Gestire le voci e importare le origini personalizzate

Questo documento descrive come creare e gestire tipi di voci, gruppi di voci e voci personalizzate per consentire l'integrazione di origini dati personalizzate in Dataplex Universal Catalog.

Una voce rappresenta una risorsa per cui acquisisci i metadati. Un gruppo di voci è un contenitore di una o più voci, utilizzato per gestirecontrollo dell'accessoo e la località regionale. Un tipo di voce definisce i metadati obbligatori per le voci. I tipi di voce introducono struttura e regole in una risorsa di voce a flusso libero e definita in modo approssimativo, consentendo alle voci di essere estensibili.

Per integrare un'origine dati personalizzata in Dataplex Universal Catalog, crea una voce personalizzata utilizzando un tipo di voce personalizzato che si trova in un gruppo di voci personalizzato. La creazione di una voce personalizzata prevede i seguenti passaggi generali:

  1. Crea un gruppo di voci.
  2. Crea un tipo di voce.
  3. Crea una voce personalizzata per il tipo di voce all'interno del gruppo di voci.

Voci

Una voce rappresenta una risorsa di dati per la quale acquisisci i metadati. Ogni voce è un'istanza di un tipo di voce. Ogni operazione sugli aspetti di una voce deve rispettare gli aspetti obbligatori del tipo di voce. Ad esempio, quando crei una voce, devi fornire valori per tutti i tipi di aspetto definiti dal tipo di voce. Non puoi eliminare gli aspetti di una voce contrassegnati come required nel tipo di voce.

Categorie di voci

  • Voci di sistema: il Catalogo universale Dataplex crea voci per le risorse, come set di dati o tabelle BigQuery. Google CloudLe voci create da Dataplex Universal Catalog sono chiamate voci di sistema. Dataplex Universal Catalog mantiene automaticamente aggiornate le voci di sistema tramite la sincronizzazione continua dei metadati dai sistemi Google Cloud supportati.

    Non puoi modificare i metadati compilati automaticamente (chiamati aspetti obbligatori) per le voci di sistema. Puoi aggiungere e modificare metadati aggiuntivi per le voci di sistema solo utilizzando aspetti facoltativi. Per maggiori informazioni, vedi Categorie di aspetti.

  • Voci personalizzate: le voci che puoi creare e gestire per le risorse personalizzate sono chiamate voci personalizzate. Le risorse personalizzate sono le risorse nei servizi non Google ospitati in Google Cloud o esternamente (ad esempio on-premise).

Gruppi di voci

Un gruppo di voci è un contenitore per una o più voci. Puoi utilizzare i gruppi di voci per gestirecontrollo dell'accessoo e la località regionale per le voci. Ogni gruppo di voci appartiene a un progetto.

Categorie di gruppi di voci

  • Gruppi di voci di sistema: per le risorse, Dataplex Universal Catalog crea automaticamente gruppi di voci per ogni sistema in ogni progetto e posizione in cui si trovano le risorse. Google Cloud Ad esempio, @bigquery è il gruppo di voci di sistema per BigQuery.

  • Gruppi di voci personalizzati: gruppi di voci creati per risorse personalizzate.

Tipi di voci

I tipi di voce definiscono i metadati obbligatori per le voci di questo tipo, utilizzando un insieme di tipi di aspetto obbligatori.

Puoi specificare i tipi di aspetto obbligatori solo nelle voci e non nelle colonne di una voce. Quando crei una voce di un tipo specifico, devi fornire i valori per tutti i tipi di aspetti obbligatori specificati dal tipo di voce.

I tipi di aspetto obbligatori a cui viene fatto riferimento all'interno di un tipo di voce devono appartenere allo stesso progetto del tipo di voce.

Categorie di tipi di voci

  • Tipi di voci personalizzati: tipi di voci che crei e gestisci. Puoi utilizzare questi tipi di voci per creare voci personalizzate.

  • Tipi di voci di sistema: Dataplex Universal Catalog fornisce questi tipi di voci per impostazione predefinita. I tipi di voci di sistema sono ulteriormente suddivisi in riutilizzabili e con limitazioni.

    La seguente tabella descrive le categorie di tipi di voci di sistema e l'elenco dei tipi di voci che Dataplex Universal Catalog fornisce per ciascuna categoria:

    Categoria del tipo di voce di sistema Descrizione Tipi di voci forniti da Dataplex Universal Catalog
    Tipo di voce di sistema riutilizzabile Puoi utilizzare questo tipo di voce per creare voci personalizzate.
    • generic
    Tipo di voce di sistema con limitazioni Sono riservati all'uso del sistema, ad esempio per la creazione di voci per le risorseGoogle Cloud .

    Non puoi utilizzare questi tipi di voci per creare voci, ma puoi modificare le voci di questi tipi per aggiungere aspetti facoltativi.     		Inclusi a titolo esemplificativo:
    • analytics-hub-exchange
    • analytics-hub-listing
    • aspecttype
    • bigquery-dataset
    • bigquery-table
    • cloudsql-database
    • cloudsql-instance
    • cloudsql-table
    • entrygroup
    • entrytype
    • sql-access
    • storage
    • storage-bucket
    • storage-folder

Puoi creare un tipo di voce personalizzato in una posizione regionale specifica o come risorsa globale. La posizione di un tipo di voce influisce sull'ambito della sua applicabilità. Per ulteriori informazioni, vedi Vincoli di progetto e località.

I tipi di voci di sistema sono sempre globali. I tipi di voci di sistema vengono archiviati in un progetto gestito da Google con ID progetto 655216118709. Ad esempio, projects/655216118709/locations/global/entryTypes/bigquery-table.

Prima di iniziare

Prima di gestire le voci e importare origini dati personalizzate, assicurati di aver completato le attività descritte in questa sezione.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire le voci, chiedi all'amministratore di concederti i seguenti ruoli IAM sulla risorsa:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più, consulta la sezione Ruoli IAM per Dataplex Universal Catalog.

Abilita l'API

Abilita l'API Dataplex nel tuo progetto Dataplex Universal Catalog.

Abilitare l'API

Creare un gruppo di voci

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Gruppi di voci > Personalizzato.

  3. Fai clic su Crea gruppo di voci (Dataplex Catalog).

  4. Nella finestra Crea gruppo di voci, inserisci quanto segue:

    1. (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato per il gruppo di voci.
    2. ID gruppo di voci: inserisci un ID univoco per il gruppo di voci.
    3. (Facoltativo) Nel campo Descrizione, inserisci una descrizione per il gruppo di voci.
    4. Località: seleziona una località. Non puoi modificare la località dopo aver creato il gruppo di voci.

  5. (Facoltativo) Nella sezione Etichette, aggiungi etichette arbitrarie alle risorse sotto forma di coppie chiave-valore:

    1. Fai clic su Aggiungi etichetta.
    2. Nel campo Chiave, inserisci una chiave.
    3. Nel campo Valore, inserisci un valore per la chiave.
    4. Per aggiungere altre etichette, fai clic su Aggiungi etichetta e ripeti i passaggi.

  6. Fai clic su Salva.

gcloud

Per creare un gruppo di voci, utilizza il comando gcloud dataplex entry-groups create.

REST

Per creare un gruppo di voci, utilizza il metodo entryGroups.Create.

Creare un tipo di voce

Per importare una nuova fonte, devi creare un tipo di voce.

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Tipi di voci > Personalizzato.

  3. Fai clic su Crea.

  4. Nella finestra Crea tipo di voce, inserisci quanto segue:

    1. (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato per il tipo di voce.
    2. ID tipo di voce: inserisci un ID univoco per il tipo di voce. Non puoi modificare questa impostazione dopo aver creato il tipo di voce.
    3. (Facoltativo) Nel campo Descrizione, inserisci una descrizione per il tipo di voce.
    4. (Facoltativo) Nel campo Sistema, inserisci il sistema di origine.
    5. (Facoltativo) Nel campo Piattaforma, inserisci la piattaforma a cui appartengono le voci di questo tipo. Ad esempio, Google Cloud.
    6. Nel campo Località, seleziona una località. Non puoi modificare la posizione dopo aver creato il tipo di voce.

  5. (Facoltativo) Nella sezione Alias del tipo, definisci il tipo di dati per il tipo di voce. Il tipo di dati può essere utilizzato per eseguire query sulle voci.

    1. Fai clic su Aggiungi alias di tipo.
    2. Nel campo Alias tipo, seleziona un tipo di dati. Puoi aggiungere più alias di tipo.

  6. Nella sezione Tipi di aspetto obbligatori, seleziona i tipi di aspetto obbligatori per questo tipo di voce. A ogni voce creata in base a questo tipo verranno assegnati questi tipi di aspetto obbligatori. L'elenco dei tipi di aspetto richiesti non può essere modificato dopo la creazione del tipo di voce.

    1. Fai clic su Scegli tipo di aspetto.
    2. Nella finestra Seleziona tipi di aspetto, seleziona il tipo di aspetto.
    3. Fai clic su Seleziona.

    Non puoi eliminare gli aspetti obbligatori da una voce.

  7. (Facoltativo) Nella sezione Etichette, aggiungi etichette arbitrarie alle risorse sotto forma di coppie chiave-valore:

    1. Fai clic su Aggiungi etichetta.
    2. Nel campo Chiave, inserisci una chiave.
    3. Nel campo Valore, inserisci un valore per la chiave.
    4. Per aggiungere altre etichette, fai clic su Aggiungi etichetta e ripeti i passaggi.

  8. Fai clic su Salva.

gcloud

Per creare un tipo di voce, utilizza il comando gcloud dataplex entry-types create.

REST

Per creare un tipo di voce, utilizza il metodo entryTypes.create.

Creare una voce personalizzata

Prima di creare una voce personalizzata, assicurati di aver creato un gruppo di voci e un tipo di voce.

Console

La creazione di una voce personalizzata utilizzando la console Google Cloud non è supportata. Utilizza invece Google Cloud CLI o l'API.

gcloud

Per creare una voce personalizzata, utilizza il comando gcloud dataplex entries create.

REST

Per creare una voce personalizzata, utilizza il metodo entries.create.

Dopo aver creato una voce personalizzata, puoi aggiungervi aspetti. Per maggiori informazioni, consulta Aggiungere aspetti a una voce.

Gestire i gruppi di voci

Questa sezione descrive come visualizzare l'elenco dei gruppi di voci disponibili, visualizzare i dettagli, aggiornare ed eliminare i gruppi di voci.

Visualizzare l'elenco dei gruppi di voci disponibili

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Gruppi di voci.

    Questa pagina elenca tutti i gruppi di voci di Dataplex Universal Catalog e Data Catalog disponibili.

  3. Per visualizzare i gruppi di voci personalizzati, fai clic sulla scheda Personalizzato. Nella scheda Personalizzato, la colonna Origine catalogo mostra dove si trova la risorsa, ovvero Dataplex Universal Catalog o Data Catalog.

    Per visualizzare i gruppi di voci di sistema, fai clic sulla scheda Sistema.

    Per saperne di più sui gruppi di voci personalizzati e di sistema, consulta la sezione Categorie di gruppi di voci di questo documento.

  4. (Facoltativo) Per visualizzare l'elenco dei gruppi di voci nel progetto selezionato, fai clic sulla scheda Personalizzato, quindi sul pulsante di attivazione/disattivazione Mostra da tutti i progetti.

    Il pulsante di attivazione/disattivazione Mostra da tutti i progetti è attivo per impostazione predefinita e l'elenco include le risorse di Dataplex Universal Catalog dell'organizzazione selezionata e le risorse di Data Catalog di tutte le organizzazioni a cui puoi accedere.

gcloud

Per visualizzare l'elenco dei gruppi di voci disponibili, utilizza il comando gcloud dataplex entry-groups list.

REST

Per visualizzare l'elenco dei gruppi di voci disponibili, utilizza il metodo entryGroups.list.

Visualizzare i dettagli di un gruppo di voci

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Gruppi di voci.

  3. Fai clic sul gruppo di voci di cui vuoi visualizzare i dettagli.

    Si apre la pagina dei dettagli del gruppo di voci. Puoi accedere a informazioni quali nome visualizzato, ID gruppo di voci, descrizione, ID progetto, posizione, etichette, data di creazione e data dell'ultima modifica del gruppo di voci selezionato.

    Per un gruppo di voci di Data Catalog, puoi visualizzare i dettagli nelle interfacce web di Data Catalog e Dataplex Universal Catalog. Per farlo, nella pagina dei dettagli del gruppo di voci, fai clic su Data Catalog o Dataplex Catalog.

    La sezione Voci di esempio mostra 10 voci correlate create di recente nel gruppo di voci selezionato.

  4. (Facoltativo) Per visualizzare tutte le voci correlate a un gruppo di voci, nella sezione Voci di esempio, fai clic su Mostra tutte le voci correlate nella ricerca.

gcloud

Per recuperare i dettagli di un gruppo di voci, utilizza il comando gcloud dataplex entry-groups describe.

REST

Per recuperare i dettagli di un gruppo di voci, utilizza il metodo entryGroups.get.

Aggiorna un gruppo di voci

Puoi aggiornare un gruppo di voci personalizzato. I gruppi di voci di sistema non possono essere modificati.

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Gruppi di voci > Personalizzato.

  3. Fai clic sul gruppo di voci da aggiornare.

  4. Nella pagina Dettagli del gruppo di voci, fai clic su Modifica.

  5. Modifica il nome visualizzato, la descrizione e le etichette, se necessario.

  6. Fai clic su Salva.

gcloud

Per aggiornare un gruppo di voci, utilizza il comando gcloud dataplex entry-groups update.

REST

Per aggiornare un gruppo di voci, utilizza il metodo entryGroups.patch.

Eliminare un gruppo di voci

Puoi eliminare un gruppo di voci personalizzato. I gruppi di voci di sistema non possono essere eliminati.

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Gruppi di voci > Personalizzato.

  3. Fai clic sul gruppo di voci che vuoi eliminare.

  4. Nella pagina Dettagli gruppo di voci, fai clic su Elimina. Conferma quando richiesto.

gcloud

Per eliminare un gruppo di voci, utilizza il comando gcloud dataplex entry-groups delete.

REST

Per eliminare un gruppo di voci, utilizza il metodo entryGroups.delete.

Gestisci i tipi di voci

Questa sezione descrive come visualizzare l'elenco dei gruppi di voci disponibili, visualizzare i dettagli, aggiornare ed eliminare i tipi di voci.

Visualizza l'elenco dei tipi di voci disponibili

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Tipi di voci.

  3. Per visualizzare i tipi di voci personalizzati, fai clic sulla scheda Personalizzato. Per visualizzare i tipi di voci di sistema, fai clic sulla scheda Sistema. Per ulteriori informazioni sui tipi di voci personalizzate e di sistema, consulta la sezione Categorie di tipi di voci di questo documento.

  4. (Facoltativo) Per visualizzare l'elenco dei tipi di voce nel progetto selezionato, fai clic sulla scheda Personalizzato, quindi fai clic sul pulsante di attivazione/disattivazione Mostra in tutti i progetti per disattivarlo.

    Il pulsante di attivazione/disattivazione Mostra in tutti i progetti è attivo per impostazione predefinita e l'elenco include i tipi di voce di tutti i progetti.

gcloud

Per visualizzare l'elenco dei tipi di voci disponibili, utilizza il comando gcloud dataplex entry-types list.

REST

Per visualizzare l'elenco dei tipi di voci disponibili, utilizza il metodo entryTypes.list.

Visualizzare i dettagli di un tipo di voce

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Tipi di voci > Personalizzato.

  3. Fai clic sul tipo di voce di cui vuoi visualizzare i dettagli.

    Si apre la pagina dei dettagli del tipo di voce. Puoi accedere a informazioni come nome visualizzato, ID tipo di voce, descrizione, ID progetto, posizione, piattaforma, sistema, alias di tipo, etichette, data di creazione e data dell'ultima modifica del tipo di voce selezionato.

  4. (Facoltativo) Per visualizzare l'elenco delle 10 voci correlate create di recente, fai clic sulla scheda Voci di esempio.

  5. (Facoltativo) Per visualizzare tutte le voci correlate a un gruppo di voci, fai clic sulla scheda Voci di esempio e poi su Mostra tutte le voci correlate nella ricerca.

gcloud

Per recuperare i dettagli di un tipo di voce, utilizza il comando gcloud dataplex entry-types describe.

REST

Per recuperare i dettagli di un tipo di voce, utilizza il metodo entryTypes.get.

Aggiornare un tipo di voce

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Tipi di voci > Personalizzato.

  3. Fai clic sul tipo di voce che vuoi aggiornare.

  4. Nella pagina Dettagli del tipo di voce, fai clic su Modifica.

  5. Modifica il nome visualizzato, la descrizione, il sistema, la piattaforma, gli alias dei tipi e le etichette, in base alle esigenze.

  6. Fai clic su Salva.

gcloud

Per aggiornare un tipo di voce, utilizza il comando gcloud dataplex entry-types update.

REST

Per aggiornare un tipo di voce, utilizza il metodo entryTypes.patch.

Eliminare un tipo di voce

Console

  1. Nella console Google Cloud , vai alla pagina Catalogo di Dataplex Universal Catalog.

    Vai al catalogo

  2. Fai clic sulla scheda Tipi di voci > Personalizzato.

  3. Fai clic sul tipo di voce che vuoi eliminare.

  4. Nella pagina Dettagli tipo di voce, fai clic su Elimina. Conferma quando richiesto.

gcloud

Per eliminare un tipo di voce, utilizza il comando gcloud dataplex entry-types delete.

REST

Per eliminare un tipo di voce, utilizza il metodo entryTypes.delete.

Passaggi successivi