Questa pagina descrive come gestire un database Spanner, incluso come creare un database, modificare le opzioni del database ed eliminare un database. Per scoprire come aggiornare lo schema di un database, consulta Eseguire aggiornamenti dello schema.
Per esercitarti a creare un database e a caricarlo con dati di esempio, consulta il codelab sul tuo primo database.
Crea un database
I seguenti esempi mostrano come creare un database in un'istanza esistente.
Per i database di dialetti GoogleSQL, puoi definire lo schema del database al momento della creazione o dopo la creazione del database. Per i database con dialetti PostgreSQL, devi definire lo schema dopo la creazione.
Gli schemi vengono definiti utilizzando il linguaggio di definizione del database, documentato per GoogleSQL e PostgreSQL. Per saperne di più sulla creazione e sull'aggiornamento degli schemi, consulta i seguenti link:
- Schema e modello dei dati
- Best practice per la progettazione degli schemi
- Aggiornamenti dello schema
Dopo aver creato il database, puoi salvaguardare i database importanti per le tue applicazioni e i tuoi servizi attivando la protezione da eliminazione dei database. Per maggiori informazioni, consulta Impedire l'eliminazione accidentale del database.
Console
Vai alla pagina Istanze nella console Google Cloud.
Seleziona l'istanza in cui creare il database.
Fai clic su Crea database.
Inserisci i seguenti valori:
- Un nome del database da visualizzare nella console Google Cloud.
- Il dialetto da utilizzare per questo database.
- Per i database di dialetti GoogleSQL, facoltativamente, puoi fornire un set di istruzioni DDL che definiscono il tuo schema. Utilizza i modelli DDL per precompilare gli elementi comuni. In caso di errori nelle istruzioni DDL, la console Google Cloud restituisce un errore quando provi a creare il database.
- Facoltativamente, seleziona una chiave di crittografia gestita dal cliente da utilizzare per questo database.
Fai clic su Crea per creare il database.
gcloud
Usa il comando gcloud spanner databases create
.
gcloud spanner databases create DATABASE \
--instance=INSTANCE \
[--async] \
[--database-dialect=DATABASE_DIALECT] \
[--ddl=DDL] \
[--ddl-file=DDL_FILE] \
[--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] \
[GCLOUD_WIDE_FLAG …]
Sono necessarie le seguenti opzioni:
DATABASE
- ID del database o identificatore completo per il database. Se specifichi l'identificatore completo, il flag
--instance
può essere omesso. --instance=INSTANCE
- L'istanza di Spanner per il database.
Le seguenti opzioni sono facoltative:
--async
- Restituisci subito, senza attendere il completamento dell'operazione in corso.
--database-dialect=DATABASE_DIALECT
- Il dialetto SQL del database Spanner. Deve essere
uno dei seguenti:
POSTGRESQL
,GOOGLE_STANDARD_SQL
. --ddl=DDL
- Istruzioni DDL (Data Definition Language) separate da punto e virgola da eseguire
nel database appena creato. Se è presente un errore in un'istruzione, il database non viene creato. Questo flag viene ignorato se
--ddl_file
è impostato. Non supportato dai database di dialetti PostgreSQL. --ddl-file=DDL_FILE
- Percorso di un file contenente istruzioni DDL (Data Definition Language) separate da punto e virgola da eseguire all'interno del database appena creato. Se è presente un errore in un'istruzione, il database non viene creato. Se
--ddl_file
viene impostato,--ddl
viene ignorato. Non supportato dai database di dialetti PostgreSQL.
Se specifichi una chiave Cloud Key Management Service da utilizzare durante la creazione del database, includi le seguenti opzioni:
--kms-key=KMS_KEY
- ID della chiave o identificatore completo della chiave.
Questo flag deve essere specificato se viene specificato uno qualsiasi degli altri argomenti in questo gruppo. Gli altri argomenti possono essere omessi se viene fornito l'identificatore completo.
--kms-keyring=KMS_KEYRING
- ID del keyring di Cloud KMS della chiave.
--kms-location=KMS_LOCATION
- Posizione Google Cloud della chiave.
--kms-project=KMS_PROJECT
- ID progetto Google Cloud per la chiave.
Client (GoogleSQL)
C++
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per scoprire come installare e utilizzare la libreria client per Spanner, consulta Librerie client di Spanner.
Per eseguire l'autenticazione su Spanner, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Aggiorna lo schema o le opzioni del database
Puoi aggiornare lo schema e le opzioni del tuo database utilizzando le istruzioni DDL.
Ad esempio, per aggiungere una colonna a una tabella, utilizza la seguente istruzione DDL:
GoogleSQL
ALTER TABLE Songwriters ADD COLUMN Publisher STRING(10);
PostgreSQL
ALTER TABLE Songwriters ADD COLUMN Publisher VARCHAR(10);
Per aggiornare la versione dello strumento di ottimizzazione delle query, utilizza la seguente istruzione DDL:
GoogleSQL
ALTER DATABASE Music SET OPTIONS(optimizer_version=null);
PostgreSQL
ALTER DATABASE DB-NAME SET spanner.optimizer_version TO DEFAULT;
Per saperne di più sulle opzioni supportate, consulta il riferimento DDL ALTER DATABASE
per GoogleSQL o PostgreSQL.
Per informazioni sugli aggiornamenti dello schema, consulta Eseguire aggiornamenti dello schema.
Console
Vai alla pagina Istanze nella console Google Cloud.
Seleziona l'istanza contenente il database da modificare.
Seleziona il database.
Fai clic su Spanner Studio.
Fai clic su
Nuova scheda o utilizza la scheda dell'editor vuota. Quindi, inserisci le istruzioni DDL da applicare.Fai clic su Esegui per applicare gli aggiornamenti. Se sono presenti errori nel DDL, la console Google Cloud restituisce un errore e il database non viene modificato.
gcloud
Per modificare un database con lo strumento a riga di comando gcloud
, usa gcloud spanner databases ddl update
.
gcloud spanner databases ddl update \ (DATABASE : --instance=INSTANCE) \ [--async] \ [--ddl=DDL] \ [--ddl-file=DDL_FILE] \
Per informazioni dettagliate sulle opzioni disponibili, consulta la documentazione di riferimento di gcloud
.
Passa gli aggiornamenti del database al comando con il flag --ddl
o --ddl-file
. Se viene specificato un file DDL, il flag --ddl
viene ignorato.
Fai riferimento al riferimento DDL ALTER DATABASE
per GoogleSQL o PostgreSQL per le istruzioni DDL da includere.
DDL
Per maggiori dettagli, consulta il riferimento DDL ALTER DATABASE
per GoogleSQL o PostgreSQL.
Verificare l'avanzamento delle operazioni di aggiornamento dello schema
Console
Nel menu di navigazione di Spanner, seleziona la scheda Operazioni. La pagina Operazioni mostra un elenco delle operazioni attualmente in esecuzione.
Trova l'operazione dello schema nell'elenco. Se è ancora in esecuzione, la barra di avanzamento nella colonna Ora di fine mostra la percentuale di completamento dell'operazione, come mostrato nell'immagine seguente:
gcloud
Utilizza gcloud spanner operations describe
per controllare l'avanzamento di un'operazione.
Recupera l'ID operazione:
gcloud spanner operations list --instance=INSTANCE-NAME \ --database=DATABASE-NAME --type=DATABASE_UPDATE_DDL
Sostituisci quanto segue:
- INSTANCE-NAME con il nome istanza Spanner.
- DATABASE-NAME con il nome del database.
Corsa di
gcloud spanner operations describe
:gcloud spanner operations describe OPERATION_ID\ --instance=INSTANCE-NAME \ --database=DATABASE-NAME
Sostituisci quanto segue:
- OPERATION-ID: l'ID dell'operazione che vuoi controllare.
- INSTANCE-NAME: il nome dell'istanza Spanner.
- DATABASE-NAME: il nome del database Spanner.
La sezione
progress
nell'output mostra la percentuale di completamento dell'operazione. L'output è simile al seguente:done: true metadata: ... progress: - endTime: '2022-03-01T00:28:06.691403Z' progressPercent: 100 startTime: '2022-03-01T00:28:04.221401Z' - endTime: '2022-03-01T00:28:17.624588Z' startTime: '2022-03-01T00:28:06.691403Z' progressPercent: 100 ...
REST v1
Recupera l'ID operazione:
gcloud spanner operations list --instance=INSTANCE-NAME \ --database=DATABASE-NAME --type=DATABASE_UPDATE_DDL
Sostituisci quanto segue:
- INSTANCE-NAME con il nome istanza Spanner.
- DATABASE-NAME con il nome del database.
Verifica lo stato di avanzamento dell'operazione.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT-ID: l'ID progetto.
- INSTANCE-ID: l'ID istanza.
- DATABASE-ID: l'ID del database.
- OPERATION-ID: l'ID operazione.
Metodo HTTP e URL:
GET https://spanner.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID/databases/DATABASE-ID/operations/OPERATION-ID
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ ... "progress": [ { "progressPercent": 100, "startTime": "2023-05-27T00:52:27.366688Z", "endTime": "2023-05-27T00:52:30.184845Z" }, { "progressPercent": 100, "startTime": "2023-05-27T00:52:30.184845Z", "endTime": "2023-05-27T00:52:40.750959Z" } ], ... "done": true, "response": { "@type": "type.googleapis.com/google.protobuf.Empty" } }
Se l'operazione richiede troppo tempo, puoi annullarla. Per maggiori informazioni, consulta Annullare un'operazione di database a lunga esecuzione.
Elimina un database
L'eliminazione di un database determina la rimozione permanente di tale database e di tutti i suoi dati. L'eliminazione del database non può essere annullata. Se su un database è abilitata la protezione da eliminazione del database, non puoi eliminare il database finché non disattivi la protezione da eliminazione.
I backup esistenti non vengono eliminati quando viene eliminato un database. Per maggiori informazioni, vedi Backup e ripristino.
Console
Vai alla pagina Istanze nella console Google Cloud.
Seleziona l'istanza contenente il database da eliminare.
Seleziona il database.
Fai clic su Elimina database. Viene visualizzato un messaggio di conferma.
Digita il nome del database e fai clic su Elimina.
gcloud
Per eliminare un database con lo strumento a riga di comando gcloud
, utilizza gcloud spanner databases delete
.
gcloud spanner databases delete \ (DATABASE : --instance=INSTANCE)
Sono necessarie le seguenti opzioni:
DATABASE
- ID del database o identificatore completo per il database. Se
viene fornito l'identificatore completo, il flag
--instance
deve essere omesso. --instance=INSTANCE
- L'istanza di Spanner per il database.
Per ulteriori dettagli, consulta il riferimento di gcloud
.
DDL
Il DDL non supporta la sintassi di eliminazione del database.
Passaggi successivi
- Crea un database e caricalo con dati di esempio.
- Scopri di più sul riferimento DDL di GoogleSQL.
- Scopri di più sul riferimento DDL di PostgreSQL.
- Scopri come eseguire il backup e il ripristino di un database.
- Scopri come impedire l'eliminazione accidentale del database.
- Scopri come eseguire aggiornamenti dello schema.