Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualmente, tu webhook usa datos codificados en la función
accountBalanceCheck.
En este paso del instructivo,
crearás una
base de datos de
Spanner, la propagarás con datos de saldo
y actualizarás tu función para consultar la base de datos.
Configuración de proyectos
Es importante que el agente de Dialogflow y la base de datos
estén en el mismo proyecto.
Esta es la forma más fácil para que tu función tenga acceso seguro a tu base de datos.
Además, debes habilitar la API de Spanner.
Antes de crear la base de datos,
selecciona tu proyecto en la consola de Google Cloud .
Cuando uses Spanner por primera vez, deberás crear una instancia, que es una asignación de recursos que usan las bases de datos de Spanner en esa instancia.
En la consola de Google Cloud , ve a la página Instancias de Spanner.
Haz clic en Enviar.
La Google Cloud consola regresa a la página Descripción general de la base de datos y muestra que se están realizando actualizaciones de esquemas.
Espera a que se complete la actualización.
En la sección Tablas de la página Descripción general de la base de datos, haz clic en Crear tabla.
En la página Escribe declaraciones DDL, ingresa lo siguiente:
Haz clic en Enviar.
La Google Cloud consola regresa a la página Descripción general de la base de datos y muestra que se están realizando actualizaciones de esquemas.
Espera a que se complete la actualización.
Cómo insertar datos en tus tablas
Ahora que tu base de datos tiene tablas,
debes agregar datos a ellas.
Para agregar datos, sigue estos pasos:
En la lista de tablas de la página Descripción general de la base de datos, haz clic en la tabla de verificación.
La Google Cloud consola muestra la página Esquema de la tabla.
En el menú de navegación de la izquierda, haz clic en Datos para mostrar la página Datos de la tabla.
Haga clic en Insert.
La Google Cloud consola muestra la página Consulta de la tabla con una pestaña de consulta nueva que contiene sentencias INSERT y SELECT.
Reemplaza esas sentencias con lo siguiente:
En el menú de navegación de la izquierda, vuelve a hacer clic en Datos para mostrar los datos de la tabla.
Confirma que la tabla contenga los datos deseados.
Haz clic en el vínculo tutorial-database: Overview para volver a la página de descripción general de la base de datos.
En la lista de tablas de la página Descripción general de la base de datos, haz clic en la tabla Ahorros.
La Google Cloud consola muestra la página Esquema de la tabla.
En el menú de navegación de la izquierda, haz clic en Datos para mostrar la página Datos de la tabla.
Haga clic en Insert.
La Google Cloud consola muestra la página Consulta de la tabla con una pestaña de consulta nueva que contiene sentencias INSERT y SELECT.
Reemplaza esas sentencias con lo siguiente:
En el menú de navegación de la izquierda, vuelve a hacer clic en Datos para mostrar los datos de la tabla.
Confirma que la tabla contenga los datos deseados.
Actualiza la Cloud Function para consultar la base de datos
La función accountBalanceCheck en el código del webhook verifica si se configuraron variables de entorno específicas con información para conectarse a la base de datos.
Si no se configuran estas variables de entorno, la función usa un saldo de cuenta codificado.
Ahora que tienes una base de datos configurada,
actualiza tu Cloud Function para establecer las variables de entorno necesarias:
Abre la página Descripción general de Cloud Functions:
Haz clic en la función tutorial-banking-webhook para ir a su página de detalles.
Haz clic en Editar.
Abre la sección Configuración de entorno de ejecución, compilación y conexiones.
Selecciona la pestaña Entorno de ejecución.
Agrega las siguientes variables en la sección Variables de entorno de ejecución:
PROJECT_ID: El ID de tu proyecto
SPANNER_INSTANCE_ID: El ID de tu instancia de Spanner (probablemente tutorial-instance)
SPANNER_DATABASE_ID: El ID de tu base de datos de Spanner (probablemente, tutorial-database)
Haz clic en Siguiente.
Haz clic en Implementar.
Espera hasta que el indicador de estado muestre que la función se implementó correctamente.
Prueba tu agente
Ya puedes probar el agente.
Haz clic en el botón Test Agent de la consola de Dialogflow para abrir el simulador.
Intenta tener la siguiente conversación con el agente:
Turno de conversación
Tú
Agente
1
Hola
Hola, gracias por elegir el Banco ACME.
2
Quiero conocer el saldo de mi cuenta
¿Para qué cuenta quieres el saldo: ahorros o corriente?
3
En verificación
Este es tu saldo más reciente: USD 10.00
Si examinas el código, $10 no es el valor codificado.
Esto significa que tu webhook se conectó correctamente a la base de datos, que tiene un saldo de USD 10.
Soluciona problemas
El código del webhook incluye instrucciones de registro.
Si tienes problemas, intenta ver los registros de tu Cloud Function.
Si tu función no se conecta a la base de datos y ves un error de permiso en los registros, es posible que debas corregir el rol de la cuenta de servicio predeterminada que usa tu función.
Esta cuenta de servicio tiene el formato PROJECT_ID@appspot.gserviceaccount.com.
Puedes solucionar este problema de una de las siguientes maneras:
Si la cuenta de servicio predeterminada se muestra en la página principal de IAM, cambia los permisos de la cuenta de servicio.
El rol de editor funcionará,
pero es posible que desees un rol más detallado en una situación de producción.
Si no se muestra una cuenta de servicio predeterminada en la página principal de IAM, otorga el rol requerido agregando la cuenta de servicio como un principal nuevo.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThis tutorial guides you through replacing hardcoded data in a webhook's \u003ccode\u003eaccountBalanceCheck\u003c/code\u003e function with a Spanner database.\u003c/p\u003e\n"],["\u003cp\u003eYou will learn how to create a Spanner instance and database, and populate it with account balance data in \u003ccode\u003eChecking\u003c/code\u003e and \u003ccode\u003eSavings\u003c/code\u003e tables.\u003c/p\u003e\n"],["\u003cp\u003eThe process includes enabling the Spanner API, setting up project configurations, defining the database schema with tables, and inserting data into those tables.\u003c/p\u003e\n"],["\u003cp\u003eThe final steps cover updating the Cloud Function's runtime environment variables to connect to the newly created database and deploying these changes.\u003c/p\u003e\n"],["\u003cp\u003eAfter deployment, the tutorial provides instructions to test your agent and details on troubleshooting connection or permission errors using the function's logs and the IAM page.\u003c/p\u003e\n"]]],[],null,["# Query a database\n\nYour webhook currently uses hardcoded data in the\n`accountBalanceCheck` function.\nIn this step of the tutorial,\nyou will create a\n[Spanner](/spanner/docs)\ndatabase, populate it with balance data,\nand update your function to query the database.\n\nProject configuration\n---------------------\n\nIt is important that your Dialogflow agent and the database\nare both in the same project.\nThis is the easiest way for your function to have\nsecure access to your database.\nAlso, you must enable the Spanner API.\n\n1. Before creating the database,\n select your project from the Google Cloud console.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n2. Enable the Spanner API for the project.\n\n [Enable the Spanner API](https://console.cloud.google.com/flows/enableapi?apiid=spanner.googleapis.com)\n\nCreate a Spanner instance\n-------------------------\n\nWhen you first use Spanner,\nyou must create an instance,\nwhich is an allocation of resources\nthat are used by Spanner databases in that instance.\n\n1. In the Google Cloud console, go to the **Spanner Instances** page.\n\n [Go to Spanner instances](https://console.cloud.google.com/spanner/instances)\n2. Click **Create instance**.\n\n3. For the instance name, enter **Tutorial Instance**.\n\n4. The instance ID is automatically entered based on the instance name.\n\n5. In **Choose your configuration** ,\n retain the default option **Regional** and select the same region\n [location](/dialogflow/es/docs/how/region)\n that you chose when creating the function.\n\n6. In **Allocate compute capacity**,\n enter 100 processing units.\n This provides a minimal capacity for the tutorial.\n\n7. Click **Create** .\n The Google Cloud console displays the **Overview** page for the instance\n you created.\n\nCreate a Spanner database\n-------------------------\n\nNow that you have an instance,\nyou need to create a database.\nTo create a database:\n\n1. In the instance **Overview** page, click **Create database**.\n2. For the database name, enter **tutorial-database**.\n3. Select the **Google Standard SQL** database dialect.\n4. Click **Create** . The Google Cloud console displays the **Overview** page for the database you created.\n\nCreate tables for your database\n-------------------------------\n\nNow that you have a database,\nyou need to create tables for the database.\nTo create tables:\n\n1. In the Tables section of the database **Overview** page, click **Create table**.\n2. In the **Write DDL statements** page, enter:\n\n CREATE TABLE Checking (\n AccountId INT64,\n Balance INT64,\n ) PRIMARY KEY(AccountId);\n\n3. Click **Submit** .\n The Google Cloud console returns to the database **Overview** page and\n shows that **Schema updates** are underway.\n Wait until the update is complete.\n\n4. In the Tables section of the database **Overview** page,\n click **Create table**.\n\n5. In the **Write DDL statements** page, enter:\n\n CREATE TABLE Savings (\n AccountId INT64,\n Balance INT64,\n ) PRIMARY KEY(AccountId);\n\n6. Click **Submit** .\n The Google Cloud console returns to the database **Overview** page and\n shows that **Schema updates** are underway.\n Wait until the update is complete.\n\nInsert data into your tables\n----------------------------\n\nNow that your database has tables,\nyou need to add data to the tables.\nTo add data:\n\n1. In the list of tables on the database **Overview** page, click the Checking table. The Google Cloud console displays the table's **Schema** page.\n2. In the left navigation menu, click **Data** to display the table's **Data** page.\n3. Click **Insert** .\n The Google Cloud console displays the table's **Query** page with a\n new query tab that contains `INSERT` and `SELECT` statements.\n Overwrite those statements with the following:\n\n INSERT INTO Checking (AccountId, Balance)\n VALUES(1, 1000),\n (2, 2000);\n\n4. Click **Run**.\n\n5. In the left navigation menu,\n click **Data** again to display the table's data.\n Confirm that the table contains the desired data.\n\n6. Click the **tutorial-database: Overview** link\n to return to the database overview page.\n\n7. In the list of tables on the database **Overview** page,\n click the Savings table.\n The Google Cloud console displays the table's **Schema** page.\n\n8. In the left navigation menu,\n click **Data** to display the table's **Data** page.\n\n9. Click **Insert** .\n The Google Cloud console displays the table's **Query** page with a\n new query tab that contains `INSERT` and `SELECT` statements.\n Overwrite those statements with the following:\n\n INSERT INTO Savings (AccountId, Balance)\n VALUES(1, 10000),\n (2, 20000);\n\n10. Click **Run**.\n\n11. In the left navigation menu,\n click **Data** again to display the table's data.\n Confirm that the table contains the desired data.\n\nUpdate the Cloud Function to query the database\n-----------------------------------------------\n\nThe `accountBalanceCheck` function in the webhook code\nchecks whether specific environment variables are set\nwith information for connecting to the database.\nIf these environment variables are not set,\nthe function uses a hardcoded account balance.\n\nNow that you have a database set up,\nupdate your Cloud Function to set required environment variables:\n\n1. Open the Cloud Functions overview page.\n\n [Go to Cloud Functions overview](https://console.cloud.google.com/functions/list)\n2. Click the tutorial-banking-webhook function to go to its details page.\n\n3. Click **Edit**.\n\n4. Open the **Runtime, build and connections settings** section.\n\n5. Select the **Runtime** tab.\n\n6. Add the following variables in the Runtime environment variables section:\n\n - `PROJECT_ID`: your project ID\n - `SPANNER_INSTANCE_ID`: your Spanner instance ID (probably `tutorial-instance`)\n - `SPANNER_DATABASE_ID`: your spanner database ID (probably `tutorial-database`)\n7. Click **Next**.\n\n8. Click **Deploy**.\n\n9. Wait until the status indicator shows that the function\n has successfully deployed.\n\nTest your agent\n---------------\n\nYour agent is now ready to try.\nClick the **Test Agent** button from the Dialogflow console\nto open the simulator.\nAttempt to have the following conversation with the agent:\n\nIf you examine the code,\n$10 is not the hardcoded value.\nThis means that your webhook has successfully connected to the database,\nwhich does have a balance of $10.\n\nTroubleshooting\n---------------\n\nThe webhook code includes logging statements.\nIf you are having issues, try viewing the logs for your Cloud Function.\n\nIf your function is not connecting to the database,\nand you see a permission error in the logs,\nyou may need to fix the role for the default service account\nused by your function.\nThis service account is of the form\n\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`@appspot.gserviceaccount.com`.\nYou can fix this in one of the following ways:\n\n- If the default service account is shown on the IAM main page,\n [change permissions for the service account](/functions/docs/securing/function-identity#default).\n The *Editor* role will work,\n but you may want a more granular role in a production scenario.\n\n [Go to the IAM main page](https://console.cloud.google.com/iam-admin/iam)\n- If the a default service account is not shown on the IAM main page,\n [grant the required role](/iam/docs/grant-role-console#grant_an_iam_role)\n by adding the service account as a new principal.\n\n- Alternatively, you can\n [use a service account that you create](/functions/docs/securing/function-identity#individual).\n\nMore information\n----------------\n\nFor more information about the steps above, see:\n\n- [Using Cloud Spanner with Cloud Functions](/functions/docs/tutorials/use-cloud-spanner)\n- [Create and query a database by using the Google Cloud console](/spanner/docs/create-query-database-console)\n- [Google Standard SQL data definition language](/spanner/docs/reference/standard-sql/data-definition-language)\n- [Google Standard SQL data manipulation language](/spanner/docs/reference/standard-sql/dml-syntax)"]]
