Administra glosarios empresariales en Data Catalog

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

El glosario empresarial proporciona un solo lugar para mantener y administrar la terminología y las definiciones relacionadas con la empresa en toda la organización. Te permite adjuntar términos a las columnas de las entradas de datos catalogados.

Puedes usar el glosario empresarial de Dataplex Universal Catalog para hacer lo siguiente:

• Crear y mantener 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.
• Adjunta términos a las columnas de entrada de datos.
• Explorar y filtrar términos dentro del glosario empresarial
• Mostrar términos y entradas de datos relacionados para un término determinado
• Buscar entradas de datos etiquetadas con un término en particular
• Muestra términos relacionados para una entrada de datos determinada.

Terminología

En esta sección, se describe la terminología que se usa en este documento.

Glosario empresarial

El glosario empresarial es un repositorio que proporciona vocabularios adecuados y rige los términos comerciales de una empresa, junto con las definiciones de términos y las relaciones entre los términos asociados. Proporciona un solo lugar para mantener y administrar las condiciones comerciales y sus definiciones. Un glosario de la empresa tiene la siguiente propiedad que se muestra en la consola:

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

Categoría

Una categoría se define dentro de un glosario de la empresa. Te permite organizar y estructurar varias categorías y términos. Puedes anidar categorías hasta en tres niveles. Estas son las propiedades de una categoría:

• Categoría: Es una relación que se usa para establecer el contenedor de la categoría actual, si existe.
• Descripción: Es una definición comercial de texto enriquecido de formato libre de la categoría.
• Administrador de datos: Especifica la persona responsable de mantener la categoría. Esta es una propiedad descriptiva y no afecta los permisos de la categoría.

Término

Un término se define dentro de un glosario empresarial, ya sea directamente en el glosario o dentro de cualquier categoría que se encuentre en él. Describe un concepto que se usa en una rama comercial específica dentro de una empresa. Un término tiene las siguientes propiedades que se muestran en la consola:

• Categoría: Es una relación que se usa para establecer el contenedor del término actual, si existe.
• Descripción: Es una definición empresarial de formato libre del término en texto enriquecido.
• Administrador de datos: Especifica la persona responsable de mantener el término. Esta es una propiedad descriptiva y no afecta los permisos del término.

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

Sinónimo

Un sinónimo es una relación que se usa para indicar similitud o equivalencia semántica entre dos términos diferentes. Se usa cuando diferentes equipos definen dos términos similares en diferentes glosarios. 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 masiva de términos en un glosario de la empresa.
• La función de glosario de la empresa solo se admite en la consola de Google Cloud .
• Cuando buscas entradas de datos en la página Búsqueda de Dataplex Universal Catalog, el resultado de la búsqueda incluye las entradas de datos en las que uno de sus términos adjuntos coincide con el término utilizado para la búsqueda. Sin embargo, no se muestra la referencia al término coincidente en el resultado de la búsqueda.
• No se admiten las regiones de BigQuery Omni. No puedes crear contenido del glosario de la empresa ni adjuntar términos a las entradas de datos en estas regiones.
• Cuando usas el glosario empresarial en Data Catalog, no puedes adjuntar términos del glosario empresarial a las columnas de las entradas del catálogo universal.

Roles y permisos requeridos

Para obtener los permisos que necesitas para crear y administrar glosarios, pídele a tu administrador que te otorgue los siguientes roles de IAM 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 DataCatalog (roles/datacatalog.glossaryUser)
• Acceso de solo lectura a glosarios, categorías y términos: Visualizador de entradas de DataCatalog (roles/datacatalog.entryViewer)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear y administrar glosarios. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear y administrar glosarios:

• Acceso completo a glosarios, categorías y términos:
  • datacatalog.entries.*
  • datacatalog.relationships.*
• Leer glosarios, categorías y términos, crear adjuntos entre términos y crear 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 borrar glosarios: datacatalog.entryGroups.create

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

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

Crea y administra glosarios empresariales

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

Crea un glosario empresarial

1. En la consola de Google Cloud , 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 un nombre, una ubicación y una descripción para el 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.

Consulta la lista de glosarios disponibles

• En la consola de Google Cloud , 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 marcas de tiempo de la última modificación.

Cómo modificar un glosario

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

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

   Ir a Glosarios

2. Haz clic en el glosario que quieras modificar.

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

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

Borra un glosario

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

   Ir a Glosarios

2. Haz clic en el glosario que deseas borrar.

3. Haz clic en Borrar.

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

Crea y administra categorías

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

Crea una categoría en un glosario

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

   Ir a Glosarios

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

3. En la página Crear categoría, ingresa un nombre y una descripción para la categoría.

4. Haz clic en Crear.

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

Cómo crear una categoría dentro de otra

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

   Ir a Glosarios

2. Expande el glosario en el que deseas crear una categoría.

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

4. En la página Crear categoría, ingresa un nombre y una descripción para la categoría.

5. Haz clic en Crear.

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

Consulta la lista de categorías disponibles

1. En la consola de Google Cloud , 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, expándelo.

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

Actualiza una categoría

Puedes modificar el nombre, la descripción, el administrador de datos y la categoría principal de la categoría actual.

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

   Ir a Glosarios

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

   1. Para editar el nombre, haz clic en edit Editar y escribe un nombre nuevo.

   2. Para editar la descripción, haz clic en Editar descripción y escribe una nueva.

   3. Para editar la lista de administradores de datos, haz clic en edit Editar junto a Administrador, proporciona una lista de correos electrónicos de administradores de datos y haz clic en Guardar.

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

      • Para cambiar la categoría principal, en el campo Selecciona una categoría, ingresa el nombre de una nueva categoría principal del glosario actual y selecciónala.

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

      Haz clic en Guardar.

Borrar una categoría

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

   Ir a Glosarios

2. Expande el glosario y haz clic en la categoría que quieras borrar de forma permanente.

   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, ingresa el nombre de la categoría y haz clic en Confirmar.

Crea y administra condiciones

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

Crea un término

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

   Ir a Glosarios

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

3. En la página Crear término, ingresa 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.

Consulta la lista de condiciones disponibles

1. En la consola de Google Cloud , 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, expándelo.

Accede a los detalles de un término

1. En la consola de Google Cloud , 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, expándelo.

3. Haz clic en un término.

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

Actualiza un término

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

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

   Ir a Glosarios

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

   1. Para editar el nombre, haz clic en edit Editar y escribe un nombre nuevo.

   2. Para editar la descripción, haz clic en Editar descripción y escribe una nueva.

   3. Para editar la lista de administradores de datos, haz clic en edit Editar junto a Administrador, proporciona una lista de correos electrónicos de administradores de datos y haz clic en Guardar.

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

      • Para cambiar la categoría principal, en el campo Selecciona una categoría, ingresa el nombre de una nueva categoría principal del glosario actual y selecciónala.

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

      Haz clic en Guardar.

Cómo borrar un término

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

   Ir a Glosarios

2. Expande el glosario y haz clic en el término que quieras borrar de forma permanente.

   Se muestra una advertencia que indica que el borrado es irreversible y que se quitarán todas las relaciones asociadas con el término.

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

Administra sinónimos y términos relacionados

Puedes agregar relaciones entre los 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.

Agrega sinónimos y términos relacionados

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

   Ir a Glosarios

2. Expande el glosario y haz clic en el término al que deseas adjuntar 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, ingresa el término que deseas adjuntar y selecciónalo en el resultado de la búsqueda.

   El término se adjunta de inmediato cuando lo seleccionas.

5. Haz clic en Listo.

Cómo quitar sinónimos y términos relacionados

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

   Ir a Glosarios

2. Expande el glosario y haz clic en el término para el que deseas quitar 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 deseas borrar, haz clic en close Borrar . El archivo adjunto se borra de inmediato.

   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. En el sinónimo que deseas borrar, haz clic en close Borrar. El archivo adjunto se borra de inmediato.

   3. Haz clic en Listo.

Administra los términos a nivel de la columna

Puedes adjuntar términos a las columnas de las entradas de Data Catalog (obsoleto) que tienen esquemas (por ejemplo, tablas y conjuntos de archivos) para proporcionar más contexto sobre los datos de las columnas.

Adjunta términos a las columnas

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

2. Haz clic en la pestaña Esquema.

3. En la columna Condiciones comerciales, para el campo al que deseas adjuntar condiciones, haz clic en add Agregar .

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

5. Haz clic en Adjuntar condiciones.

Consulta los detalles de las condiciones adjuntas a las columnas

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

2. Haz clic en la pestaña Esquema.

3. En la columna Condiciones comerciales, haz clic en la condición para ver su descripción. También puedes quitar el término o navegar a la página de detalles del término con las opciones de esta ventana.

Cómo quitar los términos asociados a las columnas

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

2. Haz clic en la pestaña Esquema.

3. En la columna Condiciones comerciales, haz clic en close Borrar para la condición que deseas quitar.

   También puedes quitar el término adjunto haciendo clic en él y, luego, en Quitar término comercial > Confirmar.

Cómo encontrar glosarios y términos

Para navegar por el contenido de tu glosario empresarial, usa el árbol de glosarios y términos en la página Glosarios de Dataplex Universal Catalog.

Puedes usar la barra de filtros de la página Glosarios de Dataplex Universal Catalog para ubicar categorías por nombre visible o términos según un criterio. El filtro devuelve elementos con cualquier atributo que coincida con la búsqueda 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 conectados con el nombre o la descripción del glosario principal que contiene la frase Finance.

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

• synonym:VALUE: Destaca los términos que tienen al menos un sinónimo con un nombre o una descripción que coinciden con VALUE. Por ejemplo, synonym:interest destaca los términos que tienen términos relacionados con un nombre o una descripción que contiene la frase interest.

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

Buscar entradas de datos con términos

Puedes usar el contenido del glosario empresarial de Dataplex Universal Catalog cuando busques entradas en la página Search de Dataplex Universal Catalog.

Se admiten las siguientes situaciones de búsqueda:

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

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

¿Qué sigue?

• Crea contenido para el glosario empresarial.
• Descubre las entradas de datos con los términos del glosario adjuntos.