Gestionar cuadernos

En este documento se describe cómo gestionar cuadernos de Colab Enterprise en BigQuery, incluido cómo ver, comparar, restaurar y eliminar cuadernos.

En este documento también se describe cómo ver y gestionar los metadatos de los cuadernos en Dataplex Universal Catalog.

Los cuadernos son recursos de código de BigQuery Studio basados en Dataform.

Antes de empezar

  1. Crea un cuaderno.
  2. Para gestionar los metadatos de los cuadernos en Dataplex Universal Catalog, asegúrate de que la API de Dataplex esté habilitada en tu Google Cloud proyecto.

Permisos obligatorios

Para compartir cuadernos, necesitas los siguientes roles de Gestión de Identidades y Accesos (IAM):

Para guardar y eliminar cuadernos, necesitas los siguientes roles de gestión de identidades y accesos:

Para trabajar con revisiones de cuadernos, necesitas los siguientes roles de gestión de identidades y accesos:

Para obtener más información sobre la gestión de identidades y accesos de BigQuery, consulta el artículo sobre el control de acceso con la gestión de identidades y accesos.

Para gestionar los metadatos de los cuadernos en Dataplex Universal Catalog, asegúrate de tener los roles de Dataplex Universal Catalog necesarios.

Conceder acceso a los cuadernos

Para dar acceso a otros usuarios a un cuaderno, añádelos al rol de gestión de identidades y accesos adecuado.

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

    Ir a BigQuery

  2. En el panel Explorador, despliega tu proyecto y la carpeta Notebooks (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Busca el cuaderno al que quieras dar acceso.

  3. Haz clic en Ver acciones junto al cuaderno y, a continuación, en Compartir > Gestionar permisos.

  4. En el panel Gestionar permisos, haz clic en Añadir usuario o grupo.

  5. En el campo New principals (Nuevos principales), introduce un principal.

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

  7. Opcional: Para ver una lista completa de roles y ajustes avanzados para compartir, haz clic en Compartir de forma avanzada.

  8. Haz clic en Guardar.

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

Compartir cuadernos

Para compartir un cuaderno con otros usuarios, puedes generar y compartir un enlace al cuaderno. Para que otros usuarios puedan ver el cuaderno que compartes, primero debes concederles acceso.

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

  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 (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Busca el cuaderno que quieras compartir.

  3. Haz clic en Ver acciones junto al cuaderno y, a continuación, en Compartir > Copiar enlace.

  4. Comparte el enlace con otros usuarios.

Ver todos los cuadernos

Para ver una lista de todos los cuadernos 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, haga clic en Ver acciones junto a Cuadernos y, a continuación, haga 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 > Pestaña dividida.

Ver los metadatos de un cuaderno

Para ver los metadatos de un cuaderno, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel Explorador, despliega tu proyecto y la carpeta Notebooks (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Haga clic en el nombre del cuaderno del que quiera ver los metadatos.

  3. Consulta el panel Resumen para ver información sobre el cuaderno, como la región que usa para los datos y la fecha de la última modificación.

Trabajar con versiones de cuadernos

Puedes crear un cuaderno dentro o fuera de un repositorio. El control de versiones de los cuadernos se gestiona de forma diferente en función de dónde se encuentren.

Gestión de versiones de cuadernos en repositorios

Los repositorios son repositorios de Git que se encuentran en BigQuery o en un proveedor externo. Puedes usar espacios de trabajo en repositorios para llevar a cabo el control de versiones en cuadernos. Para obtener más información, consulta Usar el control de versiones con un archivo.

Control de versiones de cuadernos fuera de los repositorios

En las siguientes secciones se explica cómo ver, comparar y restaurar versiones de un cuaderno.

Ver las versiones de un cuaderno

Para ver las versiones de un cuaderno, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel Explorador, despliega tu proyecto y la carpeta Notebooks (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Haz clic en el nombre del cuaderno cuyo historial de versiones quieras ver.

  3. Para ver una lista de las versiones del cuaderno en orden descendente por fecha, haz clic en Historial de versiones.

Comparar versiones de un cuaderno

Para comparar versiones de un cuaderno, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel Explorador, despliega tu proyecto y la carpeta Notebooks (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Haz clic en el nombre del cuaderno del que quieras comparar la información de las versiones.

  3. Haz clic en Historial de versiones.

  4. Haz clic en Ver acciones junto a una versión del cuaderno y, a continuación, en Comparar. Se abrirá el panel de comparación, donde se comparará la versión del cuaderno que hayas seleccionado con la versión actual.

  5. Opcional: Para comparar las versiones en línea en lugar de en paneles independientes, haz clic en Comparar y, a continuación, en En línea.

  6. Opcional: Para comparar el código fuente de las versiones, haga clic en Comparar y, a continuación, en Mostrar fuente sin formato.

  7. Opcional: Para ocultar el resultado del comando en el cuaderno, haz clic en Comparar y, a continuación, desmarca Mostrar resultado.

Restaurar una versión de un cuaderno

Restaurar una versión de un cuaderno desde el panel de comparación te permite comparar las versiones actual y anterior del cuaderno antes de elegir restaurar la versión anterior. Al restaurar un cuaderno, se crea una versión nueva en lugar de sobrescribir la actual. No se pierde ningún historial de versiones.

  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 (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Haz clic en el nombre del cuaderno del que quieras restaurar una versión anterior.

  3. Haz clic en Historial de versiones.

  4. Haga clic en Ver acciones junto a la versión y, a continuación, en Comparar. Se abrirá el panel de comparación, donde se comparará la versión del cuaderno que hayas seleccionado con la más reciente.

  5. Si quieres restaurar la versión anterior del cuaderno después de compararlas, haz clic en Restaurar.

  6. Haz clic en Confirmar.

Descargar un cuaderno

Para descargar un cuaderno, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel Explorador, despliega tu proyecto y la carpeta Notebooks (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Haz clic en el nombre del cuaderno que quieras descargar.

  3. Haz clic en Descargar.

Eliminar cuadernos

Para eliminar un cuaderno, 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 (Cuadernos) y, si es necesario, la carpeta Shared notebooks (Cuadernos compartidos). Busca el cuaderno que quieras eliminar.

  3. Haz clic en Ver acciones junto al cuaderno y, a continuación, en Eliminar.

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

  5. Haz clic en Eliminar.

Gestionar metadatos en Dataplex Universal Catalog

Dataplex Universal Catalog te permite almacenar y gestionar metadatos de cuadernos. Los cuadernos están disponibles en Dataplex Universal Catalog de forma predeterminada, sin necesidad de configuración adicional.

Puedes usar Dataplex Universal Catalog para gestionar cuadernos en todas las ubicaciones de BigQuery. La gestión de cuadernos en Dataplex Universal Catalog está sujeta a las cuotas y los límites de Dataplex Universal Catalog y a los precios de Dataplex Universal Catalog.

Dataplex Universal Catalog obtiene automáticamente los siguientes metadatos de los cuadernos:

  • Nombre del recurso de datos
  • Recurso de datos superior
  • Ubicación del recurso de datos
  • Tipo de recurso de datos
  • Proyecto Google Cloud correspondiente

Dataplex Universal Catalog registra los cuadernos como entradas con los siguientes valores de entrada:

Grupo de entradas del sistema
El grupo de entrada del sistema de los cuadernos es @dataform. Para ver los detalles de las entradas de los cuadernos en Dataplex Universal Catalog, debes ver el grupo de entradas del sistema dataform. Para obtener instrucciones sobre cómo ver una lista de todas las entradas de un grupo de entradas, consulta Ver los detalles de un grupo de entradas en la documentación de Dataplex Universal Catalog.
Tipo de entrada del sistema
El tipo de entrada del sistema de los cuadernos es dataform-code-asset. Para ver los detalles de los cuadernos, debes consultar el dataform-code-asset tipo de entrada del sistema, filtrar los resultados con un filtro basado en aspectos y definir el campo type del aspecto dataform-code-asset como NOTEBOOK. A continuación, selecciona una entrada del cuaderno seleccionado. Para obtener instrucciones sobre cómo ver los detalles de un tipo de entrada seleccionado, consulta el artículo Ver los detalles de un tipo de entrada de la documentación de Universal Catalog de Dataplex. Para obtener instrucciones sobre cómo ver los detalles de una entrada seleccionada, consulta la sección Ver los detalles de una entrada de la documentación de Dataplex Universal Catalog.
Tipo de aspecto del sistema
El tipo de aspecto del sistema de los portátiles es dataform-code-asset. Para proporcionar contexto adicional a los cuadernos de Dataplex Universal Catalog añadiendo aspectos a las entradas de los cuadernos, consulta el tipo de aspecto dataform-code-asset, filtra los resultados con un filtro basado en aspectos y define el campo type del aspecto dataform-code-asset como NOTEBOOK. Para obtener instrucciones sobre cómo anotar entradas con aspectos, consulta Gestionar aspectos y enriquecer metadatos en la documentación de Dataplex Universal Catalog.
Tipo
El tipo de los lienzos de datos es NOTEBOOK. Este tipo te permite filtrar cuadernos en el tipo de entrada del sistema dataform-code-asset y en el tipo de aspecto dataform-code-asset mediante la aspect:dataplex-types.global.dataform-code-asset.type=NOTEBOOK consulta en un filtro basado en aspectos.

Para obtener instrucciones sobre cómo buscar recursos en Dataplex Universal Catalog, consulta el artículo Buscar recursos de datos en Dataplex Universal Catalog de la documentación de Dataplex Universal Catalog.

Solución de problemas

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

Siguientes pasos