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

最終更新日： 2025年5月5日
  • トピック：

作成対象：

  • ユーザー
  • 開発者

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

IMPORTANT
このガードレール ページに加えて、販売注文と対応する 製品説明でライセンスの使用権限を確認してください。

前提条件

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

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

  • バッチクエリ：データのク INSERT TABLE AS SELECT ーン、シェイプ、操作およびエンリッチメントを行うデータクエリと CREATE TABLE AS SELECT クエリを実行します。 これらのクエリの結果は、データレイク上で 保存され す。 この機能の消費量を測定する指標は計算時間です。

  • クエリサービスユーザー:Customer Journey Analytics、Adobe Real-Time Customer Data Platform、Adobe Journey Optimizerの現在のライセンスで提供されているクエリサービスユーザーも、Data Distillerで使用できます。 クエリサービスのユーザーは、機能間で共有されます。

  • アドホックユーザー：アドホックユーザーは、アドホッククエリを実行するユーザーです。

  • バッチユーザー：バッチユーザーは、バッチクエリを実行するユーザーです。

  • レポート 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 5、LIMIT 10 など。

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

バッチクエリ

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

クライアントコネクタ

  • クエリ UI （行の上限なし）
  • サードパーティクライアント （行の上限なし）
  • PostgresSQL クライアント （行の上限なし）
  • REST API （行の上限なし）
システムに適用されたガードレール

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

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

注意：問合せ結果からのレコード数に上限はありません。

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