Listar vetores - Amazon Simple Storage Service

Listar vetores

Você pode listar vetores em um índice de vetores com a operação de API ListVectors. Para ter mais informações sobre o número máximo de vetores que podem ser exibidos por página, consulte Limitações e restrições. A resposta inclui um token de paginação quando os resultados são truncados. Para ter mais informações sobre os elementos da resposta de ListVectors, consulte ListVectors na Referência de API do Amazon S3. Você também pode usar ListVectors para exportar dados vetoriais de um índice de vetores especificado. ListVectors é altamente consistente. Depois de uma operação WRITE, você pode listar imediatamente os vetores com todas as alterações já implementadas.

Para listar vetores, use os comandos de exemplo a seguir. Substitua os espaços reservados para entrada do usuário por suas próprias informações.

Os parâmetros segment-count e segment-index permitem que você particione as operações de listagem em várias solicitações paralelas. Ao especificar um valor segment-count (como 2), o índice é dividido de acordo com esse número de segmentos. O parâmetro segment-index (que começa de 0) determina qual segmento listar. Essa abordagem ajuda a melhorar o desempenho ao listar grandes índices de vetores, permitindo o processamento paralelo. Para ter mais informações sobre segment-count e segment-index, consulte ListVectors na Referência de API do Amazon S3.

Como listar todos os vetores em um índice

Exemplo de solicitação:

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

Exemplo de resposta:

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

Como listar vetores com paginação

Exemplo de solicitação:

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"

Exemplo de resposta:

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

Exemplo: listar vetores em um índice de vetores

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)

Exemplo: listar todos os vetores em um índice de vetores em paralelo

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)