Operaciones de tablas de datos - Tablestore - Centro de documentación de Alibaba Cloud

Cree, seleccione, consulte, actualice y elimine tablas de datos con la interfaz de línea de comandos (CLI) de Tablestore.

Requisitos previos

Una instalación de la CLI de Tablestore con credenciales de acceso configuradas. Para más información, consulte Tablestore CLI.
Una instancia de Tablestore. Para más información, consulte Instance operations.

Crear una tabla

Para crear una tabla de datos, especifique las columnas de clave principal y, opcionalmente, configure el TTL de los datos y los límites de versión. También puede crear una tabla a partir de un archivo de configuración JSON.

create -t tableName --pk '[{"c":"col1","t":"string"},{"c":"col2","t":"integer"}]' [--ttl seconds] [--version max]

Parámetro	Obligatorio	Descripción
`-t, --table`	Sí	Nombre de la tabla de datos.
`-k, --pk`	Sí	Definiciones de columnas de clave principal en formato de matriz JSON. Cada elemento contiene los siguientes campos: `c` (obligatorio): Nombre de la columna de clave principal. `t` (obligatorio): Tipo de la columna de clave principal. Valores válidos: `string`, `integer`, `binary`. `opt` (opcional): Valor predeterminado: `none`. Establezca este valor en `auto` para usar la columna como clave principal de incremento automático. Para más información sobre las columnas de clave principal de incremento automático, consulte Auto-increment primary key column. Nota No es necesario definir columnas de atributo al crear una tabla de datos. Cada fila en Tablestore puede tener distintas columnas de atributo. Los nombres de las columnas de atributo se especifican al escribir los datos. Una tabla de datos admite hasta 4 columnas de clave principal. La primera columna de clave principal es la clave de partición de forma predeterminada. Las configuraciones de clave principal no se pueden modificar después de crear la tabla.
`-m, --model`	No	Tipo de tabla. Valor predeterminado: `widecolumn` (tabla de datos). Para crear una tabla de series temporales, consulte TimeSeries model.
`--ttl`	No	Tiempo de vida (TTL) de los datos, en segundos. Valor predeterminado: `-1` (los datos nunca caducan). El valor debe ser mayor o igual a 86400 (un día) o igual a -1.
`--version`	No	Número máximo de versiones. Valor predeterminado: `1`. El valor debe ser un entero distinto de cero. Importante Tablestore no impone un límite estricto al número máximo de versiones. Sin embargo, para un rendimiento y usabilidad óptimos, mantenga este valor en 500 o menos.
`--read_cu`	No	Rendimiento de lectura o escritura reservado, en unidades de capacidad (CU). Valor predeterminado: `0` (pay-as-you-go). Nota Esta configuración solo es compatible con tablas de datos en instancias de alto rendimiento. Si el rendimiento de lectura o escritura reservado se establece en un valor distinto de cero, se le cobrará independientemente de si se envían solicitudes de lectura o escritura.
`--write_cu`	No
`-d, --defined`	No	Columnas predefinidas en formato de matriz JSON. Obligatorio para índices secundarios. Cada elemento contiene los siguientes campos: `c` (obligatorio): Nombre de la columna predefinida. `t` (obligatorio): Tipo de la columna predefinida. Valores válidos: `string`, `integer`, `binary`, `double`, `bool`. Nota De forma predeterminada, una tabla de datos admite hasta 32 columnas predefinidas.
`--stream_enable`	No	Especifica si se habilita Stream. Valor predeterminado: `false`.
`--stream_expire`	No	Periodo de caducidad de los datos de Stream, en horas. Valor predeterminado: `24`.
`-i, --input`	No	Ruta al archivo de configuración JSON para crear la tabla.

Cree una tabla de datos básica:

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer"}]'

Cree una tabla de datos con una columna de incremento automático y TTL:

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer","opt":"auto"}]' --ttl 864000 --version 1

Cree una tabla de datos con columnas predefinidas para índices secundarios:

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer"}]' --defined '[{"c":"name","t":"string"},{"c":"age","t":"integer"}]'

Cree una tabla de datos a partir de un archivo de configuración:

Windows

create -i D:\\localpath\\filename.json

Linux and macOS

create -i /localpath/filename.json

Ejemplo de archivo de configuración:

{
    "Name": "mytable",
    "Meta": {
        "Pk": [
            {"C": "uid", "T": "string", "Opt": "none"},
            {"C": "pid", "T": "integer", "Opt": "none"}
        ]
    },
    "Option": {
        "TTL": 864000,
        "Version": 3
    },
    "CU": {
        "Read": 0,
        "Write": 0
    }
}

Seleccionar una tabla

Seleccione una tabla de datos para realizar operaciones posteriores.

use --wc -t tableName

Parámetro	Obligatorio	Descripción
`--wc`	No	Selecciona una tabla de datos de columna ancha.
`-t, --table`	Sí	Nombre de la tabla.

Ejemplo:

use --wc -t mytable

Listar nombres de tablas

Enumere los nombres de las tablas en la instancia actual. Filtre los resultados por tipo de tabla según sea necesario.

list [--wc | --all] [--detail]

Parámetro	Obligatorio	Descripción
`-w, --wc`	No	Enumera solo tablas de datos.
`-a, --all`	No	Enumera todos los tipos de tablas.
`-d, --detail`	No	Muestra información detallada de la tabla.

Ejemplo:

list --wc

Consultar detalles de la tabla

Consulte los detalles de configuración de una tabla de datos o de índice.

desc [-t tableName] [-f json|table] [-o outputFile]

Parámetro	Obligatorio	Descripción
`-t, --table`	No	Nombre de la tabla de datos o de índice. Si se omite, toma como valor predeterminado la tabla seleccionada mediante `use`.
`-f, --print_format`	No	Formato de salida. Valores válidos: `json` (predeterminado) y `table`.
`-o, --output`	No	Guarda la salida en un archivo local.

Ejemplo:

desc -t mytable

Actualizar una tabla

Actualice la configuración de una tabla de datos, como el TTL de los datos, el número máximo de versiones y el rendimiento reservado.

alter -t tableName [--ttl seconds] [--version max] [--read_cu n] [--write_cu n]

Parámetro	Obligatorio	Descripción
`-t, --table`	Sí	Nombre de la tabla. Si ya se seleccionó una tabla con `use`, este parámetro es opcional.
`--ttl`	No	Tiempo de vida (TTL) de los datos, en segundos. El valor debe ser mayor o igual a 86400 (un día) o igual a -1 (los datos nunca caducan).
`--version`	No	Número máximo de versiones. El valor debe ser un entero distinto de cero.
`--read_cu`	No	Rendimiento de lectura o escritura reservado, en unidades de capacidad (CU). Esta configuración solo es compatible con instancias de alto rendimiento.
`--write_cu`	No
`--stream_enable`	No	Especifica si se habilita Stream.
`--stream_expire`	No	Periodo de caducidad de los datos de Stream, en horas.
`--disallow_update`	No	Especifica si se deshabilitan las operaciones de actualización.

Establezca el TTL en un día y el número máximo de versiones en 1:

alter -t mytable --ttl 86400 --version 1

Eliminar una tabla

Elimine una tabla de datos específica.

drop -t tableName [-y]

Parámetro	Obligatorio	Descripción
`-t, --table`	Sí	Nombre de la tabla.
`-y, --yes`	No	Omite la solicitud de confirmación y elimina la tabla directamente.

Ejemplo:

drop -t mytable -y