Guida rapida all'utilizzo di Spanner Omni CLI

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 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 Spanner Omni CLI, assicurati di soddisfare i seguenti requisiti:

  1. Un deployment di Spanner Omni è configurato e in esecuzione.
  2. La macchina che esegue la CLI 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 Spanner Omni

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

    Vai al bucket Spanner Omni

  2. Estrai il file tar.

    tar -xvf CLI_TAR_FILE

    Viene installato il binario dell'interfaccia a riga di comando Spanner Omni, denominato spanner, nella directory google/spanner/bin.

    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, Spanner Omni CLI 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 tuo 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 l'interfaccia a riga di comando 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 di shell SQL interattiva

La CLI Spanner Omni include una shell SQL interattiva per l'esecuzione di 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 prompt sql>:

spanner-cli>

Per uscire dalla shell, digita exit.