Daftar vektor - Amazon Simple Storage Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Daftar vektor

Anda dapat mencantumkan vektor dalam indeks vektor dengan operasi ListVectorsAPI. Untuk informasi lebih lanjut tentang jumlah maksimum vektor yang dapat dikembalikan per halaman, lihatKeterbatasan dan pembatasan. Responsnya mencakup token pagination saat hasilnya terpotong. Untuk informasi selengkapnya tentang elemen responsListVectors, lihat ListVectorsdi Referensi API Amazon S3. Anda juga dapat menggunakan ListVectors untuk mengekspor data vektor dari indeks vektor tertentu. ListVectorssangat konsisten. Setelah operasi WRITE, Anda dapat segera membuat daftar vektor dengan semua perubahan yang tercermin.

Untuk daftar vektor, gunakan contoh perintah berikut. Ganti user input placeholders dengan informasi Anda sendiri.

segment-indexParameter segment-count dan memungkinkan Anda untuk mempartisi operasi listing Anda di beberapa permintaan paralel. Ketika Anda menentukan segment-count nilai (seperti2), Anda membagi indeks menjadi banyak segmen. segment-indexParameter (mulai dari 0) menentukan segmen mana yang akan dicantumkan. Pendekatan ini membantu meningkatkan kinerja saat mencantumkan indeks vektor besar dengan mengaktifkan pemrosesan paralel. Untuk informasi selengkapnya tentang segment-count dansegment-index, lihat ListVectorsdi Referensi API Amazon S3.

Untuk daftar semua vektor dalam indeks

Contoh permintaan:

aws s3vectors list-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --segment-count 2 \
  --segment-index 0 \
  --return-data \
  --return-metadata

Contoh respons:

{
    "vectors": [
        {
            "key": "vec3",
            "data": {
                "float32": [0.4000000059604645]
            },
            "metadata": {
                "nonFilterableKey": "val4",
                "filterableKey": "val2"
            }
        }
    ]
}

Untuk daftar vektor dengan pagination

Contoh permintaan:

aws s3vectors list-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --segment-count 2 \
  --segment-index 0 \
  --return-data \
  --return-metadata \
  --next-token "zWfh7e57H2jBfBtRRmC7OfMwl209G9dg3j2qM6kM4t0rps6ClYzJykgMOil9eGqU5nhf_gTq53IfoUdTnsg"

Contoh respons:

{
    "vectors": [
        {
            "key": "vec1",
            "data": {
                "float32": [0.5]
            },
            "metadata": {
                "nonFilterableKey": "val2",
                "filterableKey": "val1"
            }
        }
    ]
}
SDK for Python

Contoh: Daftar vektor dalam indeks vektor

import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#List vectors in your vector index 

response = s3vectors.list_vectors( 
    vectorBucketName="media-embeddings",
    indexName="movies",
    maxResults = 600,
    returnData = True,
    returnMetadata = True
)

vectors = response["vectors"]

print(vectors)

Contoh: Daftar semua vektor dalam indeks vektor secara paralel

import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#List vectors in the 1st half of vectors in the index.
response = s3vectors.list_vectors( 
    vectorBucketName="media-embeddings",
    indexName="movies",
    segmentCount=2,
    segmentIndex=1,
    maxResults = 600,
    returnData = True,
    returnMetadata = True
)

vectors = response["vectors"]

#List vectors starting from the 2nd half of vectors in the index.
# This can be ran in parallel with the first `list_vectors` call.
response = s3vectors.list_vectors( 
    vectorBucketName="media-embeddings",
    indexName="movies",
    segmentCount=2,
    segmentIndex=1,
    maxResults = 600,
    returnData = True,
    returnMetadata = True
)

vectors = response["vectors"]

print(vectors)