PDT ログの操作について

システム アクティビティPDT イベントログの Explore では、PDT の再構築やエラーなど、PDT に関連する過去のイベントに関する情報を確認できます。

たとえば、PDT イベントログ Explore は、PDT ビルドの失敗や停止したトリガーのトラブルシューティングに役立ちます。また、特定のテーブルがビルドされたタイミングとプロセスを判別する際に便利です。

システム アクティビティで使用可能な Explore について詳しくは、System Activity Explores を使用して Looker 使用状況レポートを作成するをご覧ください。

PDT ログ アクションの表示

PDT ログの操作は、システム アクティビティの PDT イベントログの Explore に表示されます。Looker 管理者であるか、PDT イベントログ Explore を表示するには see_system_activity 権限が必要です。

PDT ログ アクションとそれに関連付けられたログ アクション データのリストを表示するには、[Explore] メニューからアクセスできる PDT Event Log Explore の [PDT Event Log] ビューで、[Action] フィールドと [Action Data] フィールドを選択します。

PDT ログ アクションとそれに対応する PDT ログ アクション データのペアについて

以下の表に、PDT イベントログ Explore のさまざまなログ アクションと、各ログ アクションに対応するデータ値を示します。イベントのタイプは次のとおりです。

次の表では、PDT イベントログ Explore の PDT Event Log ビューの Action フィールドと Action Data フィールドを使用しています。

予定を作成する

アクションを記録 ログの操作の説明 アクションのデータを記録 ログアクション データの説明
create begin リジェネレータ スレッドが PDT をピックアップすると発生します。 prod-user-x ユーザーが Explore から PDT を照会し、テーブルは存在しなかったので、Looker が PDT を再ビルドする必要があることを示します。
create begin リジェネレータ スレッドが PDT をピックアップすると発生します。 prod データグループまたは SQL トリガー(リジェネレータによって構築)によって PDT がトリガーされたことを示します。
create begin リジェネレータ スレッドが PDT をピックアップすると発生します。 dev-user-x 新しい開発モードの PDT がビルドされたことを示します。

通常、PDT の SQL に変更が行われた後に発生します。その後、開発モードで Explore で PDT が照会されます。これにより、本番環境のテーブルに影響を与えないように新しいテーブルが作成されます。
create regen requires 通常、ビルドされていない別の PDT を参照する PDT をユーザーが照会して再ビルドをトリガーすることを示します。 null
create user rebuild ユーザーが Explore で [Rebuild Derived Tables & Run] オプションを使用して PDT を手動で再構築したことを示します。 null
create ready PDT が実際にビルドを開始すると、create ready イベントと create begin イベントの差が、子が再ビルドするまでにかかる時間を示します。

create ready イベントが create begin イベントの直後に発生した場合、テーブルの再ビルドは不要と考えられます。
null
create complete PDT のビルドが完了すると発生します。 production trigger トリガーのチェックによって PDT がビルドされた(つまり、PDT がリジェネレータによってビルドされた)ことを示します。
create incremental complete PDT のビルドが完了すると発生します(増分 PDT ビルドの場合)。 increment generation 増分の連続番号が含まれます。
create incremental rows 最後の増分で影響を受ける行数が表示されます。 rows delta 追加された行数を表す正の値と、削除された行数に対する負の値が含まれます。
create sql error PDT ビルドが SQL エラーで失敗したことを示します。 sql error データベースから返された SQL エラー メッセージが含まれます。

SQL Runner で PDT の基盤となる SQL を実行し、新しい編集がエラーを引き起こさないことを確認することをおすすめします。
create child error 依存 PDT の作成中にエラーが発生した場合に発生します。 sql error データベースから返された SQL エラー メッセージが含まれています。
create cancelled error クエリのキャンセルにより PDT ビルドが失敗したことを示します。 query killed クエリが強制終了されたことを示します。これは、ユーザーが Looker からクエリをキャンセルした場合、ユーザーがデータベースからのクエリをキャンセルした場合、またはクエリがデータベースでタイムアウトした場合に発生することがあります。
create trigger old value チェック時の古いトリガー値を示します。 trigger value 古いトリガーの戻り値を返します。
create trigger new value チェック時の新しいトリガー値を示します。 trigger value 新しいトリガーの戻り値を返します。
create trigger missing PDT が存在しないか破棄された場合に、特定の PDT のトリガー チェック時に発生します。 null
create trigger datagroup PDT がデータグループによってトリガーされたかどうかのトリガー チェック時に発生します。 null

イベントの再生成

アクションを記録 ログの操作の説明 アクションのデータを記録 ログアクション データの説明
regenerate begin 再生ツールが、トリガーのチェックやテーブルの作成などのプロセスを開始していることを示します。

通常、regenerate begin イベントに終了イベントがなく、PDT がビルドされていないか、トリガーが確認されていない場合、このログ アクションはハングする再生器を示します。
connection name リジェネレータ スレッドが動作している接続名が表示されます。
regenerate end リジェネレータが、トリガーのチェックや PDT の再構築などのプロセスを終了したこと、またはエラーが発生したことを示します。 success トリガーがチェックされ、PDT が再構築されたことを示します。
regenerate end リジェネレータが、トリガーのチェックや PDT の再構築などのプロセスを終了したこと、またはエラーが発生したことを示します。 error_in_regen このテーブル再生成サイクルでエラーが発生したことを示します。
regenerate end リジェネレータが、トリガーのチェックや PDT の再構築などのプロセスを終了したこと、またはエラーが発生したことを示します。 datagroup_error データグループのトリガーのチェックでエラーが発生したことを示します。
regenerate trace リジェネレータ スレッドのトレースを示します。 hex id プロセスを実行している Java スレッドを表します。

タスクイベントをドロップして公開する

アクションを記録 ログの操作の説明 アクションのデータを記録 ログアクション データの説明
drop table PDT または一時テーブルがデータベースから削除されたことを示します。 unreferenced 関連付けられたトリガー値が変更されたため、テーブルがドロップされたことを示します。

別の永続化メソッドが使用されている場合は、テーブルの有効期限が切れています。
drop table PDT または一時テーブルがデータベースから削除されたことを示します。 zombie テーブルの登録キーが(connection_reg3 で)有効な登録キーセットの一部ではないため、削除対象のゾンビテーブルとしてマークされています。
drop table PDT または一時テーブルがデータベースから削除されたことを示します。 pdt_build_failure_cleanup ビルドが失敗するか、ビルドがキャンセルされていることが検出されると、Looker は部分的に作成されたテーブルを削除します。
drop table failed PDT または一時テーブルのドロップの試行が失敗したときに発生します。 zombie ゾンビテーブルを削除できなかったことを示します。
drop table failed PDT または一時テーブルのドロップの試行が失敗したときに発生します。 unreferenced 参照されていないテーブルの削除に失敗したことを示します。
drop view publish_as_db_view テーブルがドロップされたことを示します。 expired テーブルの存続期間が終了し、テーブルが削除されたことを示します。
drop view failed publish_as_db_view テーブルの削除が失敗したことを示します。 zombie ゾンビテーブル「publish_as_db_view」をドロップできなかったことを示します。
drop view failed publish_as_db_view テーブルの削除が失敗したことを示します。 unreferenced 参照されていない publish_as_db_view テーブルのドロップが失敗したことを示します。
publish task complete 以前のビューが破棄され、新しいビューが公開されたことを示します。 X 回成功、X 回失敗 公開タスクが成功したか失敗したかを示します。

データグループのトリガー イベント

アクションを記録 ログの操作の説明 アクションのデータを記録 ログアクション データの説明
datagroup_triggers begin データグループのトリガーが接続のチェックを開始したことを示します。

接続の最新の datagroup_triggers begin ラインに大きなギャップがあり、datagroup_triggers end がない場合は、トリガーのチェック中に再生器がハングアップした可能性があります。
connection name トリガーがチェックしている接続名を示します。
datagroup_triggers end データグループのトリガーのチェックが完了したことを示します。 null

ハイライト イベント

アクションを記録 ログの操作の説明 アクションのデータを記録 ログアクション データの説明
reap begin リーパーが接続の確認を開始し、スクラッチ スキーマからドロップする必要がある、アクティブでない派生テーブルがあることを示します。 connection name リーパーが確認している接続の名前が表示されます。
reap end リーパーが特定の接続でのサイクルを終了したことを示します。 connection name リーパーがチェックした接続の名前が表示されます。

トリガー イベント

アクションを記録 ログの操作の説明 アクションのデータを記録 ログアクション データの説明
trigger value 計算時のトリガーの値を示します。 trigger value 実際のトリガー値が表示されます。
trigger value compute トリガー値の計算に使用された SQL を示します。 trigger sql トリガー値の計算に使用した実際の SQL が表示されます。
trigger value error トリガー値の計算またはトリガー SQL の実行で SQL エラーが発生したことを示します。 sql error トリガークエリに対して返されたデータベース SQL エラーを示します。
trigger datagroup check リジェネレータが SQL トリガー クエリをデータベースに対して実行したかどうかを示します。 ブール値(true または false
  • true: トリガークエリが実行されたことを示します。
  • false: SQL トリガークエリが実行されていないことを示します。