Administrar notebooks

Nota: Los notebooks de BigQuery Studio comenzarán a cobrarse en la etapa de disponibilidad general después del 11 de abril de 2024. Comenzarás a ver los cargos basados en el uso para los notebooks de BigQuery Studio en tu factura.

En este documento, se describe cómo administrar notebooks de Colab Enterprise en BigQuery. Los notebooks son recursos de código de BigQuery Studio con tecnología de Dataform.

Si deseas usar notebooks, primero debes habilitar BigQuery Studio para la administración de recursos.

Importante: En marzo de 2024, las APIs compatibles con las funciones de BigQuery Studio se habilitaron automáticamente para todos los proyectos de BigQuery existentes. Los proyectos de BigQuery nuevos tienen estas APIs habilitadas de forma predeterminada. Para obtener más información, consulta Habilitación automática de las APIs de BigQuery Studio.

Permisos necesarios

Para compartir los notebooks, necesitas los siguientes roles de Identity and Access Management (IAM):

• Usuario de trabajo de BigQuery (roles/bigquery.jobUser)
• Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser)
• Propietario del código (roles/dataform.codeOwner) a nivel de recurso.

Para guardar y borrar notebooks, necesitas los siguientes roles de IAM:

• Usuario de trabajo de BigQuery (roles/bigquery.jobUser)
• Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser)
• Propietario (roles/dataform.codeOwner) o Editor de código (roles/dataform.codeEditor)

Para trabajar con revisiones del notebook, necesitas los siguientes roles de IAM:

• Usuario de trabajo de BigQuery (roles/bigquery.jobUser)
• Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser)

• Cualquiera de los siguientes roles:

  • Propietario del código (roles/dataform.codeOwner)
  • Editor de código (roles/dataform.codeEditor)
  • Visualizador de código (roles/dataform.codeViewer)

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Otorga acceso a los notebooks

Para otorgar acceso a un notebook a otros usuarios, agrégalos a un rol de IAM adecuada.

Importante: Los usuarios que tienen acceso al notebook pueden ver todos los resultados que generó el código en el notebook, incluso si este resultado contiene datos de tablas que no admiten T debe tener acceso. Para evitar que se comparta el resultado guardado, inhabilita el guardado de resultados del notebook.

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, la carpeta Notebooks compartidos. Busca el notebook al que quieres otorgar acceso.

3. Haz clic en Ver acciones junto al notebook y, luego, en Compartir > Administrar permisos.

4. En el panel Administrar permisos, haz clic en Agregar usuario o grupo.

5. En el campo Principales nuevas, ingresa una principal.

6. En la lista Rol, selecciona uno de los siguientes roles:

   • Propietario del código: Puede realizar cualquier acción en el notebook, incluida la eliminación o el uso compartido.
   • Editor de código: Puede editar el notebook.
   • Visualizador de código: Puede ver el notebook.
   Nota: La principal también debe tener el Usuario del entorno de ejecución del notebook (roles/aiplatform.notebookRuntimeUser) y Roles de usuario de BigQuery (roles/bigquery.user) para ejecutar el notebook.

7. Opcional: Para ver una lista completa de las funciones y la configuración de uso compartido avanzada, haz clic en Uso compartido avanzado.

8. Haz clic en Guardar.

9. Para volver a la página de información del notebook, haz clic en Cerrar.

Comparte notebooks

Para compartir un notebook con otros usuarios, puedes generar y compartir un vínculo al notebook. Para que otros usuarios vean el notebook que compartes, primero debes otorgar acceso al notebook.

Para ejecutar un notebook, los usuarios deben tener acceso a los datos a los que accede el notebook. Para obtener más información, consulta Otorga acceso a un conjunto de datos.

Importante: Los usuarios que tienen acceso al notebook pueden ver todos los resultados que generó el código en el notebook, incluso si este resultado contiene datos de tablas que no admiten T debe tener acceso. Para evitar que se comparta el resultado guardado, inhabilita el guardado de resultados del notebook.

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, expande la carpeta Notebooks compartidos. Busca la carpeta que quieras compartir.

3. Haz clic en Ver acciones junto al notebook y, luego, en Compartir > Copiar vínculo.

4. Comparte el vínculo con otros usuarios.

Visualiza todos los notebooks

Para ver una lista de todos los notebooks de tu proyecto, haz lo siguiente:

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

   Ir a BigQuery

2. En el panel Explorador, haz clic en Ver acciones junto a Notebooks y, luego, realiza una de las siguientes acciones:

• Para abrir la lista en la pestaña actual, haz clic en Mostrar todo.
• Para abrir la lista en una pestaña nueva, haz clic en Mostrar todo en > Nueva pestaña.
• Para abrir la lista en una pestaña dividida, haz clic en Mostrar todo en > Dividir pestaña.

Cómo ver los metadatos del notebook

Para ver los metadatos del notebook, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, la carpeta Notebooks compartidos. Haz clic en el nombre del notebook del que quieres ver los metadatos.

3. Mira el panel Resumen para ver información sobre el notebook, como la región que usa para los datos y la fecha en que se modificó por última vez.

Trabaja con versiones de notebooks

Usa las siguientes secciones para aprender a ver, comparar y restablecer versiones de un notebook.

Cómo ver las versiones de notebook

Para ver las versiones de notebook, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, la carpeta Notebooks compartidos. Haz clic en el nombre del notebook del que quieres ver la actividad.

3. Haz clic en la pestaña Actividad para ver una lista de las versiones de notebook en orden descendente por fecha.

Cómo comparar versiones de notebooks

Para comparar las versiones de notebook, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, la carpeta Notebooks compartidos. Haz clic en el nombre del notebook del que quieres comparar la información de la versión.

3. En la pestaña Actividad, haz clic en Ver acciones junto a la versión de un notebook y, luego, haz clic en Comparar.

4. En el panel Historial de revisión, usa los menús desplegables de Versión para elegir las versiones que quieres comparar.

5. Opcional: Para comparar el código fuente del notebook, selecciona la casilla de verificación Fuente sin procesar.

6. Opcional: Para comparar las versiones intercaladas en lugar de en paneles separados, selecciona la casilla de verificación Diferencia intercalada.

7. Opcional: Para ocultar el resultado del comando en el notebook, desmarca la casilla de verificación Mostrar resultado.

Restablece una versión de notebook

Usa una de las siguientes opciones para restablecer una versión del notebook. Restablecer desde el panel Historial de revisión te permite comparar las versiones actuales y anteriores del notebook antes de restablecer la versión anterior. Si restableces un notebook, se crea una versión nueva del notebook en lugar de reemplazar la actual. No se pierde el historial de versiones.

Panel de actividad

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, expande la carpeta Notebooks compartidos. Haz clic en el nombre del notebook del que quieres restablecer una versión anterior.

3. Selecciona el panel Actividad.

4. Haz clic en Ver acciones junto a la versión del notebook que quieres restablecer y, luego, en Restablecer.

5. Haz clic en Confirmar.

Historial de revisión

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, expande la carpeta Notebooks compartidos. Haz clic en el nombre del notebook del que quieres restablecer una versión anterior.

3. Selecciona el panel Actividad.

4. Haz clic en Ver acciones junto a la versión de un notebook y, luego, en Comparar.

5. En el panel Historial de revisión, haz clic en Ver acciones junto al menú desplegable Versión y, luego, haz clic en Restablece la revisión.

6. Haz clic en Confirmar.

Descarga un notebook

Para descargar un notebook, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, la carpeta Notebooks compartidos. Haz clic en el nombre del notebook que deseas descargar.

3. Haz clic en Descargar.

Cómo borrar notebooks

Para borrar un notebook, sigue estos pasos:

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

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y la carpeta Notebooks y, si es necesario, expande la carpeta Notebooks compartidos. Busca el notebook que quieres borrar.

3. Haz clic en Ver acciones junto al notebook y, luego, en Borrar.

4. Para confirmar la eliminación, escribe delete en el cuadro de diálogo.

5. Haz clic en Borrar.

Soluciona problemas

Para obtener más información, consulta Soluciona problemas de Colab Enterprise.

¿Qué sigue?

• Obtén más información sobre los notebooks de Colab Enterprise en BigQuery.
• Obtén más información para crear notebooks.