Data Catalog è deprecato. Se esegui la migrazione di flussi di lavoro programmatici, script, librerie client o configurazioni Terraform 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 di Data Catalog ai relativi equivalenti nell'API Dataplex.
Per la procedura di migrazione passo passo, consulta Transizione da Data Catalog a Knowledge Catalog. Per la documentazione di riferimento dell'API, consulta la documentazione dell'API REST Dataplex e la documentazione dell'API RPC Dataplex.
Mappatura delle risorse
La seguente tabella descrive la corrispondenza tra le risorse di Data Catalog e quelle di 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 utilizzate in tutte le regioni. Corrispondono ai global tipi di aspetto
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
servizi. Per le Google Cloud origini, i gruppi di voci di sistema come
@bigquery vengono creati automaticamente per progetto. |
| Voce personalizzata | Voce personalizzata (con aspetti obbligatori) | Le proprietà delle voci personalizzate standard vengono modellate come aspetti obbligatori
definiti da EntryType della voce personalizzata. |
| Voce di sistema (Google Cloud) | Voce di sistema (con aspetti obbligatori) | I metadati che descrivono le entità integrate (ad esempio Schema per
le tabelle BigQuery) vengono acquisiti negli aspetti obbligatori dei
tipi di aspetto definiti dal sistema. |
| Glossari aziendali | Glossari aziendali | Tassonomie di termini aziendali che standardizzano il contesto aziendale in tutta l' azienda. |
Confronto delle funzionalità
La seguente tabella mette a confronto le funzionalità di gestione dei metadati di Knowledge Catalog e Data Catalog:
| Funzionalità | Knowledge Catalog | Data Catalog |
|---|---|---|
| Origini supportate Google Cloud | Tutte le origini descritte in Origini supportate Google Cloud . | Tutte le origini descritte nella documentazione di Data Catalog. |
| Importazione di origini personalizzate | Importazione in voci personalizzate con struttura regolamentata definita dai tipi di voci. Le voci personalizzate e i gruppi di voci di Data Catalog sono resi
disponibili in Knowledge Catalog con il
|
Importazione in voci personalizzate generiche. |
| Arricchimento dei metadati | Acquisito utilizzando glossari aziendali, aspetti e tipi di aspetti. I link alle voci sono supportati. Puoi collegare gli aspetti direttamente ai link alle voci. |
Acquisito utilizzando glossari aziendali, tag e modelli di tag. I link alle voci non sono supportati. |
| Link alle voci | Supportati. I tipi integrati come synonym,
definition, related, e
schema-join consentono di collegare voci e colonne. |
Non disponibile. |
| Feed di modifica dei metadati | Notifiche di modifica dei metadati in tempo reale trasmesse in streaming a Pub/Sub. | Non disponibile. |
| Cerca | La ricerca viene eseguita su tutte le origini supportate Google Cloud , 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 degli asset utilizzando l'API Dataplex. Visualizza gli aspetti collegati nella Google Cloud console. | Recupera i dettagli delle voci utilizzando l'API Data Catalog. |
| Glossari aziendali | Consente di creare tassonomie di termini aziendali e associarli con sia agli asset di dati (voci) sia alle colonne. | Consente di associare i termini alle colonne. |
Mappare i metodi API Data Catalog a Knowledge Catalog
Le seguenti tabelle 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 dei modelli di tag
I campi dei modelli 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 i 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 di enumerazione dei campi dei modelli di tag
Modifica i valori di enumerazione 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 di Data Catalog. Gli aspetti sono incapsulati direttamente nelle voci o nei link alle voci principali 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 e tassonomie di policy
Le API per i tag e le tassonomie di policy non cambiano e non richiedono la migrazione.
Funzionalità non supportate in Knowledge Catalog
I seguenti comportamenti e funzionalità di Data Catalog non sono supportati o funzionano in modo diverso in Knowledge Catalog:
- Tipi di aspetti privati: il concetto di aspetti privati e tipi di aspetti privati (le controparti dei tag privati e dei modelli di tag privati in Data Catalog) non esiste. Tutti i tipi di aspetti personalizzati sono regolamentati dalle autorizzazioni di Identity and Access Management per progetti e gruppi 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 in Knowledge Catalog i gruppi di voci personalizzati, le voci personalizzate, i modelli di tag e i tag di Data 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 diretto dei risultati dell'ispezione di Sensitive Data Protection a Knowledge Catalog non è supportato. In alternativa, invia i risultati dell'ispezione a Data Catalog ed esegui la transizione dei risultati a Knowledge Catalog.
- Elenco dei tipi di progetti: l'elenco dei tipi di voci, dei tipi di link alle voci e dei tipi di aspetti tra i 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 flussi di lavoro.
Informazioni sui metadati in Knowledge Catalog
Scopri di più sul metamodello flessibile di Knowledge Catalog e sul grafico del contesto attivo.
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.