サポートされているデータ型 (Azure AI Search)

Azure AI Search では、式 (フィルターなど) のドキュメント フィールドと値は、エンティティ データ モデルまたは EDM に従って入力されます (詳細については、「 エンティティ データ モデル 」を参照してください)。

注意

インデクサーを使用して Azure AI Search にデータをプルする場合、インデクサーには JSON とSQL Serverデータ ソースに対して異なるデータ型マッピングがあります。 詳細については、「 Azure AI Search のインデクサーのデータ型マップ」を参照してください。

Azure AI 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 AI 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.Single) ベクター フィールドの インデックスの作成または更新 (2023-07-01-Preview) でのみ使用される単精度 IEEE 754 浮動小数点値の一覧。
Collection(Edm.DateTimeOffset) 日付時刻の値の一覧。
Collection(Edm.GeographyPoint) 地理的な場所を表すポイントの一覧。
Collection(Edm.ComplexType) Edm.ComplexTypeのオブジェクトの一覧。 ドキュメント内のすべての種類 Edm.ComplexType のコレクションの要素の最大数には制限があります。 詳細については、「 サービスの制限 」を参照してください。

注意

プリミティブ型と複合型のコレクション (例: Collection(Edm.String)) を除き、上記のすべての型は null 許容です。 NULL 値が許容されるフィールドは、明示的に NULL に設定できます。 これらは、Azure AI Search インデックスにアップロードされたドキュメントから省略すると、自動的に null に設定されます。 コレクション フィールドは、ドキュメントから省略されると、自動的に空 (JSON では '[]' に設定されます。 また、コレクション フィールドに null 値を格納することはできません。

複雑なコレクションとは異なり、プリミティブ型のコレクション内の項目の数に特に上限はありませんが、ペイロード サイズの 16 MB の上限は、コレクションを含むドキュメントのすべての部分に適用されます。

Edm.GeographyPolygon は、地球上の地域を表す多角形です。 この型はドキュメント フィールドでは使用できませんが、関数の引数 geo.intersects として使用できます。 OData の URL のリテラル形式は、 WKT (既知のテキスト) と OGC の単純な機能アクセス標準に基づいています。 多角形のリテラルは、geography'POLYGON((lon lat, lon lat, ...))' という形式で構築します。

Azure での地理空間検索の詳細については、次のビデオを参照してください: Azure AI 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 [開始点].

こちらもご覧ください