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

ガードレールとは、Adobe Experience Platformでのデータとシステムの使用状況、パフォーマンスの最適化、エラーや予期しない結果の回避を導くしきい値です。
このドキュメントでは、Query Service データのデフォルトの使用制限を提供し、ライセンスの使用権限に関するデータをクエリする際にシステムのパフォーマンスを最適化するのに役立ちます。

IMPORTANT
このガードレール ページに加えて、実際の使用制限について、セールスオーダーと対応する製品説明のライセンス使用権限を確認してください。

前提条件

このドキュメントを続ける前に、クエリサービスの主な定義と機能について十分に理解しておく必要があります。 以下に説明します。

  • アドホッククエリ: SELECT クエリを実行して、クエリ の結果がデータレイクに保存されていないデータを探索、実験、検証します

  • バッチクエリ: データのクリーニング、整形、操作、およびエンリッチを行うためにINSERT TABLE AS SELECTおよびCREATE TABLE AS SELECT クエリを実行します。 これらのクエリ の結果は、データレイクに​格納されます。 この機能の消費量を測定するための指標は計算時間です。

  • Query Service ユーザー:現在のライセンスで提供されているCustomer Journey Analytics、Adobe Real-Time Customer Data Platform、および/またはAdobe Journey OptimizerのQuery Service ユーザーは、Data Distillerでも使用できます。 Query Service ユーザーは、機能の間で共有されます。

  • アドホックユーザー:アドホックユーザーとは、アドホッククエリを実行しているユーザーのことです。

  • バッチユーザー: バッチユーザーは、バッチクエリを実行しているユーザーです。

  • レポート API: データ フェッチ呼び出しを(内部または外部で)行うためのAPI。 拡張レポートデータモデルは、Real-Time CDP ダッシュボードデータモデルなど、Adobe Experience Platformのネイティブレポートデータモデルから派生します。

ガードレール タイプ

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

ガードレール型
説明
パフォーマンスガードレール (ソフト制限)
パフォーマンスガードレールは、ユースケースの範囲に関連する使用制限です。 パフォーマンスのガードレールを超えると、パフォーマンスの低下や遅延が発生する場合があります。 Adobeはこのようなパフォーマンス低下の責任を負いません。 パフォーマンスのガードレールを常に超えているお客様は、パフォーマンスの低下を回避するために、追加の容量のライセンスを取得できます。
システムが適用するガードレール (ハード制限)
システムによって適用されるガードレールは、Real-Time CDP UIまたはAPIによって適用されます。 UIとAPIによってブロックされたり、エラーが返されたりするため、これらの制限を超えることはできません。
NOTE
このドキュメントで説明したデフォルトの制限は、常に改善されています。 定期的にアップデートを確認してください。

プライマリエンティティのパフォーマンスガードレール

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

アドホッククエリ

ガードレール
上限
制限タイプ
説明
最大実行時間
10 分
システム強制ガードレール
これは、アドホック SQL クエリの最大出力時間を定義します。 結果を返す時間の制限を超えると、エラーコード 53400がスローされます。
同時クエリサービスユーザー
  • アプリケーション製品の説明で指定されているように。
  • +5 (アドホッククエリユーザーアドオンパックを追加購入するたびに)
システム強制ガードレール
これは、特定の組織に対して同時にセッションを作成できるユーザー数を定義します。 同時実行数の制限を超えると、ユーザーはSession Limit Reached エラーを受信します。
クエリの同時実行
  • アプリケーション製品の説明で指定されているように。
  • +1 (アドホッククエリユーザーアドオン SKU パックを購入するたびに)
システム強制ガードレール
これは、特定の組織に対して同時に実行できるクエリの数を定義します。 同時実行数の制限を超えると、クエリはキューに入れられます。
クライアントコネクタと結果出力制限

クライアントコネクタ

  • クエリ UI (100行)
  • サードパーティクライアント(50,000)
  • PostgresSQL クライアント (50,000)
システム強制ガードレール

クエリの結果は、次の方法で受信できます。

  • クエリサービス UI
  • サードパーティクライアント
  • PostgresSQL クライアント

注意:出力数に制限を加えると、結果がより速く返される場合があります。 例えば、LIMIT 5LIMIT 10 など。

を介して返された結果
クライアント UI
なし
これにより、結果をユーザーが利用できるようにする方法を定義します。

バッチクエリ

ガードレール
制限
種類を制限
説明
最大実行時間
24 時間
システム強制ガードレール
これにより、バッチ SQL クエリの最大実行時間が定義されます。
クエリの処理時間は、処理するデータの量とクエリの複雑さによって異なります。
スケジュールされていないバッチの同時クエリサービスユーザー
  • アプリケーション製品の説明で指定されているように。
  • +5 (アドホッククエリユーザーアドオンパックを追加購入するたびに)
システム強制ガードレール
スケジュールされていないバッチクエリ(インタラクティブモードのCTAS/ITAS クエリなど)の場合、特定の組織に対して同時にセッションを作成できるユーザー数を定義します。 同時実行数の制限を超えると、ユーザーはSession Limit Reached エラーを受信します。
スケジュールされたバッチの同時クエリサービスユーザー
ユーザー制限なし
なし
スケジュールされたバッチクエリは非同期ジョブであるため、ユーザーの制限はありません。
バッチデータ処理の計算時間
お客様のAdobe Experience Platform Intelligence Query Custom SKU Sales orderで指定されているように
パフォーマンスガードレール
これは、顧客がデータレイクにデータをスキャン、処理、書き込むためのバッチクエリを実行するために許可される、年間の計算時間範囲を定義します。
クエリの同時実行
サポートあり
なし
スケジュールされたバッチクエリは非同期ジョブであるため、同時クエリはサポートされます。
クライアントコネクタと結果出力制限

クライアントコネクタ

  • クエリ UI (行に上限はありません)
  • サードパーティクライアント(行に上限なし)
  • PostgresSQL クライアント (行に上限はありません)
  • REST API (行の上限なし)
システム強制ガードレール

クエリの結果は、次の方法を使用して利用できます。

  • 派生データセットとして保存可能
  • 既存の派生データセットに挿入できます

注:クエリ結果のレコード数に上限はありません。

を介して返された結果
データセット
なし
これにより、結果をユーザーが利用できるようにする方法を定義します。

クエリ高速化ストア query-accelerated-store

次の表に、クエリアクセラレーションストアの推奨ガードレール制限と説明を示します。

ガードレール
上限
制限タイプ
説明
クエリの同時実行
4
システム強制ガードレール
レポート API (Real-Time CDP データモデルなどのデータモデルを強化するクエリを含む)を介して集約されたデータに対するクエリが効率的に実行するためのリソースを備えていることを確認するために、レポート APIは、各クエリに同時実行スロットを割り当てることで、リソース使用率を追跡します。 システムはクエリをキューに入れ、同時実行スロットが使用可能になるか、キャッシュから提供されるまで待機します。 最大4つの同時クエリスロットが常に使用可能です。
BI ツールを使用してレポート APIにアクセスし、より多くの同時実行が必要な場合は、BI サーバーが必要です。

次の手順

このドキュメントを読むと、使用可能なクエリパターンを使用したクエリ実行のデフォルトの制限についてより深く理解できるようになります。

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

その他のExperience Platform サービスのガードレール、エンドツーエンドの待ち時間に関する情報、Real-Time CDPの製品説明ドキュメントからのライセンス情報については、次のドキュメントを参照してください。

recommendation-more-help
experience-platform-help-query-service