Gestire i prodotti di dati

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Questo documento è destinato ai proprietari di prodotti di dati che vogliono aggiornare, eliminare e concedere l'accesso ai prodotti di dati in Dataplex Universal Catalog.

Per saperne di più sull'architettura e sui concetti chiave dei prodotti di dati, consulta Informazioni sui prodotti di dati.

Prima di iniziare

1. Enable the Dataplex, BigQuery APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

Nota: questa guida presuppone che tu disponga di prodotti di dati esistenti da gestire. Per ulteriori informazioni sulla creazione e la configurazione dei prodotti di dati, consulta Creare prodotti di dati.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i prodotti di dati, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Autorizzazioni complete per creare, aggiornare, eliminare e gestire le autorizzazioni per i prodotti di dati: Dataplex Data Products Admin (roles/dataplex.dataProductAdmin)
• Aggiorna e gestisci i prodotti di dati esistenti: Editor di Dataplex Data Products (roles/dataplex.dataProductEditor)
• Aggiungi aspetti come schema, overview e contacts: Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner)
• Cerca e aggiungi asset: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
• Modifica i tipi di aspetto di sistema, ad esempio la documentazione e l'aspetto del contratto della cadenza di aggiornamento: Editor Dataplex Catalog (roles/dataplex.catalogEditor)

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 gestire i prodotti di dati. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire i prodotti di dati sono necessarie le seguenti autorizzazioni:

• Modifica il tipo di aspetto di sistema overview: dataplex.entryGroups.useOverviewAspect
• Modifica il tipo di aspetto di sistema refresh cadence: dataplex.entryGroups.useRefreshCadenceAspect

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Concedere l'accesso a un prodotto di dati

I proprietari dei prodotti dati devono renderli rilevabili e concedere i ruoli necessari, consentendo ai consumatori di cercare, visualizzare e richiedere l'accesso ai prodotti dati.

Per concedere ai consumatori di prodotti dati le autorizzazioni necessarie per interagire con il prodotto dati, concedi loro i seguenti ruoli IAM per la risorsa prodotto dati:

• Cerca i prodotti di dati e accedi a questi nella ricerca di Dataplex Universal Catalog: Dataplex Data Product Consumer (dataplex.dataProductsConsumer)
• Accesso di sola lettura per visualizzare le definizioni e i metadati dei prodotti di dati: Dataplex Data Product Viewer (dataplex.dataProductViewer)
• Richiedi l'accesso ai prodotti di dati: Dataplex Data Product Consumer (dataplex.dataProductsConsumer)

Quando un consumatore di un prodotto di dati richiede l'accesso a un prodotto di dati, il proprietario del prodotto di dati riceve una notifica via email.

Per concedere l'accesso:

1. Nella console Google Cloud , vai alla pagina Gruppi.

   Vai alla pagina Gruppi

2. Cerca il gruppo associato al livello di autorizzazione richiesto e selezionalo.

3. Fai clic su  Aggiungi membri.

4. Aggiungi l'entità.

5. Fai clic su Salva.

Per saperne di più, consulta Creare e gestire i Gruppi Google nella console Google Cloud .

Aggiornare un prodotto di dati

Puoi aggiornare i dettagli di base (ad esempio, nome, descrizione e dettagli del proprietario del prodotto di dati), gli asset, i gruppi di accesso, le autorizzazioni, il contratto, gli aspetti e la documentazione aggiuntiva per un prodotto di dati esistente.

Aggiornare i dettagli di base di un prodotto di dati

Console

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

   Vai a Prodotti di dati

2. Fai clic sul prodotto di dati da aggiornare.

3. Fai clic su Modifica prodotto di dati.

4. Aggiorna Nome prodotto di dati, Icona, Descrizione, Contatti proprietario ed Etichette in base alle esigenze.

5. Fai clic su Aggiorna prodotto di dati.

REST

Per aggiornare i dettagli di base di un prodotto di dati, utilizza il metodo dataProducts.patch.

Ad esempio, per aggiornare la descrizione di un prodotto di dati, invia la seguente richiesta PATCH:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

Sostituisci quanto segue:

• NEW_DESCRIPTION: una nuova descrizione per il prodotto dati
• PROJECT_ID: l'ID del tuo progetto Google Cloud
• LOCATION: la regione in cui esiste il prodotto di dati
• DATA_PRODUCT_ID: l'ID del tuo prodotto di dati

Aggiornare gli asset di un prodotto di dati

Console

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

   Vai a Prodotti di dati

2. Fai clic sul prodotto di dati per cui vuoi aggiornare gli asset.

3. Fai clic sulla scheda Asset.

4. Per aggiungere un nuovo asset:

   1. Fai clic su +Aggiungi.

   2. Cerca e seleziona gli asset che vuoi aggiungere al tuo prodotto di dati. Gli asset selezionati devono trovarsi nella stessa regione del prodotto di dati.

      Se disponi delle autorizzazioni necessarie, puoi visualizzare i metadati degli asset facendo clic sull'asset.

   3. Per perfezionare i risultati di ricerca, utilizza i filtri.

   4. Dopo aver selezionato gli asset, fai clic su Aggiungi.

5. Per rimuovere un asset dal prodotto dati:

   1. Per l'asset che vuoi rimuovere, fai clic su > Rimuovi.

   2. Per confermare l'azione, fai clic su Rimuovi.

REST

Per aggiungere un nuovo asset di dati al prodotto di dati, utilizza il metodo dataAssets.create. Per un esempio di codice, vedi (Facoltativo) Aggiungere asset.

Per eliminare un asset di dati dal prodotto di dati, utilizza il metodo dataAssets.delete. Ad esempio, invia la seguente richiesta DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud
• LOCATION: la regione in cui vuoi creare il prodotto di dati
• DATA_PRODUCT_ID: un ID univoco per il tuo prodotto di dati
• DATA_ASSET_ID: l'ID dell'asset di dati che vuoi rimuovere dal prodotto di dati

Aggiornare i gruppi di accesso e le autorizzazioni per gli asset

Console

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

   Vai a Prodotti di dati

2. Fai clic sul prodotto di dati per cui vuoi aggiornare i gruppi di accesso e le autorizzazioni.

3. Fai clic sulla scheda Gruppi di accesso e autorizzazioni.

4. Per aggiornare un gruppo di accesso:

   1. Fai clic su Modifica.

   2. Aggiorna il nome, la descrizione e l'identificatore del gruppo di accesso in base alle esigenze.

   3. Per aggiungere un nuovo gruppo di accesso, fai clic su Aggiungi gruppo di accesso e segui questi passaggi:

      1. Nel campo Nome gruppo di accesso, inserisci un nome per il nuovo gruppo di accesso. Ad esempio, Analyst.

      2. Nel campo Descrizione gruppo di accesso, inserisci una descrizione per il gruppo di accesso.

      3. Nel campo Identificatore gruppo di accesso, inserisci l'indirizzo email di un gruppo Google che vuoi assegnare a questo gruppo di accesso. I consumer del prodotto di dati che richiedono l'accesso a questo gruppo di accesso possono essere aggiunti come membri al gruppo Google mappato.

         Puoi aggiungere un massimo di tre gruppi di accesso per prodotto di dati.

   4. Fai clic su Aggiungi.

5. Per rimuovere un gruppo di accesso:

   1. Per il gruppo di accesso che vuoi rimuovere, fai clic su > Rimuovi.

   2. Per confermare l'azione, fai clic su Rimuovi.

6. Se non sono configurati gruppi di accesso per il prodotto dati selezionato, puoi aggiungere un nuovo gruppo di accesso facendo clic su Aggiungi gruppo di accesso.

7. Per aggiornare le autorizzazioni degli asset:

   1. Per l'asset per cui vuoi aggiornare le autorizzazioni, fai clic su > Autorizzazioni.

   2. Aggiorna i gruppi di accesso e i ruoli IAM richiesti.

   3. Fai clic su Configura.

REST

Per aggiornare i gruppi di accesso associati a un prodotto di dati, utilizza il metodo dataProducts.patch. Per un esempio di codice, consulta Configurare i gruppi di accesso.

Per aggiornare le autorizzazioni dell'asset, utilizza il metodo dataAssets.patch. Per un esempio di codice, consulta Configurare le autorizzazioni degli asset.

Aggiorna il contratto del prodotto di dati

Nota: la cadenza di aggiornamento non è modificabile dopo l'aggiunta al contratto. Se provi a modificare questo valore, viene visualizzato il seguente errore: You don't have permission to change contract values.

Console

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

   Vai a Prodotti di dati

2. Fai clic sul prodotto di dati per cui vuoi aggiornare il contratto.

3. Fai clic sulla scheda Contratto.

4. Per aggiornare il contratto esistente:

   1. Fai clic su Modifica.

   2. Aggiorna i campi necessari.

   3. Fai clic su Salva.

5. Se al prodotto di dati selezionato non è allegato alcun contratto, puoi aggiungerne uno facendo clic su Aggiungi contratto.

REST

Per aggiornare un contratto, utilizza il metodo entries.patch. Per un esempio di codice, vedi Aggiungi un contratto.

Aggiornare gli aspetti di un prodotto di dati

Console

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

   Vai a Prodotti di dati

2. Fai clic sul prodotto di dati per cui vuoi aggiornare gli aspetti.

3. Fai clic sulla scheda Aspetti.

4. Per aggiornare un aspetto:

   1. Fai clic sull'aspetto da aggiornare.

   2. Fai clic su Modifica.

   3. Aggiorna Tipo di aspetto, Paese e Regione in base alle esigenze.

   4. Fai clic su Salva.

5. Per aggiungere un nuovo aspetto al prodotto di dati:

   1. Fai clic su + Aggiungi aspetto.

   2. Nel campo Seleziona tipo di aspetto, cerca e seleziona un tipo di aspetto dall'elenco. Ad esempio, Geo context.

   3. Nel campo Paese, seleziona il paese a cui appartiene l'asset.

   4. Nel campo Regione, seleziona la regione aziendale a cui appartiene l'asset.

   5. Fai clic su Salva.

6. Per eliminare un aspetto:

   1. Fai clic sull'aspetto che vuoi eliminare.

   2. Fai clic su .

   3. Per confermare l'azione, fai clic su Conferma.

REST

Per aggiornare qualsiasi aspetto della voce del prodotto di dati, utilizza il metodo entries.patch.

Aggiorna la documentazione del prodotto di dati

Console

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

   Vai a Prodotti di dati

2. Fai clic sul prodotto di dati per cui vuoi aggiornare la documentazione.

3. Fai clic sulla scheda Panoramica.

4. Fai clic su Modifica accanto a Documentazione.

5. Aggiorna la guida dell'utente, le query di esempio e altra documentazione in base alle esigenze.

6. Fai clic su Salva.

REST

La documentazione fa parte dell'aspetto overview. Per aggiornare la documentazione del prodotto di dati, utilizza il metodo entries.patch.

Eliminare un prodotto di dati

Per eliminare un prodotto di dati, devi prima rimuovere tutti gli asset dal prodotto di dati.

Console

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

   Vai a Prodotti di dati

2. Fai clic sul prodotto di dati che vuoi eliminare.

3. Fai clic sulla scheda Asset.

4. Per ogni asset elencato, fai clic su > Rimuovi. Conferma l'azione facendo clic su Rimuovi.

5. Dopo aver rimosso tutti gli asset, elimina il prodotto di dati facendo clic su Elimina.

6. Nella finestra di dialogo di conferma, inserisci delete e fai clic su Elimina.

REST

Per eliminare un prodotto di dati, utilizza il metodo dataProducts.delete.

Ad esempio, invia la seguente richiesta DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud
• LOCATION: la regione in cui esiste il prodotto di dati
• DATA_PRODUCT_ID: l'ID del prodotto di dati che vuoi eliminare

Passaggi successivi

• Scopri come cercare i prodotti di dati.
• Scopri come richiedere l'accesso ai prodotti di dati.