Google Cloud Search スキーマは、データのインデックス登録とクエリに使用するオブジェクト、プロパティ、オプションを定義する JSON 構造です。コンテンツ コネクタはリポジトリからデータを読み取り、登録されたスキーマに基づいてデータを構造化してインデックスに登録します。
スキーマを作成するには、JSON スキーマ オブジェクトを API に提供してから登録します。データをインデックスに登録するには、事前に各リポジトリにスキーマ オブジェクトを登録する必要があります。
このドキュメントでは、スキーマ作成の基礎について説明します。検索エクスペリエンスを向上させるためにスキーマを調整する方法については、検索品質の向上をご覧ください。
スキーマを作成する
Cloud Search スキーマを作成するには、次の手順に従います。
予想されるユーザーの行動を特定する
ユーザーが実行するクエリの種類を予測することは、スキーマの作成戦略につながります。
たとえば、映画のデータベースに対してクエリを発行する場合、ユーザーが「ロバート レッドフォード主演の映画をすべて表示」といったクエリを行うことを想定できます。そのため、スキーマは「特定の俳優が出演するすべての映画」に基づくクエリ結果をサポートする必要があります。
ユーザーの行動パターンを反映するようにスキーマを定義するには、次のタスクを実行することを検討してください。
- さまざまなユーザーから要求される多様なクエリを評価します。
- クエリで使用される可能性があるオブジェクトを特定します。オブジェクトとは、映画データベース内の映画のような、関連データの論理的集合です。
- オブジェクトを構成し、クエリで使用される可能性があるプロパティと値を特定します。プロパティは、オブジェクトのインデックス登録可能な属性であり、プリミティブ値やその他のオブジェクトを含めることができます。たとえば、映画オブジェクトの場合、映画のタイトルや公開日などのプロパティをプリミティブ値として使用できます。また、出演者のように、名前や役柄などの固有のプロパティを持つ他のオブジェクトを含めることもできます。
- プロパティの有効な値のサンプルを見つけます。値とは、プロパティに対してインデックス登録される実際のデータのことです。たとえば、データベースには「レイダース / 失われたアーク《聖櫃》」というタイトルの映画が含まれているかもしれません。
- ユーザーが希望する並べ替えとランキングのオプションを決定します。たとえば、映画のクエリでは、タイトルでアルファベット順に並べ替えるよりも、年代順に並べ替えて視聴者の評価でランク付けするほうがよい場合があります。
- （省略可）あるプロパティの 1 つが、ユーザーの役職や部門など、検索が実行される可能性のある具体的なコンテキストを表している場合は、そのコンテキストに基づいてオートコンプリートの候補を表示できます。たとえば、映画のデータベースを検索するユーザーの場合、特定のジャンルの映画にのみ関心がある可能性があります。ユーザーは、必要に応じてユーザー プロフィールの一部として、検索結果を返したいジャンルを定義します。ユーザーが映画のクエリを入力し始めると、好みのジャンルの映画（「アクション映画」など）のみがオートコンプリートの候補の一部として提案されます。
- 検索に使用される可能性があるオブジェクト、プロパティ、サンプル値のリストを作成します（このリストの使用方法の詳細については、演算子オプションを定義するをご覧ください）。
データソースを初期化する
データソースとは、Google Cloud にインデックス登録されて格納されているリポジトリのデータを表します。データソースを初期化する手順については、サードパーティのデータソースを管理するをご覧ください。
ユーザーの検索結果はデータソースから返されます。ユーザーが検索結果をクリックすると、インデックス登録リクエストで指定された URL を使用して実際のアイテムに誘導されます。
オブジェクトを定義する
スキーマ内のデータの基本単位はオブジェクトです。これはデータの論理構造で、「スキーマ オブジェクト」とも呼ばれます。映画のデータベースでは、データの論理構造の 1 つが「movie」です。また、映画に関わっているキャストやスタッフを表す「人」などもオブジェクトになります。
スキーマ内の個々のオブジェクトに、映画のタイトルや上映時間、人物の名前や生年月日など、そのオブジェクトを構成する一連のプロパティ（属性）があります。オブジェクトのプロパティには、プリミティブ値や他のオブジェクトを含めることができます。
図 1 は、映画オブジェクトと人物オブジェクトおよびそれぞれに関連するプロパティを示しています。
Cloud Search スキーマは、基本的に objectDefinitions タグ内で定義されたオブジェクト定義ステートメントのリストです。次のスキーマ スニペットは、movie スキーマ オブジェクトと person スキーマ オブジェクトの objectDefinitions ステートメントを示しています。
{
"objectDefinitions": [
{
"name": "movie",
...
},
{
"name": "person",
...
}
]
}
スキーマ オブジェクトを定義する際には、スキーマ内の他のすべてのオブジェクトの中で一意である必要があるオブジェクトの name を指定します。通常は、オブジェクトを表す name 値を使用します（映画オブジェクトの場合は movie など）。スキーマ サービスは、name フィールドをインデックス登録可能なオブジェクトのキー識別子として使用します。name フィールドの詳細については、オブジェクトの定義をご覧ください。
オブジェクトのプロパティを定義する
ObjectDefinition のリファレンスに記載されているように、オブジェクト名の後に、options のセットと propertyDefinitions のリストが続きます。options は、さらに freshnessOptions と displayOptions で構成することもできます。freshnessOptions は、アイテムの鮮度に基づいて検索ランキングを調整するために使用されます。displayOptions は、オブジェクトの検索結果に特定のラベルとプロパティを表示するかどうかを定義するために使用します。
propertyDefinitions セクションでは、映画のタイトルや公開日などのオブジェクトのプロパティを定義します。
次のスニペットは、movieTitle と releaseDate の 2 つのプロパティを持つ movie オブジェクトを示しています。
{
"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 回定義されています。1 回目は movie オブジェクトで、2 回目は person オブジェクトの filmography サブオブジェクトで定義されています。このスキーマでは movieTitle フィールドを再利用しているため、スキーマは次の 2 種類の検索動作をサポートできます。
- ユーザーが映画のタイトルを検索した場合、映画の結果を表示します。
- ユーザーが映画のタイトルで特定の出演俳優を検索した場合、人物の結果を表示します。
同様に、スキーマでは releaseDate フィールドを再利用しています。これは、2 つの movieTitle フィールドの意味が同じであるためです。
独自のスキーマを開発する際には、スキーマで複数回宣言するデータを含む関連項目がリポジトリ内でどのように定義されているかを考慮してください。
型に依存しないオプションを追加する
PropertyDefinition には、データ型に関係なく、すべてのプロパティに共通する一般的な検索機能オプションをリストします。
isReturnable- Query API を介して検索結果で返す必要があるデータをプロパティが識別するかどうかを示します。サンプルの映画プロパティはすべて返されます。逆に、ユーザーに返さないプロパティは、結果を検索したり、ランク付けしたりするために使用できます。isRepeatable- プロパティで複数の値が許可されているかどうかを示します。たとえば、映画の公開日は 1 つしかありませんが、俳優は複数人いることが考えられます。isSortable- プロパティを並べ替えに使用できることを示します。繰り返し可能なプロパティに対しては true に設定することはできません。たとえば、映画の結果は、公開日または視聴率によって並べ替えることができます。isFacetable- プロパティをファセットの生成に使用できることを示します。ファセットは検索結果を絞り込むために使用されます。ユーザーは最初の結果を表示してから、条件（ファセット）を追加して結果をさらに絞り込みます。タイプがオブジェクト型のプロパティの場合、このオプションは true にできません。このオプションを設定するには、isReturnableが true である必要があります。最後に、このオプションは列挙型、ブール値、テキストのプロパティでのみサポートされます。たとえば、サンプル スキーマでは、genre、actorName、userRating、mpaaRatingをファセットとして使用できるようにして、検索結果のインタラクティブな絞り込みで使用できるようにします。isWildcardSearchableは、ユーザーがこのプロパティにワイルドカード検索を行えることを示します。このオプションはテキスト プロパティでのみ使用できます。テキスト フィールドに対するワイルドカード検索の仕組みは、exactMatchWithOperator フィールドに設定されている値によって異なります。exactMatchWithOperatorがtrueに設定されている場合、テキスト値は 1 つのアトミック値としてトークン化され、ワイルドカード検索が行われます。たとえば、テキスト値がscience-fictionの場合、ワイルドカード クエリscience-*と一致します。exactMatchWithOperatorがfalseに設定されている場合、テキスト値がトークン化され、各トークンに対してワイルドカード検索が実行されます。たとえば、テキスト値が「science-フィクション」の場合、ワイルドカード クエリsci*またはfi*はアイテムに一致しますが、science-*はアイテムに一致しません。
これらの一般的な検索機能のパラメータはすべてブール値です。デフォルト値はすべて false であり、使用するには true に設定する必要があります。
次の表に、movie オブジェクトのすべてのプロパティについて true に設定されたブール値パラメータを示します。
| プロパティ | 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 が特定の型（boolean など）である xxPropertyOptions がいくつかリストされています。プロパティのデータ型を設定するには、適切なデータ型オブジェクトを定義する必要があります。プロパティのデータ型オブジェクトを定義すると、そのプロパティのデータ型が設定されます。たとえば、movieTitle プロパティに textPropertyOptions を定義すると、映画のタイトルがテキスト型であることを示します。次のスニペットは、textPropertyOptions でデータ型を設定している movieTitle プロパティを示しています。
{
"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 リファレンス セクションは、各型のオプションにリンクしています。enumPropertyOptions 内の possibleValues のリストを除き、タイプ固有のオプションのほとんどはオプションです。また、orderedRanking オプションを使用すると、値を相互に比較してランク付けできます。次のスニペットは、textPropertyOptions でデータ型を設定し、retrievalImportance 型固有のオプションが設定された movieTitle プロパティを示しています。
{
"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 セットがあります。これらのオプションでは、プロパティを検索演算子として使用する方法を記述します。次のスニペットは、textPropertyOptions がデータ型を設定し、retrievalImportance と operatorOptions の型固有のオプションが設定された movieTitle プロパティを示しています。
{
"name": "movieTitle",
"isReturnable": true,
"isWildcardSearchable": true,
"textPropertyOptions": {
"retrievalImportance": { "importance": "HIGHEST" },
"operatorOptions": {
"operatorName": "title"
}
},
...
}
すべての operatorOptions には operatorName があります（movieTitle の title など）。演算子名はプロパティの検索演算子です。検索演算子は、ユーザーが検索の絞り込みに使用すると予想される実際のパラメータです。たとえば、タイトルに基づいて映画を検索するには、「title:movieName」と入力します。ここで、movieName は映画の名前です。
演算子名をプロパティ名と同じにすることはできません。代わりに、演算子名には、組織内のユーザーが使用する最も一般的な単語を反映する必要があります。たとえば、ユーザーが映画のタイトルを表す用語として「title」ではなく「name」の使用を好む場合は、演算子名を「name」に設定する必要があります。
すべてのプロパティが同じ型に解決される場合に限り、複数のプロパティに対して同じ演算子名を使用できます。クエリの実行時に共有演算子名を使用した場合、その演算子名を使用するすべてのプロパティが取得されます。たとえば、映画オブジェクトに plotSummary プロパティと plotSynopsis プロパティがあり、これらの各プロパティの operatorName が plot であるとします。これらのプロパティが両方ともテキスト（textPropertyOptions）であれば、1 つのクエリで plot 検索演算子を使用して両方を取得できます。
並べ替え可能なプロパティについては、operatorName に加えて、operatorOptions に lessThanOperatorName フィールドと greaterThanOperatorName フィールドを指定できます。これらのオプションを使用すると、送信された値との比較に基づくクエリを作成できます。
最後に、textOperatorOptions の operatorOptions には exactMatchWithOperator フィールドがあります。exactMatchWithOperator を true に設定する場合、クエリ文字列はプロパティ値全体と一致する必要があります。テキスト内にのみ一致するものは使用できません。テキスト値は、演算子検索とファセット一致で 1 つのアトミック値として扱われます。
たとえば、genre プロパティを使用して Book オブジェクトや Movie オブジェクトのインデックスを作成することを検討します。ジャンルには、「科学」、「科学」、「フィクション」などがあります。exactMatchWithOperator を false に設定するか省略した場合、ジャンルを検索するか、「Science」または「Fiction」ファセットを選択すると、「Science-Fiction」という結果も返されます。これは、テキストがトークン化され、「Science-Fiction」に「Science」トークンと「Fiction」トークンが存在するためです。exactMatchWithOperator が true の場合、テキストは単一のトークンとして扱われるため、「Science」も「Fiction」も「Science-Fiction」と一致しません。
（省略可）displayOptions セクションを追加する
propertyDefinition セクションの最後には、必要に応じて displayOptions セクションがあります。このセクションには 1 つの displayLabel 文字列が含まれます。displayLabel は、プロパティに推奨されるユーザー フレンドリーなテキストラベルです。ObjectDisplayOptions を使用してプロパティを表示するように構成されている場合、このラベルはプロパティの前に表示されます。プロパティが表示するように構成されていて、displayLabel が定義されていない場合は、プロパティ値のみが表示されます。
次のスニペットは、displayLabel が「Title」に設定された 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[] セクションを追加する
propertyDefinition セクションの末尾にオプションの suggestionFilteringOperators[] セクションがあります。このセクションを使用して、オートコンプリートの候補のフィルタリングに使用するプロパティを定義します。たとえば、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 はスキーマに定義されていないため、これらのプロパティのいずれかに対してクエリを実行することはできません（例:year など）を個別に管理する必要があります。
また、繰り返し可能なプロパティ actorName が値のリストを使用してどのようにインデックスに登録されるかにも注目してください。
インデックス登録における潜在的な問題を特定する
スキーマとインデックス登録に関する最も一般的な問題として、次の 2 つがあります。
スキーマ サービスに登録されていないスキーマ オブジェクト名またはプロパティ名がインデックス登録リクエストに含まれている。この問題が原因で、プロパティまたはオブジェクトが無視されます。
スキーマに登録されている型と異なる型を持つプロパティがインデックス登録リクエストに含まれている。この問題が原因で、インデックス登録時にエラーが返されます。
複数のクエリ形式を使用してスキーマをテストする
大規模な本番環境データ リポジトリ用にスキーマを登録する際には、より小さなテストデータ リポジトリでテストすることを検討してください。小さいテスト リポジトリでテストすることで、より大きなインデックスや既存の本番環境インデックスに影響を与えることなく、スキーマをすばやく調整したり、インデックス登録済みデータを削除できます。テスト用データ リポジトリでは、テストユーザーのみを承認する ACL を作成し、他のユーザーに対してはこのデータが検索結果に表示されないようにできます。
検索クエリを検証するための検索インターフェースを作成する方法については、検索インターフェースをご覧ください。
このセクションでは、映画スキーマをテストするために使用できるいくつかの異なるクエリを例として紹介しています。
一般的なクエリを使用してテストする
一般的なクエリとは、データソース内のアイテムのうち特定の文字列を含むすべてのアイテムを返すものです。たとえば、検索インターフェースで「titanic」という単語を入力して Return キーを押すことによって、映画データソースに対して一般的なクエリを実行できます。「titanic」という単語を含むすべての映画が検索結果として返されるはずです。
演算子を使用してテストする
クエリに演算子を追加すると、その演算子の値に一致するアイテムに結果が制限されます。たとえば、actor 演算子を使用して、特定の俳優が主演するすべての映画を検索できます。検索インターフェースを使用すると、operator=value のペア（"actor:Zane" など）を入力して、Return キーを押すだけで、この演算子クエリを実行できます。俳優 Zane が主演するすべての映画が検索結果として返されるはずです。
スキーマを調整する
スキーマとデータの使用が開始された後も、ユーザーに対してうまく機能する部分とそうでない部分を引き続き監視します。次のような状況では、スキーマを調整することを検討してください。
- 以前にインデックスに登録しなかった項目をインデックスに登録します。たとえば、監督名で映画を検索するユーザーが多い場合は、演算子として監督名をサポートするようにスキーマを調整します。
- ユーザーのフィードバックに基づいて検索演算子名を変更します。演算子名はユーザーにとってわかりやすいものでなければなりません。ユーザーが間違った演算子名を覚えたまま直らない場合は、その名前を変更することを検討します。
スキーマ変更後の再インデックス登録
スキーマ内の次の値を変更しても、データの再インデックス登録が必要になることはありません。新しい UpdateSchema リクエストを送信するだけで、インデックスは引き続き機能します。
- 演算子名。
- 整数の最小値と最大値。
- 整数型と列挙型の順位付け。
- 更新頻度オプション。
- 表示オプション。
次の変更を行った場合でも、インデックス登録済みデータは引き続き元の登録済みスキーマに従って動作します。ただし、このような変更を更新後のスキーマに基づいて表示するには、既存のエントリの再インデックス登録が必要になります。
- 新しいプロパティまたはオブジェクトを追加または削除する。
isReturnable、isFacetable、またはisSortableをfalseからtrueに変更する。
明確なユースケースとニーズがある場合にのみ、isFacetable または isSortable を true に設定してください。
最後に、プロパティに isSuggestable をマークしてスキーマを更新すると、データの再インデックス登録が必要になります。これにより、そのプロパティでのオートコンプリートの使用で遅延が発生します。
禁止されているプロパティ変更
スキーマに対する一部の変更は、データの再インデックス登録を行うかどうかに関係なく禁止されています。変更すると、インデックスが破損したり、検索結果の精度や一貫性が失われたりします。該当する変更は次のとおりです。
- プロパティのデータ型。
- プロパティ名。
exactMatchWithOperatorの設定。retrievalImportanceの設定。
ただし、この制限を回避する方法はあります。
複雑なスキーマ変更を行う
検索結果の精度低下や検索インデックスの破損を引き起こす変更を回避するために、Cloud Search では、リポジトリのインデックス登録後に UpdateSchema リクエストによって特定の種類の変更を行うことが禁止されています。たとえば、プロパティのデータ型または名前は、一度設定したら以後変更できなくなります。これらの変更は、データのインデックスに再登録しても、単純な UpdateSchema リクエストでは実現できません。
スキーマに対して禁止されている変更をどうしても加える変更がある場合は、通常、許可されている一連の変更を通じて同じ結果を実現できます。そのためには、一般に、最初にインデックス登録済みのプロパティを古いオブジェクト定義から新しいオブジェクト定義に移行してから、新しいプロパティのみを使用するインデックス登録リクエストを送信します。
プロパティのデータ型または名前を変更する手順は次のとおりです。
- スキーマのオブジェクト定義に新しいプロパティを追加します。変更対象のプロパティとは異なる名前を使用します。
- 新しい定義で UpdateSchema リクエストを発行します。リクエストでは、新しいプロパティと古いプロパティの両方を含むスキーマ全体を送信してください。
データ リポジトリからインデックスをバックフィルします。インデックスをバックフィルするには、古いプロパティは使用せず、新しいプロパティのみを使用してすべてのインデックス登録リクエストを送信します。そうしないと、クエリに対する一致件数が 2 倍になるためです。
- インデックスのバックフィル時には、新しいプロパティをチェックし、古いプロパティをデフォルトに設定することで、動作の一貫性が失われないようにします。
- バックフィルが完了したら、テストクエリを実行して検証します。
古いプロパティを削除します。古いプロパティ名を含まない別の UpdateSchema リクエストを発行し、今後のインデックス登録リクエストでは古いプロパティ名の使用を中止します。
古いプロパティの代わりに新しいプロパティを使用するように移行します。たとえば、プロパティ名を creator から author に変更する場合は、これまで creator を参照していた部分で author を使用するようにクエリコードを更新する必要があります。
Cloud Search では、予期しないインデックス登録結果の原因となる再利用を防ぐため、削除されたプロパティまたはオブジェクトの記録が 30 日間保持されます。その 30 日以内に、今後のインデックス リクエストから除外するなど、削除されたオブジェクトまたはプロパティの使用から移行する必要があります。これにより、後でそのプロパティまたはオブジェクトを元に戻すことが決まった場合でも、インデックスの正確性を維持できる方法で復元できます。
サイズ制限を把握する
Cloud Search では、構造化データ オブジェクトとスキーマのサイズに上限があります。これらの上限は次のとおりです。
- 最上位のオブジェクトの最大数は 10 個です。
- 構造化データ階層の最大深度は 10 レベルです。
- オブジェクト内の項目の合計数は 1,000 個に制限されています。これは、プリミティブ項目の数に、ネストされた各オブジェクト内の項目数の合計を加えたものです。
次のステップ
必要に応じて次の手順を行います。
スキーマをテストする検索インターフェースを作成します。
検索品質の向上のためにスキーマを調整します。
_dictionaryEntryスキーマを利用して、会社でよく使用される用語の類義語を定義する方法を学習します。_dictionaryEntryスキーマを使用するには、類義語を定義するをご覧ください。コネクタを作成します。