Looker 錯誤目錄

下表列出 Looker 中顯示的一些常見錯誤訊息、根本原因和發生位置，以及疑難排解資源。錯誤會按照向 Looker 支援團隊回報的頻率降序排列，最上方是支援要求數量最多的錯誤。

「位置」欄會指出錯誤訊息在 Looker 中的顯示位置，並包含下列選項 (部分錯誤可能會出現在產品中的多個位置)：

IDE = LookML 驗證工具/IDE

Ex = 探索

SQL = SQL Runner

LD = LookML 資訊主頁

D = 資訊主頁

S = Schedules

錯誤訊息	位置	可能原因	疑難排解資源
Variable not found (?).	IDE	變數參照的 Liquid {{ }} 會巢狀內嵌於邏輯的 Liquid {% %} 中。 範本篩選器參照的資料表未加入衍生資料表。 Liquid 中參照的欄位未完全以檢視區塊名稱 (view_name.field_name) 做為範圍。 篩選條件的值在另一個 LookML 資訊主頁篩選條件中參照。 parameter 參數的值與對應的 type 不相容。舉例來說：{% if parameters.change_value._parameter_value == "'AA'" %} 請查看 parameter type，確保值評估正確 (type: string 與 type: unquoted 相比)。 Liquid 中正確參照的欄位為 view_name.field_name，但範圍檢視 view_name 中未定義 field_name，或檢視在 Explore 中以 from 別名表示。 變數的 Liquid 參照未定義，或參照包含錯字。 Liquid 參照包含 type: time 的維度群組，但不包含特定時間範圍。例如，參考資料應使用 {{ view_name.creation_date_year }}，而非 {{ view_name.creation_date }}。 欄位使用 Liquid 和 LookML 替代運算子語法 ${view_name.field_name}，而非 view_name.field_name。	Liquid 變數參考資料 範本篩選器和衍生資料表 (社群貼文) from (適用於探索) from (適用於聯結) 維度群組必須由個別維度參照
Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?).	IDE	參照的檢視畫面不存在。 缺少聯結，導致部分探索無法存取檢視畫面。 在「探索」中，檢視區塊會以 from 參數重新命名。	錯誤：不明或無法存取的欄位 (最佳做法頁面) from (適用於探索) from (適用於聯結)
Unknown or inaccessible field (?). Check for typos or append a timeframe to the name if the field is type time.	IDE	錯誤 Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?). 的任何可能原因都適用，此外，以下原因也可能導致此錯誤： 欄位名稱或欄位參照有誤。 系統會根據 fields 參數，將該欄位排除在「探索」之外。 參照的 dimension_group 未指定時間範圍。	fields (適用於探索) fields (適用於聯結) 維度群組必須由個別維度參照
Unknown view (?).	IDE Ex SQL	模型檔案未包含檢視畫面。 explore 正在擴充缺少 view_name 參數的基礎 explore。 explore 參數中定義的探索名稱是以拼字錯誤或不存在的檢視區塊名稱為依據。 以模型為基礎的 SQL Runner 查詢正在執行，但選取的模型不正確。	include 模型參數參考資料 extends (適用於探索) explore 參數 在 SQL Runner 中針對 LookML 模型執行查詢
Unknown view (?). View does not exist in model (?). Check for typos or missing include statements.	IDE Ex SQL	explore 擴充的基礎 explore 缺少 view_name 參數，且任何已聯結檢視區塊的欄位都會參照基礎 explore 名稱。 欄位參照的檢視區塊拼字錯誤、不存在，或未加入適用的探索。	extends (適用於探索) 設定 LookML 物件的範圍和命名
Unknown field (?) in filter	IDE	原生衍生資料表 (NDT) 定義包含自訂欄位上的 bind_all_filters 參數，但該參數未在 LookML 中定義。 LookML 篩選器參照了已註解或不存在的 LookML 欄位。 LookML 篩選器參照不同檢視區塊的 LookML 欄位，且該欄位並未完全限定範圍，也未加入所有相關的 explore 參數。	原生衍生資料表 explore_source 參照 filters LookML 資訊主頁 always_filter 參考資料 access_filter 參考資料 filters 適用於措施
Measures with Looker aggregations (sum, average, min, max, list types) may not reference other measures.	IDE	在另一個匯總類型指標的 SQL 定義中參照指標。	評估類型類別參考資料 錯誤：使用 Looker 匯總 (總和、平均值、最小值、最大值、清單類型) 的指標可能無法參照其他指標 (最佳做法頁面) 如何在 Looker 中將指標劃分為維度 (最佳做法頁面)
Unknown view (?). View (?) does not exist in model (?). Check for typos or missing include statements in (?).	IDE	模型檔案中未包含檢視區塊，或包含檢視區塊但拼字錯誤。	無法開始使用模型/檢視畫面/探索 (社群貼文) include 模型參數參考資料
Can't construct persistent derived table (?), connection (?) could not be registered	IDE Ex	現有 PDT 的任何依附元件都無法建構。 連線發生問題，需要測試連線來診斷問題 (例如，測試連線可能會顯示 Looker 使用者可能沒有足夠的資料庫擁有或寫入存取權)。 匯入的專案檔案 (例如定義失敗 PDT 的檢視區塊，或失敗 PDT 參照的檢視區塊) 不會納入匯入專案。 資料庫連線未啟用「永久衍生資料表」設定。 如果 Looker Block 的程式碼與連線的 SQL 方言不同，則程式碼尚未更新為連線的 SQL 方言。 已為 Snowflake 或 BigQuery 連線啟用 OAuth。 Snowflake 資料庫 AUTOCOMMIT 參數已設定為預設值 TRUE 以外的值。	在 Looker 中測試資料庫連線 包括從匯入專案取得的檔案 永久衍生資料表連線設定 BigQuery 連線的 OAuth Snowflake 連線的 OAuth
Unknown or excluded suggest_dimension (?) in field (?)	IDE	suggest_dimension 參數參照的欄位不存在、已加上註解，或已透過 fields 參數排除在探索之外。 suggest_dimension 參數參照的欄位定義於其他檢視區塊，但未在參照中完整設定範圍為 view_name.field_name。 suggest_dimension 參數參照其他檢視畫面中的欄位，但該欄位未加入所有相關的 explore 參數，或參照 explore 中以 from 參數別名的檢視畫面。	錯誤：不明或無法存取的欄位 (最佳做法頁面) suggest_dimension 參數參考資料 from (適用於探索) from (適用於聯結) fields (適用於探索) fields (適用於聯結)
A view named (?) has been defined multiple times. Each view in a model must have a unique name.	IDE	相同模型中參照的檢視表名稱相同，包括匯入專案的檢視表。模型中的檢視區塊名稱不得重複。	view 參數參考資料
This include does not match any files	IDE	檔案路徑有錯字，導致發生錯誤。 資料夾參照使用的語法有誤。 專案匯入參照使用的語法有誤。	include 模型參數參考資料 使用 include 與 IDE 資料夾 包括從匯入專案取得的檔案 參照匯入專案中的檔案
SQL Dialect does not support Symmetric Aggregates with percentiles, field ignored.	Ex	資料庫方言不支援使用對稱匯總的 type: median 或 type: percentile 測量值。	並非所有資料庫方言都支援 median 或 percentile 具有對稱匯總的指標類型 瞭解對稱匯總 (最佳做法頁面)
Cannot use native derived table (?) with bind_all_filters outside of its source explore (?)	IDE Ex	含有 bind_all_filters 參數的原生衍生資料表會與一或多個「探索」聯結，但不會與 explore_source 參數中定義的「探索」聯結。	使用 bind_all_filters
Measures of type count do not use the sql parameter. Use count_distinct to count by something other than the primary key, or remove the sql parameter.	IDE	sql 參數用於 type: count 的測量值。計數類型指標會依據檢視區塊檔案中宣告的主鍵執行計數，不需要 sql 參數。	count 評估類型參考資料 如何計算非主要鍵 (社群貼文)
An explore named (?) has been defined multiple times. Each explore in a model must have a unique name.	IDE LD	模型檔案 explore 參數中定義的探索名稱，與現有的其他探索名稱重複。模型中的探索名稱不得重複。 匯入的專案含有與匯入專案中現有 explore 同名的 explore。 內含模型檔案的 explore 與內含專案模型檔案中的現有 explore 同名。* 程式碼中存在循環參照，多次參照 explore (或模型檔案)。 * 不建議在其他模型檔案中加入模型檔案。	explore 參數參考資料 在模型中納入模型
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml?	IDE	模型包含檢視畫面資料夾，但特定檢視畫面檔案位於資料夾外。 如果檢視區塊的命名方式不同，模型會包含檢視區塊的名稱，但不會包含檢視區塊檔案。 檢視區塊多次加入 explore，但第二次加入時缺少 from 參數。	使用 include 與 IDE 資料夾 include 參數參考資料 您可以使用 from 多次彙整同一個資料表
Unknown field '(?)'	IDE Ex	您嘗試參照的欄位不存在、拼字錯誤或已加上註解。 參照的欄位是在不同檢視區塊中定義，且未以檢視區塊名稱做為範圍。 欄位是在未併入必要探索的不同檢視區塊中定義，或檢視區塊在彙整中已別名化，導致部分探索無法存取該欄位。 required_fields 參數參照的欄位無法存取、拼字錯誤、不存在或已註解。	錯誤：不明或無法存取的欄位 (最佳做法頁面) from (適用於探索) from (適用於聯結) required_fields 參數參考資料
Cannot use (?) as access filter since any user can edit their own value.	Ex	在「探索」的 access_filter 參數中，使用「使用者屬性」，並將「使用者存取權」選項設為「編輯」。	建立使用者屬性 在存取篩選器中使用使用者屬性 access_filter 參數參考資料
label_from_parameter of (?) must refer to a parameter.	IDE Ex	label_from_parameter 參數參照的欄位不存在、拼字錯誤或已註解。 label_from_parameter 參數參照的欄位存在，但不是 parameter 型別。	label_from_parameter 參數參考資料 parameter 參數參考資料
Cannot use user-editable attribute (?) for access_grant (?)	IDE Ex	模型檔案的 access_grant 參數中，使用「使用者存取權」選項設為「編輯」的使用者屬性。	建立使用者屬性 使用存取權授權控管存取權 access_grant 參數參考資料
datagroup (?) has a sql_trigger. This is not allowed in models with a parameterized connection.	IDE	資料庫連線使用使用者屬性做為資料庫登入憑證，且 PDT 覆寫欄未針對 PDT 程序設定個別資料庫使用者。	在資料庫連線中使用使用者屬性 為 PDT 程序設定個別登入憑證 datagroup 和 sql_trigger 參數參照
relationship missing, assumed to be many_to_one.	IDE	未定義聯結的 relationship。如未指定 relationship，Looker 預設會採用 many-to-one 關係。	relationship 參數參考資料
No distribution_style specified in persistent derived table (?). Using default distribution style (?).	IDE	Redshift 連線 PDT 的 derived_table 定義中未指定 distribution_style 參數。如未指定 distribution_style，Looker 預設為 ALL。	distribution_style 參數參考資料
always_filter: unknown filter field '(?)'	IDE	always_filter 參數參照的欄位不存在、拼字錯誤或已註解。 always_filter 參數參照的欄位是 type: time 的 dimension_group，且未附加時間範圍。 always_filter 參數參照的欄位是在未加入所有相關 explore 參數的檢視區塊中定義，或是欄位未以檢視區塊名稱做為範圍。	錯誤：不明或無法存取的欄位 (最佳做法頁面) 維度群組必須由個別維度參照 always_filter 參數參考資料
The location field type requires both sql_latitude and sql_longitude.	IDE	type: location 欄位缺少 sql_latitude 或 sql_longitude 子參數。地點類型欄位必須同時提供這兩項資訊。	location 欄位類型參考資料
Missing required sql_step in create_process of derived table '(?)'.	IDE	create_process 中未指定 sql_step，但需要一或多個 sql_step 子參數。 即使已新增 sql_step，快取 LookML 驗證工具錯誤仍會標示缺少 sql_step。再次驗證，解決錯誤。	create_process 參數參考資料
Can't construct aggregate table (?), temporary schema for (?) is unset.	IDE Ex	「管理」面板的「連線設定」頁面中，連線未設定「永久衍生資料表」，且/或「暫時資料庫」設定中未指定暫時資料庫結構定義。	永久衍生資料表連線設定參考資料 暫存資料庫連線設定參考資料
Can't construct aggregate table (?), connection (?) could not be registered.	IDE Ex	連線的「連線設定」頁面 (位於「管理」面板) 未設定「暫時資料庫」，或 Looker 沒有適當權限，無法存取「暫時資料庫」設定中指定的暫時資料庫。	匯總資料表必須保留 暫存資料庫連線設定參考資料
Unknown view (?) referenced by explore (?)	IDE	系統會使用預設的 include: "*.view.lkml" 納入檢視畫面，但該檢視畫面位於不同資料夾中。 include 陳述式中的檢視區塊名稱或檔案路徑有誤，或者 include 陳述式包含檢視區塊名稱，但如果名稱不同，則不包含檢視區塊檔案。 資料夾中的特殊字元 (例如 _views) 有問題。 explore 正在擴充另一個缺少指定基本檢視區塊的 view_name 參數的 explore。	include 參數參考資料 使用 include 與 IDE 資料夾 extends (適用於探索) view_name 參數參考資料
The location field type does not use the sql parameter. Please use sql_latitude and sql_longitude instead.	IDE	sql 參數用於 type: location 的欄位。地點類型欄位需要 sql_latitude 和 sql_longitude 子參數，而非 sql 參數。	location 欄位類型參考資料
A list_field must be defined for measures of type list.	IDE Ex	如要從欄位產生清單，必須為 type: list 的指標指定欄位。	list 欄位類型參考資料
Query failed with unexpected exception (?)	IDE Ex SQL LD D S	在「管理」面板的連線「連線設定」頁面中，PDT 覆寫欄指定了主要連線資料庫以外的資料庫。 已超過每位使用者的查詢限制，且佇列查詢已達到連線集區逾時。 JDBC 連線失敗。 發生未預期的 Looker 應用程式故障。	為 PDT 程序設定個別登入憑證 連線集區逾時 Looker 啟動選項 查詢逾時和排隊 連線設定其他參數 (包括 JDBC 參數)
Looker is having trouble connecting to your database.	Ex SQL	連線的連線集區上限已達，且連線集區逾時時間間隔已過，因此佇列查詢已逾時。	「Looker 無法連線至您的資料庫」錯誤訊息是什麼意思？(社群貼文) 「Max Connections」連線設定參考資料 連線集區連線設定參考資料
SQL Error in incremental PDT: Query execution failed	Ex D S	以 SQL 為基礎的漸進式 PDT 參照的一或多個資料表，其基礎結構定義已變更。	增量 PDT 在結構定義變更後無法建構
Missing dates/values for '(?)' were not filled.	Ex	您在探索中選取了多個維度，因此無法套用維度填補功能。 由於您在「探索」中透視一或多個欄位，因此無法套用維度填滿。 由於欄位含有不同的字串值 (例如 allowed_value 或 case 參數)，且該欄位已套用篩選器，因此無法套用維度填入功能。	填入遺漏的日期和值
filters: ` is not supported for measures of non-aggregate type '(?)'	IDE Ex	filters 參數用於下列以外的任何測量類型：count、sum、average 和 count_distinct。	filters 參數參考資料 建立動態篩選的度量
Unknown source explore (?) in lookml test (?) declaration.	IDE	資料測試的 explore_source 子參數中使用了拼字錯誤、不存在或已註解的探索名稱。 資料測試定義於不含或未納入「探索」explore_source定義的檔案中。 具有 extension: required 參數規格的探索會做為資料測試的 explore_source。	test 參數參考資料 explore_source (適用於資料測試) LookML 資料測試建議和最佳做法 (社群貼文)
filter_expression: is not supported for measures of non-aggregate type '(?)'	IDE Ex	filters_expression 參數用於下列以外的任何指標類型：count、sum、average 或 count_distinct。	filter_expression LookML 資訊主頁查詢參數參考資料 (適用於瀑布圖) LookML 資訊主頁查詢參數參考資料 (適用於表格圖表)
Field references an aggregate but is specified as a dimension. If you want to use aggregations such as sum, average, count, use a measure type instead.	IDE Ex	維度會在 sql 參數中參照指標或其他匯總	維度和指標欄位 sql (適用於維度)
Cannot specify both sql_table_name and derived_table for view (?)	IDE	檢視畫面同時定義了 sql_table_name 和 derived_table 參數。一個檢視區塊只能參照一個資料表，也就是資料庫連線中具有 sql_table_name 的現有結構定義，或是具有 的新資料表。 derived_table	view 參數參考資料 sql_table_name (適用於觀看次數) derived_table 參數參考資料
Persistent Native Derived Table for view (?) has an explore source (?) that has access filters. Persisting this table may result in unexpected behavior.	IDE	持續性 NDT 是以含有 access_filter 參數的「探索」為基礎，該參數會參照使用者屬性。	決定是否要保留衍生資料表時的注意事項 access_filter 參數參考資料
Unknown or unexpected parameter "(?)" in (?).	IDE	使用的 distribution_style 參數不支援該方言 使用的 cluster_keys 參數不支援該方言 sql_always_where 參數是在 join 中定義，而不是在 explore 中。 dimension_group 中定義的時間範圍不是 type: time。 sql_distinct_key 參數是在維度中定義，而非在指標中定義。	distribution_style 方言支援 cluster_keys 方言支援 dimension_group 欄位類型參考資料 sql_distinct_key 參數參考資料
Could not find the constant	IDE	常數是從匯入專案參照匯入專案，且只在匯入專案中定義。常數只能在定義常數的專案中參照。您需要在資訊清單檔案中重新定義常數。	在匯入專案的檔案中使用常數
Multiple primary key definitions for view '(?)': '(?)' and '(?)'	IDE	檢視檔案中存在多個主鍵。指定為主鍵的維度超過一個 (使用 primary_key: yes)，或擴充檢視區塊指定新的維度做為主鍵 (使用 primary_key: yes)。	primary_key 參數參考資料 extends (適用於觀看次數) 使用 extends 重複使用程式碼
Persistent Native Derived Table for view (?) references user attributes. Persisting this table may result in unexpected behavior.	IDE	持續性 NDT 或匯總認知度表格是以 explore 為基礎，並包含參照使用者屬性的 access_filter 或 sql_always_where 參數。	決定是否要保留衍生資料表時的注意事項 access_filter 參數參考資料 sql_always_where 參數參考資料 建立原生衍生資料表 匯總認知度
No map layer named (?) is defined. Must be one of countries, uk_postcode_areas, us_counties_fips, us_states, us_zipcode_tabulation_areas	IDE	如果欄位檢視畫面中所有模型都沒有定義地圖圖層，維度就會參照 map_layer_name 的地圖圖層。舉例來說，某個檢視區塊包含在多個模型中，但地圖圖層只在一個模型中定義。	map_layer 參數參考資料 map_layer_name內建地圖圖層
Persistent derived table (?) should include at least one index	IDE	PDT 或匯總資料表定義包含 index，但未指定 PDT 或匯總資料表資料欄。	indexes 參數參考資料 永久衍生資料表參照 aggregate_table 參數參考資料
The x database encountered an error while running this query.	Ex SQL	資料庫找不到欄位 sql 參數參照的資料欄。可能原因如下： sql 參數參照的資料表或資料欄名稱有誤。 資料庫中的基礎資料 (例如資料欄名稱) 已變更。	Looker 中常見的 SQL 錯誤疑難排解提示 (社群貼文)
Render job (?) failed [orphaned job]	S	排定工作執行時，Looker 執行個體無法使用。這可能發生在版本更新和排定的維護作業期間。	Looker 代管服務的 Google 維護政策