本頁面是指 探索中的
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 的命名檢視畫面會定義要查詢的資料表。不過，如果多個資料表具有相同結構，您可以使用 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
如本頁所述，在 sql_table_name explore 層級使用 view 並不常見，只有在相同 view 可說明多個表格時才應使用。
如要為檢視區塊命名，但名稱與基礎資料表名稱不同，更常見的做法是在 view 層級使用 sql_table_name。
換句話說，您不應使用下列指令：
模型檔案
explore: customers {
sql_table_name: customer_1 ;;
}
操作步驟：
模型檔案
explore: customers { ... }
查看檔案
view: customers {
sql_table_name: customer_1 ;;
}