DeleteRow - Tablestore - Centro de documentación de Alibaba Cloud

Elimina una fila de datos.

Sintaxis de la solicitud

message DeleteRowRequest {
    required string table_name = 1;
    required bytes primary_key = 2; // The primary key is encoded as binary data in the PlainBuffer format. 
    required Condition condition = 3;
    optional ReturnContent return_content = 4;
    optional string transaction_id = 5;
}

Parámetro	Tipo	Obligatorio	Descripción
table_name	string	Sí	Nombre de la tabla de datos.
primary_key	bytes	Sí	Clave principal de la fila que desea eliminar. La clave principal se codifica en formato PlainBuffer. Para obtener más información sobre PlainBuffer, consulte PlainBuffer.
condition	Condition	Sí	Especifique si se debe comprobar la existencia de la fila antes de una operación de datos. Valor predeterminado: IGNORE. Valores válidos: IGNORE: No se comprueba la existencia de la fila. Si establece el parámetro condition en IGNORE, la operación se completa correctamente sin importar si la fila existe. EXPECT_EXIST: Se espera que la fila exista. Si establece el parámetro condition en EXPECT_EXIST, la operación de eliminación se completa correctamente cuando la fila existe. Si la fila no existe, la operación falla y se notifica un error.
return_content	ReturnContent	No	Tipo de datos que se devuelven después de escribir la fila correctamente. Solo se puede devolver la clave principal. Por lo general, este parámetro se usa con la función de columna de clave principal con incremento automático.
transaction_id	string	No	ID de la transacción local. Este parámetro es obligatorio si desea usar una transacción local para eliminar datos.

Sintaxis de la respuesta

message DeleteRowResponse {
    required ConsumedCapacity consumed = 1;
    optional bytes row = 2;
}

Parámetro

Tipo

Descripción

consumed

ConsumedCapacity

Número de unidades de capacidad (CU) consumidas por la operación. Para obtener más información, consulte CU consumption.

row

bytes

Datos que se devuelven si especifica un valor para return_content. Si no especifica un valor para return_content o no existe ningún valor de retorno, se devuelve NULL.

Los datos devueltos se codifican en formato PlainBuffer. Para obtener más información sobre PlainBuffer, consulte PlainBuffer.

Uso de los SDK de Tablestore

Use los siguientes SDK de Tablestore para eliminar una sola fila de datos:

Tablestore SDK for Java: Delete a single row of data
Tablestore SDK for Go: Delete a single row of data
Tablestore SDK for Python: Delete a single row of data
Tablestore SDK for Node.js: Delete a single row of data
Tablestore SDK for .NET: Delete a single row of data
Tablestore SDK for PHP: Delete a single row of data

Consumo de CU

Si la fila que desea eliminar no existe, el número de CU consumidas varía según el valor especificado para el parámetro condition.
- Si el valor del parámetro condition es IGNORE, el número de CU de escritura consumidas se redondea hacia arriba a partir del valor calculado con la siguiente fórmula: Número de CU de escritura consumidas = Tamaño de los datos en todas las columnas de clave principal de la fila / 4 KB.
- Si el valor del parámetro condition es EXPECT_EXIST, la eliminación de la fila falla. Se consume una CU de escritura y una CU de lectura.
Si la fila que desea eliminar existe, el número de CU consumidas varía según el valor especificado para el parámetro condition.
- Si el valor del parámetro condition es IGNORE, el número de CU de escritura consumidas se redondea hacia arriba a partir del valor calculado con la siguiente fórmula: Número de CU de escritura consumidas = Tamaño de los datos en todas las columnas de clave principal de la fila / 4 KB.
- Si el valor del parámetro condition es EXPECT_EXIST, se consumen tanto CU de escritura como de lectura. El número de CU de escritura consumidas se redondea hacia arriba a partir del valor calculado con la siguiente fórmula: Número de CU de escritura consumidas = Tamaño de los datos en todas las columnas de clave principal de la fila / 4 KB. El número de CU de lectura consumidas se redondea hacia arriba a partir del valor calculado con la siguiente fórmula: Número de CU de lectura consumidas = Tamaño de los datos en todas las columnas de clave principal de la fila / 4 KB.
Para obtener más información sobre cómo calcular el tamaño de los datos, consulte Billing overview.
Si la solicitud supera el tiempo de espera y los resultados quedan indefinidos, es posible que se consuman CU o no.
Si se devuelve un código de estado HTTP 5xx, lo cual indica que ocurrió un error interno, la operación no consume CU. Si se devuelven otros errores, se consume una CU de escritura.