このページは Cloud Translation API によって翻訳されました。

スキーマを作成して登録する

Google Cloud Search スキーマは、構造化データを定義するデータのインデックス登録やクエリに使用するオブジェクト、プロパティ、オプションが含まれます。コンテンツコネクタはリポジトリからデータを読み取り、データが構造化され、インデックスに登録されます。

スキーマを作成するには、JSON スキーマオブジェクトを API に提供してから登録します。データをインデックスに登録するには、事前に各リポジトリにスキーマオブジェクトを登録する必要があります。

このドキュメントでは、スキーマ作成の基礎について説明します。検索エクスペリエンスを向上させるためにスキーマを調整する方法については、検索品質の向上をご覧ください。

スキーマを作成する

Cloud Search スキーマを作成するには、次の手順に従います。

想定されるユーザーの行動を特定する
データソースを初期化する
スキーマの作成
完全なサンプルスキーマ
スキーマを登録する
データをインデックス登録する
スキーマをテストする
スキーマを調整する

で確認できます。

予想されるユーザーの行動を特定する

ユーザーが実行するクエリの種類を予測することは、スキーマの作成戦略につながります。

たとえば、ユーザーが映画のデータベースに対してクエリを発行する場合、「Robert Redford が主演するすべての映画を表示する」などのクエリが予測されます。したがって、スキーマでは、「特定の俳優が出演するすべての映画」に基づくクエリ結果をサポートする必要があります。

ユーザーの行動パターンを反映するようにスキーマを定義するには、次のタスクを実行することを検討してください。

さまざまなユーザーから要求される多様なクエリを評価します。
クエリで使用される可能性があるオブジェクトを特定します。オブジェクトとは、映画データベース内の映画のような、関連データの論理的集合です。
オブジェクトの構成要素であるプロパティと値使用できます。 プロパティは、オブジェクトのインデックス登録可能な属性です。プリミティブ値または他のオブジェクトを含めることができます。たとえば、movie オブジェクトには、映画のタイトルやプリミティブ値として設定できます。また、出演者のように、名前や役柄などの固有のプロパティを持つ他のオブジェクトを含めることもできます。
プロパティの有効な値のサンプルを見つけます。値とは、プロパティに対してインデックス登録される実際のデータのことです。たとえば、データベースには「レイダース / 失われたアーク《聖櫃》」というタイトルの映画が含まれているかもしれません。
ユーザーが希望する並べ替えとランキングのオプションを決定します。たとえば、映画のクエリでは、タイトルでアルファベット順に並べ替えるよりも、年代順に並べ替えて視聴者の評価でランク付けするほうがよい場合があります。
（省略可）より具体的な検索が行われる可能性があるコンテキスト（たとえば、ユーザーの職務または基づいて予測入力の候補を表示させることができます。説明します。たとえば、映画のデータベースを検索しているユーザーの場合、特定のジャンルの映画だけに興味を抱くユーザーですユーザーは何を特定のジャンル（おそらくユーザーの一部として検索してもらいたいジャンル）選択します。ユーザーが映画のクエリを開始すると好きなジャンルの映画（例: 「アクション映画」、として提案されます。予測入力の候補の一部分に移動することもできます
検索に使用される可能性があるオブジェクト、プロパティ、サンプル値のリストを作成します（このリストの使用方法の詳細については、演算子オプションを定義するをご覧ください）。

データソースを初期化する

データソースとは、Google Cloud にインデックス登録されて格納されているリポジトリのデータを表します。データソースを初期化する手順については参照サードパーティのデータソースを管理します。

ユーザーの検索結果はデータソースから返されます。ユーザーが検索結果をクリックすると、インデックス登録リクエストで指定された URL を使用して実際のアイテムに誘導されます。

オブジェクトを定義する

スキーマ内のデータの基本単位はオブジェクトです。これはデータの論理構造で、「スキーマオブジェクト」とも呼ばれます。映画のデータベースでは、1 つのデータの論理構造は「movie」です。別のオブジェクトとして "person"から映画に登場するキャストやクルーを表現します。

スキーマ内の個々のオブジェクトに、映画のタイトルや上映時間、人物の名前や生年月日など、そのオブジェクトを構成する一連のプロパティ（属性）があります。オブジェクトのプロパティには、プリミティブ値や他のオブジェクトを含めることができます。

図 1 は、映画オブジェクトと人物オブジェクトおよびそれぞれに関連するプロパティを示しています。

エンティティ間のスキーマ接続の描画 — **図 1.** 2 つのオブジェクトを示すサンプルスキーマサブオブジェクトがあります。

Cloud Search スキーマは、オブジェクト定義ステートメントのリストで、 objectDefinitions タグ。次のスキーマスニペットは、映画スキーマオブジェクトと人物スキーマオブジェクトの objectDefinitions ステートメント。

{
  "objectDefinitions": [
    {
      "name": "movie",
      ...
    },
    {
      "name": "person",
      ...
    }
  ]
}

スキーマオブジェクトを定義するときは、オブジェクトに対して name を一意である必要があります。通常は name を使用します。オブジェクトを説明する値（movie オブジェクトの movie など）。スキーマサービスは、インデックス登録可能なオブジェクトのキー識別子として name フィールドを使用します。対象 name フィールドの詳細については、オブジェクト定義。

オブジェクトのプロパティを定義する

これについては、 ObjectDefinition オブジェクト名の後に options、およびリストに含まれる propertyDefinitions。「 options でできることさらに構成される freshnessOptions および displayOptions。「 freshnessOptions は、アイテムの鮮度に基づいて検索ランキングを調整するために使用されます。「 displayOptions を使用して、特定のラベルとプロパティをオブジェクトの検索結果です

「 propertyDefinitions セクションでは、映画のタイトルなど、オブジェクトのプロパティを定義します。リリース日も確認できます。

次のスニペットは、2 つのプロパティ movieTitle を持つ movie オブジェクトを示しています。および releaseDate。

{
  "objectDefinitions": [
    {
      "name": "movie",
      "propertyDefinitions": [
        {
          "name": "movieTitle",
          "isReturnable": true,
          "isWildcardSearchable": true,
          "textPropertyOptions": {
            "retrievalImportance": { "importance": "HIGHEST" },
            "operatorOptions": {
              "operatorName": "title"
            }
          },
          "displayOptions": {
            "displayLabel": "Title"
          }
        },
        {
          "name": "releaseDate",
          "isReturnable": true,
          "isSortable": true,
          "datePropertyOptions": {
            "operatorOptions": {
              "operatorName": "released",
              "lessThanOperatorName": "releasedbefore",
              "greaterThanOperatorName": "releasedafter"
            }
          },
          "displayOptions": {
            "displayLabel": "Release date"
          }
      ...
      ]
    }
  ]
}

PropertyDefinition は、次の項目で構成されます。

name 文字列。
型に依存しないオプションのリスト（前述の isReturnable など）スニペットです。
タイプとそれに関連付けられたタイプ固有のオプション（前のスニペットの textPropertyOptions や retrievalImportance など）。
プロパティがどのように使用されるかを表す operatorOptions。検索演算子を使用します。
1 つ以上の displayOptions（前のスニペットの displayLabel など）。

プロパティの name は、含まれるオブジェクト内で一意である必要があります。他のオブジェクトやサブオブジェクトでは同じ名前を使用できます。図 1 では、映画のタイトルと公開日が 2 回定義されています。 movie オブジェクトで 1 回、もう 1 回は filmography サブオブジェクトで person オブジェクト。このスキーマでは movieTitle フィールドを再利用していますこれにより、スキーマが次の 2 種類の検索動作をサポートできるようになります。

ユーザーが映画のタイトルを検索した場合、映画の結果を表示します。
ユーザーが映画のタイトルで特定の出演俳優を検索した場合、人物の結果を表示します。

同様に、スキーマでは同じ releaseDate フィールドがあるため、再利用しています。 2 つの movieTitle フィールドの意味を確認します。

独自のスキーマを開発する際には、スキーマで複数回宣言するデータを含む関連項目がリポジトリ内でどのように定義されているかを考慮してください。

型に依存しないオプションを追加する

PropertyDefinition には、データ型に関係なく、すべてのプロパティに共通する一般的な検索機能オプションをリストします。

isReturnable - プロパティが識別されるべきデータかどうかを示します。クエリ API を介して返されます。サンプル映画のすべてプロパティを返すことができます。逆に、ユーザーに返さないプロパティは、結果を検索したり、ランク付けしたりするために使用できます。
isRepeatable - プロパティに複数の値が許可されているかどうかを示します。たとえば、映画の公開日は 1 つしかありませんが、俳優は複数人いることが考えられます。
isSortable - プロパティを並べ替えに使用できることを示します。繰り返し可能なプロパティに対しては true に設定することはできません。たとえば、映画の結果は、公開日または視聴率によって並べ替えることができます。
isFacetable - プロパティをファセットの生成に使用できることを示します。ファセットは、検索結果を絞り込むときに使用します。次に、条件（ファセット）を追加してさらに絞り込みます表示されます。タイプがオブジェクトで、かつこのオプションを設定するには、isReturnable を true にする必要があります。最後に、このオプションは列挙型、ブール値、テキストの各プロパティでサポートされています。たとえば、このサンプルスキーマでは、次のように genre、actorName、userRating、mpaaRating ファセット可能で、以下を許可します。検索結果をインタラクティブに絞り込むために使用されます。
isWildcardSearchable は、ユーザーがワイルドカード検索を実行できることを示します。このプロパティを設定します。このオプションは、テキストプロパティでのみ使用できます。ワイルドカードの使用検索がテキストフィールドで動作するかどうかは、 exactMatchWithOperator フィールド。exactMatchWithOperator が true に設定されている場合: テキスト値は 1 つのアトミック値としてトークン化され、ワイルドカード検索は表示されます。たとえば、テキスト値が science-fiction の場合、ワイルドカードクエリ science-* が一致します。exactMatchWithOperator の設定の有無 false の場合、テキスト値はトークン化され、ワイルドカード検索が実行されます。定義できます。たとえば、テキスト値が「science-def」の場合、ワイルドカードは sci* または fi* のクエリはアイテムに一致しますが、science-* は一致しません。

これらの一般的な検索機能のパラメータはすべてブール値です。すべてデフォルト値の false で、true に設定する必要があります。使用されます。

次の表に、true に設定されているブール値パラメータを示します。 movie オブジェクトのすべてのプロパティに対して次のように設定します。

プロパティ	`isReturnable`	`isRepeatable`	`isSortable`	`isFacetable`	`isWildcardSearchable`
`movieTitle`	true				true
`releaseDate`	true		true
`genre`	true	true		true
`duration`	true
`actorName`	true	true		true	true
`userRating`	true		true
`mpaaRating`	true			true

genre と actorName の両方で isRepeatable が true に設定されています映画は複数のジャンルに属す可能性があり、通常は追跡します。プロパティが繰り返し可能であるか、繰り返し可能なサブオブジェクトに含まれている場合は、そのプロパティを並べ替えることはできません。

型を定義する

「 PropertyDefinition リファレンスセクションには、xx が特定の型であるいくつかの xxPropertyOptions がリストされています。 boolean など。プロパティのデータ型を設定するには、適切なデータ型オブジェクトを定義する必要があります。プロパティのデータ型オブジェクトを定義すると、そのプロパティのデータ型が設定されます。たとえば、 movieTitle プロパティの textPropertyOptions は、映画が title は text 型です。次のスニペットは、movieTitle プロパティを示しています。データ型は textPropertyOptions に設定しています。

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    ...
  },
  ...
},

1 つのプロパティには、1 つのデータ型のみを関連付けることができます。たとえば、この映画では releaseDate は日付（例:2016-01-13）または文字列（例:January 13, 2016）で、両方は使用できません。

サンプル映画スキーマでは、次のデータ型オブジェクトを使用して各種プロパティのデータ型が指定されています。

プロパティ	データ型オブジェクト
`movieTitle`	`textPropertyOptions`
`releaseDate`	`datePropertyOptions`
`genre`	`enumPropertyOptions`
`duration`	`textPropertyOptions`
`actorName`	`textPropertyOptions`
`userRating`	`integerPropertyOptions`
`mpaaRating`	`textPropertyOptions`

プロパティに選択するデータ型は、予想されるユースケースによって異なります。この映画スキーマの想定されるシナリオでは、結果を時系列で並べ替えるため、releaseDate は日付オブジェクトです。たとえば、12 月のリリースを比較するユースケースが想定されていた場合何年にもわたって 1 月にリリースされるような場合は、文字列形式が便利です。

型固有のオプションを構成する

PropertyDefinition リファレンスセクションは、各型のオプションにリンクしています。タイプ固有オプションは省略可能ですが、possibleValues enumPropertyOptions。また、orderedRanking オプションを使用すると、次のことができます。相対的に評価します。「次のスニペットは、textPropertyOptions を含む movieTitle プロパティを示しています。データ型を設定し、retrievalImportance 型固有のオプションを使用します。

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    ...
  },
  ...
}

それ以外に、サンプルスキーマで使用されている型固有のオプションは次のとおりです。

プロパティ	型	型固有のオプション
`movieTitle`	`textPropertyOptions`	`retrievalImportance`
`releaseDate`	`datePropertyOptions`
`genre`	`enumPropertyOptions`
`duration`	`textPropertyOptions`
`actorName`	`textPropertyOptions`
`userRating`	`integerPropertyOptions`	`orderedRanking`、`maximumValue`
`mpaaRating`	`textPropertyOptions`

演算子オプションを定義する

タイプ固有のオプションに加え、各タイプにはオプションの operatorOptions: このオプションでは、プロパティを検索演算子を使用します。次のスニペットは、次の値を含む movieTitle プロパティを示しています。 textPropertyOptions でデータ型を設定し、 retrievalImportance および operatorOptions 型固有のオプション。

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
      "operatorName": "title"
    }
  },
  ...
}

警告: 宿泊施設を上位にランク付けする必要があることが確実にわかっている場合を除きます。その他の候補より優先する場合は、retrievalImportance を DEFAULT に設定します。この設定後に変更することはできません。たとえば、あるプロパティが重要性を HIGHEST に指定することをおすすめします。ただし、他の部品を参照する部品番号が含まれているが、部品番号ではないプロパティの重要度を「低」にすることを検討してください。ご不明な点がある場合は、プロパティの重要度を確認するには、DEFAULT を使用します。テキストが取得に使用しない場合は、NONE を使用します。詳しくは重要性。

すべての operatorOptions には operatorName があります。たとえば、title は movieTitle。演算子名はプロパティの検索演算子です。検索演算子は、ユーザーが検索の絞り込みに使用すると予想される実際のパラメータです。たとえば、タイトルで映画を検索するには、ユーザーは「title:movieName」と入力します。ここで、movieName は映画の名前です。

演算子名をプロパティ名と同じにすることはできません。代わりに、演算子名には、組織内のユーザーが使用する最も一般的な単語を反映する必要があります。たとえば、ユーザーが映画のタイトルを表す用語として「title」ではなく「name」の使用を好む場合は、演算子名を「name」に設定する必要があります。

すべてのプロパティが同じ型に解決される場合に限り、複数のプロパティに対して同じ演算子名を使用できます。クエリの実行時に共有演算子名を使用した場合、その演算子名を使用するすべてのプロパティが取得されます。たとえば movie オブジェクトに plotSummary と plotSynopsis があるとします。各プロパティの operatorName は plot でした。として両方のプロパティがテキスト（textPropertyOptions）である場合に限り、単一のこの両方を取得するには、plot 検索演算子を使用します。

並べ替え可能なプロパティには、operatorName だけでなく、次のものがあります。 operatorOptions の lessThanOperatorName フィールドと greaterThanOperatorName フィールド。ユーザーはこれらのオプションを使用して、値。

最後に、textOperatorOptions には exactMatchWithOperator フィールドがあります。 operatorOptions。もし exactMatchWithOperator を true に設定した場合、クエリ文字列はテキスト内だけでなく、プロパティ値全体と一致することもできます。テキスト値は、演算子検索では 1 つのアトミック値として扱われます。あります。

たとえば、genre プロパティを持つ Book オブジェクトや Movie オブジェクトにインデックスを付けることを検討してください。ジャンルには、「SF」、「科学」、「フィクション」などがあります。あり exactMatchWithOperator を false に設定するか省略する。ジャンルを検索したり、「Science」コースをまたは「フィクション」ファセットも「SF」の検索結果テキストがトークン化され、 "科学"と「Fiction」があります。「SF」内に存在します。 exactMatchWithOperator が true の場合、単一のトークンとして扱われるため、どちらのトークンも "科学"「フィクション」でもない「Science-Fiction」と一致します。

（省略可）`displayOptions` セクションを追加する

末尾にオプションの displayOptions セクションがある場合、 propertyDefinition セクション。このセクションには 1 つの displayLabel 文字列が含まれます。 displayLabel は、わかりやすく推奨されるテキストラベルです。指定します。以下を使用してプロパティを表示するように設定されている場合、 ObjectDisplayOptions, このラベルは宿泊施設の前に表示されます。プロパティが構成されているかどうか displayLabel が定義されていない場合、プロパティ値のみが表示されます。

次のスニペットは、displayLabel を含む movieTitle プロパティを示しています。設定されます。

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
       "operatorName": "title"
    }
},
  "displayOptions": {
    "displayLabel": "Title"
  }
},

movie のすべてのプロパティの displayLabel 値は次のとおりです。次のように指定します。

プロパティ	`displayLabel`
`movieTitle`	`Title`
`releaseDate`	`Release date`
`genre`	`Genre`
`duration`	`Run length`
`actorName`	`Actor`
`userRating`	`Audience score`
`mpaaRating`	`MPAA rating`

（省略可）`suggestionFilteringOperators[]` セクションを追加

オプションの suggestionFilteringOperators[] セクションをpropertyDefinitionセクションの最後に追加できます。このセクションの内容予測入力の候補のフィルタに使用するプロパティを定義します。たとえば、たとえば、genre の演算子を定義して、ユーザーの好きな映画ジャンルを指定できます。ユーザーが検索クエリを入力したときに、好みのジャンルに一致する映画が予測入力の一部として表示される提案します。

スキーマを登録する

Cloud Search クエリから構造化データが返されるようにするには、Cloud Search スキーマサービスにスキーマを登録する必要があります。スキーマを登録する際には、データソースを初期化するステップで取得したデータソース ID が必要になります。

データソース ID を使用して、UpdateSchema リクエストを発行してスキーマを登録します。

UpdateSchema リファレンスページの詳細な説明に従って、次の HTTP リクエストを発行してスキーマを登録します。

PUT https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/schema

リクエストの本文には、次の内容が含まれている必要があります。

{
  "validateOnly": // true or false,
  "schema": {
    // ... Your complete schema object ...
  }
}

スキーマの有効性をテストするには、validateOnly オプションを使用します。表示されます。

データをインデックスに登録する

スキーマの登録後、インデックス呼び出しを使用してデータソースにインデックスを挿入します。インデックス登録は通常、コンテンツコネクタ内で行われます。

映画スキーマでは、1 つの映画に対する REST API インデックス登録リクエストは次のようになります。

{
  "name": "datasource/<data_source_id>/items/titanic",
  "acl": {
    "readers": [
      {
        "gsuitePrincipal": {
          "gsuiteDomain": true
        }
      }
    ]
  },
  "metadata": {
    "title": "Titanic",
    "sourceRepositoryUrl": "http://www.imdb.com/title/tt2234155/?ref_=nv_sr_1",
    "objectType": "movie"
  },
  "structuredData": {
    "object": {
      "properties": [
        {
          "name": "movieTitle",
          "textValues": {
            "values": [
              "Titanic"
            ]
          }
        },
        {
          "name": "releaseDate",
          "dateValues": {
            "values": [
              {
                "year": 1997,
                "month": 12,
                "day": 19
              }
            ]
          }
        },
        {
          "name": "actorName",
          "textValues": {
            "values": [
              "Leonardo DiCaprio",
              "Kate Winslet",
              "Billy Zane"
            ]
          }
        },
        {
          "name": "genre",
          "enumValues": {
            "values": [
              "Drama",
              "Action"
            ]
          }
        },
        {
          "name": "userRating",
          "integerValues": {
            "values": [
              8
            ]
          }
        },
        {
          "name": "mpaaRating",
          "textValues": {
            "values": [
              "PG-13"
            ]
          }
        },
        {
          "name": "duration",
          "textValues": {
            "values": [
              "3 h 14 min"
            ]
          }
        }
      ]
    }
  },
  "content": {
    "inlineContent": "A seventeen-year-old aristocrat falls in love with a kind but poor artist aboard the luxurious, ill-fated R.M.S. Titanic.",
    "contentFormat": "TEXT"
  },
  "version": "01",
  "itemType": "CONTENT_ITEM"
}

objectType フィールドの movie の値がオブジェクトと一致することに注目してください。定義名を指定します。Cloud Search では、これらの 2 つの値の対応付けに基づいて、インデックス登録時に使用するスキーマオブジェクトが認識されます。

また、スキーマプロパティ releaseDate のインデックス作成で、 year、month、day のサブプロパティであり、 datePropertyOptions を使用して定義することで、date データ型として定義されます。ただし、year、month、day はスキーマで定義されていないため、これらのプロパティの 1 つに対してクエリを実行することはできません（例:year など）を個別に参照する必要があります。

また、リストを使用して繰り返し可能なプロパティ actorName がどのようにインデックスに登録されるかにも注目してください。使用できます。

インデックス登録における潜在的な問題を特定する

スキーマとインデックス登録に関する最も一般的な問題として、次の 2 つがあります。

スキーマサービスに登録されていないスキーマオブジェクト名またはプロパティ名がインデックス登録リクエストに含まれている。この問題が原因で、プロパティまたはオブジェクトが無視されます。
スキーマに登録されている型と異なる型を持つプロパティがインデックス登録リクエストに含まれている。この問題が原因で、インデックス登録時にエラーが返されます。

複数のクエリ形式を使用してスキーマをテストする

大規模な本番環境データリポジトリ用にスキーマを登録する際には、より小さなテストデータリポジトリでテストすることを検討してください。小さいテストリポジトリでテストすることで、より大きなインデックスや既存の本番環境インデックスに影響を与えることなく、スキーマをすばやく調整したり、インデックス登録済みデータを削除できます。テスト用データリポジトリでは、テストユーザーのみを承認する ACL を作成し、他のユーザーに対してはこのデータが検索結果に表示されないようにできます。

検索クエリを検証するための検索インターフェースを作成する方法については、検索インターフェースをご覧ください。

このセクションでは、映画スキーマをテストするために使用できるいくつかの異なるクエリを例として紹介しています。

一般的なクエリを使用してテストする

一般的なクエリとは、データソース内のアイテムのうち特定の文字列を含むすべてのアイテムを返すものです。たとえば、検索インターフェースで「titanic」という単語を入力して Return キーを押すことによって、映画データソースに対して一般的なクエリを実行できます。「titanic」という単語を含むすべての映画が検索結果として返されるはずです。

演算子を使用してテストする

クエリに演算子を追加すると、その演算子の値に一致するアイテムに結果が制限されます。たとえば、actor 演算子を使用して特定の俳優が出演するすべての映画検索インターフェースを使用するとこの演算子クエリでは、operator=value ペアを入力します。例: 「"actor:Zane"」と入力して "actor:Zane" キーを押します。俳優 Zane が主演するすべての映画が検索結果として返されるはずです。

スキーマを調整する

スキーマとデータの使用が開始された後も、ユーザーに対してうまく機能する部分とそうでない部分を引き続き監視します。次のような状況では、スキーマを調整することを検討してください。

以前にインデックスに登録しなかった項目をインデックスに登録します。たとえば、監督名で映画を検索するユーザーが多い場合は、演算子として監督名をサポートするようにスキーマを調整します。
ユーザーのフィードバックに基づいて検索演算子名を変更します。演算子名はユーザーにとってわかりやすいものでなければなりません。ユーザーが間違った演算子名を覚えたまま直らない場合は、その名前を変更することを検討します。

で確認できます。

スキーマ変更後の再インデックス登録

スキーマ内の次の値を変更しても、データの再インデックス登録が必要になることはありません。新しい UpdateSchema インデックスは引き続き機能します。

演算子名。
整数の最小値と最大値。
整数型と列挙型の順位付け。
更新頻度オプション。
表示オプション。

次の変更を行った場合でも、インデックス登録済みデータは引き続き元の登録済みスキーマに従って動作します。ただし、このような変更を更新後のスキーマに基づいて表示するには、既存のエントリの再インデックス登録が必要になります。

新しいプロパティまたはオブジェクトを追加または削除する。
isReturnable、isFacetable、または isSortable を false から true。

isFacetable または isSortable を true に設定するのは、ユースケースとニーズを明確にします

最後に、プロパティ isSuggestable をマークしてスキーマを更新すると、次のようになります。データのインデックスを再作成する必要があります。その場合、予測入力の使用に遅延が生じます。そのプロパティを選択します。

禁止されているプロパティ変更

スキーマに対する一部の変更は、データの再インデックス登録を行うかどうかに関係なく禁止されています。変更すると、インデックスが破損したり、検索結果の精度や一貫性が失われたりします。該当する変更は次のとおりです。

プロパティのデータ型。
プロパティ名。
exactMatchWithOperator の設定。
retrievalImportance の設定。

ただし、この制限を回避する方法はあります。

複雑なスキーマ変更を行う

検索結果の精度低下や検索インデックスの破損を引き起こす変更を回避するために、Cloud Search では、リポジトリのインデックス登録後に UpdateSchema リクエストによって特定の種類の変更を行うことが禁止されています。たとえば、プロパティのデータ型または名前は、一度設定したら以後変更できなくなります。これらの変更単純な演算では達成できない UpdateSchema データを再作成する必要はありません。

スキーマに対して禁止されている変更をどうしても加える変更がある場合は、通常、許可されている一連の変更を通じて同じ結果を実現できます。そのためには、一般に、最初にインデックス登録済みのプロパティを古いオブジェクト定義から新しいオブジェクト定義に移行してから、新しいプロパティのみを使用するインデックス登録リクエストを送信します。

プロパティのデータ型または名前を変更する手順は次のとおりです。

スキーマのオブジェクト定義に新しいプロパティを追加します。変更対象のプロパティとは異なる名前を使用します。
新しい定義で UpdateSchema リクエストを発行します。リクエストでは、新しいプロパティと古いプロパティの両方を含むスキーマ全体を送信してください。
データリポジトリからインデックスをバックフィルします。インデックスをバックフィルするには、古いプロパティは使用せず、新しいプロパティのみを使用してすべてのインデックス登録リクエストを送信します。そうしないと、クエリに対する一致件数が 2 倍になるためです。
1. インデックスのバックフィル時には、新しいプロパティをチェックし、古いプロパティをデフォルトに設定することで、動作の一貫性が失われないようにします。
2. バックフィルが完了したら、テストクエリを実行して検証します。
古いプロパティを削除します。古いプロパティ名を含まない別の UpdateSchema リクエストを発行し、今後のインデックス登録リクエストでは古いプロパティ名の使用を中止します。
古いプロパティの代わりに新しいプロパティを使用するように移行します。たとえば、プロパティ名を creator から author に変更する場合は、これまで creator を参照していた部分で author を使用するようにクエリコードを更新する必要があります。

Cloud Search は削除されたプロパティまたはオブジェクトの記録を 30 日間保持する再利用することで予期しないインデックス登録結果を防ぐことができます。その 30 日以内に、削除済みの VM から移行する必要があります。将来のインデックスリクエストからの除外などに対する責任を負います。これにより、後でそのプロパティを回復したり、このようにすることで、インデックスの正確性を維持できます。

サイズ制限を把握する

Cloud Search では、構造化データオブジェクトとスキーマのサイズに上限があります。上限は次のとおりです。

最上位のオブジェクトの最大数は 10 個です。
構造化データ階層の最大深度は 10 レベルです。
オブジェクト内の項目の合計数は 1,000 個に制限されています。これは、プリミティブ項目の数に、ネストされた各オブジェクト内の項目数の合計を加えたものです。

次のステップ

必要に応じて次の手順を行います。

スキーマをテストする検索インターフェースを作成します。
検索品質の向上のためにスキーマを調整します。
最適なクエリ解釈のためのスキーマを構築します。
詳しくは、定義する _dictionaryEntry スキーマビジネスで一般的に使用される用語の同義語です。 _dictionaryEntry 詳しくは、このモジュールの類義語を定義する。
コネクタを作成します。