Todos los productos
Search
Centro de documentos

Tablestore:CreateSearchIndex

Última actualización: Sep 29, 2026

Crea un índice de búsqueda.

Nota

Para obtener más información sobre los índices de búsqueda, consulte Descripción general.

Notas de uso

Antes de crear un índice de búsqueda, compruebe que el número máximo de versiones de la tabla de datos esté establecido en 1. Además, el tiempo de vida (TTL) de la tabla de datos debe cumplir una de a continuación condiciones:

  • El TTL de la tabla de datos está configurado en -1, lo que indica que los datos nunca caducan.

  • El TTL de la tabla de datos tiene un valor distinto de -1 y las operaciones de actualización en dicha tabla están prohibidas.

Sintaxis de la solicitud

message CreateSearchIndexRequest {
    required string table_name = 1;
    required string index_name = 2;
    optional IndexSchema schema = 3;
    optional string source_index_name = 4;
    optional int32 time_to_live = 5; // unit is seconds
}

Parámetro

Tipo

Obligatorio

Descripción

table_name

string

Sí

Nombre de la tabla de datos.

index_name

string

Sí

Nombre del índice de búsqueda.

schema

IndexSchema

Sí

Esquema del índice de búsqueda.

source_index_name

string

No

Nombre del índice de búsqueda de origen. Este parámetro es obligatorio solo cuando se desea modificar un esquema de forma dinámica.

time_to_live

int32

No

TTL del índice de búsqueda. Indica el periodo durante el cual se conservan los datos. Valor predeterminado: -1. Unidad: segundos.

Si el periodo de retención supera el valor del parámetro time_to_live, Tablestore elimina automáticamente los datos caducados.

El valor mínimo del parámetro time_to_live es 86400, equivalente a un día. El valor -1 indica que los datos nunca caducan.

Para obtener más información sobre el TTL de los índices de búsqueda, consulte Specify the TTL of a search index.

Sintaxis de la respuesta

message CreateSearchIndexResponse {
}

Una llamada exitosa devuelve el código de estado HTTP 200. Cualquier otro código de estado indica que la operación finalizó con errores.

  • HTTP 200: la llamada se completó correctamente.

  • HTTP 400 o 500: la llamada finalizó con errores.

    La respuesta incluye un mensaje de error. Para obtener más información, consulte Error.

Uso de los SDK de Tablestore

Utilice los siguientes SDK de Tablestore para crear un índice de búsqueda: