用量
view: view_name {
dimension: field_name {
convert_tz: yes | no
}
}
|
階層
convert_tz |
可能的欄位類型
維度、維度群組、測量指標、篩選器、參數
接受
布林值 (是或否)
|
定義
Looker 提供多種時區設定，可在不同時區之間轉換時間資料。Looker 預設會轉換時區。如果不希望 Looker 針對特定 dimension、dimension_group (含 type: time) 或 filter 欄位執行時區轉換，可以使用 convert_tz 參數。如果欄位已轉換為適當時區，或在某些進階情況下需要避免重複轉換時區，這個參數就很有用。
一般來說，只有在所有時間值都轉換為相同時區時，時間計算 (差異、持續時間等) 才能正確運作。編寫 LookML 時，請務必考量時區。
範例
不要為 local_created 維度群組執行時區轉換：
dimension_group: local_created {
type: time
timeframes: [time, date, week, month]
sql: ${TABLE}.local_created_at ;;
convert_tz: no
}
注意事項
convert_tz: no 僅適用於維度，不適用於使用該維度的篩選器。換句話說，篩選器「一律」會轉換時區。指定 convert_tz: no 時，系統會以資料庫時區顯示時間資料值，但會使用查詢時區篩選。
由於篩選器一律會轉換時區，因此資料庫時區和查詢時區之間的差異，可能會導致資料集意外納入或排除資料。為避免這種情況，請務必將查詢時區設為與資料庫時區相同的值。
如果已啟用「使用者專屬時區」，請將時區下拉式選單 (位於「探索」、「Look」和資訊主頁的「執行」按鈕旁) 設為與資料庫時區相同的值。如果停用「使用者專屬時區」，請將「查詢時區」設為與資料庫時區相同的值。
如果您使用自訂篩選器，請務必啟用時區轉換功能，確保日期比較結果有效。如果您使用 convert_tz: no 關閉時區轉換功能，並在自訂篩選器中加入該欄位，日期比較可能會無效。
支援時區轉換的資料庫方言
資料庫用語必須支援時區轉換，Looker 才能轉換 Looker 專案中的時區。下表列出最新版 Looker 中，支援時區轉換的方言：
| 方言 | 是否支援？ |
|---|---|
| Actian Avalanche | |
| Amazon Athena | |
| Amazon Aurora MySQL | |
| Amazon Redshift | |
| Amazon Redshift 2.1+ | |
| Amazon Redshift Serverless 2.1+ | |
| Apache Druid | |
| Apache Druid 0.13.x - 0.17.x | |
| Apache Druid 0.18+ | |
| Apache Hive 2.3+ | |
| Apache Hive 3.1.2+ | |
| Apache Spark 3+ | |
| ClickHouse | |
| ClickHouse 26+ | |
| Cloudera Impala 3.1+ | |
| Cloudera Impala 3.1+ with Native Driver | |
| Cloudera Impala with Native Driver | |
| DataVirtuality | |
| Databricks | |
| Denodo 7 | |
| Denodo 8 & 9 | |
| Dremio | |
| Dremio 11+ | |
| Dremio 26+ with Arrow Flight SQL | |
| Exasol | |
| Google BigQuery Legacy SQL | |
| Google BigQuery Standard SQL | |
| Google Cloud AlloyDB for PostgreSQL | |
| Google Cloud PostgreSQL | |
| Google Cloud SQL | |
| Google Spanner | |
| Greenplum | |
| HyperSQL | |
| IBM Netezza | |
| MariaDB | |
| Microsoft Azure PostgreSQL | |
| Microsoft Azure SQL Database | |
| Microsoft Azure Synapse Analytics | |
| Microsoft SQL Server 2008+ | |
| Microsoft SQL Server 2012+ | |
| Microsoft SQL Server 2016 | |
| Microsoft SQL Server 2017+ | |
| MongoBI | |
| MongoSQL | |
| MySQL | |
| MySQL 8.0.12+ | |
| Oracle | |
| Oracle ADWC | |
| PostgreSQL 9.5+ | |
| PostgreSQL pre-9.5 | |
| PrestoDB | |
| PrestoSQL | |
| SAP HANA | |
| SAP HANA 2+ | |
| SingleStore | |
| SingleStore 7+ | |
| Snowflake | |
| Teradata | |
| Trino | |
| Vector | |
| Vertica |