本頁面是指 探索中的
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 |
預設值
「探索」檢視畫面所依據的資料庫資料表
接受
資料庫表格的名稱
特別規則
|
定義
sql_table_name 會設定資料庫中的資料表，供「探索」查詢。通常，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 探索會依據預設資料庫/結構定義中的 customer_1 資料表：
explore: customers {
sql_table_name: customer_1 ;;
}
這個範例會設定資料表名稱的範圍，加入結構定義名稱 (使用 <schema_name>.<table_name> 格式)，讓 customers 探索依附於 analytics 結構定義中的 customer_1 資料表：
explore: customers {
sql_table_name: analytics.customer_1 ;;
}
注意事項
sql_table_name 參照的資料表必須可透過目前的連線存取
在 explore 物件中使用 sql_table_name 參數時，該 explore 物件會隨即納入 model 物件。(本頁的「階層」會顯示這個關係鏈。)模型物件中定義了資料庫 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 ;;
}