Crea y ejecuta un notebook con la galería de notebooks

Crea y ejecuta un notebook con la galería de notebooks

Comienza a analizar datos con la galería de notebooks en BigQuery Studio.

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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

1. Habilita la API de BigQuery.

   Roles necesarios para habilitar las APIs

   Para habilitar APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

   Habilitar la API

   Para los proyectos nuevos, la API de BigQuery se habilita de forma automática.

2. Opcional: Habilita la facturación para el proyecto. Si no deseas habilitar la facturación ni proporcionar una tarjeta de crédito, los pasos que se indican en este documento seguirán funcionando. BigQuery proporciona una zona de pruebas para realizar los pasos. Para obtener más información, consulta Habilita la zona de pruebas de BigQuery.
   Nota: Si tu proyecto tiene una cuenta de facturación y deseas usar la zona de pruebas de BigQuery, inhabilita la facturación para tu proyecto.

Roles obligatorios

Para obtener los permisos que necesitas para crear notebooks de ejecución, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

• Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser)
• Usuario de BigQuery Studio (roles/bigquery.studioUser)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Si no conoces los notebooks en BigQuery, consulta los permisos requeridos en la página Crea notebooks.

Galería de notebooks

La galería de notebooks es un centro para descubrir y usar plantillas de notebooks prediseñadas. Estas plantillas te permiten realizar tareas comunes, como la preparación, el análisis y la visualización de datos. Las plantillas de notebooks también te ayudan a explorar las funciones de BigQuery Studio, administrar flujos de trabajo y promover prácticas recomendadas.

Puedes usar plantillas de la galería de notebooks para optimizar todo tu flujo de trabajo de intención a estadísticas en cada etapa del ciclo de vida de los datos, desde la transferencia y la exploración hasta el análisis avanzado y BigQuery ML.

La galería de notebooks proporciona plantillas para todos los niveles de habilidad. La galería incluye plantillas fundamentales para SQL, Python, Apache Spark y DataFrames. También puedes explorar temas como la IA generativa y el análisis de datos multimodales en BigQuery.

Para obtener más información sobre cómo usar las plantillas de la galería de notebooks, consulta Crea un notebook con la galería de notebooks.

Crea un notebook a partir de una plantilla de la galería de notebooks

En el siguiente ejemplo, se usa la plantilla Introducción a los notebooks en BigQuery Studio. En este notebook, se muestra cómo realizar las siguientes tareas:

• Consultar datos: Ejecuta consultas con celdas de SQL.
• Visualiza los resultados de las consultas: Crea visualizaciones sin código con las celdas de visualización.
• Limpia y transforma datos: Ordena, quita duplicados y filtra tus datos con la API de BigQuery DataFrames (Pandas).
• Ejecuta predicciones basadas en IA: Genera predicciones con la (función AI.FORECAST) en BigQuery DataFrames. La función AI.FORECAST usa el modelo de base de TimesFM para generar predicciones directamente a partir de un conjunto de datos sin necesidad de entrenamiento de modelos.
• Trazar datos: Traza datos con las bibliotecas de visualización integradas de Python. Trazas los datos con la biblioteca de visualización de BigQuery DataFrames, con tecnología de Matplotlib y Pandas.

Para usar el notebook, debes abrir la plantilla, convertirla en un notebook ejecutable, conectarte al entorno de ejecución del notebook y, luego, ejecutarlo.

Abre la plantilla y conviértela en un notebook ejecutable

Antes de usar un notebook creado a partir de una plantilla de la galería de notebooks, debes convertir la plantilla en un notebook ejecutable.

Para abrir la plantilla Introduction to notebooks in BigQuery Studio en la galería de notebooks y convertirla en un notebook ejecutable, sigue estos pasos:

1. Ve a la página de Studio.

   Ir a Studio

2. Haz clic en el menú desplegable de la flecha y, luego, elige Notebook > All templates.

3. Como alternativa, en la página principal de BigQuery Studio, haz clic en Ver galería de notebooks.

   

4. Haz clic en la tarjeta Introduction to notebooks in BigQuery Studio o búscalo en la galería.

5. Después de que se abra la plantilla, haz clic en Usar esta plantilla para convertirla en un notebook ejecutable.

Conéctate al entorno de ejecución predeterminado

Antes de ejecutar el notebook, debes conectarlo a un tiempo de ejecución de Gemini Enterprise Agent Platform. Un entorno de ejecución es un recurso de procesamiento que ejecuta el código en tu notebook. El entorno de ejecución debe estar en la misma región que tu notebook.

Para obtener más información sobre los entornos de ejecución, consulta Entornos de ejecución y plantillas de entorno de ejecución. Para obtener más información sobre cómo configurar los parámetros regionales, consulta Configura la región predeterminada para los elementos de código.

Nota: Si usas los Controles del servicio de VPC, asegúrate de haber configurado el Acceso privado a Google con los Controles del servicio de VPC antes de conectarte a un entorno de ejecución. De lo contrario, el servicio devuelve el error Failed to connect to Runtime Network projects/projectid/global/networks/default' was not found.

.

En este instructivo, usarás el tiempo de ejecución predeterminado. El tiempo de ejecución predeterminado es un tiempo de ejecución preestablecido que requiere una configuración mínima. Para conectarte al entorno de ejecución predeterminado, sigue estos pasos:

1. Con el notebook abierto, haz clic en Conectar.

   Es posible que la conexión al entorno de ejecución predeterminado tarde varios minutos si aún no tienes un entorno de ejecución activo.

2. Cuando el entorno de ejecución esté listo, deberías ver una marca de verificación con los gráficos de RAM y disco. Si colocas el cursor sobre los gráficos, verás el tipo de entorno de ejecución y su configuración.

   

Ejecuta el notebook

La introducción a los notebooks en BigQuery Studio contiene texto, SQL, visualizaciones y celdas de código. Las celdas que no son de texto se pueden ejecutar de forma individual, o bien puedes ejecutar todas las celdas en orden, de la primera a la última.

En este instructivo, ejecutarás las celdas del notebook de forma individual para que puedas ver los resultados por etapas. Para ejecutar el notebook, haz lo siguiente:

1. En la sección Query your data using SQL cells, coloca el cursor sobre la celda de SQL y, luego, haz clic en Ejecutar celda.

   

   Esta celda de SQL consulta la tabla bigquery-public-data.epa_historical_air_quality.pm25_frm_daily_summary en el conjunto de datos públicos de calidad del aire histórico y muestra el promedio diario de PM2.5 (una métrica común de calidad del aire) para San Francisco en los últimos años.

2. Observa los resultados. Los resultados de la consulta se muestran en un DataFrame.

   

   Nota: Para borrar o copiar los resultados, haz clic en Acciones de salida de la celda de código.

3. En la sección Visualizar datos, coloca el cursor sobre la celda de visualización y, luego, haz clic en Ejecutar celda.

4. Visualiza la visualización generada.

   

   El resultado muestra un gráfico de series temporales que representa los valores promedio diarios de PM2.5 en el DataFrame df que generaste anteriormente. En este gráfico, se muestra la tendencia de los niveles de PM2.5 a lo largo del tiempo.

5. En la sección Limpiar los datos, coloca el cursor sobre la celda de código y, luego, haz clic en Ejecutar celda.

6. Observa los resultados. Los resultados se muestran en un DataFrame.

   

   El código hace lo siguiente:

   • Importa la biblioteca bigframes.pandas.
   • Asegúrate de que el campo date_local sea una marca de tiempo.
   • Ordena los resultados por fecha, lo que es necesario para la previsión.
   • Quita las filas duplicadas.
   • Descarta las filas en las que avg_pm25 es null.
   • Filtrar valores atípicos
   • Muestra los resultados en un BigQuery DataFrames llamado df_cleaned.

7. En la sección Predecir valores con AI.FORECAST, coloca el cursor sobre la celda de SQL y, luego, haz clic en Ejecutar celda.

8. Observa los resultados. Los resultados de la consulta se muestran en un DataFrame.

   

   Esta celda de SQL ejecuta una consulta que usa la función AI.FORECAST para predecir el promedio diario futuro de PM2.5 con el DataFrame df_cleaned que generaste anteriormente.

9. En la sección Visualiza los datos con Python, coloca el cursor sobre la celda de código y, luego, haz clic en Ejecutar celda.

10. Observa los resultados. Los resultados se muestran en un gráfico.

    

    El código de Python hace lo siguiente:

    • Importa el módulo datetime.
    • Primero, grafica los datos históricos y obtén los ejes.
    • Trazar los datos previstos en los mismos ejes
    • Trazar el intervalo de confianza

    Esta visualización se asemeja a los gráficos estándar de Python, pero df_cleaned.plot es un comando de BigQuery DataFrames. El comando recupera solo los datos necesarios (una muestra) para renderizar el gráfico, no todo el conjunto de datos.

Realiza una limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo su contenido. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID personalizado del proyecto que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, reutilizar proyectos puede ser útil para no exceder los límites de cuota de los proyectos.

1. En la Google Cloud consola, ve a la página Administrar recursos.

   Ir a Administrar recursos

2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.

Como alternativa, para conservar el proyecto y borrar los recursos que se usaron en este instructivo, sigue estos pasos:

1. Ve a la página de Studio.

   Ir a Studio

2. En el panel izquierdo, expande tu proyecto y, luego, haz clic en Notebooks.

3. En el notebook que deseas borrar, haz clic en Abrir acciones > Borrar.

4. En el cuadro de diálogo Borrar notebook, haz clic en Borrar para confirmar.

¿Qué sigue?

Para ejecutar otras plantillas de notebooks de muestra en la galería de notebooks, consulta lo siguiente:

• Comienza a usar notebooks para usuarios de SQL
• Comienza a usar notebooks para usuarios de Python

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

• Introducción a BigQuery DataFrames
• Referencia de la API de BigQuery DataFrames

Para obtener más información sobre las funciones de IA y AA generativos en BigQuery, consulta la descripción general de la IA generativa.