Consultar um banco de dados

No momento, seu webhook usa dados codificados na função accountBalanceCheck. Nesta etapa do tutorial, você vai criar um banco de dados do Spanner, preenchê-lo com dados de saldo e atualizar a função para consultar o banco de dados.

Configuração do projeto

É importante que o agente do Dialogflow e o banco de dados estejam no mesmo projeto. Essa é a maneira mais fácil de a função ter acesso seguro ao banco de dados. Além disso, você precisa ativar a API Spanner.

1. Antes de criar o banco de dados, selecione seu projeto no console do Google Cloud.

   Acessar o seletor de projetos

2. Ative a API Spanner para o projeto.

   Ativar a API Spanner

Criar uma instância do Spanner

Ao usar o Spanner pela primeira vez, é necessário criar uma instância, que é uma alocação de recursos usados pelos bancos de dados do Spanner nessa instância.

1. No console do Google Cloud, acesse a página Instâncias do Spanner.

   Acessar as instâncias do Spanner

2. Clique em Criar instância.

3. Para o nome da instância, insira Instância do tutorial.

4. O ID da instância é inserido automaticamente com base no nome dela.

5. Em Escolher a configuração, mantenha a opção padrão Regional e selecione a mesma região localização escolhida ao criar a função.

6. Em Alocar capacidade de computação, insira 100 unidades de processamento. Isso fornece uma capacidade mínima para o tutorial.

7. Clique em Criar. O console do Google Cloud mostra a página Visão geral da instância criada.

Criar um banco de dados do Spanner

Agora que você tem uma instância, é necessário criar um banco de dados. Para criar um banco de dados:

1. Na página Visão geral da instância, clique em Criar banco de dados.
2. Para o nome do banco de dados, digite tutorial-database.
3. Selecione o dialeto do banco de dados SQL padrão do Google.
4. Clique em Criar. O console do Google Cloud mostra a página Visão geral do banco de dados que você criou.

Criar tabelas para seu banco de dados

Agora que você tem um banco de dados, é necessário criar tabelas para ele. Para criar tabelas:

1. Na seção "Tabelas" da página Visão geral do banco de dados, clique em Criar tabela.

2. Na página Escrever instruções DDL, insira:

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

3. Clique em Enviar. O console do Google Cloud retorna à página Visão geral do banco de dados e mostra que as atualizações do esquema estão em andamento. Aguarde a conclusão da atualização.

4. Na seção "Tabelas" da página Visão geral do banco de dados, clique em Criar tabela.

5. Na página Escrever instruções DDL, insira:

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

6. Clique em Enviar. O console do Google Cloud retorna à página Visão geral do banco de dados e mostra que as atualizações do esquema estão em andamento. Aguarde a conclusão da atualização.

Inserir dados nas tabelas

Agora que o banco de dados tem tabelas, é necessário adicionar dados a elas. Para adicionar dados:

1. Na lista de tabelas na página Visão geral do banco de dados, clique na tabela de verificação. O console do Google Cloud exibe a página Esquema da tabela.
2. No menu de navegação à esquerda, clique em Dados para mostrar a página Dados da tabela.

3. Clique em Inserir. O console do Google Cloud mostra a página Consulta da tabela com uma nova guia de consulta que contém instruções INSERT e SELECT. Substitua essas instruções por:

   INSERT INTO Checking (AccountId, Balance)
   VALUES(1, 1000),
         (2, 2000);
   

4. Clique em Executar.

5. No menu de navegação à esquerda, clique em Dados novamente para mostrar os dados da tabela. Confirme se a tabela contém os dados desejados.

6. Clique no link tutorial-database: Overview para voltar à página de visão geral do banco de dados.

7. Na lista de tabelas na página Visão geral do banco de dados, clique na tabela "Savings". O console do Google Cloud exibe a página Esquema da tabela.

8. No menu de navegação à esquerda, clique em Dados para mostrar a página Dados da tabela.

9. Clique em Inserir. O console do Google Cloud mostra a página Consulta da tabela com uma nova guia de consulta que contém instruções INSERT e SELECT. Substitua essas instruções por:

   INSERT INTO Savings (AccountId, Balance)
   VALUES(1, 10000),
         (2, 20000);
   

10. Clique em Executar.

11. No menu de navegação à esquerda, clique em Dados novamente para mostrar os dados da tabela. Confirme se a tabela contém os dados desejados.

Atualizar a função do Cloud para consultar o banco de dados

A função accountBalanceCheck no código do webhook verifica se variáveis de ambiente específicas são definidas com informações para se conectar ao banco de dados. Se essas variáveis de ambiente não estiverem definidas, a função vai usar um saldo de conta codificado.

Agora que você configurou um banco de dados, atualize a função do Cloud para definir as variáveis de ambiente necessárias:

1. Abra a página de visão geral do Cloud Functions.

   Acessar a página de visão geral do Cloud Functions

2. Clique na função tutorial-banking-webhook para acessar a página de detalhes dela.

3. Clique em Editar.

4. Abra a seção Configurações de ambiente de execução, criação e conexões.

5. Selecione a guia Ambiente de execução.

6. Adicione as seguintes variáveis na seção "Variáveis de ambiente de execução":

   • PROJECT_ID: ID do projeto;
   • SPANNER_INSTANCE_ID: o ID da instância do Spanner (provavelmente tutorial-instance)
   • SPANNER_DATABASE_ID: o ID do banco de dados do Spanner (provavelmente tutorial-database)

7. Clique em Próxima.

8. Clique em Implantar.

9. Aguarde até que o indicador de status mostre que a função foi implantada.

Testar o agente

Seu agente está pronto para ser testado. Clique no botão Test Agent no console do Dialogflow para abrir o simulador. Tente ter a seguinte conversa com o agente:

Turno de conversa	Você	Agente
1	Olá	Olá, agradecemos por escolher o ACME Bank.
2	Quero saber o saldo da minha conta	Qual conta você quer consultar o saldo: poupança ou corrente?
3	Verificando	Seu saldo mais recente é de US$ 10,00.

Se você examinar o código, $10 não é o valor codificado em disco. Isso significa que seu webhook foi conectado ao banco de dados, que tem um saldo de US $10.

Solução de problemas

O código do webhook inclui instruções de registro. Se você tiver problemas, tente ver os registros da sua Função do Cloud.

Se a função não estiver se conectando ao banco de dados e você encontrar um erro de permissão nos registros, talvez seja necessário corrigir o papel da conta de serviço padrão usada pela função. Esta conta de serviço tem o formato [e-mail]. Você pode corrigir isso de uma das seguintes maneiras:

• Se a conta de serviço padrão aparecer na página principal do IAM, mude as permissões da conta de serviço. A função Editor vai funcionar, mas talvez você queira uma função mais granular em um cenário de produção.

  Acessar a página principal do IAM

• Se uma conta de serviço padrão não aparecer na página principal do IAM, conceda o papel necessário adicionando a conta de serviço como um novo principal.

• Também é possível usar uma conta de serviço criada.

Mais informações

Para mais informações sobre as etapas acima, consulte:

• Como usar o Cloud Spanner com Cloud Functions
• Criar e consultar um banco de dados usando o console do Google Cloud
• Linguagem de definição de dados SQL padrão do Google
• Linguagem de manipulação de dados SQL padrão do Google