Tablestore:Data table operations

Notas de uso

• Puede crear un máximo de 64 tablas de datos en una sola instancia.

• Una tabla de datos no está disponible inmediatamente para operaciones de lectura y escritura tras su creación. En la mayoría de los casos, podrá acceder a una nueva tabla aproximadamente un minuto después.

• La función de columna de clave principal con incremento automático y la función de transacción local no pueden usarse simultáneamente. Si configura una columna de clave principal con incremento automático al crear una tabla de datos, la función de transacción local no surtirá efecto aunque esté habilitada.

Funciones

• Crear una tabla de datos

  Al crear una tabla de datos, debe especificar su información de esquema y su información de configuración.

  • La información de esquema de una tabla de datos incluye el nombre de la tabla, la definición de la clave principal y las configuraciones de columnas predefinidas.

  • Puede configurar la tabla de datos según sus necesidades empresariales. La siguiente tabla describe los parámetros de configuración.

    Parámetro	Descripción
    Auto-increment primary key column	Al crear una tabla de datos, puede establecer una columna de clave principal que no sea clave de partición como columna de clave principal con incremento automático. Al escribir datos en la tabla, no necesita especificar un valor para esta columna; Tablestore genera uno automáticamente.
    Data versions and TTL	Puede usar versiones de datos y la función de tiempo de vida (TTL) para gestionar los datos de manera eficiente, lo que ayuda a reducir el uso y los costos de almacenamiento.
    Allow updates	De forma predeterminada, puede escribir datos en una tabla de datos mediante la operación de API UpdateRow. Puede cambiar esta configuración después de crear la tabla. Importante Si planea usar la función de tiempo de vida (TTL) para un índice de búsqueda, debe prohibir las escrituras que utilicen la operación de API UpdateRow.
    Reserved read/write throughput	Para instancias de alto rendimiento que utilizan el , puede configurar el rendimiento reservado de lectura/escritura para una tabla de datos según sus necesidades.
    Secondary index	Tablestore proporciona índices secundarios locales y globales para satisfacer requisitos de consulta con diferentes garantías de consistencia de lectura. Puede crear uno o más índices secundarios al crear una tabla de datos. Nota Para usar un índice secundario, debe predefinir una o más columnas que no sean de clave principal y sus tipos de datos en la tabla de datos. Estas columnas pueden usarse como columnas de índice o columnas incluidas en el índice. Puede agregar o eliminar columnas predefinidas después de crear la tabla.
    Data encryption	Tablestore ofrece cifrado de datos en reposo para garantizar la seguridad de la información. Puede configurar el cifrado de datos al crear una tabla de datos.
    Local transaction	Después de habilitar las transacciones locales para una tabla de datos, puede crear una transacción local dentro de un único valor de clave de partición y realizar operaciones de lectura y escritura sobre los datos dentro de esa transacción. Importante Puede habilitar transacciones locales para una tabla de datos mediante la consola de Tablestore o el SDK de Tablestore para Java 5.11.0 o posterior. Si no habilitó las transacciones locales al crear la tabla pero necesita la función posteriormente, submit a ticket para solicitar su activación.

• Actualizar la configuración de la tabla

  Modifica la configuración de una tabla de datos específica, como el tiempo de vida (TTL), el número máximo de versiones, la desviación máxima de versión y la configuración de Stream. También puede ajustar el rendimiento reservado de lectura/escritura para tablas de datos en instancias de alto rendimiento que utilizan el .

• Listar nombres de tablas

  Recupera los nombres de todas las tablas de datos en la instancia actual.

• Consultar la descripción de la tabla

  Consulta información sobre una tabla de datos específica, como su esquema y los detalles del rendimiento reservado de lectura/escritura.

• Eliminar una tabla de datos

  Elimina una tabla de datos específica.

Crear una tabla de datos

Siga estos pasos para crear una tabla de datos en la consola de Tablestore.

1. Vaya a la página Instance Management.

   1. Inicie sesión en la consola de Tablestore.

   2. En la barra de navegación superior, seleccione un resource group y una región.

   3. En la página Overview, haga clic en el alias de una instancia o haga clic en Instance Management en la columna Actions de la instancia.

2. En la pestaña Instance Details, haga clic en Create Table.

3. En el cuadro de diálogo Create Table, configure los parámetros como se describe en la siguiente tabla.

   Parámetro	Descripción
   Table name	El nombre de la tabla de datos, que debe ser único dentro de una instancia. El nombre debe tener entre 1 y 255 bytes de longitud y puede contener letras mayúsculas, letras minúsculas, dígitos y guiones bajos (_). El nombre debe comenzar con una letra o un guion bajo (_).
   Primary key	Una o más columnas que identifican de forma única una fila en la tabla. Introduzca un nombre de clave principal, seleccione un tipo de datos y luego haga clic en Add Primary Key Column para agregar otra columna de clave principal. Puede definir hasta cuatro columnas de clave principal para una tabla. La primera columna de clave principal es la clave de partición. No puede cambiar la configuración ni el orden de las columnas de clave principal después de crear la tabla. Importante Tablestore permite establecer una columna de clave principal como columna de clave principal con incremento automático. Una tabla solo puede tener una columna de clave principal con incremento automático, y la clave de partición no puede ser una columna con incremento automático. Si una columna de clave principal se establece con incremento automático, no necesita especificar su valor al escribir una fila; Tablestore genera automáticamente un valor único y estrictamente creciente dentro de la clave de partición. Un nombre de clave principal debe tener entre 1 y 255 bytes de longitud y puede contener letras mayúsculas, letras minúsculas, dígitos y guiones bajos (_). El nombre debe comenzar con una letra o un guion bajo (_). El tipo de datos de una clave principal puede ser STRING, INTEGER o BINARY.
   Allow updates	Especifica si se permite escribir datos mediante la operación de API UpdateRow. Si este parámetro no se establece o se define como Yes, se podrán escribir datos mediante UpdateRow. Para usar la función time to live (TTL) de un índice de búsqueda, debe establecer este parámetro en No. Esto prohíbe las escrituras que utilizan la operación de API UpdateRow.
   Encryption	Especifica si se habilita el cifrado de datos en reposo. De forma predeterminada, esta función está deshabilitada. Para habilitarla, active el interruptor Encryption. Importante El cifrado de datos en reposo no puede deshabilitarse una vez habilitado. Proceda con precaución.
   Encryption type	El tipo de cifrado de datos. Este parámetro es obligatorio solo si activa el interruptor Encryption. Valores válidos: CMK of KMS: Tablestore BYOK-based Key: Tablestore Importante Antes de usar la opción BYOK, debe crear una clave de software en la consola de KMS y luego crear un rol personalizado y configurar sus permisos. Para obtener más información, consulte Data encryption.
   Key ID	El ID de la clave. Este parámetro es obligatorio solo si Encryption Type se establece en BYOK-based Key.
   Role ARN	El Alibaba Cloud Resource Name (ARN) del rol. Este parámetro es obligatorio solo si Encryption Type se establece en BYOK-based Key.

4. (Opcional) En el cuadro de diálogo Create Table, configure los ajustes avanzados o cree un índice secundario.

   Realice este paso si necesita configurar ajustes avanzados para la tabla de datos, como el tiempo de vida (TTL), o crear un índice secundario.

   Parámetros avanzados

   Para gestionar el periodo de retención de datos en la tabla, especifique un tiempo de vida (TTL). Para conservar varias versiones de datos para la misma clave principal, especifique el número máximo de versiones. Para obtener más información, consulte Data versions and TTL.

   Para instancias de alto rendimiento en modo CU, puede especificar un rendimiento reservado de lectura o escritura para la tabla de datos con el fin de reducir costos. Para obtener más información, consulte Reserved read/write throughput.

   1. Active el interruptor Advanced Settings.

   2. Configure los parámetros avanzados como se describe en la siguiente tabla.

      Parámetro	Descripción
      Time to live	El periodo de retención de datos, en segundos. Cuando los datos superan este periodo, el sistema elimina automáticamente la información caducada. El valor debe ser un entero mayor o igual a 86400 (un día), o -1. Un valor de -1 indica que los datos nunca caducan.
      Max versions	El número máximo de versiones que pueden conservarse para cada columna de atributo. Si el número de versiones de datos en una columna de atributo supera este valor, el sistema elimina automáticamente las versiones anteriores. El valor debe ser un entero distinto de cero.
      Max version offset	La desviación máxima permitida entre una versión de datos especificada y la hora actual del sistema, en segundos. Este valor debe ser un entero positivo. Una operación de escritura solo se realiza correctamente si la versión especificada para cada columna se encuentra dentro de la desviación permitida respecto a la hora de escritura. El rango de versión válido para una columna de atributo es [max{WriteTime - MaxVersionOffset, WriteTime - TTL}, WriteTime + MaxVersionOffset).
      Reserved read throughput	Este parámetro solo es compatible con instancias de alto rendimiento que utilizan el . El rendimiento reservado de lectura o escritura para la tabla de datos. El valor debe ser un entero de 0 a 100,000. La unidad es la unidad de capacidad (CU). Si establece Reserved Read Throughput o Reserved Write Throughput en un valor mayor que 0, Tablestore asigna y reserva los recursos correspondientes para la tabla de datos. Después de crear la tabla, la facturación por el rendimiento reservado comienza inmediatamente. Si establece Reserved Read Throughput o Reserved Write Throughput en 0, Tablestore no asigna ni reserva recursos para la tabla de datos.
      Reserved write throughput
      Enable local transaction	La función de transacción local está deshabilitada de forma predeterminada. Para realizar operaciones atómicas de lectura y escritura en una o más filas dentro de la misma partición, active el interruptor Enable Local Transaction.
      Enable row version support	La compatibilidad con versiones de fila está deshabilitada de forma predeterminada. Para usar un global table, debe activar el interruptor Enable Row Versioning. No puede deshabilitar esta configuración una vez activada. Se aplican las siguientes limitaciones cuando la compatibilidad con versiones de fila está habilitada: Una sola fila puede tener un máximo de 256 columnas. No puede especificar manualmente números de versión al escribir datos. Los números de versión son generados automáticamente por el sistema. Al realizar una operación de actualización, el sistema debe leer primero la versión actual de la fila, lo que introduce una pequeña cantidad de carga de lectura adicional.
      Quick set for global table	Cuando utiliza un global table, active el interruptor Quick Set Global Table Dependency. El sistema modifica automáticamente las configuraciones relacionadas para la tabla global. Los cambios de configuración son los siguientes: Time To Live: -1 Max Versions: 1 Max Version Offset: 2147483647 Enable Row Version Support: Enabled

   Configurar un índice secundario

   Cuando una aplicación necesita consultar datos basándose en diferentes atributos, puede usar estos atributos como columnas de clave principal de un índice secundario para habilitar consultas rápidas. Para obtener más información, consulte secondary index.

   1. Active el interruptor Create a secondary index.

   2. Haga clic en Add y, a continuación, introduzca un nombre y seleccione un tipo de datos para la columna predefinida.

      El nombre de una columna predefinida debe tener entre 1 y 255 bytes de longitud y puede contener letras mayúsculas, letras minúsculas, dígitos y guiones bajos (_). Debe comenzar con una letra o un guion bajo (_).

      El tipo de datos para una columna predefinida puede ser STRING, INTEGER, BINARY, FLOAT o BOOLEAN.

   3. Haga clic en Add Secondary Index, introduzca un nombre de índice, seleccione la clave principal del índice y, opcionalmente, seleccione columnas predefinidas y un tipo de índice.

      Importante

      El nombre del índice no puede ser igual al nombre de la tabla de datos. Tanto el nombre del índice como el nombre de la tabla de datos deben ser únicos dentro de la instancia.

      Un nombre de índice debe tener entre 1 y 255 bytes de longitud y puede contener letras mayúsculas, letras minúsculas, dígitos y guiones bajos (_). Debe comenzar con una letra o un guion bajo (_).

      • La Primary Key puede consistir en las columnas de clave principal de la tabla de datos y columnas predefinidas. Puede seleccionar varias columnas. La Pre-defined Column solo puede seleccionarse de las columnas predefinidas de la tabla de datos. Puede seleccionar varias columnas, pero no pueden ser iguales a ninguna de las columnas de clave principal del índice.

      • El Index Type puede ser Global o Local.

        Importante

        La primera columna de clave principal de un índice secundario global puede ser cualquier columna de clave principal o columna predefinida. La primera columna de clave principal de un índice secundario local debe ser la misma que la primera columna de clave principal de la tabla de datos.

        Un índice secundario global sincroniza de forma asíncrona los datos de las columnas indexadas y las columnas de clave principal de la tabla de datos hacia la tabla de índice. La latencia de sincronización suele estar en el rango de milisegundos. Un índice secundario local sincroniza sincrónicamente los datos de las columnas indexadas y las columnas de clave principal de la tabla de datos hacia la tabla de índice. Después de escribir datos en la tabla de datos, están disponibles inmediatamente para consultas desde la tabla de índice.

5. Haga clic en Create.

Gestionar tablas de datos

Realice las siguientes operaciones para gestionar sus tablas de datos según sea necesario.

Desarrollo e integración

Puede utilizar los siguientes SDK o la CLI de Tablestore para realizar operaciones de tablas de datos.