Tablestore:Operações de tabelas de dados

Observações de uso

• É possível criar no máximo 64 tabelas de dados em uma única instância.

• Uma tabela de dados não fica disponível imediatamente para operações de leitura e gravação após a criação. Na maioria dos casos, é possível acessar a nova tabela em aproximadamente um minuto.

• O recurso de coluna de chave primária de autoincremento e o recurso de transação local não podem ser usados simultaneamente. Ao configurar uma coluna de chave primária de autoincremento durante a criação de uma tabela de dados, o recurso de transação local não entra em vigor, mesmo que esteja ativado.

Funcionalidades

• Criar uma tabela de dados

  Ao criar uma tabela de dados, especifique as informações de esquema e de configuração.

  • As informações de esquema de uma tabela de dados incluem o nome da tabela, a definição de chave primária e as configurações de colunas predefinidas.

  • Configure a tabela de dados conforme suas necessidades de negócio. A tabela a seguir descreve os parâmetros de configuração.

    Parâmetro	Descrição
    Coluna de chave primária de autoincremento	Ao criar uma tabela de dados, você pode definir uma coluna de chave primária que não seja a chave de partição como coluna de chave primária de autoincremento. Ao gravar dados na tabela, não é necessário especificar um valor para essa coluna; Tablestore gera o valor automaticamente.
    Versões de dados e TTL	Utilize versões de dados e o recurso de tempo de vida (TTL) para gerenciar dados de forma eficiente, reduzindo o uso de armazenamento e os custos.
    Permitir atualizações	Por padrão, é possível gravar dados em uma tabela de dados chamando a operação de API UpdateRow. Essa configuração pode ser alterada após a criação da tabela. null Se pretende usar o recurso de tempo de vida (TTL) para um índice de pesquisa, é necessário proibir gravações que utilizem a operação de API UpdateRow.
    Throughput de leitura/gravação reservado	Para instâncias de alto desempenho que utilizam o , configure o throughput de leitura/gravação reservado para uma tabela de dados conforme suas necessidades.
    Índice secundário	Tablestore oferece índices secundários locais e globais para atender a requisitos de consulta com diferentes garantias de consistência de leitura. É possível criar um ou mais índices secundários ao criar uma tabela de dados. null Para usar um índice secundário, predefina uma ou mais colunas que não sejam de chave primária e seus tipos de dados na tabela de dados. Essas colunas podem ser usadas como colunas de índice ou colunas incluídas no índice. É possível adicionar ou excluir colunas predefinidas após a criação da tabela.
    Criptografia de dados	Tablestore oferece criptografia de dados em repouso para garantir a segurança dos dados. Configure a criptografia de dados ao criar uma tabela de dados.
    Transação local	Após ativar transações locais para uma tabela de dados, você pode criar uma transação local dentro de um único valor de chave de partição e realizar operações de leitura e gravação nos dados dessa transação. null É possível ativar transações locais para uma tabela de dados usando o console do Tablestore ou o Tablestore SDK for Java 5.11.0 ou posterior. Se não ativou as transações locais durante a criação da tabela e precisa do recurso posteriormente, envie um ticket para ativá-lo.

• Atualizar configuração da tabela

  Modifica a configuração de uma tabela de dados especificada, como tempo de vida (TTL), máximo de versões, desvio máximo de versão e configurações de Stream. Também é possível ajustar o throughput de leitura/gravação reservado para tabelas de dados em instâncias de alto desempenho que utilizam o.

• Listar nomes de tabelas

  Recupera os nomes de todas as tabelas de dados na instância atual.

• Consultar descrição da tabela

  Consulta informações sobre uma tabela de dados especificada, como esquema e detalhes de throughput de leitura/gravação reservado.

• Excluir uma tabela de dados

  Exclui uma tabela de dados especificada.

Criar uma tabela de dados

Siga estas etapas para criar uma tabela de dados no console do Tablestore.

1. Acesse a página Instance Management.

   1. Faça login no console do Tablestore.

   2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

   3. Na página Overview, clique no alias de uma instância ou clique em Instance Management na coluna Actions da instância.

2. Na aba Instance Details, clique em Create Table.

3. Na caixa de diálogo Create Table, configure os parâmetros conforme descrito na tabela a seguir.

   Parâmetro	Descrição
   Nome da tabela	O nome da tabela de dados, que deve ser exclusivo dentro de uma instância. O nome deve ter de 1 a 255 bytes e pode conter letras maiúsculas, minúsculas, dígitos e sublinhados (_). O nome deve começar com uma letra ou sublinhado (_).
   Chave primária	Uma ou mais colunas que identificam exclusivamente uma linha na tabela. Insira o nome da chave primária, selecione um tipo de dados e clique em Add Primary Key Column para adicionar outra coluna de chave primária. É possível definir até quatro colunas de chave primária para uma tabela. A primeira coluna de chave primária é a chave de partição. Não é possível alterar a configuração ou a ordem das colunas de chave primária após a criação da tabela. null Tablestore permite definir uma coluna de chave primária como coluna de chave primária de autoincremento. Uma tabela pode ter apenas uma coluna de chave primária de autoincremento, e a chave de partição não pode ser uma coluna de autoincremento. Se uma coluna de chave primária estiver configurada como autoincremento, não é necessário especificar seu valor ao gravar uma linha; Tablestore gera automaticamente um valor exclusivo e estritamente crescente dentro da chave de partição. O nome da chave primária deve ter de 1 a 255 bytes e pode conter letras maiúsculas, minúsculas, dígitos e sublinhados (_). O nome deve começar com uma letra ou sublinhado (_). O tipo de dados de uma chave primária pode ser STRING, INTEGER ou BINARY.
   Permitir atualizações	Especifica se é permitido gravar dados chamando a operação de API UpdateRow. Se esse parâmetro não estiver definido ou estiver definido como Yes, os dados podem ser gravados por meio do UpdateRow. Para usar o recurso de tempo de vida (TTL) de um índice de pesquisa, defina esse parâmetro como No. Isso proíbe gravações que utilizem a operação de API UpdateRow.
   Criptografia	Especifica se a criptografia de dados em repouso deve ser ativada. Por padrão, esse recurso está desativado. Para ativá-lo, habilite o botão Encryption. null A criptografia de dados em repouso não pode ser desativada após a ativação. Prossiga com cautela.
   Tipo de criptografia	O tipo de criptografia de dados. Esse parâmetro é obrigatório somente quando o botão Encryption está ativado. Valores válidos: CMK of KMS: Tablestore BYOK-based Key: Tablestore null Antes de usar a opção BYOK, crie uma chave de software no console do KMS e depois crie uma função personalizada e configure suas permissões. Para mais informações, consulte Criptografia de dados.
   ID da chave	O ID da chave. Esse parâmetro é obrigatório somente quando o Encryption Type está definido como BYOK-based Key.
   ARN da função	O Alibaba Cloud Resource Name (ARN) da função. Esse parâmetro é obrigatório somente quando o Encryption Type está definido como BYOK-based Key.

4. (Opcional) Na caixa de diálogo Create Table, defina configurações avançadas ou crie um índice secundário.

   Realize esta etapa se precisar definir configurações avançadas para a tabela de dados, como tempo de vida (TTL), ou criar um índice secundário.

   Parâmetros avançados

   Para gerenciar o período de retenção dos dados na tabela, especifique um tempo de vida (TTL). Para manter várias versões de dados para a mesma chave primária, especifique o número máximo de versões. Para mais informações, consulte Versões de dados e TTL.

   Para instâncias de alto desempenho no modo CU, especifique o throughput de leitura ou gravação reservado da tabela de dados para reduzir custos. Para mais informações, consulte Throughput de leitura/gravação reservado.

   1. Ative o botão Advanced Settings.

   2. Configure os parâmetros avançados conforme descrito na tabela a seguir.

      Parâmetro	Descrição
      Tempo de vida	O período de retenção de dados, em segundos. Quando os dados excedem esse período, o sistema exclui automaticamente os dados expirados. O valor deve ser um número inteiro maior ou igual a 86400 (um dia), ou -1. O valor -1 indica que os dados nunca expiram.
      Máximo de versões	O número máximo de versões que podem ser retidas para cada coluna de atributo. Se o número de versões de dados em uma coluna de atributo exceder esse valor, o sistema exclui automaticamente as versões mais antigas. O valor deve ser um número inteiro diferente de zero.
      Desvio máximo de versão	O desvio máximo permitido entre uma versão de dados especificada e o horário atual do sistema, em segundos. Esse valor deve ser um número inteiro positivo. Uma operação de gravação é bem-sucedida somente se a versão especificada para cada coluna estiver dentro do desvio permitido a partir do horário de gravação. O intervalo válido de versão para uma coluna de atributo é [max{WriteTime - MaxVersionOffset, WriteTime - TTL}, WriteTime + MaxVersionOffset).
      Throughput de leitura reservado	Esse parâmetro é compatível apenas com instâncias de alto desempenho que utilizam o . O throughput de leitura ou gravação reservado para a tabela de dados. O valor deve ser um número inteiro de 0 a 100.000. A unidade é unidade de capacidade (CU). Se você definir o Reserved Read Throughput ou o Reserved Write Throughput com um valor maior que 0, o Tablestore aloca e reserva os recursos correspondentes para a tabela de dados. Após a criação da tabela, a cobrança pelo throughput reservado começa imediatamente. Se você definir o Reserved Read Throughput ou o Reserved Write Throughput como 0, o Tablestore não aloca nem reserva recursos para a tabela de dados.
      Throughput de gravação reservado
      Ativar transação local	O recurso de transação local é desativado por padrão. Para realizar operações de leitura e gravação atômicas em uma ou mais linhas dentro da mesma partição, ative o botão Enable Local Transaction.
      Ativar suporte a versão de linha	O suporte a versão de linha é desativado por padrão. Para usar uma tabela global, ative o botão Enable Row Versioning. Não é possível desativar essa configuração após a ativação. As seguintes limitações se aplicam quando o suporte a versão de linha está ativado: Uma única linha pode ter no máximo 256 colunas. Não é possível especificar manualmente os números de versão ao gravar dados. Os números de versão são gerados automaticamente pelo sistema. Ao realizar uma operação de atualização, o sistema precisa primeiro ler a versão atual da linha, o que introduz uma pequena carga adicional de leitura.
      Configuração rápida para tabela global	Ao usar uma tabela global, ative o botão Quick Set Global Table Dependency. O sistema modifica automaticamente as configurações relacionadas à tabela global. As alterações de configuração são as seguintes: Time To Live: -1 Max Versions: 1 Max Version Offset: 2147483647 Enable Row Version Support: Enabled

   Configurar um índice secundário

   Quando uma aplicação precisa consultar dados com base em diferentes atributos, utilize esses atributos como colunas de chave primária de um índice secundário para possibilitar consultas rápidas. Para mais informações, consulte índice secundário.

   1. Ative o botão Create a secondary index.

   2. Clique em Add e insira o nome e selecione o tipo de dados da coluna predefinida.

      O nome de uma coluna predefinida deve ter de 1 a 255 bytes e pode conter letras maiúsculas, minúsculas, dígitos e sublinhados (_). Deve começar com uma letra ou sublinhado (_).

      O tipo de dados de uma coluna predefinida pode ser STRING, INTEGER, BINARY, FLOAT ou BOOLEAN.

   3. Clique em Add Secondary Index, insira o nome do índice, selecione a chave primária do índice e, opcionalmente, selecione colunas predefinidas e um tipo de índice.

      null

      O nome do índice não pode ser igual ao nome da tabela de dados. Tanto o nome do índice quanto o nome da tabela de dados devem ser exclusivos dentro da instância.

      O nome do índice deve ter de 1 a 255 bytes e pode conter letras maiúsculas, minúsculas, dígitos e sublinhados (_). Deve começar com uma letra ou sublinhado (_).

      • A Primary Key pode ser composta pelas colunas de chave primária e colunas predefinidas da tabela de dados. É possível selecionar várias colunas. A Pre-defined Column pode ser selecionada somente dentre as colunas predefinidas da tabela de dados. É possível selecionar várias colunas, mas não podem coincidir com nenhuma coluna de chave primária do índice.

      • O Index Type pode ser Global ou Local.

        null

        A primeira coluna de chave primária de um índice secundário global pode ser qualquer coluna de chave primária ou coluna predefinida. A primeira coluna de chave primária de um índice secundário local deve ser a mesma que a primeira coluna de chave primária da tabela de dados.

        Um índice secundário global sincroniza de forma assíncrona os dados das colunas indexadas e colunas de chave primária da tabela de dados para a tabela de índice. A latência de sincronização geralmente é da ordem de milissegundos. Um índice secundário local sincroniza de forma síncrona os dados das colunas indexadas e colunas de chave primária da tabela de dados para a tabela de índice. Após gravar dados na tabela de dados, eles ficam imediatamente disponíveis para consulta na tabela de índice.

5. Clique em Create.

Gerenciar tabelas de dados

Realize as operações a seguir para gerenciar suas tabelas de dados conforme necessário.

Desenvolvimento e integração

Utilize os seguintes SDKs ou o Tablestore CLI para realizar operações de tabela de dados.