GraphQLクエリの最適化 optimizing-graphql-queries

これらのガイドラインは、GraphQLクエリでのパフォーマンスの問題を防ぐために提供されています。

GraphQLチェックリスト graphql-checklist

次のチェックリストは、Adobe Experience Manager(AEM)as a Cloud ServiceのGraphQLの設定と使用を最適化するためのものです。

第 1 原則 first-principles

永続的なGraphQLクエリを使用 use-persisted-graphql-queries

レコメンデーション

永続化されたGraphQLクエリの使用を強くお勧めします。

永続的なGraphQLクエリは、コンテンツ配信ネットワーク (CDN) を利用して、クエリの実行パフォーマンスを低減するのに役立ちます。 クライアントアプリケーションは、高速なエッジ対応の実行を実現するために、GETリクエストを使用して永続化されたクエリをリクエストします。

その他の参照

以下を参照してください。

キャッシュ方法 cache-strategy

キャッシュの様々な方法を最適化に使用することもできます。

AEM Dispatcher のキャッシュの有効化 enable-aem-dispatcher-caching

レコメンデーション

AEM Dispatcher は、AEMサービス内の、CDN キャッシュの前の第 1 レベルのキャッシュです。

その他の参照

以下を参照してください。

コンテンツ配信ネットワーク (CDN) の使用 use-cdn

レコメンデーション

GraphQLクエリとその JSON 応答は、をターゲット設定した場合はキャッシュできます GET リクエストを送信する必要があります。 これに対し、キャッシュされていないリクエストは、（リソース）非常に高コストで処理に時間がかかる場合があり、元のリソースにさらに悪影響を及ぼす可能性があります。

その他の参照

以下を参照してください。

HTTP キャッシュ制御ヘッダーの設定 set-http-cache-control-headers

レコメンデーション

永続化されたGraphQLクエリを CDN で使用する場合は、適切な HTTP キャッシュ制御ヘッダーを設定することをお勧めします。

永続化された各クエリには、独自のキャッシュ制御ヘッダーのセットを設定できます。 ヘッダーは、 GraphQL API または AEM GraphiQL IDE.

その他の参照

以下を参照してください。

AEM GraphQLのプリキャッシュの使用 use-aem-graphql-pre-caching

レコメンデーション

この機能を使用すると、AEMは、GraphQLクエリの範囲内でコンテンツをさらにキャッシュでき、1 行に 1 行ずつではなく、JSON 出力でブロックとしてアセンブルできます。

その他の参照

Adobeに問い合わせて、AEM Cloud Serviceのプログラムおよび環境でこの機能を有効にします。

GraphQL Query optimization graphql-query-optimization

同じモデルを共有するコンテンツフラグメントが多数ある AEM インスタンスでは、GraphQL のリストクエリに（リソースの点で）コストがかかる場合があります。

これは、GraphQL クエリ内で使用されているモデルを共有する​ すべての ​フラグメントを、メモリに読み込む必要があるためです。これは時間とメモリの両方を消費します。 結果セット全体をメモリに読み込んだ​ 後に ​のみ、（最終的な）結果セット内の項目数を減らす可能性のあるフィルタリングを適用できます。

これにより、小さな結果セットでもパフォーマンスが低下するというインプレッションを与える可能性があります。ただし、実際には、フィルタリングを適用する前に内部で処理する必要があるので、初期結果セットのサイズが原因で速度が低下します。

パフォーマンスとメモリの問題を減らすには、この初期結果セットをできるだけ小さく保つ必要があります。

AEM には、GraphQL クエリを最適化する 2 つの方法があります。

各アプローチには、独自のユースケースと制限があります。 この節では、ハイブリッドフィルターとページングに関する情報と、 ベストプラクティス GraphQLクエリの最適化に使用する

AEM GraphQLハイブリッドフィルタリングの使用 use-aem-graphql-hybrid-filtering

レコメンデーション

ハイブリッドフィルタリングは、JCR フィルタリングと AEM フィルタリングを組み合わせます。

結果セットを AEM フィルタリング用のメモリに読み込む前に、（クエリ制約の形式で）JCR フィルターを適用します。 これは、JCR フィルターによって余分な結果が先に削除されるので、メモリに読み込まれる結果セットを減らすためです。

この方法では、GraphQL フィルターが提供する柔軟性を維持しながら、可能な限り多くのフィルタリングを JCR に委任できます。

その他の参照

以下を参照してください。

GraphQLのページネーションを使用 use-aem-graphql-pagination

レコメンデーション

大きな結果セットを持つ複雑なクエリの応答時間は、GraphQL標準のページネーションを使用して応答をチャンクにセグメント化することで、改善できます。

AEM の GraphQL では、次の 2 種類のページネーションに対応しています。

その他の参照

以下を参照してください。

GraphQLの並べ替えを使用 use-graphql-sorting

レコメンデーション

また、GraphQL標準の並べ替え機能を使用すると、クライアントは JSON コンテンツを並べ替えられた順序で受け取ることができます。 これにより、クライアント上でさらに処理する必要が減少します。

並べ替えは、すべての並べ替え条件が最上位のフラグメントに関連している場合にのみ効率的です。

並べ替え順に、ネストされたフラグメントに配置された 1 つ以上のフィールドが含まれている場合、最上位モデルを共有するすべてのフラグメントをメモリに読み込む必要があります。 これにより、パフォーマンスが低下します。

その他の参照

以下を参照してください。

ベストプラクティス best-practices

すべての最適化レコメンデーションの主な目的は、初期結果セットを減らすことです。 ここに示すベストプラクティスで、その方法を説明します。 組み合わせることができます（推奨）。

最上位のプロパティのみをフィルター filter-top-level-properties-only

現在、JCR レベルでのフィルタリングは、最上位のフラグメントに対してのみ機能します。

フィルターがネストされたフラグメントのフィールドに対応する場合、AEM はフォールバックして、基になるモデルを共有するすべてのフラグメントを（メモリに）読み込む必要があります。

最上位のフラグメントのフィールドとネストされたフラグメントのフィールドのフィルター式を、AND 演算子と組み合わせることで、このような GraphQL クエリを引き続き最適化できます。

コンテンツ構造の使用 use-content-structure

AEM では、通常、リポジトリ構造を使用して、処理するコンテンツの範囲を絞り込むことをお勧めします。

この方法は、GraphQL クエリにも適用する必要があります。

これを実行するには、最上位フラグメントの _path フィールドにフィルターを適用します。

{
  someList(filter: {
    _path: {
      _expressions: [
        {
          value: "/content/dam/some/sub/path/",
          _operator: STARTS_WITH
        }
      ]
    }
  }) {
    items {
      # ...
    }
  }
}

ページングの使用 use-paging

ページングを使用して、初期の結果セットを減らすこともできます（特に、リクエストでフィルタリングと並べ替えを使用しない場合）。

ネストされたフラグメントをフィルターまたは並べ替える場合でも、AEM は大量のフラグメントをメモリに読み込む必要があるので、ページ分割されたクエリの処理に時間がかかる場合があります。 したがって、フィルタリングとページングを組み合わせる場合は、（前述のように）フィルタリングのルールを考慮してください。

ページングの場合、ページ分割された結果が常に明示的または暗黙的に並べ替えられるので、並べ替えも同様に重要です。

最初の数ページのみを取得したい場合、...List クエリと ...Paginated クエリの使用に大きな違いはありません。 ただし、アプリケーションで 1～2 ページ以上のページを読みたい場合は、...Paginated クエリを使用することをお勧めします。後のページで、パフォーマンスが著しく向上します。

フィルター式の論理演算 logical-operations-in-filter-expressions

ネストされたフラグメントをフィルタリングする場合でも、AND 演算子を使用して組み合わされた最上位フィールドに付随するフィルターを提供して、JCR フィルタリングを適用できます。

一般的なユースケースは、最上位フラグメントの _path フィールドでフィルターを使用してクエリの範囲を制限し、最上位またはネストされたフラグメント上の追加フィールドでフィルタリングすることです。

この場合、様々なフィルター式が AND で組み合わされます。したがって、_path のフィルターにより、初期の結果セットが効果的に制限されます。 最上位フィールドのその他すべてのフィルターも、AND で組み合わせた場合を除き、初期結果セットを減らすのに役立ちます。

ネストされたフラグメントが含まれている場合、OR で組み合わされたフィルター式を最適化できません。OR 式は、ネストされたフラグメントが含まれて​ いない ​場合にのみ最適化できます。

複数行のテキストフィールドに対するフィルタリングの回避 avoid-filtering-multiline-textfields

複数行のテキストフィールド（html、markdown、plaintext、json）のフィールドは、JCR クエリでフィルタリングできません。これらのフィールドの内容をその場で計算する必要があるからです。

それでも複数行のテキストフィールドに対してフィルタリングする必要がある場合は、フィルター式を追加して、初期の結果セットのサイズを制限し、AND と組み合わせることを検討してください。_path フィールドに対してフィルタリングして範囲を制限することも、適切なアプローチです。

仮想フィールドに対するフィルタリングの回避 avoid-filtering-virtual-fields

仮想フィールド（_ で始まるほとんどのフィールド）は、GraphQL クエリの実行中に計算されるので、JCR ベースのフィルタリングの範囲外です。

重要な例外は _path フィールです。コンテンツが適切に構造化されている場合は、初期結果セットのサイズを効果的に削減するために使用できます（コンテンツ構造の使用を参照）。

：フィルタリング除外 filtering-exclusions

JCR レベルでフィルター式を評価できない場合が他にもいくつかあります（したがって、最高のパフォーマンスを実現するには回避する必要があります）。

コンテンツフラグメントのネストを最小化 minimize-content-fragment-nesting

コンテンツフラグメントのネストは、カスタムコンテンツ構造をモデル化する優れた方法です。 ネストされたフラグメントを含むフラグメントを持つこともできます。そのフラグメントには、ネストされたフラグメントも含まれ、その中に…などが含まれています。

ただし、レベルが多すぎる構造を作成すると、GraphQLはネストされたすべてのコンテンツフラグメントの階層全体をトラバースする必要があるので、GraphQLクエリの処理時間が長くなる可能性があります。

深いネストは、コンテンツガバナンスに悪影響を与える可能性もあります。 一般に、コンテンツフラグメントのネストは、5 レベルまたは 6 レベル未満に制限することをお勧めします。

すべてのフォーマットを出力しない（複数行テキスト要素） do-not-output-all-formats

AEM GraphQLは、 複数行テキスト 複数の形式のデータタイプ：リッチテキスト、シンプルテキスト、Markdown。

3 つの形式をすべて出力すると、JSON で出力されるテキストのサイズが約 3 倍になります。 これを、非常に広範なクエリからの一般的に大きな結果セットと組み合わせると、非常に大きな JSON 応答が生成されるので、計算に長い時間がかかる場合があります。 コンテンツのレンダリングに必要なテキスト形式のみに出力を制限することをお勧めします。

コンテンツフラグメントの変更 modifying-content-fragments

AEM UI または API を使用して、コンテンツフラグメントとそのリソースのみを変更します。 JCR で直接変更を行わないでください。

クエリのテスト test-your-queries

GraphQLクエリの処理は検索クエリの処理と似ており、単純なGETオールコンテンツ API リクエストよりも大幅に複雑です。

管理対象の非実稼動環境でクエリを慎重に計画、テスト、最適化することが、後で実稼動環境で使用する際に成功するための鍵となります。