Crear y administrar glosarios empresariales de Dataplex

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En este documento, se muestra cómo crear y usar el contenido del glosario empresarial de Dataplex.

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

Puedes usar el glosario empresarial de Dataplex para lo siguiente:

• Crear y mantener glosarios, categorías y términos comerciales
• 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.
• Explora y filtra términos en el glosario empresarial.
• Muestra los términos relacionados y las entradas de datos de un término determinado.
• Buscar entradas de datos etiquetadas por un término en particular
• Muestra términos relacionados con una entrada de datos determinada.

Terminología

En este documento, se usa la siguiente terminología:

Glosario empresarial

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

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

Categoría

Una categoría se define dentro de un glosario de empresa. Te permite organizar y estructurar distintos categorías y términos. Puedes anidar categorías en hasta tres niveles. Las siguientes 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 la hay.
• Descripción: Es una definición de la empresa de texto enriquecido y 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.

Período

Un término se define dentro de un glosario de negocios, ya sea directamente o dentro de cualquier categoría que se encuentre en él. Describe un concepto usado en una rama particular dentro de una empresa. En la consola, se muestran las siguientes propiedades de un término:

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

Puedes adjuntar términos con columnas de entrada de datos para indicar que las columnas se describen en los términos respectivos.

Sinónimo

Un sinónimo es una relación que se usa para indicar la similitud semántica o la equivalencia entre dos términos diferentes. Se usa cuando equipos diferentes definen dos términos similares 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.

Antes de comenzar

Limitaciones

• No se admite la importación masiva de términos a un glosario empresarial.
• La función de glosario empresarial solo se admite en la consola de Google Cloud.
• Cuando buscas entradas de datos en la página Búsqueda de Dataplex, el resultado de la búsqueda incluye entradas de datos en las que uno de los términos adjuntos coincide con el término usado para la búsqueda. Sin embargo, la referencia al término coincidente no se muestra en el resultado de la búsqueda.
• Las regiones de BigQuery Omni no son compatibles. No puedes crear contenido del glosario empresarial ni adjuntar términos a las entradas de datos en estas regiones.

Roles y permisos requeridos

Si deseas 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 los glosarios, las categorías y los términos: Propietario del glosario de DataCatalog (roles/datacatalog.glossaryOwner)
• Lee glosarios, categorías y términos, crea archivos adjuntos entre términos y crea 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: Visualizador de entradas de DataCatalog (roles/datacatalog.entryViewer)

Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

Estas funciones predefinidas 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 los glosarios, las categorías y los términos:
  • datacatalog.entries.*
  • datacatalog.relationships.*
• Lee glosarios, categorías y términos, crea archivos 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
• Crea o borra glosarios: datacatalog.entryGroups.create

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

Nota: Para crear o borrar glosarios, debes tener la función de IAM de creador de EntryGroup de Data Catalog (roles/datacatalog.entryGroupCreator) o sus respectivos permisos, además de la función de propietario del glosario de Data Catalog (roles/datacatalog.glossaryOwner).

Para obtener más información sobre las funciones y los permisos de Data Catalog, consulta Funciones predefinidas de Data Catalog.

Crea y administra glosarios empresariales

Crea un glosario empresarial

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

   Ir a Glosarios

2. Haz clic en Crear glosario empresarial.

3. En la página Crea un 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.

  Ir a Glosarios

  En el panel Mis glosarios, se muestran todos los glosarios de la organización en los que tienes el permiso view. Los glosarios se muestran con sus descripciones y la hora 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.

   Ir a Glosarios

2. Haz clic en el glosario que deseas modificar.

   • Para editar el nombre, haz clic en , 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.

   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.

Cómo crear y administrar categorías

Cómo crear una categoría en un glosario

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

   Ir a Glosarios

2. Selecciona un glosario en el que desees 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 en una categoría

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

   Ir a Glosarios

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

3. Selecciona la categoría superior en la que deseas crear otra categoría y haz clic en Crear categoría. Puedes anidar una categoría en hasta 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.

   Ir a Glosarios

2. Expande un glosario para ver la lista de categorías disponibles.

3. Expande la categoría para ver la lista de categorías anidadas disponibles.

Cómo actualizar una categoría

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

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

   Ir a Glosarios

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

   1. Para editar el nombre, haz clic en y, luego, ingresa un nombre nuevo.

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

   3. Para editar la lista de administradores de datos, haz clic en junto a Steward, 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 junto a Categoría.

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

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

      Haz clic en Guardar.

Borrar una categoría

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

   Ir a Glosarios

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

   Aparecerá una advertencia que indica que la eliminación es irreversible y 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.

Crear y administrar condiciones

Crea un término

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

   Ir a Glosarios

2. Selecciona el glosario en el que deseas 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 términos disponibles

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

   Ir a Glosarios

2. Expande un glosario para ver la lista de términos disponibles.

Accede a los detalles de un término

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

   Ir a Glosarios

2. Expande un glosario para ver la lista de términos disponibles.

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 administrador de datos de un término.

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

   Ir a Glosarios

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

   1. Para editar el nombre, haz clic en y, luego, ingresa un nombre nuevo.

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

   3. Para editar la lista de administradores de datos, haz clic en junto a Steward, 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 junto a Categoría.

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

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

      Haz clic en Guardar.

Borrar un término

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

   Ir a Glosarios

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

   Aparecerá una advertencia que indica que la eliminación es irreversible y 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.

Administrar sinónimos y términos relacionados

Puedes agregar relaciones entre términos si los marcas 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.

Nota: Las relaciones entre términos son bidireccionales. Por ejemplo, cuando seleccionas Term 2 como sinónimo de Term 1, Term 1 también se convierte en un sinónimo de Term 2.

Agregar sinónimos y términos relacionados

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

   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 para Términos relacionados o Sinónimos.

4. En el campo Buscar términos del glosario, ingresa el término que deseas adjuntar y selecciona el término del resultado de la búsqueda.

   El término se adjunta inmediatamente cuando lo seleccionas.

5. Haz clic en Listo.

Quitar sinónimos y términos relacionados

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

   Ir a Glosarios

2. Expande el glosario y haz clic en el término del que deseas quitar un sinónimo o un término relacionado.

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

   1. Haga clic en la junto a Términos relacionados.

   2. Haz clic en para el término relacionado que deseas borrar. El archivo adjunto se borrará de inmediato.

   3. Haz clic en Listo.

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

   1. Haga clic en junto a Sinónimos.

   2. Haz clic en para el sinónimo que deseas borrar. El archivo adjunto se borrará de inmediato.

   3. Haz clic en Listo.

Administrar términos a nivel de columna

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

Adjuntar términos a 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 para el campo al que deseas adjuntar las condiciones.

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 los términos adjuntos 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 el término para ver su descripción. También puedes quitar el término o navegar a su página de detalles con las opciones de esta ventana.

Quitar los términos adjuntos 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 para el término que deseas quitar.

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

Ubicar glosarios y términos

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

Puedes usar la barra de filtros en la página Glosarios de Dataplex para ubicar categorías por nombre visible o términos según un criterio. El filtro muestra los elementos con cualquier atributo que coincida con la consulta de filtro. También puedes usar los siguientes calificadores:

• parent:VALUE

  Destaca los términos cuyo nombre o descripción del glosario superior coincide con VALUE.

  Por ejemplo, parent:Finance destaca los términos conectados con el nombre o la descripción del glosario superior que contiene la frase Finance.

• contact:VALUE

  Destaca los términos en los que el administrador de datos es VALUE.

  Por ejemplo, contact:[e-mail] destaca las entradas conectadas a los términos con administrador de datos que coincide con [e-mail].

• synonym:VALUE

  Destaca los términos que tienen al menos un sinónimo de nombre o descripción que coincida con VALUE.

  Por ejemplo, synonym:interest destaca los términos que tienen términos relacionados con el nombre o la descripción que contiene la frase interest.

• related_to:VALUE

  Destaca los términos que tienen al menos un término relacionado cuyo nombre o descripción coincide con VALUE.

  Por ejemplo, related_to:discounting destaca los términos que tienen términos relacionados con el nombre o la descripción que contiene la frase discounting.

Buscar entradas de datos usando términos

Puedes usar el contenido del glosario empresarial de Dataplex cuando busques entradas en la página Búsqueda de Dataplex.

Se admiten las siguientes situaciones de búsqueda:

Nota: En esta sección, la frase “entradas conectadas a un término” se refiere a las entradas con al menos una columna que contiene un término adjunto.

• 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 cuyo nombre o descripción coincide con la búsqueda. Estos resultados se muestran junto con los resultados recuperados de otras formas de coincidencia que no están relacionadas con el contenido del glosario de la empresa.

  Nota: El resultado de la búsqueda muestra las entradas conectadas con los términos que coinciden con la búsqueda. Sin embargo, la fuente de la coincidencia no se muestra en el resultado de la búsqueda.

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

¿Qué sigue?

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