Crea un índice de búsqueda.
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 |
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:
Tablestore SDK for Java: Create a search index
Tablestore SDK for Go: Create a search index
Tablestore SDK for Python: Create a search index
Tablestore SDK for Node.js: Create a search index
Tablestore SDK for .NET: Create search indexes
Tablestore SDK for PHP: Create a search index