Listar vetores

nota

O Amazon S3 Vectors está na versão prévia para o Amazon Simple Storage Service e está sujeito a alterações.

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.

Como usar a AWS CLI

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"
            }
        }
    ]
}