En este instructivo, se muestra cómo escribir una Cloud Function HTTP que envía una consulta a BigQuery.
Objetivos
- Escribe una Cloud Function HTTP que envíe una consulta a BigQuery.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
- Cloud Functions
- Cloud Build
- Artifact Registry
Para obtener detalles, consulta Precios de Cloud Functions.
Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Habilita las API de Cloud Functions, Cloud Build, and Artifact Registry.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Habilita las API de Cloud Functions, Cloud Build, and Artifact Registry.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Prepara tu entorno de desarrollo.
Si ya tienes instalado gcloud CLI, ejecuta el siguiente comando para actualizarla:
gcloud components update
Prepara la aplicación
Clona el repositorio de la app de muestra en tu máquina local:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
De manera opcional, puedes descargar la muestra como un archivo ZIP y extraerla.
Ve al directorio que contiene el código de muestra de Cloud Functions, como sigue:
cd nodejs-docs-samples/functions/v2/helloBigQuery
Ve el código de muestra. La muestra envía una consulta de palabras que ocurren al menos 400 veces en el conjunto de datos especificado y muestra el resultado.
Implementa la función
Para implementar la función con un activador HTTP, ejecuta el siguiente comando en el directorio que contiene el código de muestra:
gcloud functions deploy nodejs-bq-function \ --gen2 \ --runtime=nodejs20 \ --region=REGION \ --source=. \ --entry-point=helloBigQuery \ --trigger-http \ --allow-unauthenticated
Puedes usar los siguientes valores para que la marca --runtime
especifique tu versión preferida de Node.js:
nodejs18
(recomendada)nodejs16
nodejs14
nodejs12
nodejs10
La marca --allow-unauthenticated
te permite acceder a la función sin autenticación.
Para solicitar la autenticación, omite la marca.
Activa la función
Cuando la función se termine de implementar, toma nota de la propiedad
uri
o búscala con el siguiente comando:gcloud functions describe nodejs-bq-function --gen2 --region=REGION --format="value(serviceConfig.uri)"
Visita este URI en tu navegador. Deberías ver una lista de las palabras que coinciden con los criterios de la consulta y cuántas veces aparece cada palabra en el conjunto de datos de destino.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.
Borra el proyecto
La manera más fácil de eliminar la facturación es borrar el proyecto que creaste para el instructivo.
Para borrar el proyecto, sigue estos pasos:
- En la consola de Google Cloud, ve a la página Administrar recursos.
- En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.
Borra la función de Cloud Functions
Borrar las funciones de Cloud Functions no quita ningún recurso almacenado en Cloud Storage.
Para borrar la función de Cloud Functions que creaste en este instructivo, ejecuta el siguiente comando:
gcloud functions delete nodejs-bq-function --gen2 --region REGION
También puedes borrar funciones de Cloud Functions en la consola de Google Cloud.