Creazione di una tabella di test

Questa pagina descrive i passaggi per creare una piccola tabella Bigtable che puoi utilizzare per testare snippet di codice. La tabella contiene dati delle serie temporali per smartphone e tablet.

Queste istruzioni utilizzano la console Google Cloud e l'interfaccia a riga di comando cbt, un'interfaccia a riga di comando creata appositamente per Bigtable.

Prima di iniziare

Prima di creare una tabella di test, completa i seguenti prerequisiti.

Configura l'autenticazione

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, vedi Set up Application Default Credentials for code running on Google Cloud.

Concedi ruolo IAM

Per ottenere le autorizzazioni necessarie per creare una tabella di test, chiedi all'amministratore di concederti il ruolo IAM Bigtable Administrator (roles/bigtable.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Installa la CLI cbt

Esegui questo comando per installare la CLI cbt:

  gcloud components install cbt

Crea un'istanza

Nel progetto che preferisci, crea un'istanza di test per archiviare la tabella di test. La tabella è piccola, quindi è necessaria una sola istanza a un nodo.

  1. Apri la pagina Crea istanza nella console Google Cloud .

    Crea un'istanza

  2. In Nome istanza, inserisci Test instance.

  3. In ID istanza, inserisci test-instance.

  4. Per Tipo di archiviazione, seleziona SSD.

  5. In ID cluster, inserisci test-instance-c1.

  6. In Regione, seleziona una regione vicina a te.

  7. Per Zona, seleziona una zona nella regione che hai selezionato.

  8. In Nodi, inserisci 1.

  9. Fai clic sul pulsante Crea per creare l'istanza.

Connettersi all'istanza

  1. Configura la CLI cbt in modo da utilizzare il tuo progetto e la tua istanza creando un file .cbtrc, sostituendo PROJECT_ID con l'ID del progetto in cui hai creato l'istanza Bigtable:

    echo project = PROJECT_ID >> ~/.cbtrc && echo instance = test-instance >> ~/.cbtrc

  2. Verifica di aver configurato correttamente il file .cbtrc:

    cat ~/.cbtrc

    Il terminale mostra i contenuti del file .cbtrc, che hanno un aspetto simile al seguente:

    project = PROJECT_ID
instance = test-instance

    Ora puoi utilizzare l'interfaccia a riga di comando di cbt con la tua istanza.

Creazione di una tabella di test

  1. Crea una tabella denominata test_table con due famiglie di colonne. Per ogni famiglia di colonne, imposta una policy di garbage collection per conservare un massimo di 2 celle per colonna:

       cbt createtable test_table "families=stats_summary:maxversions=2,stats_detail:maxversions=2,cell_plan:maxversions=2"

  2. Elenca le famiglie di colonne:

       cbt ls test_table

    Il terminale mostra un output simile al seguente:

        Family Name       GC Policy
    -----------       ---------
    stats_detail        versions() > 2
    stats_summary       versions() > 2
    cell_plan           versions() > 2

Compilare la tabella

  1. Copia i seguenti comandi nella finestra del terminale e premi Enter.

      cbt set test_table phone#4c410523#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.003 cell_plan:data_plan_01gb=true cell_plan:data_plan_05gb=true
  cbt set test_table phone#4c410523#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.004 cell_plan:data_plan_05gb=true
  cbt set test_table phone#4c410523#20190505 stats_summary:connected_cell=0 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190406.000
  cbt set test_table phone#5c10102#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190401.002 cell_plan:data_plan_10gb=true
  cbt set test_table tablet#5c10102#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=0 stats_summary:os_build=PQ2A.190406.000 cell_plan:data_plan_10gb=true

  2. Utilizza il comando cbt read per leggere i dati che hai aggiunto alla tabella:

       cbt read test_table

    Il terminale mostra un output simile al seguente. Tieni presente che i timestamp vengono assegnati automaticamente alle celle perché la richiesta di scrittura non include timestamp.

        ----------------------------------------
    phone#4c410523#20190501
      cell_plan:data_plan_01gb                 @ 2023/09/23-11:44:10.535000
        "true"
      cell_plan:data_plan_05gb                 @ 2023/09/23-11:44:10.535000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:10.535000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:10.535000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:10.535000
        "PQ2A.190405.003"
    ----------------------------------------
    phone#4c410523#20190502
      cell_plan:data_plan_05gb                 @ 2023/09/23-11:44:11.545000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:11.545000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:11.545000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:11.545000
        "PQ2A.190405.004"
    ----------------------------------------
    phone#4c410523#20190505\
      stats_summary:connected_cell             @ 2023/09/23-11:44:12.503000
        "0"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:12.503000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:12.503000
        "PQ2A.190406.000"
    ----------------------------------------
    phone#5c10102#20190501
      cell_plan:data_plan_10gb                 @ 2023/09/23-11:44:13.553000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:13.553000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:13.553000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:13.553000
        "PQ2A.190401.002"
    ----------------------------------------
    tablet#5c10102#20190502
      cell_plan:data_plan_10gb                 @ 2023/09/23-11:44:14.480000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:14.480000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:14.480000
        "0"
      stats_summary:os_build                   @ 2023/09/23-11:44:14.480000
             "PQ2A.190406.000"

  3. (Facoltativo) Scrivi i nuovi valori nelle stesse righe e colonne. Bigtable crea nuove celle con nuovi timestamp per archiviare le nuove versioni dei dati. Copia i seguenti comandi nella finestra del terminale e premi Enter.

      cbt set test_table phone#4c410523#20190501 stats_summary:connected_cell=2 stats_summary:connected_wifi=5 stats_summary:os_build=PQ2A.190405.003 cell_plan:data_plan_01gb=true cell_plan:data_plan_05gb=false
  cbt set test_table phone#4c410523#20190502 stats_summary:connected_cell=2 stats_summary:connected_wifi=5 stats_summary:os_build=PQ2A.190405.004 cell_plan:data_plan_05gb=false
  cbt set test_table phone#4c410523#20190505 stats_summary:connected_cell=1 stats_summary:connected_wifi=4 stats_summary:os_build=PQ2A.190406.000
  cbt set test_table phone#5c10102#20190501 stats_summary:connected_cell=3 stats_summary:connected_wifi=3 stats_summary:os_build=PQ2A.190401.002 cell_plan:data_plan_10gb=false
  cbt set test_table tablet#5c10102#20190502 stats_summary:connected_cell=2 stats_summary:connected_wifi=0 stats_summary:os_build=PQ2A.190406.000 cell_plan:data_plan_10gb=false

  4. Utilizza il comando cbt read per leggere tutti i dati nella tabella:

       cbt read test_table

    Il terminale mostra un output simile al seguente. Ogni colonna ora contiene due celle con timestamp univoci.

      ----------------------------------------
  phone#4c410523#20190501
    cell_plan:data_plan_01gb                 @ 2024/07/09-17:48:21.191000
    "true"
    cell_plan:data_plan_01gb                 @ 2024/07/09-17:46:09.369000
    "true"
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:48:21.191000
    "false"
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:46:09.369000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:21.191000
    "2"
    stats_summary:connected_cell             @ 2024/07/09-17:46:09.369000
    "1"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:21.191000
    "5"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:09.369000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:21.191000
    "PQ2A.190405.003"
    stats_summary:os_build                   @ 2024/07/09-17:46:09.369000
    "PQ2A.190405.003"

  ----------------------------------------
  phone#4c410523#20190502
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:48:22.205000
    "false"
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:46:10.455000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:22.205000
    "2"
    stats_summary:connected_cell             @ 2024/07/09-17:46:10.455000
    "1"
     stats_summary:connected_wifi             @ 2024/07/09-17:48:22.205000
    "5"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:10.455000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:22.205000
    "PQ2A.190405.004"
    stats_summary:os_build                   @ 2024/07/09-17:46:10.455000
    "PQ2A.190405.004"

  ----------------------------------------
  phone#4c410523#20190505
    stats_summary:connected_cell             @ 2024/07/09-17:48:23.206000
    "1"
    stats_summary:connected_cell             @ 2024/07/09-17:46:11.402000
    "0"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:23.206000
    "4"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:11.402000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:23.206000
    "PQ2A.190406.000"
    stats_summary:os_build                   @ 2024/07/09-17:46:11.402000
    "PQ2A.190406.000"

  ----------------------------------------
  phone#5c10102#20190501
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:48:24.172000
    "false"
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:46:12.388000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:24.172000
    "3"
    stats_summary:connected_cell             @ 2024/07/09-17:46:12.388000
    "1"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:24.172000
    "3"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:12.388000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:24.172000
    "PQ2A.190401.002"
    stats_summary:os_build                   @ 2024/07/09-17:46:12.388000
    "PQ2A.190401.002"

  ----------------------------------------
  tablet#5c10102#20190502
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:48:25.194000
    "false"
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:46:13.391000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:25.194000
    "2"
    stats_summary:connected_cell             @ 2024/07/09-17:46:13.391000
    "1"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:25.194000
    "0"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:13.391000
    "0"
    stats_summary:os_build                   @ 2024/07/09-17:48:25.194000
    "PQ2A.190406.000"
    stats_summary:os_build                   @ 2024/07/09-17:46:13.391000
    "PQ2A.190406.000"

Utilizzare i dati di test

Ora puoi utilizzare test_table su test-instance per testare esempi di codice o query.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse create durante questi passaggi, elimina l'istanza non appena hai terminato il test. L'eliminazione del file .cbtrc ti consente di lavorare su un progetto diverso.

  1. Se vuoi conservare l'istanza ma eliminare la tabella, puoi utilizzare il comando deletetable:

       cbt deletetable test_table

  2. Se non prevedi di utilizzare l'istanza per ulteriori test, eliminala. Questa azione elimina anche la tabella.

       cbt deleteinstance test-instance

  3. Elimina il file .cbtrc:

       rm ~/.cbtrc

Passaggi successivi