Delete an existing doc in a collection by its ID or a list of IDs using the Python SDK - DashVector: Central de Documentação do Alibaba Cloud

Exclua um ou mais documentos de uma coleção do DashVector por chave primária com o SDK for Python ou remova todos os documentos de uma partição.

Nota

Se o ID do documento a ser excluído não existir, a operação de exclusão será inválida para esse documento.

Pré-requisitos

Crie um cluster
Gerencie chaves de API
Instale o DashVector SDK (versão mais recente)

Definição da API

Collection.delete(
    ids: Union[str, List[str]],
    partition: Optional[str] = None,
    async_req: bool = False,
    delete_all: bool = False
) -> DashVectorResponse

Parâmetros

Parâmetro	Tipo	Valor padrão	Descrição
ids	str ou List[str]	-	Chave primária ou lista de chaves primárias a excluir.
partition	Optional[str]	None	Nome da partição de destino.
async_req	bool	False	Ative o modo assíncrono.
delete_all	bool	False	Exclui todos os dados da partição. Quando definido como `True`, o campo `ids` deve permanecer vazio.

Resposta

DashVectorResponse contém os seguintes campos:

Campo	Tipo	Descrição	Exemplo
code	int	Código de status. Para mais informações, consulte Códigos de status.	0
message	str	Mensagem da resposta.	success
request_id	str	ID único da solicitação.	19215409-ea66-4db9-8764-26ce2eb5bb99
output	List[DocOpResult]	Resultado da exclusão do documento.

Exemplos

Nota

Substitua <your-api-key> pela sua chave de API e <your-cluster-endpoint> pelo endpoint do seu cluster.
Estes exemplos exigem uma coleção chamada quickstart com documentos já inseridos. Consulte Crie uma coleção e Inserir documentos.

Os exemplos a seguir usam a mesma configuração de cliente:

import dashvector

client = dashvector.Client(
    api_key='<your-api-key>',
    endpoint='<your-cluster-endpoint>'
)
collection = client.get(name='quickstart')

Excluir um único documento

Informe uma única chave primária como string:

resp = collection.delete('1')
if resp:
    print('Delete succeeded')

Excluir vários documentos

Forneça uma lista de chaves primárias:

resp = collection.delete(['1', '2'])
if resp:
    print('Batch delete succeeded')

Excluir todos os documentos de uma partição

Aviso

Esta operação remove todos os dados da partição. Não informe nenhum ID ao usar delete_all.

Defina delete_all=True para remover todos os documentos de uma partição:

resp = collection.delete(delete_all=True)
if resp:
    print('All documents deleted')

Operações relacionadas

Operação	Descrição
Inserir documentos	Insere documentos em uma coleção.
Consultar documentos	Consulta documentos por similaridade vetorial.
Crie uma coleção	Cria uma nova coleção.