管理者設定 - 永続的な派生テーブル

Looker の [永続的な派生テーブル] 管理ページには、Looker インスタンスの永続テーブルのステータスが表示されます（永続的な派生テーブルと集約テーブルの両方が含まれます）。

[永続的な派生テーブル] 管理ページには、永続テーブルの動作の追跡とトラブルシューティングに役立ついくつかの管理機能が表示されます。永続テーブルのトラブルシューティングについては、Looker の派生テーブルのドキュメント ページをご覧ください。

Looker 管理者と see_pdts 権限を持つユーザーは、[永続的な派生テーブル] ページにアクセスできます。

[永続的な派生テーブル] ページを開く手順は次のとおりです。

  1. Looker のメインメニュー アイコン をクリックし、[管理] メニューがまだ表示されていない場合は [管理] を選択します。（Looker のメインメニューの [Explore] セクションまたは [Develop] セクションにいる場合は、[管理者] メニューを表示するために戻る矢印をクリックする必要がある場合があります）。
  2. [管理者] メニューから [永続派生テーブル] を選択します。

[永続的な派生テーブル] ページには、PDT が有効になっている接続と、次の条件を満たす永続テーブルのみが表示されます。

  • 永続テーブルは、本番環境にあるビューファイルで定義されます。ただし、開発モードでは、[Development] タブを使用して永続テーブルの開発バージョンを確認してください。
  • 永続テーブルは、正しく構成されたモデルの一部です。
  • 永続テーブルは、データアクセスが可能なモデルの一部です。

このページの情報は、このページの PDT イベントログ Explore セクションで説明されている内部 PDT イベントログに基づいています。

テーブルのカスタマイズ

デフォルトでは、[永続的な派生テーブル] ページには、最大 25 個の永続テーブルがページに表示されます。また、Looker インスタンスに対するアクセス権がユーザーに付与されているすべての接続の永続テーブルが読み込まれます。テーブルに表示されるデータを変更する方法はいくつかあります。

  1. 特定の接続の永続テーブルのみを表示するには、[すべての接続] の横にある矢印をクリックし、特定の接続の名前を選択します。セレクタには、PDT が有効になっている接続と、ユーザーにデータアクセス権が付与されている接続のみが表示されます。
  2. 検索ボックスにキーワードを入力して、永続テーブル リストを名前にキーワードが含まれる永続テーブルに絞り込みます。表には、一致する検索キーワードが太字の状態で永続テーブルが表示されます。検索バーの [X] をクリックして、検索クエリのキーワードを消去します。
  3. [フィルタ] アイコンをクリックして、テーブルのフィルタを定義します。
  4. 閉じる / 開くアイコンをクリックして、[一覧] セクションを表示または非表示にします。
  5. 列でテーブルを並べ替えるには、列の名前をクリックします。並べ替え順を逆にするには、列名をもう一度クリックします。
  6. [表示する列を選択] アイコンをクリックして、テーブル内の列の表示と非表示を切り替えます。
  7. 表示セレクタを使用して、1 ページに表示する結果の数を選択します。表が 1 ページを超える場合は、ページの中央下にある矢印をクリックすると、次のページまたは前のページに移動できます。

フィルタリング

検索バーの横にある [フィルタ] アイコンを使用すると、[永続的な派生テーブル] ページに表示する永続テーブルを選択できます。たとえば、[Last Build Status] でフィルタして、ビルドエラーが発生している永続テーブルのみを表示できます。または、[Model] でフィルタして、表示される永続テーブルを特定のモデルに制限することもできます。

[永続的な派生テーブル] ページをフィルタリングする手順は次のとおりです。

  1. [フィルタ] アイコン をクリックします。
  2. フィルタ メニューの最初のフィルタ セレクタからフィルタ オプションを選択します。次の選択肢が用意されています。
    • [最後にトリガーされなかった]: 指定した時間数と分数内にトリガーされなかった永続テーブルで [永続的な派生テーブル] ページをフィルタします。
    • [最後にトリガーされた]: 指定した時間数と分数内にトリガーされた永続テーブルで [永続的な派生テーブル] ページをフィルタします。
    • モデル: 指定したモデルに含まれる永続テーブルの [永続的な派生テーブル] ページをフィルタします。
    • 永続性ルール: 永続性のタイプを基準として [永続的な派生テーブル] ページをフィルタします。
    • 最後の試行ステータス: 指定した永続テーブルのステータスで [永続的な派生テーブル] ページをフィルタします。
    • 安定表示として公開: 永続テーブルの [永続的な派生テーブル] ページをフィルタするブール値。これは、安定表示として公開された永続テーブルの場合は [はい] を表示し、publish_as_db_view パラメータ値で確定される安定表示として公開されていない永続テーブルの場合は [いいえ] と表示します。
    • [時間超過中の最後のビルド]: ビルドが指定した秒数を超えた永続テーブルで [永続的な派生テーブル] ページをフィルタします。
    • プロジェクト: 指定した LookML プロジェクトの永続テーブルで [永続的な派生テーブル] ページをフィルタします。
  3. 2 番目のフィルタ セレクタで、[永続的な派生テーブル] ページをフィルタする値を選択します。[最後にトリガーされない] オプションまたは [最後にトリガーされる] オプションに、時間数または分数を入力します。[時間超過中の最後のビルド] オプションに、秒数を入力します。
  4. [フィルタの追加] をクリックしてフィルタを追加し、追加するフィルタごとに手順 2 と 3 を繰り返します。
    • フィルタの選択をクリアし、任意の時点でやり直すには、[すべてクリア] をクリックします。
    • その他のフィルタを個別に削除するには、削除するフィルタの [クリア] オプションをクリックします。
  5. 選択したフィルタ条件を [永続的な派生テーブル] ページに適用するには、[適用] をクリックします。

適用されたフィルタは、[永続的な派生テーブル] ページの上部に表示されます。

[永続的な派生テーブル] ページで適用されているフィルタの横にある [X] をクリックして、[永続的な派生テーブル] ページからフィルタを削除します。[すべてクリア] をクリックして、すべてのフィルタをクリアします。

[永続的な派生テーブル] ページについて

以降のセクションでは、[永続的な派生テーブル] ページに関する情報について説明します。

[本番環境] タブと [開発] タブ

Development Mode で操作している LookML のデベロッパーである場合、[永続的な派生テーブル] テーブルには 2 つのタブがあります。

  • デフォルトでは [本番環境] タブが選択され、本番環境の永続テーブルが表示されます。これらはインスタンス上の本番環境にデプロイされた永続テーブルです。これらの永続テーブルは、ユーザーの Explore クエリ用のデータを提供します。（本番環境モードで操作している場合、または develop 権限を付与されていない場合は、[永続的な派生テーブル] ページにはタブが表示されず、本番環境の永続テーブルに関する情報のみが表示されます）。

  • [開発] タブには、開発永続テーブルが表示されます。開発の永続テーブルは、まだ本番環境に push されていません。

Looker では、デベロッパー モードの LookML デベロッパーが永続テーブルのデータや永続テーブルのクエリ方法に影響する変更を行うと、開発用永続テーブルが作成されます。このように変更することで、Looker は開発用永続テーブルを作成しますが、変更後、永続テーブルがクエリを実行しない限り、Looker は実際には永続テーブルをビルドしません。[Development] タブは、Looker が作成した開発永続テーブルと、ビルド済みかどうかの判断に役立ちます。

Looker に開発永続テーブルが作成される原因と、開発永続テーブルがデータベースに保持される期間の詳細については、Looker の派生テーブルのドキュメントをご覧ください。

[一覧] セクション

[一覧] セクションには、永続テーブル テーブルに表示されている永続テーブルのステータスの概要が表示されます。テーブルにフィルタを定義している場合や、ページ上部の [すべての接続] の横にある矢印を使用して、テーブルを特定の接続に絞り込む場合は、[概要] セクションを使用すると、永続テーブル テーブルに表示される結果を絞り込むことができます。

セクションの上部にある閉じる　/　開くアイコンをクリックすると、[一覧] セクションを表示または非表示にできます。

テーブル列

以降のセクションでは、[永続的な派生テーブル] ページのテーブル列について説明します。[表示する列を選択] アイコンをクリックして、テーブルの一部の列の表示と非表示を切り替えます。詳細については、このページのテーブルのカスタマイズ　セクションをご覧ください。

PDT 名

[PDT 名] 列には、永続テーブルの LookML ビューファイルの view パラメータで定義されている永続テーブルの名前が表示されます。

該当する場合は、[PDT 名] 列の永続テーブル名の下に次の追加情報が表示されます。

  • [古いビルド] は、行に古い永続テーブル ビルドに関する情報が表示されていることを示します。このメッセージの詳細については、オプション メニューの [PDT の詳細] ダイアログをご覧ください。
  • [増分] は、永続テーブルが増分 PDT であることを示します。
  • [マテリアライズド ビュー] は、永続テーブルがデータベース上のマテリアライズド ビューであることを示します。

最後の試行ステータス

[最後の試行ステータス] 列には、リストに表示されている各永続テーブルのビルドの最後の試行のステータスが表示されます。

  • [再生成] は、永続テーブルにクエリを実行でき、更新済みテーブルが作成中であることを示します。タイムスタンプは、永続テーブルのビルドが開始された日時を示します。
  • [完了] は、永続テーブルが正常にビルドされたことを示します。
  • [構築中] は、永続テーブルが構築中で、構築が完了するまでクエリを実行できないことを示します。
  • [未ビルド] は、永続テーブルがビルドされていないことを示します。
  • ビルドエラーは、ビルド中にエラーが発生したことを示します。LookML を表示するための適切な権限を付与されている場合は、[ビルドエラー] をクリックして、エラーのソースを表示し、永続テーブルの LookML に移動できます。永続的な派生テーブルページからの永続テーブルのトラブルシューティングについて詳しくは、このページの [オプション メニュー] セクションをご覧ください。

最後の試行時刻

[最後の試行時刻] 列は、永続テーブルのビルドが最後に試行された時刻を表します。

最終ビルド日時

[Last Successful Build] 列は、最後に成功した永続テーブル ビルドの時刻を示します。

最後のビルド期間

[最後のビルド時間] 列には、その永続テーブルの最新ビルドにかかった時間（秒）と、永続テーブルのビルドにかかった平均時間（秒）が表示されます。

永続性ルール

[永続性ルール] 列には、永続テーブルの LookML 定義で指定されている、永続テーブルに適用される永続性のタイプが表示されます。また、正常にビルドされた永続テーブルがチェックされた最後の時間（トリガータイプの永続テーブルの場合）、または正常にビルドされた永続テーブルが有効期限切れになる時期（永続タイプの永続テーブルの場合）も示されます。[永続性ルール] 列には、次の 2 種類の永続性が表示されます。

  • [永続: (時間)] は、persist_for パラメータで永続化される永続テーブルに表示されます。
  • [トリガー: （データグループ名）] は、datagroup_trigger パラメータで永続化される永続テーブルに表示されます。データグループ名のリンクをクリックすると、datagroup パラメータの sql_trigger 値が表示されます。
  • [トリガー: SQL] は、sql_trigger_value パラメータで永続化される永続テーブルに表示されます。リンクをクリックして、sql_trigger_value ステートメントを表示できます。
  • [マテリアライズド ビュー] は、データベースの機能を使用して派生テーブルをデータベース上に永続化されるマテリアライズド ビューに対して表示されます。

プロジェクト

[プロジェクト] 列には、永続テーブルが定義されている LookML プロジェクトの名前が表示されます。

接続

接続の選択で [すべての接続] を選択すると、[接続] 列が表示され、永続テーブルが有効になっている接続の名前が表示されます。

モデル

[モデル] 列には、永続テーブルに関連付けられているモデルファイルの名前が表示されます。PDT の場合、通常は PDT が定義されているビューファイルを含むモデルファイルです。集約テーブルの場合、通常は集約テーブルが定義されているモデルファイルです。

オプション メニュー

その他のオプションメニューは、予期しない動作のトラブルシューティングに特に有用です。表示されるオプションを使用すると、テーブルの最終ビルド日時の確認、ビルドにかかった時間の確認、最新のビルド時間と平均ビルド時間の比較、トリガーが正しく動作しているかどうかの確認を行えます。次の中から選択できます:

  • LookML に移動: LookML を表示する適切な権限がある場合は、永続テーブルが定義されているビューファイルを開きます。
  • PDT アクティビティ ダッシュボード: PDT アクティビティ ダッシュボードを開きます。ダッシュボードには、選択した永続テーブルのアクティビティが表示されます。
  • PDT の詳細: 特定の永続テーブルの詳細情報と統計情報を含むダイアログが開きます。詳細については、このページの PDT 詳細モーダル セクションをご覧ください。

トラブルシューティングのヒントについては、Looker の派生テーブルドキュメント ページの PDT セクションのモニタリングとトラブルシューティングをご覧ください。

PDT 詳細モーダル

永続テーブルのその他メニュー [オプション] で [PDT の詳細] オプションをクリックして、PDT 詳細モーダルを表示します。

モーダル内の情報は、永続テーブルの構成によって異なります。表示される可能性のある情報は次のとおりです。

  • テーブル名: 最後に正常にビルドされた永続テーブルのハッシュ。
  • モデル: 永続テーブルのビューファイルが含まれているモデルファイルの名前。
  • 安定した名前: データベース上の永続テーブルの安定したデータベース ビューの名前（永続テーブルが安定したビューとして公開されている場合）。永続テーブルをデータベースで安定したビューとして公開するには、PDT または集約テーブルに publish_as_db_view: yes ステートメントを追加するか、materialized_view: yes ステートメントを使用して派生テーブルをマテリアライズド ビューにします。
  • 接続: 永続テーブルが有効になっている接続の名前。
  • 古いビルド: ビルドが古い永続テーブル ビルドの場合は [はい]、そうでない場合は [いいえ] を表示するブール値。
    • テーブルタイプ: 古いビルドの場合、このフィールドが表示され、テーブルタイプを表示します。値には、以前の世代のテーブルとスタンドインが含まれます。
  • 増分 PDT: 永続テーブルが増分 PDT の場合は [はい] を、そうでない場合は [いいえ] を表示するブール値。
  • ステータス: 最後の試行ステータスを示します。ビルドに失敗した場合は、SQL エラー メッセージが表示され、ユーザーが LookML を表示するための適切な権限を持っている場合は、モデルの LookML へのリンクが表示されます。
  • 依存関係: [依存関係グラフを表示] ボタンをクリックして、この永続テーブルが依存するすべての派生テーブルの関係図を表示します。図の各ノードは、派生テーブルに対応しています。各ノードの色は、次のように、その派生テーブルのステータスに対応しています。
    • 緑色のノードは、正常にビルドされた永続テーブルを表します。
    • 黄色のノードは、ビルド中または増分中の永続テーブルを表します。
    • 赤いノードは、ビルドに失敗した永続テーブルを表します。
    • 灰色のノードは、まだビルドされていない永続テーブルを表します。
    • 白いノードは、Looker がビルドしない一時派生テーブルを表します。
  • 直近のビルド:
    • 成功した最新のビルド: 成功した最新の永続テーブル ビルドの日時。
    • Latest Build Duration: 最新の永続テーブルのビルドに要する時間（秒）。テーブルがまだビルドされていない場合は – が表示されます。
    • 平均ビルド期間: 永続テーブルのビルドに要する平均時間（秒で表示されます – テーブルがまだビルドされていない場合）。
    • ビルド理由: 永続テーブルがビルドされた理由（最初のビルドの開始、永続テーブルがデータグループで永続化された場合のトリガーされたデータグループ、永続テーブルの SQL トリガー値が変更された場合のトリガー値の変更）。
    • 増分キー: 増分ビルドを使用する永続テーブルの increment_key パラメータ。
    • 増分オフセット: 増分ビルドを使用する永続テーブルの increment_offset パラメータ。
    • Increment Build Add/Remove Rows: テーブルが最後にインクリメントされたときにテーブルに対して追加または削除された行の数（テーブルの永続化戦略が最後にインクリメントをトリガーした際に、行が追加または削除されなかった場合は – が表示されます）。
    • 最後に試行された SQL: データベースにクエリを実行してテーブルの最後のビルドを作成する際に使用された SQL。
  • 永続性ルール:
    • タイプ: テーブルで使用される永続性のタイプ。指定可能な値については、このページの [永続性ルール] 列 セクションをご覧ください。
    • 持続期間: 永続タイプの永続テーブルの場合における、持続期間の値。トリガータイプの永続テーブルには適用されません。
    • データグループ: データグループ トリガーの永続テーブルについては、データグループの名前を指定します。
    • SQL コードブロック: データグループと SQL トリガーの永続テーブルの場合、コードブロックにはトリガーの SQL ステートメントが表示されます。データグループ トリガーの場合、これはデータグループの sql_trigger パラメータの SQL です。SQL トリガーの場合、これは sql_trigger_value パラメータの SQL です。
    • トリガー値: トリガータイプの永続テーブルの場合、永続テーブルのビルドをトリガーした値（-適切にビルドされた永続テーブルが作成され、datagroup_trigger。最新のトリガー値を確認し、データグループの詳細については、データグループページの管理パネルをご覧ください）。
    • 最終確認日: トリガータイプの永続テーブルの場合、トリガー値が最後にチェックされた日時。
    • 有効期限: 該当する場合、永続テーブルの有効期限が切れる時刻（データグループのトリガーには該当しません）。

PDT アクティビティ ダッシュボード

[PDT アクティビティ] ダッシュボードには、永続テーブル、その再ビルド、クエリに関する情報が表示されます。

[PDT アクティビティ] ダッシュボードには、デフォルトで過去 4 週間のアクティビティ情報が表示されます。表示される期間は、ダッシュボード上部のフィルタバーを使用して変更できます。[PDT アクティビティ] ダッシュボードには、次の情報を表示するタイルが含まれています。

  • 永続テーブルを定義する LookML モデルとビューの名前、永続テーブルが使用するデータベース 接続の名前、永続テーブルの成功したビルド試行と失敗したビルド試行の合計数、失敗したビルド試行の総数の割合を含む、永続テーブルの概要。
  • 永続テーブルの最新の完全再ビルドの日時。
  • 永続テーブルが増分 PDT の場合、PDT の最新の増分再ビルドの日時。
  • 永続テーブルが増分 PDT の場合、最新の完全再ビルド以降に発生した増分再ビルドの数。
  • 永続テーブルの再ビルドに要した平均時間。
  • 最近発生したすべての作成イベントを表示し、イベントの原因となったアクションの種類の概要でグループ化した可視化。
  • ダッシュボードの期間中に発生したすべての永続テーブル再ビルドのリスト。各再ビルドの完了日、再ビルドの完了にかかった秒数、再ビルドが増分ビルドであったかどうか、再ビルドの原因となったトリガー、永続テーブル ビルド。
  • 失敗した再ビルドが開始された日時、失敗の原因となったエラーの種類、エラー メッセージ、作成の失敗数など、失敗したすべての再ビルド試行のリスト。
  • イベント ID 番号、イベントの日付、イベントの種類、トリガー イベントに付属するデータなど、すべての永続テーブル再ビルドトリガー イベントのリスト。
  • イベント ID 番号、イベントの日付、イベントの種類、再ビルドイベントに付属するデータなど、すべての永続テーブル再ビルド イベントのリスト。
  • クエリのソースと各クエリソースの平均ランタイムでグループ化した、フィールドを直接クエリしたクエリの数。
  • 永続テーブルで実行されたクエリの合計数。
  • フィールドが定義されている LookML ビューとモデル、フィールド名、フィールドを含む Explore 実行の名前、フィールドがクエリに含まれた回数など、クエリされたすべての永続テーブル フィールドのリスト。

PDT イベントログの Explore

Looker には、PDT イベントログのデータ探索が可能な system_activity という名前の事前ビルド済みモデルが含まれています。これは、永続テーブルのトリガーとビルド アクティビティを追跡するデータベース接続の一時スキーマ内のテーブルです。

このモデルには、[永続的な派生テーブル] ページの [オプション] のその他メニューに表示される [最近のビルドイベント] リンクと [最近のトリガー イベント] リンクから、または Looker [管理者] パネルの [接続] ページからアクセスできます。

[接続] ページから [PDT イベントログ] Explore にアクセスするには、各接続の歯車アイコン プルダウン メニュー から [PDT イベントログを表示] オプションを選択します。

他の Looker Explore と同様に、モデルを探索できます。[接続] ページからアクセスすると、[PDT イベントログ] Explore で接続全体がフィルタされます。[永続的な派生テーブル] ページからアクセスすると、[PDT イベントログ] の Explore で特定の永続テーブルがフィルタされます。

PDT イベントログの Explore で使用可能なフィールドの概要は次のとおりです。

フィールド説明
アクション発生したアクションを記述します。たとえば、再生成、ドロップ、作成、読み込みなどの操作を行います。

PDT ログ アクションとそれに対応するアクション データの表示と理解について詳しくは、PDT ログ アクションについてのドキュメント ページをご覧ください。
アクション データ使用中のトリガー、トリガーの値、永続テーブルの有効期限、再構築の原因、エラー メッセージのテキストなど、アクションについての詳細情報を提供します。

PDT ログ アクションとそれに対応するアクション データの表示と理解について詳しくは、PDT ログ アクションについてのドキュメント ページをご覧ください。
接続派生テーブルが存在する接続の名前。
ハッシュ各派生テーブルには、その派生テーブルを作成するために記述された SQL のハッシュが含まれています。
ID永続テーブルを生成した Looker インスタンスの一意の ID。多くの場合、データベースを指す Looker インスタンスは 1 つのみ存在するため、ID は 1 つのみ表示されます。ただし、ステージング インスタンスを使用している場合などは、複数の ID が表示される可能性があります。
モデル名テーブルが生成されたモデルの名前。
発生日イベントが発生した日時。
発生 Utc 表示日イベントが発生した日時（UTC）。
シーケンス永続テーブルのビルドにおけるステップ番号。
ショート ハッシュ派生テーブルを作成するために記述された SQL のハッシュの簡略版。
テーブル名テーブルタイプの接頭辞、ハッシュ、ビュー名を含む、永続テーブルの完全な名前。
Tidトランザクション ID
ビュー名派生テーブルのビュー名。