put-vectors - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Tek bir vektör dizini en fazla 2 milyar satır vektör verisi depolayabilir.
PutVectors işlemi saniyede 1.000 istek (QPS) sınırına sahiptir. Tek bir istekle en fazla 500 vektörlük bir toplu iş yazabilirsiniz. Tüm eşzamanlı isteklerdeki toplam vektör sayısı 2.500 ile sınırlıdır.

İzinler

Bir Alibaba Cloud hesabı varsayılan olarak tüm izinlere sahiptir. Ancak, bir Resource Access Management (RAM) kullanıcısı veya RAM rolü varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesap sahibi veya bir yönetici, bir RAM İlkesi veya bir paket ilkesi kullanarak izinleri vermelidir.

API	Eylem	Açıklama
PutVectors	`oss:PutVectors`	Vektör verilerini yazar.

Komut biçimi

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

Parametreler

Parametre	Tür	Açıklama
--bucket	dize	Vektör paketinin adı.
--index-name	dize	Dizinin adı.
--vectors	dize	Vektör verileri. Bir JSON dizesi veya file:// önekli bir dosya yolu belirtebilirsiniz.

Not

put-vectors komutu, PutVectors API işlemine karşılık gelir.
Desteklenen genel komut satırı seçenekleri hakkında bilgi için bkz. Genel komut satırı seçenekleri.

Vektör veri biçimi

Vektör verileri JSON dizi biçiminde olmalıdır. Dizideki her vektör aşağıdaki alanları içerir:

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

Aşağıdaki tabloda her bir alan açıklanmıştır.

Ad	Veri türü	Gerekli	Örnek	Açıklama
key	Dize	Evet	doc-001	Vektörün birincil anahtarıdır. Vektörü benzersiz şekilde tanımlar. Aşağıdaki sınırlamalar geçerlidir: Bir anahtar zaten varsa vektör üzerine yazılır. Aynı toplu iş içinde yinelenen anahtarlar varsa tüm işlem başarısız olur. Anahtar 1 ila 1.024 karakter uzunluğunda olmalıdır. Anahtar UTF-8 biçiminde olmalıdır. Üst düğüm: vectors
data	Konteyner	Evet	-	Vektörün içeriği. Üst düğüm: vectors
float32	Sayısal dizi	Evet	[0,1, 0,2, 0,3]	Vektör verileri. Veri türü float32'dir. Vektör boyutları dizinde tanımlanan boyutlarla eşleşmelidir. Kosinüs uzaklık ölçüsü kullanıldığında sıfır vektörlere izin verilmez. Üst düğüm: data
metadata	Konteyner	Hayır	-	Meta veriler. Aşağıdaki sınırlamalar geçerlidir: Toplam boyut 200 KB'yi aşamaz. Filtrelenebilir meta veriler için sınırlamalar: Her vektör 0 ila 100 filtrelenebilir alanı destekler. Her bir filtrelenebilir meta veri alanının boyutu 2 KB'yi aşamaz. Desteklenen veri türleri: dize, sayı, boolean ve liste. Filtrelenebilir meta verileri yapılandırdığınızda: Tek bir filtre yönergesindeki filtrelenebilir meta verilerin toplam uzunluğu 20 KB'yi aşamaz. Tek bir filtre yönergesindeki filtrelenebilir meta veri öğelerinin sayısı 1.024'ü aşamaz. Filtre koşulları en fazla 8 düzey derinliğinde iç içe yerleştirilebilir. Boş filtre koşullarına izin verilir. Üst düğüm: vectors

Örnekler

Bu örnekte, examplebucket adlı bir vektör paketindeki index adlı bir vektör dizinine bir vektör eklenmektedir. Vektör verisi [1], birincil anahtar vector1 ve meta veriler {"Key1": "32"} şeklindedir.

JSON yapılandırma dosyası kullanın. Aşağıdaki içerik vectors.json dosyasında bulunmaktadır:

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

Komut örneği:

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

JSON yapılandırma parametresi kullanın:

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