Gli aspetti e i tipi di aspetto in Knowledge Catalog (precedentemente Dataplex Universal Catalog) consentono di aggiungere metadati strutturati a voci, colonne e link alle voci per descrivere gli asset di dati e le relative relazioni. Questo contesto migliora la rilevabilità dei dati e ti aiuta a classificare le informazioni sensibili, come le informazioni che consentono l'identificazione personale (PII), per applicare policy di qualità dei dati o di accesso.
Per informazioni concettuali sugli schemi degli aspetti, sui tipi di aspetti di sistema e personalizzati, sui livelli di destinazione e sui vincoli di residenza dei dati, consulta Informazioni sugli aspetti e sui tipi di aspetti. Per una panoramica dell'architettura dell'intero metamodello dei metadati, consulta Informazioni sui metadati in Knowledge Catalog. Se è la prima volta che utilizzi i metadati di Knowledge Catalog, consulta le guide rapide Aggiungi metadati a una tabella BigQuery o Crea e utilizza un glossario aziendale.
Prima di iniziare
Prima di creare e gestire tipi di aspetti e aspetti, completa le attività descritte in questa sezione.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare e gestire tipi di aspetti e aspetti, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto. Non hai bisogno di tutti questi ruoli contemporaneamente. Scegli il ruolo o la combinazione che corrisponde al tuo workflow specifico:
Per ottenere le autorizzazioni necessarie per creare e gestire tipi di aspetti e aspetti, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
-
Per gestire tutte le risorse del catalogo, inclusi i tipi di aspetto e le voci, con un accesso amministratore ampio:
Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) o Dataplex Catalog Editor (roles/dataplex.catalogEditor) -
Per creare e gestire solo tipi di aspetto personalizzati, con accesso con privilegi minimi per gli amministratori dei tipi di aspetto:
Dataplex Aspect Type Owner (
roles/dataplex.aspectTypeOwner) -
Per utilizzare i tipi di aspetto durante la creazione o la modifica delle voci, con accesso con privilegi minimi per i curatori dei dati:
Dataplex Aspect Type User (
roles/dataplex.aspectTypeUser) -
Per collegare tipi di aspetti di sistema riutilizzabili, come
schema,contactseoverview, a voci e link alle voci: Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner) -
Per visualizzare i tipi di aspetto e le relative policy IAM senza modificarli:
Dataplex Catalog Viewer (
roles/dataplex.catalogViewer)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e gestire tipi di aspetti e aspetti. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare e gestire tipi di aspetti e aspetti sono necessarie le seguenti autorizzazioni:
-
Crea, visualizza, elenca, aggiorna ed elimina i tipi di aspetto:
-
dataplex.aspectTypes.create -
dataplex.aspectTypes.get -
dataplex.aspectTypes.list -
dataplex.aspectTypes.update -
dataplex.aspectTypes.delete
-
-
Utilizza i tipi di aspetto per arricchire le voci:
dataplex.aspectTypes.use -
Crea, visualizza, aggiorna ed elimina le voci e i relativi aspetti:
-
dataplex.entries.create -
dataplex.entries.get -
dataplex.entries.list -
dataplex.entries.update -
dataplex.entries.delete
-
-
Crea, visualizza, aggiorna ed elimina i link alle voci e i relativi aspetti:
-
dataplex.entryLinks.create -
dataplex.entryLinks.get -
dataplex.entryLinks.list -
dataplex.entryLinks.update -
dataplex.entryLinks.delete
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Per saperne di più, consulta Ruoli IAM di Knowledge Catalog.
Abilita l'API
Abilita l'API Dataplex nel tuo progetto Knowledge Catalog. Se utilizzi un nuovo progetto Google Cloud o un progetto in cui è abilitata l'API BigQuery, l'API Dataplex è abilitata per impostazione predefinita.
Crea un tipo di aspetto personalizzato
Console
Per creare un tipo di aspetto personalizzato nella console Google Cloud , segui queste attività secondarie:
Configura i dettagli di base:
Nella console Google Cloud , vai alla pagina Tipi di metadati di Knowledge Catalog.
Fai clic sulla scheda Tipi di aspetto > Personalizzato, quindi su Crea tipo di aspetto.
Nella sezione Dettagli, inserisci quanto segue:
- (Facoltativo) Nome visualizzato: un nome facile da usare per il tipo di aspetto.
- ID tipo di aspetto: un identificatore univoco per il tipo di aspetto.
- (Facoltativo) Descrizione: una descrizione del tipo di aspetto e del suo scopo.
- Località: seleziona una località per il tipo di aspetto. Non puoi modificare la località dopo la creazione. Per indicazioni sui compromessi tra località globali e regionali, consulta Tipi di aspetti personalizzati.
Definisci il template dello schema:
Il template definisce il formato e lo schema dei campi dei metadati raggruppati all'interno del tipo di aspetto. Puoi definire i campi manualmente o accelerare la creazione dello schema selezionando un modello iniziale dalla Galleria di modelli, ad esempio Sensibilità dei dati, Governance dei dati o Acquisizione dei dati. Ad esempio, se selezioni il modello Sensibilità dei dati, vengono aggiunti automaticamente i campi booleani
Is EncryptedeHas PIIe il campo enumPII Type.Per definire i campi manualmente:
- Nella sezione Modello, fai clic su Aggiungi campo.
- Nel riquadro Nuovo campo, specifica quanto segue:
- Nome: un identificatore per il campo.
- (Facoltativo) Nome visualizzato: un'etichetta facile da usare.
- (Facoltativo) Descrizione: una breve descrizione del campo.
- Tipo: seleziona il tipo di dati del campo. I tipi supportati includono Testo, Numero intero, Booleano, Data e ora, Doppio, Enum, Array, Mappa e Record.
- (Facoltativo) È obbligatorio: seleziona questa casella di controllo per rendere obbligatorio il campo quando gli utenti collegano questo aspetto.
- Fai clic su Fine. Per aggiungere altri campi, fai clic su Aggiungi campo e ripeti questi passaggi.
Aggiungi etichette delle risorse e salva:
Le etichette delle risorse sono coppie chiave-valore arbitrarie che ti aiutano a organizzare e filtrare le risorse Google Cloud . Ad esempio, puoi organizzare le risorse in base all'ambiente o alla proprietà del team utilizzando etichette come
environment: productionoteam: analytics.- Nella sezione Etichette, fai clic su Aggiungi etichetta.
- Inserisci la Chiave e il Valore dell'etichetta.
- Fai clic su Salva.
gcloud
Per creare un tipo di aspetto personalizzato, utilizza il comando gcloud dataplex aspect-types
create.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per creare un tipo di aspetto personalizzato, utilizza il metodo aspectType.create.
Dopo aver creato un tipo di aspetto personalizzato, puoi aggiungere aspetti alle voci.
Esempio di utilizzo dei campi ID record e Riferimento record
Puoi utilizzare i campi ID record e Riferimento record per i riferimenti ricorsivi. L'esempio seguente mostra come utilizzare questi campi:
Considera un tipo di aspetto denominato Employee, con i seguenti campi:
- Nome (tipo:
Text) - Data di inizio (tipo:
Date & time) - Designation (type:
Text) - Indirizzo attuale (tipo:
Record) - Indirizzo permanente (tipo:
Record)
I due campi di indirizzo Indirizzo attuale e Indirizzo permanente sono dello stesso tipo di dati Record. Per evitare la duplicazione, puoi impostare i valori ID record e Riferimento record quando definisci questi campi.
Quando definisci il campo Indirizzo attuale, puoi specificare ID record come address-field. Per Permanent address (Indirizzo permanente), puoi specificare lo stesso valore (address-field) per Record reference (Riferimento record). Ad esempio:
- Nome (tipo:
Text) - Data di inizio (tipo:
Date & time) - Designation (type:
Text) - Indirizzo attuale (tipo:
Record, ID record:address-field) - Indirizzo permanente (tipo:
Record, riferimento record:address-field)
In questo modo, non è necessario duplicare i campi di un altro indirizzo.
Aggiungi aspetti a una voce
Dopo aver creato un tipo di aspetto personalizzato, puoi creare aspetti di quel tipo. Per aggiungere aspetti a una voce, devi aggiornare la voce, poiché gli aspetti vengono archiviati all'interno delle voci.
Nota. Vi sono delle limitazioni:
- Puoi aggiungere aspetti a una voce o alle colonne di una voce.
- Puoi modificare gli aspetti obbligatori solo per le voci personalizzate. Non puoi eliminare gli aspetti obbligatori.
- Puoi modificare ed eliminare gli aspetti facoltativi sia per le voci personalizzate che per quelle di sistema.
- Quando sostituisci o ricarichi una tabella BigQuery utilizzando un'istruzione
CREATE OR REPLACE TABLE, un'istruzioneTRUNCATE TABLEo un jobWRITE_TRUNCATE, Knowledge Catalog conserva gli aspetti della voce allegati dall'utente. Gli aspetti a livello di colonna vengono conservati anche per le colonne che rimangono nello schema. Tuttavia, se elimini e ricrei una tabella utilizzando un'istruzioneDROP TABLEe un'istruzioneCREATE TABLE, Knowledge Catalog crea una nuova voce senza gli aspetti collegati dall'utente della tabella originale. Per mantenere gli aspetti quando ricarichi una tabella, utilizzaCREATE OR REPLACE TABLE,TRUNCATE TABLEoWRITE_TRUNCATE. In alternativa, puoi creare una vista BigQuery e collegare gli aspetti alla vista.
Console
Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.
Cerca la voce a cui vuoi aggiungere gli aspetti e fai clic sulla voce. Viene visualizzata la pagina dei dettagli della voce.
Nella pagina dei dettagli della voce, fai clic sulla scheda Dettagli.
Nella sezione Aspetti, fai clic su Aggiungi nell'area Aspetti obbligatori o Aspetti facoltativi. Puoi aggiungere aspetti obbligatori solo se il tipo di voce li definisce.
Cerca e seleziona l'aspetto che vuoi aggiungere.
Nella finestra Aggiungi aspetto, inserisci i valori per i campi.
Fai clic su Salva.
Per aggiungere aspetti a una colonna della voce:
- Nella pagina dei dettagli della voce, fai clic sulla scheda Schema.
- Seleziona le colonne a cui vuoi aggiungere gli aspetti.
- Fai clic su Aggiungi aspetto.
- Cerca e seleziona l'aspetto che vuoi aggiungere.
- Nella finestra Aggiungi aspetto, inserisci i valori per i campi.
- Fai clic su Salva.
gcloud
Per aggiungere aspetti a una voce o a una colonna di una voce, utilizza il comando gcloud
dataplex entries update.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Per aggiungere aspetti all'oggetto Entry, consulta Aspetti.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Per aggiungere aspetti all'oggetto Entry, consulta Entry.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Per aggiungere aspetti all'oggetto entry, consulta #required_aspects=.
REST
Per aggiungere aspetti a una voce o a una colonna di una voce, utilizza il metodo entry.patch.
La creazione e l'utilizzo di aspetti in una voce in cui il rispettivo tipo di aspetto e la voce si trovano in organizzazioni Google Cloud diverse non sono supportati.
Collega aspetti di tipi di aspetto di sistema riutilizzabili
Knowledge Catalog fornisce tipi di aspetti di sistema predefiniti che puoi collegare alle voci per acquisire metadati standardizzati. Ad esempio, puoi utilizzare questi tipi di aspetti per registrare i contatti di proprietà, le definizioni degli schemi, le metriche di utilizzo e i risultati della qualità dei dati.
Workflow generale e regole del payload
Quando colleghi aspetti di tipi di aspetto di sistema riutilizzabili, segui queste regole:
- Console e CLI/REST: per i tipi di aspetto senza campi nidificati, come
generic, puoi utilizzare la console Google Cloud , l'interfaccia a riga di comandogcloudo l'API REST. Per i tipi di aspetto con strutture complesse o nidificate, comedata-quality-scorecard,contactsodata-profile, devi utilizzare l'interfaccia a riga di comandogcloudo l'API REST. - Struttura del payload:
- CLI
gcloud: passa direttamente la mappa degli aspetti, con chiave l'identificatore del tipo di aspetto globale:{"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}. - API REST: inserisci la mappa degli aspetti all'interno di un oggetto contenitore
"aspects":{"aspects": {"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}}.
- CLI
- Comportamento di sovrascrittura: l'aggiornamento di un aspetto sostituisce tutti i dati esistenti per quel tipo di aspetto specifico nella voce o nella colonna di destinazione; non unisce i campi.
Le sezioni seguenti forniscono esempi e schemi per collegare aspetti comuni del sistema riutilizzabili, a partire dal prospetto di valutazione della qualità dei dati.
Scheda di valutazione della qualità dei dati
Un prospetto della qualità dei dati è un aspetto che fornisce un riepilogo della qualità dei dati, spesso basato su scansioni della qualità dei dati o altri processi. Puoi allegare un prospetto della qualità dei dati a una voce per fornire informazioni personalizzate sulla qualità dei dati. Per farlo, collega un aspetto del tipo definito dal sistema data-quality-scorecard.
Il campo data all'interno dell'aspetto data-quality-scorecard può includere i seguenti campi:
job: (Facoltativo) Un record contenente i dettagli del job che ha generato lo scorecard.name: il nome della risorsa del job di qualità dei dati.runTime: il tempo di esecuzione del job di qualità dei dati.
score: (Facoltativo) Il punteggio di qualità dei dati complessivo. Il punteggio è compreso tra [0, 100].status: obbligatorio. Lo stato dello scorecard della qualità dei dati, che indica se ha superato o meno la soglia di qualità (PASSoFAIL).dimensions: (Facoltativo) Un array di risultati delle dimensioni. Ogni risultato include:name: il nome della dimensione. Può essere uno dei valoriACCURACY,COMPLETENESS,CONSISTENCY,FRESHNESS,UNIQUENESS,VALIDITYoVOLUMEoppure il nome di una dimensione personalizzata. I nomi delle dimensioni personalizzate devono utilizzare lettere maiuscole e contenere massimo 30 caratteri.score: il punteggio complessivo a livello di dimensione, compreso tra [0, 100].status: lo stato della dimensione, che indica se ha superato o meno la soglia di qualità (PASSoFAIL).
columns: (Facoltativo) Un array di risultati delle colonne. Ogni risultato include:name: il nome della colonna.score: il punteggio complessivo a livello di colonna, compreso tra [0, 100].status: lo stato della colonna, che indica se ha superato o meno la soglia di qualità (PASSoFAIL).dimensions: un array di punteggi delle dimensioni per la colonna. Ogni punteggio della dimensione include:name: il nome della dimensione.score: il punteggio della dimensione, compreso tra [0, 100].status: lo stato della dimensione per la colonna, che indica se ha superato o meno la soglia di qualità (PASS,FAIL,UNKNOWNoNOT_APPLICABLE).
details(mappa facoltativa): coppie chiave-valore che forniscono un contesto aggiuntivo sulla valutazione.evaluatedAssetCount(numero intero facoltativo): il numero di asset valutati.
Quando esegui il comando per collegare un aspetto, i dati esistenti per quell'aspetto specifico vengono sostituiti. Ad esempio, se aggiorni una scheda di valutazione con un punteggio di 80 con un nuovo file che mostra un punteggio di 90, il valore 80 viene sovrascritto. I dati non vengono uniti.
Per allegare un prospetto sulla qualità dei dati, segui questi passaggi:
gcloud
Per aggiornare gli aspetti di una voce, utilizza il comando gcloud dataplex entries
update-aspects.
Crea un file JSON (
dq-aspect.json) con i seguenti contenuti.{ "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" } ] } } }Esegui questo comando:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=dq-aspect.json
Sostituisci le seguenti variabili:
ENTRY_ID: l'ID della voce, ad esempioexample-entryLOCATION: la località della voce, ad esempious-central1ENTRY_GROUP_ID: l'ID del gruppo di voci, ad esempioexample-entry-groupPROJECT_ID: l'ID del progetto, ad esempioexample-project
REST
Per aggiornare gli aspetti di una voce, utilizza il metodo
entry.patch.
Crea un file denominato
payload.jsone incolla i contenuti JSON della richiesta.{ "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" } ] } } } }Esegui questo comando nel terminale:
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"Sostituisci quanto segue:
PROJECT_ID: l'ID del progetto, ad esempioexample-projectLOCATION: la località della voce, ad esempious-central1ENTRY_GROUP_ID: l'ID del gruppo di voci, ad esempioexample-entry-groupENTRY_ID: l'ID della voce, ad esempioexample-entry
Altri tipi di aspetti riutilizzabili
Per l'arricchimento delle voci sono disponibili anche i seguenti tipi di aspetti di sistema. I riepiloghi iniziali sono elencati nelle sezioni seguenti. Fai clic su ogni sezione espandibile per visualizzare gli schemi dei campi e i payload JSON di esempio.
Contatti (dataplex-types.global.contacts)
Utilizza il tipo di aspetto contacts per assegnare ruoli di proprietà, gestione o operativi alle voci.
identities(array): un elenco di contatti. Ogni contatto includerole(ad esempioowner,steward,produceroadmin),nameeid(indirizzo email).
Esempio di payload (API REST):
{ "aspects": { "dataplex-types.global.contacts": { "data": { "identities": [ { "role": "steward", "name": "Jane Doe", "id": "jane.doe@example.com" } ] } } } }
Profilo dati (dataplex-types.global.data-profile)
Utilizza il tipo di aspetto data-profile per acquisire i risultati della profilazione statistica generati dalle scansioni dei dati di origine. Per saperne di più, consulta Informazioni sulla profilazione dei dati.
sourceDataInfo(record): metadati relativi alla scansione, inclusiscope(PREVIEW,SAMPLEDoALL),scannedRowsesamplingPercentage.fields(mappa): statistiche a livello di colonna, tra cuinullness,uniquenesse metriche specifiche per il tipo di colonne numeriche, stringa, datetime e array.
Esempio di payload (API 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 } } } } } } } }
Generica (dataplex-types.global.generic)
Utilizza il tipo di aspetto generic per acquisire informazioni sulle voci in formato libero e i metadati del sistema di origine senza definire uno schema di aspetto personalizzato.
type(stringa): una stringa di categorizzazione delle voci specificata dall'utente.system(stringa): l'identificatore del sistema di origine della voce personalizzata.
Esempio di payload (API REST):
{ "aspects": { "dataplex-types.global.generic": { "data": { "type": "custom-type", "system": "custom-system" } } } }
Panoramica (dataplex-types.global.overview)
Utilizza il tipo di aspetto overview per fornire documentazione in formato RTF leggibile e link esterni utili.
content(stringa): descrizione in formato RTF che supporta la formattazione HTML.links(array): risorse esterne e link alla documentazione, ciascuno contenenteurletitle.
Esempio di payload (API REST):
{ "aspects": { "dataplex-types.global.overview": { "data": { "content": "This is a rich text description.", "links": [ { "url": "https://example.com", "title": "Example Link" } ] } } } }
Schema (dataplex-types.global.schema)
Utilizza il tipo di aspetto schema per descrivere lo schema tabulare, i nomi delle colonne, le modalità e i tipi di dati degli asset di dati.
fields(array): elenco di colonne, ciascuna contenentename,dataType,metadataType(ad esempioSTRING,BOOLEAN),mode(NULLABLE,REQUIRED,REPEATED) edescriptionfacoltativo.
Esempio di payload (API REST):
{ "aspects": { "dataplex-types.global.schema": { "data": { "fields": [ { "name": "id", "dataType": "string", "metadataType": "STRING", "mode": "REQUIRED" } ] } } } }
Utilizzo (dataplex-types.global.usage)
Utilizza il tipo di aspetto usage per monitorare le metriche di consumo, il numero di visualizzazioni e i pattern di query delle serie temporali.
metrics(array): metriche di consumo, ciascuna contenentename(ad esempioviewsoreads) etimeSeriespunti dati con intervalli e valori di aggregazione.refreshTime(datetime): timestamp dell'ultimo calcolo delle metriche di utilizzo.
Esempio di payload (API REST):
{ "aspects": { "dataplex-types.global.usage": { "data": { "metrics": [ { "name": "views", "timeSeries": [ { "interval": "30d", "value": 100 } ] } ], "refreshTime": "2025-01-01T12:00:00Z" } } } }
Crea un link di accesso
Puoi stabilire una relazione tra due voci creando un link di voce.
Un link di ingresso può essere simmetrico, ad esempio un synonym, o asimmetrico, ad esempio un definition.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per creare un link di entrata con l'aspetto richiesto, utilizza il metodo entryLinks.create, includendo i dati dell'aspetto nel corpo della richiesta.
Aggiungi aspetti a un link di una voce
Per arricchire i metadati con informazioni sulle relazioni tra le voci, aggiungi aspetti ai link delle voci.
Puoi configurare i tipi di link di entrata in modo che richiedano un aspetto specifico. Quando crei un link di voce di questo tipo, devi fornire l'aspetto richiesto.
Puoi aggiungere questi aspetti quando crei un link di accesso o aggiornando un link di accesso esistente, come segue:
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per aggiornare un link di una voce, utilizza il metodo entryLinks.patch, includendo i dati dell'aspetto nel corpo di entryLink.
Tieni presente le seguenti limitazioni per l'utilizzo degli aspetti con i link di accesso:
- Gli aspetti facoltativi non sono supportati.
- Gli aspetti dei dati non sono supportati.
- Gli aspetti dei tipi personalizzati non sono supportati.
- Puoi gestire solo gli aspetti obbligatori definiti dai tipi di aspetto di sistema, ad esempio
schema-join. - La ricerca di link di voci in base ai contenuti dei relativi aspetti non è supportata.
- L'importazione o l'esportazione di aspetti dei link di ingresso non è supportata.
Gestisci gli aspetti esistenti per una voce
Questa sezione descrive come aggiornare ed eliminare gli aspetti esistenti di una voce.
Aggiorna un aspetto
Puoi modificare gli aspetti facoltativi sia per le voci personalizzate che per quelle di sistema. Puoi modificare gli aspetti obbligatori solo per le voci personalizzate.
Per le voci di sistema proprietarie (1P), come le tabelle BigQuery, puoi aggiornare gli aspetti utilizzando l'API modifyEntry. In questo modo, puoi utilizzare le autorizzazioni di aggiornamento dei metadati del sistema di origine (ad esempio, BigQuery Data Editor (roles/bigquery.dataEditor)).
Console
Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.
Cerca la voce di cui vuoi aggiornare gli aspetti e fai clic sulla voce.
Viene visualizzata la pagina dei dettagli della voce.
- Fai clic sulla scheda Dettagli.
- Nella sezione Aspetti, espandi l'aspetto che vuoi aggiornare e fai clic su Modifica.
- Nella finestra Modifica aspetto, aggiorna i campi obbligatori.
- Fai clic su Salva.
gcloud
Per aggiornare gli aspetti di una voce o di una colonna di una voce, utilizza il comando gcloud
dataplex entries update o gcloud dataplex entries update-aspects.
Per aggiornare gli aspetti utilizzando un file JSON:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=ASPECTS_JSON_FILE
Sostituisci quanto segue:
ENTRY_ID: l'ID della voce.LOCATION: la località della voce.ENTRY_GROUP_ID: l'ID del gruppo di voci.PROJECT_ID: l'ID del progettoASPECTS_JSON_FILE: il percorso del file JSON contenente la mappa degli aspetti.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per aggiornare gli aspetti di una voce o di una colonna di una voce, utilizza il metodo entry.patch.
Elimina un aspetto
Console
Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.
Cerca la voce di cui vuoi eliminare gli aspetti e fai clic sulla voce.
Viene visualizzata la pagina dei dettagli della voce.
- Fai clic sulla scheda Dettagli.
- Nella sezione Aspetti, espandi l'aspetto che vuoi eliminare e fai clic su Elimina.
- Fai clic su Conferma.
gcloud
Per eliminare un aspetto per una voce, utilizza il comando gcloud dataplex entries update con il flag --remove-aspects.
Per eliminare un aspetto di livello base:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE'
Per eliminare un aspetto a livello di colonna:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE@Schema.COLUMN_NAME'
Sostituisci quanto segue:
ENTRY_ID: l'ID della voce.LOCATION: la località della voce.ENTRY_GROUP_ID: l'ID del gruppo di voci.PROJECT_ID: l'ID del progettoASPECT_TYPE: l'identificatore completo del tipo di aspetto, ad esempiodataplex-types.global.generico<var>PROJECT_ID</var>.<var>LOCATION</var>.<var>ASPECT_TYPE_ID</var>.COLUMN_NAME: il nome della colonna.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per eliminare un aspetto per una voce, utilizza il metodo
entry.patch.
Gestisci gli aspetti esistenti per un link di voce
Questa sezione descrive come aggiornare gli aspetti esistenti per un link di voce.
Aggiorna un aspetto
Per i link alle voci, puoi aggiornare solo gli aspetti obbligatori che utilizzano tipi di aspetti di sistema riutilizzabili.
Per saperne di più, consulta Autorizzazioni IAM per le operazioni sui link di entrata.
REST
Per aggiornare un link alla voce con l'aspetto richiesto, utilizza il metodo entryLinks.patch, includendo i dati dell'aspetto nel corpo della richiesta.
Elimina un aspetto
Non puoi eliminare l'aspetto richiesto per un link di ingresso.
Gestisci tipi di aspetti
Questa sezione descrive come visualizzare i tipi di aspetto e come aggiornare ed eliminare i tipi di aspetto personalizzati.
Visualizza l'elenco dei tipi di aspetto disponibili
Console
Nella console Google Cloud , vai alla pagina Tipi di metadati di Knowledge Catalog.
Fai clic sulla scheda Tipi di aspetto.
In questa pagina sono elencati tutti i tipi di aspetto di Knowledge Catalog disponibili.
- Per visualizzare i tipi di aspetti personalizzati, fai clic sulla scheda Personalizzati. Nella scheda Personalizzato, la colonna Origine catalogo mostra dove si trova la risorsa in Knowledge Catalog.
Per visualizzare i tipi di aspetto di sistema, fai clic sulla scheda Sistema.
Per ulteriori informazioni sui tipi di aspetti personalizzati e di sistema, consulta la sezione Categorie di tipi di aspetti di questo documento.
- (Facoltativo) Per visualizzare l'elenco dei tipi di aspetto nel progetto selezionato, fai clic sulla scheda Personalizzato, quindi fai clic sul pulsante di attivazione/disattivazione Mostra da tutti i progetti in modo che sia disattivato.
Il pulsante di attivazione/disattivazione Mostra da tutti i progetti è attivo per impostazione predefinita e l'elenco include le risorse di Knowledge Catalog dell'organizzazione selezionata.
gcloud
Per elencare tutti i tipi di aspetto disponibili, utilizza il comando gcloud dataplex
aspect-types list.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per elencare tutti i tipi di aspetto disponibili, utilizza il metodo
aspectTypes.list.
Visualizza i dettagli di un tipo di aspetto
Console
Nella console Google Cloud , vai alla pagina Tipi di metadati di Knowledge Catalog.
Fai clic sulla scheda Tipi di aspetto.
Per visualizzare i dettagli di un tipo di aspetto di Knowledge Catalog, fai clic sul tipo di aspetto. Si apre la pagina dei dettagli del tipo di aspetto, in cui puoi accedere ai dettagli, come nome visualizzato, ID tipo di aspetto, descrizione, ID progetto, località, etichette, data di creazione e data dell'ultima modifica.
- Per visualizzare la struttura del tipo di aspetto selezionato, fai clic sulla scheda Modello.
- Per visualizzare l'elenco delle 10 voci correlate create di recente, fai clic sulla scheda Voci di esempio.
- Per cercare tutte le voci correlate, fai clic su Mostra tutte le voci correlate nella ricerca. Questo pulsante viene visualizzato solo se esiste almeno una voce correlata.
gcloud
Per visualizzare i dettagli di un tipo di aspetto, utilizza il comando gcloud dataplex aspect-types
describe.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per ottenere i dettagli di un tipo di aspetto, utilizza il metodo aspectTypes.get.
Aggiorna un tipo di aspetto personalizzato
Puoi aggiornare il nome visualizzato, la descrizione, i campi del modello e le etichette di un tipo di aspetto personalizzato. Non puoi eliminare un campo esistente in un modello.
Non puoi aggiornare l'ID e la località del tipo di aspetto dopo averlo creato.
Console
Nella console Google Cloud , vai alla pagina Tipi di metadati di Knowledge Catalog.
Fai clic sulla scheda Tipi di aspetto.
Fai clic sul tipo di aspetto che vuoi aggiornare.
Nella pagina Dettagli tipo di aspetto, fai clic su Modifica.
Modifica il nome visualizzato, la descrizione, i campi del modello e le etichette, se necessario.
(Facoltativo) Per contrassegnare un campo nel tipo di aspetto come deprecato, segui questi passaggi:
- Nella sezione Modello, espandi il campo.
- Seleziona È deprecato.
- Nel campo Motivo della deprecazione, inserisci un motivo per la deprecazione del campo selezionato.
Fai clic su Fine.
Fai clic su Salva.
gcloud
Per aggiornare un tipo di aspetto personalizzato, utilizza il comando gcloud dataplex aspect-types
update.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per aggiornare un tipo di aspetto personalizzato, utilizza il metodo aspectTypes.patch.
Elimina un tipo di aspetto personalizzato
Console
Nella console Google Cloud , vai alla pagina Tipi di metadati di Knowledge Catalog.
Fai clic sulla scheda Tipi di aspetto.
Fai clic sul tipo di aspetto che vuoi eliminare.
Nella pagina Dettagli tipo di aspetto, fai clic su Elimina. Conferma quando ti viene richiesto.
gcloud
Per eliminare un tipo di aspetto personalizzato, utilizza il comando gcloud dataplex aspect-types
delete.
C#
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.
Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Per eliminare un tipo di aspetto personalizzato esistente, utilizza il metodo
aspectTypes.delete.
Passaggi successivi
- Scopri come cercare risorse in Knowledge Catalog.
- Scopri come gestire le voci e importare origini personalizzate.
- Scopri come importare i metadati in Knowledge Catalog.
- Scopri di più sui metadati in Knowledge Catalog.
- Scopri come stabilire un contesto dei dati di base.
- Prova i casi d'uso di Knowledge Catalog.