Visualizzare e iscriversi alle schede

In qualità di abbonato ad Analytics Hub, puoi visualizzare e iscriverti alle schede per le quali hai accesso. L'iscrizione a una scheda crea un set di dati collegato nel tuo progetto.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare le schede, chiedi all'amministratore di concederti i seguenti ruoli Identity and Access Management (IAM) nel progetto dell'abbonato:

• Schede di Discover: Visualizzatore di Analytics Hub (roles/analyticshub.viewer)

• Iscriviti alle schede: Utente BigQuery (roles/bigquery.user)

  • Per iscriverti alle schede, devi anche chiedere al publisher della scheda di concederti il ruolo di abbonato ad Analytics Hub (roles/analyticshub.subscriber) per la sua scheda, la sua piattaforma di scambio pubblicitario o il suo progetto, a seconda dell'ambito più appropriato per il tuo caso d'uso.

• Visualizza i set di dati collegati: Visualizzatore dati BigQuery (roles/bigquery.dataViewer)

• Esegui query sui set di dati collegati: Visualizzatore dati BigQuery (roles/bigquery.dataViewer)

• Aggiorna i set di dati collegati: Proprietario dei dati BigQuery (roles/bigquery.dataOwner)

• Visualizza i metadati della tabella: Visualizzatore dati BigQuery (roles/bigquery.dataViewer)

• Eliminare i set di dati collegati: BigQuery Admin (roles/bigquery.admin)

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per eseguire le attività descritte in questo documento. Per visualizzare le autorizzazioni esatte necessarie per creare e eseguire query sui set di dati, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

• Crea nuovi set di dati: bigquery.datasets.create o bigquery.datasets.* per eseguire azioni aggiuntive sui set di dati.
• Esegui query sui set di dati: bigquery.jobs.create o bigquery.jobs.* per eseguire ulteriori azioni sui job.

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

Scoprire le schede

Per trovare le schede pubbliche e private:

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

   Vai a BigQuery

2. Nel riquadro Explorer, fai clic su Aggiungi.

3. Nella finestra di dialogo Aggiungi, fai clic su Hub di analisi. Viene visualizzata la finestra di dialogo Analytics Hub contenente le schede a cui puoi accedere. Per le schede Salesforce Data Cloud, nel riquadro Explorer è presente un pulsante che filtra automaticamente le schede correlate.
   

   In alternativa, per aprire la finestra di dialogo di Analytics Hub puoi anche andare su Analytics Hub e fare clic su Schede di ricerca.

4. Per filtrare le schede in base al nome o alla descrizione, inserisci il nome o la descrizione della scheda nel campo Cerca schede.

5. Nella sezione Filtra, puoi filtrare le schede in base ai seguenti campi:

   • Schede: seleziona se vuoi visualizzare schede private, schede pubbliche o schede all'interno della tua organizzazione.

   • Categorie: seleziona le categorie che ti interessano.

   • Località: seleziona la località che ti interessa. Per ulteriori informazioni, consulta Regioni supportate.

   • Fornitore: seleziona il fornitore di dati. Alcuni fornitori di dati richiedono di richiedere l'accesso ai loro set di dati commerciali. Dopo aver richiesto l'accesso, il fornitore di dati ti contatta per condividere i suoi set di dati.

6. Sfoglia le schede filtrate.

Iscriversi alle schede

L'iscrizione a una scheda ti consente di avere accesso in sola lettura ai dati della scheda creando un set di dati collegato nel tuo progetto.

Attenzione: ti consigliamo di non inserire dati in un progetto che si trova all'interno di un perimetro di Controlli di servizio VPC. In questo caso, devi aggiungere le regole di ingresso e uscita appropriate.

Per iscriverti a una scheda:

Console

1. Per visualizzare un elenco delle schede a cui hai accesso, segui i passaggi descritti in Visualizzare le schede.

2. Sfoglia le schede e fai clic su una a cui vuoi iscriverti. Viene visualizzata una finestra di dialogo contenente i dettagli della scheda.

3. Se non hai accesso per iscriverti a una scheda, ad esempio una scheda che fa riferimento a un set di dati commerciale, fai clic su Richiedi accesso. Se fai clic su un set di dati a cui puoi iscriverti, fai clic su Aggiungi set di dati al progetto per aprire la finestra di dialogo Crea set di dati collegato.

4. Se l'API Analytics Hub non è abilitata nel tuo progetto, viene visualizzato un messaggio di errore con un link per abilitarla. Fai clic su Abilita l'API Analytics Hub.

5. Nella finestra di dialogo Crea set di dati collegato, specifica i seguenti dettagli:

   • Project (Progetto): specifica il nome del progetto a cui vuoi aggiungere il set di dati.
   • Nome set di dati collegato: specifica il nome del set di dati collegato.

6. Per salvare le modifiche, fai clic su Salva. Il set di dati collegato è elencato nel tuo progetto.

API

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

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto della scheda a cui vuoi abbonarti.
• LOCATION: la località della tua scheda a cui vuoi abbonarti.
• DATAEXCHANGE_ID: l'ID piattaforma di scambio dati della scheda a cui vuoi abbonarti.
• LISTING_ID: l'ID scheda a cui vuoi abbonarti.

Nel corpo della richiesta, specifica il set di dati in cui vuoi creare il set di dati collegato. In caso di esito positivo, il corpo della risposta è vuoto.

Visualizzare i set di dati collegati

I set di dati collegati vengono visualizzati insieme ad altri set di dati nella console Google Cloud.

Per visualizzare i set di dati collegati nel progetto:

Console

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

   Vai a BigQuery

2. Nel riquadro Explorer, fai clic sul nome del progetto che contiene il set di dati collegato .

In alternativa, puoi anche utilizzare Data Catalog per cercare e visualizzare i set di dati collegati. Per trovare corrispondenze in tutti i set di dati collegati di Analytics Hub, utilizza il predicato type=dataset.linked. Per ulteriori informazioni, consulta la sintassi di ricerca di Data Catalog.

Cloud Shell

Esegui questo comando:

PROJECT=<your project ID> \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

Nota: se un publisher rimuove l'abbonamento, la pagina dei dettagli del set di dati collegato indica che il set di dati è stato scollegato. Puoi eliminare un set di dati non collegato perché non puoi eseguire query su un set di dati non collegato.

Esegui query sui set di dati collegati

Puoi eseguire query sulle tabelle e sulle viste nei set di dati collegati come faresti per qualsiasi altra tabella BigQuery.

Aggiornare i set di dati collegati

Le risorse in un set di dati collegato sono di sola lettura. Non puoi modificare i dati o i metadati delle risorse nei set di dati collegati né specificare le autorizzazioni per le singole risorse.

Puoi aggiornare solo la descrizione e le etichette dei set di dati collegati. Le modifiche a un set di dati collegato non influiscono sui set di dati di origine o condivisi.

Per aggiornare la descrizione e le etichette di un set di dati collegato:

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

   Vai a BigQuery

2. Nel riquadro Explorer, fai clic sul nome del progetto, quindi sul set di dati collegato.

3. Espandi l'opzione Azioni e fai clic su Apri.

4. Nel riquadro Dettagli, fai clic su Modifica dettagli e poi specifica i seguenti dettagli:

   1. Per aggiungere etichette, vedi Aggiungere un'etichetta a un set di dati.

   2. Per attivare la collation, espandi la sezione Opzioni avanzate e segui questi passaggi:

      1. Seleziona Attiva regole di confronto predefinite.
      2. Nell'elenco Collazione predefinita, seleziona un'opzione.

5. Fai clic su Salva.

Visualizza i metadati della tabella

Per visualizzare i metadati della tabella sottostante, esegui una query sulla vista INFORMATION_SCHEMA.TABLES:

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

Sostituisci LINKED-DATASET con il nome del set di dati collegato.

Nota: le query INFORMATION_SCHEMA basate su regioni non restituiscono i metadati delle tabelle collegate. Per scoprire di più sulle visualizzazioni INFORMATION_SCHEMA che non supportano i qualificatori dei set di dati per i set di dati collegati, consulta Limitazioni.

Elimina set di dati collegati

Se il tuo abbonamento viene rimosso da un editore di Analytics Hub, il tuo set di dati collegato viene scollegato dal set di dati condiviso. Puoi eliminare un set di dati scollegato perché non puoi eseguire query su un set di dati scollegato.

L'eliminazione di un set di dati collegato non comporta l'eliminazione del set di dati di origine. Non puoi recuperare un set di dati collegato che hai eliminato. Tuttavia, puoi ricrearlo nuovamente abbonandoti alla scheda e aggiungendo il set di dati al tuo progetto.

Per eliminare un set di dati collegato:

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

   Vai a BigQuery

2. Nel riquadro Explorer, fai clic sul nome del progetto, quindi sul set di dati collegato.

3. Espandi l'opzione Azioni e fai clic su Elimina.

4. Nella finestra di dialogo Vuoi eliminare il set di dati collegato?, conferma l'eliminazione digitando delete.

5. Fai clic su Elimina.

Passaggi successivi

• Scopri di più su Analytics Hub.
• Scopri di più sulla gestione delle schede.
• Scopri di più sulla gestione delle piattaforme di scambio dati.
• Scopri di più sull'audit logging di Analytics Hub.