Gestionar glosarios empresariales en Data Catalog

En este documento se describe cómo crear y usar contenido de glosario de empresa en Dataplex Universal Catalog con Data Catalog.

El glosario empresarial proporciona un único lugar para mantener y gestionar la terminología y las definiciones relacionadas con la empresa en toda la organización. Te permite asociar términos a las columnas de las entradas de datos catalogadas.

Puedes usar el glosario de términos empresariales de Dataplex Universal Catalog para hacer lo siguiente:

• Crea y mantén glosarios, categorías y términos empresariales.
• Usa categorías para representar estructuras jerárquicas de categorías y términos.
• Establece relaciones entre términos como sinónimos o términos relacionados.
• Asocia términos a las columnas de entrada de datos.
• Consulta y filtra los términos del glosario empresarial.
• Muestra los términos y las entradas de datos relacionados con un término concreto.
• Buscar entradas de datos etiquetadas con un término concreto.
• Muestra los términos relacionados con una entrada de datos determinada.

Terminología

En esta sección se describe la terminología utilizada en este documento.

El glosario empresarial

Un glosario empresarial es un repositorio que proporciona vocabularios adecuados y rige los términos empresariales de una empresa, junto con las definiciones de los términos asociados y las relaciones entre ellos. Ofrece un único lugar para mantener y gestionar los términos empresariales y sus definiciones. Un glosario empresarial tiene la siguiente propiedad en la consola:

• Descripción general: descripción en formato libre y texto enriquecido del propósito y el contenido del glosario empresarial.

Categoría

Las categorías se definen en un glosario empresarial. Te permite organizar y estructurar varias categorías y términos. Puedes anidar categorías hasta tres niveles. Estas son las propiedades de una categoría:

• Categoría: relación que se usa para establecer el contenedor de la categoría actual, si existe.
• Descripción: definición de la categoría en formato de texto enriquecido.
• Gestor de datos: especifica la persona responsable de mantener la categoría. Se trata de una propiedad descriptiva que no afecta a los permisos de la categoría.

Término

Un término se define en un glosario empresarial directamente o en cualquier categoría del glosario. Describe un concepto que se usa en una rama concreta de la empresa. Un término tiene las siguientes propiedades en la consola:

• Categoría: relación que se usa para establecer el contenedor del término actual, si lo hay.
• Descripción: definición de la empresa en formato de texto enriquecido.
• Gestor de datos: especifica la persona responsable de mantener el término. Se trata de una propiedad descriptiva que no afecta a los permisos del término.

Puedes asociar términos a las columnas de una entrada de datos para indicar que las columnas se describen con esos términos.

Sinónimo

Un sinónimo es una relación que se usa para indicar la similitud o equivalencia semántica entre dos términos diferentes. Se usa cuando dos términos similares se definen por equipos diferentes en glosarios distintos. Por ejemplo, earnings y income.

Término relacionado

Un término relacionado es una relación que se usa para indicar que dos términos están relacionados semánticamente, pero son diferentes. Por ejemplo, profit y income.

Limitaciones

• No se admite la importación en bloque de términos en un glosario de empresa.
• La función de glosario de empresa solo está disponible en la consola de Google Cloud .
• Cuando buscas entradas de datos en la página Búsqueda del catálogo universal de Dataplex, los resultados incluyen entradas de datos en las que uno de los términos adjuntos coincide con el término utilizado en la búsqueda. Sin embargo, no se muestra ninguna referencia al término coincidente en el resultado de búsqueda.
• No se admiten las regiones de BigQuery Omni. No puedes crear contenido de glosario de empresa ni adjuntar términos a las entradas de datos de estas regiones.
• Cuando se usa el glosario de empresa en Data Catalog, no se pueden adjuntar términos del glosario de empresa a las columnas de las entradas de Dataplex Universal Catalog.

Roles y permisos necesarios

Para obtener los permisos que necesitas para crear y gestionar glosarios, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

• Acceso completo a glosarios, categorías y términos: Propietario del glosario de DataCatalog (roles/datacatalog.glossaryOwner)
• Leer glosarios, categorías y términos, crear adjuntos entre términos y crear adjuntos entre términos y entradas de datos: Usuario del glosario de Data Catalog (roles/datacatalog.glossaryUser)
• Acceso de solo lectura a glosarios, categorías y términos: Lector de entradas de DataCatalog (roles/datacatalog.entryViewer)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear y gestionar glosarios. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para crear y gestionar glosarios, se necesitan los siguientes permisos:

• Acceso completo a glosarios, categorías y términos:
  • datacatalog.entries.*
  • datacatalog.relationships.*
• Lee glosarios, categorías y términos, crea adjuntos entre términos y crea adjuntos entre términos y entradas de datos:
  • datacatalog.entries.get
  • datacatalog.entries.list
  • datacatalog.relationships.*
• Acceso de solo lectura a glosarios, categorías y términos:
  • datacatalog.entries.get
  • datacatalog.entries.list
  • datacatalog.entryGroups.get
  • datacatalog.relationships.list
  • resourcemanager.projects.list
  • resourcemanager.projects.get
• Crear o eliminar glosarios: datacatalog.entryGroups.create

También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.

Para obtener más información, consulta Roles predefinidos de Data Catalog.

Crear y gestionar glosarios empresariales

En las siguientes secciones se describe cómo crear, ver, modificar y eliminar un glosario de empresa.

Crear un glosario empresarial

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Haz clic en Crear glosario empresarial.

3. En la página Crear glosario empresarial, especifica el nombre, la ubicación y la descripción del glosario empresarial.

   Los campos de nombre y ubicación son obligatorios. No puedes cambiar la ubicación después de crear el glosario.

4. Haz clic en Crear.

   El glosario se crea en el proyecto actual y se muestra la página del glosario.

Ver la lista de glosarios disponibles

• En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

  Ir a Glosarios

  En el panel Mis glosarios se muestran todos los glosarios de la organización que tienes permiso para ver, junto con sus descripciones y las marcas de tiempo de la última modificación.

Modificar un glosario

Puedes modificar el nombre y la descripción de un glosario.

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Haz clic en la glosario que quieras modificar.

   • Para editar el nombre, haz clic en edit Editar, introduce un nombre nuevo y haz clic en Guardar.

   • Para editar la descripción, haz clic en Editar descripción, introduce una nueva descripción y haz clic en Guardar.

Eliminar un glosario

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Haz clic en la glosario que quieras eliminar.

3. Haz clic en Eliminar.

   Para confirmar la acción, introduce el nombre del glosario y haz clic en Confirmar.

Crear y gestionar categorías

En las siguientes secciones se describe cómo crear, ver, actualizar y eliminar categorías.

Crear una categoría en un glosario

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Selecciona el glosario en el que quieras crear una categoría y haz clic en Crear categoría.

3. En la página Crear categoría, introduce el nombre y la descripción de la categoría.

4. Haz clic en Crear.

   Se abrirá la página de detalles de la categoría.

Crear una categoría dentro de otra

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Despliega el glosario en el que quieras crear una categoría.

3. Selecciona la categoría principal en la que quieras crear otra categoría y haz clic en Crear categoría. Puedes anidar una categoría hasta tres niveles.

4. En la página Crear categoría, introduce el nombre y la descripción de la categoría.

5. Haz clic en Crear.

   Se abrirá la página de detalles de la categoría.

Ver la lista de categorías disponibles

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Para ver la lista de categorías disponibles en un glosario, despliégalo.

3. Para ver la lista de categorías anidadas disponibles, despliega la categoría.

Actualizar una categoría

Puedes modificar el nombre, la descripción, el responsable de los datos y la categoría superior de la categoría actual.

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Despliega el glosario y haz clic en la categoría que quieras modificar.

   1. Para editar el nombre, haz clic en edit Editar e introduce un nuevo nombre.

   2. Para editar la descripción, haz clic en Editar descripción e introduce una nueva.

   3. Para editar la lista de responsables de datos, haga clic en edit Editar junto a Responsable, proporcione una lista de correos de responsables de datos y haga clic en Guardar.

   4. Para editar la categoría, haz clic en edit Editar junto a Categoría.

      • Para cambiar la categoría superior, en el campo Seleccionar una categoría, escriba el nombre de una nueva categoría superior del glosario actual y selecciónela.

      • Para quitar la categoría actual, en el campo Seleccionar una categoría, selecciona ---Ninguna---.

      Haz clic en Guardar.

Eliminar una categoría

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Despliega el glosario y haz clic en la categoría que quieras eliminar definitivamente.

   Se muestra una advertencia que indica que la eliminación es irreversible y que todos los términos y categorías de la categoría actual se moverán al siguiente nivel.

   Para confirmar la eliminación, introduce el nombre de la categoría y haz clic en Confirmar.

Crear y gestionar términos

En las siguientes secciones se describe cómo crear, ver, acceder, actualizar y eliminar un término.

Crear un término

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Selecciona el glosario en el que quieras crear un término y haz clic en Crear término.

3. En la página Crear término, introduce un nombre y una descripción para el término.

4. Haz clic en Crear.

   Se abrirá la página de detalles del término.

Ver la lista de términos disponibles

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Para ver la lista de términos disponibles en un glosario, amplíalo.

Acceder a los detalles de un término

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Para ver la lista de términos disponibles en un glosario, amplíalo.

3. Haz clic en un término.

   En la página de detalles del término se muestra el nombre, la descripción, los términos relacionados, los sinónimos y las entradas relacionadas.

Actualizar un término

Puedes modificar el nombre, la descripción y el responsable de los datos de un término.

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Despliega el glosario y haz clic en el término que quieras modificar.

   1. Para editar el nombre, haz clic en edit Editar e introduce un nuevo nombre.

   2. Para editar la descripción, haz clic en Editar descripción e introduce una nueva.

   3. Para editar la lista de responsables de datos, haga clic en edit Editar junto a Responsable, proporcione una lista de correos de responsables de datos y haga clic en Guardar.

   4. Para editar la categoría, haz clic en edit Editar junto a Categoría.

      • Para cambiar la categoría superior, en el campo Seleccionar una categoría, escriba el nombre de una nueva categoría superior del glosario actual y selecciónela.

      • Para quitar la categoría actual, en el campo Selecciona una categoría, selecciona ---Ninguna---.

      Haz clic en Guardar.

Eliminar un término

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Despliega el glosario y haz clic en el término que quieras eliminar definitivamente.

   Se muestra una advertencia que indica que la eliminación es irreversible y que se quitarán todas las relaciones asociadas al término.

   Para confirmar la eliminación, introduce el nombre del término y haz clic en Confirmar.

Gestionar sinónimos y términos relacionados

Puedes añadir relaciones entre términos marcándolos como términos relacionados o sinónimos. Las listas de términos relacionados y sinónimos se muestran en la página de detalles del término.

Añadir sinónimos y términos relacionados

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Despliega el glosario y haz clic en el término al que quieras añadir un sinónimo o un término relacionado.

3. Haz clic en edit Editar en Términos relacionados o Sinónimos.

4. En el campo Buscar términos del glosario, introduce el término que quieras adjuntar y selecciónalo en los resultados de búsqueda.

   El término se adjunta inmediatamente cuando lo seleccionas.

5. Haz clic en Listo.

Eliminar sinónimos y términos relacionados

1. En la Google Cloud consola, ve a la página Glosarios de Dataplex Universal Catalog.

   Ir a Glosarios

2. Despliega el glosario y haz clic en el término del que quieras eliminar un sinónimo o un término relacionado.

3. Para quitar un término relacionado, sigue estos pasos:

   1. Haz clic en edit Editar junto a Términos relacionados.

   2. En el término relacionado que quieras eliminar, haz clic en close Eliminar . El archivo adjunto se elimina inmediatamente.

   3. Haz clic en Listo.

4. Para quitar un sinónimo, sigue estos pasos:

   1. Haz clic en edit Editar junto a Sinónimos.

   2. Junto al sinónimo que quieras eliminar, haz clic en close Eliminar. El archivo adjunto se elimina inmediatamente.

   3. Haz clic en Listo.

Gestionar términos a nivel de columna

Puede asociar términos a las columnas de las entradas del catálogo de datos (obsoleto) que tengan esquemas (por ejemplo, tablas y conjuntos de archivos) para proporcionar más contexto sobre los datos de las columnas.

Asociar términos a columnas

1. Ve a una entrada de Data Catalog que tenga un esquema.

2. Haz clic en la pestaña Esquema.

3. En la columna Términos empresariales, en el campo al que quieras adjuntar términos, haz clic en add Añadir .

4. En el campo Búsqueda de términos, introduce el nombre del término y selecciónalo en el resultado de búsqueda. Puedes seleccionar varios términos.

5. Haz clic en Adjuntar términos.

Ver los detalles de los términos asociados a las columnas

1. Ve a una entrada de Data Catalog que tenga un esquema.

2. Haz clic en la pestaña Esquema.

3. En la columna Términos empresariales, haga clic en el término para ver su descripción. También puedes quitar el término o ir a la página de detalles del término mediante las opciones de esta ventana.

Quitar términos asociados a columnas

1. Ve a una entrada de Data Catalog que tenga un esquema.

2. Haz clic en la pestaña Esquema.

3. En la columna Términos empresariales, haga clic en el término que quiera quitar. close Eliminar

   También puedes quitar el término adjunto haciendo clic en él y, a continuación, en Quitar término empresarial > Confirmar.

Localizar glosarios y términos

Para desplazarte por el contenido del glosario empresarial, usa el árbol de glosario y términos de la página Glosarios de Dataplex Universal Catalog.

Puede usar la barra de filtros de la página Glosarios de Dataplex Universal Catalog para buscar categorías por nombre visible o términos según un criterio. El filtro devuelve los elementos con atributos que coincidan con la consulta del filtro. También puedes usar los siguientes calificadores:

• parent:VALUE: destaca los términos cuyo nombre o descripción del glosario principal coinciden con VALUE. Por ejemplo, parent:Finance destaca los términos relacionados con el nombre o la descripción del glosario principal que contenga la frase Finance.

• contact:VALUE: destaca los términos en los que el administrador de datos es VALUE. Por ejemplo, contact:johndoe@company.org resalta las entradas conectadas a términos con coincidencia de responsable de datos johndoe@company.org.

• synonym:VALUE: destaca los términos que tienen al menos un sinónimo cuyo nombre o descripción coincide con VALUE. Por ejemplo, synonym:interest destaca los términos que tienen términos relacionados con el nombre o la descripción que contienen la frase interest.

• related_to:VALUE: destaca los términos que tienen al menos un término relacionado cuyo nombre o descripción coinciden con VALUE. Por ejemplo, related_to:discounting destaca los términos que tienen términos relacionados con el nombre o la descripción que contienen la frase discounting.

Buscar entradas de datos con términos

Puedes usar el contenido del glosario de términos empresariales de Dataplex Universal Catalog cuando busques entradas en la página Búsqueda de Dataplex Universal Catalog.

Se admiten los siguientes casos de búsqueda:

• Búsqueda simple: la consulta de búsqueda se especifica como texto de formato libre que incluye el nombre o la descripción del término. Los resultados de búsqueda incluyen entradas conectadas a un término cuyo nombre o descripción coinciden con la consulta de búsqueda. Estos resultados se muestran junto con los obtenidos de otras formas de coincidencia que no están relacionadas con el contenido del glosario de empresa.

• Buscar con calificadores: la consulta de búsqueda se especifica como term:VALUE. El resultado de búsqueda incluye entradas conectadas a un término en el que una subcadena de nombre, descripción o responsable de datos coincide con VALUE.

Siguientes pasos

• Crea contenido de glosario empresarial.
• Descubre entradas de datos mediante los términos del glosario adjunto.