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

ガードレールとは、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 5LIMIT 10 など。

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

バッチクエリ

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

クライアントコネクタ

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

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

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

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

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

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

次の表に、クエリ高速化ストアに対して推奨されるガードレールの制限と説明を示します。

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

次の手順

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

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

他のExperience Platformサービスのガードレール、エンドツーエンドの待ち時間の情報およびReal-Time CDP Product Description のドキュメントからのライセンス情報について詳しくは、次のドキュメントを参照してください。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb