Crie e faça a gestão de tabelas

Consola

Para criar uma nova tabela numa instância:

1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

   Abra a lista de instâncias

2. Clique na instância cujas tabelas quer ver.

3. Clique em Tabelas no painel esquerdo.

   A página Tabelas apresenta uma lista de tabelas na instância.

4. Introduza um ID da tabela para a tabela.

5. Adicione famílias de colunas (opcional).

   Pode adicionar colunas agora ou mais tarde. Uma tabela tem de ter, pelo menos, uma família de colunas antes de poder escrever dados na mesma. Uma tabela tem de ter, pelo menos, uma família de colunas antes de poder escrever dados na mesma ou ler um fluxo de alterações a partir da mesma.

6. Opcional: ative uma stream de alterações para a tabela. Antes de ativar uma stream de alterações, certifique-se de que compreende as implicações, incluindo o aumento dos custos de armazenamento e os requisitos de utilização do perfil da app. Para rever estes detalhes, consulte a Vista geral das streams de alterações.

   1. Selecione Ativar stream de alterações.

   2. No campo Tempo de validade, introduza um número de 1 a 7 para especificar o número de dias durante os quais os dados do fluxo de alterações devem ser retidos.

   3. Clique em Criar.

7. Opcional: se não quiser que o Bigtable crie uma cópia de segurança diária da tabela, desmarque a caixa de verificação junto a Ativar cópia de segurança automática. Para mais informações, consulte o artigo Use uma cópia de segurança automática.

8. Clique em Criar tabela.

gcloud

Para criar uma tabela, execute o seguinte comando. Consulte gcloud bigtable instances tables create para ver uma lista completa de opções.

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN-FAMILIES

Substitua o seguinte:

• TABLE_ID: um ID exclusivo para a nova tabela
• INSTANCE_ID: o ID da instância
• PROJECT_ID: o projeto que vai conter a nova tabela
• COLUMN-FAMILIES: uma lista separada por vírgulas de nomes de famílias de colunas. Pode adicionar mais famílias de colunas mais tarde.

Opcional:

• Para proteger a tabela contra eliminação, acrescente o comando com --deletion-protection. Se não aplicar esta definição, a tabela pode ser eliminada. Também pode permitir explicitamente a eliminação de tabelas acrescentando --no-deletion-protection.

• Para ativar uma stream de alterações para a tabela, especifique um período de retenção para os dados da stream de alterações. Antes de ativar uma stream de alterações, certifique-se de que compreende as implicações, incluindo o aumento dos custos de armazenamento e os requisitos de utilização do perfil da app. Para rever estes detalhes, consulte a Vista geral das streams de alterações.

  --change-stream-retention-period=RETENTION_PERIOD
  

  Substitua RETENTION_PERIOD pela duração durante a qual o Bigtable deve reter os dados da stream de alterações para a tabela. O tempo tem de ser entre um e sete dias. As unidades aceitáveis são dias (d), horas (h), minutos (m) e segundos (s). Exemplos: 48h ou 6d

• Para permitir que o Bigtable crie uma cópia de segurança diária da sua tabela e retenha cada cópia de segurança durante o período de retenção predefinido de sete dias, use a flag --enable-automated-backup quando criar a tabela.

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN-FAMILIES \
      --enable-automated-backup
  

  Para configurar um período de retenção diferente, use a flag --automated-backup-retention-period em vez da flag --enable-automated-backup e forneça um valor até 90 dias, expresso como um número com uma unidade de m, h ou d (minutos, horas ou dias), como 15d para 15 dias.

cbt

Use o seguinte comando, substituindo TABLE_NAME pelo nome da sua tabela. Não pode usar a cbt CLI para criar uma tabela com uma stream de alterações ativada.

cbt createtable TABLE_ID

Opcional: para criar uma família de colunas agregadas na tabela, acrescente o nome da família de colunas com o tipo de agregação. O seguinte cria uma família de colunas agregada com uma política de recolha de lixo de never.

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

Substitua o seguinte:

• TABLE_ID: um ID exclusivo para a nova tabela
• FAMILY_NAME: : uma lista separada por vírgulas de nomes de famílias de colunas. Pode adicionar mais famílias de colunas mais tarde.
• TYPE: o tipo de agregação. Tem de ser intsum, intmin, intmax ou inthll.

Consola

Não pode dividir previamente as linhas quando cria uma tabela através da Google Cloud consola.

gcloud

Para dividir uma tabela pela chave da linha, execute o seguinte comando. Consulte gcloud bigtable instances tables create para ver uma lista completa de opções.

gcloud bigtable instances tables create TABLE_ID\
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN-FAMILIES \
    --splits=SPLITS

Substitua o seguinte:

• TABLE_ID: um ID exclusivo para a nova tabela
• INSTANCE_ID: o ID da instância
• PROJECT_ID: o projeto que vai conter a nova tabela
• COLUMN-FAMILIES: uma lista separada por vírgulas de nomes de famílias de colunas. Pode adicionar mais famílias de colunas mais tarde.
• SPLITS: as chaves de linhas onde a tabela deve ser dividida inicialmente, por exemplo, 10,20.

cbt

Para dividir previamente uma tabela com base na chave da linha, use a seguinte sintaxe para criar a tabela. Substitua [TABLE_NAME] pelo nome da tabela e [SPLITS] por uma lista separada por vírgulas de prefixos de chaves de linhas a usar para as pré-divisões.

```none
cbt createtable [TABLE_NAME] splits=[SPLITS]
```

Por exemplo, para dividir previamente a tabela my-table em chaves de linhas que começam com 10 e 20:

```none
cbt createtable my-table splits=10,20
```

Consola

1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

   Abra a lista de instâncias

2. Clique na instância cujas tabelas quer ver.

3. Clique em Tabelas no painel esquerdo.

   A página Tabelas apresenta uma lista de tabelas na instância.

4. Clique em edit Editar para a tabela que quer modificar.

5. Para cada família de colunas que quer adicionar, conclua o seguinte:

   1. Clique em Adicionar família de colunas.
   2. Indique um identificador exclusivo para a família de colunas.
   3. Defina a política de recolha de lixo para a família de colunas.
   4. Clique em Concluído.
   5. Clique em Guardar.

gcloud

Não pode usar a CLI gcloud para adicionar famílias de colunas a uma tabela.

cbt

Para adicionar uma família de colunas a uma tabela, use o seguinte comando:

cbt createfamily TABLE_ID FAMILY_NAME

Por exemplo, para adicionar as famílias de colunas cf1 e cf2 à tabela my-table:

cbt createfamily my-table cf1
cbt createfamily my-table cf2

Opcional: para adicionar uma família de colunas agregadas à tabela, acrescente o nome da família de colunas com o tipo de agregação. O comando seguinte cria uma tabela com uma família de colunas agregadas com uma política de recolha de lixo de never.

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

Substitua o seguinte:

• TABLE_ID: o ID da tabela
• FAMILY_NAME: : uma lista separada por vírgulas de nomes de famílias de colunas. Pode adicionar mais famílias de colunas mais tarde.
• TYPE: o tipo de agregação. Tem de ser intsum, intmin, intmax ou inthll.

Consola

1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

   Abra a lista de instâncias

2. Clique na instância cujas tabelas quer ver.

3. Clique em Tabelas no painel esquerdo.

   A página Tabelas apresenta uma lista de tabelas na instância.

4. Clique em edit Editar para a tabela que quer modificar.

5. Para cada família de colunas que quer eliminar, conclua o seguinte:

   1. Passe o cursor do rato sobre a linha da família de colunas que quer eliminar.
   2. Clique em delete.

6. Clique em Guardar.

7. Para confirmar que compreende que a eliminação de uma família de colunas é permanente e que todos os dados na família de colunas serão eliminados, escreva "Eliminar famílias de colunas" no campo de texto.

8. Clique em Confirm.

gcloud

Não pode usar a CLI gcloud para eliminar famílias de colunas de uma tabela.

cbt

Para eliminar uma família de colunas de uma tabela, use o seguinte comando, substituindo [TABLE_NAME] pelo nome da tabela e [FAMILY_NAME] pelo nome da família de colunas:

cbt deletefamily [TABLE_NAME] [FAMILY_NAME]

Por exemplo, para eliminar a família de colunas cf2 da tabela my-table:

cbt deletefamily my-table cf2

Consola

Para ver uma lista de tabelas numa instância:

1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

   Abra a lista de instâncias

2. Clique na instância cujas tabelas quer ver.

3. Clique em Tabelas no painel esquerdo.

   A página Tabelas apresenta uma lista de tabelas na instância.

   • Clique na seta junto ao ID da tabela para expandir uma lista de replicações da tabela.
   • Clique em Ver métricas junto ao nome de uma tabela para ver os dados de estatísticas do sistema da tabela.

gcloud

Para ver uma lista de tabelas, execute o comando gcloud bigtable instances tables list.

gcloud bigtable instances tables list --instances=INSTANCE_IDS

Substitua o seguinte:

• INSTANCE_IDS: uma lista de IDs de instâncias separados por vírgulas.

cbt

Para ver uma lista de tabelas numa instância, execute o seguinte comando:

    cbt ls INSTANCE_ID

Substitua o seguinte:

• INSTANCE_ID: O identificador permanente da instância.

C++

namespace cbt = ::google::cloud::bigtable;
namespace cbta = ::google::cloud::bigtable_admin;
using ::google::cloud::StreamRange;
[](cbta::BigtableTableAdminClient admin, std::string const& project_id,
   std::string const& instance_id) {
  std::string instance_name = cbt::InstanceName(project_id, instance_id);

  google::bigtable::admin::v2::ListTablesRequest r;
  r.set_parent(instance_name);
  r.set_view(google::bigtable::admin::v2::Table::NAME_ONLY);

  StreamRange<google::bigtable::admin::v2::Table> tables =
      admin.ListTables(std::move(r));
  for (auto& table : tables) {
    if (!table) throw std::move(table).status();
    std::cout << table->name() << "\n";
  }
}

C#

// Lists tables in intance.
// Initialize request argument(s).
ListTablesRequest request = new ListTablesRequest
{
    ParentAsInstanceName = s_instanceName
};
try
{
    // Make the request.
    PagedEnumerable<ListTablesResponse, Table> response = bigtableTableAdminClient.ListTables(request);

}
catch (Exception ex)
{
    Console.WriteLine($"Error listing tables {ex.Message}");
}

Java

// Lists tables in the current instance.
try {
  List<String> tableIds = adminClient.listTables();
  for (String tableId : tableIds) {
    System.out.println(tableId);
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

// List tables in current project
const [tables] = await adminClient.listTables({parent: instance.name});
tables.forEach(table => {
  console.log(table.name);
});

PHP

use Google\Cloud\Bigtable\Admin\V2\Client\BigtableInstanceAdminClient;
use Google\Cloud\Bigtable\Admin\V2\Client\BigtableTableAdminClient;
use Google\Cloud\Bigtable\Admin\V2\ListTablesRequest;

/**
 * List tables in an instance
 *
 * @param string $projectId The Google Cloud project ID
 * @param string $instanceId The ID of the Bigtable instance
 */
function list_tables(
    string $projectId,
    string $instanceId
): void {
    $instanceAdminClient = new BigtableInstanceAdminClient();
    $tableAdminClient = new BigtableTableAdminClient();

    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);

    printf('Listing Tables:' . PHP_EOL);
    $listTablesRequest = (new ListTablesRequest())
        ->setParent($instanceName);
    $tables = $tableAdminClient->listTables($listTablesRequest)->iterateAllElements();
    $tables = iterator_to_array($tables);
    if (empty($tables)) {
        print('No table exists.' . PHP_EOL);
        return;
    }
    foreach ($tables as $table) {
        print($table->getName() . PHP_EOL);
    }
}

Python

tables = instance.list_tables()
print("Listing tables in current project...")
if tables != []:
    for tbl in tables:
        print(tbl.table_id)
else:
    print("No table exists in current project...")

Ruby

# instance_id = "my-instance"
bigtable.tables(instance_id).all.each do |t|
  puts "Table: #{t.name}"
end

Consola

Para ver informações sobre uma tabela:

1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

   Abra a lista de instâncias

2. Clique na instância cujas tabelas quer ver.

3. Clique em Tabelas no painel esquerdo.

   A página Tabelas apresenta uma lista de tabelas na instância. Para cada tabela, a Google Cloud consola apresenta o número de clusters em que a tabela está armazenada, o estado da tabela, a utilização do armazenamento e os identificadores de todas as cópias de segurança atuais da tabela.

4. Para ver os nomes das famílias de colunas da tabela, clique em edit. Para fechar o painel Editar tabela, clique em Cancelar.

5. Para ver detalhes adicionais acerca da tabela, incluindo métricas ao nível da tabela e o estado de replicação, clique no nome da tabela.

gcloud

Para ver informações sobre uma tabela, execute o comando gcloud bigtable instances tables describe.

gcloud bigtable instances tables describe TABLE_ID \
    --instance=INSTANCE_ID

Substitua o seguinte:

• TABLE_ID: um ID exclusivo da tabela
• INSTANCE_ID: o ID da instância

cbt

Pode usar a CLI cbt para obter uma lista de famílias de colunas existentes numa tabela.

Use o seguinte comando, substituindo [TABLE_NAME] pelo nome da tabela:

cbt ls [TABLE_NAME]

Consola

1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

   Abra a lista de instâncias

2. Clique na instância cujas tabelas quer ver.

3. Clique em Tabelas no painel esquerdo.

   A página Tabelas apresenta uma lista de tabelas na instância.

4. Clique em more_vert para a tabela que quer eliminar.

5. Clique em Eliminar.

6. Para confirmar que reconhece que esta ação elimina a tabela de todos os clusters na instância e que tem apenas sete dias para anular a eliminação da tabela, escreva o ID da tabela na caixa Eliminar tabela.

7. Clique em Eliminar.

gcloud

1. Para eliminar tabelas, execute o comando gcloud bigtable instances tables delete.

   gcloud bigtable instances tables delete TABLE_ID --instance=INSTANCE_ID
   

   Substitua o seguinte:

   • TABLE_ID: o ID exclusivo da tabela
   • INSTANCE_ID: o ID da instância

2. No terminal, introduza y para confirmar a eliminação da tabela.

cbt

Para eliminar uma tabela, use o seguinte comando, substituindo [TABLE_NAME] pelo nome da tabela:

cbt deletetable [TABLE_NAME]

Consola

1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

   Abra a lista de instâncias

2. Clique na instância cujas tabelas quer ver.

3. Clique em Tabelas no painel esquerdo.

   A página Tabelas apresenta uma lista de tabelas na instância.

4. Clique em more_vert junto ao ID da tabela.

5. Para ativar a proteção contra eliminação, clique em Impedir eliminação. Para desativar a proteção contra eliminação, clique em Ativar eliminação. Apenas a opção válida é visível.

gcloud

Para ativar a proteção contra eliminação para uma tabela, execute o comando gcloud bigtable instances table update:

```sh
gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --deletion-protection
```

Para desativar a proteção contra eliminação de uma tabela, execute o seguinte comando:

```sh
gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --no-deletion-protection
```

Substitua o seguinte:

+ TABLE_ID: the unique identifier for the table
+ INSTANCE_ID: the ID of the instance

cbt

Não pode usar a CLI cbt para ativar ou desativar a proteção contra eliminação.