---
title: "制限GraphQL APIプレビュー"
slug: "preview-graphql-api-limitations-and-restrictions"
abstract: "プレビュー GraphQL APIを使う際の制限、制限、そして制約。"
---
# 制限GraphQL APIプレビュー

このトピックではプレビュー 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](https://support.sitecore.com/kb?id=kb_article_view&sysparm_article=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)。
-   スペースはダッシュに符号化されます。