このリファレンス内の Tableau 関数はアルファベット順に整理されています。文字をクリックして、その字で始まる関数を参照します。その字で始まる関数がない場合、アルファベットの次の字で始まる関数が表示されます。Ctrl+F (Mac では Command-F) を押して検索ボックスを開き、ページ内で特定の関数を検索できます。

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

ABS(number)

指定された数値の絶対値を返します。

例

ABS(-7) = 7

ABS([Budget Variance])

2 番目の例では、Budget Variance フィールドに含まれているすべての数値の絶対値を返します。

ACOS(number)

指定された数値の逆余弦を返します。結果はラジアン単位です。

例

ACOS(-1) = 3.14159265358979

AREA(geometry, 'units')

空間ポリゴンの総表面積を返します。

サポートされている単位名は、メートル ("meters"、"metres"、"m")、キロメートル ("kilometers"、"kilometres"、"km")、マイル ("miles" または "mi")、フィート ("feet"、"ft") です。

例

AREA([Geometry], 'km')

ASCII(string)

string の最初の文字の ASCII コードを返します。

例

ASCII('A') = 65

ASIN(number)

指定された数値の逆正弦を返します。結果はラジアン単位です。

例

ASIN(1) = 1.5707963267949

ATAN(number)

指定された数値の逆正接を返します。結果はラジアン単位です。

例

ATAN(180) = 1.5652408283942

ATAN2(y number, x number)

指定された 2 つの値 (x と y) の逆正接を返します。結果はラジアン単位です。

例

ATAN2(2, 1) = 1.10714871779409

ATTR(expression)

すべての行に単一の値がある場合に式の値を返します。それ以外の場合はアスタリスクを返します。NULL 値は無視されます。

AVG(expression)

式内のすべての値の平均を返します。AVG に使用できるのは数値フィールドだけです。NULL 値は無視されます。

BUFFER(geometry, number, 'units')

2 つのポイント間の距離を指定した単位で返します。

サポートされている単位名は、メートル ("meters"、"metres"、"m")、キロメートル ("kilometers"、"kilometres"、"km")、マイル ("miles" または "mi")、フィート ("feet"、"ft") です。

この関数はライブ接続でのみ作成することができ、データ ソースが抽出に変換された場合も引き続き機能します。

例

BUFFER(MAKEPOINT(47.59, -122.32), 5, 'km')

CASE

CASE <expression> WHEN <value1> THEN <return1> WHEN <value2> THEN <return2> ...ELSE <default return> END

論理テストを実行して適切な値を返すためには、CASE 関数を使用します。通常、CASE は IIF または IF THEN ELSE より簡単に使用できます。CASE 関数は expressionを評価し、value1、value2 などの連続した値と比較して、その結果を返します。expression と一致する値が見つかった場合、CASE は対応する戻り値を返します。一致が見つからない場合は、既定の return 式が使用されます。既定の return がなく、一致した値がない場合は、Null が返されます。

例

CASE [Region] WHEN 'West' THEN 1 WHEN 'East' THEN 2 ELSE 3 END

CASE LEFT(DATENAME('weekday',[Order Date]),3) WHEN 'Sun' THEN 0 WHEN 'Mon' THEN 1 WHEN 'Tue' THEN 2 WHEN 'Wed' THEN 3 WHEN 'Thu' THEN 4 WHEN 'Fri' THEN 5 WHEN 'Sat' THEN 6 END

CEILING(number)

数字を、同等またはより大きい値である最も近い整数に丸めます。

例

CEILING(3.1415) = 4

CHAR(number)

ASCII コード number によって符号化された文字を返します。

例

CHAR(65) = 'A'

COLLECT(spatial)

引数フィールドの値を組み合わせる集計計算。NULL 値は無視されます。

注: COLLECT 関数は空間フィールドでのみ使用できます。

例

COLLECT ([Geometry])

CONTAINS(string, substring)

特定の文字列に指定されたサブ文字列が含まれている場合は、true を返します。

例

CONTAINS("Calculation", "alcu") = true

CORR(expression 1, expression2)

2 つの式のピアソン相関係数を返します。

ピアソン相関係数は、2 つの変数の間の線形関係を測定します。結果は -1 から +1 の範囲となります。ここで、1 つの変数のプラスの変化はもう一方の変数の対応する倍率のプラスの変化を示し、1 は正確なプラスの直線関係を示します。0 は分布間に線形の関係がないことを示し、−1 は正確なマイナスの関係を示します。

例

CORR を使用して非集計散布図で相関を可視化できます。これを実行する方法は、表範囲の詳細レベルの式として知られています。例:

{CORR(Sales, Profit)}

詳細レベルの式では、相関はすべての行で実行します。CORR(Sales, Profit) (詳細レベルの式にするには括弧を使用しない) のような式を使用した場合、ビューはそれぞれ未定義の他のデータ ポイントを使用した散布図における、各個別ポイントの相関を示します。

表範囲を参照してください

COS(number)

角の余弦を返します。角を弧度で指定します。

例

COS(PI( ) /4) = 0.707106781186548

COT(number)

角の余接を返します。角を弧度で指定します。

例

COT(PI( ) /4) = 1

COUNT(expression)

グループ内のアイテムの数を返します。Null 値は数に含まれません。

COUNTD(expression)

グループ内の個別のアイテムの数を返します。Null 値は数に含まれません。この関数は、Tableau Desktop 8.2 以前で作成され、Microsoft Excel やテキスト ファイルのデータ ソースを使用するワークブック、レガシー接続を使用するワークブック、および Microsoft Access データ ソースを使用するワークブックでは使用できません。この関数を使用するには、データを抽出ファイルに抽出します。データの抽出を参照してください。

COVAR(expression 1, expression2)

2 つの式の標本共分散を返します。

共分散は 2 つの変数の変化をまとめて定量化します。ある変数の値が大きい場合は、平均して、他の変数の大きい値に対応している傾向があるため、プラスの共分散は変数が同じ方向に移動する傾向があることを示します。標本共分散では、母共分散によって (COVARP 関数で) 使用される n ではなく、non-null データ ポイントの数である n-1 を使用して共分散計算を標準化します。標本共分散は、データが大きな人口に対する共分散の見積もりに使用されるランダムなサンプルの場合に適しています。

expression1 と expression2 が同じ場合、たとえば、COVAR([profit], [profit]) の場合、COVAR は、値がどの程度の範囲で分散しているかを示す値を返します。

注:COVAR(X, X) の値は VAR(X) の値、および STDEV(X)^2 の値に相当します。

例

次の計算式は、[売上高] および [収益] の標本共分散を返します。

COVAR([Sales], [Profit])

COVARP(expression 1, expression2)

2 つの式の母共分散を返します。

共分散は 2 つの変数の変化をまとめて定量化します。ある変数の値が大きい場合は、平均して、他の変数の大きい値に対応している傾向があるため、プラスの共分散は変数が同じ方向に移動する傾向があることを示します。母共分散は標本共分散に (n-1)/n を乗算したものです。ここで、n は non-null データ ポイントの合計です。母共分散は、対象のすべてのアイテムに対して利用可能なデータがある場合に最適です。反対に、アイテムのランダムなサブセットのみがある場合には、標本共分散 (COVAR 関数を使用) が適しています。

expression1 と expression2 が同じ場合、たとえば、COVARP([profit], [profit]) の場合、COVARP は、値がどの程度の範囲で分散しているかを示す値を返します。

注:COVARP(X, X) の値は VARP(X) の値、および STDEVP(X)^2 の値に相当します。

例

次の計算式は、[売上高] および [収益] の母共分散を返します。

COVARP([Sales], [Profit])

DATE(expression)

指定された数値、文字列、または日付式の日付を返します。

例

DATE([Employee Start Date])

DATE("April 15, 2004") = #April 15, 2004#

DATE("4/15/2004")

DATE(#2006-06-15 14:52#) = #2006-06-15#

2 番目と 3 番目の例では引用符が必要です。

DATEADD(date_part, interval, date)

指定された日付と指定した interval の数を、指定されたその日付の date_part に追加して返します。

例

DATEADD('month', 3, #2004-04-15#) = 2004-07-15 12:00:00 AM

この式は日付 #2004-04-15# に 3 か月を追加します。

DATEDIFF(date_part, date1, date2, [start_of_week])

date_part の単位で表された、date1 と date2 の差異を返します。

週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。省略される場合、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

例

DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'monday')= 1

DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'sunday')= 0

start_of_week が 'monday' の場合、9 月 22 日 (日曜日) と 9 月 24 日 (火曜日) は別の週になるため、最初の式は 1 を返します。start_of_week が 'sunday' の場合、9 月 22 日 (日曜日) と 9 月 24 日 (火曜日) は同じ週になるため、2 番目の式は 2 を返します。

DATENAME(date_part, date, [start_of_week])

date の date_part を文字列として返します。週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。start_of_week が省略されると、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

例

DATENAME('year', #2004-04-15#) = "2004"

DATENAME('month', #2004-04-15#) = "April"

DATEPARSE(format, string)

文字列を指定した書式設定の日付時刻に変換します。一部の現地固有の書式設定向けサポートは、コンピューターのシステム設定によって決定されます。データに表示される文字で、解析される必要のないものは単一引用符 (' ') で囲む必要があります。値の間に区切り文字のない書式設定 (例: MMddyy) については、予測どおりに解析されていることを確認します。書式設定はフィールド値ではなく、定数文字列である必要があります。データが書式設定と一致しない場合、この関数は Null を返します。

この関数は複数のコネクターで使用できます。詳細については、フィールドを日付フィールドに変換するを参照してください。

例

DATEPARSE ("dd.MMMM.yyyy", "15.April.2004") = #April 15, 2004#

DATEPARSE ("h'h' m'm' s's'", "10h 5m 3s") = #10:05:03#

DATEPART(date_part, date, [start_of_week])

date の date_part を整数として返します。

週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。start_of_week が省略されると、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

注: date_part が曜日の場合、start_of_week パラメーターは無視されます。これは、Tableauは固定した曜日順を信頼してオフセットを適用するためです。

例

DATEPART('year', #2004-04-15#) = 2004

DATEPART('month', #2004-04-15#) = 4

DATETIME(expression)

指定された数値、文字列、または日付式の日付時刻を返します。

例

DATETIME(“April 15, 2005 07:59:00”) = April 15, 2005 07:59:00

DATETRUNC(date_part, date, [start_of_week])

指定された日付を date_part によって指定された精度で切り捨てます。この関数は新しい日付を返します。たとえば、月の中旬にある日付を月レベルで丸めた場合、この関数はその月の第 1 日を返します。週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。start_of_week が省略されると、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

例

DATETRUNC('quarter', #2004-08-15#) = 2004-07-01 12:00:00 AM

DATETRUNC('month', #2004-04-15#) = 2004-04-01 12:00:00 AM

DAY(date)

指定された日付の日の部分を整数として返します。

例

DAY(#2004-04-12#) = 12

DEGREES(number)

ラジアン単位の指定された数値を度単位に変換します。

例

DEGREES(PI( )/4) = 45.0

DISTANCE(Geometry1, Geometry2, "Units")

2 つのポイント間の距離を指定した単位で返します。サポートされている単位名は、メートル ("meters"、"metres"、"m")、キロメートル ("kilometers"、"kilometres"、"km")、マイル ("miles")、フィート ("feet"、"ft") です。

この関数はライブ接続でのみ作成することができ、データ ソースが抽出に変換された場合も引き続き機能します。

例

DISTANCE ({ EXCLUDE [Branch Name] : COLLECT([Selected Point]) }, [unselected point], 'km')

DISTANCE([Origin MakePoint],[Destination MakePoint], "miles")

DIV(integer1, integer2)

integer1 を integer2 で割った除算演算の整数部分を返します。

例

DIV(11,2) = 5

DOMAIN(string_url)

注: Google BigQuery に接続時のみサポート

URL 文字列が指定された場合に、ドメインを文字列として返します。

例

DOMAIN('http://www.google.com:80/index.html') = 'google.com'

ELSE

「IF THEN ELSE」を参照してください。

ELSEIF

「IF THEN ELSE」を参照してください。

END

IF や CASE などの関数と一緒に使用して、一連の式の終わりを示します。

ENDSWITH(string, substring)

特定の文字列が指定されたサブ文字列で終わる場合は、true を返します。行末の空白は無視されます。

例

ENDSWITH(“Tableau”, “leau”) = true

EXP(number)

指定された数値で累乗した e の値を返します。

例

EXP(2) = 7.389

EXP(-[Growth Rate]*[Time])

FIND(string, substring, [start])

string 内の substring のインデックス位置を返します。substringが見つからない場合は、0 を返します。オプションの引数 start を追加した場合、この関数は同じ処理を行いますが、インデックス位置 start より前に現れる substring のインスタンスはすべて無視されます。文字列の最初の文字の位置は 1 です。

例

FIND("Calculation", "alcu") = 2

FIND("Calculation", "Computer") = 0

FIND("Calculation", "a", 3) = 7

FIND("Calculation", "a", 2) = 2

FIND("Calculation", "a", 8) = 0

FINDNTH(string, substring, occurrence)

指定した文字列内のサブストリングが n 番目に現れる位置を返します。ここで、n は出現引数によって定義されます。

注: FINDNTH は、すべてのデータ ソースで使用できません。

例

FINDNTH("Calculation", "a", 2) = 7

FIRST( )

現在の行からパーティション内の最初の行までの行数を返します。たとえば、次のビューには四半期ごとの売上高が示されています。FIRST() が日付パーティション内で計算される場合、2 番目の行からの最初の行のオフセットは -1 です。

例

現在の行のインデックスが 3 の場合、FIRST() = -2.

FLOAT(expression)

引数を浮動小数点数としてキャストします。

例

FLOAT(3) = 3.000

FLOAT([Age]) は Age フィールドの各値を浮動小数点数に変換します。

FLOOR(number)

数字を、同等またはより小さい値である最も近い整数に丸めます。

例

FLOOR(3.1415) = 3

FULLNAME( )

現在のユーザーのフル ネームを返します。これは、ユーザーがサインインしている場合は Tableau Server または Tableau Cloud のフル ネーム、それ以外の場合は Tableau Desktop ユーザーのローカルまたはネットワーク フル ネームになります。

例

[Manager]=FULLNAME( )

Dave Hallsten というマネージャーがサインインしている場合、この例が True を返すのは、ビューの "Manager (マネージャー)" フィールドに "Dave Hallsten" が含まれているときに限ります。この計算フィールドをフィルターとして使用すると、サーバーにサインインしているユーザーと関連性のあるデータのみを表示するユーザー フィルターを作成できます。

GET_JSON_OBJECT(JSON string, JSON path)

注: Hadoop Hive に接続時のみサポート。

JSON パスに基づいた JSON 文字列内の JSON オブジェクトを返します。

GROUP_CONCAT(expression)

注: Google BigQuery に接続時のみサポート

各レコードの値をコンマで区切られた 1 つの文字列に連結します。この機能は、文字列に対して SUM() を実行するのと同じです。

例

GROUP_CONCAT(Region) = "Central,East,West"

HEXBINX(number, number)

x、y 座標を最も近い六角形のビンの x 座標にマップします。ビンの横幅は 1 です。入力時には適切に拡大縮小する必要があります。

HEXBINX と HEXBINY は六角形のビン用のビニング関数とプロット関数です。六角形のビンは、マップなどの x/y 平面内でデータを可視化するための効率的で洗練されたオプションです。ビンは六角形なので、各ビンは円に近似し、データ点からビンの中心への距離のばらつきを最小限に抑えます。これにより、クラスタリングがより正確かつ有益なものになります。

例

HEXBINX([Longitude], [Latitude])

HEXBINY(number, number)

x、y 座標を最も近い六角形のビンの y 座標にマップします。ビンの横幅は 1 です。入力時には適切に拡大縮小する必要があります。

例

HEXBINY([Longitude], [Latitude])

HOST(string_url)

注: Google BigQuery に接続時のみサポート

URL 文字列が指定された場合に、ホスト名を文字列として返します。

例

HOST('http://www.google.com:80/index.html') = 'www.google.com:80'

IF THEN ELSE

IF test THEN value END / IF test THEN value ELSE else END

論理テストを実行して適切な値を返すためには、IFTHENELSE 関数を使用します。IF THEN ELSE 関数は、一連のテスト条件を評価して、true として評価された最初の条件の値を返します。true の条件がない場合は、ELSE値が返されます。test にはブール値を指定する必要があります。ブール値には、データ ソースのブール値フィールドまたは論理式の結果を指定できます。最後の ELSE は省略可能ですが、指定しなかった場合に true の test 式がないと、Null が返されます。value 式はすべて同じ型でなければなりません。

例

IF [Cost]>[Budget Cost] THEN 'Over Budget' ELSE 'Under Budget' END

IF [Budget Sales]!=0 THEN [Sales]/[Budget Sales] END

IF THEN ELSEIF

IF test1 THEN value1 ELSEIF test2 THEN value2 ELSE else END

再帰的に論理テストを実行するには、このバージョンの IF 関数を使用します。各 IF 式で使用できる ELSEIF 値の数に制限はありません。しかし、IF 関数の複雑度は、各データベースによって制限されている場合があります。IF 関数はネストされた一連の IIF ステートメントとして記述し直すことができますが、式の評価方法は異なります。つまり、IIF ステートメントは TRUE、FALSE、および UNKNOWN を区別するのに対し、IFステートメントは TRUE と not true (FALSE と UNKNOWN の両方を含む) しか区別しません。

IIF(test, then, else, [unknown])

論理テストを実行して適切な値を返すためには、IIF 関数を使用します。最初の引数である test はブール値である必要があります。ブール値には、データ ソースのブール値フィールドか、演算子を使った論理式 (または AND、OR、NOT の論理比較) の結果を指定できます。If test が TRUE として評価された場合、IIF は then 値を返します。test が FALSE として評価された場合、IIF は else 値を返します。

ブール値比較は、通常、テストに Null 値が含まれていることが原因で、値 UNKNOWN(TRUE と FALSE のいずれでもない) を生成することもあります。IIF の最後の引数は、比較の結果が UNKNOWN である場合に返されます。この引数を省略した場合は、Null が返されます。

例

IIF(7>5, 'Seven is greater than five', 'Seven is less than five')

IIF([Cost]>[Budget Cost], 'Over Budget', 'Under Budget')

IIF([Budget Sales]!=0,[Sales]/[Budget Sales],0)

IIF(Sales>=[Budget Sales], 'Over Cost Budget and Over Sales Budget', 'Over Cost Budget and Under Sales Budget','Under Cost Budget')

IFNULL(expression1, expression2)

IFNULL 関数は、結果が NULL でない場合は最初の式を返し、NULL の場合は 2 番目の式を返します。

例

IFNULL([Profit], 0) = [Profit]

<expression1> IN <expression2>

<expression1> が <expression2> の任意の値と一致する場合、TRUE を返します。

例

[Name] IN [Set of attendees]

SUM([Cost]) IN (19.99, 20.99, 21.99)

INDEX( )

値に関しては並べ替えをせずに、パーティション内の現在の行のインデックスを返します。最初の行のインデックスは 1 から始まります。たとえば、次の表には四半期ごとの売上高が示されています。INDEX() が日付パーティション内で計算される場合、各行のインデックスは 1、2、3、4 のようになります。

例

パーティション内の 3 番目の行の場合、INDEX() = 3.

INT(expression)

引数を整数としてキャストします。引数が式の場合、この関数は結果をゼロに最も近い整数に丸めます。

例

INT(8.0/3.0) = 2

INT(4.0/1.5) = 2

INT(0.50/1.0) = 0

INT(-9.7) = -9

文字列が整数に変換される場合、この文字列はまず浮動小数点数に変換されてから、丸められます。

ISDATE(string)

ISDATE 関数は、string 引数を日付に変換できる場合は TRUE を返し、変換できない場合は FALSE を返します。

例

ISDATE('January 1, 2003') = TRUE

ISDATE('Jan 1 2003') = TRUE

ISDATE('1/1/03') = TRUE

ISDATE('Janxx 1 2003') = FALSE

ISFULLNAME(string)

現在のユーザーのフル ネームが指定されたフル ネームに一致する場合に true を返し、一致しない場合は false を返します。この関数は、ユーザーがサインインしている場合は Tableau Server または Tableau Cloud のフル ネーム、それ以外の場合は Tableau Desktop ユーザーのローカルまたはネットワーク フル ネームを使用します。

例

ISFULLNAME("Dave Hallsten")

この例では、Dave Hallsten が現在のユーザーである場合は True、それ以外の場合は False を返します。

ISMEMBEROF(string)

現在のユーザーが指定されたグループのメンバーである場合、TRUE を返します。この関数は、ログインした Tableau Server または Tableau Cloud サイトを使用して、グループ メンバーシップを解決します。それ以外の場合は、常に false を返します。

例

ISMEMBEROF("All Users")

ISNULL(expression)

ISNULL 関数は、式が Null の場合は TRUE を返し、式が NULL でない場合は FALSE を返します。

例

次の例では、ISNULL と IIF を組み合わせて使用し、null 値を 0 に置き換えます。

IIF(ISNULL([Sales]), 0,[Sales] )

ISOQUARTER (date)

指定された日付の ISO8601 週ベースの四半期の部分を整数として返します。

例

ISOQUARTER(#2022-03-29#) = 1

ISOWEEK (date)

指定された日付の ISO8601 週ベースの部分を整数として返します。

例

ISOWEEK(#2022-03-29#) = 13

ISOWEEKDAY (date)

指定された日付の ISO8601 週ベースの曜日の部分を整数として返します。

例

ISOWEEKDAY(#2022-03-29#) = 2

ISOYEAR (date)

指定された日付の ISO8601 週ベースの年の部分を整数として返します。

例

ISOYEAR(#2019-12-31#) = 2020

ISUSERNAME(string)

現在のユーザーのユーザー名が指定されたユーザー名に一致する場合に true を返し、一致しない場合は false を返します。この関数は、ユーザーがサインインしている場合は Tableau Server または Tableau Cloud のユーザー名、それ以外の場合は Tableau Desktop ユーザーのローカルまたはネットワーク ユーザー名を使用します。

例

ISUSERNAME(“dhallsten”)

この例では、dhallsten が現在のユーザーである場合は True、それ以外の場合は False を返します。

LAST( )

現在の行からパーティション内の最後の行までの行数を返します。たとえば、次の表には四半期ごとの売上高が示されています。LAST() が日付パーティション内で計算される場合、2 番目の行からの最後の行のオフセットは 5 です。

例

現在の行のインデックスは 7 個中 3 つ目の場合、LAST() = 4.

LEFT(string, number)

文字列内の一番左から n 文字分を返します (n は引数で指定された数)。

例

LEFT("Matador", 4) = "Mata"

LEN(string)

文字列の長さを返します。

例

LEN("Matador") = 7

LN(number)

数値の自然対数を返します。数値が 0 以下の場合は、Null を返します。

LOG(number [, base])

指定された基底について数値の対数を返します。基底値が省略された場合は、10 を使用します。

LOG2(number)

注: Google BigQuery に接続時のみサポート

数値の対数 (底 2) を返します。

例

LOG2(16) = '4.00'

LOOKUP(expression, [offset])

現在の行からの相対オフセットとして指定されたターゲット行にある式の値を返します。パーティション内の最初/最後の行に相対的なターゲットには、オフセット定義の一部として FIRST() + n と LAST() - n を使用してください。offset を省略した場合は、比較対象行をフィールド メニューで設定できます。この関数は、ターゲット行を特定できない場合は、NULL を返します。

次のビューには四半期ごとの売上高が示されています。LOOKUP (SUM(Sales), 2) が日付パーティション内で計算される場合、各行には 2 四半期後の売上高が表示されるようになります。

例

LOOKUP(SUM([Profit]), FIRST()+2) はパーティション内の 3 番目の行の SUM(Profit) を計算します。

LOWER(string)

string のすべての文字を小文字に返します。

例

LOWER("ProductVersion") = "productversion"

LTRIM(string)

先頭の空白を削除した文字列を返します。

例

LTRIM(" Matador ") = "Matador "

LTRIM_THIS(string, string)

注: Google BigQuery に接続時のみサポート

最初の string から、2 つ目の string を先頭から削除した文字列を返します。

例

LTRIM_THIS('[-Sales-]','[-') = 'Sales-]'

MAKEDATE(year, month, day)

指定した年、月、日から構成された日付値を返します。

Tableau Data Extract で利用できます。他のデータ ソースで利用可能か確認します。

例

MAKEDATE(2004, 4, 15) = #April 15, 2004#

MAKEDATETIME(date, time)

日付と時刻を組み合わせた日付時刻を返します。日付は、日付、日付時刻、または文字列の種類になることがあります。時刻は日付時刻である必要があります。この関数は、MySQL 互換の接続 (Tableau では、MySQL、Amazon Aurora、および Amazon Aurora の他に) でのみ使用できます。

例

MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#

MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#

MAKELINE(geometry1,geometry2)

MAKELINE(Geometry1,Geometry2)

2 つの空間ポイントの間の線マークを生成します。これは起点 - 終点マップの作成に便利です。

例

MAKELINE(MAKEPOINT(OriginLat],[OriginLong) ),MAKEPOINT([DestinationLat],[DestinationLong] ) )

MAKELINE(Geometry1, Geometry2 )

MAKEPOINT(Latitude,Longitude)

緯度列および経度列のデータを、空間オブジェクトに変換します。MAKEPOINT を使用すると、データ ソースを空間的に有効化し、空間結合を使用している空間ファイルと結合することができます。MAKEPOINT を使用するには、データに緯度と経度の座標を含める必要があります。

例

MAKEPOINT([AirportLatitude],[AirportLongitude])

MAKEPOINT(Xcoordinate,Ycoordinate,SRID)

投影された地理座標のデータを、空間オブジェクトに変換します。SRID は、ESPG 参照系コードを使用して座標系を指定する空間参照識別子です。SRID を指定しない場合は WGS84 が使用され、パラメーターは度を単位とする緯度/経度で処理されます。

この関数はライブ接続でのみ作成することができ、データ ソースが抽出に変換された場合も引き続き機能します。

例

MAKEPOINT([Xcoord],[Ycoord],3493)

MAKETIME(hour, minute, second)

指定した時、分、秒から構成された日付値を返します。

Tableau Data Extract で利用できます。他のデータ ソースで利用可能か確認します。

例

MAKETIME(14, 52, 40) = #14:52:40#

MAX(a, b)

a と b の最大値を返します (同じ型でなければなりません)。この関数は、通常は数値の比較に使用されますが、文字列でも使用できます。文字列を使用する場合、MAX は、その列のデータベースによって定義されているソート順が最も高い値を見つけます。いずれかの引数が Null の場合は、Null を返します。

例

MAX ("Apple","Banana") = "Banana"

MAX(expression) または MAX(expr1, expr2)

通常は数値に適用されますが、日付でも使用できます。a と b の最大値を返します (a と b は同じ型でなければなりません)。いずれかの引数が Null の場合は、Null を返します。

例

MAX(#2004-01-01# ,#2004-03-01#) = 2004-03-01 12:00:00 AM

MAX([ShipDate1], [ShipDate2])

MAX(number, number)

2 つの引数の最大値を返します (2 つの引数は同じ型でなければなりません)。いずれかの引数が Null の場合は、Null を返します。MAX は集計関数の単一フィールドに適用することもできます。

例

MAX(4,7)

MAX(Sales,Profit)

MAX([First Name],[Last Name])

MEDIAN(expression)

式のすべてのレコードの中から中央値を返します。中央値は数値フィールドでのみ使用できます。NULL 値は無視されます。この関数は、Tableau Desktop 8.2 より前のバージョンで作成されたワークブック、 または従来の接続を使用するワークブックでは使用できません。

MID(string, start, [length])

インデックス位置 start で始まる文字列を返します。文字列の最初の文字の位置は 1 です。オプションの引数 length を追加した場合、返される文字列には、その引数に相当する数の文字だけが含まれます。

例

MID("Calculation", 2) = "alculation"

MID("Calculation", 2, 5) ="alcul"

MIN(a, b)

a と b の最小値を返します (同じ型でなければなりません)。この関数は、通常は数値の比較に使用されますが、文字列でも使用できます。文字列を使用する場合、MIN は、ソート順が最も低い値を見つけます。いずれかの引数が Null の場合は、Null を返します。

例

MIN ("Apple","Banana") = "Apple"

MIN(expression) または MIN(expr1, expr2)

通常は数値に適用されますが、日付でも使用できます。a と b の最小値を返します (a と b は同じ型でなければなりません)。いずれかの引数が Null の場合は、Null を返します。

例

MIN(#2004-01-01# ,#2004-03-01#) = 2004-01-01 12:00:00 AM

MIN([ShipDate1], [ShipDate2])

MIN(number, number)

2 つの引数の最小値を返します (2 つの引数は同じ型でなければなりません)。いずれかの引数が Null の場合は、Null を返します。MIN は集計関数の単一フィールドに適用することもできます。

例

MIN(4,7)

MIN(Sales,Profit)

MIN([First Name],[Last Name])

MODEL_EXTENSION_BOOL(model_name, arguments, expression)

デプロイされた分析拡張機能モデルである model_name のブール結果を返します。各引数は、使用する要素を定義する単一の文字列です。式を使用して (モデルに送信される) 入力フィールドを定義し、集計関数 (SUM、AVG など) を使用して結果を集計します。各入力フィールドを独自の引数として定義および順序付けします。

例

MODEL_EXTENSION_BOOL("model_isProfitable", "[inputSales]", "[inputCosts]", SUM([Sales]), SUM([Costs]))

MODEL_EXTENSION_INT(model_name, arguments, expression)

デプロイされた分析拡張機能モデルである model_name の整数結果を返します。各引数は、使用する要素を定義する単一の文字列です。式を使用して (モデルに送信される) 入力フィールドを定義し、集計関数 (SUM、AVG など) を使用して結果を集計します。各入力フィールドを独自の引数として定義および順序付けします。

例

MODEL_EXTENSION_INT("model_getPopulation", "[inputCity]", "[inputState]", MAX([City]), MAX([State]))

MODEL_EXTENSION_REAL(model_name, arguments, expression)

デプロイされた分析拡張機能モデルである model_name の数値結果を返します。各引数は、使用する要素を定義する単一の文字列です。式を使用して (モデルに送信される) 入力フィールドを定義し、集計関数 (SUM、AVG など) を使用して結果を集計します。各入力フィールドを独自の引数として定義および順序付けします。

例

MODEL_EXTENSION_REAL("model_ProfitRatio", "[inputSales]", "[inputCosts]", SUM([Sales]), SUM([Costs]))

MODEL_EXTENSION_STR(model_name, arguments, expression)

デプロイされた分析拡張機能モデルである model_name の文字列結果を返します。各引数は、使用する要素を定義する単一の文字列です。式を使用して (モデルに送信される) 入力フィールドを定義し、集計関数 (SUM、AVG など) を使用して結果を集計します。各入力フィールドを独自の引数として定義および順序付けします。

例

MODEL_EXTENSION_STR("model_mostPopulatedCity", "[inputCountry]", "[inputYear]", MAX([Country]), MAX([Year]))

MODEL_PERCENTILE(target_expression, predictor_expression(s))

予測値が観測されたマーク以下である確率 (0 から 1 の間) を返します。マークは、ターゲット式と他の予測変数で定義されます。これは、累積分布関数 (CDF) とも呼ばれる事後予測分布関数です。

例

MODEL_PERCENTILE( SUM([Sales]),COUNT([Orders]))

MODEL_QUANTILE(quantile, target_expression, predictor_expression(s))

指定した分位数で、ターゲット式と他の予測変数によって定義された推定範囲内のターゲット数値を返します。これは事後予測分位です。

例

MODEL_QUANTILE(0.5, SUM([Sales]),COUNT([Orders]))

MONTH(date)

指定された日付の月の部分を整数として返します。

例

MONTH(#2004-04-15#) = 4

NOT

1 つの式で論理否定を実行します。

例

IF NOT <exp> THEN <then> END

NOW( )

現在の日付と時刻を返します。

戻り値は、接続の性質によって異なります。

• ライブの、パブリッシュされていない接続については、データ ソース サーバー時間を返すようになりました。

• ライブの、パブリッシュされた接続については、データ ソース サーバー時間が返されるようになりました。

• パブリッシュされていない抽出の場合、ローカルのシステム時間が返されるようになりました。

• パブリッシュされた抽出の場合、Tableau Server データ エンジンのローカルの時間が返されるようになりました。異なるタイム ゾーン複数のワーカー マシンがある場合、一貫性のない結果が生成される可能性があります。

例

NOW( ) = 2004-04-15 1:08:21 PM

OR

2 つの式で論理和を実行します。

例

IF <exp1> or <expr2> THEN <then> END

PARSE_URL(string, url_part)

注: Hadoop Hive および Cloudera Impala に接続時のみサポート。

コンポーネントが url_part で定義されている特定の URL 文字列のコンポーネントを返します。有効な url_part の値は、'HOST'、'PATH'、'QUERY'、'REF'、'PROTOCOL'、'AUTHORITY'、'FILE'、'USERINFO' などです。

例

PARSE_URL('http://www.tableau.com', 'HOST') = 'www.tableau.com'

PARSE_URL_QUERY(string, key)

注: Hadoop Hive および Cloudera Impala に接続時のみサポート。

特定の URL 文字列内にある指定したクエリ パラメーターの値を返します。クエリ パラメーターはキーで定義されます。

例

PARSE_URL_QUERY('http://www.tableau.com?page=1&cat=4', 'page') = '1'

PERCENTILE(expression, number)

指定された数字に対応する指定された式の百分位値を返します。数値は 0 と 1 (包含) の間である必要があります — たとえば、0.66 は数値定数にする必要があります。

PI( )

数値定数 pi (3.14159) を返します。

POWER(number, power)

指定された回数、数値を掛け合わせます。

例

POWER(5,2) = 52 = 25

POWER(Temperature, 2)

^ 記号を使用することもできます。

5^2 = POWER(5,2) = 25

PREVIOUS_VALUE(expression)

前の行のこの計算の値を返します。現在の行がパーティション内の最初の行の場合は、指定された式を返します。

例

SUM([Profit]) * PREVIOUS_VALUE(1) は SUM(Profit) の累積積を計算します。

四半期

指定された日付の四半期の部分を整数として返します。

例

QUARTER(#2021-02-20#) = 1

RADIANS(number)

指定された数値を度単位からラジアン単位に変換します。

例

RADIANS(180) = 3.14159

RANK(expression, ['asc' | 'desc'])

パーティション内の現在の行に対して標準の競争ランクを返します。同一の値には同一のランクが割り当てられます。

昇順または降順を指定するには、オプションの 'asc' | 'desc' 因数を使用してください。既定では降順です。

この関数を使用すると、値のセット (6、9、9、14) は (4、2、2、1) とランク付けされます。

Null はランキング関数では無視されます。これらには番号が付けられておらず、百分位値のランク計算のレコード総数に含まれません。

異なるランキング オプションの詳細については、ランク計算を参照してください。

例

次の図は、値のセットにおけるさまざまなランキング関数 (RANK、RANK_DENSE、RANK_MODIFIED、RANK_PERCENTILE、および RANK_UNIQUE)) の効果を示しています。データ セットには、14 名の生徒 (生徒 A から生徒 N) に関する情報が含まれています。[年齢] 列には各生徒の現在の年齢が表示されます (すべての生徒は 17 歳から 20 歳の間です)。その他の列には、年齢値に対する各ランク関数の結果が示されます。常に、関数の既定の順序 (昇順または降順) が前提となります。

RANK_DENSE(expression, ['asc' | 'desc'])

パーティション内の現在の行に対して密度の高いランクを返します。

同一の値には同一のランクが指定されますが、数列にギャップは挿入されません。

この関数を使用すると、値のセット (6、9、9、14) は (3、2、2、1) とランク付けされます。

RANK_MODIFIED(expression, ['asc' | 'desc'])

パーティション内の現在の行に対して変更された競争ランクを返します。

同一の値には同一のランクが割り当てられます。

この関数を使用すると、値のセット (6、9、9、14) は (4、3、3、1) とランク付けされます。

RANK_PERCENTILE(expression, ['asc' | 'desc'])

パーティション内の現在の行に対して百分位値のランクを返します。

この関数を使用すると、値セット (6、9、9、14) は (0.25、0.75、0.75、1.00) とランク付けされます。

注: 他のランク オプションとは異なり、既定では昇順です。

RANK_UNIQUE(expression, ['asc' | 'desc'])

パーティション内の現在の行の一意のランクを返します。

同一の値に異なるランクが指定されます。

この関数を使用すると、値のセット (6、9、9、14) は (4、2、3、1) とランク付けされます。

RAWSQL_BOOL("sql_expr", [arg1], …[argN])

指定された SQL 式からブールの結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。

例

次の例では、%1 は [Sales]、%2 は [Profit] に等しくなります。

RAWSQL_BOOL("IIF(%1 > %2, True, False)", [Sales], [Profit])

RAWSQL_DATE("sql_expr", [arg1], …[argN])

指定された SQL 式から日付の結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。

例

次の例では、%1 は [Order Date] に等しくなります。

RAWSQL_DATE("%1", [Order Date])

RAWSQL_DATETIME("sql_expr", [arg1], …[argN])

指定された SQL 式から日付と時刻の結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Delivery Date] に等しくなります。

例

RAWSQL_DATETIME("MIN(%1)", [Delivery Date])

RAWSQL_INT("sql_expr", [arg1], …[argN])

指定された SQL 式から整数の結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Sales] に等しくなります。

例

RAWSQL_INT("500 + %1", [Sales])

RAWSQL_REAL("sql_expr", [arg1], …[argN])

参照元データベースに直接渡される指定された SQL 式から数値結果を返します。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Sales] に等しくなります。

例

RAWSQL_REAL("-123.98 * %1', [Sales])

RAWSQL_SPATIAL

参照元データ ソースに直接渡される指定された SQL 式から空間を返します。SQL 式では、データベース値の代替構文として %n を使用してください。

例

次の例では、%1 は [Geometry] に等しくなります。

RAWSQL_SPATIAL("%1", [Geometry])

RAWSQL_STR("sql_expr", [arg1], …[argN])

参照元データベースに直接渡される指定された SQL 式から文字列を返します。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Customer Name] に等しくなります。

例

RAWSQL_STR("%1", [Customer Name])

RAWSQLAGG_BOOL("sql_expr", [arg1], …[argN])

指定された集計 SQL 式からブールの結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。

例

次の例では、%1 は [Sales]、%2 は [Profit] に等しくなります。

RAWSQLAGG_BOOL("SUM( %1) >SUM( %2)”, [Sales], [Profit])

RAWSQLAGG_DATE("sql_expr", [arg1], …[argN])

指定された集計 SQL 式から日付の結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Order Date] に等しくなります。

例

RAWSQLAGG_DATE("MAX(%1)", [Order Date])

RAWSQLAGG_DATETIME("sql_expr", [arg1], …[argN])

指定された集計 SQL 式から日付と時刻の結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Delivery Date] に等しくなります。

例

RAWSQLAGG_DATETIME("MIN(%1)", [Delivery Date])

RAWSQLAGG_INT(“sql_expr”, [arg1,] …[argN])

指定された集計 SQL 式から整数の結果を返します。SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Sales] に等しくなります。

例

RAWSQLAGG_INT("500 + SUM(%1)", [Sales])

RAWSQLAGG_REAL("sql_expr", [arg1,] …[argN])

参照元データベースに直接渡される指定された集計 SQL 式から数値結果を返します。SQL 式では、データベース値の代替構文として %n を使用してください。次の例では、%1 は [Sales] に等しくなります。

例

RAWSQLAGG_REAL("SUM( %1)", [Sales])

RAWSQLAGG_STR("sql_expr", [arg1,] …[argN])

参照元データベースに直接渡される指定された集計 SQL 式から文字列を返します。SQL 式では、データベース値の代替構文として %n を使用してください。この例では、%1 は [Discount] に等しくなります。

例

RAWSQLAGG_STR("AVG(%1)", [Discount])

REGEXP_EXTRACT(string, pattern)

正規表現のパターンと一致する文字列の一部を返します。この関数はテキスト ファイル、Hadoop Hive、Google BigQuery、PostgreSQL、Tableau Data Extract、Microsoft Excel、Salesforce、Vertica、Pivotal Greenplum、Teradata (バージョン 14.1 以上)、Snowflake、および Oracle データ ソースで利用できます。

Tableau データ抽出では、パターンを定数にする必要があります。

正規表現の構文の詳細については、お使いのデータ ソースのドキュメントを参照してください。Tableau 抽出の場合、正規表現の構文は ICU 規格 (Unicode の国際的なコンポーネント)、Unicode サポートのための成熟した C/C++ ライブラリと Java ライブラリのオープン ソース プロジェクト、ソフトウェアの国際化、およびソフトウェアのグローバル化に準拠しています。オンラインの ICU ユーザー ガイドの「正規表現」(新しいウィンドウでリンクが開く)のページを参照してください。

例

REGEXP_EXTRACT('abc 123', '[a-z]+\s+(\d+)') = '123'

REGEXP_EXTRACT_NTH(string, pattern, index)

正規表現のパターンと一致する文字列の一部を返します。サブストリングは n 番目 (n は特定のインデックス) のキャプチャリング グループと照合されます。index が 0 の場合、文字列全体が返されます。この関数は、テキスト ファイル、PostgreSQL、Tableau Data Extract、Microsoft Excel、Salesforce、Vertica、Pivotal Greenplum、Teradata (バージョン 14.1 以降)、および Oracle データ ソースで利用できます。

Tableau データ抽出では、パターンを定数にする必要があります。

正規表現の構文の詳細については、お使いのデータ ソースのドキュメントを参照してください。Tableau 抽出の場合、正規表現の構文は ICU 規格 (Unicode の国際的なコンポーネント)、Unicode サポートのための成熟した C/C++ ライブラリと Java ライブラリのオープン ソース プロジェクト、ソフトウェアの国際化、およびソフトウェアのグローバル化に準拠しています。オンラインの ICU ユーザー ガイドの「正規表現」(新しいウィンドウでリンクが開く)のページを参照してください。

例

REGEXP_EXTRACT_NTH('abc 123', '([a-z]+)\s+(\d+)', 2) = '123'

REGEXP_MATCH(string, pattern)

指定した文字列のサブストリングが正規表現パターンに一致した場合に TRUE を返します。この関数はテキスト ファイル、Google BigQuery、PostgreSQL、Tableau Data Extract、Microsoft Excel、Salesforce、Vertica、Pivotal Greenplum、Teradata (バージョン 14.1 以降)、Impala 2.3.0 (Cloudera Hadoop データ ソースを介して)、Snowflake、および Oracle データ ソースで利用できます。

Tableau データ抽出では、パターンを定数にする必要があります。

正規表現の構文の詳細については、お使いのデータ ソースのドキュメントを参照してください。Tableau 抽出の場合、正規表現の構文は ICU 規格 (Unicode の国際的なコンポーネント)、Unicode サポートのための成熟した C/C++ ライブラリと Java ライブラリのオープン ソース プロジェクト、ソフトウェアの国際化、およびソフトウェアのグローバル化に準拠しています。オンラインの ICU ユーザー ガイドの「正規表現」(新しいウィンドウでリンクが開く)のページを参照してください。

例

REGEXP_MATCH('-([1234].[The.Market])-','\[\s*(\w*\.)(\w*\s*\])')=true

REGEXP_REPLACE(string, pattern, replacement)

正規表現のパターンが置換文字列に置き換えられている特定の文字列のコピーを返します。この関数はテキスト ファイル、Hadoop Hive、Google BigQuery、PostgreSQL、Tableau Data Extract、Microsoft Excel、Salesforce、Vertica、Pivotal Greenplum、Teradata (バージョン 14.1 以上)、Snowflake、および Oracle データ ソースで利用できます。

Tableau データ抽出では、パターンおよび置換を定数にする必要があります。

正規表現の構文の詳細については、お使いのデータ ソースのドキュメントを参照してください。Tableau 抽出の場合、正規表現の構文は ICU 規格 (Unicode の国際的なコンポーネント)、Unicode サポートのための成熟した C/C++ ライブラリと Java ライブラリのオープン ソース プロジェクト、ソフトウェアの国際化、およびソフトウェアのグローバル化に準拠しています。オンラインの ICU ユーザー ガイドの「正規表現」(新しいウィンドウでリンクが開く)のページを参照してください。

例

REGEXP_REPLACE('abc 123', '\s', '-') = 'abc-123'

REPLACE(string, substring, replacement)

string で substring を検索し、それを replacement で置き換えます。substring が見つからない場合、string は変更されません。

例

REPLACE("Version8.5", "8.5", "9.0") = "Version9.0"

RIGHT(string, number)

string 内の一番右から n 文字分を返します (n は引数で指定された数)。

例

RIGHT("Calculation", 4) = "tion"

ROUND(number, [decimals])

指定された桁数に数値を丸めます。decimals 引数は、最終結果に含める小数点以下の桁数 (精度) を指定します。decimals を省略した場合、number は最も近い整数に丸められます。

例

この例では、すべての Sales の値が整数に丸められます。

ROUND(Sales)

MS SQL Server などの一部のデータベースでは、length に負の値を指定できます。たとえば、-1 は number を十の位で丸め、-2 は百の位で丸めます。このことは、すべてのデータベースに当てはまるわけではありません。たとえば、Excel と Access には当てはまりません。

RTRIM(string)

末尾の空白を削除した string を返します。

例

RTRIM(" Calculation ") = " Calculation"

RTRIM_THIS(string, string)

注: Google BigQuery に接続時のみサポート

最初の string から、2 つ目の string を末尾から削除した文字列を返します。

例

RTRIM_THIS('[-Market-]','-]') = '[-Market'

RUNNING_AVG(expression)

パーティション内の最初の行から現在の行までの、指定された式の累積平均を返します。

次のビューには四半期ごとの売上高が示されています。RUNNING_AVG(SUM([Sales]) が日付パーティション内で計算される場合、結果は四半期ごとの売上高の累積平均になります。

例

RUNNING_AVG(SUM([Profit])) は SUM(Profit) の累積平均を計算します。

RUNNING_COUNT(expression)

パーティション内の最初の行から現在の行までの、指定された式の累積数を返します。

例

RUNNING_COUNT(SUM([Profit])) は SUM(Profit) の累積数を計算します。

RUNNING_MAX(expression)

パーティション内の最初の行から現在の行までの、指定された式の累積最大値を返します。

例

RUNNING_MAX(SUM([Profit])) は SUM(Profit) の累積最大値を計算します。

RUNNING_MIN(expression)

パーティション内の最初の行から現在の行までの、指定された式の累積最小値を返します。

例

RUNNING_MIN(SUM([Profit])) は SUM(Profit) の累積最小値を計算します。

RUNNING_SUM(expression)

パーティション内の最初の行から現在の行までの、指定された式の累積合計を返します。

例

RUNNING_SUM(SUM([Profit])) は SUM(Profit) の累積合計を計算します。

SCRIPT_BOOL

指定された式からブールの結果を返します。式は実行中の外部サービス インスタンスに直接渡されます。

R 式では、パラメーターに .argn (先頭にピリオド) を使用してパラメーターを参照します (.arg1、.arg2、など)。

Python 式では、_argn (先頭にアンダースコア) を使用します。

例

この R の例では、.arg1 は SUM([Profit]) に等しくなります。

SCRIPT_BOOL("is.finite(.arg1)", SUM([Profit]))

それ以外の場合は False を返します。次の例はワシントンのストア ID に対して True を返します。この例は "IsStoreInWA" という計算フィールドの定義となる可能性があります。

SCRIPT_BOOL('grepl(".*_WA", .arg1, perl=TRUE)',ATTR([Store ID]))

Python 用のコマンドは以下のようになります。

SCRIPT_BOOL("return map(lambda x : x > 0, _arg1)", SUM([Profit]))

SCRIPT_INT

指定された式から整数の結果を返します。式は実行中の外部サービス インスタンスに直接渡されます。

R 式では、パラメーターに .argn (先頭にピリオド) を使用してパラメーターを参照します (.arg1、.arg2、など)。

Python 式では、_argn (先頭にアンダースコア) を使用します。

例

この R の例では、.arg1 は SUM([Profit]) に等しくなります。

SCRIPT_INT("is.finite(.arg1)", SUM([Profit]))

次の例では、k-means クラスタリングが 3 つのクラスタ作成に使用されます。

SCRIPT_INT('result <- kmeans(data.frame(.arg1,.arg2,.arg3,.arg4), 3);result$cluster;', SUM([Petal length]), SUM([Petal width]),SUM([Sepal length]),SUM([Sepal width]))

Python 用のコマンドは以下のようになります。

SCRIPT_INT("return map(lambda x : int(x * 5), _arg1)", SUM([Profit]))

SCRIPT_REAL

指定された式から実際の結果を返します。式は実行中の外部サービス インスタンスに直接渡されます。R

R 式では、パラメーターに .argn (先頭にピリオド) を使用してパラメーターを参照します (.arg1、.arg2、など)。

Python 式では、_argn (先頭にアンダースコア) を使用します。

例

この R の例では、.arg1 は SUM([Profit]) に等しくなります。

SCRIPT_REAL("is.finite(.arg1)", SUM([Profit]))

次の例では、温度の値をセ氏からカ氏に変換します。

SCRIPT_REAL('library(udunits2);ud.convert(.arg1, "celsius", "degree_fahrenheit")',AVG([Temperature]))

Python 用のコマンドは以下のようになります。

SCRIPT_REAL("return map(lambda x : x * 0.5, _arg1)", SUM([Profit]))

SCRIPT_STR

指定された式から文字列の結果を返します。式は実行中の外部サービス インスタンスに直接渡されます。

R 式では、パラメーターに .argn (先頭にピリオド) を使用してパラメーターを参照します (.arg1、.arg2、など)。

Python 式では、_argn (先頭にアンダースコア) を使用します。

例

この R の例では、.arg1 は SUM([Profit]) に等しくなります。

SCRIPT_STR("is.finite(.arg1)", SUM([Profit]))

次の例ではより複雑な文字列から州名の省略形を抽出します (元のフォーム 13XSL_CA, A13_WA において)。

SCRIPT_STR('gsub(".*_", "", .arg1)',ATTR([Store ID]))

Python 用のコマンドは以下のようになります。

SCRIPT_STR("return map(lambda x : x[:2], _arg1)", ATTR([Region]))

SIGN(number)

数値の符号を返します。数値が負の場合は -1、数値がゼロの場合は 0、数値が正の場合は 1 が返されます。

例

Profit フィールドの平均が負の値の場合は、次のようになります。

SIGN(AVG(Profit)) = -1

SIN(number)

角の正弦を返します。角を弧度で指定します。

例

SIN(0) = 1.0

SIN(PI( )/4) = 0.707106781186548

SIZE()

パーティション内の行数を返します。たとえば、次のビューには四半期ごとの売上高が示されています。日付パーティション内には 7 行があるため、日付パーティションの Size() は 7 になります。

例

現在のパーティションに 5 行含まれる場合、SIZE() = 5。

SPACE(number)

指定された文字 number 分の空白で構成された文字列を返します。

例

SPACE(1) = " "

SPLIT(string, delimiter, token number)

指定した文字列を基に、区切り文字を使用して連続したトークンに文字列を分割したサブストリングを返します。

文字列は区切り文字とトークンが交互に連続する文字列として解釈されます。そのため、文字列が abc-defgh-i-jkl で、区切り文字が「-」の場合、「abc」、「defgh」、「i」、「jlk」がトークンとなります。これらをトークン 1 からトークン 4 と考えます。SPLIT はトークン数に対応するトークンを返します。トークン数が正の場合、トークンは文字列の左端からカウントされます。トークン数が負の場合、トークンは文字列の右からカウントされます。

例

SPLIT ('a-b-c-d', '-', 2) = 'b'

SPLIT ('a|b|c|d', '|', -2) = 'c'

SQRT(number)

数値の平方根を返します。

例

SQRT(25) = 5

SQUARE(number)

数値の平方を返します。

例

SQUARE(5) = 25

STARTSWITH(string, substring)

string が substring で始まる場合は、true を返します。行頭の空白は無視されます。

例

STARTSWITH(“Joker”, “Jo”) = true

STDEV(expression)

サンプル母集団に基づいて、指定された式のすべての値の統計的標準偏差を返します。

STDEVP(expression)

バイアス母集団に基づいて、指定された式のすべての値の統計的標準偏差を返します。

STR(expression)

引数を文字列としてキャストします。

例

STR([Age]) は Age というメジャーのすべての値を文字列に変換します。

SUM(expression)

式内のすべての値の合計を返します。SUM に使用できるのは数値フィールドだけです。NULL 値は無視されます。

TAN(number)

角の正接を返します。角を弧度で指定します。

例

TAN(PI ( )/4) = 1.0

THEN

「IF THEN ELSE」と「CASE」を参照してください。

TIMESTAMP_TO_USEC(expression)

注: Google BigQuery に接続時のみサポート

TIMESTAMP データ型を UNIX タイムスタンプ (ミリ秒単位) に変換します。

例

TIMESTAMP_TO_USEC(#2012-10-01 01:02:03#)=1349053323000000

TLD(string_url)

注: Google BigQuery に接続時のみサポート

URL 文字列が指定された場合に、URL 内のトップ レベル ドメインと国ドメイン (ある場合) を返します。

例

TLD('http://www.google.com:80/index.html') = '.com'

TLD('http://www.google.co.uk:80/index.html') = '.co.uk'

TODAY( )

現在の日付を返します。

例

TODAY( ) = 2004-04-15

TOTAL(expression)

表計算パーティションで指定された式の合計を返します。

TRIM(string)

先頭と末尾の空白を削除した文字列を返します。たとえば、TRIM(" Calculation ") = "Calculation"

UPPER(string)

string のすべての文字を大文字に返します。

例

UPPER("Calculation") = "CALCULATION"

USEC_TO_TIMESTAMP(expression)

注: Google BigQuery に接続時のみサポート

UNIX タイムスタンプ (ミリ秒単位) を TIMESTAMP データ型に変換します。

例

USEC_TO_TIMESTAMP(1349053323000000) = #2012-10-01 01:02:03#

USERDOMAIN()

ユーザーが Tableau Server にサインオンしている場合は、現在のユーザーのドメインを返します。Tableau Desktop ユーザーがドメイン上に存在する場合は、Windowsドメインを返します。それ以外の場合は、この関数は NULL 文字列を返します。

例

[Manager]=USERNAME() AND [Domain]=USERDOMAIN()

USERNAME( )

現在のユーザーのユーザー名を返します。これは、ユーザーがサインインしている場合は Tableau Server または Tableau Cloud のユーザー名、それ以外の場合は Tableau Desktop ユーザーのローカルまたはネットワーク ユーザー名になります。

例

[Manager]=USERNAME( )

dhallsten というマネージャーがサインインしている場合、この関数が True を返すのは、ビューの "Manager (マネージャー)" フィールドが "dhallsten" であるときに限ります。この計算フィールドをフィルターとして使用すると、サーバーにサインインしているユーザーと関連性のあるデータのみを表示するユーザー フィルターを作成できます。

VAR(expression)

サンプル母集団に基づいて、指定された式のすべての値の統計的変異を返します。

VARP(expression)

母集団全体について、指定された式のすべての値の統計的変異を返します。

WEEK(date)

指定された日付の週の部分を整数として返します。

例

WEEK(#2022-03-29#) = 14

WHEN

「CASE」を参照してください。

WINDOW_AVG(expression, [start, end])

ウィンドウ内の式の平均を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

たとえば、次のビューには四半期ごとの売上高が示されています。日付パーティション内の期間平均は、全日付にわたって平均した売上高の値を返します。

例

WINDOW_AVG(SUM([Profit]), FIRST()+1, 0) は、2 行目から現在の行までの SUM(Profit) の平均を計算します。

WINDOW_CORR(expression1, expression2, [start, end])

ウィンドウ内の 2 つの式のピアソン相関係数を返します。ウィンドウは、現在の行からのオフセットとして定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

ピアソン相関係数は、2 つの変数の間の線形関係を測定します。結果は -1 から +1 の範囲となります。ここで、1 つの変数のプラスの変化はもう一方の変数の対応する倍率のプラスの変化を示し、1 は正確なプラスの直線関係を示します。0 は分布間に線形の関係がないことを示し、−1 は正確なマイナスの関係を示します。

同等の集計関数:CORR があります。

例

次の計算式は、5 行前から現在の行の SUM(Profit) および SUM(Sales) のピアソン相関係数を返します。

WINDOW_CORR(SUM[Profit]), SUM([Sales]), -5, 0)

WINDOW_COUNT(expression, [start, end])

ウィンドウ内の式の数を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

例

WINDOW_COUNT(SUM([Profit]), FIRST()+1, 0) は、2 行目から現在の行までの SUM(Profit) の件数を計算します。

WINDOW_COVAR(expression1, expression2, [start, end])

ウィンドウ内の 2 つの式の標本共分散を返します。ウィンドウは、現在の行からのオフセットとして定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始および終了引数を省略すると、ウィンドウはパーティション全体となります。

標本共分散では、母共分散によって (WINDOW_COVARP 関数で) 使用される n ではなく、non-null データ ポイントの数である n-1 を使用して共分散計算を標準化します。標本共分散は、データが大きな人口に対する共分散の見積もりに使用されるランダムなサンプルの場合に適しています。

同等の集計関数:COVAR があります。

例

次の計算式は、2 行前から現在の行の SUM(Profit) および SUM(Sales) の標本共分散を返します。

WINDOW_COVAR(SUM([Profit]), SUM([Sales]), -2, 0)

WINDOW_COVARP(expression1, expression2, [start, end])

ウィンドウ内で 2 つの式の母共分散を返します。ウィンドウは、現在の行からのオフセットとして定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

母共分散は標本共分散に (n-1)/n を乗算したものです。ここで、n は non-null データ ポイントの合計です。母共分散は、対象のすべてのアイテムに対して利用可能なデータがある場合に最適です。反対に、アイテムのランダムなサブセットのみがある場合には、標本共分散 (WINDOW_COVAR 関数を使用) が適しています。

同等の集計関数:COVARP があります。Tableau 関数 (アルファベット順)(新しいウィンドウでリンクが開く)を参照してください。

例

次の計算式は、2 行前から現在の行の SUM(Profit) および SUM(Sales) の母共分散を返します。

WINDOW_COVARP(SUM([Profit]), SUM([Sales]), -2, 0)

WINDOW_MAX(expression, [start, end])

ウィンドウ内の式の最大値を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

たとえば、次のビューには四半期ごとの売上高が示されています。日付パーティション内の期間最大値は、全日付にわたる売上高の最大値を返します。

例

WINDOW_MAX(SUM([Profit]), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の最大値を計算します。

WINDOW_MEDIAN(expression, [start, end])

ウィンドウ内の式の中央値を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

たとえば、次のビューには四半期ごとの利益が示されています。日付パーティション内のウィンドウの中央値は、全日付にわたる利益の中央値を返します。

例

WINDOW_MEDIAN(SUM([Profit]), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の中央値を計算します。

WINDOW_MIN(expression, [start, end])

ウィンドウ内の式の最小値を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

たとえば、次のビューには四半期ごとの売上高が示されています。日付パーティション内の期間最小値は、全日付にわたる売上高の最小値を返します。

例

WINDOW_MIN(SUM([Profit]), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の最小値を計算します。

WINDOW_PERCENTILE(expression, number, [start, end])

ウィンドウ内の指定した百分位値に対応する値を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

例

WINDOW_PERCENTILE(SUM([Profit]), 0.75, -2, 0) は、2 行前から現在の行に SUM(Profit) の 75% を返します。

WINDOW_STDEV(expression, [start, end])

ウィンドウ内の式のサンプルの標準偏差を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

例

WINDOW_STDEV(SUM([Profit]), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の標準偏差を計算します。

WINDOW_STDEVP(expression, [start, end])

ウィンドウ内の式のバイアス標準偏差を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

例

WINDOW_STDEVP(SUM([Profit]), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の標準偏差を計算します。

WINDOW_SUM(expression, [start, end])

ウィンドウ内の式の合計を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

たとえば、次のビューには四半期ごとの売上高が示されています。日付パーティション内で計算される期間合計は、全四半期にわたる売上高の合計を返します。

例

WINDOW_SUM(SUM([Profit]), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の合計を計算します。

WINDOW_VAR(expression, [start, end])

ウィンドウ内の式の標本分散を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

例

WINDOW_VAR((SUM([Profit])), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の分散を計算します。

WINDOW_VARP(expression, [start, end])

ウィンドウ内の式のバイアス分散を返します。ウィンドウは現在の行からのオフセットにより定義されます。パーティション内の最初または最後の行からのオフセットには、FIRST()+n および LAST()-n を使用してください。開始と終了を省略すると、パーティション全体が使用されます。

例

WINDOW_VARP(SUM([Profit]), FIRST()+1, 0) は、2 番目の行から現在の行までの SUM(Profit) の分散を計算します。

XPATH_BOOLEAN(XML string, XPath expression string)

注: Hadoop Hive に接続時のみサポート

XPath 式がノードに一致した場合、または true に評価された場合に true を返します。

例

XPATH_BOOLEAN('<values> <value id="0">1</value><value id="1">5</value>', 'values/value[@id="1"] = 5') = true

XPATH_DOUBLE(XML string, XPath expression string)

注: Hadoop Hive に接続時のみサポート

XPath 式の浮動小数点値を返します。

例

XPATH_DOUBLE('<values><value>1.0</value><value>5.5</value> </values>', 'sum(value/*)') = 6.5

XPATH_FLOAT(XML string, XPath expression string)

注: Hadoop Hive に接続時のみサポート

XPath 式の浮動小数点値を返します。

例

XPATH_FLOAT('<values><value>1.0</value><value>5.5</value> </values>','sum(value/*)') = 6.5

XPATH_INT(XML string, XPath expression string)

注: Hadoop Hive に接続時のみサポート

XPath 式の数値を返します。または、XPath 式が数字に評価できない場合はゼロを返します。

例

XPATH_INT('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_LONG(XML string, XPath expression string)

注: Hadoop Hive に接続時のみサポート

XPath 式の数値を返します。または、XPath 式が数字に評価できない場合はゼロを返します。

例

XPATH_LONG('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_SHORT(XML string, XPath expression string)

注: Hadoop Hive に接続時のみサポート

XPath 式の数値を返します。または、XPath 式が数字に評価できない場合はゼロを返します。

例

XPATH_SHORT('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_STRING(XML string, XPath expression string)

注: Hadoop Hive に接続時のみサポート

最初に一致したノードのテキストを返します。

例

XPATH_STRING('<sites ><url domain="org">http://www.w3.org</url> <url domain="com">http://www.tableau.com</url></sites>', 'sites/url[@domain="com"]') = 'http://www.tableau.com'

YEAR (date)

指定された日付の年の部分を整数として返します。

例

YEAR(#2004-04-15#) = 2004

ZN(expression)

式が NULL でない場合は式を返し、それ以外は 0 を返します。NULL 値の代わりにゼロ値を使用するには、この関数を使用してください。

例

ZN([Profit]) = [Profit]

関数についてより詳しく知りたいですか？

関数のトピック(新しいウィンドウでリンクが開く)をご覧ください。

関連項目

Tableau 関数 (カテゴリ別)(新しいウィンドウでリンクが開く)

Tableau で使用する関数(新しいウィンドウでリンクが開く)