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 progetto.

Ruoli obbligatori

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

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

Questi ruoli predefiniti contengono le autorizzazioni necessarie per eseguire le attività in questo documento. Per vedere le autorizzazioni esatte necessarie per creare ed eseguire query su set di dati, 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 una 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 schede pubbliche e private, procedi nel seguente modo:

  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 Analytics Hub. Viene visualizzata la finestra di dialogo Analytics Hub contenente le schede a cui puoi accedere. Per le schede di Salesforce Data Cloud, è presente un pulsante nel riquadro Explorer che filtra automaticamente le schede correlate.

    In alternativa, per aprire la finestra di dialogo 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 Filtro, puoi filtrare le schede in base ai seguenti campi:

    • Schede: scegli se visualizzare le schede private, quelle pubbliche o le schede all'interno dell'organizzazione.

    • Categorie: seleziona le categorie che ti interessano.

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

    • Provider: 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.

Iscriviti alle schede

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

Per abbonarti a una scheda, procedi nel seguente modo:

Console

  1. Per visualizzare un elenco di 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 con i dettagli della scheda.

  3. Se non hai accesso per abbonarti 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 progetto, viene visualizzato un messaggio di errore con un link per abilitare l'API. Fai clic su Abilita API Analytics Hub.

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

    • Progetto: specifica il nome del progetto in cui desideri 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 iscriverti.
  • LOCATION: la posizione della scheda a cui vuoi abbonarti.
  • DATAEXCHANGE_ID: l'ID Data Exchange della scheda a cui vuoi abbonarti.
  • LISTING_ID: l'ID scheda a cui vuoi iscriverti.

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.

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 una corrispondenza con tutti i set di dati collegati ad Analytics Hub, utilizza il predicato type=dataset.linked. Per ulteriori informazioni, consulta la pagina sulla 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

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 i metadati per le 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 e poi sul set di dati collegato.

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

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

    1. Per aggiungere etichette, consulta la sezione Aggiungere un'etichetta a un set di dati.

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

      1. Seleziona Attiva le 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 sulla visualizzazione INFORMATION_SCHEMA.TABLES:

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

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

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 ricrearlo effettuando nuovamente la sottoscrizione alla scheda e aggiungendo il set di dati al 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 e poi 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