クエリサービスデータのガードレール

ガードレールとは、Adobe Experience Platform でのデータやシステムの使用状況、パフォーマンスの最適化、エラーや予期しない結果の回避に関するガイダンスを提供するしきい値のことです。

このドキュメントでは、ライセンス権限に関連するデータをクエリする際のシステムパフォーマンスを最適化するのに役立つ、クエリサービスデータのデフォルトの使用制限を提供します。

前提条件

このドキュメントを続行する前に、次の 2 つの主要なクエリサービス機能を十分に理解しておく必要があります。

  • アドホッククエリ:実行用 SELECT クエリの結果を含むデータを調査、実験、検証するクエリ 保存されていません をデータレイクに追加します。

  • バッチクエリ:実行用 INSERT TABLE AS SELECT および CREATE TABLE AS SELECT データの消去、形状化、操作、エンリッチメントをおこなうクエリ。 これらのクエリの結果 が保存されている をデータレイクに追加します。 この機能の消費量を測定する指標は、計算時間です。

次の図は、クエリサービス機能が現在パッケージ化され、ライセンスを受け取っている方法をまとめたものです。

ライセンスに関するクエリサービス機能の配布とパッケージを説明する図です。

上限のタイプ

このドキュメントでは、次の 2 種類のデフォルトの上限について説明します。

  • ソフトリミット:ソフトリミットを超えても構いませんが、ソフトリミットはシステムのパフォーマンスに対して推奨されるガイドラインです。

  • ハードリミット:ハードリミットは絶対最大値を提供します。

メモ

このドキュメントで概要を説明するデフォルトの制限は、常に改善されています。 定期的にアップデートを確認してください。

プライマリエンティティ効果ガードレール

次の表に、特定のクエリパターンを使用する場合に実行するクエリに推奨されるガードレールの制限と説明を示します。

アドホッククエリ

ガードレール 上限 制限タイプ 説明
最大実行時間 10 分 ハード これは、アドホック SQL クエリの最大出力時間を定義します。 結果を返す時間制限を超えると、エラーコード53400がスローされます。
クエリの同時実行
  • アプリケーション製品の説明で指定されたとおり。
  • +1 (追加のアドホッククエリユーザーアドオン SKU パックを購入するたび)
ハード 特定の組織に対して同時に実行できるクエリの数を定義します。 同時実行制限を超えると、クエリはキューに入れられます。
クライアントコネクタと結果出力の制限 クライアントコネクタ
  • クエリ UI (100 行)
  • サードパーティクライアント (50,000)
  • PostgresSQL クライアント (50,000)
ハード クエリの結果は、次の方法で受け取ることができます。
  • クエリサービス UI
  • サードパーティクライアント
  • PostgresSQL client
注意:出力数に制限を追加すると、結果がより速く返される場合があります。 例えば、LIMIT 5LIMIT 10 など。
次を介して返された結果: クライアント UI N/A これは、結果をユーザーに提供する方法を定義します。

バッチクエリ

ガードレール 上限 制限タイプ 説明
最大実行時間 24 時間 ハード バッチ SQL クエリの最大実行時間を定義します。
クエリの処理時間は、処理するデータの量とクエリの複雑さに応じて異なります。
ユーザーの同時実行 ユーザーの制限なし 該当なし スケジュールされたバッチクエリは非同期ジョブなので、ユーザーの制限はありません。
バッチデータ処理の計算時間 お客様のAdobe Experience Platform Intelligence Query Custom SKU 販売注文で指定 ソフト これにより、顧客がバッチクエリを実行してデータをスキャンし、処理し、データレイクに書き戻す際に許可される、1 年あたりの計算時間の範囲を定義します。
クエリの同時実行 サポートあり 該当なし スケジュールされたバッチクエリは非同期ジョブなので、同時クエリがサポートされます。
クライアントコネクタと結果出力の制限 クライアントコネクタ
  • クエリ UI (行の上限なし)
  • サードパーティクライアント(行の上限なし)
  • PostgresSQL クライアント(行の上限なし)
  • REST API(行の上限なし)
ハード クエリの結果は、次の方法で使用できます。
  • 派生データセットとして保存可能
  • 既存の派生データセットに挿入可能
注意:クエリ結果のレコード数に上限はありません。
次を介して返された結果: データセット 該当なし これは、結果をユーザーに提供する方法を定義します。

次の手順

このドキュメントを読んだ後は、使用可能なクエリパターンに基づいて、クエリ実行のデフォルトの制限をより深く理解する必要があります。

クエリサービスについて詳しくは、次のドキュメントを参照してください。

このページ