Gerenciar tabelas de dados usando a interface de linha de comando - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Uma instalação da CLI do Tablestore com credenciais de acesso configuradas. Para mais informações, consulte Tablestore CLI.
Uma instância do Tablestore. Para mais informações, consulte Operações de instância.

Criar uma tabela

Para criar uma tabela de dados, especifique as colunas de chave primária e, opcionalmente, configure o TTL dos dados e os limites de versão. Como alternativa, crie uma tabela a partir de um arquivo de configuração JSON.

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

Parâmetro	Obrigatório	Descrição
`-t, --table`	Sim	O nome da tabela de dados.
`-k, --pk`	Sim	As definições das colunas de chave primária no formato de array JSON. Cada elemento contém os seguintes campos: `c` (obrigatório): O nome da coluna de chave primária. `t` (obrigatório): O tipo da coluna de chave primária. Valores válidos: `string`, `integer`, `binary`. `opt` (opcional): Valor padrão: `none`. Defina como `auto` para usar a coluna como uma coluna de chave primária de incremento automático. Para mais informações sobre colunas de chave primária de incremento automático, consulte Coluna de chave primária de incremento automático. Nota Não é necessário definir colunas de atributo ao criar uma tabela de dados. Cada linha no Tablestore pode ter colunas de atributo diferentes. Os nomes das colunas de atributo são especificados quando você grava dados. Uma tabela de dados suporta até 4 colunas de chave primária. A primeira coluna de chave primária é a chave de partição por padrão. As configurações de chave primária não podem ser modificadas após a criação da tabela.
`-m, --model`	Não	O tipo de tabela. Valor padrão: `widecolumn` (tabela de dados). Para criar uma tabela de séries temporais, consulte Modelo TimeSeries.
`--ttl`	Não	O tempo de vida (TTL) dos dados, em segundos. Valor padrão: `-1` (os dados nunca expiram). O valor deve ser maior ou igual a 86400 (um dia) ou igual a -1.
`--version`	Não	O número máximo de versões. Valor padrão: `1`. O valor deve ser um número inteiro diferente de zero. Importante O Tablestore não impõe um limite rígido ao número máximo de versões. No entanto, para obter desempenho e usabilidade ideais, mantenha este valor em 500 ou menos.
`--read_cu`	Não	O throughput reservado de leitura ou gravação, em unidades de capacidade (CUs). Valor padrão: `0` (pagamento conforme o uso). Nota Esta configuração é suportada apenas para tabelas de dados em instâncias de alto desempenho. Se o throughput reservado de leitura ou gravação for definido com um valor diferente de zero, você será cobrado independentemente de solicitações de leitura ou gravação serem enviadas.
`--write_cu`	Não
`-d, --defined`	Não	Colunas predefinidas no formato de array JSON. Obrigatório para índices secundários. Cada elemento contém os seguintes campos: `c` (obrigatório): O nome da coluna predefinida. `t` (obrigatório): O tipo da coluna predefinida. Valores válidos: `string`, `integer`, `binary`, `double`, `bool`. Nota Uma tabela de dados suporta até 32 colunas predefinidas por padrão.
`--stream_enable`	Não	Especifica se o Stream deve ser ativado. Valor padrão: `false`.
`--stream_expire`	Não	O período de expiração dos dados do Stream, em horas. Valor padrão: `24`.
`-i, --input`	Não	O caminho para um arquivo de configuração JSON para criar a tabela.

Crie uma tabela de dados básica:

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

Crie uma tabela de dados com uma coluna de incremento automático e TTL:

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

Crie uma tabela de dados com colunas predefinidas para índices secundários:

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

Crie uma tabela de dados a partir de um arquivo de configuração:

Windows

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

Linux and macOS

create -i /localpath/filename.json

Exemplo de arquivo de configuração:

{
    "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
    }
}

Selecionar uma tabela

Selecione uma tabela de dados para realizar operações subsequentes nos dados.

use --wc -t tableName

Parâmetro	Obrigatório	Descrição
`--wc`	Não	Selecione uma tabela de dados de coluna larga.
`-t, --table`	Sim	O nome da tabela.

Exemplo:

use --wc -t mytable

Listar nomes de tabelas

Liste os nomes das tabelas na instância atual. Filtre os resultados por tipo de tabela conforme necessário.

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

Parâmetro	Obrigatório	Descrição
`-w, --wc`	Não	Lista apenas tabelas de dados.
`-a, --all`	Não	Lista todos os tipos de tabela.
`-d, --detail`	Não	Exibe informações detalhadas da tabela.

Exemplo:

list --wc

Visualizar detalhes da tabela

Visualize os detalhes de configuração de uma tabela de dados ou tabela de índice.

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

Parâmetro	Obrigatório	Descrição
`-t, --table`	Não	O nome da tabela de dados ou tabela de índice. Se omitido, assume como padrão a tabela selecionada pelo comando `use`.
`-f, --print_format`	Não	O formato de saída. Valores válidos: `json` (padrão) e `table`.
`-o, --output`	Não	Salva a saída em um arquivo local.

Exemplo:

desc -t mytable

Atualizar uma tabela

Atualize a configuração de uma tabela de dados, como TTL dos dados, número máximo de versões e throughput reservado.

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

Parâmetro	Obrigatório	Descrição
`-t, --table`	Sim	O nome da tabela. Se uma tabela já estiver selecionada com `use`, este parâmetro é opcional.
`--ttl`	Não	O tempo de vida (TTL) dos dados, em segundos. O valor deve ser maior ou igual a 86400 (um dia) ou igual a -1 (os dados nunca expiram).
`--version`	Não	O número máximo de versões. O valor deve ser um número inteiro diferente de zero.
`--read_cu`	Não	O throughput reservado de leitura ou gravação, em unidades de capacidade (CUs). Esta configuração é suportada apenas para instâncias de alto desempenho.
`--write_cu`	Não
`--stream_enable`	Não	Especifica se o Stream deve ser ativado.
`--stream_expire`	Não	O período de expiração dos dados do Stream, em horas.
`--disallow_update`	Não	Especifica se as operações de atualização devem ser desativadas.

Defina o TTL para um dia e o número máximo de versões para 1:

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

Excluir uma tabela

Exclua uma tabela de dados específica.

drop -t tableName [-y]

Parâmetro	Obrigatório	Descrição
`-t, --table`	Sim	O nome da tabela.
`-y, --yes`	Não	Ignora o prompt de confirmação e exclui a tabela diretamente.

Exemplo:

drop -t mytable -y