Administra un glosario empresarial

El glosario empresarial de Dataplex Universal Catalog proporciona un solo lugar para administrar la terminología y las definiciones relacionadas con la empresa en toda tu organización.

Cuando diferentes equipos trabajan en un proyecto compartido o una empresa grande tiene muchos departamentos, es común que cada parte de la empresa cree su propia terminología para describir los diversos recursos de datos con los que trabaja. Esto puede generar una mala 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 empresarial de Dataplex Universal Catalog te permite crear un vocabulario centralizado y estandarizado para tus recursos de datos. Puedes usar un glosario de la empresa para hacer lo siguiente:

  • Definir una estructura jerárquica de categorías y conceptos comerciales, denominados 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 según conceptos comerciales.

Un glosario empresarial ayuda a optimizar el descubrimiento de datos y reducir la ambigüedad, lo que puede generar análisis más precisos, una mejor administració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 términos comerciales.

Glosario

Un glosario tiene las siguientes propiedades:

  • Descripción general. Describe el propósito y el contenido del glosario de términos comerciales. Puedes agregar imágenes, vínculos, 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 la búsqueda. El tamaño máximo admitido es de 1 KB.
  • Region. Especifica la región en la que se encuentra el glosario.

Categoría

Una categoría te permite organizar y estructurar varias categorías y términos. Las categorías se definen dentro de un glosario empresarial. Puedes anidar categorías hasta en tres niveles.

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

  • Contactos. Especifica la persona responsable de mantener la categoría. Esta propiedad es descriptiva y no afecta los permisos de la categoría.
  • Madre o padre Especifica una relación que se usa para establecer la categoría principal 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 del glosario") describe un concepto que se usa en una rama comercial específica dentro de tu empresa. Por ejemplo, el departamento de marketing de una empresa podría crear un término que describa el costo por clic. Los términos se definen en un glosario empresarial, 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 vínculos entre términos que tienen el mismo significado. Consulta Términos sinónimos.
  • Términos relacionados. Especifica vínculos entre términos que están relacionados conceptualmente entre sí, pero que tienen significados diferentes. Consulta Términos relacionados.
  • Entradas relacionadas Especifica vínculos entre términos y recursos de datos, o entre términos y columnas dentro de los 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 del glosario que lo contiene.

Términos sinónimos

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

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, puedes crear un término relacionado para vincular los términos "ingresos" y "ganancias".

Limitaciones

Roles obligatorios

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 tu proyecto:

  • Los administradores de datos obtienen acceso completo a los glosarios, las categorías, los términos, los sinónimos y los términos relacionados, y pueden establecer políticas de IAM: Administrador de Catálogo de Dataplex (roles/dataplex.catalogAdmin)
  • Para los administradores o propietarios de datos, obtén acceso para crear, editar o borrar glosarios, categorías, términos, vínculos entre términos, vínculos entre términos y recursos de datos, y realizar búsquedas: Editor de Dataplex Catalog (roles/dataplex.catalogEditor)
  • Para los analistas o consumidores de datos, obtén acceso de solo lectura a glosarios, categorías, términos, vínculos entre términos y entre términos y recursos de datos, y realiza búsquedas: Visualizador del catálogo de Dataplex (roles/dataplex.catalogViewer)

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:

  • Crea, lee, actualiza y borra un glosario empresarial, una categoría y términos en 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
  • Crea y borra vínculos de términos sinónimos en tu proyecto:
    • dataplex.entryLinks.create en el grupo de entradas de Dataplex Universal Catalog en el proyecto en el que se encuentra cualquiera de los términos del glosario. El vínculo se crea en el grupo de entradas para el que se otorga el permiso.
    • dataplex.entryGroups.useSynonymEntryLink en el grupo de entradas de Dataplex Universal Catalog en el proyecto en el que se encuentra cualquiera de los términos del glosario. El vínculo se crea en el grupo de entradas para el que se otorga el permiso.
    • dataplex.glossaryTerms.use en los glosarios cuyos términos deben asociarse.
    • dataplex.entryLinks.delete en el grupo de entradas de Dataplex Universal Catalog en el proyecto en el que se encuentra el vínculo.
  • Crea y borra vínculos de términos relacionados en tu proyecto:
    • dataplex.entryLinks.create en el grupo de entradas de Dataplex Universal Catalog en el proyecto en el que se encuentra cualquiera de los términos del glosario. El vínculo se crea en el grupo de entradas para el que se otorga el permiso.
    • dataplex.entryGroups.useRelatedEntryLink en el grupo de entradas de Dataplex Universal Catalog en el proyecto en el que se encuentra cualquiera de los términos del glosario. El vínculo se crea en el grupo de entradas para el que se otorga el permiso.
    • dataplex.entries.link en el grupo de entradas de Dataplex Universal Catalog en proyectos en los que hay entradas correspondientes a términos del glosario.
    • dataplex.entryLinks.delete en el grupo de entradas de Dataplex Universal Catalog en el proyecto en el que se encuentra el vínculo.
  • Crea vínculos entre los términos y los recursos de datos o las columnas de tu proyecto:
    • dataplex.entryLinks.create en el grupo de entrada del sistema correspondiente a los recursos de datos o las columnas del proyecto El vínculo se crea en el proyecto para el que se otorga el permiso.
    • dataplex.entryGroups.useDefinitionEntryLink en el grupo de entrada del sistema correspondiente a los recursos de datos o las columnas del proyecto El vínculo se crea en el proyecto para el que se otorga permiso.
    • dataplex.entries.link en el grupo de entrada del sistema correspondiente a los recursos de datos o las columnas del proyecto. El vínculo se crea en el proyecto para el que se otorga el permiso.
    • dataplex.glossaryTerms.use en el glosario cuyo término debe asociarse.
    • dataplex.entryLinks.delete en el grupo de entradas del sistema en el que se encuentra el vínculo.

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, editar y borrar un glosario de la empresa.

Crea un glosario empresarial

Console

  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 y una ubicación para el glosario empresarial. Después de crear el glosario, no puedes cambiar la ubicación.

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

  5. Opcional: Agrega una descripción breve en Descripción (hasta 1,024 caracteres) o una descripción larga en Descripción general (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

    Reemplaza lo siguiente:

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

  2. Opcional: Agrega 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

      Reemplaza PROJECT_NUMBER por el número del proyecto en el que se creó tu glosario.

    2. Sigue estos pasos para agregar 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

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

Consulta los glosarios disponibles

Console

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

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

Cómo editar un glosario

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

Console

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

  3. Haz clic en Editar junto al nombre, la descripción o el resumen, y, luego, realiza 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?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Borra un glosario

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

Console

  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 y, luego, confirma cuando se te solicite.

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

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

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

Console

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

    Ir a Glosarios

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

  3. Ingresa un nombre para la categoría.

  4. Haz clic en Crear.

  5. Opcional: Agrega una descripción breve en Descripción (hasta 1,024 caracteres) o una descripción larga en Descripción general (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

    Reemplaza lo siguiente:

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

  2. Opcional: Agrega 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. Agrega 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

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

  3. Opcional: Agrega 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

Cómo 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.

Console

  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.

  4. Ingresa un nombre para la categoría.

  5. Haz clic en Crear.

  6. Opcional: Agrega una descripción breve en Descripción (hasta 1,024 caracteres) o una descripción larga en Descripción general (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

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

Cómo ver las categorías que pertenecen a un glosario

Console

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

    Ir a Glosarios

  2. Para ver las categorías de un glosario, expándelo.

  3. Para ver las categorías anidadas en una categoría, expándela.

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.

Console

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

  3. Haz clic en Editar junto al nombre, la descripción o el resumen y, luego, realiza 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

Borrar una categoría

Console

  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 deseas borrar.

  3. Haz clic en Borrar y, luego, confirma cuando se te solicite.

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

Crea y administra condiciones

En las siguientes secciones, se describe cómo crear, ver, acceder, editar y borrar condiciones.

Crea un término en un glosario empresarial

Un glosario empresarial puede tener un máximo de 5,000 términos.

Console

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

    Ir a Glosarios

  2. Para crear un término a nivel del glosario, selecciona el glosario en el que deseas crear un término y, luego, haz clic en Crear término.

  3. Ingresa un nombre para el término.

  4. Haz clic en Crear.

  5. Opcional: Agrega una descripción breve en Descripción (hasta 1,024 caracteres) o una descripción larga en Descripción general (hasta 120 KB).

  6. Opcional: Para agregar contactos, haz clic en Editar y, luego, proporciona una lista de direcciones de correo electrónico para los administradores, los propietarios o los propietarios del dominio de los datos. Luego, 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

    Reemplaza lo siguiente:

    • TERM_ID: Es el ID del período que crearás.
    • TERM_DISPLAY_NAME: Es el nombre visible del término que crearás.
    • TERM_DESCRIPTION: Es la descripción del término que crearás.

  2. Opcional: Agrega una descripción general del 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. Sigue estos pasos para agregar una descripción general a tu 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

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

  3. Opcional: Agrega 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. Actualiza la entrada de tu término 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/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

Crea un término en una categoría

Console

  1. En la consola de Google Cloud , 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 deseas crear un término y, luego, haz clic en Agregar término.

  3. Ingresa un nombre para el término.

  4. Haz clic en Crear.

  5. Opcional: Agrega una descripción breve en Descripción (hasta 1,024 caracteres) o una descripción larga en Descripción general (hasta 120 KB).

  6. Opcional: Para agregar contactos, haz clic en Editar y, luego, proporciona una lista de direcciones de correo electrónico para los administradores, los propietarios o los propietarios del dominio de los datos. Luego, haz clic en Guardar.

REST

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

  1. Crea 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

    Reemplaza lo siguiente:

    • TERM_ID: Es el ID del período que crearás.
    • TERM_DISPLAY_NAME: Es el nombre visible del término que crearás.
    • TERM_DESCRIPTION: Es la descripción del término que crearás.

  2. Opcional: Agrega una descripción general del 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. Sigue estos pasos para agregar una descripción general a tu 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

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

  3. Opcional: Agrega 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. Actualiza la entrada de tu término 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/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

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

Console

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

    Ir a Glosarios

  2. Para ver los términos de un glosario, expándelo. Para ver los términos de una categoría dentro de este glosario, expándela. Para ver los términos dentro de una categoría anidada, expándela.

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

Cómo ver los detalles de un término

Console

  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 en un glosario, expándelo.

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

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

Cómo editar un término

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

Console

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

  3. Haz clic en Editar.

  4. Edita cualquiera de los campos 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

Cómo borrar un término

Console

  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 deseas borrar.

  3. Haz clic en Borrar y, luego, confirma cuando se te solicite.

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 agregar relaciones entre los términos vinculándolos como sinónimos o términos relacionados.

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

Console

  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 con el que deseas crear vínculos.

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

  4. Busca y, luego, selecciona los términos a los que deseas vincularte.

    El término se vinculará de inmediato cuando lo selecciones.

  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
)"

Reemplaza lo siguiente:

  • TERM1_PROJECT_NUMBER: Es el número del proyecto del primer período que se vincula.
  • TERM1_LOCATION_ID: Es el ID de ubicación del glosario que contiene el primer término.
  • TERM1_GLOSSARY_ID: Es el ID del glosario que contiene el primer término.
  • TERM1_ID: Es el ID del primer término.
  • TERM2_PROJECT_NUMBER: Es el número del proyecto del segundo término que deseas vincular como 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: Es el ID de ubicación del glosario que contiene el segundo término. Si ambos términos se encuentran en la misma ubicación, este valor es el mismo que el ID de ubicación del primer término.
  • TERM2_GLOSSARY_ID: Es el ID del 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: Es el ID del segundo término.
  • ENTRY_LINK_ID: Es un ID para la vinculación entre los dos términos. Cada término se representa como una entrada de Dataplex Universal Catalog. El vínculo de entrada es la relación entre los términos sinónimos.

Console

  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 con el que deseas crear vínculos.

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

  4. Busca y, luego, selecciona los términos a los que deseas vincularte.

    El término se vinculará de inmediato cuando lo selecciones.

  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
)"

Reemplaza lo siguiente:

  • TERM1_PROJECT_NUMBER: Es el número del proyecto del primer período que se vincula.
  • TERM1_LOCATION_ID: Es el ID de ubicación del glosario que contiene el primer término.
  • TERM1_GLOSSARY_ID: Es el ID del glosario que contiene el primer término.
  • TERM1_ID: Es el ID del primer término.
  • TERM2_PROJECT_NUMBER: Es el número del proyecto del segundo término al que deseas 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: Es el ID de ubicación del glosario que contiene el segundo término. Si ambos términos se encuentran en la misma ubicación, este valor es el mismo que el ID de ubicación del primer término.
  • TERM2_GLOSSARY_ID: Es el ID del 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: Es el ID del segundo término.
  • ENTRY_LINK_ID: Es un ID para la vinculación entre los dos términos. Cada término se representa como una entrada de Dataplex Universal Catalog. El vínculo de entrada es la relación entre los términos relacionados.

Console

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

  3. Para borrar vínculos entre términos relacionados, haz clic en Editar junto a Términos relacionados. Borra los términos relacionados y, luego, haz clic en Cerrar.

  4. Para borrar vínculos entre sinónimos, haz clic en Editar junto a Términos sinónimos. Borra los sinónimos y, luego, 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

Puedes adjuntar condiciones a los recursos de datos o a las columnas de recursos de datos. Por ejemplo, puedes adjuntar condiciones a un conjunto de datos de BigQuery.

Console

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

    Ir a Búsqueda

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

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

    • Para vincular términos a un activo, en la pestaña Detalles, en la sección Términos del glosario, haz clic en Agregar. Busca los términos y, luego, selecciónalos. Por último, haz clic en Cerrar.
    • Si el activo tiene un esquema, puedes vincular términos a una columna. En la pestaña Esquema, selecciona una columna para vincular términos y, luego, haz clic en Agregar término comercial. Busca los términos y, luego, selecciónalos. Por último, 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
)"

Reemplaza lo siguiente:

  • PROJECT_NUMBER: Es el número del proyecto del activo de datos al que se vincula.
  • ENTRY_LOCATION_ID: Es el ID de ubicación del activo de datos al que se vincula.
  • ENTRY_GROUP_ID: Es el grupo de entrada del recurso de datos al que se vincula.
  • ENTRY_LINK_ID: Es un ID para la vinculación entre el término y la entrada de Dataplex Universal Catalog que representa el recurso de datos.
  • TERM_PROJECT_NUMBER: Es el número del proyecto del término que se vincula.

Adjunta términos a una columna en un esquema de entrada

Console

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

    Ir a Búsqueda

  2. Busca el activo 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. Haz clic en el recurso de datos.

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

    • Para vincular términos a una columna del activo de datos, en la pestaña Esquema, selecciona las columnas a las que deseas adjuntar el término.
    • Haz clic en Agregar término comercial. Busca el término que deseas 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<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
)"

Reemplaza lo siguiente:

  • PROJECT_NUMBER: Es el número del proyecto del activo de datos al que se vincula.
  • ENTRY_LOCATION_ID: Es el ID de ubicación del activo de datos al que se vincula.
  • ENTRY_GROUP_ID: Es el grupo de entrada del recurso de datos al que se vincula.
  • ENTRY_LINK_ID: Es un ID para la vinculación entre el término y la entrada de Dataplex Universal Catalog que representa el activo de datos.
  • TERM_PROJECT_NUMBER: Es el número del proyecto del término que se vincula.
  • COLUMN_NAME: Es la columna a la que deseas adjuntar el término.

Console

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

    Ir a Búsqueda

  2. Busca el activo de datos (como un conjunto de datos, un archivo o una tabla) del que deseas quitar las condiciones y haz clic en él.

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

    • Para quitar un término de un recurso, en la pestaña Detalles, en la sección Términos del glosario, haz clic en el término. Luego, 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

Cómo encontrar glosarios, términos y recursos de datos vinculados

Console

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

  1. En la consola de Google Cloud , 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. Los siguientes filtros están disponibles:

    • Nombre: Muestra los glosarios, las categorías y los términos cuyo nombre contiene el texto que proporcionas.
    • Parent: Muestra los términos cuyo nombre o descripción del glosario principal coinciden con el texto que proporcionas. 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.
    • Synonym: Muestra la lista de términos con un sinónimo cuyo nombre o ID contiene el texto que proporcionas. 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 administrador de datos aparece como contacto. Por ejemplo, contact:alex@example.com devuelve las entradas que están conectadas a términos con un administrador de datos que coincide con alex@example.com.

REST

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

Buscar recursos de datos vinculados a términos

Console

  1. En la consola de Google Cloud , 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 ingresar una consulta de búsqueda de texto de formato libre. Esto devuelve una lista de coincidencias correspondientes en los nombres del glosario, la categoría y el 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 (activos de datos) a este término.

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

REST

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

Para importar glosarios y vínculos desde otra herramienta de catalogación o actualizar tus glosarios en Dataplex Universal Catalog, puedes importar de forma masiva glosarios, categorías, términos, vínculos entre términos, vínculos entre términos y recursos de datos, o columnas, con la API de 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
)"

    Reemplaza lo siguiente:

    • PROJECT_ID: ID del proyecto en el que crearás el glosario
    • LOCATION_ID: Es la ubicación en la que queremos crear el glosario.
    • GLOSSARY_ID: El ID del glosario
    • DISPLAY_NAME: Es el nombre visible del glosario.
    • DESCRIPTION: La descripción del glosario

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

    • Formato de ejemplo para los términos y las 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 para vínculos 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 muestra para vínculos 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
)"

    Reemplaza DATAPLEX_API por el extremo de la API de 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

    Reemplaza 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 vínculos 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 vínculos entre términos y recursos o columnas de datos

    Para crear un vínculo entre los términos del glosario y los recursos de datos, ejecuta el trabajo de importación para cada grupo de entradas al que pertenece la entrada del recurso de datos. Todos los vínculos de entrada 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 de 2026, el glosario empresarial de Dataplex Universal Catalog se facturará de la misma manera que los precios de almacenamiento de metadatos. Consulta los precios de almacenamiento de metadatos de Dataplex Universal Catalog.

¿Qué sigue?