sql_table_name（Explore 用）

このページでは、Explore の一部である sql_table_name パラメータについて説明します。

sql_table_name は、ビューの一部として使用することもできます。詳しくは、sql_table_name（ビュー用）パラメータのドキュメントをご覧ください。

また、sql_table_name（結合用）パラメータのドキュメント ページに記載されているように、sql_table_name を結合の一部として使用することもできます。

使用状況

Explore: explore_name {
sql_table_name: table_name ;;
}

階層 モデルファイル explore sql_table_name

デフォルト値 Explore のビューに基づくデータベース テーブル 許可 データベース テーブルの名前 特別なルール sql_table_name は、同じビューが複数のテーブルを記述できる場合にのみ使用します。 sql_table_name で参照されるテーブルは、モデルのデータベース接続でアクセス可能である必要があります。

定義

sql_table_name は、Explore によってクエリされるデータベース内のテーブルを設定します。通常、Explore が命名されるビューでは、クエリ対象のテーブルが定義されます。ただし、複数のテーブルの構造が同じ場合は、同じビューを使用してすべてのテーブルを記述できます。sql_table_name では、使用するテーブルを指定できます。

別のデータベースやスキーマからテーブルを参照する必要がある場合は、database_or_schema_name.table_name を使用できます。データベース/スキーマを明示的に記述しない場合は、Looker は設定したデフォルトを使用します。デフォルトは、Looker の [管理] セクションの [接続] で構成します。

例

customers Explore がデフォルトのデータベース/スキーマの customer_1 テーブルに依存するようにします。

explore: customers {
  sql_table_name: customer_1 ;;
}

customers Explore が analytics データベース / スキーマの customer_1 テーブルに依存するようにします。

explore: customers {
  sql_table_name: analytics.customer_1 ;;
}

一般的な課題

sql_table_name で参照されているテーブルに、現在の接続からアクセスできる必要があります

sql_table_name は Explore の一部であり、Explore はモデルの一部です。このモデルでは、データベース接続が定義されています。sql_table_name で参照するテーブルは、そのデータベース接続内でアクセス可能である必要があります。

知っておくべきこと

基礎となる表とは異なる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 ;;
}