En este instructivo, se muestra cómo escribir una Cloud Run Function HTTP que envía una consulta a BigQuery.
Prepara la aplicación
Clona el repositorio de la aplicación de muestra en tu máquina local:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Como alternativa, descarga la muestra como un archivo ZIP y extráelo.
Dirígete al directorio que contiene el código de muestra:
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, haz lo siguiente:
Ejecuta el siguiente comando en el directorio que contiene el código de muestra:
gcloud run deploy FUNCTION \ --source . \ --function FUNCTION_ENTRYPOINT \ --base-image BASE_IMAGE \ --region REGION \ --allow-unauthenticated
Reemplaza lo siguiente:
FUNCTION por el nombre de la función que implementas, por ejemplo,
my-bigquery-function
. Puedes omitir este parámetro por completo, pero se te solicitará el nombre si lo haces.FUNCTION_ENTRYPOINT por el punto de entrada a tu función en tu código fuente. Este es el código que ejecuta Cloud Run cuando se ejecuta tu función. El valor de esta marca debe ser un nombre de función o un nombre de clase completamente calificado que exista en tu código fuente. El punto de entrada que debes especificar para la función de muestra es
helloBigQuery
.BASE_IMAGE con el entorno de la imagen base de tu función, por ejemplo,
nodejs22
. Para obtener detalles sobre las imágenes base y los paquetes incluidos en cada imagen, consulta Imágenes base de los tiempos de ejecución.REGION con la región Google Clouden la que deseas implementar tu función Por ejemplo,
europe-west1
.
Opcional:
- Si creas una función de HTTP pública, por ejemplo, un webhook, especifica la marca
--allow-unauthenticated
. Esta marca asigna el rol de invocador de IAM de Cloud Run al identificador especialallUser
. Puedes usar IAM para editar esta configuración más adelante una vez que hayas creado el servicio.
Prueba la función
Cuando la función termine de implementarse, copia la propiedad
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.