Visualizza e iscriviti alle schede

In qualità di abbonato ad Analytics Hub, puoi visualizzare e iscriverti alle schede a cui 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 per concederti i seguenti ruoli IAM (Identity and Access Management) sul sottoscrittore progetto:

• 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 all'editore della scheda di concederti il ruolo Abbonato Analytics Hub (roles/analyticshub.subscriber) nella scheda, nella piattaforma di scambio pubblicitario o nel progetto, a seconda dell'ambito più appropriato per il tuo caso d'uso.

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

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

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

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

• Elimina set di dati collegati: Amministratore BigQuery (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 vedere le autorizzazioni esatte necessarie per creare set di dati di query, espandi la sezione Autorizzazioni obbligatorie:

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 azioni aggiuntive sui job.

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

Scopri 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 dati.

3. Nella finestra di dialogo Aggiungi dati, fai clic su Hub di analisi. Viene visualizzata la finestra di dialogo Analytics Hub contenente le schede a cui puoi accedere. Per gli elenchi di Salesforce Data Cloud, è presente un pulsante Riquadro di esplorazione 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: scegli se visualizzare le schede private, pubbliche schede o schede all'interno della tua organizzazione.

   • Categorie: seleziona le categorie che ti interessano.

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

   • Provider: seleziona il fornitore di dati. Alcuni fornitori di dati richiedono di richiedere l'accesso ai propri 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

Iscrizione a una scheda ti consente di accedere di sola lettura ai dati della scheda creando un link di dati nel tuo progetto.

Attenzione: consigliamo di non inserire dati in un progetto che si trova all'interno di Perimetro Controlli di servizio VPC. In questo caso, devi aggiungere gli attributi regole in entrata e in uscita.

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. a. 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 abilitare l'API. 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 che a cui vuoi iscriverti.
• LOCATION: la località della tua scheda a cui vuoi abbonarti.
• DATAEXCHANGE_ID: l'ID dello scambio dati della scheda a cui vuoi abbonarti.
• LISTING_ID: l'ID scheda che vuoi .

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

Visualizza 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 tuo 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 con tutti i set di dati collegati ad Analytics Hub, utilizza Predicato type=dataset.linked. Per ulteriori informazioni, vedi 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 editore rimuove l'abbonamento, la pagina dei dettagli del set di dati collegato mostra che il set di dati è stato scollegato. Puoi eliminare un set di dati scollegato perché non puoi eseguire una query su un set di dati scollegato.

Esegui query su set di dati collegati

Puoi eseguire query su tabelle e viste nei set di dati collegati nello stesso modo in cui eseguiresti una query su qualsiasi altra tabella BigQuery.

Aggiorna set di dati collegati

Le risorse in un set di dati collegato sono di sola lettura. Non puoi modificare i dati o metadati per le risorse nei set di dati collegati o specifica le autorizzazioni per singoli Google Cloud.

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 e poi sul pulsante del set di dati.

3. Espandi 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, consulta la sezione 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. Seleziona un'opzione dall'elenco Regole di confronto predefinite.

5. Fai clic su Salva.

Visualizza i metadati della tabella

Per visualizzare i metadati della tabella sottostante, esegui una query su INFORMATION_SCHEMA.TABLES. visualizza:

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 publisher Analytics Hub, il 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 elimina il set di dati di origine. Non puoi recuperare un set di dati collegato che hai eliminato. Tuttavia, puoi ricrearla iscrivendoti alla scheda e aggiungendo 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 degli scambi di dati.
• Scopri di più sul log di controllo di Analytics Hub.