Creare ed eseguire query su un database utilizzando Google Cloud Console
Questa guida rapida mostra come eseguire operazioni di base in Cloud Spanner utilizzando Google Cloud Console. Nella guida rapida:
- Creare un'istanza di Cloud Spanner.
- Crea un database.
- Crea uno schema.
- Inserire e modificare i dati.
- Esegui una query.
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.
-
Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.
-
Abilita l'API Cloud Spanner per il progetto.
Crea un'istanza
Quando usi Cloud Spanner per la prima volta, devi creare un'istanza, ovvero l'assegnazione di risorse utilizzate dai database Cloud Spanner in tale istanza.
In Google Cloud Console, vai alla pagina Istanze Cloud Spanner.
Fai clic su Crea istanza.
Inserisci il nome dell'istanza, ad esempio Istanza di test.
L'ID istanza viene inserito automaticamente in base al nome dell'istanza, ad esempio istanza-test. Modificala, se necessario.
In Scegli la configurazione, mantieni l'opzione predefinita Regional e seleziona una configurazione dal menu a discesa.
La configurazione dell'istanza determina la località geografica in cui vengono archiviate e replicate le tue istanze.
In Assegna capacità di calcolo, mantieni il valore predefinito di 1000 unità di elaborazione.
La pagina di creazione dell'istanza ha il seguente aspetto:
Fai clic su Crea.
L'istanza viene visualizzata nell'elenco delle istanze.
Crea un database
In Google Cloud Console, vai alla pagina Istanze Cloud Spanner.
Fai clic sull'istanza che hai creato, ad esempio Istanza di test.
Nella pagina Panoramica dell'istanza che si apre, fai clic su Crea database.
Inserisci il nome del database, ad esempio example-db.
Seleziona un dialetto del database.
Per informazioni sul supporto per PostgreSQL e per indicazioni sulla scelta di un dialetto, consulta l'interfaccia di PostgreSQL. Se hai selezionato SQL standard di Google, dovrai definire lo schema nel campo di testo Definisci il tuo schema nella sezione successiva di questa guida rapida.
La pagina di creazione del database ora ha il seguente aspetto:
Fai clic su Crea.
Google Cloud Console visualizza la pagina Panoramica per il database che hai creato.
Crea uno schema per il tuo database
Nella sezione Tabelle della pagina Panoramica del database, fai clic su Crea tabella.
Nella pagina Scrivi istruzioni DDL, inserisci:
SQL standard di Google
CREATE TABLE Singers ( SingerId INT64 NOT NULL, FirstName STRING(1024), LastName STRING(1024), SingerInfo BYTES(MAX), BirthDate DATE, ) PRIMARY KEY(SingerId);
PostgreSQL
CREATE TABLE Singers ( SingerId BIGINT PRIMARY KEY, FirstName VARCHAR(1024), LastName VARCHAR(1024), SingerInfo BYTEA, BirthDate TIMESTAMPTZ );
Fai clic su Invia.
Google Cloud Console torna alla pagina Panoramica del database e indica che sono in corso gli aggiornamenti dello schema. Al termine dell'aggiornamento, la pagina sarà simile a questa:
SQL standard di Google
PostgreSQL
Tieni presente che PostgreSQL converte il nome della tabella in lettere minuscole.
Inserire e modificare i dati
Google Cloud Console offre un'interfaccia per inserire, modificare ed eliminare dati.
Inserisci i dati
Nell'elenco delle tabelle nella pagina Panoramica del database, fai clic sulla tabella Cantanti.
Google Cloud Console mostra la pagina Schema della tabella Singer.
Nel menu di navigazione, fai clic su Dati per visualizzare la pagina Dati della tabella Cantanti.
Fai clic su Inserisci.
Google Cloud Console mostra la pagina Query della tabella Singer con una nuova scheda Query contenente le istruzioni
INSERT
eSELECT
modificate per inserire una riga nella tabella Singer e visualizzare il risultato dell'inserimento:SQL standard di Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (<SingerId>, -- type: INT64 <BirthDate>, -- type: DATE <FirstName>, -- type: STRING(1024) <LastName>, -- type: STRING(1024) <SingerInfo> -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=<SingerId>;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (<singerid>, -- type: bigint <birthdate>, -- type: timestamp with time zone <firstname>, -- type: character varying <lastname>, -- type: character varying <singerinfo> -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=<singerid>;
Tieni presente che PostgreSQL converte i nomi delle colonne in lettere minuscole.
Modifica la clausola
VALUES
dell'istruzioneINSERT
e la clausolaWHERE
dell'istruzioneSELECT
:SQL standard di Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (1, -- type: INT64 NULL, -- type: DATE 'Marc', -- type: STRING(1024) 'Richards', -- type: STRING(1024) NULL -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=1;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (1, -- type: bigint NULL, -- type: timestamp with time zone 'Marc', -- type: character varying 'Richards', -- type: character varying NULL -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=1;
Fai clic su Esegui.
Cloud Spanner esegue le istruzioni. Al termine, la scheda Risultati indica che la prima istruzione ha inserito una riga e fornisce un link per visualizzare i dati della tabella.
Nella scheda Risultati, fai clic sul link tabella. La tabella Cantanti ora ha una riga:
SQL standard di Google
PostgreSQL
Fai clic su Inserisci per aggiungere un'altra riga.
Google Cloud Console mostra di nuovo la pagina Query della tabella Singer con una nuova scheda Query contenente le stesse istruzioni
INSERT
eSELECT
.Modifica la clausola
VALUES
dell'istruzioneINSERT
e la clausolaWHERE
dell'istruzioneSELECT
:SQL standard di Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (2, -- type: INT64 NULL, -- type: DATE 'Catalina', -- type: STRING(1024) 'Smith', -- type: STRING(1024) NULL -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=2;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (2, -- type: bigint NULL, -- type: timestamp with time zone 'Catalina', -- type: character varying 'Smith', -- type: character varying NULL -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=2;
Fai clic su Esegui.
Dopo che Cloud Spanner ha eseguito le istruzioni, la scheda Risultati indica di nuovo che la prima istruzione ha inserito una riga.
Fai clic sul link tabella. La tabella Cantanti ora ha due righe:
SQL standard di Google
PostgreSQL
Puoi anche inserire valori stringa vuoti quando inserisci i dati.
Fai clic su Inserisci per aggiungere una riga.
Cloud Spanner mostra di nuovo la pagina Query della tabella Singer con una nuova scheda Query contenente le stesse istruzioni
INSERT
eSELECT
.Modifica la clausola
VALUES
del modelloINSERT
e la clausolaWHERE
dell'istruzioneSELECT
:SQL standard di Google
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO Singers (SingerId, BirthDate, FirstName, LastName, SingerInfo) VALUES (3, -- type: INT64 NULL, -- type: DATE 'Kena', -- type: STRING(1024) '', -- type: STRING(1024) NULL -- type: BYTES(MAX) ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM Singers WHERE SingerId=3;
PostgreSQL
-- Add new values in the VALUES clause in order of the column list. -- Each value must be type compatible with its associated column. INSERT INTO singers (singerid, birthdate, firstname, lastname, singerinfo) VALUES (3, -- type: bigint NULL, -- type: timestamp with time zone 'Kena', -- type: character varying '', -- type: character varying NULL -- type: bytea ); -- Change values in the WHERE condition to match the inserted row. SELECT * FROM singers WHERE singerid=3;
Tieni presente che il valore fornito per la colonna del cognome è una stringa vuota,
''
, non un valoreNULL
.Fai clic su Esegui.
Dopo che Cloud Spanner ha eseguito le istruzioni, la scheda Risultati indica che la prima istruzione ha inserito una riga.
Fai clic sul link tabella. La tabella
Singers
ora ha tre righe, mentre la riga con la coppia chiave-valore principale3
ha una stringa vuota nella colonnaLastName
:SQL standard di Google
PostgreSQL
Modifica dati
Nella pagina Dati della tabella Cantanti, seleziona la casella di controllo in corrispondenza della riga con la chiave-valore principale
3
, quindi fai clic su Modifica.Cloud Spanner visualizza la pagina Query con una nuova scheda contenente le istruzioni modello
UPDATE
eSELECT
modificabili. Tieni presente che le clausoleWHERE
di entrambe le istruzioni indicano che la riga da aggiornare è quella con valore chiave principale di3
.SQL standard di Google
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE Singers SET BirthDate='', FirstName='Kena', LastName='', SingerInfo='' WHERE SingerId=3; SELECT * FROM Singers WHERE SingerId=3;
PostgreSQL
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE singers SET birthdate='', firstname='Kena', lastname='', singerinfo='' WHERE singerid='3'; SELECT * FROM singers WHERE singerid='3';
Modifica la clausola
SET
dell'istruzioneUPDATE
per aggiornare solo la data di nascita:SQL standard di Google
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE Singers SET BirthDate='1961-04-01' WHERE SingerId=3; SELECT * FROM Singers WHERE SingerId=3;
PostgreSQL
-- Change values in the SET clause to update the row where the WHERE condition is true. UPDATE singers SET birthdate='1961-04-01 00:00:00 -8:00' WHERE singerid='3'; SELECT * FROM singers WHERE singerid='3';
Fai clic su Esegui.
Cloud Spanner esegue le istruzioni. Al termine, la scheda Risultati indica che la prima istruzione ha aggiornato una riga e fornisce un link per visualizzare i dati della tabella.
Nella scheda Risultati, fai clic sul link tabella.
La riga aggiornata ora contiene un valore per la data di nascita.
SQL standard di Google
PostgreSQL
Elimina dati
- Nella pagina Dati della tabella Cantanti, seleziona la casella di controllo in corrispondenza della riga contenente
2
nella prima colonna, quindi fai clic su Elimina. Nella finestra di dialogo visualizzata, fai clic su Conferma.
La tabella Cantanti ora ha due righe:
SQL standard di Google
PostgreSQL
Esegui una query
Nella pagina Panoramica del database, fai clic su Query nel menu di navigazione.
Fai clic su Nuova scheda per creare una nuova scheda Query. Poi, inserisci la seguente query nell'Editor query:
SQL standard di Google
SELECT * FROM Singers;
PostgreSQL
SELECT * FROM singers;
Fai clic su Esegui.
Cloud Spanner esegue la query. Al termine, la scheda Risultati mostra il risultato della tua query:
SQL standard di Google
PostgreSQL
Complimenti! Hai creato un database Cloud Spanner ed eseguito un'istruzione SQL utilizzando l'editor di query.
Esegui la pulizia
Per evitare addebiti aggiuntivi sul tuo account di fatturazione Cloud, elimina il database e l'istanza che hai creato. Se elimini un'istanza, vengono eliminati automaticamente tutti i database creati nell'istanza.
Eliminazione del database
In Google Cloud Console, vai alla pagina Istanze Cloud Spanner.
Fai clic sul nome dell'istanza con il database che vuoi eliminare, ad esempio Istanza di test.
Fai clic sul nome del database da eliminare, ad esempio example-db.
Nella pagina Dettagli database, fai clic su delete Elimina database.
Conferma che vuoi eliminare il database inserendone il nome e facendo clic su Elimina.
Elimina l'istanza
In Google Cloud Console, vai alla pagina Istanze Cloud Spanner.
Fai clic sul nome dell'istanza che vuoi eliminare, ad esempio Istanza di test.
Fai clic su delete Elimina istanza.
Conferma di voler eliminare l'istanza inserendo il nome dell'istanza e facendo clic su Elimina.
Passaggi successivi
- Scopri di più sulle istanze.
- Interpretare lo schema e il modello dei dati di Cloud Spanner.
- Ulteriori informazioni sul linguaggio DDL (Google Standard SQL Data Definition Language).
- Scopri di più sui piani di esecuzione delle query.
- Scopri come utilizzare Cloud Spanner con C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST o gcloud.