制限GraphQL APIプレビュー
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックではプレビュー GraphQL APIの制限と制約について説明します。
カスタムフィールド命名
検索述語で使用されるカスタムフィールド名は、アンダースコア(_)で始まることはできません。検索サービスは、_name、_path、_languageなどのシステムフィールドに対してアンダースコア接頭辞を予約します。 _myCustomFieldというカスタムフィールドで検索しようとすると、例外が発生します(NotSupportedFieldException)。これはサービスがカスタムフィールドをシステムフィールドの内部許可リストと照らして解決しようとするためです。
ページ数制限
ページ数制限はクエリの種類によって異なります:
-
allSiteInfoクエリ - オフセット(ページ番号×ページサイズ)の組み合わせは10,000を超えてはなりません。この数値を超えると、以下のエラーメッセージが表示されます。
オフセットページングは最大10,000サイトまでしかサポートできませんでしたが、以前は{X}
-
Dictionaryクエリ - サイトノードのfirst引数(ページサイズ)は1,000を超えてはなりません。サイト { siteInfo { dictionary(first: 1001) } }などのフィールドで最初の1,001個以上を要求すると、GraphQLエラーが発生します。
「最初の」値は1000を超えてはいけません
オペレーターの挙動
Equality演算子(EQ)は、弦場のContains演算子のように振る舞います。例えば、次の検索述語はフィールドトークン化のため完全一致にはなりません。この制限を回避するには、関連するサポート記事KB1003665を参照してください。
name: "customField" value: "value to look for" operator: EQ
順序付けの挙動
検索クエリは、項目テキストフィールドでorderByを使うとフィールドトークン化のために一貫性のない結果を返すことがあります。
ルート経路の制限
サイトクエリのルートフィールドはフィルタリングされたパスの数を制限します。 includedPaths引数とexcludedPaths引数に与えられる文字列の合計は100を超えてはなりません。この限界を超えるとエラーが発生します:
「routes」フィールドでは、「excludedPaths」と「includedPaths」の合計数は100を超えてはなりません
URL解決
アイテムのurlフィールドはオーバーライドItemUrlBuilderOptionsで解決されます:
- AlwaysIncludeServerUrl は trueに設定されています。
- AlwaysExcludeVirtualFolder は trueに設定されています。
- SiteResolving 無効化されています(false)。
- スペースはダッシュに符号化されます。