Tablestore:Operações de tabela de dados

Observações de uso

• Crie 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, a nova tabela torna-se acessível cerca de um minuto depois.

• Os recursos de coluna de chave primária com incremento automático e transação local são incompatíveis. Se você configurar uma coluna de chave primária com incremento automático ao criar uma tabela de dados, o recurso de transação local não terá efeito, mesmo que esteja ativado.

Recursos

• Criar uma tabela de dados

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

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

  • Configure a tabela de dados de acordo com os requisitos do seu negócio. A tabela a seguir descreve os parâmetros de configuração.

    Parâmetro	Descrição
    Auto-increment primary key column	Durante a criação da tabela de dados, defina uma coluna de chave primária que não seja chave de partição como coluna de chave primária com incremento automático. Ao gravar dados na tabela, não é necessário especificar um valor para essa coluna; o Tablestore gera o valor automaticamente.
    Data versions and TTL	Utilize versões de dados e o recurso time to live (TTL) para gerenciar dados com eficiência, reduzindo o uso e os custos de armazenamento.
    Permitir atualizações	Por padrão, a gravação de dados em uma tabela ocorre por meio da operação de API UpdateRow. Altere essa configuração após a criação da tabela. Importante Caso pretenda usar o recurso time to live (TTL) para um índice de pesquisa, proíba gravações que utilizem a operação de API UpdateRow.
    Reserved read/write throughput	Para instâncias de alto desempenho que usam o , configure o throughput reservado de leitura/gravação da tabela de dados conforme necessário.
    Secondary index	O Tablestore oferece índices secundários locais e globais para atender a requisitos de consulta com diferentes garantias de consistência de leitura. Crie um ou mais índices secundários durante a criação da tabela de dados. Nota Para utilizar um índice secundário, predefina uma ou mais colunas que não sejam de chave primária e seus tipos de dados na tabela. Essas colunas podem servir como colunas de índice ou colunas incluídas no índice. Adicione ou exclua colunas predefinidas após a criação da tabela.
    Data encryption	O Tablestore fornece criptografia de dados em repouso para garantir a segurança das informações. Configure a criptografia de dados ao criar uma tabela de dados.
    Local transaction	Após ativar transações locais para uma tabela de dados, crie uma transação local dentro de um único valor de chave de partição e execute operações de leitura e gravação nos dados dessa transação. Importante Ative 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 você não ativou transações locais durante a criação da tabela, mas precisar do recurso posteriormente, abra um ticket para solicitar a ativação.

• Atualizar configuração da tabela

  Modifica a configuração de uma tabela de dados específica, como time to live (TTL), número máximo de versões, deslocamento máximo de versão e configurações de Stream. Também permite ajustar o throughput reservado de leitura/gravação para tabelas de dados em instâncias de alto desempenho que usam 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 específica, incluindo esquema e detalhes de throughput reservado de leitura/gravação.

• Excluir uma tabela de dados

  Exclui uma tabela de dados especificada.

Criar uma tabela de dados

Siga as etapas abaixo 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 em o 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	Nome da tabela de dados, que deve ser exclusivo dentro de uma instância. O nome deve ter entre 1 e 255 bytes e pode conter letras maiúsculas, minúsculas, dígitos e sublinhados (_). Deve começar com uma letra ou um sublinhado (_).
   Chave primária	Uma ou mais colunas que identificam exclusivamente uma linha na tabela. Insira um nome de chave primária, selecione um tipo de dados e clique em Add Primary Key Column para adicionar outra coluna de chave primária. Defina 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. Importante O Tablestore permite definir uma coluna de chave primária como coluna de chave primária com incremento automático. Uma tabela pode ter apenas uma coluna de chave primária com incremento automático, e a chave de partição não pode ser uma coluna de incremento automático. Se uma coluna de chave primária estiver definida como incremento automático, não será necessário especificar seu valor ao gravar uma linha; o Tablestore gera automaticamente um valor exclusivo e estritamente crescente dentro da chave de partição. O nome da chave primária deve ter entre 1 e 255 bytes e pode conter letras maiúsculas, minúsculas, dígitos e sublinhados (_). Deve começar com uma letra ou um sublinhado (_). O tipo de dados de uma chave primária pode ser STRING, INTEGER ou BINARY.
   Permitir atualizações	Define se é permitido gravar dados chamando a operação de API UpdateRow. Se este parâmetro não estiver definido ou estiver definido como Yes, os dados poderão ser gravados via UpdateRow. Para usar o recurso time to live (TTL) de um índice de pesquisa, defina este parâmetro como No. Isso proíbe gravações que utilizem a operação de API UpdateRow.
   Criptografia	Define se a criptografia de dados em repouso deve ser ativada. Por padrão, esse recurso está desativado. Para ativá-lo, ligue a chave Encryption. Importante A criptografia de dados em repouso não pode ser desativada após ser habilitada. Proceda com cautela.
   Tipo de criptografia	Tipo de criptografia de dados. Este parâmetro é obrigatório apenas se você ligar a chave Encryption. Valores válidos: CMK of KMS: Tablestore BYOK-based Key: Tablestore Importante Antes de usar a opção BYOK, crie uma chave de software no console do KMS e, em seguida, crie uma função personalizada e configure suas permissões. Para mais informações, consulte Data encryption.
   ID da chave	ID da chave. Este parâmetro é obrigatório apenas se Encryption Type estiver definido como BYOK-based Key.
   ARN da função	Alibaba Cloud Resource Name (ARN) da função. Este parâmetro é obrigatório apenas se Encryption Type estiver definido como BYOK-based Key.

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

   Execute esta etapa se precisar configurar definições avançadas para a tabela de dados, como time to live (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 time to live (TTL). Para manter múltiplas versões de dados para a mesma chave primária, defina o número máximo de versões. Para mais informações, consulte Data versions and TTL.

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

   1. Ligue a chave Advanced Settings.

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

      Parâmetro	Descrição
      Time to live	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	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.
      Deslocamento máximo de versão	Desvio máximo permitido entre uma versão de dados especificada e a hora atual do sistema, em segundos. Este valor deve ser um número inteiro positivo. Uma operação de gravação só é bem-sucedida se a versão especificada para cada coluna estiver dentro do deslocamento permitido em relação ao momento da gravação. O intervalo de versão válido para uma coluna de atributo é [max{WriteTime - MaxVersionOffset, WriteTime - TTL}, WriteTime + MaxVersionOffset).
      Throughput reservado de leitura	Este parâmetro é suportado apenas para instâncias de alto desempenho que usam o . Throughput reservado de leitura ou gravação para a tabela de dados. O valor deve ser um número inteiro de 0 a 100.000. A unidade é capacity unit (CU). Se você definir Reserved Read Throughput ou 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, o faturamento do throughput reservado começa imediatamente. Se você definir Reserved Read Throughput ou Reserved Write Throughput como 0, o Tablestore não aloca nem reserva recursos para a tabela de dados.
      Throughput reservado de gravação
      Ativar transação local	O recurso de transação local vem desativado por padrão. Para executar operações atômicas de leitura e gravação em uma ou mais linhas dentro da mesma partição, ligue a chave Enable Local Transaction.
      Ativar suporte a versão de linha	O suporte a versão de linha vem desativado por padrão. Para usar um global table, ligue a chave 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 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 um global table, ligue a chave Quick Set Global Table Dependency. O sistema modifica automaticamente as configurações relacionadas para a 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 permitir consultas rápidas. Para mais informações, consulte secondary index.

   1. Ligue a chave Create a secondary index.

   2. Clique em Add, insira um nome e selecione um tipo de dados para a coluna predefinida.

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

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

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

      Importante

      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.

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

      • A Primary Key pode consistir nas colunas de chave primária da tabela de dados e em colunas predefinidas. Selecione várias colunas. A Pre-defined Column só pode ser selecionada a partir das colunas predefinidas da tabela de dados. Selecione várias colunas, desde que não sejam iguais a nenhuma das colunas de chave primária do índice.

      • O Index Type pode ser Global ou Local.

        Importante

        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 igual à primeira coluna de chave primária da tabela de dados.

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

5. Clique em Create.

Gerenciar tabelas de dados

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

Desenvolvimento e integração

Utilize os SDKs a seguir ou o Tablestore CLI para executar operações de tabela de dados.