Lookerエラーカタログ

下表は、Looker でよく表示されるエラー メッセージ、その根本原因と発生場所、トラブルシューティング リソースをまとめたものです。エラーは、Looker サポートに報告される頻度の高いものから順に（サポート リクエストの数が多い順に）表示されています。

[場所] 列は、Looker 内でエラー メッセージが表示されている場所を示しており、次のオプションがあります（一部のエラーはプロダクト内の複数の場所に表示されることがあります）。

IDE = LookML バリデータ / IDE

Ex = Explore

SQL = SQL Runner

LD = LookML ダッシュボード

D = ダッシュボード

S = スケジュール

エラー メッセージ ロケーション 考えられる原因 トラブルシューティング リソース
Variable not found (?). IDE
  • 変数参照用の Liquid（{{ }}）は、ロジック用の Liquid（{% %}）内にネストされています。
  • テンプレート化されたフィルタは、派生テーブルに結合されていないテーブルを参照します。
  • Liquid で参照されているフィールドは、ビュー名（view_name.field_name）で完全にスコープ指定されていません。
  • フィルタの値は、別の LookML ダッシュボード フィルタ内で参照されます。
  • parameter パラメータの値は、対応する type と互換性がありません。例: {% dynamic 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 }} ではなく {{view_name.creation_date_year }} を使用する必要があります。
  • フィールドでは、view_name.field_name のようにではなく、LookML 置換演算子構文 ${view_name.field_name} で Liquid を使用しています。
Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?). IDE
  • 参照されているビューが存在しません。
  • 結合がないため、一部の Explore でビューにアクセスできなくなります。
  • ビューの名前は、Explore 内の 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 パラメータによって Explore から除外されています。
  • 参照は、タイムフレームが指定されていない dimension_group です。
Unknown view (?). IDE Ex SQL
  • ビューはモデルファイルに含まれません。
  • explore は、view_name パラメータがないベース explore を拡張しています。
  • explore パラメータで定義された Explore の名前は、スペルミスや存在しないビュー名に基づいています。
  • 誤ったモデルを選択して、モデルベースの SQL Runner クエリを実行しています。
Unknown view (?). View does not exist in model (?). Check for typos or missing include statements. IDE Ex SQL
  • explore は、view_name パラメータがないベース explore を拡張しており、結合されたビューのいずれかのフィールドはベース explore 名を参照します。
  • フィールドは、スペルが間違っている、存在しない、または該当する Explore に結合されていないビューを参照しています。
Unknown field (?) in filter IDE
  • ネイティブ派生テーブル（NDT）の定義には、LookML で定義されていないカスタム フィールドに bind_all_filters パラメータが含まれます。
  • LookML フィルタは、コメントアウトされているまたは存在しない LookML フィールドを参照しています。
  • LookML フィルタが、別のビューから取得した LookML フィールドを参照しています。また、このフィールドは完全なスコープでも、関連するすべての explore パラメータでも結合されていません。
Measures with Looker aggregations (sum, average, min, max, list types) may not reference other measures. IDE メジャーは、別の集計タイプのメジャーの SQL 定義内で参照されます。
Unknown view (?). View (?) does not exist in model (?). Check for typos or missing include statements in (?). IDE ビューがモデルファイルに含まれていないか、ビューに含まれているものの、スペルが間違っていいます。
Can't construct persistent derived table (?), connection (?) could not be registered IDE Ex
  • 既存の PDT の依存関係のビルドに失敗しました。
  • 接続に問題があります。接続をテストして診断する必要があります（たとえば、接続をテストした結果、Looker ユーザーがデータベースに対して所有または書き込みの十分なアクセス権を持っていないことが判明する場合があります）。
  • 失敗した PDT を定義するビューや、失敗した PDT によって参照されるビューなどのインポートされたプロジェクト ファイルは、インポート プロジェクトに含まれません。
  • データベース接続で永続的な派生テーブルの設定が有効になっていません。
  • Looker ブロックの記述が記述された言語と異なる場合、Looker Block のコードが接続の SQL 言語に更新されません。
  • Snowflake または BigQuery の接続で OAuth が有効になっています。
  • Snowflake データベースの AUTOCOMMIT パラメータには、デフォルト値の TRUE 以外の値が設定されています。
Unknown or excluded suggest_dimension (?) in field (?) IDE
  • suggest_dimension パラメータで参照されるフィールドが存在しないか、コメントアウトされているか、fields パラメータによって Explore で除外されています。
  • suggest_dimension パラメータで参照されるフィールドは別のビューで定義されていますが、参照で view_name.field_name として完全にスコープ設定されていません。
  • suggest_dimension パラメータは、関連するすべての explore パラメータに結合されていない別のビューのフィールド、または from パラメータを持つ explore でエイリアス化されたビューを参照します。
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
  • ファイルのパスのスペルミスによりエラーが発生します。
  • フォルダ参照で誤った構文が使用されています。
  • プロジェクト インポート参照で正しくない構文が使用されています。
SQL Dialect does not support Symmetric Aggregates with percentiles, field ignored. Ex データベース言語は、対称集計による type: median または type: percentile のメジャーをサポートしていません。
Using project_name or local_dependency in manifest.lkml without Local Project Import enabled is not supported. Params ignored. IDE ローカル プロジェクトのインポート パラメータはマニフェスト ファイルで使用されますが、ローカル プロジェクト インポートの Labs 機能は無効になっています。ローカル プロジェクトのインポートの Labs 機能が有効になっていない限り、ローカル プロジェクトのインポート パラメータをマニフェスト ファイルでは使用できません。
Cannot use native derived table (?) with bind_all_filters outside of its source explore (?) IDE Ex bind_all_filters パラメータを持つネイティブ派生テーブル（NDT）が、explore_source パラメータで定義された Explore 以外の 1 つ以上の Explore に結合されています。 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 パラメータは必要ありません。
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 には、含まれているプロジェクト モデルファイルの既存の explore と同じ名前が付いています。*
  • コードには、explore（またはモデルファイル）を複数回参照する循環参照があります。
* モデルファイルを他のモデルファイルに含めることはおすすめしません。
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml? IDE
  • モデルにはビューフォルダが含まれていますが、特定のビューファイルはフォルダの外側にあります。
  • モデルにはビューの名前が含まれますが、名前が異なる場合はビューファイルが含まれません。
  • ビューは explore に複数回結合されますが、2 番目の結合時には from パラメータがありません。
Unknown field '(?)' IDE Ex
  • 参照しようとしているフィールドが存在しないか、スペルが間違っているか、コメントアウトされています。
  • 参照フィールドは別のビューで定義されているため、そのビュー名のスコープは設定されていません。
  • フィールドは、必要な Explore に結合されていない別のビューで定義されている場合や、結合でビューにエイリアスが設定されている場合、一部の Explore ではそのフィールドにアクセスできません。
  • required_fields パラメータが、アクセスできないフィールド、スペル間違いのあるフィールド、存在しないフィールド、コメントアウトされているフィールドを参照しています。
Cannot use (?) as access filter since any user can edit their own value. Ex [ユーザー アクセス] オプションを [編集] に設定したユーザー属性が、Explore の access_filter パラメータで使用されています。
label_from_parameter of (?) must refer to a parameter. IDE Ex
  • label_from_parameter パラメータで参照されるフィールドが存在しないか、スペルが間違っているか、コメントアウトされています。
  • label_from_parameter パラメータで参照されるフィールドは存在します、parameter 型ではありません。
Cannot use user-editable attribute (?) for access_grant (?) IDE Ex [ユーザー アクセス] オプションを [編集] に設定したユーザー属性が、Explore の access_grant パラメータで使用されています。
datagroup (?) has a sql_trigger. This is not allowed in models with a parameterized connection. IDE データベース接続でデータベース ログイン認証情報のユーザー属性が使用されており、PDT プロセス用に別のデータベース ユーザーに対して PDT オーバーライド列が構成されていません。
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 パラメータに結合されていないビューで定義されているフィールド、またはフィールドのスコープがビュー名ではないフィールドです。
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 が指定されていないため、1 つ以上の 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 を拡張しています。
The location field type does not use the sql parameter. Please use sql_latitude and sql_longitude instead. IDE sql パラメータは、type: location のフィールドで使用されます。ロケーション型のフィールドには、sql パラメータの代わりに sql_latitude と sql_longitude のサブパラメータが必要です。 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 アプリケーションで予期しないエラーが発生しました。
Looker is having trouble connecting to your database. Ex SQL 接続の最大接続プール上限に到達し、接続プール タイムアウト時間枠が経過してからキューに格納されたクエリがタイムアウトしました。
Missing dates/values for '(?)' were not filled. Ex
  • Explore に複数のディメンションが選択されているため、ディメンションの塗りつぶしを適用できません。
  • Explore で 1 つ以上のフィールドがピボットされたため、ディメンション フィルを適用できません。
  • フィールドが個別の文字列値（allowed_value パラメータや case パラメータなど）を持ち、そのフィールドにフィルタが適用されているため、ディメンション フィルを適用できません。
 欠けている日付と値の入力
filters: ` is not supported for measures of non-aggregate type '(?)' IDE Ex filters パラメータが、count、sum、average、count_distinct 以外のメジャー タイプで使用されました。
Unknown source explore (?) in lookml test (?) declaration. IDE
  • スペル間違いのある、存在しない、またはコメントアウトされた Explore の名前が、データテストの explore_source サブパラメータで使用されています。
  • データテストは、Explore の explore_source 定義を含むファイルに含まれていない、またはファイルに含まれていないファイルに定義されています。
  • extension: required パラメータ仕様の Explore が、データテストの explore_source として使用されています。
filter_expression: is not supported for measures of non-aggregate type '(?)' IDE Ex filters_expression パラメータが、count、sum、average、count_distinct 以外のメジャー タイプで使用されました。
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 パラメータでメジャーやその他の集計を参照している
Cannot specify both sql_table_name and derived_table for view (?) IDE ビューには sql_table_name パラメータと derived_table パラメータの両方が定義でされています。ビューは 1 つのテーブル（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 パラメータを持つ Explore に基づいています。
Unknown or unexpected parameter "(?)" in (?). IDE
  • distribution_style パラメータは、そのパラメータをサポートしていない言語で使用されています。
  • cluster_keys パラメータは、そのパラメータをサポートしていない言語で使用されています。
  • sql_always_where パラメータは、explore ではなく join で定義されます。
  • dimension_group で定義されたタイムフレームは type: time ではありません。
  • sql_distinct_key パラメータは、メジャーではなくディメンションで定義されます。
Could not find the constant IDE 定数は、インポートしたプロジェクト内でインポートしたプロジェクトから参照され、インポートしたプロジェクトでのみ定義されます。定数は、定義されているプロジェクトでのみ参照できます。定数はマニフェスト ファイルで再定義する必要があります。 インポートしたプロジェクトのファイルで定数を使用する
Multiple primary key definitions for view '(?)': '(?)' and '(?)' IDE ビューファイルに複数の主キーが存在します。primary_key: yes を使用して主キーとして複数のディメンションが指定されているか、拡張ビューによって primary_key: yes を使用して新しいディメンションが主キーとして指定されています。
Persistent Native Derived Table for view (?) references user attributes. Persisting this table may result in unexpected behavior. IDE 永続的な NDT テーブルまたは集計認識テーブルは、ユーザー属性を参照する access_filter または sql_always_where パラメータを持つ explore に基づいています。
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 で地図のレイヤを参照します。たとえば、ビューが複数のモデルに含まれている場合でも、マップレイヤは 1 つのモデルでのみ定義されています。
Persistent derived table (?) should include at least one index IDE PDT または集計テーブル定義には、PDT または集計テーブル列が指定されていない index があります。
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 メンテナンス ポリシー