Cómo consultar una base de datos

Actualmente, tu webhook usa datos codificados de forma rígida en la función cruisePlanCoverage. En este paso del instructivo, crearás una base de datos de Spanner, la completarás con los destinos cubiertos y actualizarás tu función para consultar la base de datos.

Configuración de proyectos

Es importante que tu 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.

1. Antes de crear la base de datos, selecciona tu proyecto en la consola de Google Cloud .

   Ir al selector de proyectos

2. Habilita la API de Spanner para el proyecto.

   Habilita la API de Spanner

Crear una instancia de Spanner

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.

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a Instancias de Spanner

2. Haz clic en Crear instancia.

3. En el nombre de la instancia, ingresa Instancia del instructivo.

4. El ID de instancia se ingresa automáticamente según el nombre de la instancia.

5. En Elige tu configuración, conserva la opción predeterminada Regional y selecciona la misma ubicación que elegiste cuando creaste la función.

6. En Asignar capacidad de procesamiento, ingresa 100 unidades de procesamiento. Esto proporciona una capacidad mínima para el instructivo.

7. Haz clic en Crear. La consola de Google Cloud muestra la página Descripción general de la instancia que creaste.

Crear una base de datos de Spanner

Ahora que tienes una instancia, debes crear una base de datos. Sigue estos pasos para crear una base de datos:

1. En la página Descripción general de la instancia, haz clic en Crear base de datos.
2. En el nombre de la base de datos, escribe tutorial-database.
3. Selecciona el dialecto de la base de datos SQL estándar de Google.
4. Haz clic en Crear. La consola de Google Cloud muestra la página Descripción general de la base de datos que creaste.

Crea una tabla para tu base de datos

Ahora que tienes una base de datos, debes crear una tabla para ella. Para crear una tabla, sigue estos pasos:

1. En la sección Tablas de la página Descripción general de la base de datos, haz clic en Crear tabla.

2. En la página Escribe declaraciones DDL, ingresa lo siguiente:

   CREATE TABLE Destinations (
     Destination STRING(1024),
     Covered BOOL,
   ) PRIMARY KEY(Destination);
   

3. Haz clic en Enviar. La consola de Google Cloud regresa a la página Descripción general de la base de datos y muestra que las actualizaciones del esquema están en curso. Espera hasta que se complete la actualización.

Inserta datos en tu tabla

Ahora que tu base de datos tiene una tabla, debes agregarle datos. Para agregar datos, sigue estos pasos:

1. En la lista de tablas de la página Overview de la base de datos, haz clic en la tabla Destinations. La consola de Google Cloud muestra la página Esquema de la tabla Destinos.
2. En el menú de navegación de la izquierda, haz clic en Datos para mostrar la página Datos de la tabla Destinos.

3. Haz clic en Insertar. La consola Google Cloud muestra la página Consulta de la tabla Destinations con una nueva pestaña de consulta que contiene las instrucciones INSERT y SELECT. Reemplaza esas instrucciones con lo siguiente:

   INSERT INTO Destinations (Destination, Covered)
   VALUES('anguilla', TRUE),
         ('canada', TRUE),
         ('china', TRUE),
         ('italy', TRUE),
         ('mexico', TRUE),
         ('spain', FALSE);
   

4. Haz clic en Ejecutar.

5. En el menú de navegación de la izquierda, vuelve a hacer clic en Datos para mostrar los datos de la tabla de destino. Confirma que la tabla contenga los datos deseados.

Actualiza Cloud Function para consultar la base de datos

La función cruisePlanCoverage 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 estas variables de entorno no están configuradas, la función usa una lista codificada de forma rígida de destinos.

Ahora que tienes configurada una base de datos, actualiza tu Cloud Function para establecer las variables de entorno requeridas:

1. Abre la página Descripción general de Cloud Functions:

   Ir a la descripción general de Cloud Functions

2. Haz clic en la función tutorial-telecommunications-webhook para ir a su página de detalles.

3. Haz clic en Editar.

4. Abre la sección Configuración del entorno de ejecución, la compilación, las conexiones y la seguridad.

5. Selecciona la pestaña Entorno de ejecución.

6. Agrega las siguientes variables en la sección Variables de entorno de ejecución:

   • PROJECT_ID: Es el ID del 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)

7. Haz clic en Siguiente.

8. Haz clic en Implementar.

9. Espera hasta que el indicador de estado muestre que la función se implementó correctamente.

Prueba tu agente

Tu agente ya está listo para probarse. Haz clic en el botón Probar agente en 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! Soy el agente virtual de telecomunicaciones. Puedo ayudarte a resolver preguntas sobre facturación y planes, solucionar problemas y agregar planes de viajes y cruceros. ¿En qué puedo ayudarte hoy?
2	Quiero agregar un plan de crucero	Déjame echarle un vistazo. ¿Cuál es tu número de teléfono?
3	123-123-1234	¿Cuántos días dura tu crucero?
4	7	La opción 1 incluye llamadas y mensajes de texto. Cuesta USD [XX] por día. Obtén más información aquí [URL]. La opción 2 incluye llamadas, mensajes de texto y datos. Cuesta USD [XX] por día. Obtén más información aquí [URL]. ¿Qué plan de crucero quieres agregar?
5	Opción 1	Entendido. Agregué ese plan a tu cuenta. Durante el crucero, es posible que también necesites cobertura en tierra. ¿En qué puerto harás una parada?
6	Italia	¿Y cuántos días pasarás allí?
7	3	¡Excelentes noticias! Italia tiene cobertura gratuita en tierra. ¡Listo! ¿Hay algo más con lo que pueda ayudarte?

Si examinas el código, verás que Italia no está en la lista codificada de destinos cubiertos. Esto significa que tu webhook se conectó correctamente a la base de datos, que incluye a Italia.

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 [e-mail]. 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.

  Ir a la página principal de IAM

• 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.

• Como alternativa, puedes usar una cuenta de servicio que crees.

Más información

Para obtener más información sobre los pasos anteriores, consulta los siguientes recursos:

• Usa Cloud Spanner con Cloud Functions
• Crea y consulta una base de datos con la consola de Google Cloud
• Lenguaje de definición de datos de SQL estándar de Google
• Lenguaje de manipulación de datos de SQL estándar de Google