Data Catalog è deprecato. Se esegui la migrazione di workflow, script, librerie client o configurazioni Terraform programmatici da Data Catalog a Knowledge Catalog, devi aggiornare il codice per utilizzare l'API Dataplex.
Questo documento fornisce una mappatura completa delle risorse, delle funzionalità e dei metodi API Data Catalog ai loro equivalenti nell'API Dataplex.
Per la procedura di migrazione passo passo, vedi Transizione da Data Catalog a Knowledge Catalog. Per la documentazione di riferimento dell'API, consulta la documentazione dell'API Dataplex REST e la documentazione dell'API Dataplex RPC.
Mappatura delle risorse
La tabella seguente descrive la corrispondenza tra le risorse in Data Catalog e le risorse in Knowledge Catalog:
| Risorsa Data Catalog | Risorsa Knowledge Catalog | Descrizione |
|---|---|---|
| Modello di tag pubblico | Tipo di aspetto (global) |
I modelli di tag sono risorse regionali in Data Catalog che
possono essere utilizzati in più regioni. Corrispondono ai tipi di aspetto global in Knowledge Catalog. |
| Tag pubblico | Aspetto facoltativo | I tag pubblici corrispondono agli aspetti facoltativi collegati a una voce o a una colonna in Knowledge Catalog. |
| Gruppo di voci | Gruppo di voci | I gruppi di voci fungono da contenitori organizzativi e di sicurezza in entrambi i servizi. Per le origini Google Cloud , i gruppi di voci di sistema come
@bigquery vengono creati automaticamente per progetto. |
| Voce personalizzata | Voce personalizzata (con aspetti obbligatori) | Le proprietà di voce personalizzata standard sono modellate come aspetti obbligatori
definiti dal EntryType della voce personalizzata. |
| Voce di sistema (Google Cloud) | Voce di sistema (con gli aspetti obbligatori) | I metadati che descrivono le entità integrate (ad esempio Schema per le tabelle BigQuery) vengono acquisiti negli aspetti richiesti dei tipi di aspetti definiti dal sistema. |
| Glossari aziendali | Glossari aziendali | Tassonomie di termini aziendali che standardizzano il contesto aziendale in tutta l'impresa. |
Confronto delle funzioni
La seguente tabella confronta le funzionalità di gestione dei metadati di Knowledge Catalog e Data Catalog:
| Funzionalità | Knowledge Catalog | Data Catalog |
|---|---|---|
| Origini Google Cloud supportate | Tutte le fonti descritte in Origini Google Cloud supportate. | Tutte le origini descritte nella documentazione di Data Catalog. |
| Importazione di origini personalizzate | Importazione in voci personalizzate con struttura controllata definita dai tipi di voce. Le voci e i gruppi di voci personalizzati di Data Catalog vengono resi
disponibili in Knowledge Catalog con il
tipo di voce |
Inserimento in voci personalizzate generiche. |
| Arricchimento dei metadati | Acquisiti utilizzando glossari aziendali, aspetti e tipi di aspetto. I link di accesso sono supportati. Puoi allegare aspetti direttamente ai link delle voci. |
Acquisiti utilizzando glossari aziendali, tag e modelli di tag. I link di accesso non sono supportati. |
| Link alle voci | Supportato. I tipi integrati come synonym,
definition, related e
schema-join ti consentono di collegare voci e colonne. |
Non disponibile. |
| Feed di modifica dei metadati | Notifiche di modifica dei metadati quasi in tempo reale trasmesse in streaming a Pub/Sub. | Non disponibile. |
| Cerca | La ricerca viene eseguita su tutte le origini Google Cloud supportate, le voci personalizzate, gli aspetti e i contenuti di Data Catalog migrati all'interno della stessa organizzazione e dello stesso perimetro dei Controlli di servizio VPC. | La ricerca viene eseguita sulle origini supportate, sulle voci personalizzate e sui tag creati in Data Catalog. |
| Tracciabilità dei dati | Recupera i dettagli delle voci per i nodi delle risorse utilizzando l'API Dataplex. Mostra gli aspetti allegati nella console Google Cloud . | Recupera i dettagli della voce utilizzando l'API Data Catalog. |
| Glossari aziendali | Consente di creare tassonomie di termini aziendali e associarli sia a asset di dati (voci) sia a colonne. | Consente di associare i termini alle colonne. |
Mappare i metodi dell'API Data Catalog a Knowledge Catalog
Le tabelle seguenti forniscono una mappatura metodo per metodo tra l'API Data Catalog (google.cloud.datacatalog.v1) e l'API Dataplex (google.cloud.dataplex.v1.CatalogService).
Gruppi di voci
Il concetto di gruppi di voci è coerente in entrambi i servizi:
| Metodo API Data Catalog | Metodo API Dataplex |
|---|---|
projects.locations.entryGroups.create (REST)CreateEntryGroup (RPC) |
projects.locations.entryGroups.create (REST)CreateEntryGroup (RPC) |
projects.locations.entryGroups.get (REST)GetEntryGroup (RPC) |
projects.locations.entryGroups.get (REST)GetEntryGroup (RPC) |
projects.locations.entryGroups.patch (REST)UpdateEntryGroup (RPC) |
projects.locations.entryGroups.patch (REST)UpdateEntryGroup (RPC) |
projects.locations.entryGroups.delete (REST)DeleteEntryGroup (RPC) |
projects.locations.entryGroups.delete (REST)DeleteEntryGroup (RPC) |
projects.locations.entryGroups.list (REST)ListEntryGroups (RPC) |
projects.locations.entryGroups.list (REST)ListEntryGroups (RPC) |
Voci
Il concetto di voci, che rappresentano gli asset di dati, è coerente in entrambi i servizi:
| Metodo API Data Catalog | Metodo API Dataplex |
|---|---|
projects.locations.entryGroups.entries.create (REST)CreateEntry (RPC) |
projects.locations.entryGroups.entries.create (REST)CreateEntry (RPC) |
projects.locations.entryGroups.entries.get (REST)GetEntry (RPC) |
projects.locations.entryGroups.entries.get (REST)GetEntry (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
Nota:puoi anche utilizzare i metodi |
projects.locations.entryGroups.entries.delete (REST)DeleteEntry (RPC) |
projects.locations.entryGroups.entries.delete (REST)DeleteEntry (RPC) |
projects.locations.entryGroups.entries.list (REST)ListEntries (RPC) |
projects.locations.entryGroups.entries.list (REST)ListEntries (RPC) |
entries.lookup (REST)LookupEntry (RPC) |
projects.locations.lookupEntry (REST)LookupEntry (RPC)
Nota:per utilizzare |
projects.locations.entryGroups.entries.modifyEntryContacts (REST)ModifyEntryContacts (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC)
Nota: utilizza |
projects.locations.entryGroups.entries.modifyEntryOverview (REST)ModifyEntryOverview (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC)
Nota: utilizza |
projects.locations.entryGroups.entries.tags.reconcile (REST)ReconcileTags (RPC) |
projects.locations.metadataJobs.create (REST)CreateMetadataJob (RPC),projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC)
Nota:utilizza |
catalog.search (REST)SearchCatalog (RPC) |
projects.locations.searchEntries (REST)SearchEntries (RPC)
Nota: |
Modelli di tag e tipi di aspetti
I tipi di aspetti sono i successori dei modelli di tag di Data Catalog:
| Metodo API Data Catalog | Metodo API Dataplex |
|---|---|
projects.locations.tagTemplates.create (REST)CreateTagTemplate (RPC) |
projects.locations.aspectTypes.create (REST)CreateAspectType (RPC) |
projects.locations.tagTemplates.get (REST)GetTagTemplate (RPC) |
projects.locations.aspectTypes.get (REST)GetAspectType (RPC) |
projects.locations.tagTemplates.patch (REST)UpdateTagTemplate (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.delete (REST)DeleteTagTemplate (RPC) |
projects.locations.aspectTypes.delete (REST)DeleteAspectType (RPC) |
catalog.search (REST) con type=tag_templateSearchCatalog (RPC) con type=tag_template |
projects.locations.aspectTypes.list (REST)ListAspectTypes (RPC) |
Campi del modello di tag
I campi del modello di tag corrispondono ai contenuti del campo metadata_template
in un tipo di aspetto. Utilizza UpdateAspectType con metadata_template modificato
per creare, aggiornare, rinominare o eliminare campi:
| Metodo API Data Catalog | Metodo API Dataplex |
|---|---|
projects.locations.tagTemplates.fields.create (REST)CreateTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.patch (REST)UpdateTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.rename (REST)RenameTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.delete (REST)DeleteTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
Valori enum del campo del modello di tag
Modifica i valori enum aggiornando il campo metadata_template nel
tipo di aspetto corrispondente:
| Metodo API Data Catalog | Metodo API Dataplex |
|---|---|
projects.locations.tagTemplates.fields.enumValues.rename (REST)RenameTagTemplateFieldEnumValue (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
Tag e aspetti
Gli aspetti sono i successori dei tag Data Catalog. Gli aspetti sono incapsulati
direttamente nelle voci padre o nei link alle voci e vengono gestiti utilizzando il
metodo UpdateEntry con update_mask:
| Metodo API Data Catalog | Metodo API Dataplex |
|---|---|
projects.locations.entryGroups.entries.tags.create (REST)CreateTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
projects.locations.entryGroups.entries.tags.list (REST)ListTags (RPC) |
projects.locations.entryGroups.entries.get (REST)GetEntry (RPC)
Nota:per filtrare gli aspetti nella risposta, utilizza i parametri |
projects.locations.entryGroups.entries.tags.patch (REST)UpdateTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
projects.locations.entryGroups.entries.tags.delete (REST)DeleteTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
Tag di policy e tassonomie
Le API per i tag di criteri e le tassonomie non cambiano e non richiedono
la migrazione. Continuano a essere pubblicati nell'endpoint datacatalog.googleapis.com (servizio Policy Tag Manager). L'API Data Catalog
(datacatalog.googleapis.com) deve rimanere abilitata nei progetti che utilizzano
controllo dell'accesso a livello di colonna di BigQuery o il mascheramento dinamico dei dati.
Funzionalità non supportate in Knowledge Catalog
I seguenti comportamenti e funzionalità di Data Catalog non sono supportati o funzionano diversamente in Knowledge Catalog:
- Tipi di aspetto privati: il concetto di aspetti privati e tipi di aspetto privati (le controparti dei tag privati e dei modelli di tag privati in Data Catalog) non esiste. Tutti i tipi di aspetto personalizzati sono regolati dalle autorizzazioni Identity and Access Management per progetto e gruppo di voci.
- Ricerca di tag di policy: la ricerca di tag di policy utilizzando i predicati
policytagopolicytagidnon è supportata nella ricerca nel catalogo. - Trasferimento delle autorizzazioni: quando importi gruppi di voci personalizzati, voci personalizzate, modelli di tag e tag di Data Catalog in Knowledge Catalog, le autorizzazioni originali non vengono trasferite. Devi configurare le autorizzazioni IAM per le risorse importate. Per un confronto dettagliato delle autorizzazioni legacy e di sostituzione, consulta Mappare le autorizzazioni IAM tra Data Catalog e Knowledge Catalog.
- Risultati dell'ispezione di Sensitive Data Protection: l'invio dei risultati dell'ispezione di Sensitive Data Protection direttamente a Knowledge Catalog non è supportato. Invia invece i risultati dell'ispezione a Data Catalog e trasferiscili a Knowledge Catalog.
- Elenco dei tipi tra progetti: l'elenco dei tipi di voci, dei tipi di link delle voci e dei tipi di aspetti in più progetti in una singola chiamata API non è supportato; le richieste devono essere limitate a un singolo progetto.
- Ricerca dell'amministratore: la ricerca dell'amministratore (richiamo completo) non è supportata. In alternativa, esporta i metadati in Cloud Storage ed esegui query utilizzando BigQuery.
Passaggi successivi
Transizione da Data Catalog
Guida passo passo per eseguire la migrazione di modelli di tag, voci personalizzate e workflow.
Informazioni sui metadati in Knowledge Catalog
Scopri di più sul metamodello flessibile di Knowledge Catalog e sull'Active Context Graph.
Riferimento API REST Dataplex
Sfoglia la documentazione di riferimento dell'API REST per il servizio Dataplex Catalog.
Riferimento API RPC Dataplex
Sfoglia la documentazione di riferimento dell'API gRPC per il servizio Dataplex Catalog.