Visualizza le schede e iscriviti

Grazie al tuo abbonamento ad Analytics Hub, puoi visualizzare e abbonarti 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 di concederti i seguenti ruoli IAM (Identity and Access Management) sul progetto del sottoscrittore:

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestione dell'accesso.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per eseguire le attività in questo documento. Per visualizzare le autorizzazioni esatte necessarie per creare ed 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.
  • Query sui set di dati: bigquery.jobs.create o bigquery.jobs.* per eseguire azioni aggiuntive sui job.

Potresti essere in grado di ottenere queste autorizzazioni anche 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 ad Analytics Hub e fare clic su Cerca schede.

  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 schede private, pubbliche o schede all'interno della tua organizzazione.

    • Categorie: seleziona le categorie desiderate.

    • Posizione: seleziona la località che ti interessa. Per saperne di più, consulta 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 ti consente di accedere in sola lettura ai relativi dati creando un set di dati collegato nel tuo progetto.

Per iscriverti a una scheda, procedi nel seguente modo:

Console

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

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

  3. Se non hai accesso all'abbonamento per 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 sottoscrivere un set di dati, poi 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, verrà 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 vuoi aggiungere il set di dati.
    • Nome del 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 scheda a cui vuoi iscriverti.
  • DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati 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 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 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 set di dati collegati. Per trovare corrispondenze di 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

Esegui query su set di dati collegati

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

Aggiorna 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 o 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 sull'origine o sui set di dati 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 specifica i seguenti dettagli:

    1. Per aggiungere etichette, consulta Aggiunta di un'etichetta a un set di dati.

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

      1. Seleziona Attiva regole di confronto predefinite.
      2. Dall'elenco Regole di confronto predefinite, 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.

Elimina set di dati collegati

Se il tuo abbonamento viene rimosso da un publisher di 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 abbonandoti di nuovo 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