Creazione e gestione delle tabelle

Console

Per creare una nuova tabella in un'istanza:

1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

   Apri l'elenco delle istanze

2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

   La pagina Tables (Tabelle) mostra un elenco delle tabelle nell'istanza.

4. Inserisci un ID tabella per la tabella.

5. (Facoltativo) Aggiungi famiglie di colonne.

   Puoi aggiungere colonne ora o in un secondo momento. Una tabella deve avere almeno una famiglia di colonne prima che tu possa scrivere dati al suo interno. Una tabella deve avere almeno una famiglia di colonne prima che tu possa scrivere dati al suo interno o leggere un stream di variazioni.

6. (Facoltativo) Abilita un flusso di modifiche per la tabella. Prima di attivare un stream di modifiche, assicurati di comprendere le implicazioni, inclusi i costi di archiviazione aumentati e i requisiti di utilizzo del profilo dell'app. Per esaminare questi dettagli, consulta la Panoramica degli stream di modifiche.

   1. Seleziona Attiva flusso di modifiche.

   2. Nel campo Data di scadenza, inserisci un numero compreso tra 1 e 7 per specificare il numero di giorni per i quali devono essere conservati i dati dello stream di modifiche.

   3. Fai clic su Crea.

7. (Facoltativo) Se non vuoi che Bigtable crei un backup giornaliero della tabella, deseleziona la casella di controllo accanto ad Abilita il backup automatico. Per ulteriori informazioni, consulta Utilizzare il backup automatico (anteprima).

8. Fai clic su Crea una tabella.

gcloud

Per creare una tabella, esegui il seguente comando. Consulta gcloud bigtable instances tables create per un elenco completo delle opzioni.

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

Sostituisci quanto segue:

• TABLE_ID: un ID univoco per la nuova tabella
• INSTANCE_ID: l'ID dell'istanza
• PROJECT_ID: il progetto che conterrà la nuova tabella
• COLUMN-FAMILIES: un elenco separato da virgole di nomi di famiglia di colonne. Puoi aggiungere altre famiglie di colonne in un secondo momento.

Facoltativamente,

• Per proteggere la tabella dall'eliminazione, aggiungi al comando --deletion-protection. Se non applichi questa impostazione, la tabella può essere eliminata. Puoi anche consentire esplicitamente l'eliminazione della tabella aggiungendo --no-deletion-protection.

• Per attivare un flusso di modifiche per la tabella, specifica un periodo di conservazione per i dati del flusso di modifiche. Prima di attivare un stream di modifiche, assicurati di comprendere le implicazioni, inclusi i costi di archiviazione aggiuntivi e i requisiti di utilizzo del profilo dell'app. Per esaminare questi dettagli, consulta la Panoramica degli stream di modifiche.

  --change-stream-retention-period=RETENTION_PERIOD
  

  Sostituisci RETENTION_PERIOD con il periodo di tempo per cui Bigtable deve conservare i dati del flusso di modifiche per la tabella. Il periodo di tempo deve essere compreso tra 1 e 7 giorni. Le unità accettabili sono giorni (d), ore (h), minuti (m) e secondi (s). Esempi: 48h o 6d

• Per consentire a Bigtable di creare un backup giornaliero della tabella, attiva il backup automatico (anteprima):

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

cbt

Utilizza il seguente comando, sostituendo TABLE_NAME con il nome della tabella. Non puoi utilizzare cbt CLI per creare una tabella con un flusso di modifiche abilitato.

cbt createtable TABLE_ID

(Facoltativo) Per creare una famiglia di colonne aggregate nella tabella, accoda il nome della famiglia di colonne al tipo di aggregazione. Il seguente codice crea una famiglia di colonne aggregate con un criterio di raccolta del garbage di never.

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

Sostituisci quanto segue:

• TABLE_ID: un ID univoco per la nuova tabella
• FAMILY_NAME: un elenco separato da virgole di nomi di famiglia di colonne. Puoi aggiungere altre famiglie di colonne in un secondo momento.
• TYPE: il tipo di aggregazione. Deve essere intsum, intmin, intmax o inthll.

Console

Non puoi suddividere in anticipo le righe quando crei una tabella utilizzando la console Google Cloud.

gcloud

Per suddividere una tabella in base alla chiave di riga, esegui il seguente comando. Consulta gcloud bigtable instances tables create per un elenco completo delle opzioni.

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

Sostituisci quanto segue:

• TABLE_ID: un ID univoco per la nuova tabella
• INSTANCE_ID: l'ID dell'istanza
• PROJECT_ID: il progetto che conterrà la nuova tabella
• COLUMN-FAMILIES: un elenco separato da virgole di nomi di famiglia di colonne. Puoi aggiungere altre famiglie di colonne in un secondo momento.
• SPLITS: le chiavi di riga in cui la tabella deve essere inizialmente suddivisa, ad esempio 10,20.

cbt

Per predividere una tabella in base alla chiave di riga, utilizza la seguente sintassi per creare la tabella. Sostituisci [TABLE_NAME] con il nome della tabella e [SPLITS] con un elenco separato da virgole di prefissi delle chiavi di riga da utilizzare per le suddivisioni preliminari.

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

Ad esempio, per predividere la tabella my-table in base alle chiavi di riga che iniziano con 10 e 20:

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

Console

1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

   Apri l'elenco delle istanze

2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

   La pagina Tables (Tabelle) mostra un elenco delle tabelle nell'istanza.

4. Fai clic su edit Modifica per la tabella che vuoi modificare.

5. Per ogni famiglia di colonne da aggiungere, completa quanto segue:

   1. Fai clic su Aggiungi famiglia di colonne.
   2. Fornisci un identificatore univoco per la famiglia di colonne.
   3. Imposta il criterio di garbage collection per la famiglia di colonne.
   4. Fai clic su Fine.
   5. Fai clic su Salva.

gcloud

Non puoi utilizzare l'interfaccia alla gcloud CLI per aggiungere famiglie di colonne a una tabella.

cbt

Per aggiungere una famiglia di colonne a una tabella, utilizza il seguente comando:

cbt createfamily TABLE_ID FAMILY_NAME

Ad esempio, per aggiungere le famiglie di colonne cf1 e cf2 alla tabella my-table:

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

(Facoltativo) Per aggiungere una famiglia di colonne aggregate alla tabella, appendi il nome della famiglia di colonne al tipo di aggregazione. Il codice seguente crea una tabella con una famiglia di colonne aggregate con un criterio di garbage collection di never.

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

Sostituisci quanto segue:

• TABLE_ID: l'ID tabella
• FAMILY_NAME: un elenco separato da virgole di nomi di famiglia di colonne. Puoi aggiungere altre famiglie di colonne in un secondo momento.
• TYPE: il tipo di aggregazione. Deve essere intsum, intmin, intmax o inthll.

Console

1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

   Apri l'elenco delle istanze

2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

   La pagina Tables (Tabelle) mostra un elenco delle tabelle nell'istanza.

4. Fai clic su edit Modifica per la tabella che vuoi modificare.

5. Per ogni famiglia di colonne che vuoi eliminare:

   1. Passa il mouse sopra la riga della famiglia di colonne che vuoi eliminare.
   2. Fai clic su delete.

6. Fai clic su Salva.

7. Per confermare di aver compreso che l'eliminazione di una famiglia di colonne è permanente e che tutti i dati al suo interno verranno eliminati, digita "Elimina famiglie di colonne" nel campo di testo.

8. Fai clic su Conferma.

gcloud

Non puoi utilizzare l'interfaccia alla gcloud CLI per eliminare famiglie di colonne da una tabella.

cbt

Per eliminare una famiglia di colonne da una tabella, utilizza il seguente comando, sostituendo [TABLE_NAME] con il nome della tabella e [FAMILY_NAME] con il nome della famiglia di colonne:

cbt deletefamily [TABLE_NAME] [FAMILY_NAME]

Ad esempio, per eliminare la famiglia di colonne cf2 dalla tabella my-table:

cbt deletefamily my-table cf2

Console

Per visualizzare un elenco di tabelle in un'istanza:

1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

   Apri l'elenco delle istanze

2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

   La pagina Tables (Tabelle) mostra un elenco delle tabelle nell'istanza.

   • Fai clic sulla freccia accanto all'ID tabella per espandere un elenco di repliche della tabella.
   • Fai clic su Visualizza metriche accanto al nome di una tabella per visualizzare i dati di monitoraggio della tabella.

gcloud

Per visualizzare un elenco di tabelle, esegui il comando gcloud bigtable instances tables list.

gcloud bigtable instances tables list --instances=INSTANCE_IDS

Sostituisci quanto segue:

• INSTANCE_IDS: un elenco separato da virgole di ID istanza.

cbt

Per visualizzare un elenco di tabelle in un'istanza, esegui il seguente comando:

    cbt ls INSTANCE_ID

Sostituisci quanto segue:

• INSTANCE_ID: l'identificatore permanente dell'istanza.

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 instance.getTables();
tables.forEach(table => {
  console.log(table.id);
});

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

Console

Per visualizzare le informazioni su una tabella:

1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

   Apri l'elenco delle istanze

2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

   La pagina Tables (Tabelle) mostra un elenco delle tabelle nell'istanza. Per ogni tabella, la console Google Cloud mostra il numero di cluster su cui è archiviata, lo stato della tabella, l'utilizzo dello spazio di archiviazione e gli identificatori di eventuali backup attuali della tabella.

4. Per visualizzare i nomi famiglia di colonne per la tabella, fai clic su edit. Per chiudere il riquadro Modifica tabella, fai clic su Annulla.

5. Per visualizzare ulteriori dettagli sulla tabella, tra cui le metriche a livello di tabella e lo stato di replica, fai clic sul nome della tabella.

gcloud

Per visualizzare le informazioni su una tabella, esegui il comando gcloud bigtable instances tables describe.

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

Sostituisci quanto segue:

• TABLE_ID: un ID univoco della tabella
• INSTANCE_ID: l'ID dell'istanza

cbt

Puoi utilizzare cbt CLI per ottenere un elenco delle famiglie di colonne esistenti in una tabella.

Utilizza il seguente comando, sostituendo [TABLE_NAME] con il nome della tabella:

cbt ls [TABLE_NAME]

Console

1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

   Apri l'elenco delle istanze

2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

   La pagina Tables (Tabelle) mostra un elenco delle tabelle nell'istanza.

4. Fai clic su more_vert per la tabella che vuoi eliminare.

5. Fai clic su Elimina.

6. Per confermare di aver compreso che questa azione eliminerà la tabella da tutti i cluster dell'istanza e che hai solo sette giorni di tempo per annullare l'eliminazione della tabella, digita l'ID tabella nella casella di testo.

7. Fai clic su Elimina.

gcloud

1. Per eliminare le tabelle, esegui il comando gcloud bigtable instances tables delete.

   gcloud bigtable instances tables delete --instance=INSTANCE_ID
   

   Sostituisci quanto segue:

   • INSTANCE_ID: l'ID dell'istanza

2. Nel terminale, inserisci y per confermare l'eliminazione della tabella.

cbt

Per eliminare una tabella, utilizza il seguente comando, sostituendo [TABLE_NAME] con il nome della tabella:

cbt deletetable [TABLE_NAME]

Console

1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

   Apri l'elenco delle istanze

2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

   La pagina Tables (Tabelle) mostra un elenco delle tabelle nell'istanza.

4. Fai clic su more_vert accanto all'ID tabella.

5. Per attivare la protezione da eliminazione, fai clic su Impedisci eliminazione. Per disattivare la protezione da eliminazione, fai clic su Consenti eliminazione. È visibile solo l'opzione valida.

gcloud

Per attivare la protezione dall'eliminazione per una tabella, esegui il comando gcloud bigtable instances table update:

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

Per disattivare la protezione da eliminazione per una tabella, esegui il seguente comando:

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

Sostituisci quanto segue:

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

cbt

Non puoi utilizzare cbt CLI per attivare o disattivare la protezione dall'eliminazione.