Gestire le schede

In qualità di publisher Analytics Hub, puoi eseguire le seguenti attività:

• Crea schede in uno scambio di dati per cui disponi dell'accesso con diritti di pubblicazione.
• Aggiornare, eliminare, condividere e visualizzare le metriche di utilizzo per le schede.
• Gestisci i diversi ruoli per le schede Analytics Hub, ad esempio amministratori, abbonati e visualizzatori.
• Visualizza tutti gli iscritti che si sono iscritti alla tua scheda.
• Monitora l'utilizzo delle tue schede.
• Rimuovi gli abbonati dalla tua scheda.

Una scheda è un riferimento a un set di dati condiviso che un editore elenca in uno scambio di dati. Una scheda può essere dei due tipi seguenti in base al criterio IAM (Identity and Access Management) impostato per la scheda e al tipo di scambio di dati che la contiene:

• Scheda pubblica. Può essere scoperta e sottoscritta dagli utenti Google Cloud (allAuthenticatedUsers). Le schede in uno scambio di dati pubblico sono schede pubbliche. Queste schede possono fare riferimento a un set di dati pubblico gratuito o a un set di dati commerciale. Se la scheda fa parte di un set di dati commerciale, gli abbonati possono richiedere l'accesso alla scheda e il fornitore di dati contatta questi abbonati.

• Scheda privata. Vengono condivisi direttamente con individui o gruppi. Ad esempio, una scheda privata può fare riferimento al set di dati delle metriche di marketing che condividi con altri team interni all'interno della tua organizzazione. Anche se puoi consentire a allAuthenticatedUsers di iscriversi alle tue schede, la scheda rimarrà privata e non verrà visualizzata come scheda pubblica nella pagina Analytics Hub. Per condividere queste schede con gli utenti, condividi con loro l'URL della scheda. Per rendere rilevabile una scheda privata, devi rendere la piattaforma di scambio pubblica.

Prima di iniziare

Per iniziare a utilizzare Analytics Hub, devi abilitare l'API Analytics Hub all'interno del tuo progetto Google Cloud.

Autorizzazioni obbligatorie

Per abilitare l'API Analytics Hub, devi disporre delle seguenti autorizzazioni IAM (Identity and Access Management):

• serviceUsage.services.get
• serviceUsage.services.list
• serviceUsage.services.enable

Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per abilitare l'API Analytics Hub:

• roles/serviceusage.serviceUsageAdmin

Per ulteriori informazioni sui ruoli IAM in BigQuery, vedi Ruoli e autorizzazioni predefiniti.

Abilitare l'API Analytics Hub

Per attivare l'API Analytics Hub:

Console

Vai all'API Analytics Hub per il tuo progetto Google Cloud e abilitalo.

Abilitare l'API Analytics Hub

gcloud

Esegui il comando gcloud services enabled:

gcloud services enable analyticshub.googleapis.com

Autorizzazioni obbligatorie

Per gestire schede e abbonamenti, devi disporre di uno dei seguenti ruoli di Analytics Hub:

• Ruolo di publisher di Analytics Hub (roles/analyticshub.publisher), che ti consente di creare, aggiornare, eliminare e impostare criteri IAM nelle tue schede.

• Amministratore schede di Analytics Hub (roles/analyticshub.listingAdmin), che consente di aggiornare, eliminare e impostare criteri IAM nelle schede.

• Ruolo Amministratore Analytics Hub (roles/analyticshub.Admin), che consente di creare, aggiornare, eliminare e impostare i criteri IAM su tutte le schede nello scambio di dati.

Per saperne di più, consulta Ruoli utente di Analytics Hub. Per scoprire come concedere questi ruoli ad altri utenti, consulta Creare un amministratore delle schede.

Inoltre, per creare schede, devi disporre anche delle autorizzazioni bigquery.datasets.get e bigquery.datasets.update per i set di dati per i quali vuoi creare schede. I seguenti ruoli predefiniti di BigQuery contengono l'autorizzazione bigquery.datasets.update:

• Ruolo Proprietario dati BigQuery (roles/bigquery.dataOwner)
• Ruolo Amministratore BigQuery (roles/bigquery.admin)

Per visualizzare tutti gli scambi di dati nei progetti di un'organizzazione a cui hai accesso, devi disporre dell'autorizzazione resourcemanager.organizations.get. Non esistono ruoli predefiniti di BigQuery contenenti questa autorizzazione, quindi dovrai utilizzare un ruolo personalizzato IAM.

Visualizza scambi di dati

Per visualizzare l'elenco degli scambi di dati nella tua organizzazione a cui hai accesso, consulta Visualizzare gli scambi di dati. Se lo scambio di dati è in un'altra organizzazione, l'amministratore di Analytics Hub deve condividere con te un link a quello scambio di dati.

Crea una scheda

Una scheda è un riferimento a un set di dati condiviso elencato da un editore in uno scambio di dati.

Attenzione: ti consigliamo di non aggiungere i set di dati condivisi in un progetto con un perimetro dei Controlli di servizio VPC. In questo caso, devi aggiungere le regole in entrata e in uscita appropriate.

Per creare una scheda, procedi nel seguente modo:

Console

1. Vai alla pagina Analytics Hub.

   Vai ad Analytics Hub

   Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.

2. Fai clic sul nome dello scambio di dati in cui vuoi creare la scheda.

3. Fai clic su Crea scheda.

4. Nella pagina Crea scheda, in Nome visualizzato, inserisci il nome della scheda.

5. Se stai creando un set di dati commerciale, devi compilare il campo Richiedi contatto di accesso. Devi inserire un'email o un URL del modulo di richiesta per consentire agli abbonati di contattarti.

6. (Facoltativo) Inserisci i seguenti dettagli:

   • Contatto principale: inserisci un indirizzo email o un URL del contatto principale per la scheda.

   • Categoria: seleziona fino a due categorie che rappresentano al meglio la tua scheda. Gli abbonati possono filtrare le schede in base a queste categorie.

   • Provider: espandi la sezione Provider e specifica i dettagli nei seguenti campi:

     • Nome provider: il nome del fornitore del set di dati.
     • Contatto principale del fornitore: un'email o un URL del contatto principale del provider di set di dati.

     Gli abbonati possono filtrare le schede in base ai fornitori di dati.

   • Editore: espandi la sezione Editore e specifica i dettagli nei seguenti campi:

     • Nome editore: il nome del publisher che sta creando la scheda.
     • Contatto principale del publisher: un'email o un URL del set di dati del contatto principale del publisher.

   • Icona: un'icona per la tua scheda. Sono supportati i formati file PNG e JPEG. Le icone devono avere file di dimensioni inferiori a 512 KiB e dimensioni non superiori a 512 x 512 pixel.

   • Descrizione: una breve descrizione della tua scheda. Gli abbonati possono cercare le schede in base alla descrizione.

7. In Set di dati di origine, seleziona il set di dati da elencare nello scambio di dati. Il set di dati di origine deve trovarsi nella stessa regione dello scambio di dati. Non puoi aggiornare questo campo dopo aver creato la scheda.

   Importante: il nome del set di dati di origine e l'ID del progetto che contiene il set di dati vengono restituiti quando i sottoscrittori visualizzano i metadati del set di dati collegato.

8. In Traffico in uscita dai dati, seleziona l'opzione appropriata per il traffico in uscita. Solo gli abbonati con offerte diverse dalla versione o Enterprise Plus possono eseguire query sui dati con restrizioni relative al traffico in uscita dei dati.

   • Per applicare restrizioni al traffico in uscita dai dati al set di dati condiviso, ma non ai risultati della query sul set di dati condiviso, seleziona Disabilita la copia e l'esportazione dei dati condivisi.
   • Per applicare restrizioni al traffico in uscita dai dati al set di dati condiviso e ai risultati delle query del set di dati condiviso, seleziona Disattiva copia ed esportazione dei risultati delle query. L'opzione Disattiva copia ed esportazione dei dati condivisi verrà impostata automaticamente.
   • Per applicare le restrizioni relative al traffico in uscita dalla copia e all'esportazione delle API di dati sul set di dati condiviso, seleziona Disattiva la copia e l'esportazione delle tabelle tramite le API. L'opzione Disattiva copia ed esportazione dei dati condivisi verrà impostata automaticamente.

9. (Facoltativo) Nella sezione Documentazione > Markdown puoi inserire ulteriori informazioni, ad esempio query di esempio che puoi eseguire sul set di dati, link a eventuale documentazione pertinente e qualsiasi informazione aggiuntiva che possa aiutare gli abbonati a utilizzare il tuo set di dati.

10. Fai clic su Salva.

API

Utilizza il metodo projects.locations.dataExchanges.listings.create.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto contenente lo scambio di dati in cui vuoi creare la scheda.
• LOCATION: la località dello scambio di dati. Per ulteriori informazioni sulle località che supportano Analytics Hub, consulta Regioni supportate.
• DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati.
• LISTING_ID: l'ID scheda.

Nel corpo della richiesta, fornisci i dettagli della scheda. Se la richiesta ha esito positivo, il corpo della risposta conterrà i dettagli dell'elenco.

Per maggiori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta i metodi di projects.locations.dataExchanges.listings.

Concedere agli utenti l'accesso a una scheda

Se vuoi concedere agli utenti l'accesso a una scheda privata, devi impostare un criterio IAM per un singolo utente o un gruppo della scheda. Per una scheda commerciale, lo scambio di dati deve essere pubblico. Le schede in uno scambio di dati pubblico vengono visualizzate in Analytics Hub per tutti gli utenti Google Cloud (allAuthenticatedUsers). Per consentire agli utenti di richiedere l'accesso per le schede commerciali, devi concedere agli utenti il ruolo Visualizzatore Analytics Hub.

Per concedere agli utenti l'accesso per visualizzare o abbonarsi alla tua scheda, procedi nel seguente modo:

Console

1. Vai alla pagina Analytics Hub.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio di dati che contiene la scheda.

3. Fai clic sulla scheda alla quale vuoi aggiungere abbonati.

4. Fai clic su Imposta autorizzazioni.

5. Per aggiungere entità, fai clic su Aggiungi entità.

6. Nel campo Nuove entità, aggiungi i seguenti dettagli in base al tipo di elenco:

   • Per una scheda privata, inserisci gli indirizzi email dell'identità a cui vuoi concedere l'accesso.

   • Per una scheda pubblica, aggiungi allAuthenticatedUsers.

7. Per Seleziona un ruolo, tieni il puntatore del mouse su Analytics Hub e poi, in base al tipo di scheda, seleziona uno dei seguenti ruoli:

   • Per una scheda commerciale, seleziona il ruolo Visualizzatore Analytics Hub. Questo ruolo consente agli utenti di visualizzare la scheda e richiedere l'accesso.

   • Per una scheda pubblica privata o non commerciale, seleziona il ruolo Abbonato ad Analytics Hub. Questo ruolo consente agli utenti di iscriversi alla tua scheda.

   Per ulteriori informazioni, consulta i ruoli di abbonato e Visualizzatore Analytics Hub.

8. Fai clic su Salva.

API

1. Leggi la norma esistente con il metodo getIamPolicy per elencare gli utenti utilizzando il metodo projects.locations.dataExchanges.listings.getIamPolicy.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto, ad esempio my-project-1.
   • LOCATION: la posizione dello scambio di dati che contiene la scheda.
   • DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati.
   • LISTING_ID: l'ID scheda.

   Analytics Hub restituisce il criterio corrente nella risposta.

2. Per aggiungere o rimuovere i membri e i relativi ruoli, modifica il criterio con un editor di testo. Utilizza il seguente formato per aggiungere membri:

   • user:[e-mail]
   • group:[e-mail]
   • serviceAccount:[e-mail]
   • domain:example.domain.com

   Ad esempio, per concedere il ruolo roles/analyticshub.subscriber a group:[e-mail], aggiungi la seguente associazione al criterio:

   {
    "members": [
      "group:[e-mail]"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Scrivi il criterio aggiornato utilizzando il metodo projects.locations.dataExchanges.listings.setIamPolicy. Nel corpo della richiesta, fornisci il criterio IAM aggiornato nel passaggio precedente.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy
   

   Nel corpo della richiesta, fornisci i dettagli della scheda. Se la richiesta ha esito positivo, il corpo della risposta conterrà i dettagli dell'elenco.

Per maggiori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta i metodi di projects.locations.dataExchanges.listings.

Nota: dopo aver concesso le licenze agli utenti per l'accesso alla tua scheda commerciale, puoi creare una scheda privata per questi utenti o concedere loro il ruolo di Abbonato Analytics Hub per la tua scheda commerciale.

Crea un amministratore della scheda

Per consentire agli utenti di gestire le schede, devi creare amministratori delle schede Analytics Hub. Per creare amministratori delle schede, devi concedere agli utenti il ruolo Publisher Analytics Hub o Amministratore schede di Analytics Hub a livello di scheda. Per ulteriori informazioni su come concedere questi ruoli per una scheda, vedi Concedere il ruolo per una scheda.

Visualizza tutti gli abbonamenti

Per visualizzare tutti gli abbonamenti correnti alla tua scheda, seleziona una delle seguenti opzioni:

Console

1. Vai alla pagina Analytics Hub.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio di dati che contiene la scheda per cui vuoi gestire gli abbonamenti.

3. Fai clic sulla scheda per cui desideri elencare tutti gli iscritti.

4. Per visualizzare tutti gli iscritti della tua scheda, fai clic su Gestisci abbonamenti.

   

5. (Facoltativo) Puoi filtrare i risultati in base ai dettagli dell'iscritto.

In alternativa, se hai accesso al set di dati condiviso, puoi seguire questi passaggi per elencare gli abbonati:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e seleziona il set di dati condiviso.

3. Nell'elenco Condivisione di , seleziona Gestisci iscrizioni.

SQL

L'esempio seguente utilizza la vista INFORMATION_SCHEMA.SCHEMATA_LINKS per elencare tutti i set di dati collegati a un set di dati condiviso in myproject che si trovano nella regione us:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

L'output è simile al seguente. Alcune colonne vengono omesse per semplificare l'output.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

Utilizza il projects.locations.dataExchanges.listings.listSubscriptions.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto della scheda a cui vuoi iscriverti.
• LOCATION: la posizione della scheda a cui vuoi abbonarti.
• DATAEXCHANGE_ID: l'ID Data Exchange contenente la scheda a cui vuoi abbonarti.
• LISTING_ID: l'ID della scheda a cui vuoi iscriverti.

Rimuovere una sottoscrizione

Quando rimuovi dalle schede un abbonamento creato prima del 25 luglio 2023, il set di dati collegato viene scollegato dal set di dati condiviso. I sottoscrittori possono ancora visualizzare i set di dati nei loro progetti, ma non sono più collegati al set di dati condiviso.

Per rimuovere dalle tue schede un abbonamento creato prima del 25 luglio 2023:

1. Per elencare tutti gli abbonati di una scheda, segui le istruzioni della console Google Cloud in Visualizzare tutti gli abbonamenti.

2. Per rimuovere un abbonato da una scheda, fai clic su Elimina. Se vuoi rimuovere tutte le sottoscrizioni, fai clic su Rimuovi tutte le sottoscrizioni.

3. Nella finestra di dialogo Rimuovere l'abbonamento?, inserisci remove per confermare.

4. Fai clic su Rimuovi.

Per rimuovere le iscrizioni create dopo il 25 luglio 2023:

Console

1. Per elencare tutti gli abbonati di una scheda, segui le istruzioni della console Google Cloud in Visualizzare tutti gli abbonamenti.

2. Fai clic sulla scheda Sottoscrizioni.

3. Per rimuovere un abbonato da una scheda, seleziona gli abbonamenti che desideri rimuovere e fai clic su Rimuovi abbonamenti.

4. Nella finestra di dialogo Rimuovere l'abbonamento?, inserisci remove per confermare.

5. Fai clic su Rimuovi.

API

Utilizza il metodoprojects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto della sottoscrizione che vuoi rimuovere.
• LOCATION: la posizione dell'abbonamento che vuoi rimuovere.
• SUBSCRIPTION: l'ID dell'abbonamento che vuoi rimuovere.

Aggiornare una scheda

Per aggiornare una scheda, procedi nel seguente modo:

Console

1. Vai alla pagina Analytics Hub.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio di dati che contiene la scheda.

3. Fai clic sulla scheda da aggiornare.

4. Fai clic su Modifica scheda.

5. Modifica i valori nei campi. Puoi modificare tutti i valori, ad eccezione del set di dati di origine della scheda.

6. Per visualizzare l'anteprima delle modifiche, fai clic su Anteprima.

7. Per salvare le modifiche, fai clic su Salva.

API

Utilizza il metodo projects.locations.dataExchanges.listings.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

Sostituisci UPDATEMASK con l'elenco dei campi da aggiornare. Per aggiornare più valori, utilizza un elenco separato da virgole. Nel corpo della richiesta, specifica i valori aggiornati.

Per maggiori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta i metodi di projects.locations.dataExchanges.listings.

Eliminare una scheda

Se elimini una scheda, gli iscritti non potranno più visualizzarla. Se elimini una scheda, vengono eliminati anche tutti i set di dati collegati (vengono rimosse tutte le sottoscrizioni) dai progetti dei tuoi abbonati.

Se elimini una scheda, non puoi annullarla. Per eliminare una scheda, procedi nel seguente modo:

Console

1. Vai alla pagina Analytics Hub.

   Vai ad Analytics Hub

2. Fai clic sul nome dello scambio di dati che contiene la scheda.

3. Fai clic sulla scheda da eliminare.

4. Fai clic su Elimina.

5. Nella finestra di dialogo Vuoi eliminare la scheda?, conferma l'eliminazione digitando delete.

6. Fai clic su Elimina.

API

Utilizza il metodo projects.locations.dataExchanges.listings.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

Per maggiori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta i metodi di projects.locations.dataExchanges.listings.

Passaggi successivi

• Ulteriori informazioni sull'architettura di Analytics Hub
• Scopri come visualizzare e iscriverti alle schede.
• Scopri di più sui ruoli utente di Analytics Hub.
• Scopri di più sulla creazione di set di dati.
• Scopri di più sul log di controllo di Analytics Hub.
• Scopri come monitorare le schede.