Los aspectos y los tipos de aspectos en Knowledge Catalog (anteriormente, Dataplex Universal Catalog) te permiten agregar metadatos estructurados a entradas, columnas y vínculos de entradas para describir tus recursos de datos y sus relaciones. Este contexto mejora la visibilidad de los datos y te ayuda a clasificar la información sensible, como la información de identificación personal (PII), para aplicar políticas de calidad de los datos o de acceso.
Para obtener información conceptual sobre los esquemas de aspectos, los tipos de aspectos del sistema y personalizados, los niveles de destino y las restricciones de residencia de los datos, consulta Acerca de los aspectos y los tipos de aspectos. Para obtener una descripción general de la arquitectura de todo el metamodelo de metadatos, consulta Acerca de los metadatos en Knowledge Catalog. Si es la primera vez que trabajas con metadatos de Knowledge Catalog, consulta las guías de inicio rápido Agrega metadatos a una tabla de BigQuery o Crea y usa un glosario empresarial.
Antes de comenzar
Antes de crear y administrar tipos de aspectos 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 de aspectos y aspectos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto. No necesitas todos estos roles de forma simultánea. Elige el rol o la combinación que coincida con tu flujo de trabajo específico:
Para obtener los permisos que necesitas para crear y administrar tipos de aspectos y aspectos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:
-
Para administrar todos los recursos del catálogo, incluidos los tipos de aspectos y las entradas, con un acceso de administrador amplio:
Administrador del catálogo de Dataplex (
roles/dataplex.catalogAdmin) o Editor del catálogo de Dataplex (roles/dataplex.catalogEditor) -
Para crear y administrar solo tipos de aspectos personalizados, con acceso de privilegio mínimo para los administradores de tipos de aspectos:
Propietario de tipos de aspectos de Dataplex (
roles/dataplex.aspectTypeOwner) -
Para usar tipos de aspectos cuando creas o modificas entradas, con acceso con privilegios mínimos para los seleccionadores de datos:
Usuario de tipos de aspectos de Dataplex (
roles/dataplex.aspectTypeUser) -
Para adjuntar tipos de aspectos del sistema reutilizables, como
schema,contactsyoverview, a entradas y vínculos de entrada: Propietario de entradas y vínculo de entrada de Dataplex (roles/dataplex.entryOwner) -
Para ver los tipos de aspectos y sus políticas de IAM sin modificarlos:
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 tipos de aspectos y aspectos. 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 tipos de aspectos y aspectos:
-
Crea, visualiza, enumera, actualiza y borra tipos de aspectos:
-
dataplex.aspectTypes.create -
dataplex.aspectTypes.get -
dataplex.aspectTypes.list -
dataplex.aspectTypes.update -
dataplex.aspectTypes.delete
-
-
Usa tipos de aspectos para enriquecer las entradas:
dataplex.aspectTypes.use -
Crea, visualiza, actualiza y borra entradas y sus aspectos:
-
dataplex.entries.create -
dataplex.entries.get -
dataplex.entries.list -
dataplex.entries.update -
dataplex.entries.delete
-
-
Crea, visualiza, actualiza y borra vínculos de entrada y sus aspectos:
-
dataplex.entryLinks.create -
dataplex.entryLinks.get -
dataplex.entryLinks.list -
dataplex.entryLinks.update -
dataplex.entryLinks.delete
-
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
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 de Google Cloud nuevo o uno 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
Para crear un tipo de aspecto personalizado en la consola de Google Cloud , sigue estas subtareas:
Configura los detalles básicos:
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 > Personalizado y, luego, en Crear tipo de aspecto.
En la sección Detalles, ingresa lo siguiente:
- Opcional: Nombre visible: Es un nombre fácil de usar para el tipo de aspecto.
- ID del tipo de aspecto: Es un identificador único para el tipo de aspecto.
- Opcional: Descripción: Es una descripción del tipo de aspecto y su propósito.
- Ubicación: Selecciona una ubicación para el tipo de aspecto. No puedes modificar la ubicación después de crearla. Para obtener orientación sobre las compensaciones de ubicación global y regional, consulta Tipos de aspectos personalizados.
Define la plantilla de esquema:
La plantilla define el formato y el esquema de los campos de metadatos agrupados en tu tipo de aspecto. Puedes definir los campos de forma manual o acelerar la creación de esquemas seleccionando una plantilla de inicio de la Galería de plantillas, como Sensibilidad de los datos, Administración de datos o Ingesta de datos. Por ejemplo, si seleccionas la plantilla Data Sensitivity, se agregarán automáticamente los campos booleanos
Is EncryptedyHas PII, y el campo de enumeraciónPII Type.Para definir los campos de forma manual, haz lo siguiente:
- En la sección Plantilla, haz clic en Agregar campo.
- En el panel Campo nuevo, especifica lo siguiente:
- Nombre: Es un identificador para el campo.
- Nombre visible (opcional): Es una etiqueta fácil de usar.
- Descripción (opcional): Es una descripción breve del campo.
- Tipo: Selecciona el tipo de datos del campo. Entre los tipos admitidos, se incluyen Texto, Número entero, Booleano, Fecha y hora, Doble, Enum, Array, Mapa y Registro.
- Opcional: Es obligatorio: Selecciona esta casilla de verificación para que el campo sea obligatorio cuando los usuarios adjunten este aspecto.
- Haz clic en Listo. Para agregar más campos, haz clic en Agregar campo y repite estos pasos.
Agrega etiquetas de recursos y guarda los cambios:
Las etiquetas de recursos son pares clave-valor arbitrarios que te ayudan a organizar y filtrar tus recursos de Google Cloud . Por ejemplo, puedes organizar los recursos por entorno o propiedad del equipo con etiquetas como
environment: productionoteam: analytics.- En la sección Etiquetas, haz clic en Agregar etiqueta.
- Ingresa la Clave y el Valor de la etiqueta.
- 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las 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) - Designación (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 el ID de registro como
address-field. En Dirección permanente, puedes especificar el mismo valor
(address-field) para Referencia de registro. Por ejemplo:
- Nombre (tipo:
Text) - Fecha de inicio (tipo:
Date & time) - Designación (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 necesitas duplicar 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 las siguientes limitaciones:
- Puedes agregar aspectos a una entrada o a las columnas de una entrada.
- Solo puedes editar los aspectos obligatorios de las entradas personalizadas. No puedes borrar los aspectos obligatorios.
- Puedes editar y borrar los aspectos opcionales de las entradas personalizadas y del sistema.
- Cuando reemplazas o vuelves a cargar una tabla de BigQuery con una
instrucción
CREATE OR REPLACE TABLE, una instrucciónTRUNCATE TABLEo un trabajoWRITE_TRUNCATE, Knowledge Catalog conserva los aspectos de la entrada adjuntos por el usuario. Los aspectos a nivel de columna también se conservan para las columnas que permanecen en el esquema. Sin embargo, si borras y vuelves a crear una tabla con una declaraciónDROP TABLEy una declaraciónCREATE TABLE, Knowledge Catalog crea una entrada nueva sin los aspectos adjuntos del usuario de la tabla original. Para mantener los aspectos cuando vuelvas a cargar una tabla, usaCREATE OR REPLACE TABLE,TRUNCATE TABLEoWRITE_TRUNCATE. Como alternativa, puedes crear una vista de BigQuery y adjuntar aspectos a la vista.
Console
En la consola de Google Cloud , ve a la página Búsqueda de Knowledge 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.
En la página de detalles de la entrada, haz clic en la pestaña Detalles.
En la sección Aspectos, haz clic en Agregar en el área Aspectos obligatorios o Aspectos opcionales. Solo puedes agregar aspectos obligatorios si el tipo de entrada los define.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 Entrada.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 .
Adjunta aspectos de tipos de aspectos del sistema reutilizables
Knowledge Catalog proporciona tipos de aspectos del sistema predefinidos que puedes adjuntar a las entradas para capturar metadatos estandarizados. Por ejemplo, puedes usar estos tipos de aspectos para registrar contactos de propiedad, definiciones de esquemas, métricas de uso y resultados de calidad de los datos.
Flujo de trabajo general y reglas de carga útil
Cuando adjuntes aspectos de tipos de aspectos del sistema reutilizables, sigue estas reglas:
- Consola frente a CLI/REST: Para los tipos de aspectos sin campos anidados, como
generic, puedes usar la consola de Google Cloud , la CLI degcloudo la API de REST. Para los tipos de aspectos con estructuras complejas o anidadas, comodata-quality-scorecard,contactsodata-profile, debes usar la CLI degcloudo la API de REST. - Estructura de la carga útil:
- CLI de
gcloud: Pasa el mapa de aspectos directamente, con la clave del identificador de tipo de aspecto global:{"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}. - API de REST: Une el mapa de aspectos dentro de un objeto contenedor
"aspects":{"aspects": {"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}}.
- CLI de
- Comportamiento de reemplazo: Cuando se actualiza un aspecto, se reemplazan los datos existentes para ese tipo de aspecto específico en la entrada o columna de destino; no se combinan los campos.
En las siguientes secciones, se proporcionan ejemplos y esquemas para adjuntar aspectos comunes del sistema reutilizables, comenzando con el cuadro de evaluación de la calidad de los datos.
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 calidad de los datos o en otros procesos. Puedes adjuntar un cuadro de evaluación de la 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 data-quality-scorecard definido por el sistema.
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 se 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 una de las siguientes opciones: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 varía de [0, 100].status: Es el estado de la dimensión, que indica si aprobó 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 aprobó o no el umbral de calidad (PASSoFAIL).dimensions: Es un array de puntuaciones de dimensiones 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 varía de [0, 100].status: Es el estado de la dimensión de la columna, que indica si aprobó o no el umbral de calidad (PASS,FAIL,UNKNOWNoNOT_APPLICABLE).
details(mapa opcional): Pares clave-valor que proporcionan contexto adicional sobre la evaluación.evaluatedAssetCount(número entero opcional): Es la cantidad de recursos evaluados.
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 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": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 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: el ID de la entrada, por ejemplo,example-entryLOCATION: 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 la 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: el ID del grupo de entradas, por ejemplo,example-entry-groupENTRY_ID: el ID de la entrada, por ejemplo,example-entry
Otros tipos de aspectos reutilizables
Los siguientes tipos de aspectos del sistema también están disponibles para el enriquecimiento de entradas. Los resúmenes de carga inicial se indican en las siguientes secciones. Haz clic en cada sección expandible para ver los esquemas de campo y las cargas útiles de JSON de ejemplo.
Contactos (dataplex-types.global.contacts)
Usa el tipo de aspecto contacts para asignar roles de propiedad, administración o de operaciones a las entradas.
identities(array): Es una lista de contactos. Cada contacto incluyerole(por ejemplo,owner,steward,produceroadmin),nameyid(dirección de correo electrónico).
Carga útil de ejemplo (API de REST):
{ "aspects": { "dataplex-types.global.contacts": { "data": { "identities": [ { "role": "steward", "name": "Jane Doe", "id": "jane.doe@example.com" } ] } } } }
Perfil de datos (dataplex-types.global.data-profile)
Usa el tipo de aspecto data-profile para capturar los resultados de la generación de perfiles estadísticos que se generan a partir de los análisis de datos de origen. Para obtener más información, consulta Acerca de la generación de perfiles de datos.
sourceDataInfo(registro): Son los metadatos sobre el análisis, incluidosscope(PREVIEW,SAMPLEDoALL),scannedRowsysamplingPercentage.fields(mapa): Son estadísticas a nivel de columna, incluidasnullness,uniquenessy métricas específicas del tipo para columnas numéricas, de cadena, de fecha y hora, y de array.
Carga útil de ejemplo (API de REST):
{ "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 } } } } } } } }
Pases genéricos (dataplex-types.global.generic)
Usa el tipo de aspecto generic para capturar información de entrada de formato libre y metadatos del sistema de origen sin definir un esquema de aspecto personalizado.
type(cadena): Es una cadena de categorización de entradas especificada por el usuario.system(cadena): Es el identificador del sistema de origen de la entrada personalizada.
Carga útil de ejemplo (API de REST):
{ "aspects": { "dataplex-types.global.generic": { "data": { "type": "custom-type", "system": "custom-system" } } } }
Descripción general (dataplex-types.global.overview)
Usa el tipo de aspecto overview para proporcionar documentación de texto enriquecido legible por humanos y vínculos externos útiles.
content(cadena): Es una descripción de texto enriquecido que admite el formato HTML.links(array): Son vínculos a recursos y documentación externos, cada uno conurlytitle.
Carga útil de ejemplo (API de REST):
{ "aspects": { "dataplex-types.global.overview": { "data": { "content": "This is a rich text description.", "links": [ { "url": "https://example.com", "title": "Example Link" } ] } } } }
Esquema (dataplex-types.global.schema)
Usa el tipo de aspecto schema para describir el esquema tabular, los nombres de las columnas, los modos y los tipos de datos de los recursos de datos.
fields(array): Es una lista de columnas, cada una conname,dataType,metadataType(comoSTRING,BOOLEAN),mode(NULLABLE,REQUIRED,REPEATED) ydescriptionopcional.
Carga útil de ejemplo (API de REST):
{ "aspects": { "dataplex-types.global.schema": { "data": { "fields": [ { "name": "id", "dataType": "string", "metadataType": "STRING", "mode": "REQUIRED" } ] } } } }
Uso (dataplex-types.global.usage)
Usa el tipo de aspecto usage para hacer un seguimiento de las métricas de consumo, los recuentos de vistas y los patrones de consulta de series temporales.
metrics(array): Métricas de consumo, cada una conname(comoviewsoreads) y datos detimeSeriescon intervalos y valores de agregación.refreshTime(datetime): Es la marca de tiempo de la última vez que se calcularon las métricas de uso.
Carga útil de ejemplo (API de REST):
{ "aspects": { "dataplex-types.global.usage": { "data": { "metrics": [ { "name": "views", "timeSeries": [ { "interval": "30d", "value": 100 } ] } ], "refreshTime": "2025-01-01T12:00:00Z" } } } }
Crea un vínculo de entrada
Puedes establecer una relación entre dos entradas creando un vínculo de entrada.
Un vínculo de entrada puede ser simétrico, como un synonym, o asimétrico, como un
definition.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
REST
Para crear un vínculo de entrada con el aspecto requerido, usa el método entryLinks.create, incluidos los datos del aspecto en el cuerpo de la solicitud.
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 obligatorio.
Puedes agregar estos aspectos cuando creas un vínculo de entrada o actualizas uno existente, de la siguiente manera:
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
REST
Para actualizar un vínculo de entrada, usa el método entryLinks.patch, incluidos los datos de aspecto en el cuerpo de 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 los aspectos de los 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.
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 de las entradas personalizadas y las 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 los aspectos con la API de modifyEntry. Esto te permite usar los permisos de actualización de metadatos del sistema de origen (por ejemplo, Editor de datos de BigQuery (roles/bigquery.dataEditor)).
Console
En la consola de Google Cloud , ve a la página Búsqueda de Knowledge 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, expande el aspecto que deseas actualizar y haz clic en Editar.
- En la ventana Editar aspecto, actualiza los campos obligatorios.
- Haz clic en Guardar.
gcloud
Para actualizar los aspectos de una entrada o una columna de una entrada, usa el comando gcloud
dataplex entries update o gcloud dataplex entries update-aspects.
Para actualizar aspectos con un archivo JSON, haz lo siguiente:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=ASPECTS_JSON_FILE
Reemplaza lo siguiente:
ENTRY_ID: Es el ID de la entrada.LOCATION: Es la ubicación de la entrada.ENTRY_GROUP_ID: Es el ID del grupo de entradas.PROJECT_ID: el ID del proyectoASPECTS_JSON_FILE: Es la ruta de acceso al archivo JSON que contiene el mapa de aspectos.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 los 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.
Busca la entrada cuyos aspectos deseas borrar y haz clic en la entrada.
Se abrirá la página de detalles de la entrada.
- Haz clic en la pestaña Detalles.
- En la sección Aspectos, expande el aspecto 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 con la marca --remove-aspects.
Para borrar un aspecto de nivel de entrada, haz lo siguiente:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE'
Para borrar un aspecto a nivel de columna, haz lo siguiente:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE@Schema.COLUMN_NAME'
Reemplaza lo siguiente:
ENTRY_ID: Es el ID de la entrada.LOCATION: Es la ubicación de la entrada.ENTRY_GROUP_ID: Es el ID del grupo de entradas.PROJECT_ID: el ID del proyectoASPECT_TYPE: Es el identificador completo del tipo de aspecto, por ejemplo,dataplex-types.global.generico<var>PROJECT_ID</var>.<var>LOCATION</var>.<var>ASPECT_TYPE_ID</var>.COLUMN_NAME: el nombre de la columna.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 del sistema reutilizables.
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, incluidos 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.
Administrar 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 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 aspectos.
En esta página, se enumeran todos los tipos de aspectos disponibles de Knowledge Catalog.
- Para ver los tipos de aspectos personalizados, haz clic en la pestaña Personalizado. En la pestaña Personalizado, la columna Fuente del catálogo muestra dónde reside el recurso en Knowledge 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 en el proyecto seleccionado, haz clic en la pestaña Personalizado y, luego, en el botón de activación Mostrar de todos los proyectos para desactivarlo.
El botón de activación Mostrar de todos los proyectos está activado de forma predeterminada, y la lista incluye recursos de Knowledge Catalog de la organización que seleccionaste.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Consulta los detalles de un 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 aspectos.
Para ver los detalles de un tipo de aspecto de Knowledge Catalog, 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 10 entradas relacionadas creadas recientemente, haz clic en la pestaña Entradas de muestra.
- 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.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 plantilla y las etiquetas de un tipo de aspecto personalizado. No puedes borrar un campo existente en una plantilla.
No puedes actualizar el ID ni la ubicación del tipo de aspecto después de crearlo.
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 aspectos.
Haz clic en el tipo de aspecto que quieres 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 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 aspectos.
Haz clic en el tipo de aspecto que quieres 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
Node.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Knowledge Catalog sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para Node.js.
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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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 las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Knowledge Catalog para 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.
- Aprende a importar metadatos a Knowledge Catalog.
- Obtén más información sobre los metadatos en Knowledge Catalog.
- Obtén más información para establecer un contexto de datos fundamental.
- Prueba los casos de uso de Knowledge Catalog.