このページでは、Explore の一部である
sql_table_nameパラメータについて説明します。
sql_table_nameは、sql_table_name（ビューの場合）のパラメータ ドキュメント ページで説明されているように、ビューの一部としても使用できます。
sql_table_nameは、sql_table_name（結合の場合）パラメータのドキュメント ページで説明されているように、結合の一部としても使用できます。
用途
explore: explore_name {
sql_table_name: table_name ;;
}
sql_table_name |
デフォルト値
Explore のビューのベースとなるデータベース テーブル
許可
データベース テーブルの名前
特別なルール
|
定義
sql_table_name は、Explore によってクエリされるデータベース内のテーブルを設定します。通常、Explore の名前が付けられたビューは、クエリされるテーブルを定義します。ただし、複数のテーブルの構造が同じ場合は、同じビューを使用してすべてのテーブルを記述できます。sql_table_name を使用すると、使用するテーブルを指定できます。
テーブル名のスコープ設定
テーブル名を単独で使用してテーブルを参照すると、Looker は Looker 管理者がデータベース接続の設定で構成したデフォルトの検索パス（データベースとスキーマ）を使用します。詳しくは、このページの考慮事項をご覧ください。
データベース ユーザーのデフォルトの検索パスにない別のデータベースとスキーマのテーブルを参照する必要がある場合は、<database_name>.<schema_name>.<table_name> 形式を使用してテーブル名をスコープし、別のデータベースまたはスキーマを指すことができます。
- 別のスキーマのテーブルを参照するには、このページの例に示すように、
<schema_name>.<table_name>を使用します。 - 別のデータベースのテーブルを参照するには、完全な
<database_name>.<schema_name>.<table_name>を使用します。
Google BigQuery 接続の場合、<project_name>.<dataset_name>.<table_name> 形式でテーブル名をスコープ設定することで、別のプロジェクトとデータセットのテーブルを参照できます。詳細については、Google BigQuery 接続のドキュメント ページをご覧ください。
例
この例では、customers Explore がデフォルトのデータベース/スキーマの customer_1 テーブルに依存するようにします。
explore: customers {
sql_table_name: customer_1 ;;
}
この例では、テーブル名をスキーマ名を含むようにスコープ設定（<schema_name>.<table_name> 形式を使用）することで、customers Explore が analytics スキーマの customer_1 テーブルに依存するようにします。
explore: customers {
sql_table_name: analytics.customer_1 ;;
}
注意点
sql_table_name で参照されるテーブルは、現在の接続からアクセス可能である必要があります
explore オブジェクト内で sql_table_name パラメータが使用されると、その explore オブジェクトは モデル オブジェクトに含められます。（このページの [階層] に、この関係チェーンが表示されます）。モデル オブジェクトには、定義されたデータベース connection があります。sql_table_name パラメータでデータベース テーブルを参照する場合、モデルファイルで指定された関連付けられた接続内でテーブルにアクセスできる必要があります。
デフォルトのデータベースとスキーマ（または Google BigQuery の場合は課金プロジェクトとデータセット）は、Looker 管理者がデータベース接続の データベースへの Looker 接続を作成するときに定義します。
view に基盤となるテーブルとは異なる名前を付けるには、view レベルで sql_table_name を適用します。
このページで説明しているように、explore レベルで sql_table_name を使用することはあまり一般的ではありません。同じ view で複数のテーブルを記述できる場合にのみ使用してください。
より一般的な方法は、基盤となるテーブル名とは異なるビューに名前を付ける場合に、view レベルで sql_table_name を使用することです。
つまり、次のようになります。
モデルファイル
explore: customers {
sql_table_name: customer_1 ;;
}
方法
モデルファイル
explore: customers { ... }
ファイルを表示
view: customers {
sql_table_name: customer_1 ;;
}