Crea ed esegui query su un database nella console Google Cloud

Questa guida rapida mostra come utilizzare la console Google Cloud per creare un database in Spanner, inserire dati ed eseguire una query SQL.

Nella guida rapida imparerai a:

  • Crea un'istanza Spanner.
  • Crea un database.
  • Crea uno schema.
  • Inserire e modificare i dati.
  • Esegui una query.

Per informazioni sul costo dell'utilizzo di Spanner, consulta Prezzi.

Prima di iniziare

  1. 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 senza costi per l'esecuzione, il test e il deployment dei workload.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. (Facoltativo) L'API Spanner dovrebbe essere abilitata automaticamente. In caso contrario, attivalo manualmente:

    Abilita l'API Spanner

  7. Per ottenere le autorizzazioni necessarie per creare istanze e database, chiedi all'amministratore di concederti il ruolo IAM Amministratore Cloud Spanner (roles/spanner.admin) nel progetto.

Crea un'istanza con la console Google Cloud

Quando utilizzi Spanner per la prima volta, devi creare un'istanza, ovvero un'allocazione di risorse utilizzate dai database Spanner in quell'istanza.

  1. Nella console Google Cloud , vai alla pagina Spanner.

    Vai a Spanner

  2. Seleziona o crea un progetto Google Cloud , se non l'hai ancora fatto.

  3. Nella pagina Spanner, fai clic su Crea un'istanza di cui è stato eseguito il provisioning.

    Se hai già utilizzato Spanner, viene visualizzata la pagina Istanze di Spanner anziché la pagina di prodotto. Fai clic su Crea istanza.

  4. Nella sezione Seleziona una versione, seleziona Standard, quindi fai clic su Continua.

  5. Nella sezione Assegna un nome all'istanza, inserisci un Nome istanza, ad esempio Test Instance.

    L'ID istanza viene compilato automaticamente in base al nome dell'istanza, ad esempio test-instance. Se necessario, modificalo e poi fai clic su Continua.

  6. Nella sezione Configura l'istanza, in Scegli una configurazione, mantieni l'opzione predefinita Regionale e seleziona una località di configurazione dal menu a discesa.

    La configurazione dell'istanza determina la posizione geografica in cui le istanze vengono archiviate e replicate.

  7. Fai clic su Continua.

  8. Nella sezione Configura la capacità di calcolo, per Seleziona unità, seleziona Unità di elaborazione (PU). In Scegli una modalità di scalabilità, mantieni Allocazione manuale e la Quantità predefinita di 1000 unità di elaborazione.

  9. (Facoltativo) Nella sezione Backup, deseleziona la casella di controllo Abilita le pianificazioni dei backup predefiniti se non vuoi che vengano create pianificazioni dei backup predefiniti per questa istanza di test.

  10. Fai clic su Crea.

    La console Google Cloud mostra la pagina Panoramica dell'istanza che hai creato.

Crea un database

  1. Nella console Google Cloud , vai alla pagina Istanze Spanner.

    Vai a Istanze Spanner

  2. Fai clic sull'istanza che hai creato, ad esempio Test Instance.

  3. Nella pagina Panoramica dell'istanza che si apre, fai clic su Crea database.

  4. Per il nome del database, inserisci un nome, ad esempio example-db.

  5. Seleziona un dialetto del database.

    Per informazioni sul supporto di PostgreSQL e per indicazioni sulla scelta di un dialetto, consulta Interfaccia PostgreSQL. Lascia vuota la sezione Definisci il tuo schema (facoltativo). Lo schema viene definito in Spanner Studio nella sezione successiva di questa guida rapida.

  6. Fai clic su Crea.

    La console Google Cloud mostra la pagina Panoramica del database che hai creato.

Crea uno schema per il tuo database

  1. Nel menu di navigazione, fai clic su Spanner Studio.

  2. Nella pagina Spanner Studio, fai clic su Nuova scheda o utilizza la scheda Query senza titolo, quindi inserisci una delle seguenti query,
    a seconda del dialetto del tuo database:

    GoogleSQL 

    CREATE TABLE Singers (
  SingerId   INT64 NOT NULL,
  FirstName  STRING(1024),
  LastName   STRING(1024),
  BirthDate  DATE
) PRIMARY KEY(SingerId);

    PostgreSQL 

    CREATE TABLE Singers (
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  BirthDate  TIMESTAMPTZ
);

  3. Fai clic su Esegui.

    Spanner esegue l'istruzione. Al termine, nella scheda Risultati viene visualizzato Aggiornamento completato.

Inserisci e modifica i dati

La console Google Cloud fornisce un'interfaccia per l'inserimento, la modifica e l'eliminazione dei dati.

Inserisci i dati

  1. Nel riquadro Explorer, fai clic su Visualizza azioni per la tabella Singers, quindi su Inserisci dati.

    Spanner apre una nuova scheda di query in Spanner Studio che contiene un'istruzione INSERT del modello.

  2. Modifica la clausola VALUES dell'istruzione INSERT del modello per inserire una riga nella tabella Singers e visualizzare il risultato dell'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,
    FirstName,
    LastName,
    BirthDate)
VALUES
  (1, -- type: INT64
    'Marc', -- type: STRING(1024)
    'Richards', -- type: STRING(1024)
    NULL -- type: DATE
    )
THEN RETURN
  SingerId,
  FirstName,
  LastName,
  BirthDate;

    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,
    firstname,
    lastname,
    birthdate)
VALUES
  (1, -- type: bigint
    'Marc', -- type: character varying
    'Richards', -- type: character varying
    NULL -- type: timestamp with time zone
    )
RETURNING
  singerid,
  firstname,
  lastname,
  birthdate;

    Tieni presente che PostgreSQL converte i nomi delle colonne in lettere minuscole.

  3. Fai clic su Esegui.

    Spanner esegue l'istruzione. Al termine, la scheda Risultati mostra 1 riga inserita e i dati della riga inserita.

  4. Nel riquadro Explorer, fai clic su Visualizza azioni per la tabella Singers, quindi su Inserisci dati.

  5. Modifica la clausola VALUES dell'istruzione INSERT:

    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,
    FirstName,
    LastName,
    BirthDate)
VALUES
  (2, -- type: INT64
    'Catalina', -- type: STRING(1024)
    'Smith', -- type: STRING(1024)
    NULL -- type: DATE
    )
THEN RETURN
  SingerId,
  FirstName,
  LastName,
  BirthDate;

    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,
    firstname,
    lastname,
    birthdate)
VALUES
  (2, -- type: bigint
    'Catalina', -- type: character varying
    'Smith', -- type: character varying
    NULL -- type: timestamp with time zone
    )
RETURNING
  singerid,
  firstname,
  lastname,
  birthdate;

  6. Fai clic su Esegui.

    Spanner esegue l'istruzione. Al termine, la scheda Risultati mostra 1 riga inserita e i dati della riga inserita.

  7. Nel riquadro Explorer, fai clic su Visualizza azioni per la tabella Singers, quindi fai clic su Anteprima dati.

  8. Fai clic su Esegui. Nella scheda Risultati vengono visualizzate le due righe della tabella Singers.

Puoi anche inserire valori di stringa vuoti quando inserisci i dati.

  1. Nel riquadro Explorer, fai clic su Visualizza azioni per la tabella Singers, quindi su Inserisci dati.

    Spanner apre una nuova scheda di query in Spanner Studio che contiene l'istruzione INSERT del modello.

  2. Modifica la clausola VALUES dell'istruzione INSERT del template:

    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,
    FirstName,
    LastName,
    BirthDate)
VALUES
  (3, -- type: INT64
    'Kena', -- type: STRING(1024)
    '', -- type: STRING(1024)
    NULL -- type: DATE
    )
THEN RETURN
  SingerId,
  FirstName,
  LastName,
  BirthDate;

    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,
    firstname,
    lastname,
    birthdate)
VALUES
  (3, -- type: bigint
    'Kena', -- type: character varying
    '', -- type: character varying
    NULL -- type: timestamp with time zone
    )
RETURNING
  singerid,
  firstname,
  lastname,
  birthdate;

  3. Fai clic su Esegui.

    Spanner esegue l'istruzione. Al termine, la scheda Risultati mostra 1 riga inserita e i dati della riga inserita.

    Tieni presente che il valore fornito per la colonna del cognome è una stringa vuota, '', non un valore NULL.

  4. Nel riquadro Explorer, fai clic su Visualizza azioni per la tabella Singers, quindi fai clic su Anteprima dati.

  5. Fai clic su Esegui. La scheda Risultati mostra le tre righe della tabella Singers e la riga con il valore della chiave primaria 3 ha una stringa vuota nella colonna LastName.

Modifica dati

  1. Fai clic su Nuova scheda per creare una nuova scheda di query, quindi inserisci la seguente istruzione UPDATE per aggiornare la data di nascita per la riga con il valore della chiave primaria 3:

    GoogleSQL 

    UPDATE
  Singers
SET
  BirthDate='1961-04-01'
WHERE
  SingerId=3
THEN RETURN
  SingerId,
  FirstName,
  LastName,
  BirthDate;

    PostgreSQL 

    UPDATE
  singers
SET
  birthdate='1961-04-01 00:00:00 -8:00'
WHERE
  singerid=3
RETURNING
  singerid,
  firstname,
  lastname,
  birthdate;

  2. Fai clic su Esegui.

    Spanner esegue l'istruzione. Al termine, la scheda Risultati mostra 1 riga aggiornata e i dati della riga aggiornata.

  3. Nel riquadro Explorer, fai clic su Visualizza azioni per la tabella Singers, quindi fai clic su Anteprima dati.

  4. Fai clic su Esegui. La scheda Risultati mostra le righe della tabella Singers, dove la riga aggiornata ora ha un valore per la data di nascita.

Elimina dati

  1. Fai clic su Nuova scheda per creare una nuova scheda di query, quindi inserisci la seguente istruzione DELETE per eliminare la riga con il valore della chiave primaria 2:

    GoogleSQL 

    DELETE FROM Singers
WHERE SingerId = 2;

    PostgreSQL 

    DELETE FROM singers
WHERE singerid = 2;

  2. Fai clic su Esegui.

    Spanner esegue l'istruzione. Al termine, la scheda Risultati mostra 1 riga eliminata. La tabella Singers ora contiene due righe.

Esegui una query nella console Google Cloud

  1. Fai clic su Nuova scheda per creare una nuova scheda di query. Poi, inserisci la seguente query nell'editor di query:

    GoogleSQL 

    SELECT * FROM Singers;

    PostgreSQL 

    SELECT * FROM singers;

  2. Fai clic su Esegui.

    Spanner esegue la query. Al termine, la scheda Risultati mostra il risultato della query.

Complimenti! Hai creato correttamente un database Spanner ed eseguito un'istruzione SQL utilizzando l'editor di query.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi aggiuntivi, elimina il database e l'istanza. La disattivazione dell'API Cloud Billing non interrompe gli addebiti. Quando elimini un'istanza, vengono eliminati tutti i database al suo interno.

Elimina il database

  1. Nella console Google Cloud , vai alla pagina Istanze Spanner.

    Vai a Istanze Spanner

  2. Fai clic sul nome dell'istanza contenente il database che vuoi eliminare, ad esempio Test Instance.

  3. Fai clic sul nome del database che vuoi eliminare, ad esempio example-db.

  4. Nella pagina Dettagli database, fai clic su Elimina database.

  5. Conferma di voler eliminare il database inserendo il nome del database e facendo clic su Elimina.

Elimina l'istanza

  1. Nella console Google Cloud , vai alla pagina Istanze Spanner.

    Vai a Istanze Spanner

  2. Fai clic sul nome dell'istanza che vuoi eliminare, ad esempio Test Instance.

  3. Fai clic su Elimina istanza.

  4. Conferma di voler eliminare l'istanza inserendo il nome dell'istanza e facendo clic su Elimina.

Passaggi successivi