Los metadatos son fundamentales para organizar y comprender tus recursos de datos y las relaciones entre ellos. Por ejemplo, las industrias reguladas deben proteger la información de identificación personal (PII), como nombres, direcciones y números de identificación emitidos por el Gobierno. Estos datos pueden aparecer en numerosas instancias en los sistemas de datos distribuidos. Knowledge Catalog (antes conocido como Dataplex Universal Catalog) te ayuda a descubrir y catalogar rápidamente tus recursos de datos distribuidos. Luego, puedes clasificar los datos como PII.
Si enriqueces las entradas de datos y los vínculos de entrada con contexto significativo, puedes hacer que tus datos sean más fáciles de descubrir y más útiles. Knowledge Catalog proporciona contexto a través de lo siguiente:
- Tipo de aspecto: Es una plantilla JSON que define datos relacionados. Por ejemplo, para la información de cumplimiento, podrías tener la clasificación de PII y el cumplimiento del RGPD.
- Aspecto: Es una instancia de un tipo de aspecto. Por ejemplo, {"pii_classification": "confidential", "gdpr_compliant": true}. Puedes aplicar un aspecto a una tabla completa, a una columna de tabla individual o a un vínculo de entrada (con restricciones).
Una vez que hayas clasificado los datos, podrás aplicarles políticas de calidad de los datos o acceso.
Para obtener más información, consulta Acerca de la administración de metadatos en Knowledge Catalog.
Aspectos
Los aspectos te permiten capturar metadatos en entradas o vínculos de entrada para proporcionar contexto significativo. Puedes usar aspectos para almacenar lo siguiente:
Metadatos empresariales: Es la información que proporciona contexto empresarial, como la clasificación de datos.
Metadatos técnicos: Detalles técnicos de las entradas o los vínculos de entrada, incluidos los siguientes:
- Para las entradas: detalles sobre el activo de datos en sí, por ejemplo, su esquema
- Para los vínculos de entrada: detalles sobre la relación entre los activos de datos, por ejemplo, detalles de la unión
Metadatos derivados de los datos: Es la información que se genera a partir de los datos en sí, como las estadísticas de una tabla de BigQuery.
Se considera que los aspectos son partes del recurso de entrada y no recursos separados. Cuando modificas un aspecto, se modifica la entrada que lo contiene. Puedes usar los feeds de cambios de metadatos para recibir notificaciones cuando se modifiquen aspectos.
En el caso de las entradas, puedes especificar aspectos a nivel de la entrada para describir una entrada o a nivel de la columna para describir una columna en una entrada. En el caso de los vínculos de entrada, agregas aspectos al vínculo en sí.
Cada aspecto es una instancia de un tipo de aspecto. Un tipo de aspecto define una plantilla para sus aspectos. Cada tipo de aspecto contiene un conjunto de campos. Cuando creas aspectos, debes proporcionar valores para esos campos.
Para una entrada o un vínculo de entrada determinados, puede haber como máximo un aspecto asociado por tipo de aspecto. En el caso de las entradas, puedes tener varios aspectos asociados con las columnas de entrada por tipo de aspecto.
Categorías de aspectos
Los aspectos se clasifican de la siguiente manera:
Aspectos obligatorios: Son los aspectos que son obligatorios al crear una entrada o un vínculo de entrada. Estos aspectos se definen según el tipo de entrada o el tipo de vínculo de entrada. Todos los recursos que pertenecen a un tipo específico siempre deben tener todos los aspectos obligatorios que se definen según ese tipo.
Knowledge Catalog administra los aspectos requeridos (por ejemplo, el esquema) para las entradas del sistema.
Ten en cuenta lo siguiente:
Solo puedes asociar aspectos obligatorios con las entradas y no con sus columnas.
No puedes borrar los aspectos obligatorios de una entrada o un vínculo de entrada.
Puedes leer los aspectos requeridos de las entradas del sistema, pero no puedes modificarlos.
Los aspectos de datos no pueden ser aspectos obligatorios.
Aspectos opcionales: Puedes asociar aspectos opcionales con entradas o con columnas de entrada. Puedes completar los aspectos opcionales en el momento de la creación de la entrada o más adelante actualizándola.
Ten en cuenta lo siguiente:
Puedes borrar los aspectos opcionales después de que se completen.
Los vínculos de entrada solo admiten los aspectos obligatorios.
Aspectos de datos
Algunos aspectos contienen información derivada de los datos subyacentes de una entrada, en lugar de metadatos sobre la entrada. Estos se conocen como aspectos de los datos. Por ejemplo, los resultados de un análisis de perfil de datos o de calidad de los datos contienen estadísticas derivadas de los datos mismos y, por lo tanto, se clasifican como aspectos de los datos.
Los tipos de aspectos del sistema que son aspectos de datos incluyen los siguientes:
data-profile: Contiene los resultados de un análisis del perfil de datos. Para obtener más información, consulta Acerca de la generación de perfiles de datos.data-quality-scorecard: Contiene un resumen de las puntuaciones de calidad de los datos.data-rules: Adjunta reglas de calidad de los datos a una entrada.data-quality-rule-template: Define una plantilla de regla de calidad de los datos reutilizable.
Tipos de aspecto
Los tipos de aspecto son recursos reutilizables que proporcionan plantillas para aspectos.
Categorías de tipos de aspectos
Los tipos de aspectos se clasifican en tipos de aspectos personalizados y del sistema.
Tipos de aspectos personalizados
Los tipos de aspectos que creas en Knowledge Catalog se denominan tipos de aspectos personalizados.
Los tipos de aspectos personalizados pueden ser globales o regionales. Puedes crear tipos de aspectos personalizados en una ubicación regional específica (por ejemplo, us-central1) o como un recurso global. La ubicación de un tipo de aspecto afecta el alcance de su aplicabilidad y determina con qué entradas se puede usar:
- Tipos de aspectos globales: Se pueden usar para crear aspectos para las entradas en cualquier región. Elige un tipo de aspecto
globalsi necesitas aplicar la misma estructura a las entradas en varias regiones, ya que solo necesitas definirlo una vez. Debido a que la definición de un tipo de aspecto global se replica en todas las regiones, es posible que esta opción no sea adecuada si el esquema del tipo de aspecto en sí contiene información sensible o si se requiere una residencia de datos estricta para todos los componentes de metadatos. - Tipos de aspectos regionales: Solo se pueden usar para crear aspectos para las entradas que residen en la misma región que el tipo de aspecto. Por ejemplo, un tipo de aspecto creado en
us-central1solo se puede usar con entradas enus-central1. Elige una ubicación regional si un tipo de aspecto solo es relevante para las entradas de una región específica o para garantizar que la definición del tipo de aspecto resida dentro de la región seleccionada, lo que puede ayudar a cumplir con los requisitos de soberanía y cumplimiento de datos. Si usas tipos de aspectos regionales, pero necesitas la misma estructura en varias regiones, debes crear y administrar definiciones de tipos de aspectos separadas en cada región.
Para obtener más información, consulta Restricciones de ubicación y proyecto.
Tipos de aspectos del sistema
Los tipos de aspectos que Knowledge Catalog proporciona, usa y administra se denominan tipos de aspectos del sistema. Los tipos de aspectos del sistema siempre son globales, por lo que se pueden usar en cualquier región. Los tipos de aspectos del sistema se almacenan en un proyecto administrado por Google con el número de proyecto 655216118709. Por ejemplo,
projects/655216118709/locations/global/aspectTypes/schema.
Cada tipo de aspecto, tipo de entrada y tipo de vínculo de entrada definidos por el sistema tiene sus propios permisos de IAM. Para obtener más información, consulta Permisos de IAM para tipos de aspectos del sistema, tipos de entrada y tipos de vínculos de entrada.
Los tipos de aspectos del sistema se clasifican en reutilizables y restringidos. En la siguiente tabla, se describen las categorías de tipos de aspectos del sistema y la lista de tipos de aspectos que proporciona Knowledge Catalog para cada una de las categorías:
| Categoría del tipo de aspecto del sistema | Descripción | Tipos de aspectos que proporciona Knowledge Catalog |
|---|---|---|
| Tipo de aspecto del sistema reutilizable | Puedes usar estos tipos de aspectos para crear o modificar aspectos. |
|
| Tipo de aspecto del sistema restringido | Knowledge Catalog administra estos tipos de aspectos. Puedes leer aspectos en estos tipos de aspectos, pero no puedes crear ni editar aspectos en estos tipos de aspectos. |
Incluidos, sin limitaciones, los siguientes:
|
Antes de comenzar
Antes de crear y administrar tipos y aspectos, completa las tareas que se describen en esta sección.
Roles obligatorios
Para obtener los permisos que necesitas para crear y administrar tipos y aspectos de aspectos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el recurso:
-
Conjunto completo de permisos sobre los recursos de metadatos en Knowledge Catalog, incluidos los tipos de aspectos y los aspectos de datos:
Administrador de Dataplex Catalog (
roles/dataplex.catalogAdmin) -
Crea y administra recursos de metadatos en Knowledge Catalog, incluidos los tipos de aspectos y los aspectos de datos:
Editor del catálogo de Dataplex (
roles/dataplex.catalogEditor) -
Conjunto completo de permisos sobre tipos de aspectos personalizados (excepto los permisos para usar tipos de aspectos para crear o editar entradas):
Propietario de Tipos de aspecto de Dataplex (
roles/dataplex.aspectTypeOwner) -
Ver los tipos de aspectos y las políticas de IAM asociadas a ellos: Visualizador del catálogo de Dataplex (
roles/dataplex.catalogViewer) -
Usar tipos de aspectos para crear y modificar entradas con los aspectos correspondientes:
Usuario de tipo de aspecto de Dataplex (
roles/dataplex.aspectTypeUser) -
Agrega aspectos de algunos de los tipos de aspectos del sistema, como
schema,schema-join,overviewycontacts: Propietario de entrada y EntryLink de Dataplex (roles/dataplex.entryOwner)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Para obtener más información, consulta Roles de IAM de Knowledge Catalog.
Habilita la API
Habilita la API de Dataplex en tu proyecto de Knowledge Catalog. Si usas un proyecto Google Cloud nuevo o un proyecto en el que la API de BigQuery está habilitada, la API de Dataplex se habilita de forma predeterminada.
Crea un tipo de aspecto personalizado
Console
En la consola de Google Cloud , ve a la página Tipos de metadatos de Knowledge Catalog.
Haz clic en la pestaña Tipos de aspecto y plantillas de etiquetas > Personalizado.
Haz clic en Crear tipo de aspecto.
En la ventana Crear tipo de aspecto, ingresa lo siguiente:
- Opcional: En el campo Nombre visible, ingresa un nombre para el tipo de aspecto.
- En el campo ID de tipo de aspecto, ingresa un ID único para el tipo de aspecto.
- Opcional: En el campo Descripción, ingresa una descripción para el tipo de aspecto.
- En el campo Ubicación, selecciona una ubicación para el tipo de aspecto. No puedes modificar la ubicación de un tipo de aspecto después de crearlo. Para comprender el impacto de elegir una ubicación global en comparación con una regional, consulta la sección Tipos de aspectos personalizados.
Opcional: Define una plantilla para tu tipo de aspecto.
En la sección Plantilla, haz clic en Agregar campo. En la sección Campo nuevo, ingresa lo siguiente:
- En el campo Nombre, ingresa un nombre.
- Opcional: En el campo Nombre visible, ingresa un nombre visible.
- Opcional: en el campo Descripción, ingresa una descripción.
En el campo Tipo, selecciona un tipo de datos para el campo. Según tu selección, se mostrará el siguiente conjunto de campos y opciones:
Si seleccionaste Texto como el tipo de datos, sigue estos pasos:
- En el campo Tipo de texto, selecciona el tipo de texto.
- En el campo Valores de texto, proporciona una sugerencia para el campo de texto. Para ello, haz clic en Agregar valor y, luego, ingresa la sugerencia. Puedes agregar varias sugerencias para un campo de texto.
- Haz clic en Listo.
Si seleccionaste Enum como el tipo de datos, agrega un valor de enumeración:
- Haz clic en Agrega un valor de enum.
- En el campo Valor, ingresa un valor de enumeración. Puedes agregar varios valores de enumeración.
- Haz clic en Listo.
Si seleccionaste Array como el tipo de datos, en la sección Elemento del array, define los tipos de elementos que estarán presentes en el array:
- Haz clic en Agregar elemento de array.
- En el campo Nombre, ingresa un nombre para los elementos del array.
- Opcional: En el campo Nombre visible, ingresa un nombre visible para los elementos del array.
- Opcional: En el campo Descripción, ingresa una descripción para los elementos del array.
En el campo Tipo, selecciona un tipo de datos para los elementos del array.
Según tu selección, se mostrará el siguiente conjunto de campos y opciones. Son similares a las opciones que se describen para los tipos de datos Text, Enum, Map, Array y Record en otras partes de esta sección.
Haz clic en Listo.
Si seleccionaste Mapa como el tipo de datos, en la sección Valor del mapa, define los tipos de valores que estarán presentes en el mapa:
- Haz clic en Agregar valor de mapa.
- En el campo Nombre, ingresa un nombre para el mapa.
- Opcional: En el campo Nombre visible, ingresa un nombre visible para el mapa.
- Opcional: En el campo Descripción, ingresa una descripción para el mapa.
En el campo Tipo, selecciona un tipo de datos para el mapa.
Según tu selección, se mostrará el siguiente conjunto de campos y opciones. Son similares a las opciones que se describen para los tipos de datos Text, Enum, Map, Array y Record en otras partes de esta sección.
Haz clic en Listo.
Si seleccionaste Registro como el tipo de datos, ingresa lo siguiente:
- En el campo ID de registro, ingresa un ID único que otros campos de registro puedan usar para hacer referencia a este registro. Consulta la sección Ejemplo para usar los campos ID de registro y Referencia de registro de este documento.
- Opcional: Si deseas agregar una referencia a otro registro desde esta plantilla, usa el campo Referencia de registro. No puedes modificarlo después de crear el tipo de aspecto. Consulta la sección Ejemplo para usar los campos ID de registro y Referencia de registro de este documento.
En la sección Campos de registro, puedes definir un objeto complejo con varios campos anidados. Para ello, haz clic en Agregar elemento de campo de registro y especifica lo siguiente:
En el campo Nombre, ingresa un nombre para el campo del registro.
Opcional: En el campo Nombre visible, ingresa un nombre visible para el campo de registro.
Opcional: En el campo Descripción, ingresa una descripción para el campo del registro.
En el campo Tipo, selecciona un tipo de datos.
Según tu selección, se mostrará el siguiente conjunto de campos y opciones. Son similares a las opciones descritas para los tipos de datos Text, Enum, Map, Array y Record que se mencionaron anteriormente en esta sección.
Haz clic en Listo.
Para que el campo sea obligatorio para un aspecto de este tipo, selecciona Es obligatorio. Para obtener más información sobre los aspectos obligatorios y opcionales, consulta la sección categorías de aspectos de este documento.
Haz clic en Listo.
Para agregar varios campos, haz clic en Agregar campo y repite los pasos anteriores.
Opcional: En la sección Etiquetas, agrega etiquetas arbitrarias como pares clave-valor a tus recursos:
- Haz clic en Agregar etiqueta.
- En el campo Clave, ingresa una clave.
- En el campo Valor, ingresa un valor para la clave.
- Para agregar más etiquetas, haz clic en Agregar etiqueta y repite los pasos.
Haz clic en Guardar.
gcloud
Para crear un tipo de aspecto personalizado, usa el comando gcloud dataplex aspect-types
create.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para crear un tipo de aspecto personalizado, usa el método aspectType.create.
Después de crear un tipo de aspecto personalizado, puedes agregar aspectos a las entradas.
Ejemplo de uso de los campos ID de registro y Referencia de registro
Puedes usar los campos ID de registro y Referencia de registro para referencias recursivas. En el siguiente ejemplo, se muestra cómo usar estos campos:
Considera un tipo de aspecto llamado Employee, con los siguientes campos:
- Nombre (tipo:
Text) - Fecha de inicio (tipo:
Date & time) - Designation (tipo:
Text) - Dirección actual (tipo:
Record) - Dirección permanente (tipo:
Record)
Los dos campos de dirección Dirección actual y Dirección permanente son del mismo tipo de datos Record. Para evitar la duplicación, puedes establecer los valores de ID de registro y Referencia de registro cuando definas estos campos.
Cuando defines el campo Dirección actual, puedes especificar ID de registro como address-field. En Dirección permanente, puedes especificar el mismo valor (address-field) para Referencia del registro. Por ejemplo:
- Nombre (tipo:
Text) - Fecha de inicio (tipo:
Date & time) - Designation (tipo:
Text) - Dirección actual (tipo:
Record, ID de registro:address-field) - Dirección permanente (tipo:
Record, referencia del registro:address-field)
De esta manera, no es necesario que dupliques los campos de otra dirección.
Agrega aspectos a una entrada
Después de crear un tipo de aspecto personalizado, puedes crear aspectos de ese tipo. Para agregar aspectos a una entrada, debes actualizarla, ya que los aspectos se almacenan dentro de las entradas.
Ten en cuenta lo siguiente:
- Puedes agregar aspectos a una entrada o a las columnas de una entrada.
- Solo puedes editar los aspectos requeridos para las entradas personalizadas. No puedes borrar los aspectos obligatorios.
- Puedes editar y borrar los aspectos opcionales de las entradas personalizadas y del sistema.
Console
En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.
Si tu plataforma de búsqueda está configurada como Data Catalog, en el menú Elige una plataforma de búsqueda, selecciona Dataplex Universal Catalog.
Busca la entrada a la que deseas agregar aspectos y haz clic en ella. Se abrirá la página de detalles de la entrada.
Para agregar aspectos a la entrada, sigue estos pasos:
- Haz clic en la pestaña Detalles.
- Para agregar aspectos obligatorios u opcionales a la entrada, en la sección Aspectos y etiquetas, haz clic en Agregar para la categoría correspondiente.
No puedes agregar aspectos obligatorios si el tipo de entrada de la entrada seleccionada no tiene aspectos obligatorios definidos. - Busca y selecciona el aspecto que quieras agregar.
- En la ventana Agregar aspecto, ingresa los valores de los campos.
Haz clic en Guardar.
Para agregar aspectos a una columna de la entrada, sigue estos pasos:
En la página de detalles de la entrada, haz clic en la pestaña Esquema.
Selecciona las columnas a las que deseas agregar aspectos.
Haz clic en Agregar aspecto.
Busca y selecciona el aspecto que quieras agregar.
En la ventana Agregar aspecto, ingresa los valores de los campos.
Haz clic en Guardar.
gcloud
Para agregar aspectos a una entrada o a una columna de una entrada, usa el comando gcloud
dataplex entries update.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Para agregar aspectos al objeto de entrada, consulta Aspectos.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Para agregar aspectos al objeto de entrada, consulta Entry.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Para agregar aspectos al objeto de entrada, consulta #required_aspects=.
REST
Para agregar aspectos a una entrada o a una columna de una entrada, usa el método entry.patch.
No se admite la creación ni el uso de aspectos en una entrada en la que el tipo de aspecto respectivo y la entrada se encuentran en diferentes organizaciones de Google Cloud .
Cómo adjuntar aspectos de tipos de aspectos del sistema reutilizables
Puedes adjuntar aspectos de tipos de aspectos del sistema reutilizables a las entradas.
Puedes editar un aspecto de un tipo de aspecto reutilizable en la consola de Google Cloud según su estructura. Los tipos de aspectos que contienen campos anidados no se pueden editar en la consola de Google Cloud . Debes usar la herramienta de línea de comandos de gcloud o la API de REST para adjuntar o actualizar aspectos de este tipo.
Cuadro de evaluación de la calidad de los datos
Un cuadro de evaluación de la calidad de los datos es un aspecto que proporciona un resumen de la calidad de los datos, a menudo basado en análisis de la calidad de los datos o en otros procesos. Puedes adjuntar un cuadro de evaluación de calidad de los datos a una entrada para proporcionar información personalizada sobre la calidad de los datos. Para ello, adjunta un aspecto del tipo definido por el sistema data-quality-scorecard.
El campo data dentro del aspecto data-quality-scorecard puede incluir los siguientes campos:
job: Opcional Es un registro que contiene detalles sobre el trabajo que generó el cuadro de evaluación.name: Es el nombre del recurso del trabajo de calidad de los datos.runTime: Es el tiempo de ejecución del trabajo de calidad de los datos.
score: Opcional Es la puntuación general de calidad de los datos. La puntuación varía entre [0, 100].status: Obligatorio. Es el estado del cuadro de evaluación de la calidad de los datos, que indica si superó o no el umbral de calidad (PASSoFAIL).dimensions: Opcional Es un array de resultados de dimensiones. Cada resultado incluye lo siguiente:name: Es el nombre de la dimensión. Puede ser uno de los siguientes:ACCURACY,COMPLETENESS,CONSISTENCY,FRESHNESS,UNIQUENESS,VALIDITYoVOLUME, o bien un nombre de dimensión personalizada. Los nombres de las dimensiones personalizadas deben usar letras mayúsculas y tener 30 caracteres o menos.score: Es la puntuación general a nivel de la dimensión, que va de [0, 100].status: Es el estado de la dimensión, que indica si superó o no el umbral de calidad (PASSoFAIL).
columns: Opcional Es un array de resultados de columnas. Cada resultado incluye lo siguiente:name: El nombre de la columna.score: Es la puntuación general a nivel de la columna, que varía de [0, 100].status: Es el estado de la columna, que indica si superó o no el umbral de calidad (PASSoFAIL).dimensions: Es un array de puntuaciones de dimensión para la columna. Cada puntuación de dimensión incluye lo siguiente:name: Es el nombre de la dimensión.score: Es la puntuación de la dimensión, que va de [0, 100].status: Es el estado de la dimensión para la columna, que indica si superó o no el umbral de calidad (PASSoFAIL).
Cuando ejecutas el comando para adjuntar un aspecto, se reemplazan los datos existentes de ese aspecto específico. Por ejemplo, si actualizas un cuadro de evaluación que tiene una puntuación de 80 con un archivo nuevo que muestra una puntuación de 90, se reemplaza el valor 80. No combina los datos.
Para adjuntar un cuadro de evaluación de la calidad de los datos, sigue estos pasos:
gcloud
Para actualizar los aspectos de una entrada, usa el comando gcloud dataplex entries
update-aspects.
Crea un archivo JSON (
dq-aspect.json) con el siguiente contenido.{ "dataplex-types.global.data-quality-scorecard": { "data": { "score": 0.8, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 0.9, "status": "PASS" }, { "name": "uniqueness", "score": 0.7, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 0.85, "status": "PASS" } ] } } } }Ejecuta el comando siguiente:
gcloud dataplex entries update-aspects ENTRY_ID --location=LOCATION --entry-group=ENTRY_GROUP_ID --project=PROJECT_ID --aspects=dq-aspect.json
Reemplaza las siguientes variables:
ENTRY_ID: Es el ID de la entrada, por ejemplo,example-entry.LOCATION: Es la ubicación de la entrada, por ejemplo,us-central1.ENTRY_GROUP_ID: Es el ID del grupo de entradas, por ejemplo,example-entry-group.PROJECT_ID: Es el ID del proyecto, por ejemplo,example-project.
REST
Para actualizar los aspectos de una entrada, usa el método entry.patch.
Crea un archivo llamado
payload.jsony pega el contenido JSON de tu solicitud en él.{ "aspects": { "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } } }Ejecuta este comando en tu terminal:
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d @payload.json \ "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto, por ejemplo,example-project.LOCATION: Es la ubicación de la entrada, por ejemplo,us-central1.ENTRY_GROUP_ID: Es el ID del grupo de entradas, por ejemplo,example-entry-group.ENTRY_ID: El ID de la entrada, por ejemplo,example-entry
Otros tipos de aspectos reutilizables
También se pueden usar los siguientes tipos de aspectos del sistema. Puedes adjuntarlos con los mismos métodos de la API de REST o gcloud que se muestran para el cuadro de evaluación de la calidad de los datos. En el caso de los tipos de aspectos sin campos anidados, por ejemplo, generic, puedes usar la consola.
Contacts: Usa el tipo de aspecto
contactspara asignar la propiedad o la administración. Los campos incluyen lo siguiente:identities(matriz): Es una lista de contactos. Cada contacto incluye lo siguiente:role(cadena): Es el rol del contacto (por ejemplo,owner,steward,produceroadmin).name(cadena): Es el nombre del contacto.id(cadena): Es la dirección de correo electrónico o el ID del contacto.
Crea el archivo
payload.jsonde la siguiente manera:{ "aspects": { "dataplex-types.global.contacts": { "data": { "identities": [ { "role": "steward", "name": "Jane Doe", "id": "jane.doe@example.com" } ] } } } }Perfil de datos: Usa el tipo de aspecto
data-profilepara capturar los resultados de la generación de perfiles de datos. Para obtener más información, consulta Acerca de la generación de perfiles de datos.Los campos incluyen lo siguiente:
sourceDataInfo(registro): Es la información sobre los datos de origen que se analizaron para generar el perfil.scope(enum): Es el alcance del perfil (PREVIEW,SAMPLEDoALL). El valorPREVIEWcorresponde a los resultados de un análisis de perfilado ligero.scannedRows(int): Es la cantidad de filas analizadas.samplingPercentage(double): Es el porcentaje de muestreo utilizado.
fields(map): Es un mapa de los nombres de las columnas y sus perfiles de datos, incluidas métricas como los valores deuniqueness,nullnessytopN, y estadísticas específicas del tipo para las columnasnumeric,string,datetimeyarray.
Crea el archivo
payload.jsonde la siguiente manera:{ "aspects": { "dataplex-types.global.data-profile": { "data": { "sourceDataInfo": { "scope": "ALL", "scannedRows": 100 }, "fields": { "col1": { "nullness": 0.0, "uniqueness": 0.1, "string": { "length": { "min": 1, "max": 20, "avg": 12.54 } } } } } } }}Perfil de gráfico: El tipo de aspecto
graph-profile(dataplex-types.global.graph-profile) es un aspecto del sistema generado por IA que captura estructuras semánticas inferidas (nodos, bordes y campos) que resultan de las estadísticas de datos no estructurados. Si bien Knowledge Catalog adjunta este aspecto automáticamente durante la ejecución del análisis, puedes actualizar o definir mejor de forma manual las estadísticas inferidas con la API de REST. Para obtener instrucciones detalladas y ejemplos de cargas útiles, consulta Actualiza las estadísticas inferidas.Genérico: Usa el tipo de aspecto
genericpara la información de entrada genérica. Los campos incluyen lo siguiente:type(cadena): Es un campo de formato libre para almacenar un tipo especificado por el usuario.system(cadena): Es el sistema de la entrada personalizada.
Crea el archivo
payload.jsonde la siguiente manera:{ "aspects": { "dataplex-types.global.generic": { "data": { "type": "custom-type", "system": "custom-system" } } } }Descripción general Usa el tipo de aspecto
overviewpara proporcionar una descripción de texto enriquecido. Los campos incluyen lo siguiente:content(cadena): Es el resumen de la entrada, que admite el formato HTML.links(array): Es una lista de vínculos del sistema fuente. Cada vínculo incluye lo siguiente:url(cadena): URL del vínculo.title(cadena): Es el título del vínculo.
Crea el archivo
payload.jsonde la siguiente manera:{ "aspects": { "dataplex-types.global.overview": { "data": { "content": "This is a <b>rich text</b> description.", "links": [ { "url": "https://example.com", "title": "Example Link" } ] } } }}Esquema: Usa el tipo de aspecto
schemapara describir la estructura de los datos.fields(array): Es una lista de campos del esquema. Los campos incluyen lo siguiente:name(cadena): Es el nombre del campo.dataType(cadena): Es el tipo de datos del campo.metadataType(enum): Es el tipo de metadatos (por ejemplo,STRING,BOOLEAN).mode(enum): Es el modo del campo (NULLABLE,REQUIRED,REPEATED).description(cadena): Es una descripción del campo.
Crea el archivo
payload.jsonde la siguiente manera:{ "aspects": { "dataplex-types.global.schema": { "data": { "fields": [ { "name": "id", "dataType": "string", "metadataType": "STRING", "mode": "REQUIRED" } ] } } }}Uso: Usa el tipo de aspecto
usagepara hacer un seguimiento de las métricas de uso. Los campos incluyen lo siguiente:metrics(matriz): Es una lista de métricas de uso. Cada métrica incluye lo siguiente:name(cadena): Es el nombre de la métrica (por ejemplo,views,reads).timeSeries(array): Es una lista de datos de series temporales. Cada elemento incluye lo siguiente:interval(cadena): Es el intervalo de agregación (por ejemplo,30d).value(número entero): Es el valor agregado.
refreshTime(fecha y hora): Es la fecha y hora en la que se actualizaron las métricas por última vez.
Crea el archivo
payload.jsonde la siguiente manera:{ "aspects": { "dataplex-types.global.usage": { "data": { "metrics": [ { "name": "views", "timeSeries": [ { "interval": "30d", "value": 100 } ] } ], "refreshTime": "2025-01-01T12:00:00Z" } } }}
Agrega aspectos a un vínculo de entrada
Para enriquecer los metadatos con información sobre las relaciones entre las entradas, agrega aspectos a los vínculos de entrada.
Puedes configurar los tipos de vínculos de entrada para que requieran un aspecto específico. Cuando creas un vínculo de entrada de ese tipo, debes proporcionar el aspecto requerido.
Crea aspectos para los vínculos de entrada
Los aspectos de los vínculos de entrada se administran como parte del recurso EntryLink.
Ten en cuenta las siguientes limitaciones para usar aspectos con vínculos de entrada:
- No se admiten los aspectos opcionales.
- No se admiten los aspectos de datos.
- No se admiten aspectos de tipos personalizados.
- Solo puedes administrar los aspectos obligatorios definidos por los tipos de aspectos del sistema, por ejemplo,
schema-join. - No se admite la búsqueda de vínculos de entrada según el contenido de sus aspectos.
No se admite la importación ni la exportación de aspectos de vínculos de entrada.
REST
Para crear un vínculo de entrada con el aspecto requerido, usa el método entryLinks.create, que incluye los datos del aspecto en el cuerpo de la solicitud.
Administra los aspectos existentes de una entrada
En esta sección, se describe cómo actualizar y borrar los aspectos existentes de una entrada.
Actualiza un aspecto
Puedes editar los aspectos opcionales tanto de las entradas personalizadas como de las entradas del sistema. Solo puedes editar los aspectos obligatorios de las entradas personalizadas.
En el caso de las entradas del sistema propias (1P), como las tablas de BigQuery, puedes actualizar aspectos con la API de modifyEntry. Esto te permite usar los permisos de actualización de metadatos del sistema fuente (por ejemplo, editor de datos de BigQuery).
Console
En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.
Si tu plataforma de búsqueda está configurada como Data Catalog, en el menú Elige una plataforma de búsqueda, selecciona Dataplex Universal Catalog.
Busca la entrada cuyos aspectos deseas actualizar y haz clic en ella.
Se abrirá la página de detalles de la entrada.
- Haz clic en la pestaña Detalles.
- En la sección Aspectos y etiquetas, expande el aspecto o la etiqueta que deseas actualizar y haz clic en Editar.
- En la ventana Editar aspecto, actualiza los campos obligatorios.
- Haz clic en Guardar.
gcloud
Para actualizar aspectos de una entrada o una columna de una entrada, usa el comando gcloud
dataplex entries update.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para actualizar aspectos de una entrada o una columna de una entrada, usa el método entry.patch.
Borra un aspecto
Console
En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.
Si tu plataforma de búsqueda está configurada como Data Catalog, en el menú Elige una plataforma de búsqueda, selecciona Dataplex Universal Catalog.
Busca la entrada cuyos aspectos deseas borrar y haz clic en ella.
Se abrirá la página de detalles de la entrada.
- Haz clic en la pestaña Detalles.
- En la sección Aspectos y etiquetas, expande el aspecto o la etiqueta que deseas borrar y haz clic en Borrar.
- Haz clic en Confirmar.
gcloud
Para borrar un aspecto de una entrada, usa el comando gcloud dataplex entries update.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para borrar un aspecto de una entrada, usa el método entry.patch.
Administra los aspectos existentes de un vínculo de entrada
En esta sección, se describe cómo actualizar los aspectos existentes de un vínculo de entrada.
Actualiza un aspecto
En el caso de los vínculos de entrada, solo puedes actualizar los aspectos obligatorios que usan tipos de aspectos reutilizables del sistema.
Para obtener más información, consulta Permisos de IAM para operaciones de vínculos de entrada.
REST
Para actualizar un vínculo de entrada con el aspecto requerido, usa el método entryLinks.patch, que incluye los datos del aspecto en el cuerpo de la solicitud.
Borra un aspecto
No puedes borrar el aspecto obligatorio de un vínculo de entrada.
Administra tipos de aspectos
En esta sección, se describe cómo ver los tipos de aspectos, y actualizar y borrar los tipos de aspectos personalizados.
Consulta la lista de tipos de aspectos y plantillas de etiquetas disponibles
Console
En la consola de Google Cloud , ve a la página Tipos de metadatos de Knowledge Catalog.
Haz clic en la pestaña Tipos de aspecto y plantillas de etiquetas.
En esta página, se enumeran todos los tipos de aspectos de Knowledge Catalog y las plantillas de etiquetas de Data Catalog disponibles.
- Para ver los tipos de aspectos y las plantillas de etiquetas personalizados, haz clic en la pestaña Personalizado. En esta pestaña, la columna Fuente del catálogo muestra dónde reside el recurso: Knowledge Catalog o Data Catalog.
Para ver los tipos de aspectos del sistema, haz clic en la pestaña Sistema.
Para obtener más información sobre los tipos de aspectos personalizados y del sistema, consulta la sección categorías de tipos de aspectos de este documento.
- Opcional: Para ver la lista de tipos de aspectos y plantillas de etiquetas en el proyecto seleccionado, haz clic en la pestaña Personalizado y, luego, en el botón de activación Mostrar desde todos los proyectos para desactivarlo.
El botón de activación Mostrar desde todos los proyectos está activado de forma predeterminada, y la lista incluye recursos de Knowledge Catalog de la organización que seleccionaste y recursos de Data Catalog de todas las organizaciones a las que puedes acceder.
gcloud
Para enumerar todos los tipos de aspectos disponibles, usa el comando gcloud dataplex
aspect-types list.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para enumerar todos los tipos de aspectos disponibles, usa el método aspectTypes.list.
Cómo ver los detalles de un tipo de aspecto o una plantilla de etiqueta
Console
En la consola de Google Cloud , ve a la página Tipos de metadatos de Knowledge Catalog.
Haz clic en la pestaña Tipos de aspecto y plantillas de etiquetas.
Para ver los detalles de un tipo de aspecto del catálogo de Knowledge, haz clic en el tipo de aspecto. Se abrirá la página de detalles del tipo de aspecto, en la que podrás acceder a detalles como el nombre visible, el ID del tipo de aspecto, la descripción, el ID del proyecto, la ubicación, las etiquetas, la fecha de creación y la fecha de última modificación.
- Para ver la estructura del tipo de aspecto seleccionado, haz clic en la pestaña Plantilla.
- Para ver la lista de las 10 entradas relacionadas creadas recientemente, haz clic en la pestaña Entradas de ejemplo.
- Para buscar todas las entradas relacionadas, haz clic en Mostrar todas las entradas relacionadas en la búsqueda. Este botón solo aparece si hay al menos una entrada relacionada.
Para ver los detalles de una plantilla de etiqueta de Data Catalog, haz clic en ella. La página de detalles de la plantilla de etiqueta se abre en Data Catalog, donde puedes acceder a detalles como el nombre visible, el ID de la plantilla, el ID del proyecto, la ubicación, la visibilidad y las etiquetas.
gcloud
Para obtener los detalles de un tipo de aspecto, usa el comando gcloud dataplex aspect-types
describe.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para obtener los detalles de un tipo de aspecto, usa el método aspectTypes.get.
Actualiza un tipo de aspecto personalizado
Puedes actualizar el nombre visible, la descripción, los campos de la plantilla y las etiquetas de un tipo de aspecto personalizado. No puedes borrar un campo existente en una plantilla.
No puedes actualizar el ID y la ubicación del tipo de aspecto después de crear el tipo de aspecto.
Console
En la consola de Google Cloud , ve a la página Tipos de metadatos de Knowledge Catalog.
Haz clic en la pestaña Tipos de aspecto y plantillas de etiquetas.
Haz clic en el tipo de aspecto que deseas actualizar.
En la página Detalles del tipo de aspecto, haz clic en Editar.
Edita el nombre visible, la descripción, los campos de la plantilla y las etiquetas según sea necesario.
Opcional: Para marcar un campo en el tipo de aspecto como obsoleto, sigue estos pasos:
- En la sección Plantilla, expande el campo.
- Selecciona Is Deprecated.
- En el campo Motivo de la baja, ingresa un motivo para dar de baja el campo seleccionado.
Haz clic en Listo.
Haz clic en Guardar.
gcloud
Para actualizar un tipo de aspecto personalizado, usa el comando gcloud dataplex aspect-types
update.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para actualizar un tipo de aspecto personalizado, usa el método aspectTypes.patch.
Borra un tipo de aspecto personalizado
Console
En la consola de Google Cloud , ve a la página Tipos de metadatos de Knowledge Catalog.
Haz clic en la pestaña Tipos de aspecto y plantillas de etiquetas.
Haz clic en el tipo de aspecto que deseas borrar.
En la página Detalles del tipo de aspecto, haz clic en Borrar. Confirma cuando se te solicite.
gcloud
Para borrar un tipo de aspecto personalizado, usa el comando gcloud dataplex aspect-types
delete.
C#
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog C#.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Go.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Java.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Python.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre cómo usar las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog Ruby.
Para autenticarte en Knowledge Catalog, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para borrar un tipo de aspecto personalizado existente, usa el método aspectTypes.delete.
¿Qué sigue?
- Obtén más información para buscar recursos en Knowledge Catalog.
- Obtén más información para administrar entradas y transferir fuentes personalizadas.
- Obtén más información para importar metadatos a Knowledge Catalog.
- Obtén más información sobre la administración de metadatos en Knowledge Catalog.
- Obtén más información para migrar de Data Catalog a Knowledge Catalog.
- Obtén información para crear una administración de datos fundamental.
- Prueba los casos de uso de Knowledge Catalog.