Guida rapida all'utilizzo di Spanner Omni CLI

Anteprima

Questo prodotto o funzionalità è un'offerta in anteprima soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi e può essere utilizzata solo per sviluppare, testare, creare prototipi e dimostrare programmi software. Non può essere utilizzata per l'elaborazione dei dati o per scopi commerciali. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questo documento mostra come utilizzare l'interfaccia a riga di comando (CLI) di Spanner Omni per interagire con un deployment di Spanner Omni e gestirlo. La CLI di Spanner Omni fornisce comandi per le attività amministrative comuni e include una shell SQL interattiva per eseguire query sul database.

Prima di iniziare

Prima di poter utilizzare la CLI di Spanner Omni, assicurati di soddisfare i seguenti requisiti:

1. È configurato e in esecuzione un deployment di Spanner Omni.
2. La macchina che esegue la CLI di Spanner Omni ha accesso alla rete al bilanciatore del carico del deployment di Spanner Omni o ad almeno uno dei server nel deployment.

Passaggio 1: scarica e installa la CLI di Spanner Omni

1. Scarica la CLI di Spanner Omni dal bucket Cloud Storage spanner-omni.

   Vai al bucket di Spanner Omni

2. Estrai il file tar.

   tar -xvf CLI_TAR_FILE
   

   Viene installato il file binario della CLI di Spanner Omni, denominato spanner, nella google/spanner/bin directory.

   Per eseguire il comando spanner, aggiungi la directory google/spanner/bin alla variabile di ambiente PATH o utilizza il percorso completo del file binario nei passaggi seguenti.

Passaggio 2: connettiti al deployment

Per impostazione predefinita, la CLI di Spanner Omni tenta di connettersi a localhost:15000. Per connetterti al tuo deployment specifico, utilizza il flag --deployment-endpoint.

Ad esempio, il seguente comando elenca le zone nel deployment:

spanner deployment zones list \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

Passaggio 3: esegui i comandi comuni

Di seguito sono riportati i comandi amministrativi comuni che puoi eseguire con la CLI di Spanner Omni.

Assistenza

Per visualizzare un elenco dei comandi e dei flag globali disponibili, esegui:

spanner --help

Crea un database

Per creare un nuovo database nel deployment, esegui:

spanner databases create DATABASE_NAME \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

Elenca tutti i database

Per elencare tutti i database nel deployment, esegui:

spanner databases list \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

Passaggio 4: avvia una sessione della shell SQL interattiva

La CLI di Spanner Omni include una shell SQL interattiva per l'esecuzione delle query. Avviando la shell per un database specifico con il flag --database, puoi eseguire comandi SQL senza dover specificare il database o l'endpoint per ogni query.

Per avviare la shell SQL, esegui:

spanner sql --database=DATABASE_NAME \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

Dopo l'avvio della shell, viene visualizzato il sql> prompt:

spanner-cli>

Per uscire dalla shell, digita exit.