Gestisci le voci e importa 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 Dataplex.

Una voce rappresenta una risorsa per cui acquisisci i metadati. Un gruppo di voci è un container per una o più voci, utilizzato per gestire il controllo dell'accesso e in ogni località. Un tipo di voce definisce i metadati richiesti per le voci. Tipi di voce struttura e regole in una risorsa di accesso a flusso libero e non più chiaro, rendendo le voci estensibili.

Per integrare un'origine dati personalizzata in Dataplex, devi creare una utilizzando un tipo di voce personalizzata presente 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 un asset di dati per il quale acquisisci i metadati. Ogni voce è un'istanza di un tipo di voce. Ogni operazione sugli aspetti di una voce deve devono soddisfare gli aspetti richiesti per il tipo di voce. Ad esempio, quando crei una voce, devi fornire i valori per tutti i tipi di aspetto definiti dal tipo di voce. Non puoi eliminare questi aspetti per una voce contrassegnata come required nel tipo di voce.

Categorie di voci

• Voci di sistema: Dataplex crea voci per Google Cloud ad esempio set di dati o tabelle BigQuery. Le voci che Le creazioni di Dataplex sono chiamate voci di sistema. Dataplex mantiene automaticamente aggiornate le voci di sistema tramite metadati continui dai sistemi supportati da Google Cloud.

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

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

Gruppi di voci

Un gruppo di voci è un container per una o più voci. Puoi utilizzare i gruppi di voci per gestire il controllo dell'accesso e la località regionale per le voci. Ogni voce appartiene a un progetto.

Categorie di gruppi di voci

• Gruppi di voci di sistema: per le risorse Google Cloud, Dataplex crea automaticamente gruppi di voci per ogni sistema di ogni progetto la località in cui si trovano le risorse. Ad esempio, @bigquery è la voce di sistema per BigQuery.

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

Tipi di voci

I tipi di voce definiscono i metadati richiesti per le voci di questo tipo, utilizzando un set dei tipi di aspetto richiesti.

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

I tipi di aspetto obbligatori a cui viene fatto riferimento in un tipo di voce devono appartenere al lo stesso progetto del tipo di voce.

Categorie dei tipi di voce

• Tipi di voce personalizzati: i tipi di voce che crei e gestisci. Puoi utilizzare la modalità questi tipi di voce per creare voci personalizzate.

• Tipi di voci di sistema: Dataplex fornisce questi tipi di voci per impostazione predefinita. I tipi di voci di sistema sono ulteriormente classificati in riutilizzabili e limitato.

  La tabella seguente descrive le categorie dei tipi di voci di sistema e elenco dei tipi di voce forniti da Dataplex per ciascuna delle categorie:

  Categoria del tipo di voce di sistema	Descrizione	Tipi di voce forniti da Dataplex
  Tipo di voce di sistema riutilizzabile	Puoi utilizzare questo tipo di voce per creare voci personalizzate.	generic
  Tipo di voce di sistema con restrizioni	Questi sono riservati per l'uso da parte del sistema, come la creazione di voci per dell'accesso a specifiche risorse Google Cloud. Non puoi utilizzare questi tipi di voce per creare voci, ma puoi modificarle di questi tipi di voce per aggiungere aspetti facoltativi.	bigquery-connection bigquery-dataset bigquery-model bigquery-routine bigquery-table bigquery-view cloudsql-database cloudsql-instance cloudsql-schema cloudsql-table cloudsql-view sql-access storage storage-bucket storage-folder

Nota: le voci del tipo entrygroup rappresentano i gruppi di voci e sono quando viene creato un gruppo di voci. Puoi cercare voci di questo tipo. A differenza delle voci normali, non puoi eliminarle. Invece, devi eliminare il gruppo di voci.

Puoi creare un tipo di voce personalizzato in una località regionale specifica o come di una risorsa globale. I tipi di voci di sistema sono sempre globali. La posizione influisce sull'ambito della sua applicabilità. Per ulteriori informazioni, vedi Limiti di località e progetti.

Prima di iniziare

Prima di gestire le voci e importare origini dati personalizzate, assicurati di avere 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 seguenti ruoli IAM sulla risorsa:

• Set completo di autorizzazioni per voci, gruppi di voci e tipi di voci: Amministratore Dataplex Catalog (roles/dataplex.catalogAdmin)
• Crea e gestisci tutte le risorse Dataplex Catalog, tra cui voci, gruppi di voci e tipi di voci: Editor Dataplex Catalog (roles/dataplex.catalogEditor)
• Accesso completo alle operazioni relative all'accesso: Proprietario voci Dataplex (roles/dataplex.entryOwner)
• Visualizza voci, gruppi di voci, tipi di voci e criteri IAM associati: Visualizzatore Dataplex Catalog (roles/dataplex.catalogViewer)
• Quando crei voci personalizzate, utilizza i tipi di aspetto per crearne di nuovi: Utente tipo di aspetto Dataplex (roles/dataplex.aspectTypeUser)
• Crea e gestisci i gruppi di voci: Proprietario del gruppo di voci Dataplex (roles/dataplex.entryGroupOwner)
• Crea e gestisci i tipi di voce: Proprietario del tipo di voce Dataplex (roles/dataplex.entryTypeOwner)
• Utilizza i tipi di voce per creare e modificare voci di questi tipi: Utente tipo di voce Dataplex (roles/dataplex.entryTypeUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

Nota: quando utilizzi un tipo di voce per creare e modificare voci di quel tipo, se il tipo di voce e la voce si trova in progetti diversi, devi concedere Ruolo IAM Utente (roles/dataplex.entryTypeUser) del tipo di voce Dataplex nella progetto in cui è presente il tipo di voce.

Per ulteriori informazioni, vedi Ruoli IAM Dataplex.

Abilita l'API

Abilitare l'API Dataplex nel progetto Dataplex.

Abilitare l'API

Crea un gruppo di voci

Console

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

   Vai al catalogo

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

3. Fai clic su Crea.

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

   • (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato per gruppo di voci.
   • ID gruppo di voci: inserisci un ID univoco per il gruppo di voci.
   • (Facoltativo) Nel campo Descrizione, inserisci una descrizione per gruppo di voci.
   • Posizione: seleziona una posizione. Non puoi modificare la località dopo crei il gruppo di voci.

5. (Facoltativo) Nella sezione Etichette, aggiungi etichette arbitrarie come coppia chiave-valore. alle tue risorse:

   1. Fai clic su Aggiungi etichetta.
   2. Inserisci una chiave nel campo 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.

REST

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

Crea un tipo di voce

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

Console

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

   Vai al catalogo

2. Fai clic sulla scheda Tipi di voce > 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 tipo di voce.
   2. ID tipo di voce: inserisci un ID univoco per il tipo di voce. Non puoi modificarlo dopo aver creato il tipo di voce.
   3. (Facoltativo) Nel campo Descrizione, inserisci una descrizione per tipo di voce.
   4. (Facoltativo) Nel campo Sistema, inserisci il sistema di origine.
   5. (Facoltativo) Nel campo Piattaforma, inserisci la piattaforma per cui vengono inseriti i dati della piattaforma. di questo tipo appartengono. Ad esempio, Google Cloud.
   6. Nel campo Località, seleziona una località. Non puoi modificare 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 del tipo.
   2. Nel campo Digita alias, seleziona un tipo di dati. Puoi aggiungere più alias dei tipi.

6. Nella sezione Tipi di aspetto obbligatori, seleziona i tipi di aspetto che sono obbligatori per questo tipo di voce. Ogni voce creata in base a questo tipo verranno assegnati questi tipi di aspetto obbligatori.

   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 come coppia chiave-valore. alle tue risorse:

   1. Fai clic su Aggiungi etichetta.
   2. Inserisci una chiave nel campo 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.

REST

Per creare un tipo di voce, utilizza entryType.create .

Crea una voce personalizzata

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

Console

La creazione di una voce personalizzata non è supportata nella console Google Cloud. Utilizza invece Google Cloud CLI o tramite Google Cloud CLI o tramite l'API Compute Engine.

REST

Per creare una voce personalizzata, utilizza la entries.create .

Dopo aver creato una voce personalizzata, puoi aggiungere aspetti alla voce. Per ulteriori informazioni, vedi Aggiungere aspetti a una voce.

Gestisci gruppi di voci

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

Nota: i gruppi di voci provenienti da Data Catalog hanno il suffisso (Data Catalog). Non puoi modificare o eliminare questi gruppi di voci, ma puoi e gestire le relative autorizzazioni.

Visualizza l'elenco dei gruppi di voci disponibili

Console

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

   Vai al catalogo

2. Fai clic sulla scheda Gruppi di voci.

   Puoi accedere all'elenco di gruppi di voci di sistema e personalizzate. Per maggiori informazioni informazioni, consulta le categorie dei gruppi di voci di questo documento.

   Nella scheda Personalizzata, i gruppi di voci con il suffisso (Data Catalog) sono i gruppi di voci spostati da Data Catalog.

3. Per visualizzare l'elenco dei gruppi di voci in tutti i progetti, fai clic sull'icona Scheda Personalizzata, poi fai clic sul pulsante di attivazione/disattivazione Mostra da tutti i progetti per su On.

   Nota: se il pulsante di attivazione/disattivazione Mostra da tutti i progetti è attivo, non puoi modificare o eliminare direttamente un gruppo di voci. Devi invece fare clic su gruppo di voci per aprire la pagina dei dettagli del gruppo di voci, quindi modificare o eliminarlo.

REST

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

Visualizza i dettagli di un gruppo di voci

Console

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

   Vai al catalogo

2. Fai clic sulla scheda Gruppi di voci.

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

   Viene visualizzata la pagina dei dettagli del gruppo di voci. Puoi accedere a informazioni quali: nome visualizzato, ID gruppo di voci, descrizione, ID progetto, località, etichette data di creazione e data dell'ultima modifica del gruppo di voci selezionato.

4. Se il gruppo di voci proviene da Data Catalog, indicato con il suffisso (Data Catalog), puoi visualizzarne i dettagli in sia Data Catalog che Dataplex Catalog interfacce. Per farlo, nella pagina dei dettagli del gruppo di voci, seleziona Data Catalog o Dataplex Catalog.

5. Per visualizzare l'elenco delle 10 voci correlate create di recente: Fai clic sulla scheda Voci di esempio.

REST

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

Aggiorna un gruppo di voci

Console

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

   Vai al catalogo

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

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

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

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

6. Fai clic su Salva.

REST

Per aggiornare un gruppo di voci, utilizza la entryGroups.patch .

Elimina un gruppo di voci

Console

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

   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.

REST

Per eliminare un gruppo di voci, utilizza la entryGroups.delete .

Gestisci i tipi di voce

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

Visualizza l'elenco dei tipi di voce disponibili

Console

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

   Vai al catalogo

2. Fai clic sulla scheda Tipi di voce.

   Puoi accedere all'elenco di tipi di voci di sistema e personalizzate. Per maggiori informazioni informazioni, consulta le categorie dei tipi di voce di questo documento.

3. Per visualizzare l'elenco dei tipi di voce in tutti i progetti, fai clic sull' Scheda Personalizzata e fai clic sul pulsante di attivazione/disattivazione Mostra da tutti i progetti in posizione corretta.

   Nota: se il pulsante di attivazione/disattivazione Mostra da tutti i progetti è attivo, non puoi modificare o eliminare direttamente un tipo di voce. Devi invece fare clic su il tipo di voce per aprire la relativa pagina dei dettagli, quindi modifica o eliminarlo.

REST

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

Visualizzare i dettagli di un tipo di voce

Console

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

   Vai al catalogo

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

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

   Viene visualizzata la pagina dei dettagli sul tipo di voce. Puoi accedere a informazioni quali: nome visualizzato, ID tipo di voce, descrizione, ID progetto, località, piattaforma sistema, alias del tipo, etichette, data di creazione e data dell'ultima modifica il tipo di voce selezionato.

4. Per visualizzare l'elenco delle 10 voci correlate create di recente: Fai clic sulla scheda Voci di esempio.

REST

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

Aggiorna un tipo di voce

Console

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

   Vai al catalogo

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

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

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

5. Modifica nome visualizzato, descrizione, sistema, piattaforma, alias del tipo, ed etichette, se richiesto.

6. Fai clic su Salva.

REST

Per aggiornare un tipo di voce, utilizza la entryTypes.patch .

Elimina un tipo di voce

Console

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

   Vai al catalogo

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

3. Fai clic sul tipo di voce da eliminare.

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

REST

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

Passaggi successivi

• Scopri come cercare asset di dati in Dataplex Catalog.
• Scopri come gestire gli aspetti e arricchire i metadati.
• Scopri di più su Dataplex Catalog.