Administrar notebooks

En este documento, se describe cómo administrar notebooks de Colab Enterprise en BigQuery, incluido cómo ver, comparar, restablecer y borrar notebooks.

Los notebooks son recursos de código de BigQuery Studio con tecnología de Dataform.

Antes de comenzar

Antes de comenzar, crea un notebook.

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 > Pestaña nueva.
• Para abrir la lista en una pestaña dividida, haz clic en Mostrar todo en > Pestaña dividida.

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. Se abrirá el panel de comparación y se comparará la versión del notebook que seleccionaste con la versión actual del notebook.

4. Opcional: Para comparar las versiones intercaladas en lugar de en paneles separados, haz clic en Comparar y, luego, en Intercalado.

5. Opcional: Para comparar el código fuente de las versiones, haz clic en Comparar y, luego, en Mostrar fuente sin procesar.

6. Opcional: Para ocultar el resultado del comando en el notebook, haz clic en Comparar y, luego, anula la selección de 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 de comparació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.

Panel de comparació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. Se abrirá el panel de comparación y se comparará la versión del notebook que seleccionaste con la versión más reciente del notebook.

5. Si deseas restablecer la versión anterior del notebook después de la comparación, haz clic en Restablecer.

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.
• Obtén más información para orquestar notebooks.