Wikis de Unity Catalog

Importante

Esta característica se encuentra en su versión beta. Los administradores de cuentas pueden administrar el acceso a esta característica desde la página Vista previa de la consola de la cuenta. Consulte Gestionar previsualizaciones a nivel de cuenta.

Una wiki permite a tu equipo documentar el significado de una tabla, su uso previsto y sus fuentes, y luego colaborar en esa información. Los propietarios y administradores de datos redactan y publican wikis para capturar el contexto empresarial asociado a una tabla, como definiciones y advertencias conocidas. Cualquiera que pueda ver los metadatos de la tabla puede leer una wiki publicada, comentarla, sugerir ediciones y reaccionar a ella.

Una wiki documenta una tabla. Una Página define un concepto de negocio que puede abarcar muchos activos. Usa una wiki para contexto sobre una tabla específica y usa una página para una definición compartida.

Las wikis funcionan además del comentario existente de la tabla. Consulta Wikis y los comentarios de tabla.

Qué contiene una wiki

Una wiki contiene los siguientes campos:

Campo	Description
Description	Un resumen de una línea de la tabla, mostrado en la parte superior de la wiki.
Cuerpo de página	Documentación en texto enriquecido que admite encabezados, enlaces, imágenes y menciones en línea de objetos protegibles de Unity Catalog y objetos de espacio de trabajo.
Sources	Enlaces a las Páginas o fuentes externas en las que se basa el contenido de la wiki.

Permissions

Una wiki no es un objeto protegible. Son metadatos de la tabla, así que los privilegios existentes de tu Catálogo Unity en la tabla determinan lo que puedes hacer con su wiki. Para información sobre los privilegios del Catálogo de Unity, véanse los conceptos del modelo de permisos del Catálogo de Unity.

La tabla de privilegios que sigue utiliza privilegios de uso en objetos padres para referirse a los privilegios de uso que READ_METADATA, MANAGE o la propiedad requieren para que entren en vigor. Dependen del objeto:

• Tabla: USE SCHEMA sobre el esquema padre y USE CATALOG sobre el catálogo padre.
• Esquema: USE CATALOG en el catálogo principal.
• Catálogo: Ninguno.

Action	Privilegios necesarios
Consulta y colabora en wikis publicados: consulta wikis publicados, añade, edita o elimina tus propios comentarios, sugiere ediciones y añade reacciones	Uno de los siguientes: SELECT en la mesa, USE SCHEMA en el esquema y USE CATALOG en el catálogo BROWSE en el catálogo primario READ_METADATA en la tabla, esquema, catálogo o metastore, con privilegios de uso en objetos padres MANAGE en la tabla, esquema o catálogo, con privilegios de uso en objetos padres Propietario de la tabla, esquema padre o catálogo padre, con privilegios de uso en objetos padres Administrador de metastore
Ver borradores de wikis	Uno de los siguientes: READ_METADATA en la tabla, esquema, catálogo o metastore, con privilegios de uso en objetos padres MANAGE en la tabla, esquema o catálogo, con privilegios de uso en objetos padres Propietario de la tabla, esquema padre o catálogo padre, con privilegios de uso sobre ellos Administrador de metastore
Gestionar wikis y comentarios: crear, editar, publicar o despublicar wikis, aceptar o rechazar ediciones sugeridas y eliminar cualquier comentario	Uno de los siguientes: MANAGE en la tabla, esquema o catálogo, con privilegios de uso en objetos padres Propietario de la tabla, esquema principal o catálogo principal, con privilegios de uso en objetos principales Administrador de metastore

Crea una wiki

Para crear una wiki, necesitas los privilegios para gestionar wikis en la tabla. Consulte Permisos.

Puedes crear una wiki manualmente o redactar una con Genie Code.

Warning

Los datos de la wiki se cifran en reposo con claves gestionadas por Microsoft. Las wikis no soportan cifrado de clave gestionada por el cliente (CMK). No incluyas PII, datos regulados u otra información sensible en las descripciones de la wiki ni en los cuerpos de las páginas.

1. En el Explorador de Catálogos, abre la tabla.

2. En la pestaña Información general, haz clic en Crear wiki. Si has descartado el banner de Crear wiki , haz clic en el Menú Kebab en la esquina superior derecha de la página y selecciona Crear wiki en su lugar. Si la tabla tiene un comentario existente, rellena previamente el cuerpo de la página de la wiki.

   

3. Añadir el contenido de la wiki:

   • Para redactar manualmente, rellena la Descripción y el cuerpo de la página, y añade cualquier Fuentes.
   • Para redactar con Código Genie, usa el panel de Código Genie en el editor de la wiki. Adjunta archivos u otro contexto para que Genie Code trabaje. Consulte Código de Genie.

4. Haz clic en Guardar como borrador para seguir trabajando en la wiki, o haz clic en Publicar para que sea visible para todos los que puedan ver los metadatos de la tabla.

Después de publicar una wiki, aparece en la parte superior de la pestaña Resumen de la tabla, y la Descripción de la tabla se traslada a la pestaña Detalles.

Editar y publicar wikis

Para editar, publicar o anular la publicación de una wiki, necesitas los privilegios para gestionar wikis en la tabla. Consulte Permisos.

1. En el Explorador de Catálogos, abre la tabla.

2. En la wiki, haz clic en Editar.

3. Haz tus cambios, luego haz clic en Guardar para guardarlos, o haz clic en Publicar para hacer visible un wiki en borrador.

   

Para ocultar una wiki publicada sin perder su contenido, haz clic en Editar, haz clic en el menú de kebab y luego haz clic en Anular la publicación. La wiki vuelve a ser un borrador que solo pueden ver los usuarios que pueden ver borradores. Hasta que publiques la wiki de nuevo, la Descripción de la tabla aparece en la parte superior de la pestaña Información general.

Colaborar en una wiki

Cualquiera que pueda ver una wiki publicada puede colaborar en ella. Consulte Permisos.

• Comentario: Haz preguntas o añade contexto. Puedes editar o eliminar tus propios comentarios.
• Sugerir ediciones: Sugerir cambios en el cuerpo de la página de la wiki. Haz clic en Sugerir, edita el cuerpo de la página y haz clic en Guardar. Un usuario con los privilegios para gestionar la wiki acepta o rechaza la sugerencia.
• React: Vota a favor o en contra de la wiki para indicar si fue útil.

Wikis y comentarios en tablas

Una wiki no reemplaza el comentario de la tabla, así que los pipelines existentes que leen o escriben comentarios siguen funcionando:

• Aún puedes poner el comentario con COMMENT ON TABLE o ALTER TABLE. El comentario sigue apareciendo en information_schema y en el campo Descripción del Explorador de Catálogos.
• Cuando creas una wiki, el comentario existente de la tabla sirve de base para el cuerpo de la página de la wiki. Después de eso, la wiki y el comentario son independientes. Los cambios en uno no actualizan al otro.

Para más información sobre los comentarios en tablas, consulta Añadir comentarios a datos y activos de IA.

Limitations

• Las wikis solo están disponibles en tabletas. No se admiten wikis sobre columnas, esquemas, catálogos y otros objetos protegibles.
• Cada tabla puede tener una wiki.

• Las wikis no están disponibles en las regiones de Azure Government, Azure China o FedRAMP.