Jenis data yang didukung (Azure AI Search)

Di Pencarian Azure AI, bidang dokumen dan nilai dalam ekspresi (misalnya, dalam filter) ditik sesuai dengan Model Data Entitas, atau EDM (lihat Model Data Entitas untuk detailnya).

Catatan

Jika Anda menggunakan pengindeks untuk menarik data ke Azure AI Search, pengindeks memiliki pemetaan jenis data yang berbeda untuk sumber data JSON dan SQL Server. Untuk informasi selengkapnya, lihat Peta jenis data untuk pengindeks di Azure AI Search.

Jenis data EDM yang digunakan dalam indeks dan dokumen Pencarian Azure AI

Menentukan jenis data EDM diperlukan saat menentukan bidang dalam indeks. Anda dapat menemukan contoh representasi JSON untuk bidang dari berbagai jenis dalam Contoh Buat Indeks. Untuk contoh dokumen JSON yang berisi konten yang ditik dalam skenario pengunggahan data, lihat contoh Tambahkan, Perbarui, atau Hapus Dokumen.

Jenis data Deskripsi
Edm.String Data teks.
Edm.Boolean Berisi nilai true/false.
Edm.Int32 Nilai bilangan bulat 32-bit.
Edm.Int64 Nilai bilangan bulat 64-bit.
Edm.Double Nilai titik mengambang IEEE 754 presisi ganda.
Edm.DateTimeOffset Nilai tanggal dan waktu yang diwakili dalam format OData V4: yyyy-MM-ddTHH:mm:ss.fffZ atau yyyy-MM-ddTHH:mm:ss.fff[+|-]HH:mm. Presisi DateTimeOffset bidang terbatas pada milidetik. Jika Anda mengunggah DateTimeOffset nilai dengan presisi submillisecond, nilai yang dikembalikan dibulatkan ke atas hingga milidetik (misalnya, 2015-04-15T10:30:09.7552052Z dikembalikan sebagai 2015-04-15T10:30:09.7550000Z). Saat Anda mengunggah DateTimeOffset nilai dengan informasi zona waktu ke indeks Anda, Azure AI Search menormalkan nilai-nilai ini ke UTC. Misalnya, 2017-01-13T14:03:00-08:00 disimpan sebagai 2017-01-13T22:03:00Z. Jika Anda perlu menyimpan informasi zona waktu, tambahkan bidang tambahan ke indeks Anda.
Edm.GeographyPoint Titik yang mewakili lokasi geografis di dunia. Untuk badan permintaan dan respons, representasi nilai jenis ini mengikuti format jenis GeoJSON "Titik". Untuk URL, OData menggunakan formulir harfiah berdasarkan standar WKT. Harfiah titik dibangun sebagai geografi'POINT(lon lat)'.
Edm.ComplexType Objek yang propertinya memetakan ke subbidang yang dapat berupa jenis data lain yang didukung. Jenis ini memungkinkan pengindeksan data hierarkis terstruktur seperti JSON. Objek dalam bidang jenis Edm.ComplexType dapat berisi objek berlapis, tetapi tingkat bersarang terbatas. Batas dijelaskan dalam Batas layanan.
Collection(Edm.String) Daftar string.
Collection(Edm.Boolean) Daftar nilai boolean.
Collection(Edm.Int32) Daftar nilai bilangan bulat 32-bit.
Collection(Edm.Int64) Daftar nilai bilangan bulat 64-bit.
Collection(Edm.Double) Daftar nilai numerik presisi ganda.
Collection(Edm.Single) Daftar nilai floating-point IEEE 754 presisi tunggal, digunakan secara eksklusif dalam Buat atau Perbarui Indeks (2023-07-01-Preview) untuk bidang vektor.
Collection(Edm.DateTimeOffset) Daftar nilai waktu tanggal.
Collection(Edm.GeographyPoint) Daftar titik yang mewakili lokasi geografis.
Collection(Edm.ComplexType) Daftar objek jenis Edm.ComplexType. Ada batasan jumlah maksimum elemen di semua koleksi jenis Edm.ComplexType dalam dokumen. Lihat Batas layanan untuk detailnya.

Catatan

Semua jenis di atas dapat diubah ke null, kecuali untuk koleksi jenis primitif dan kompleks, misalnya, Collection(Edm.String). Bidang yang dapat diubah ke null dapat diatur secara eksplisit ke null. Mereka secara otomatis diatur ke null saat dihilangkan dari dokumen yang diunggah ke indeks Azure AI Search. Bidang koleksi secara otomatis diatur ke kosong ('[]' di JSON) saat dihilangkan dari dokumen. Selain itu, tidak dimungkinkan untuk menyimpan nilai null di bidang koleksi.

Tidak seperti koleksi kompleks, tidak ada batas atas khusus pada jumlah item dalam kumpulan jenis primitif, tetapi batas atas 16 MB pada ukuran payload berlaku untuk semua bagian dokumen, termasuk koleksi.

Edm.GeographyPolygon adalah poligon yang mewakili wilayah geografis di dunia. Meskipun jenis ini tidak dapat digunakan dalam bidang dokumen, jenis ini dapat digunakan sebagai argumen untuk geo.intersects fungsi. Bentuk harfiah untuk URL di OData didasarkan pada WKT (Teks terkenal) dan standar akses fitur sederhana OGC. Literal poligon dibangun sebagai GEOGRAPHY'POLYGON((lon lat, lon lat, ...))'.

Untuk mempelajari selengkapnya tentang pencarian geospasial di Azure, lihat video ini: Pencarian Azure AI dan Data Geospasial

Penting

Titik dalam poligon harus dalam urutan berlawanan arah jajaran. Titik-titik dalam poligon ditafsirkan dalam urutan berlawanan arah jakal, relatif terhadap bagian dalam poligon. Misalnya, poligon tertutup 4 titik di sekitar London adalah -0,3°W 51,6°N [kiri atas] , -0,3°W 51,4°N [kiri bawah], 0,1°E 51,4°N [kanan bawah], 0,1°E 51,6°N [kanan atas], -0,3°W 51,6°N [titik awal].

Lihat juga