All Products
Search
Document Center

OpenSearch:Sumber data API

Last Updated:Aug 21, 2026

Topik ini menjelaskan cara menambahkan tabel saat Anda menggunakan API sebagai sumber data.

Tambahkan tabel

  1. Pada halaman Detail Instans > Manajemen Tabel, klik Add Table.

  2. Masukkan informasi dasar untuk tabel tersebut, lalu klik Next.

Deskripsi konfigurasi:

  • Table Name: Masukkan nama kustom.

  • Number of Shards: Masukkan bilangan bulat positif hingga 256. Pengaturan ini meningkatkan kecepatan build penuh dan performa kueri individual. Untuk beberapa instans yang sudah ada, semua tabel indeks harus memiliki jumlah shard yang sama. Alternatifnya, satu tabel indeks dapat memiliki satu shard, sedangkan semua tabel indeks lainnya memiliki jumlah shard yang sama.

  • Data update resources: Jumlah sumber daya yang digunakan untuk pembaruan data. Secara default, setiap indeks mencakup dua sumber daya pembaruan berukuran 4-core 8 GB secara gratis. Anda akan dikenai biaya untuk sumber daya yang melebihi kuota gratis. Untuk informasi selengkapnya, lihat atau Dokumen Penagihan Situs Internasional Edisi Pencarian Vektor.

  • Scenario Template: Edisi Pencarian Vektor menyediakan tiga templat bawaan: General, Vector - Image Search, dan Vector - Text Semantics.

  1. Konfigurasikan sumber data untuk sinkronisasi data, lalu klik Next.

Deskripsi parameter:

  • Data Source Type: Pilih API. Ini menunjukkan bahwa data didorong ke instans menggunakan API.

  1. Konfigurasikan bidang-bidang, lalu klik Next.

    Catatan
    • Bidang primary key dan bidang vektor wajib diisi. Bidang primary key harus bertipe int atau string, dan Anda harus memilih opsi Primary Key untuk bidang tersebut. Bidang vektor harus bertipe float, dan Anda harus memilih opsi Vector Field untuk bidang tersebut.

    • Secara default, bidang vektor bertipe float multi-nilai. Pemisah multi-nilai default adalah pemisah ha3 `^]` (dikodekan UTF-8 sebagai `\x1D`), yang digunakan untuk memisahkan nilai-nilai tersebut. Anda juga dapat menentukan pemisah multi-nilai kustom.

    • Jika suatu bidang tidak tersedia atau kosong dalam data, sistem secara otomatis mengisinya dengan nilai default. Nilai default adalah 0 untuk tipe numerik dan string kosong untuk tipe STRING. Anda juga dapat menentukan nilai default kustom.

  2. Konfigurasikan skema indeks, lalu klik Next.

Bagian ini digunakan untuk mengonfigurasi indeks vektor:

  • Bidang primary key dan bidang vektor wajib diisi. Bidang namespace bersifat opsional dan dapat dibiarkan kosong.

  • Anda hanya dapat memilih dari ketiga bidang tetap ini. Anda tidak dapat menambahkan bidang baru.

  • Vector Dimensions: Pilih jumlah dimensi berdasarkan vektor yang dihasilkan oleh model Anda.

  • Distance Metric: Pilih metrik jarak berdasarkan vektor yang dihasilkan oleh model Anda. Sistem mendukung dua jenis metrik jarak: SquareEuclidean dan InnerProduct.

  • Vector Index Algorithm: Pilih algoritma berdasarkan vektor yang dihasilkan oleh model Anda. Sistem mendukung algoritma indeks vektor berikut: Quantized Clustering, linear, dan HNSW (Hierarchical Navigable Small World).

  • Real-time Index: Menentukan apakah akan membuat indeks vektor real-time untuk data inkremental dari API. Nilai default-nya adalah true.

Untuk konfigurasi lanjutan lainnya, buka bagian tersebut. Untuk deskripsi parameternya, lihat Konfigurasi umum untuk indeks vektor.

  1. Konfirmasi konfigurasi. Setelah Anda mengklik Confirm, sistem secara otomatis membuat tabel berdasarkan spesifikasi Anda.

Anda dapat melihat progres pembuatan di riwayat perubahan.

  1. Saat status tabel berubah menjadi In Use, Anda dapat menguji kueri di halaman Query Test.

Catatan

  • Saat Anda melakukan build penuh untuk sumber data API, seluruh data yang sebelumnya telah didorong akan dihapus. Sistem kemudian mulai menyinkronkan data real-time dari timestamp yang ditentukan. Oleh karena itu, berhati-hatilah saat melakukan build penuh untuk sumber data API.