Gestire le schede

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

• Crea schede in un data exchange per cui disponi dell'accesso in pubblicazione.
• Aggiorna, elimina, condividi e visualizza le metriche di utilizzo per le schede.
• Gestisci diversi ruoli per le tue schede BigQuery sharing (in precedenza Analytics Hub), ad esempio amministratori, abbonati e visualizzatori delle schede.
• Visualizza tutti gli iscritti al tuo annuncio.
• Monitora l'utilizzo delle tue schede.
• Rimuovi gli iscritti dal tuo annuncio.

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

• Scheda pubblica. Può essere scoperta e sottoscritta dagli utenti Google Cloud (allAuthenticatedUsers). Le schede in uno scambio di dati pubblico sono schede pubbliche. Questi elenchi possono fare riferimento a un set di dati pubblico gratuito o a un set di dati commerciale. Se la scheda riguarda un set di dati commerciale, gli abbonati possono richiedere l'accesso alla scheda direttamente dal fornitore di dati oppure possono sfogliare e acquistare schede commerciali integrate in Google Cloud Marketplace.

• Scheda privata. Viene condiviso direttamente con singoli utenti o gruppi. Ad esempio, una scheda privata può fare riferimento a un set di dati delle metriche di marketing che condividi con altri team interni 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 Condivisione. Per condividere queste schede con gli utenti, condividi l'URL della scheda. Per rendere individuabile una scheda privata, devi rendere pubblico il tuo scambio.

Prima di iniziare

Per iniziare a utilizzare BigQuery sharing (in precedenza Analytics Hub), devi abilitare l'API Analytics Hub all'interno del tuo Google Cloud progetto.

Autorizzazioni obbligatorie

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

• 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 saperne di più sui ruoli IAM in BigQuery, vedi Ruoli e autorizzazioni predefiniti.

Abilita l'API Analytics Hub

Per abilitare l'API Analytics Hub:

gcloud services enable analyticshub.googleapis.com

Autorizzazioni obbligatorie

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

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

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

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

Per saperne di più, vedi Ruoli utente di Analytics Hub. Per scoprire come concedere questi ruoli ad altri utenti, vedi 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 BigQuery contengono l'autorizzazione bigquery.datasets.update:

• Ruolo BigQuery Data Owner (roles/bigquery.dataOwner)
• Ruolo Amministratore BigQuery (roles/bigquery.admin)

Per visualizzare tutti gli scambi di dati tra i progetti di un'organizzazione a cui hai accesso, devi disporre dell'autorizzazione resourcemanager.organizations.get. Non esistono ruoli predefiniti BigQuery che contengano questa autorizzazione, pertanto devi utilizzare un ruolo IAM personalizzato.

Visualizzare gli scambi di dati

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

Creare 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:

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

Creare una scheda da un set di dati

Puoi anche creare una scheda da un set di dati:

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

   Vai a BigQuery

2. Fai clic su un set di dati per visualizzarne i dettagli.

3. Fai clic su person_add Condivisione > Pubblica come scheda.

   Si apre la finestra di dialogo Crea scheda.

4. Seleziona uno scambio di dati in cui pubblicare questa scheda. Lo scambio di dati deve trovarsi nella stessa regione del set di dati. Per saperne di più sulla creazione di uno scambio di dati, vedi Creare uno scambio e impostare le autorizzazioni.

5. Nel menu Set di dati condiviso, seleziona un set di dati esistente o fai clic su Crea un set di dati per crearne uno nuovo. Seleziona il set di dati che vuoi elencare nello scambio di dati. Il set di dati deve trovarsi nella stessa regione del data exchange. Non puoi aggiornare questo campo dopo la creazione della scheda.

   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.

6. In Controlli di uscita dei dati, seleziona l'opzione uscita dei dati appropriata.

   • Per applicare restrizioni all'uscita dei dati al 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 all'uscita dei dati al 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, che imposterà automaticamente anche Disabilita la copia e l'esportazione dei dati condivisi.
   • Per applicare le limitazioni all'uscita di copia ed esportazione dell'API Data sul set di dati condiviso, seleziona Disabilita la copia e l'esportazione delle tabelle nelle API, che imposterà automaticamente anche Disabilita la copia e l'esportazione dei dati condivisi.

7. Nella sezione Dettagli scheda, in Nome visualizzato, inserisci il nome della scheda.

8. Inserisci i seguenti dettagli facoltativi:

   • Categoria: seleziona fino a due categorie che rappresentano al meglio la tua scheda. Gli iscritti possono filtrare gli elenchi in base a queste categorie.

   • Affinità dei dati: la regione o le regioni utilizzate dal publisher per la pubblicazione dei dati. Queste informazioni sono utili agli abbonati per ridurre al minimo o evitare i costi di traffico in uscita dalla rete Pub/Sub leggendo i dati dalla stessa regione. Per ulteriori informazioni sui costi di uscita, consulta Costi di trasferimento dei dati.

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

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

   • Rilevabilità pubblica: attiva la rilevabilità pubblica della tua scheda nel catalogo di condivisione di BigQuery. Se attivi questa opzione, concedi allUsers o allAuthenticatedUsers il ruolo di Visualizzatore di Analytics Hub (roles/analyticshub.viewer). Per saperne di più, vedi Concedere il ruolo per una scheda. Se l'exchange è già pubblico, le autorizzazioni per le schede sono già ereditate e non sono necessari ulteriori interventi.

     Gli scambi rilevabili pubblicamente non possono avere schede private a causa dell'ereditarietà delle autorizzazioni, ma gli scambi privati possono avere schede pubbliche. Per creare schede pubbliche, il progetto in cui si trova la scheda di dati deve avere un'organizzazione e un account di fatturazione associati. Se stai creando una scheda commerciale integrata in Cloud Marketplace, ti consigliamo di renderla rilevabile pubblicamente.

   • Registrazione delle email dei sottoscrittori: conserva le email degli utenti sottoscrittori per l'utilizzo dei set di dati collegati a questa scheda. Una volta abilitato e salvato il logging delle email, questa impostazione non può essere modificata. Per disabilitare il logging, elimina la scheda e ricreala senza fare clic sul pulsante di attivazione/disattivazione Logging email dei sottoscrittori (Anteprima).

   • Documentazione > Markdown: informazioni aggiuntive, ad esempio link a documentazione pertinente e qualsiasi informazione aggiuntiva che possa aiutare gli abbonati a utilizzare l'argomento.

9. Nella sezione Informazioni di contatto della scheda, inserisci i seguenti dettagli facoltativi:

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

   • Contatto per la richiesta di accesso: inserisci un ID email o un URL del modulo di acquisizione per consentire agli abbonati di contattarti.

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

     • Nome del fornitore: il nome del fornitore dell'argomento.
     • Contatto principale del provider: un ID email o un URL del contatto principale del provider dell'argomento.

     Gli abbonati 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 dell'editore: un ID email o un URL del contatto principale dell'editore dell'argomento.

10. Esamina la sezione Anteprima scheda.

11. Fai clic su Pubblica.

Concedere agli utenti l'accesso a una scheda

Se vuoi concedere agli utenti l'accesso a una scheda privata, devi impostare il criterio IAM per una persona o un gruppo per quella scheda. Per una scheda commerciale, il tuo scambio di dati deve essere pubblico. Le schede in uno scambio di dati pubblico vengono visualizzate in Condivisione per tutti gli utenti (allAuthenticatedUsers). Per consentire agli utenti di sfogliare e richiedere l'accesso alle schede commerciali, devi concedere agli utenti il ruolo Visualizzatore Analytics Hub.Google Cloud Per consentire agli utenti di abbonarsi alle schede commerciali, devi concedere esplicitamente agli utenti il ruolo di abbonato ad Analytics Hub. Per le schede commerciali integrate in Cloud Marketplace, il ruolo Abbonato Analytics Hub viene eseguito automaticamente in base agli ordini di Cloud Marketplace.

Se vuoi rendere la tua scheda accessibile a tutti, comprese le persone che non utilizzano Google Cloud, devi concedere a allUsers il ruolo Visualizzatore di Analytics Hub (roles/analyticshub.viewer).

Per consentire agli utenti di visualizzare o abbonarsi alla tua scheda:

Creare un URL non autenticato per la scheda pubblica

Per creare un URL di scheda di condivisione non autenticato che sia visibile anche agli utenti nonGoogle Cloud , procedi nel seguente modo:

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (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 contenente la scheda.

3. Fai clic sul nome visualizzato per visualizzare i dettagli della scheda. La scheda deve avere visibilità pubblica attivata.

4. Fai clic su Copia link pubblico per generare un URL della scheda non autenticato. Assicurati che questo elenco conceda a allUsers il ruolo di visualizzatore di Analytics Hub (roles/analyticshub.viewer).

Creare un amministratore delle schede

Per consentire agli utenti di gestire le schede, devi creare amministratori delle schede di condivisione. Per creare amministratori delle schede, devi concedere agli utenti il ruolo Publisher di Analytics Hub o Amministratore delle schede di Analytics Hub a livello di scheda. Per saperne di più 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:

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

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  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                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

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

Rimuovere un abbonamento

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

Per rimuovere un abbonamento creato prima del 25 luglio 2023 dalle tue schede, segui questi passaggi:

1. Per elencare tutti gli iscritti a una scheda, segui le istruzioni della console Google Cloud riportate in Visualizzare tutti gli abbonamenti.

2. Per rimuovere un abbonato da un elenco, fai clic su delete Elimina. Se vuoi rimuovere tutte le iscrizioni, fai clic su Rimuovi tutte le iscrizioni.

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

4. Fai clic su Rimuovi.

Per rimuovere gli abbonamenti creati dopo il 25 luglio 2023:

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

Aggiornare una scheda

Per aggiornare una scheda:

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

Eliminare una scheda

Quando elimini una scheda, gli abbonati non possono più visualizzarla. L'eliminazione di una scheda comporta anche l'eliminazione di tutti i set di dati collegati (rimuove tutti gli abbonamenti) dai progetti dei tuoi abbonati.

Se elimini una scheda, non puoi annullare l'operazione. Per eliminare una scheda:

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

Mostrare una scheda nella sezione In evidenza

Per aumentare la visibilità e la notorietà della tua scheda nel catalogo di condivisione, le schede possono essere visualizzate nella sezione In evidenza. Le schede in evidenza sono regolate dal Google Cloud Contratto Partner Advantage.

I partner interessati a visualizzare le proprie schede nella sezione In primo piano del catalogo di condivisione devono soddisfare i seguenti criteri:

• I dati condivisi devono risiedere in BigQuery.

• Devono essere registrati al programma Partner Advantage con la designazione Build.

• La scheda deve essere creata e deve avere l'individuabilità pubblica attivata.

Per richiedere che la tua scheda venga visualizzata nella sezione In evidenza, compila e invia il modulo di accettazione. Per richiedere la rimozione della tua scheda dalla sezione, invia lo stesso modulo di acquisizione.

Passaggi successivi

• Scopri di più sull'architettura di condivisione.
• Scopri come visualizzare le schede e abbonarti.
• Scopri di più sui ruoli utente di Analytics Hub.
• Scopri di più sulla creazione di set di dati.
• Scopri di più sull'audit logging della condivisione.
• Scopri come monitorare le schede.