put-vectors - Object Storage Service

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

Catatan

Indeks vektor tunggal dapat menyimpan maksimum 50 juta baris data vektor.
Operasi PutVectors dapat menulis maksimum 500 vektor dalam satu batch.

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 Kebijakan RAM atau kebijakan bucket.

API	Tindakan	Deskripsi
PutVectors	`oss:PutVectors`	Menulis data vektor.

Format perintah

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

Parameter

Parameter	Tipe	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 tentang opsi baris perintah global yang didukung, lihat Opsi baris perintah global.

Format data vektor

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

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

Tabel berikut menjelaskan setiap bidang.

Nama	Tipe data	Diperlukan	Contoh	Deskripsi
key	String	Ya	doc-001	Kunci utama dari vektor. Ini secara unik mengidentifikasi vektor. Batasan berikut berlaku: Jika kunci sudah ada, vektor akan ditimpa. Jika kunci duplikat ada dalam batch yang sama, seluruh operasi gagal. Kunci harus memiliki panjang 1 hingga 1.024 karakter. Kunci harus dalam format UTF-8. Node induk: vectors
data	Container	Ya	-	Isi dari vektor. Node induk: vectors
float32	Array numerik	Ya	[0.1, 0.2, 0.3]	Data vektor. Tipe datanya adalah float32. Dimensi vektor harus sesuai dengan dimensi yang didefinisikan dalam indeks. Vektor nol tidak diizinkan saat menggunakan ukuran jarak kosinus. Node induk: data
metadata	Container	Tidak	-	Metadata. Batasan berikut berlaku: Ukuran total tidak boleh melebihi 40 KB. Batas untuk metadata yang dapat difilter: Jumlah bidang yang dapat difilter adalah antara 0 hingga 10. Ukuran bagian yang dapat difilter tidak boleh melebihi 2 KB. Tipe data yang didukung adalah string. Saat mengonfigurasi metadata yang dapat difilter: Panjang total metadata yang dapat difilter dalam instruksi filter tunggal tidak boleh melebihi 64 KB. Jumlah item metadata yang dapat difilter dalam instruksi filter tunggal tidak boleh melebihi 1.024. Kondisi filter dapat bersarang 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 utamanya adalah vector1, dan metadatanya adalah {"Key1": "32"}.

Gunakan file konfigurasi JSON. Berikut adalah isi dari 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\"}}]"