En este documento, se describe cómo crear y usar contenido del glosario empresarial en Dataplex.
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 catalogadas.
Puedes usar el glosario empresarial de Dataplex 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 los 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
- Muestra términos relacionados y entradas de datos 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 asociadas y las relaciones entre los términos. Proporciona un solo lugar para mantener y administrar las condiciones comerciales y sus definiciones. Un glosario empresarial tiene la siguiente propiedad que se muestra en la consola:
- Descripción general: Es una descripción de texto enriquecido de formato libre del propósito y el contenido del glosario empresarial.
Categoría
Una categoría se define dentro de un glosario empresarial. Te permite organizar y estructurar varias categorías y términos. Puedes anidar categorías hasta en 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 existe.
- Descripción: Es una definición comercial de la categoría en formato de texto enriquecido de formato libre.
- 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 particular de la 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 corresponde.
- Descripción: Es una definición empresarial del término en texto enriquecido de formato libre.
- 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 esos términos las describen.
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 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
.
Antes de comenzar
Limitaciones
- No se admite la importación masiva de términos a un glosario de la empresa.
- La función de glosario empresarial solo es compatible con 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 sus términos adjuntos coincide con el término que se usó para la búsqueda. Sin embargo, la referencia al término coincidente no se muestra en el resultado de la búsqueda.
- No se admiten las regiones de BigQuery Omni. No puedes crear contenido de glosario de la empresa ni adjuntar términos a entradas de datos en estas regiones.
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 los glosarios, las categorías y los términos:
Propietario del glosario de DataCatalog (
roles/datacatalog.glossaryOwner
) -
Leer glosarios, categorías y términos, crear vínculos entre términos y crear vínculos 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 los glosarios, las categorías y los términos:
-
datacatalog.entries.*
-
datacatalog.relationships.*
-
-
Lee glosarios, categorías y términos, crea vínculos entre términos y crea vínculos 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 de Data Catalog.
Crea y administra glosarios empresariales
Crea un glosario empresarial
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Haz clic en Crear glosario empresarial.
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.
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.
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.
Modifica un glosario
Puedes modificar el nombre y la descripción de un glosario.
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Haz clic en el glosario que deseas modificar.
Para editar el nombre, haz clic en
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
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Haz clic en el glosario que quieres borrar.
Haz clic en Borrar.
Para confirmar la acción, ingresa el nombre del glosario y haz clic en Confirmar.
Crea y administra categorías
Crea una categoría en un glosario
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Selecciona un glosario en el que deseas crear una categoría y haz clic en Crear categoría.
En la página Crear categoría, ingresa un nombre y una descripción para la categoría.
Haz clic en Crear.
Se abrirá la página de detalles de la categoría.
Cómo crear una categoría dentro de una categoría
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Expande el glosario en el que deseas crear una categoría.
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 hasta en tres niveles.
En la página Crear categoría, ingresa un nombre y una descripción para la categoría.
Haz clic en Crear.
Se abrirá la página de detalles de la categoría.
Consulta la lista de categorías disponibles
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Para ver la lista de categorías disponibles en un glosario, expándelo.
Para ver la lista de categorías anidadas disponibles, expande la categoría.
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.
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Expande el glosario y haz clic en la categoría que quieras modificar.
Para editar el nombre, haz clic en
Editar y escribe uno nuevo.Para editar la descripción, haz clic en Editar descripción y, luego, ingresa una nueva.
Para editar la lista de administradores de datos, haz clic en
Editar junto a Administrador, proporciona una lista de correos electrónicos de los administradores de datos y haz clic en Guardar.Para editar la categoría, haz clic en
Editar junto a Categoría.Para cambiar la categoría superior, en el campo Seleccionar 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 Seleccionar una categoría, selecciona ---Ninguna---.
Haz clic en Guardar.
Borrar una categoría
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Expande el glosario y haz clic en la categoría que quieras borrar de forma permanente.
Aparecerá 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 términos
Crea un término
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Selecciona un glosario en el que quieras crear un término y haz clic en Crear término.
En la página Crear término, ingresa un nombre y una descripción para el término.
Haz clic en Crear.
Se abrirá la página de detalles del término.
Consulta la lista de condiciones disponibles
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Para ver la lista de términos disponibles en un glosario, expándelo.
Accede a los detalles de un término
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Para ver la lista de términos disponibles en un glosario, expándelo.
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.
Actualiza un término
Puedes modificar el nombre, la descripción y el encargado de datos de un término.
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Expande el glosario y haz clic en el término que quieres modificar.
Para editar el nombre, haz clic en
Editar y escribe uno nuevo.Para editar la descripción, haz clic en Editar descripción y, luego, ingresa una nueva.
Para editar la lista de administradores de datos, haz clic en
Editar junto a Administrador, proporciona una lista de correos electrónicos de los administradores de datos y haz clic en Guardar.Para editar la categoría, haz clic en
Editar junto a Categoría.Para cambiar la categoría superior, en el campo Seleccionar 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 Seleccionar una categoría, selecciona ---Ninguna---.
Haz clic en Guardar.
Cómo borrar un término
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Expande el glosario y haz clic en el término que quieres borrar de forma permanente.
Se muestra una advertencia que indica que la eliminación 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
Para agregar relaciones entre términos, márcalos 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
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Expande el glosario y haz clic en el término al que deseas adjuntar un sinónimo o un término relacionado.
Haz clic en
Editar para ver los Términos relacionados o los Sinónimos.En el campo Términos del glosario de búsqueda, ingresa el término que deseas vincular y selecciónalo en el resultado de la búsqueda.
El término se adjunta de inmediato cuando lo seleccionas.
Haz clic en Listo.
Cómo quitar sinónimos y términos relacionados
En la consola de Google Cloud , ve a la página Glosarios de Dataplex.
Expande el glosario y haz clic en el término del que quieres quitar un sinónimo o un término relacionado.
Para quitar un término relacionado, sigue estos pasos:
Haz clic en
Editar junto a Términos relacionados.En el término relacionado que deseas borrar, haz clic en
Borrar . El archivo adjunto se borrará de inmediato.Haz clic en Listo.
Para quitar un sinónimo, sigue estos pasos:
Haz clic en
Editar junto a Sinónimos.En el sinónimo que quieres borrar, haz clic en
Borrar. El archivo adjunto se borrará de inmediato.Haz clic en Listo.
Administra términos a nivel de la columna
Puedes adjuntar términos a las columnas de las entradas de Data Catalog 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
Navega a una entrada de Data Catalog que tenga un esquema.
Haz clic en la pestaña Esquema.
En la columna Términos comerciales, haz clic en
Agregar para el campo al que deseas adjuntar los términos .En el campo Term search, ingresa el nombre del término y selecciónalo en el resultado de la búsqueda. Puedes seleccionar varios términos.
Haz clic en Adjuntar condiciones.
Consulta los detalles de los términos adjuntos a las columnas
Navega a una entrada de Data Catalog que tenga un esquema.
Haz clic en la pestaña Esquema.
En la columna Términos comerciales, haz clic en el término 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.
Quita los términos adjuntos a las columnas
Navega a una entrada de Data Catalog que tenga un esquema.
Haz clic en la pestaña Esquema.
En la columna Términos comerciales, haz clic en
Borrar para el término 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 glosario y el árbol de términos en la página Glosarios de Dataplex.
Puedes usar la barra de filtro en la página Glosarios de Dataplex para encontrar categorías por nombre visible o términos según un criterio. El filtro muestra 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 superior coinciden conVALUE
. Por ejemplo,parent:Finance
destaca los términos conectados con el nombre o la descripción del glosario superior que contiene la fraseFinance
.contact:VALUE
: Destaca los términos en los que el administrador de datos esVALUE
. Por ejemplo,contact:johndoe@company.org
destaca las entradas conectadas a términos con el administrador de datos que coincide conjohndoe@company.org
.synonym:VALUE
: Destaca los términos que tienen al menos un sinónimo con un nombre o una descripción que coincide conVALUE
. Por ejemplo,synonym:interest
destaca los términos que tienen términos relacionados con un nombre o una descripción que contiene la fraseinterest
.related_to:VALUE
: Destaca los términos que tienen al menos un término relacionado con un nombre o una descripción que coincide conVALUE
. Por ejemplo,related_to:discounting
destaca los términos que tienen términos relacionados con un nombre o una descripción que contiene la frasediscounting
.
Buscar entradas de datos con 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:
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 coincida con la búsqueda. Estos resultados se muestran junto con los resultados recuperados de las otras formas de concordancia 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 conVALUE
.
¿Qué sigue?
- Crea contenido para el glosario empresarial.
- Descubre las entradas de datos con los términos del glosario adjuntos.