Gestire le schede

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

  • Crea schede in uno scambio di dati per il quale disponi dell'accesso in pubblicazione.
  • Aggiorna, elimina, condividi e visualizza le metriche di utilizzo per le schede.
  • Gestisci ruoli diversi per le schede di Analytics Hub, ad esempio amministratori, abbonati e visualizzatori delle schede.
  • Visualizzare tutti gli iscritti che si sono iscritti alla tua scheda.
  • Monitora l'utilizzo delle tue schede.
  • Rimuovi gli iscritti dalla scheda.

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

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, consulta Autorizzazioni e ruoli predefiniti.

Abilita l'API Analytics Hub

Per abilitare l'API Analytics Hub:

Console

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

Attivare l'API Analytics Hub

gcloud

Esegui il comando gcloud services allow:

gcloud services enable analyticshub.googleapis.com

Autorizzazioni obbligatorie

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

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

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

  • Ruolo Amministratore Analytics Hub (roles/analyticshub.Admin), che consente di creare, aggiornare, eliminare e impostare criteri IAM su tutte le schede nel tuo Data Exchange.

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

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 che contengono questa autorizzazione, quindi devi utilizzare un ruolo IAM personalizzato.

Visualizza scambi di dati

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

Crea una scheda

Una scheda è un riferimento a un set di dati condiviso che un publisher elenca in uno scambio di dati.

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 indirizzo email o un URL del modulo di accettazione affinché gli abbonati possano 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 iscritti possono filtrare le schede in base a queste categorie.

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

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

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

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

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

    • Icona: un'icona della tua scheda. I formati file PNG e JPEG sono supportati. Le icone devono avere dimensioni inferiori a 512 KiB e 512 x 512 pixel.

    • Descrizione: una breve descrizione della scheda. Gli iscritti 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.

  8. In In uscita dai dati (anteprima), seleziona l'opzione In uscita dai dati appropriata. Solo gli abbonati con offerte diverse da una versione o versione Enterprise Plus possono eseguire query sui dati con restrizioni relative al traffico in uscita.

    • Per applicare restrizioni per il traffico in uscita dai dati al tuo set di dati condiviso, ma non ai risultati delle query del set di dati condiviso, seleziona Disabilita la copia e l'esportazione dei dati condivisi.
    • Per applicare restrizioni relative al traffico in uscita dai dati al tuo set di dati condiviso e ai risultati delle query del set di dati condiviso, seleziona Disabilita la copia e l'esportazione dei risultati delle query. In questo modo, verrà impostata automaticamente anche l'opzione Disabilita la copia e l'esportazione dei dati condivisi.

  9. (Facoltativo) Nella sezione Documentazione > Markdown, puoi inserire informazioni aggiuntive, ad esempio query di esempio che puoi eseguire sul set di dati, link a qualsiasi documentazione pertinente ed eventuali informazioni aggiuntive che possono 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 dello 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 contiene i dettagli della scheda.

Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta la pagina relativa ai metodi di projects.locations.dataExchanges.listings.

Consentire agli utenti di accedere a una scheda

Se vuoi concedere agli utenti l'accesso a una scheda privata, devi impostare un criterio IAM per una persona o un gruppo per quella scheda. Per una scheda commerciale, il data Exchange 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 a schede commerciali, devi concedere agli utenti il ruolo Visualizzatore Analytics Hub.

Per consentire agli utenti di visualizzare o iscriversi 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 contenente la scheda.

  3. Fai clic sulla scheda a cui 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 scheda:

    • 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, in base al tipo di elenco, seleziona uno dei seguenti ruoli:

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

  8. Fai clic su Salva.

API

  1. Leggi il criterio esistente con il metodo getIamPolicy della scheda 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 contenente la scheda.
    • DATAEXCHANGE_ID: l'ID dello scambio di dati.
    • LISTING_ID: l'ID scheda.

    Analytics Hub restituisce il criterio corrente nella risposta.

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

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    Ad esempio, per concedere il ruolo roles/analyticshub.subscriber a group:subscribers@example.com, aggiungi la seguente associazione al criterio:

    {
 "members": [
   "group:subscribers@example.com"
 ],
 "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 del 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 contiene i dettagli della scheda.

Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta la pagina relativa ai metodi di projects.locations.dataExchanges.listings.

Crea un amministratore della scheda

Per consentire agli utenti di gestire le schede, devi creare amministratori di schede di Analytics Hub. Per creare amministratori di schede, devi concedere agli utenti il ruolo Publisher Analytics Hub o Amministratore schede 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 attuali 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 la quale vuoi elencare tutti gli iscritti.

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

    gestisci abbonati

  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, seleziona Gestisci abbonamenti.

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

Utilizzare il metodoprojects.locations.dataExchanges.listings.list Subscriptions.

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 abbonarti.
  • LOCATION: la località della scheda a cui vuoi iscriverti.
  • DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati che contiene 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 comunque vedere 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 riportate 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 tutti gli abbonamenti.

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

  4. Fai clic su Rimuovi.

Per rimuovere gli abbonamenti creati dopo il 25 luglio 2023:

Console

  1. Per elencare tutti gli abbonati di una scheda, segui le istruzioni della console Google Cloud riportate 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 Vuoi 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 contenente la scheda.

  3. Fai clic sulla scheda che vuoi aggiornare.

  4. Fai clic su Modifica scheda.

  5. Modifica i valori nei campi. Puoi modificare tutti i valori, tranne il 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 che vuoi aggiornare. Per aggiornare più valori, utilizza un elenco separato da virgole. Nel corpo della richiesta, specifica i valori aggiornati.

Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta la pagina relativa ai metodi di projects.locations.dataExchanges.listings.

Eliminare una scheda

Quando elimini una scheda, gli iscritti non possono più visualizzarla. L'eliminazione di una scheda elimina anche tutti i set di dati collegati (rimuove tutte le sottoscrizioni) dai progetti dei tuoi abbonati.

Se elimini una scheda, l'operazione non potrà essere annullata. Per eliminare una scheda, segui questi passaggi:

Console

  1. Vai alla pagina Analytics Hub.

    Vai ad Analytics Hub

  2. Fai clic sul nome dello scambio di dati contenente 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 ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando le API, consulta la pagina relativa ai metodi di projects.locations.dataExchanges.listings.

Passaggi successivi