Google Cloud Search スキーマは、構造化データを定義する データのインデックス登録やクエリに使用するオブジェクト、プロパティ、オプションが含まれます。 コンテンツ コネクタはリポジトリからデータを読み取り、 データが構造化され、インデックスに登録されます。
スキーマを作成するには、JSON スキーマ オブジェクトを API に提供してから登録します。データをインデックスに登録するには、事前に各リポジトリにスキーマ オブジェクトを登録する必要があります。
このドキュメントでは、スキーマ作成の基礎について説明します。検索エクスペリエンスを向上させるためにスキーマを調整する方法については、検索品質の向上をご覧ください。
スキーマを作成する
Cloud Search スキーマを作成するには、次の手順に従います。
で確認できます。予想されるユーザーの行動を特定する
ユーザーが実行するクエリの種類を予測することは、スキーマの作成戦略につながります。
たとえば、ユーザーが映画のデータベースに対してクエリを発行する場合、「Robert Redford が主演するすべての映画を表示する」などのクエリが予測されます。したがって、スキーマでは、「特定の俳優が出演するすべての映画」に基づくクエリ結果をサポートする必要があります。
ユーザーの行動パターンを反映するようにスキーマを定義するには、次のタスクを実行することを検討してください。
- さまざまなユーザーから要求される多様なクエリを評価します。
- クエリで使用される可能性があるオブジェクトを特定します。オブジェクトとは、映画データベース内の映画のような、関連データの論理的集合です。
- オブジェクトの構成要素であるプロパティと値 使用できます。 プロパティは、オブジェクトのインデックス登録可能な属性です。 プリミティブ値または他のオブジェクトを含めることができます。 たとえば、movie オブジェクトには、映画のタイトルや プリミティブ値として設定できます。また、出演者のように、名前や役柄などの固有のプロパティを持つ他のオブジェクトを含めることもできます。
- プロパティの有効な値のサンプルを見つけます。値とは、プロパティに対してインデックス登録される実際のデータのことです。たとえば、データベースには「レイダース / 失われたアーク《聖櫃》」というタイトルの映画が含まれているかもしれません。
- ユーザーが希望する並べ替えとランキングのオプションを決定します。たとえば、映画のクエリでは、タイトルでアルファベット順に並べ替えるよりも、年代順に並べ替えて視聴者の評価でランク付けするほうがよい場合があります。
- (省略可)より具体的な 検索が行われる可能性があるコンテキスト(たとえば、ユーザーの職務または 基づいて予測入力の候補を表示させることができます。 説明します。たとえば、映画のデータベースを検索しているユーザーの場合、 特定のジャンルの映画だけに 興味を抱くユーザーですユーザーは何を 特定のジャンル(おそらくユーザーの一部として検索してもらいたいジャンル) 選択します。ユーザーが映画のクエリを開始すると 好きなジャンルの映画(例: 「アクション映画」、として提案されます。 予測入力の候補の一部分に 移動することもできます
- 検索に使用される可能性があるオブジェクト、プロパティ、サンプル値のリストを作成します(このリストの使用方法の詳細については、 演算子オプションを定義するをご覧ください)。
データソースを初期化する
データソースとは、Google Cloud にインデックス登録されて格納されているリポジトリのデータを表します。データソースを初期化する手順については 参照 サードパーティのデータソースを管理します。
ユーザーの検索結果はデータソースから返されます。ユーザーが検索結果をクリックすると、インデックス登録リクエストで指定された URL を使用して実際のアイテムに誘導されます。
オブジェクトを定義する
スキーマ内のデータの基本単位はオブジェクトです。これはデータの論理構造で、「スキーマ オブジェクト」とも呼ばれます。映画のデータベースでは、1 つの データの論理構造は「movie」です。別のオブジェクトとして "person"から 映画に登場するキャストやクルーを表現します。
スキーマ内の個々のオブジェクトに、映画のタイトルや上映時間、人物の名前や生年月日など、そのオブジェクトを構成する一連のプロパティ(属性)があります。オブジェクトのプロパティには、プリミティブ値や他のオブジェクトを含めることができます。
図 1 は、映画オブジェクトと人物オブジェクトおよびそれぞれに関連するプロパティを示しています。
![エンティティ間のスキーマ接続の描画](https://developers-dot-devsite-v2-prod.appspot.com/static/cloud-search/images/schemaExample.png?authuser=6&hl=ja)
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"
}
},
...
}
すべての 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 倍になるためです。
- インデックスのバックフィル時には、新しいプロパティをチェックし、古いプロパティをデフォルトに設定することで、動作の一貫性が失われないようにします。
- バックフィルが完了したら、テストクエリを実行して検証します。
古いプロパティを削除します。古いプロパティ名を含まない別の UpdateSchema リクエストを発行し、今後のインデックス登録リクエストでは古いプロパティ名の使用を中止します。
古いプロパティの代わりに新しいプロパティを使用するように移行します。たとえば、プロパティ名を creator から author に変更する場合は、これまで creator を参照していた部分で author を使用するようにクエリコードを更新する必要があります。
Cloud Search は削除されたプロパティまたはオブジェクトの記録を 30 日間保持する 再利用することで予期しないインデックス登録結果を防ぐことができます。 その 30 日以内に、削除済みの VM から移行する必要があります。 将来のインデックス リクエストからの除外などに対する責任を負います。 これにより、後でそのプロパティを回復したり、 このようにすることで、インデックスの正確性を維持できます。
サイズ制限を把握する
Cloud Search では、構造化データ オブジェクトとスキーマのサイズに上限があります。 上限は次のとおりです。
- 最上位のオブジェクトの最大数は 10 個です。
- 構造化データ階層の最大深度は 10 レベルです。
- オブジェクト内の項目の合計数は 1,000 個に制限されています。これは、プリミティブ項目の数に、ネストされた各オブジェクト内の項目数の合計を加えたものです。
次のステップ
必要に応じて次の手順を行います。
スキーマをテストする検索インターフェースを作成します。
検索品質の向上のためにスキーマを調整します。
詳しくは、 定義する
_dictionaryEntry
スキーマ ビジネスで一般的に使用される用語の同義語です。_dictionaryEntry
詳しくは、このモジュールの 類義語を定義する。コネクタを作成します。