Tulis data vektor ke indeks menggunakan put-vectors - Object Storage Service - Alibaba Cloud - Object Storage Service

Gunakan perintah put-vectors untuk menulis data vektor ke dalam indeks.

Catatan penggunaan

Satu indeks vektor dapat menyimpan hingga 2 miliar baris data vektor.
Operasi PutVectors memiliki batas QPS sebesar 1.000. Satu permintaan dapat menulis batch hingga 500 vektor, dan jumlah total vektor dari semua permintaan konkuren dibatasi hingga 2.500.

Izin

Akun Alibaba Cloud memiliki semua izin secara default. Namun, Pengguna Resource Access Management (RAM) atau Peran RAM tidak memiliki izin apa pun secara default. Pemilik Akun Alibaba Cloud atau administrator harus memberikan izin menggunakan RAM Policy atau bucket policy.

API	Action	Description
PutVectors	`oss:PutVectors`	Menulis data vektor.

Format perintah

ossutil vectors-api put-vectors --bucket value --index-name value --vectors value [flags]

Parameter

Parameter	Type	Deskripsi
--bucket	string	Nama bucket vektor.
--index-name	string	Nama indeks.
--vectors	string	Data vektor. Anda dapat menentukan string JSON atau jalur file dengan awalan file://.

Catatan

Perintah put-vectors sesuai dengan operasi API PutVectors.
Untuk informasi mengenai opsi baris perintah global yang didukung, lihat Global command-line options.

Format data vektor

Data vektor harus dalam format array JSON. Setiap vektor dalam array berisi bidang-bidang berikut:

[ 
    { 
       "data": {
          "float32":[float]
       },
       "key": "string",
       "metadata": {
           "key1": ["value1", "value2"],
           "key2": "value2"
       }
    }
]

Tabel berikut menjelaskan setiap bidang.

Nama	Tipe data	Wajib	Contoh	Deskripsi
key	String	Ya	doc-001	Kunci primary dari vektor. Kunci ini secara unik mengidentifikasi vektor. Batasan berikut berlaku: Jika kunci sudah ada, vektor akan ditimpa. Jika terdapat kunci duplikat dalam batch yang sama, seluruh operasi gagal. Panjang kunci harus antara 1 hingga 1.024 karakter. Kunci harus dalam format UTF-8. Node induk: vectors
data	Container	Ya	-	Isi vektor. Node induk: vectors
float32	Numeric array	Ya	[0.1, 0.2, 0.3]	Data vektor. Tipe datanya adalah float32. Dimensi vektor harus sesuai dengan dimensi yang ditentukan dalam indeks. Vektor nol tidak diperbolehkan saat menggunakan ukuran jarak cosine. Node induk: data
metadata	Container	Tidak	-	Metadata. Batasan berikut berlaku: Ukuran total tidak boleh melebihi 200 KB. Batas untuk metadata yang dapat difilter: Setiap vektor mendukung 0 hingga 100 bidang yang dapat difilter. Ukuran setiap bidang metadata yang dapat difilter tidak boleh melebihi 2 KB. Tipe data yang didukung: string, number, boolean, dan list. Saat Anda mengonfigurasi metadata yang dapat difilter: Panjang total metadata yang dapat difilter dalam satu instruksi filter tidak boleh melebihi 20 KB. Jumlah item metadata yang dapat difilter dalam satu instruksi filter tidak boleh melebihi 1.024. Kondisi filter dapat disusun hingga kedalaman 8 level. Kondisi filter kosong diperbolehkan. Node induk: vectors

Contoh

Contoh ini menambahkan vektor ke indeks vektor bernama index dalam bucket vektor bernama examplebucket. Data vektornya adalah [1], kunci primernya adalah vector1, dan metadatanya adalah {"Key1": "32"}.

Gunakan file konfigurasi JSON. Konten berikut ada dalam file vectors.json:

[
  {
    "data": {
      "float32": [1]
    },
    "key": "vector1",
    "metadata": {
      "Key1": "32"
    }
  }
]

Contoh perintah:

ossutil vectors-api put-vectors --bucket examplebucket --index-name index --vectors file://vectors.json

Gunakan parameter konfigurasi JSON:

ossutil vectors-api put-vectors --bucket examplebucket --index-name index --vectors "[{\"data\":{\"float32\":[1]},\"key\":\"vector1\",\"metadata\":{\"Key1\":\"32\"}}]"