Comandi dell'interfaccia a riga di comando Spanner

Questa pagina riepiloga i comandi supportati della CLI Spanner.

Sintassi del comando Descrizione
SHOW DATABASES; Elenca i database.
USE database_name [ROLE role_name]; Cambia database. Il ruolo che imposti viene utilizzato per il controllo dell'accesso granulare.
CREATE DATABASE database_name; Crea database.
DROP DATABASE database_name; Elimina database.
SHOW TABLES [schema]; Elenca tabelle. Se non fornisci uno schema, Spanner utilizza lo schema predefinito.
SHOW CREATE TABLE table_name; Mostra schema tabella.
SHOW COLUMNS FROM table_name; Mostra colonne.
SHOW INDEX FROM table_name; Mostra indici.
CREATE TABLE ...; Crea tabella.
ALTER TABLE ...; Modifica lo schema della tabella.
DROP TABLE ...; Elimina tabella.
TRUNCATE TABLE table_name; Tronca tabella. Elimina solo le righe. Questo comando non è atomico perché viene eseguito come istruzione DML partizionata.
CREATE INDEX ...; Crea indice.
DROP INDEX ...; Elimina indice.
CREATE ROLE ...; Crea ruolo. Per saperne di più, consulta la panoramica di IAM di Spanner.
DROP ROLE ...; Elimina ruolo.
GRANT ...; Concedi l'autorizzazione a un ruolo.
REVOKE ...; Revoca l'autorizzazione da un ruolo.
SELECT ...; Esegui una query.
{ INSERT|UPDATE|DELETE } ...; Esegui un'istruzione DML.
PARTITIONED { UPDATE|DELETE } ...; Esegui un'istruzione DML partizionata. Questo comando non è atomico.
EXPLAIN SELECT ...; Mostra un piano di esecuzione delle query. Per maggiori informazioni, vedi Piani di esecuzione delle query.
EXPLAIN {INSERT|UPDATE|DELETE} ...; Mostra il piano di esecuzione DML.
EXPLAIN ANALYZE SELECT ...; Mostra il piano di esecuzione delle query con le statistiche dello strumento di ottimizzazione. Per ulteriori informazioni, vedi Pacchetti di statistiche dell'ottimizzatore.
EXPLAIN ANALYZE {INSERT|UPDATE|DELETE} ...; Mostra il piano di esecuzione DML con le statistiche dell'ottimizzatore. Per ulteriori informazioni, vedi Pacchetti di statistiche dell'ottimizzatore.
DESCRIBE SELECT ...; Mostra la forma del risultato della query.
DESCRIBE {INSERT|UPDATE|DELETE} ... THEN RETURN ...; Mostra la forma del risultato DML.
ANALYZE; Avvia la creazione di un nuovo pacchetto di statistiche dell'ottimizzatore di query.
START BATCH DDL; Avvia un batch DDL.
RUN BATCH; Esegui comandi batch.
ABORT BATCH; Interrompi i comandi batch.
BEGIN [RW] [ISOLATION LEVEL {SERIALIZABLE|REPEATABLE READ}] [PRIORITY {HIGH|MEDIUM|LOW}] [TAG tag_name]; Avvia una transazione di lettura/scrittura. Per ulteriori informazioni, consulta la sezione Comandi di transazione.
COMMIT; Esegui il commit di una transazione di lettura/scrittura.
ROLLBACK; Esegui il rollback (annulla) di una transazione di lettura/scrittura.
BEGIN RO [{seconds|RFC 3339-formatted_time}] [PRIORITY {HIGH|MEDIUM|LOW}] [TAG tag_name]; Avvia una transazione di sola lettura. seconds e RFC 3339-formatted_time vengono utilizzati per le letture non aggiornate. Per ulteriori informazioni, vedi Comandi di transazione.
CLOSE; Termina una transazione di sola lettura.
EXIT; Esci dalla CLI Spanner.

BATCH comandi

La CLI Spanner consente di eseguire operazioni DDL in modalità batch, che raggruppa più istruzioni DDL in un'unica operazione e velocizza le modifiche allo schema. La CLI Spanner supporta i seguenti comandi BATCH:

START BATCH DDL;

Questo comando avvia un batch DDL. Tutte le istruzioni DDL successive (ad esempio CREATE TABLE, ALTER TABLE, DROP INDEX) che esegui all'interno di questa sessione rimangono in stato di attesa e non vengono applicate immediatamente al database.

RUN BATCH;

Dopo aver eseguito START BATCH DDL e le istruzioni DDL successive, utilizza il comando RUN BATCH per inviare tutte le operazioni DDL in attesa come singola richiesta a Spanner. Questo comando riduce l'overhead associato alle singole istruzioni DDL, il che porta a modifiche dello schema più rapide.

ABORT BATCH;

Se decidi di non applicare le modifiche DDL in attesa, utilizza il comando ABORT BATCH. Questo comando ignora tutte le istruzioni DDL raccolte dall'emissione del comando START BATCH DDL, eseguendo il rollback del batch e lasciando invariato lo schema del database.

Comandi per le transazioni

La CLI di Spanner supporta i seguenti comandi SQL per le transazioni:

BEGIN [TRANSACTION] [RO] [seconds|RFC 3339-formatted_time ] [ISOLATION LEVEL {SERIALIZABLE|REPEATABLE READ}] [PRIORITY {HIGH|MEDIUM|LOW}] [TAG tag_name];

Avvia una transazione. Puoi configurare queste opzioni:

  • Tipo di transazione: avvia una transazione di lettura/scrittura (nessun parametro necessario) o di sola lettura (RO).
  • Ora di lettura obsoleta: imposta l'ora, in secondi o in formato RFC 3339, per leggere i dati da un timestamp specifico.
  • Livello di isolamento: imposta il livello di isolamento per le transazioni di lettura/scrittura. Per impostazione predefinita, viene utilizzato l'isolamento serializzabile. Per saperne di più, consulta la Panoramica dei livelli di isolamento.
  • Priorità: imposta la priorità della richiesta per la transazione. La priorità media è impostata per impostazione predefinita.

  • Tag: imposta i tag transazione utilizzando il comando BEGIN.

    • In una transazione di lettura/scrittura, aggiungi un tag con BEGIN TAG tag. La CLI di Spanner aggiunge il tag come tag di transazione. Il tag viene utilizzato anche come tag di richiesta all'interno della transazione.
    • In una transazione di sola lettura, aggiungi un tag con BEGIN RO TAG tag. Poiché le transazioni di sola lettura non supportano i tag di transazione, Spanner aggiunge il tag come tag di richiesta.

COMMIT;

Finalizza e rendi permanenti tutte le modifiche in una transazione di lettura/scrittura.

CLOSE;

Chiudi una transazione di sola lettura.

ROLLBACK;

Esegui il rollback (annulla) di una transazione di lettura/scrittura.

Passaggi successivi