Eliminar documentos - DashVector - Centro de documentación de Alibaba Cloud

Elimine uno o más documentos de una colección de DashVector mediante la clave primaria con el SDK para Python, o elimine todos los documentos de una partición.

Nota

Si el ID del documento que se desea eliminar no existe, la operación de eliminación no surte efecto para ese documento.

Requisitos previos

Create a cluster
Manage API keys
Install DashVector SDK (versión más reciente)

Definición de la API

Python

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 predeterminado	Descripción
ids	str or List[str]	-	Clave primaria o lista de claves primarias que se van a eliminar.
partition	Optional[str]	None	Nombre de la partición de destino.
async_req	bool	False	Habilite el modo asíncrono.
delete_all	bool	False	Elimine todos los datos de la partición. Cuando se establece en `True`, `ids` debe quedar vacío.

Respuesta

DashVectorResponse contiene a continuación los siguientes campos:

Campo	Tipo	Descripción	Ejemplo
code	int	Código de estado. Para obtener más información, consulte Status codes.	0
message	str	Mensaje de respuesta.	success
request_id	str	ID único de la solicitud.	19215409-ea66-4db9-8764-26ce2eb5bb99
output	List[DocOpResult]	Resultado de la eliminación del documento.

Ejemplos

Nota

Reemplace <your-api-key> con su clave de API y <your-cluster-endpoint> con el endpoint de su clúster.
Estos ejemplos requieren una colección llamada quickstart con documentos ya insertados. Consulte Create a collection y Insert documents.

A continuación se muestran ejemplos que utilizan la misma configuración de cliente:

Python

import dashvector

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

Eliminar un solo documento

Pase una única clave primaria como cadena de texto:

Python

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

Eliminar varios documentos

Pase una lista de claves primarias:

Python

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

Eliminar todos los documentos de una partición

Aviso

Esta operación elimina todos los datos de la partición. No pase ningún ID cuando utilice delete_all.

Establezca delete_all=True para quitar todos los documentos de una partición:

Python

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

Operaciones relacionadas

Operación	Descripción
Insert documents	Inserte documentos en una colección.
Consultar documentos	Consulte documentos por similitud vectorial.
Create a collection	Cree una nueva colección.