put-vectors - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

Um único índice vetorial pode armazenar no máximo 2 bilhões de linhas de dados vetoriais.
Cada solicitação grava até 500 vetores. QPS máximo: 5.

Permissões

Uma conta do Alibaba Cloud possui todas as permissões por padrão. No entanto, um usuário ou uma função do Resource Access Management (RAM) não possui nenhuma permissão por padrão. O proprietário da conta do Alibaba Cloud ou um administrador deve conceder permissões usando uma Política do RAM ou uma política de bucket.

API	Ação	Descrição
PutVectors	`oss:PutVectors`	Grava dados vetoriais.

Formato do comando

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

Parâmetros

Parâmetro	Tipo	Descrição
--bucket	string	O nome do bucket vetorial.
--index-name	string	O nome do índice.
--vectors	string	Os dados vetoriais. É possível especificar uma string JSON ou um caminho de arquivo prefixado com file://.

null

O comando put-vectors corresponde à operação de API PutVectors.
Para obter informações sobre as opções globais de linha de comando compatíveis, consulte Opções globais de linha de comando.

Formato dos dados vetoriais

Os dados vetoriais devem estar no formato de array JSON. Cada vetor no array contém os seguintes campos:

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

A tabela a seguir descreve cada campo.

Nome	Tipo de dados	Obrigatório	Exemplo	Descrição
key	String	Sim	doc-001	A chave primária do vetor. Ela identifica o vetor de forma exclusiva. Os seguintes limites se aplicam: Se uma chave já existir, o vetor será substituído. Se houver chaves duplicadas no mesmo lote, toda a operação falhará. A chave deve ter de 1 a 1.024 caracteres. A chave deve estar no formato UTF-8. Nó pai: vectors
data	Container	Sim	-	O conteúdo do vetor. Nó pai: vectors
float32	Array numérico	Sim	[0.1, 0.2, 0.3]	Os dados vetoriais. O tipo de dados é float32. As dimensões do vetor devem corresponder às dimensões definidas no índice. Vetores nulos não são permitidos quando a medida de distância cosseno é utilizada. Nó pai: data
metadata	Container	Não	-	Os metadados. Os seguintes limites se aplicam: O tamanho total não pode exceder 40 KB. Limites para metadados filtráveis: o número de campos filtráveis é de 0 a 10. O tamanho da parte filtrável não pode exceder 2 KB. O tipo de dados compatível é string. Ao configurar metadados filtráveis: O comprimento total dos metadados filtráveis em uma única instrução de filtro não pode exceder 64 KB. O número de itens de metadados filtráveis em uma única instrução de filtro não pode exceder 1.024. As condições de filtro podem ser aninhadas em até 8 níveis de profundidade. Condições de filtro vazias são permitidas. Nó pai: vectors

Exemplos

Este exemplo adiciona um vetor a um índice vetorial chamado index em um bucket vetorial chamado examplebucket. Os dados vetoriais são [1], a chave primária é vector1 e os metadados são {"Key1": "32"}.

Use um arquivo de configuração JSON. O conteúdo a seguir está no arquivo vectors.json:

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

Exemplo de comando:

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

Use um parâmetro de configuração JSON:

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