Objetivos
Escribe, implementa y activa una función de HTTP de Cloud Functions que tenga acceso a Spanner.
Costos
En este documento, se usan Spanner y Cloud Run, que son componentes facturables de Google Cloud.
Para obtener información sobre el costo de usar Spanner, consulta Precios de Spanner.
Para obtener información sobre el costo del uso de Cloud Run, incluidas las invocaciones gratuitas, consulta Precios de Cloud Run.
Antes de comenzar
En este documento, se supone que tienes una instancia de Spanner llamada
test-instance
y una base de datos llamadaexample-db
que usa el esquema de la aplicación de música. Para obtener instrucciones sobre cómo crear una instancia y una base de datos con el esquema de la aplicación de música, consulta la Guía de inicio rápido sobre el uso de Console o los instructivos para comenzar a usar Node.js o Python.Habilita las APIs de Cloud Run Functions, Cloud Run y Cloud Build.
Instala e inicializa la CLI de gcloud.
Si ya tienes instalada la CLI de gcloud, ejecuta el siguiente comando para actualizarla:
gcloud components update
Prepara tu entorno de desarrollo:
Node.js
Consulta la guía de configuración de Node.js.
Python
Consulta la guía de configuración de Python.
Prepara la aplicación
Clona el repositorio de la app de muestra en tu máquina local:
Node.js
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
De manera opcional, puedes descargar la muestra como un archivo zip y extraerla.
Cambia al directorio que contiene el código de muestra de Cloud Run Functions para acceder a Spanner:
Node.js
cd nodejs-docs-samples/functions/spanner
Python
cd python-docs-samples/functions/spanner
Ve el código de muestra:
Node.js
Python
La función envía una consulta de SQL para recuperar todos los datos de
Albums
de tu base de datos. La función se ejecuta cuando haces una solicitud HTTP al extremo de la función.
Implementa la función
Ejecuta el siguiente comando en el directorio spanner
para implementar la función con un activador HTTP:
Node.js
gcloud beta run deploy nodejs-spanner-function \
--source . \
--region REGION \
--function spannerQuickstart \
--base-image RUNTIME_ID \
--log-http
Python
gcloud beta run deploy python-spanner-function \
--source . \
--region REGION \
--function spanner_read_data \
--base-image RUNTIME_ID \
--log-http
Reemplaza lo siguiente:
REGION por el nombre de la regiónGoogle Cloud en la que deseas implementar tu función (por ejemplo,
us-west1
).RUNTIME_ID con el ID de entorno de ejecución adecuado (por ejemplo,
nodejs22
). Consulta Entornos de ejecución de lenguajes y imágenes base compatibles.
La implementación de la función puede tardar hasta dos minutos.
Ten en cuenta el valor de url
que se muestra cuando tu función termina de implementarse. Lo usarás cuando actives la función.
Puedes ver las funciones implementadas en la página Cloud Run de la consola de Google Cloud. También puedes crear y editar funciones en esa página, en la que además puedes obtener detalles y diagnósticos de tus funciones.
Activa la función
Haz una solicitud HTTP a tu función:
curl URL
Reemplaza URL por el valor de la URL que se muestra cuando la función se termina de implementar.
Deberías ver una respuesta que muestre los resultados de la consulta de SQL, suponiendo que trabajaste con un instructivo de introducción y propagaste la base de datos:
SingerId: 2, AlbumId: 2, AlbumTitle: Forever Hold Your Peace
SingerId: 1, AlbumId: 2, AlbumTitle: Go, Go, Go
SingerId: 2, AlbumId: 1, AlbumTitle: Green
SingerId: 2, AlbumId: 3, AlbumTitle: Terrified
SingerId: 1, AlbumId: 1, AlbumTitle: Total Junk
También puedes visitar la URL de la función en tu navegador para ver los resultados de tu consulta de SQL.
Limpia
Para evitar incurrir en cargos adicionales a tu cuenta de Google Cloud por los recursos de Spanner y Cloud Run Functions que se usaron en este documento, haz lo siguiente:
Borra la instancia:
gcloud CLI instances delete test-instance
Usa este comando para borrar el servicio de Cloud Run que implementaste en este instructivo:
Node.js
gcloud run services delete nodejs-spanner-function
Python
gcloud run services delete python-spanner-function
¿Qué sigue?
- Más información sobre Cloud Run Functions.
- Más información sobre cómo implementar Cloud Run Functions.
- Más información para activar funciones de Cloud Run.