Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Esegui una query su un database

Al momento, il webhook utilizza dati impostati come hardcoded nella funzione accountBalanceCheck. In questo passaggio del tutorial, creerai un database Spanner, lo compilerai con i dati del saldo e aggiornerai la funzione per eseguire query sul database.

Configurazione progetto

È importante che l'agente Dialogflow e il database si trovino nello stesso progetto. Questo è il modo più semplice per consentire alla tua funzione di accedere in modo sicuro al tuo database. Inoltre, devi abilitare l'API Spanner.

Prima di creare il database, seleziona il progetto dalla console Google Cloud .

Vai al selettore di progetti
Abilitare l'API Spanner per il progetto.

Abilita l'API Spanner

Creazione di un'istanza Spanner

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 Istanze Spanner.

Vai a Istanze Spanner
Fai clic su Crea istanza.
Come nome dell'istanza, inserisci Tutorial Instance.
L'ID istanza viene inserito automaticamente in base al nome dell'istanza.
In Scegli la configurazione, mantieni l'opzione predefinita Regionale e seleziona la stessa località della regione che hai scelto durante la creazione della funzione.
In Alloca capacità di calcolo, inserisci 100 unità di elaborazione. In questo modo, viene fornita una capacità minima per il tutorial.
Fai clic su Crea. La console Google Cloud visualizza la pagina Panoramica dell'istanza che hai creato.

Creazione di un database Spanner

Ora che hai un'istanza, devi creare un database. Per creare un database:

Nella pagina Panoramica dell'istanza, fai clic su Crea database.
Come nome del database, inserisci tutorial-database.
Seleziona il dialetto del database Google SQL standard.
Fai clic su Crea. La console Google Cloud visualizza la pagina Panoramica del database che hai creato.

Crea tabelle per il tuo database

Ora che hai un database, devi creare le tabelle per il database. Per creare tabelle:

Nella sezione Tabelle della pagina Panoramica del database, fai clic su Crea tabella.

Nella pagina Scrivi istruzioni DDL, inserisci:

CREATE TABLE Checking (
  AccountId INT64,
  Balance INT64,
) PRIMARY KEY(AccountId);

Fai clic su Invia. La console Google Cloud torna alla pagina Panoramica del database e mostra che gli aggiornamenti dello schema sono in corso. Attendi il completamento dell'aggiornamento.
Nella sezione Tabelle della pagina Panoramica del database, fai clic su Crea tabella.

Nella pagina Scrivi istruzioni DDL, inserisci:

CREATE TABLE Savings (
  AccountId INT64,
  Balance INT64,
) PRIMARY KEY(AccountId);

Fai clic su Invia. La console Google Cloud torna alla pagina Panoramica del database e mostra che gli aggiornamenti dello schema sono in corso. Attendi il completamento dell'aggiornamento.

Inserisci i dati nelle tabelle

Ora che il database contiene tabelle, devi aggiungere dati alle tabelle. Per aggiungere dati:

Nell'elenco delle tabelle nella pagina Panoramica del database, fai clic sulla tabella Checking. La console Google Cloud visualizza la pagina Schema della tabella.
Nel menu di navigazione a sinistra, fai clic su Dati per visualizzare la pagina Dati della tabella.
Fai clic su Inserisci. La console Google Cloud mostra la pagina Query della tabella con una nuova scheda di query che contiene le istruzioni INSERT e SELECT. Sovrascrivi queste istruzioni con le seguenti:
```
INSERT INTO Checking (AccountId, Balance)
VALUES(1, 1000),
      (2, 2000);
```
Fai clic su Esegui.
Nel menu di navigazione a sinistra, fai di nuovo clic su Dati per visualizzare i dati della tabella. Verifica che la tabella contenga i dati desiderati.
Fai clic sul link tutorial-database: Panoramica per tornare alla pagina Panoramica del database.
Nell'elenco delle tabelle nella pagina Panoramica del database, fai clic sulla tabella Risparmi. La console Google Cloud visualizza la pagina Schema della tabella.
Nel menu di navigazione a sinistra, fai clic su Dati per visualizzare la pagina Dati della tabella.
Fai clic su Inserisci. La console Google Cloud mostra la pagina Query della tabella con una nuova scheda di query che contiene le istruzioni INSERT e SELECT. Sovrascrivi queste istruzioni con le seguenti:
```
INSERT INTO Savings (AccountId, Balance)
VALUES(1, 10000),
      (2, 20000);
```
Fai clic su Esegui.
Nel menu di navigazione a sinistra, fai di nuovo clic su Dati per visualizzare i dati della tabella. Verifica che la tabella contenga i dati desiderati.

Aggiorna la Cloud Function per eseguire query sul database

La funzione accountBalanceCheck nel codice del webhook controlla se sono impostate variabili di ambiente specifiche con informazioni per la connessione al database. Se queste variabili di ambiente non sono impostate, la funzione utilizza un saldo dell'account impostato come hardcoded.

Ora che hai configurato un database, aggiorna la Cloud Function per impostare le variabili di ambiente richieste:

Apri la pagina Panoramica di Cloud Functions.

Vai alla panoramica di Cloud Functions
Fai clic sulla funzione tutorial-banking-webhook per andare alla relativa pagina dei dettagli.
Fai clic su Modifica.
Apri la sezione Impostazioni di runtime, build e connessioni.
Seleziona la scheda Runtime.
Aggiungi le seguenti variabili nella sezione Variabili di ambiente runtime:
- PROJECT_ID: il tuo ID progetto
- SPANNER_INSTANCE_ID: l'ID istanza Spanner (probabilmente tutorial-instance)
- SPANNER_DATABASE_ID: l'ID del tuo database Spanner (probabilmente tutorial-database)
Fai clic su Avanti.
Fai clic su Esegui il deployment.
Attendi finché l'indicatore di stato non mostra che il deployment della funzione è stato eseguito correttamente.

Testa l'agente

Ora l'agente è pronto per essere provato. Fai clic sul pulsante Test Agent nella console Dialogflow per aprire il simulatore. Prova ad avere la seguente conversazione con l'agente:

Turno di conversazione	Tu	Agente
1	Ciao	Ciao, grazie per aver scelto ACME Bank.
2	Voglio conoscere il saldo dell'account	Di quale conto vuoi conoscere il saldo: risparmio o corrente?
3	In fase di controllo	Ecco il tuo saldo più recente: 10,00 $

Se esamini il codice, 10 $ non è il valore impostato come hardcoded. Ciò significa che il webhook si è connesso correttamente al database, che ha un saldo di 10 $.

Risoluzione dei problemi

Il codice del webhook include istruzioni di log. Se riscontri problemi, prova a visualizzare i log della Cloud Function.

Se la funzione non si connette al database e visualizzi un errore di autorizzazione nei log, potresti dover correggere il ruolo per il account di servizio predefinito utilizzato dalla funzione. Questo account di servizio è nel formato PROJECT_ID@. Puoi risolvere il problema in uno dei seguenti modi:

Se il account di servizio predefinito viene visualizzato nella pagina principale di IAM, modifica le autorizzazioni per il service account. Il ruolo Editor funzionerà, ma potresti volere un ruolo più granulare in uno scenario di produzione.

Vai alla pagina principale di IAM
Se nella pagina principale di IAM non viene visualizzato un account di servizio predefinito, concedi il ruolo richiesto aggiungendo il account di servizio come nuova entità.
In alternativa, puoi utilizzare un account di servizio creato da te.