サポートされているデータ型 (Azure Cognitive Search)
Azure Cognitive Searchでは、式のドキュメント フィールドと値 (フィルターなど) は、エンティティ データ モデルまたは EDM に従って入力されます (詳細については、「エンティティ データ モデル」を参照してください)。
注意
インデクサーを使用してデータをAzure Cognitive Searchにプルする場合、インデクサーは JSON とSQL Serverデータ ソースに対して異なるデータ型マッピングを使用します。 詳細については、「Azure Cognitive Searchのインデクサーのデータ型マップ」を参照してください。
Azure Cognitive Searchインデックスとドキュメントで使用される EDM データ型
インデックス内のフィールドを定義する場合は、EDM データ型を指定する必要があります。 さまざまな種類のフィールドの JSON 表記の例については、「インデックスの作成の例」を 参照してください。 データ アップロード シナリオに型指定されたコンテンツが含まれている JSON ドキュメントの例については、「 ドキュメントの追加、更新、または削除の例」を参照してください。
| データ型 | 説明 |
|---|---|
| Edm.String | テキスト データ。 |
| Edm.Boolean | true または false の値が含まれます。 |
| Edm.Int32 | 32 ビット整数値です。 |
| Edm.Int64 | 64 ビット整数値です。 |
| Edm.Double | 倍精度 IEEE 754 浮動小数点値。 |
| Edm.DateTimeOffset | OData V4 形式で表される日付と時刻の値: yyyy-MM-ddTHH:mm:ss.fffZ または yyyy-MM-ddTHH:mm:ss.fff[+|-]HH:mm。 フィールドの DateTimeOffset 有効桁数はミリ秒に制限されます。 ミリ秒未満の有効桁数の値をアップロード DateTimeOffset すると、返される値はミリ秒に切り上げられます (たとえば、 2015-04-15T10:30:09.7552052Z は として 2015-04-15T10:30:09.7550000Z返されます)。 タイム ゾーン情報を含む値をインデックスにアップロードDateTimeOffsetすると、これらの値Azure Cognitive Search UTC に正規化されます。 たとえば、 2017-01-13T14:03:00-08:00 は として 2017-01-13T22:03:00Z格納されます。 タイム ゾーン情報を格納する必要がある場合は、インデックスにフィールドを追加する必要があります。 |
| Edm.GeographyPoint | 地球上の地理的な場所を表すポイントです。 要求と応答の本文の場合、この型の値の表記は、GeoJSON の "Point" 型の形式に従います。 URL の場合、OData は WKT 標準に基づくリテラル形式を使用します。 点のリテラルは、geography'POINT(lon lat)' という形式で構築します。 |
| Edm.ComplexType | プロパティが、サポートされている他の任意のデータ型のサブフィールドにマップされるオブジェクト。 これにより、JSON などの構造化階層データのインデックス作成が可能になります。 型 Edm.ComplexType のフィールド内のオブジェクトには入れ子になったオブジェクトを含めることができますが、入れ子のレベルは制限されています。 制限については、「 サービスの制限」を参照してください。 |
| Collection(Edm.String) | 文字列の一覧。 |
| Collection(Edm.Boolean) | ブール値の一覧。 |
| Collection(Edm.Int32) | 32 ビット整数値の一覧。 |
| Collection(Edm.Int64) | 64 ビット整数値の一覧。 |
| Collection(Edm.Double) | 倍精度数値の一覧。 |
| Collection(Edm.DateTimeOffset) | 日付と時刻の値の一覧。 |
| Collection(Edm.GeographyPoint) | 地理的な場所を表すポイントの一覧。 |
| Collection(Edm.ComplexType) | 型 Edm.ComplexTypeのオブジェクトの一覧。 ドキュメント内のすべての型 Edm.ComplexType のコレクションの要素の最大数には制限があります。 詳細については、「 サービスの制限 」を参照してください。 |
Note
プリミティブ型と複合型のコレクション (例: Collection(Edm.String)) を除き、上記のすべての型は null 許容です。 NULL 値が許容されるフィールドは、明示的に NULL に設定できます。 Azure Cognitive Searchインデックスにアップロードされたドキュメントから省略すると、自動的に null に設定されます。 コレクション フィールドは、ドキュメントから省略すると、自動的に空 (JSON では '[]' に設定されます。 また、コレクション フィールドに null 値を格納することはできません。
複雑なコレクションとは異なり、プリミティブ型のコレクション内の項目の数に特に上限はありませんが、ペイロード サイズの 16 MB の上限は、コレクションを含むドキュメントのすべての部分に適用されます。
Azure Cognitive Searchで使用されるその他の EDM 構造体
Edm.GeographyPolygon は、地球上の地域を表す多角形です。 この型はドキュメント フィールドで使用できませんが、geo.intersects 関数の引数として使用できます。 OData の URL のリテラル 形式は、 WKT (既知のテキスト) と OGC の単純な機能アクセス標準に基づいています。 多角形のリテラルは、geography'POLYGON((lon lat, lon lat, ...))' という形式で構築します。
Azure での地理空間検索の詳細については、次のビデオを参照してください: Azure Cognitive Searchと地理空間データ
重要
多角形内のポイントは、反時計回りの順序である 必要があります 。 多角形内のポイントは、多角形の内側を基準にして、反時計回りの順序で解釈されます。 たとえば、ロンドン周辺の 4 ポイント閉じたポリゴンは、-0.3°W 51.6°N [左上] 、-0.3°W 51.4°N [左下]、 0.1°E 51.4°N [右下],0.1°E 51.6°N [右上], -0.3°W 51.6°N [開始点].