Questa guida rapida mostra come eseguire operazioni di base in Cloud Spanner utilizzando la console Google Cloud. Nella guida rapida:
- Creare un'istanza Spanner.
- Creare un database.
- Crea uno schema.
- Inserisci e modifica i dati.
- Eseguire una query.
Per informazioni sul costo di utilizzo di Spanner, consulta la sezione Prezzi.
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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
- (Facoltativo) L'API Spanner deve essere abilitata automaticamente. In caso contrario, attivala manualmente: Abilita l'API Spanner
Crea un'istanza
Quando utilizzi Spanner per la prima volta, devi creare un'istanza, ovvero un'allocazione di risorse utilizzate dai database Spanner in quell'istanza.
Nella console Google Cloud, vai alla pagina Cloud Spanner.
Seleziona o crea un progetto Google Cloud se non lo hai già fatto.
Nella pagina Cloud Spanner, fai clic su Crea un'istanza di cui è stato eseguito il provisioning.
Se hai già utilizzato Spanner, visualizzerai la pagina Istanze di Spanner, anziché la pagina del prodotto. Fai clic su Crea istanza.
Inserisci un nome per l'istanza, ad esempio Istanza di test.
L'ID istanza viene inserito automaticamente in base al nome dell'istanza, ad esempio come test-instance. Modificala, se necessario.
In Scegli la configurazione, mantieni l'opzione predefinita regionale e seleziona una configurazione dal menu a discesa.
La configurazione delle istanze determina la posizione geografica in cui vengono archiviate e replicate.
In Assegna capacità di calcolo, mantieni il valore predefinito di 1000 unità di elaborazione.
Ora 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
Nella console Google Cloud, vai alla pagina Istanze 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.
Per il nome del database, inserisci un nome, ad esempio example-db.
Seleziona un dialetto del database.
Per informazioni sul supporto per PostgreSQL e per indicazioni per la scelta di un dialetto, consulta l'articolo sull'interfaccia di PostgreSQL. Se hai selezionato GoogleSQL, puoi definire lo schema nel campo di testo Definisci lo schema nella prossima sezione di questa guida rapida.
La pagina di creazione del database ora appare così:
Fai clic su Crea.
La console Google Cloud 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:
GoogleSQL
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.
La console Google Cloud torna alla pagina Panoramica del database e mostra che sono in corso gli aggiornamenti dello schema. Al termine dell'aggiornamento, la pagina sarà simile alla seguente:
GoogleSQL
PostgreSQL
Tieni presente che PostgreSQL converte il nome della tabella in lettere minuscole.
Inserisci e modifica i dati
La console Google Cloud offre un'interfaccia per l'inserimento, la modifica e l'eliminazione dei dati.
Inserisci i dati
Nell'elenco delle tabelle della pagina Panoramica del database, fai clic sulla tabella Cantanti.
La console Google Cloud mostra la pagina Schema della tabella Cantanti.
Nel menu di navigazione, fai clic su Dati per visualizzare la pagina Dati della tabella Cantanti.
Fai clic su Inserisci.
La console Google Cloud mostra la pagina di Spanner Studio della tabella Cantanti con una nuova scheda di query che contiene le istruzioni
INSERT
eSELECT
che modifichi per inserire una riga nella tabella Cantanti e visualizzare il risultato di quell'inserimento:GoogleSQL
-- 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
:GoogleSQL
-- 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.
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 della tabella. La tabella Cantanti ora contiene una riga:
GoogleSQL
PostgreSQL
Fai clic su Inserisci per aggiungere un'altra riga.
La console Google Cloud mostra di nuovo la pagina Spanner Studio della tabella Singers con una nuova scheda delle query che contiene le stesse istruzioni
INSERT
eSELECT
.Modifica la clausola
VALUES
dell'istruzioneINSERT
e la clausolaWHERE
dell'istruzioneSELECT
:GoogleSQL
-- 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 Spanner ha eseguito le istruzioni, la scheda Risultati indica nuovamente che la prima istruzione ha inserito una riga.
Fai clic sul link della tabella. La tabella Cantanti ora ha due righe:
GoogleSQL
PostgreSQL
Puoi anche inserire valori stringa vuoti quando inserisci i dati.
Fai clic su Inserisci per aggiungere una riga.
Spanner mostra di nuovo la pagina Spanner Studio della tabella Singers con una nuova scheda delle query che contiene le stesse istruzioni
INSERT
eSELECT
.Modifica la clausola
VALUES
dell'istruzioneINSERT
del modello e la clausolaWHERE
dell'istruzioneSELECT
:GoogleSQL
-- 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 Spanner ha eseguito le istruzioni, la scheda Risultati indica che la prima istruzione ha inserito una riga.
Fai clic sul link della tabella. La tabella
Singers
ora ha tre righe e la riga con il valore di chiave primaria3
ha una stringa vuota nella colonnaLastName
:GoogleSQL
PostgreSQL
Modifica dati
Nella pagina Dati della tabella Cantanti, seleziona la casella di controllo nella riga con il valore di chiave primaria
3
e fai clic su Modifica.Spanner visualizza la pagina Spanner Studio con una nuova scheda contenente il modello
UPDATE
e le istruzioniSELECT
che puoi modificare. Tieni presente che le clausoleWHERE
di entrambe le istruzioni indicano che la riga da aggiornare è quella con il valore di chiave primaria3
.GoogleSQL
-- 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=NULL, firstname='Kena', lastname='', singerinfo=NULL WHERE singerid='3'; SELECT * FROM singers WHERE singerid='3';
Modifica la clausola
SET
dell'istruzioneUPDATE
per aggiornare solo la data di nascita:GoogleSQL
-- 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.
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 della tabella.
La riga aggiornata contiene ora un valore per la data di nascita.
GoogleSQL
PostgreSQL
Elimina dati
- Nella pagina Dati della tabella Cantanti, seleziona la casella di controllo sulla riga con
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:
GoogleSQL
PostgreSQL
esegui una query
Nella pagina Panoramica del database, fai clic su Spanner Studio nel menu di navigazione.
Fai clic su Nuova scheda per creare una nuova scheda di query. Quindi, inserisci la seguente query nell'Editor query:
GoogleSQL
SELECT * FROM Singers;
PostgreSQL
SELECT * FROM singers;
Fai clic su Esegui.
Spanner esegue la query. Al termine, la scheda Risultati mostra il risultato della query:
GoogleSQL
PostgreSQL
Complimenti! Hai creato un database Spanner ed eseguito un'istruzione SQL tramite Editor query.
Esegui la pulizia
Per evitare addebiti aggiuntivi al tuo account di fatturazione Cloud, elimina il database e l'istanza che hai creato. L'eliminazione di un'istanza elimina automaticamente tutti i database creati nell'istanza.
Elimina il database
Nella console Google Cloud, vai alla pagina Istanze Spanner.
Fai clic sul nome dell'istanza contenente il database che vuoi eliminare, ad esempio Istanza di test.
Fai clic sul nome del database che vuoi eliminare, ad esempio example-db.
Nella pagina Dettagli database, fai clic su delete Elimina database.
Conferma l'eliminazione del database inserendo il suo nome e facendo clic su Elimina.
Elimina l'istanza
Nella console Google Cloud, vai alla pagina Istanze 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 relativo nome e facendo clic su Elimina.
Passaggi successivi
- Scopri di più sulle istanze.
- Informazioni sullo schema e sul modello dei dati di Spanner.
- Scopri di più sul Data Definition Language (DDL) di GoogleSQL.
- Scopri di più sui piani di esecuzione delle query.
- Scopri come utilizzare Spanner con C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST o gcloud.