Gestionar un glosario empresarial

El glosario de términos empresariales de Universal Catalog de Dataplex ofrece un único lugar para gestionar la terminología y las definiciones relacionadas con la empresa en toda la organización.

Cuando diferentes equipos trabajan en un proyecto compartido o una gran empresa tiene muchos departamentos, es habitual que cada parte de la empresa cree su propia terminología para describir los distintos recursos de datos con los que trabaja. Esto puede provocar errores de comunicación y una comprensión incoherente de esos recursos. Además, a veces un concepto puede requerir conocimientos técnicos o especializados. Esto puede dificultar que los usuarios empresariales de otros dominios comprendan el concepto.

El glosario de términos empresariales de Universal Catalog de Dataplex te permite crear un vocabulario centralizado y estandarizado para tus recursos de datos. Puedes usar un glosario de empresa para hacer lo siguiente:

  • Define una estructura jerárquica de categorías y conceptos empresariales, denominada términos.
  • Crea conexiones entre conceptos definiendo sinónimos y términos relacionados.
  • Asocia tus recursos de datos con términos del glosario, lo que te permite buscar recursos de datos en función de conceptos empresariales.

Un glosario de empresa ayuda a agilizar la detección de datos y a reducir la ambigüedad, lo que puede dar lugar a análisis más precisos, una mejor gestión y estadísticas más rápidas.

Elementos de un glosario empresarial

En esta sección se describen los elementos clave que puedes usar para estructurar un glosario de empresa.

Glosario

Un glosario tiene las siguientes propiedades:

  • Introducción. Describe la finalidad y el contenido del glosario empresarial. Puedes añadir imágenes, enlaces, tablas o texto con formato al glosario. El tamaño máximo admitido es de 120 KB.
  • Descripción. Describe el glosario. El texto de este campo se indexa para búsquedas. El tamaño máximo admitido es de 1 KB.
  • Región. Especifica la región en la que se encuentra el glosario.

Categoría

Las categorías le permiten organizar y estructurar varias categorías y términos. Las categorías se definen en un glosario empresarial. Puedes anidar categorías hasta tres niveles.

Una categoría tiene las propiedades de un glosario, así como las siguientes:

  • Contactos Especifica la persona responsable de mantener la categoría. Esta propiedad es descriptiva y no afecta a los permisos de la categoría.
  • Padre o madre. Especifica una relación que se usa para establecer el elemento superior de la categoría actual. Puedes anidar hasta tres categorías.

La región de una categoría es la misma que la del glosario que la contiene.

Término

Un término (abreviatura de "término de glosario") describe un concepto que se usa en una rama de actividad concreta de tu empresa. Por ejemplo, el departamento de marketing de una empresa puede crear un término que describa el coste por clic. Los términos se definen en un glosario de empresa, ya sea directamente en el glosario o en cualquier categoría que se encuentre en él.

Un término tiene las propiedades de una categoría, así como las siguientes propiedades:

  • Sinónimos. Especifica los enlaces entre términos que tienen el mismo significado. Consulta los términos sinónimos.
  • Términos relacionados. Especifica los enlaces entre términos que están relacionados conceptualmente entre sí, pero que tienen significados diferentes. Consulta los términos relacionados.
  • Entradas relacionadas Especifica los vínculos entre términos y recursos de datos, o entre términos y columnas de recursos de datos.
  • Contactos Especifica la persona responsable de mantener el término. Los términos no heredan los contactos definidos en las categorías.

La región de un término es la misma que la de la glosario que lo contiene.

Términos sinónimos

Un sinónimo es una relación que indica la equivalencia entre dos términos diferentes. Usa sinónimos cuando dos términos con el mismo significado estén definidos por diferentes equipos en diferentes glosarios. Por ejemplo, puedes crear un sinónimo para vincular los términos "beneficio" y "ganancias".

Un término relacionado es una relación que indica que dos términos están asociados entre sí, pero tienen significados diferentes. Por ejemplo, puede crear un término relacionado para vincular los términos "ingresos" y "beneficios".

Limitaciones

Roles obligatorios

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 (IAM) en tu proyecto:

  • Los administradores de datos pueden obtener acceso completo a glosarios, categorías, términos, sinónimos y términos relacionados, así como definir políticas de gestión de identidades y accesos: Administrador de catálogo de Dataplex (roles/dataplex.catalogAdmin)
  • Los responsables o propietarios de los datos pueden crear, editar o eliminar glosarios, categorías, términos y enlaces entre términos, así como enlaces entre términos y recursos de datos, y buscar: Editor de Dataplex Catalog (roles/dataplex.catalogEditor)
  • Los analistas o consumidores de datos pueden obtener acceso de solo lectura a glosarios, categorías, términos, enlaces entre términos y entre términos y recursos de datos, así como buscar: Lector del catálogo de Dataplex (roles/dataplex.catalogViewer)

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:

  • Crea, lee, actualiza y elimina un glosario de empresa, una categoría y términos de tu proyecto:
    • dataplex.glossaries.list
    • dataplex.glossaries.create
    • dataplex.glossaries.get
    • dataplex.glossaries.update
    • dataplex.glossaries.delete
    • dataplex.glossaryCategories.create
    • dataplex.glossaryCategories.list
    • dataplex.glossaryCategories.get
    • dataplex.glossaryCategories.update
    • dataplex.glossaryCategories.delete
    • dataplex.glossaryTerms.create
    • dataplex.glossaryTerms.list
    • dataplex.glossaryTerms.get
    • dataplex.glossaryTerms.update
    • dataplex.glossaryTerms.delete
  • Crear y eliminar enlaces de sinónimos en tu proyecto:
    • dataplex.entryLinks.create en el grupo de entradas de Dataplex Universal Catalog del proyecto en el que se encuentre cualquiera de los términos del glosario. El enlace se crea en el grupo de entradas para el que se ha concedido el permiso.
    • dataplex.entryGroups.useSynonymEntryLink en el grupo de entradas de Dataplex Universal Catalog del proyecto en el que se encuentre cualquiera de los términos del glosario. El enlace se crea en el grupo de entradas para el que se ha concedido el permiso.
    • dataplex.glossaryTerms.use en los glosarios cuyos términos deban asociarse.
    • dataplex.entryLinks.delete en el grupo de entradas de Dataplex Universal Catalog del proyecto en el que se encuentra el enlace.
  • Crea y elimina enlaces de términos relacionados en tu proyecto:
    • dataplex.entryLinks.create en el grupo de entradas de Dataplex Universal Catalog del proyecto en el que se encuentre cualquiera de los términos del glosario. El enlace se crea en el grupo de entradas para el que se ha concedido el permiso.
    • dataplex.entryGroups.useRelatedEntryLink en el grupo de entradas de Dataplex Universal Catalog del proyecto en el que se encuentre cualquiera de los términos del glosario. El enlace se crea en el grupo de entradas para el que se ha concedido el permiso.
    • dataplex.entries.link en el grupo de entradas de Dataplex Universal Catalog de los proyectos en los que haya entradas correspondientes a términos del glosario.
    • dataplex.entryLinks.delete en el grupo de entradas de Dataplex Universal Catalog del proyecto en el que se encuentra el enlace.
  • Crea enlaces entre los términos y los recursos de datos o las columnas de tu proyecto:
    • dataplex.entryLinks.create en el grupo de entradas del sistema correspondiente a los recursos de datos o las columnas del proyecto. El enlace se crea en el proyecto para el que se ha concedido el permiso.
    • dataplex.entryGroups.useDefinitionEntryLink en el grupo de entradas del sistema correspondiente a los recursos de datos o las columnas del proyecto. El enlace se crea en el proyecto para el que se ha concedido el permiso.
    • dataplex.entries.link en el grupo de entradas del sistema correspondiente a los recursos de datos o las columnas del proyecto. El enlace se crea en el proyecto para el que se ha concedido el permiso.
    • dataplex.glossaryTerms.use en el glosario cuyo término deba asociarse.
    • dataplex.entryLinks.delete en el grupo de entradas del sistema en el que se encuentra el enlace.

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

Para obtener más información, consulta los roles de gestión de identidades y accesos de Dataplex Universal Catalog.

Crear y gestionar glosarios empresariales

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

Crear un glosario empresarial

Consola

  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 un nombre y una ubicación para el glosario empresarial. Una vez que hayas creado el glosario, no podrás cambiar la ubicación.

  4. Haz clic en Crear. El glosario se crea en el proyecto actual.

  5. Opcional: Añade una descripción breve en Descripción (hasta 1024 caracteres) o una descripción larga en Resumen (hasta 120 KB).

REST

Cuando creas un glosario, Dataplex Universal Catalog crea una entrada para representarlo.

  1. Crea el glosario.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto en el que quieres crear el glosario
    • LOCATION_ID: el ID de la ubicación en la que quieres crear el glosario
    • GLOSSARY_ID: el ID del glosario
    • DISPLAY_NAME: el nombre visible del glosario
    • DESCRIPTION: descripción del glosario, con un máximo de 1024 caracteres.

  2. Opcional: Añade una descripción general al glosario.

    1. Busca la entrada de tu glosario:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID
\
\&view=ALL

      Sustituye PROJECT_NUMBER por el número del proyecto en el que se ha creado tu glosario.

    2. Añade una descripción general a tu glosario:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \
--data @- << EOF
{
"aspects": {
   "dataplex-types.global.overview": {
      "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview",
      "data": {
      "content": "OVERVIEW",
      "links": []
      },
   }
}
}
EOF

      Sustituye OVERVIEW por texto sin formato o HTML para describir la categoría o el término del glosario.

Ver las glosarios disponibles

Consola

  • 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.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries

Editar un glosario

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

Consola

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

    Ir a Glosarios

  2. Haz clic en el glosario que quieras editar.

  3. Haz clic en Editar junto al nombre, la descripción o el resumen y, a continuación, haz los cambios que quieras.

  4. Haz clic en Guardar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Eliminar un glosario

Antes de eliminar un glosario, primero debes eliminar todas las categorías y los términos del glosario.

Consola

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

    Ir a Glosarios

  2. Haz clic en la lista de términos que quieras eliminar.

  3. Haz clic en Eliminar y, a continuación, confirma la acción cuando se te pida.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID

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

Un glosario de empresa puede tener un máximo de 200 categorías.

Consola

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

    Ir a Glosarios

  2. Seleccione el glosario en el que quiera crear una categoría y, a continuación, haga clic en Crear categoría.

  3. Escribe el nombre de la categoría.

  4. Haz clic en Crear.

  5. Opcional: Añade una descripción breve en Descripción (hasta 1024 caracteres) o una descripción larga en Resumen (hasta 120 KB).

REST

Cuando creas una categoría, Dataplex Universal Catalog crea una entrada para representarla.

  1. Crea la categoría.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "CATEGORY_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

    Haz los cambios siguientes:

    • CATEGORY_ID: el ID de la categoría
    • CATEGORY_DISPLAY_NAME: el nombre visible de la categoría
    • CATEGORY_DESCRIPTION: la descripción de la categoría

  2. Opcional: Añade una descripción general a la categoría.

    1. Busca la entrada de tu categoría:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

    2. Añade una descripción general a tu categoría:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Sustituye OVERVIEW por texto sin formato o HTML para describir la categoría o el término del glosario.

  3. Opcional: Añadir contactos

    1. Busca la entrada de tu categoría:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

    2. Actualiza la entrada de tu categoría con los contactos:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Crear una categoría anidada

Un glosario empresarial puede tener un máximo de tres niveles de categorías anidadas, sin incluir el nivel raíz del glosario.

Consola

  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. Seleccione la categoría principal en la que quiera crear otra categoría y haga clic en Crear categoría.

  4. Escribe el nombre de la categoría.

  5. Haz clic en Crear.

  6. Opcional: Añade una descripción breve en Descripción (hasta 1024 caracteres) o una descripción larga en Resumen (hasta 120 KB).

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
  "displayName": "CATEGORY_DISPLAY_NAME",
  "description": "CATEGORY_DESCRIPTION",
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

Sustituye PARENT_CATEGORY_ID por el ID de la categoría principal.

Ver las categorías que pertenecen a un glosario

Consola

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

    Ir a Glosarios

  2. Para ver las categorías de un glosario, despliégalo.

  3. Para ver las categorías anidadas de una categoría, despliégala.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories

Editar una categoría

Puedes editar el nombre, la descripción y los contactos de una categoría. En el caso de las categorías anidadas, también puedes editar la categoría principal.

Consola

  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 editar.

  3. Haz clic en Editar junto al nombre, la descripción o el resumen y, a continuación, haz el cambio.

  4. Haz clic en Guardar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Eliminar una categoría

Consola

  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.

  3. Haz clic en Eliminar y, a continuación, confirma la acción cuando se te pida.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID

Crear y gestionar términos

En las siguientes secciones se describe cómo crear, ver, acceder, editar y eliminar términos.

Crear un término en un glosario empresarial

Un glosario empresarial puede tener un máximo de 5000 términos.

Consola

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

    Ir a Glosarios

  2. Para crear un término a nivel de glosario, selecciona el glosario en el que quieras crear un término y, a continuación, haz clic en Crear término.

  3. Escribe un nombre para el término.

  4. Haz clic en Crear.

  5. Opcional: Añade una descripción breve en Descripción (hasta 1024 caracteres) o una descripción larga en Resumen (hasta 120 KB).

  6. Opcional: Para añadir contactos, haga clic en Editar y, a continuación, proporcione una lista de direcciones de correo de los responsables, los propietarios o los propietarios del dominio de datos. A continuación, haz clic en Guardar.

REST

Cuando creas un término, Dataplex Universal Catalog crea una entrada para representarlo.

  1. Crea el término.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

    Haz los cambios siguientes:

    • TERM_ID: el ID del término que estás creando
    • TERM_DISPLAY_NAME: el nombre visible del término que estás creando
    • TERM_DESCRIPTION: la descripción del término que estás creando

  2. Opcional: Añade una descripción general al término.

    1. Busca la entrada de tu término:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Añade una descripción general del término:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Sustituye OVERVIEW por texto sin formato o HTML para describir la categoría o el término del glosario.

  3. Opcional: Añade contactos.

    1. Busca la entrada de tu término:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Para actualizar la entrada de tu mandato con los contactos, sigue estos pasos:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Crear un término en una categoría

Consola

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

    Ir a Glosarios

  2. Para crear un término en una categoría, selecciona la categoría en la que quieras crear un término y, a continuación, haz clic en Añadir término.

  3. Escribe un nombre para el término.

  4. Haz clic en Crear.

  5. Opcional: Añade una descripción breve en Descripción (hasta 1024 caracteres) o una descripción larga en Resumen (hasta 120 KB).

  6. Opcional: Para añadir contactos, haga clic en Editar y, a continuación, proporcione una lista de direcciones de correo de los responsables, los propietarios o los propietarios del dominio de datos. A continuación, haz clic en Guardar.

REST

Cuando creas un término, Dataplex Universal Catalog crea una entrada para representarlo.

  1. Crear un término.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

    Haz los cambios siguientes:

    • TERM_ID: el ID del término que estás creando
    • TERM_DISPLAY_NAME: el nombre visible del término que estás creando
    • TERM_DESCRIPTION: la descripción del término que estás creando

  2. Opcional: Añade una descripción general al término.

    1. Busca la entrada de tu término:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Añade una descripción general del término:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Sustituye OVERVIEW por texto sin formato o HTML para describir la categoría o el término del glosario.

  3. Opcional: Añade contactos.

    1. Busca la entrada de tu término:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Para actualizar la entrada de tu mandato con los contactos, sigue estos pasos:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Ver los términos en un glosario o una categoría

Consola

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

    Ir a Glosarios

  2. Para ver los términos de un glosario, despliega el glosario. Para ver los términos de una categoría de este glosario, despliégala. Para ver los términos de una categoría anidada, despliégala.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms

Ver los detalles de un término

Consola

  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 de un glosario, amplíalo.

  3. Haz clic en un término. En la página Detalles del término se muestra el nombre del término, la descripción, los términos relacionados, los sinónimos y las entradas relacionadas.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Editar un término

Puedes editar el nombre, la descripción, la información general, los contactos y el elemento superior de un término.

Consola

  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 editar.

  3. Haz clic en Editar.

  4. Edita los campos que quieras y haz clic en Guardar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=displayName,description --data @- << EOF
{
  "displayName": "TERM_DISPLAY_NAME",
  "description": "TERM_DESCRIPTION"
}
EOF

Eliminar un término

Consola

  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.

  3. Haz clic en Eliminar y, a continuación, confirma la acción cuando se te pida.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Puedes añadir relaciones entre términos vinculándolos como sinónimos o términos relacionados.

Las relaciones de términos son bidireccionales. Por ejemplo, si vinculas profit como sinónimo de earnings, earnings también se convierte en sinónimo de profit.

Consola

  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 con el que quieras crear enlaces.

  3. Haz clic en Editar junto a Términos sinónimos.

  4. Busca y selecciona los términos a los que quieras vincularte.

    El término se vincula inmediatamente cuando lo seleccionas.

  5. Haz clic en Cerrar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Haz los cambios siguientes:

  • TERM1_PROJECT_NUMBER: el número de proyecto del primer término que se va a vincular.
  • TERM1_LOCATION_ID: el ID de ubicación del glosario que contiene el primer término.
  • TERM1_GLOSSARY_ID: el ID del glosario que contiene el primer término.
  • TERM1_ID: el ID del primer término.
  • TERM2_PROJECT_NUMBER: el número de proyecto del segundo término que quieras vincular como término sinónimo. Si ambos términos están en el mismo proyecto, este valor es el mismo que el número de proyecto del primer término.
  • TERM2_LOCATION_ID: el ID de ubicación del glosario que contiene el segundo término. Si ambos términos están en la misma ubicación, este valor es el mismo que el ID de ubicación del primer término.
  • TERM2_GLOSSARY_ID: el ID de la glosario que contiene el segundo término. Si ambos términos están en el mismo glosario, este valor es el mismo que el ID del glosario del primer término.
  • TERM2_ID: el ID del segundo término.
  • ENTRY_LINK_ID: un ID del enlace entre los dos términos. Cada término se representa como una entrada de Dataplex Universal Catalog. El enlace de entrada es la relación entre términos sinónimos.

Consola

  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 con el que quieras crear enlaces.

  3. Haz clic en Editar junto a Términos relacionados.

  4. Busca y selecciona los términos a los que quieras vincularte.

    El término se vincula inmediatamente cuando lo seleccionas.

  5. Haz clic en Cerrar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Haz los cambios siguientes:

  • TERM1_PROJECT_NUMBER: número de proyecto del primer periodo que se va a vincular.
  • TERM1_LOCATION_ID: el ID de ubicación del glosario que contiene el primer término.
  • TERM1_GLOSSARY_ID: el ID del glosario que contiene el primer término.
  • TERM1_ID: el ID del primer término.
  • TERM2_PROJECT_NUMBER: el número de proyecto del segundo término que quieras vincular como término relacionado. Si ambos términos están en el mismo proyecto, este valor es el mismo que el número de proyecto del primer término.
  • TERM2_LOCATION_ID: el ID de ubicación del glosario que contiene el segundo término. Si ambos términos están en la misma ubicación, este valor es el mismo que el ID de ubicación del primer término.
  • TERM2_GLOSSARY_ID: el ID de la glosario que contiene el segundo término. Si ambos términos están en el mismo glosario, este valor es el mismo que el ID del glosario del primer término.
  • TERM2_ID: el ID del segundo término.
  • ENTRY_LINK_ID: un ID del enlace entre los dos términos. Cada término se representa como una entrada de Dataplex Universal Catalog. El enlace de entrada es la relación entre términos relacionados.

Consola

  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 cuyos sinónimos o términos relacionados quieras eliminar.

  3. Para eliminar los enlaces entre términos relacionados, haz clic en Editar junto a Términos relacionados. Elimina los términos relacionados y, a continuación, haz clic en Cerrar.

  4. Para eliminar enlaces entre sinónimos, haz clic en Editar junto a Términos sinónimos. Elimina los sinónimos y haz clic en Cerrar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Puede asociar términos a recursos de datos o a columnas de recursos de datos. Por ejemplo, puedes asociar términos a un conjunto de datos de BigQuery.

Consola

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

    Ir a la búsqueda

  2. Busca el recurso de datos (como un conjunto de datos, un archivo o una tabla) al que quieras vincular un término y, a continuación, haz clic en él.

  3. En la página del recurso de datos, haga una de las siguientes acciones:

    • Para vincular términos a un recurso, en la pestaña Detalles, en la sección Términos del glosario, haz clic en Añadir. Busca y selecciona los términos y, a continuación, haz clic en Cerrar.
    • Si el recurso tiene un esquema, puedes vincular términos a una columna. En la pestaña Esquema, selecciona una columna para vincular los términos y, a continuación, haz clic en Añadir término empresarial. Busca y selecciona los términos y, a continuación, haz clic en Cerrar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
  "entry_references": [{
     "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
     "type": "SOURCE"
  }, {
     "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
     "type": "TARGET"
  }
  ]
}
EOF
)"

Haz los cambios siguientes:

  • PROJECT_NUMBER: número de proyecto del recurso de datos al que se va a vincular
  • ENTRY_LOCATION_ID: ID de ubicación del recurso de datos que se va a vincular.
  • ENTRY_GROUP_ID: el grupo de entradas del recurso de datos al que se va a vincular
  • ENTRY_LINK_ID: ID del enlace entre el término y la entrada de Dataplex Universal Catalog que representa el recurso de datos.
  • TERM_PROJECT_NUMBER: el número de proyecto del término que se va a vincular.

Asociar términos a una columna de un esquema de entrada

Consola

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

    Ir a la búsqueda

  2. Busca el recurso de datos (como un conjunto de datos, un archivo o una tabla) que tenga un esquema con una columna a la que quieras vincular un término. Haga clic en el recurso de datos.

  3. En la página del recurso de datos, haga una de las siguientes acciones:

    • Para vincular términos a una columna del recurso de datos, en la pestaña Esquema, seleccione las columnas a las que quiera adjuntar el término.
    • Haz clic en Añadir término empresarial. Busca el término que quieras adjuntar y haz clic en él para adjuntarlo.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
"entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
"entry_references": [{
  "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
  "type": "SOURCE",
  "path": "Schema.COLUMN_NAME",
}, {
  "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
  "type": "TARGET"
}
]
}
EOF
)"

Haz los cambios siguientes:

  • PROJECT_NUMBER: número de proyecto del recurso de datos que se va a vincular.
  • ENTRY_LOCATION_ID: ID de ubicación del recurso de datos que se va a vincular.
  • ENTRY_GROUP_ID: el grupo de entradas del recurso de datos al que se va a vincular
  • ENTRY_LINK_ID: ID del enlace entre el término y la entrada de Dataplex Universal Catalog que representa el recurso de datos.
  • TERM_PROJECT_NUMBER: número de proyecto del término que se va a vincular.
  • COLUMN_NAME: la columna a la que quieres adjuntar el término

Consola

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

    Ir a la búsqueda

  2. Busca el recurso de datos (como un conjunto de datos, un archivo o una tabla) del que quieras quitar los términos y haz clic en él.

  3. En la página del recurso de datos, haga una de las siguientes acciones:

    • Para quitar un término de un recurso, ve a la pestaña Detalles y, en la sección Términos del glosario, haz clic en el término. A continuación, haz clic en .
    • Para quitar un término de una columna, en la pestaña Esquema, haz clic en junto al término.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Buscar glosarios, términos y recursos de datos vinculados

Consola

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

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

    Ir a Glosarios

  2. En la página Glosarios, usa la barra de filtros para encontrar categorías. Están disponibles los siguientes filtros:

    • Nombre: devuelve las glosarios, categorías y términos cuyo nombre contenga el texto que proporciones.
    • Padre: devuelve los términos cuyo nombre o descripción del glosario principal coincida con el texto que proporcione. Por ejemplo, parent:Finance devuelve los términos que están conectados con el glosario principal cuyo nombre o descripción contiene la frase Finance.
    • Sinónimo: devuelve la lista de términos con un sinónimo cuyo nombre o ID contiene el texto que proporciones. Por ejemplo, synonym:Profit devuelve los términos que tienen un término sinónimo cuyo nombre o ID contiene la frase profit.
    • Contacto: devuelve los términos en los que el responsable de los datos aparece como contacto. Por ejemplo, contact:alex@example.com devuelve las entradas que están conectadas a términos con un responsable de datos que coincida con alex@example.com.

REST

Para buscar glosarios, términos y recursos de datos vinculados mediante la API REST, debes registrarte en la versión preliminar.

Buscar recursos de datos vinculados a términos

Consola

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

    Ir a Glosarios

  2. En la página Glosarios, usa la barra de filtros para introducir una consulta de búsqueda de texto libre. Devuelve una lista de coincidencias correspondientes en los nombres de glosario, categoría y término.

  3. Haz clic en un término coincidente.

  4. En la página Detalles del término, consulta los términos vinculados (sinónimos y términos relacionados) y las entradas vinculadas (recursos de datos) a este término.

  5. Si quieres ver los detalles de una entrada de Dataplex Universal Catalog, haz clic en ella.

REST

Para buscar glosarios, términos y recursos de datos vinculados mediante la API REST, debes registrarte en la versión preliminar.

Para importar glosarios y enlaces de otra herramienta de catalogación o para actualizar tus glosarios en Dataplex Universal Catalog, puedes importar de forma masiva glosarios, categorías, términos, enlaces entre términos, enlaces entre términos y recursos de datos, o columnas, mediante la API REST.

  1. Crea el glosario de destino.

    REST

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID -d "$(cat<<EOF

{
 "displayName": "DISPLAY_NAME",
 "description": "DESCRIPTION"
}
EOF
)"

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto en el que vas a crear el glosario
    • LOCATION_ID: la ubicación en la que queremos crear el glosario
    • GLOSSARY_ID: el ID del glosario
    • DISPLAY_NAME: el nombre visible del glosario
    • DESCRIPTION: la descripción del glosario

  2. Para importar categorías, términos y enlaces entre términos y recursos de datos en el glosario de destino creado, sube archivos de cada uno de estos elementos a un segmento de Cloud Storage. Estos archivos tienen el siguiente formato:

    • Formato de ejemplo de términos y categorías de un glosario

       {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}

    • Formato de ejemplo de enlaces entre términos

       {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}

    • Formato de ejemplo de los enlaces entre términos y recursos de datos

       projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}
 
    # Set GCURL alias
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "glossaries": "GLOSSARY_NAME"
     }
  }
}
EOF
)"

    Sustituye DATAPLEX_API por el endpoint de la API Dataplex Universal Catalog con el formato dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  3. Opcional: Obtén el estado de la operación.

    gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID

    Sustituye OPERATION_ID por el ID de la operación.

  4. Opcional: Obtén el estado del trabajo de metadatos.

    gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataJobs/JOB_ID

  5. Importa enlaces entre términos como sinónimos o términos relacionados.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "entry_groups":[  "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex"
        ],
        "entry_link_types":[
           "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
           "projects/dataplex-types/locations/global/entryLinkTypes/related"
        ],
        "referenced_entry_scopes":[
           "PROJECT_IDS"
        ]
     }
  }
}
EOF
)"

    Reemplaza DATAPLEX_API por dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  6. Importar enlaces entre términos y recursos de datos o columnas.

    Para crear una vinculación entre términos del glosario y recursos de datos, ejecute el trabajo de importación de cada grupo de entradas al que pertenezca la entrada del recurso de datos. Todos los enlaces de las entradas de definición se crean en este grupo de entradas.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
"type":"IMPORT",
"import_spec":{
  "log_level":"DEBUG",
  "source_storage_uri":"gs://STORAGE_BUCKET/",
  "entry_sync_mode":"FULL",
  "aspect_sync_mode":"INCREMENTAL",
  "scope":{
     "entry_groups":[  "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex"
     ],
     "entry_link_types":[
        "projects/dataplex-types/locations/global/entryLinkTypes/definition"
     ],
     "referenced_entry_scopes":[
        "PROJECT_IDS"
     ]
  }
}
}
EOF
)"

    Reemplaza DATAPLEX_API por dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

Precios

A partir de julio del 2026, la factura del glosario de términos empresariales de Dataplex Universal Catalog será la misma que la de los precios del almacenamiento de metadatos. Consulta los precios del almacenamiento de metadatos de Dataplex Universal Catalog.

Siguientes pasos