--- schema_version: "1" id: 58577a5e4fae9d617566b5dc7ea6a39ac8aaee263809bbd6190f4261d52ed764 title: パススルー関数 (RAWSQL) collection: tableau version: current locale: ja-jp portal_url: https://docs.salesforce.com/tableau/current/ja-jp/public/desktop/functions_functions_passthrough.md canonical_url: https://help.tableau.com/current/public/desktop/ja-jp/functions_functions_passthrough.htm source_site: help.tableau.com content_type: documentation content_hash: b2743d97e8a471f10f6e0ba7b45e6320be70db20d0ee19a85549317d926402be description: Reference for RAWSQL pass-through functions that send SQL directly to the database. --- [メイン コンテンツに進む](#main-content) # パススルー関数 (RAWSQL) これらの RAWSQL パススルー関数は、SQL 式を、Tableau による最初の解釈なしで、データベースに直接送信します。Tableau で認識されていないカスタム データベース関数がある場合は、パススルー関数を使用して、これらのカスタム関数を呼び出すことができます。 Tableau では式が解釈されないため、必要に応じて、集計を定義する必要があります。集計式を渡す必要がある場合は、`RAWSQLAGG` バージョンの関数を使用できます。 RAWSQL パススルー関数は、フェデレーション データ ソース (異なるデータベース間で組み合わされた) やパブリッシュされたデータ ソースでは動作しない場合があります。 ## RAWSQL 構文 RAWSQL 関数には、非集計と集計の 2 つのタイプがあります。これは、関数名の最初の部分である _RAWSQL_ または _RAWSQLAGG_ で指定されます。関数名の最後の部分は、_BOOL_、_STR_、_INT_ などの出力タイプです。すべての RAWSQL 関数で、引数は `"sql_expr", [arg1], ...[arg2]` になります。関数を記述するときには、代替構文 `%n` を使用して、正しいフィールド名または式を挿入できます。 ### %n 代入構文 通常、データベースは Tableau に表示されているフィールド名を理解できません。パススルー関数内の SQL 式は Tableau によって解釈されないため、式で Tableau フィールド名を使用すると、エラーが発生することがあります。`%n` を使用して、Tableau 計算のための正しいフィールド名または式をパススルー SQL に挿入します。 たとえば、いくつかの値の中央値を計算する関数があると、この関数を Tableau 列 \[Sales\] に対して呼び出す方法は次のとおりです。 RAWSQLAGG\_REAL("MEDIAN(%1)", \[Sales\]) - `REALSQLAGG` を使用する理由は、集計を指定する必要があるためです。 - `REAL` を使用する理由は、出力が数値であり、必ずしも整数ではないためです。 - `MEDIAN` は集計です。 - `%1` は `[Sales]` のプレースホルダーです。 ## RAWSQL 関数 SQL 式は参照元データベースに直接渡されます。SQL 式では、データベース値の代替構文として %n を使用してください。 Tableau では、次の RAWSQL 関数を利用できます。 ### RAWSQL\_BOOL
構文 RAWSQL_BOOL("sql_expr", [arg1], …[argN])
出力 ブール値
定義 指定された SQL 式からブールの結果を返します。
例 
RAWSQL_BOOL("%1 > %2", [Sales], [Profit])

次の例では、%1 は [Sales]、%2 は [Profit] に等しくなります。
### RAWSQLAGG\_BOOL
構文 RAWSQLAGG_BOOL("sql_expr", [arg1], …[argN])
出力 ブール値
定義 指定された集計 SQL 式からブールの結果を返します。
例 
RAWSQLAGG_BOOL("SUM( %1) >SUM( %2)", [Sales], [Profit])

次の例では、%1 は [Sales]、%2 は [Profit] に等しくなります。
### RAWSQL\_DATE
構文 RAWSQL_DATE("sql_expr", [arg1], …[argN])
出力 日付
定義 指定された SQL 式から日付の結果を返します。
例 
RAWSQL_DATE("%1", [Order Date])

次の例では、%1 は [Order Date] に等しくなります。
### RAWSQLAGG\_DATE
構文 RAWSQLAGG_DATE("sql_expr", [arg1], …[argN])
出力 日付
定義 指定された集計 SQL 式から日付の結果を返します。
例 
RAWSQLAGG_DATE("MAX(%1)", [Order Date])

次の例では、%1 は [Order Date] に等しくなります。
### RAWSQL\_DATETIME
構文 RAWSQL_DATETIME("sql_expr", [arg1], …[argN])
出力 日時
定義 指定された SQL 式から日付時刻の結果を返します。
例 
RAWSQL_DATETIME("%1", [Order Date])

次の例では、%1 は [Order Date] に等しくなります。
### RAWSQLAGG\_DATETIME
構文 RAWSQLAGG_DATETIME("sql_expr", [arg1], …[argN])
出力 日時
定義 指定された集計 SQL 式から日付時刻の結果を返します。
例 
RAWSQLAGG_DATETIME("MIN(%1)", [Order Date])

次の例では、%1 は [Order Date] に等しくなります。
### RAWSQL\_INT
構文 RAWSQL_INT("sql_expr", [arg1], …[argN])
出力 整数
定義 指定された SQL 式から整数の結果を返します。
例 
RAWSQL_INT("500 + %1", [Sales])

次の例では、%1 は [Sales] に等しくなります。
### RAWSQLAGG\_INT
構文 RAWSQLAGG_INT("sql_expr", [arg1,] …[argN])
出力 整数
定義 指定された集計 SQL 式から整数の結果を返します。
例 
RAWSQLAGG_INT("500 + SUM(%1)", [Sales])

次の例では、%1 は [Sales] に等しくなります。
### RAWSQL\_REAL
構文 RAWSQL_REAL("sql_expr", [arg1], …[argN])
出力 数値
定義 指定された SQL 式から数値の結果を返します。
例 
RAWSQL_REAL("-123.98 * %1", [Sales])

次の例では、%1 は [Sales] に等しくなります。
### RAWSQLAGG\_REAL
構文 RAWSQLAGG_REAL("sql_expr", [arg1,] …[argN])
出力 数値
定義 指定された集計 SQL 式から数値の結果を返します。
例 
RAWSQLAGG_REAL("SUM( %1)", [Sales])

次の例では、%1 は [Sales] に等しくなります。
### RAWSQL\_SPATIAL
構文 RAWSQL_SPATIAL("sql_expr", [arg1], …[argN])
出力 空間
定義 指定された SQL 式から空間の結果を返します。
例 
RAWSQL_SPATIAL("%1", [Geometry])

次の例では、%1 は [Geometry] に等しくなります。
注 この関数の RAWSQLAGG バージョンはありません。
### RAWSQL\_STR
構文 RAWSQL_STR("sql_expr", [arg1], …[argN])
出力 文字列
定義 指定された SQL 式から文字列を返します。
例 
RAWSQL_STR("%1", [Customer Name])

次の例では、%1 は [Customer Name] に等しくなります。
### RAWSQLAGG\_STR
構文 RAWSQLAGG_STR("sql_expr", [arg1,] …[argN])
出力 文字列
定義 指定された集計 SQL 式から文字列を返します。
例 
RAWSQLAGG_STR("AVG(%1)", [Discount])

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