スケジュール済みクエリの監視

最終更新日: 2023-11-29
  • トピック:
  • Queries
    このトピックの詳細を表示
  • 作成対象:
  • Developer
    User
    Admin
    Leader

Adobe Experience Platform では、UI を使用して、すべてのクエリジョブのステータスをより的確に把握できるようになりました。次から: スケジュール済みクエリ 「 」タブを使用すると、ステータス、スケジュールの詳細、失敗した場合のエラーメッセージ/コードなど、クエリの実行に関する重要な情報を確認できます。 「スケジュール済みクエリ」タブから、これらの任意のクエリについて、UI を使用して、ステータスに基づくクエリのアラートの配信を登録することもできます。

スケジュール済みクエリ

The スケジュール済みクエリ 「 」タブには、スケジュールされたすべての CTAS および ITAS クエリの概要が表示されます。 すべてのスケジュール済みクエリの実行の詳細と、失敗したクエリのエラーコードおよびメッセージが見つかります。

「スケジュール済みクエリ」タブに移動するには、左側のナビゲーションバーから「クエリ」、「スケジュール済みクエリ」の順に選択します。

クエリワークスペースの「スケジュール済みクエリ」タブで、「スケジュール済みクエリ」と「クエリ」がハイライトされています。

使用可能な各列を以下のテーブルに示します。

メモ

名称未設定列の各行に、アラート配信登録アイコンが含まれています。 詳しくは、アラート配信登録の節を参照してください。

説明
名前 名前フィールドは、テンプレート名か SQL クエリの最初の数文字のどちらかです。 クエリエディターを使用して UI から作成したクエリは、開始時に名前が付けられます。API を使用してクエリが作成された場合、その名前は、クエリの作成に使用される最初の SQL のスニペットになります。 クエリに関連付けられているすべての実行のリストを表示するには、 名前 列。 詳しくは、 クエリ実行スケジュールの詳細 」セクションに入力します。
テンプレート クエリのテンプレート名。 テンプレート名を選択してクエリエディターに移動します。 便宜上、クエリエディターにクエリテンプレートが表示されます。 テンプレート名がない場合、行はハイフンでマークされ、クエリエディターにリダイレクトしてクエリを表示することはできません。
SQL SQL クエリのスニペット。
実行頻度 クエリを実行するように設定されたケイデンス。 指定可能な値は Run onceScheduled です。クエリは、実行頻度に従ってフィルタリングできます。
作成者 クエリを作成したユーザーの名前。
作成日 クエリが作成されたときのタイムスタンプ(UTC 形式)。
前回実行時のタイムスタンプ クエリ実行時の最新のタイムスタンプ。 この列では、現在のスケジュールに従ってクエリが実行されたかどうかがハイライト表示されます。
前回の実行ステータス 最新のクエリ実行ステータス。 ステータスの値は次のとおりです。 Success, Failed, In progress、および No runs.
スケジュールのステータス スケジュール済みクエリの現在のステータス。 5 つの潜在的な値があります。 登録中, アクティブ, 非アクティブ, 削除済み、およびハイフン
  • ハイフンは、スケジュール済みクエリが 1 回限りの、繰り返し発生しないクエリであることを示します。
  • The 登録中 「 」ステータスは、クエリの新しいスケジュールの作成をシステムがまだ処理していることを示します。 スケジュール済みクエリの登録中に、そのクエリを無効にしたり削除したりすることはできません。
  • The アクティブ ステータスは、スケジュール済みクエリに まだ経過していない 完了日時。
  • The 非アクティブ ステータスは、スケジュール済みクエリに 渡された 完了日時。
  • The 削除済み 「 」ステータスは、クエリスケジュールが削除されたことを示します。
ヒント

クエリエディターに移動する場合は、「クエリ」を選択して「テンプレート」タブに戻ることができます。

スケジュール済みクエリのテーブル設定のカスタマイズ

「スケジュール済みクエリ」タブの列は、必要に応じて調整できます。を開くには、 テーブルをカスタマイズ 設定ダイアログが開き、使用可能な列を編集する場合は、設定アイコン (設定アイコン。) を画面の右上からクリックします。

メモ

The 作成済み スケジュールが作成された日付を参照する列は、デフォルトで非表示になっています。

「テーブル設定をカスタマイズ」アイコンがハイライトされた「スケジュールされたクエリ」タブ

該当するチェックボックスを切り替えて、テーブル列を削除または追加します。 次に、「適用」をクリックして選択を確定します。

メモ

UI を使用して作成されたクエリは、作成プロセスの一環として名前付きテンプレートになります。 テンプレート列にテンプレート名が表示されます。 API を使用してクエリが作成された場合、テンプレート列は空白になります。

テーブル設定をカスタマイズダイアログ。

インラインアクションを使用したスケジュール済みクエリの管理

The スケジュール済みクエリ 「表示」では、スケジュールされたすべてのクエリを 1 か所で管理する様々なインラインアクションを提供します。 インラインアクションは、各行に省略記号付きで示されます。 管理するスケジュール済みクエリの省略記号を選択し、ポップアップメニューで使用可能なオプションを表示します。 使用可能なオプションは次のとおりです。 スケジュールを無効にする または スケジュールを有効にする, スケジュールを削除、および 購読 アラートを問い合わせるには、次の手順に従います。

インラインアクションの省略記号とポップアップメニューがハイライトされた「スケジュールされたクエリ」タブ。

スケジュール済みクエリの無効化または有効化

スケジュール済みクエリを無効にするには、管理するスケジュール済みクエリの省略記号を選択し、「 」を選択します。 スケジュールを無効にする を選択します。 アクションを確認するダイアログが表示されます。 選択 無効にする をクリックして設定を確定します。

スケジュール済みクエリを無効にした後は、同じ手順でスケジュールを有効にできます。 省略記号を選択し、「 スケジュールを有効にする を選択します。

スケジュール済みクエリの削除

スケジュール済みクエリを削除するには、管理するスケジュール済みクエリの省略記号を選択し、「 スケジュールを削除 を選択します。 アクションを確認するダイアログが表示されます。 選択 削除 をクリックして設定を確定します。

スケジュール済みクエリを削除すると、 not スケジュール済みクエリのリストから削除されました。 省略記号で提供されるインラインアクションは削除され、灰色表示のアラートの追加アイコンに置き換えられます。 削除したスケジュールのアラートを購読することはできません。 行は UI に残り、スケジュール済みクエリの一部として実行される実行に関する情報を提供します。

削除されたスケジュール済みクエリが表示される「スケジュール済みクエリ」タブと、灰色表示のアラートアイコンが強調表示されています。

そのクエリテンプレートの実行をスケジュールする場合は、適切な行からテンプレート名を選択してクエリエディターに移動し、次の手順に従います。 クエリにスケジュールを追加する手順 ドキュメントで説明されているとおりです。

アラートの配信を登録

スケジュール済みクエリの実行に関するアラートをサブスクライブするには、管理するスケジュール済みクエリの省略記号を選択し、「 」を選択します。 購読 を選択します。

The アラート ダイアログが開きます。 The アラート ダイアログは、UI 通知と E メールアラートの両方を購読します。 アラートは、クエリのステータスに基づいています。使用できるオプションは、startsuccess および failure の 3 つです。該当する 1 つ以上のチェックボックスをオンにし、「保存」を選択して配信を登録します。アラートが 前回の実行のタイムスタンプ の値です。

アラートの配信を登録するダイアログ。

詳しくは、 アラート購読 API ドキュメント を参照してください。

クエリの詳細を表示

情報アイコン (情報アイコン。) をクリックして、クエリの詳細パネルを表示します。 詳細パネルには、スケジュール済みクエリテーブルに含まれる事実以外の、クエリに関するすべての関連情報が表示されます。 追加情報には、クエリ ID、最終変更日、クエリの SQL、スケジュール ID、現在の設定スケジュールが含まれます。

情報アイコンと詳細パネルがハイライトされた「スケジュール済みクエリ」タブ。

クエリのフィルタリング

実行頻度に基づいてクエリをフィルタリングできます。「スケジュールされたクエリ」タブで、フィルターアイコン(フィルターアイコン)を選択して、フィルターサイドバーを開きます。

フィルターアイコンがハイライト表示された「スケジュールされたクエリ」タブ。

実行頻度に基づいてクエリのリストをフィルターするには、 Scheduled または 1 回実行 フィルターチェックボックス。

メモ

実行されたけれどスケジュールされていないクエリは、1 回実行と認定されます。

フィルターサイドバーがハイライト表示された「スケジュールされたクエリ」タブ。

フィルター条件を有効にしたら、「フィルターを非表示」を選択して、フィルターパネルを閉じます。

クエリ実行スケジュールの詳細

スケジュールの詳細ページを開くには、 スケジュール済みクエリ タブをクリックします。 このビューには、スケジュールされたクエリの一部として実行されたすべての実行内容のリストが表示されます。表示される情報に含まれているのは、開始時間と終了時間、ステータス、使用されたデータセットです。

スケジュールの詳細ページ。

この情報は 5 列の表として表示されます。各行はクエリを 1 回実行したことを示しています。

列名 説明
クエリ実行 ID 毎日の実行に対するクエリ実行 ID。を選択します。 クエリ実行 ID をクリックして、 クエリ実行の概要.
クエリの実行開始 クエリが実行されたときのタイムスタンプ。タイムスタンプは UTC 形式です。
クエリの実行完了 クエリが完了したときのタイムスタンプ。タイムスタンプは UTC 形式です。
ステータス 最新のクエリ実行ステータス。 ステータス値は successfulfailedin progress のいずれかです。
データセット 実行に使われたデータセット。

スケジュールされたクエリの詳細は、プロパティパネルに表示されています。このパネルには、初回クエリ ID、クライアントタイプ、テンプレート名、クエリ SQL、スケジュールのケイデンスが含まれています。

プロパティパネルがハイライト表示されたスケジュールの詳細ページ。

クエリ実行 ID を選択して実行の詳細ページに移動し、クエリ情報を表示します。

実行 ID がハイライト表示されたスケジュールの詳細画面。

クエリ実行の概要

The クエリ実行の概要 は、このスケジュール済みクエリの個々の実行に関する情報と、実行ステータスの詳細な分類を提供します。 また、このページには、クライアント情報と、クエリの失敗を引き起こした可能性のあるエラーの詳細も含まれています。

概要セクションがハイライト表示された実行の詳細画面。

クエリステータスセクションには、クエリが失敗した場合のエラーコードとエラーメッセージが表示されます。

エラーセクションが強調表示された実行の詳細画面

このビューからクエリ SQL をクリップボードにコピーできます。 クエリをコピーするには、SQL スニペットの右上にあるコピーアイコンを選択します。 コードがコピーされたことを確認するポップアップメッセージが表示されます。

「SQL コピー」アイコンが強調表示された実行詳細画面

匿名ブロックを含むクエリの詳細を実行

匿名ブロックを使用して SQL ステートメントを構成するクエリは、個々のサブクエリに分割されます。 サブクエリに分割すると、各クエリブロックの実行詳細を個別に検査できます。

メモ

DROP コマンドを使用する匿名ブロックの実行詳細は、次のようになります。 not は、別のサブクエリとしてレポートされます。 CTAS クエリ、ITAS クエリ、および匿名ブロックサブクエリとして使用される COPY ステートメントに対して、個別の実行詳細を使用できます。 DROP コマンドの実行の詳細は、現在サポートされていません。

匿名ブロックは、 $$ プレフィックスを使用します。 クエリサービスの匿名ブロックについて詳しくは、 匿名ブロックドキュメント.

匿名ブロックサブクエリの実行ステータスの左側にタブがあります。 実行の詳細を表示するタブを選択します。

匿名ブロッククエリを表示するクエリ実行の概要。 複数のクエリタブがハイライト表示されます。

匿名ブロッククエリが失敗したイベントでは、この UI を使用してその特定のブロックのエラーコードを見つけることができます。

クエリ実行の概要では、1 つのブロックのエラーコードがハイライト表示された匿名ブロッククエリを表示します。

クエリ」を選択してスケジュール詳細画面に戻るか、「スケジュール済みクエリ」を選択して「スケジュール済みクエリ」タブに戻ります。

クエリがハイライト表示された実行詳細画面

このページ