All Products
Search
Document Center

OpenSearch:Impor data menggunakan API atau SDK

Last Updated:Apr 02, 2026

Gunakan API atau SDK untuk mengimpor data ke dalam aplikasi OpenSearch Anda guna beban kerja produksi yang memerlukan volume tinggi atau otomatisasi. Konsol OpenSearch mendukung unggahan file hingga 2 MB per unggahan—cukup untuk pengujian pencarian, tetapi tidak praktis bila Anda perlu mengimpor ribuan catatan atau menjalankan pipeline terjadwal. Untuk batasan impor melalui API dan SDK, lihat Limits.

Pemetaan tipe bidang

Petakan tipe data sumber Anda ke tipe bidang OpenSearch yang sesuai sebelum mengimpor data melalui API atau SDK.

Tipe bidang OpenSearchTipe data API
INTint, long
INT_ARRAYint[], long[]
FLOATfloat
FLOAT_ARRAYfloat[]
DOUBLEdouble
DOUBLE_ARRAYdouble[]
LITERALstring
LITERAL_ARRAYstring[]
SHORT_TEXTstring
TEXTstring
TIMESTAMPlong
GEO_POINTstring, dalam format lon lat. Baik lon maupun lat harus bertipe DOUBLE, dipisahkan oleh spasi. Nilai lon berkisar antara -180 hingga 180; nilai lat berkisar antara -90 hingga 90.

Batasan dan persyaratan format data

Plugin sumber data tidak didukung. Gabungkan dan proses data Anda sebelum mengimpornya ke aplikasi OpenSearch.

Kirim data bertipe ARRAY sebagai array, bukan string. Contoh Java berikut menunjukkan format yang benar untuk bidang bertipe LITERAL_ARRAY:

// Buat objek Map bernama doc2 untuk menyimpan data dokumen 2 yang akan diunggah.
Map<String,Object> doc2 = Maps.newLinkedHashMap();
     doc2.put("id", 1);
String[] literal_arr2 = {"Element 1", "Element 2"};
     doc2.put("literal_arr", literal_arr2);

Mengirim nilai array sebagai string alih-alih sebagai tipe array akan menyebabkan error impor.

Langkah selanjutnya

Untuk panduan lengkap tentang pemrosesan dan pengimporan data, lihat: