Visualizzare le schede e iscriversi

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

Ruoli obbligatori

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

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 quali sono esattamente le autorizzazioni richieste per creare ed eseguire query sui 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 query sui set di dati: bigquery.jobs.create o bigquery.jobs.* per eseguire azioni aggiuntive sui job.

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

Scoprire le schede

Per scoprire le schede pubbliche e private:

  1. Nella console Google Cloud , vai alla pagina Condivisione (Analytics Hub).

    Vai a Condivisione (Analytics Hub)

  2. Fai clic su Schede di ricerca. Viene visualizzata una finestra di dialogo contenente gli elenchi a cui puoi accedere.

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

  4. Nella sezione Filtri, puoi filtrare le schede in base ai seguenti campi:

    • Schede: seleziona se vuoi visualizzare le schede private, quelle pubbliche o quelle interne alla tua organizzazione.

    • Categorie: seleziona una o più categorie.

    • Posizione: seleziona una posizione. Puoi eseguire ricerche solo in base alla posizione di scambio dei dati. Per ulteriori informazioni, vedi 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.

  5. Sfoglia gli annunci filtrati.

Iscriversi alle schede

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

Per abbonarti a una scheda:

Console

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

  2. Sfoglia gli elenchi e fai clic su quello a cui vuoi abbonarti. Viene visualizzata una finestra di dialogo contenente i dettagli della scheda. Nella sezione Dettagli aggiuntivi, puoi vedere in quali regioni il fornitore ha reso disponibile la scheda.

  3. Se non hai accesso per abbonarti a una scheda, ad esempio una scheda che fa riferimento a un set di dati commerciali, fai clic su Richiedi accesso o Acquista tramite Marketplace. Se fai clic su un set di dati a cui puoi abbonarti, fai clic su Abbonati 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 in cui vuoi aggiungere il set di dati.
    • Nome set di dati collegato: specifica il nome del set di dati collegato.

    • Regione principale: seleziona la regione in cui vuoi creare il set di dati collegato.

    • (Facoltativo) Regioni di replica (anteprima): seleziona la regione o le regioni in cui vuoi creare repliche secondarie aggiuntive del set di dati collegato. Puoi scegliere di collocare il set di dati collegato nella stessa regione degli altri dati per ridurre al minimo l'uscita e facilitare i join tra set di dati. Per creare repliche del set di dati collegato, devi disporre dell'autorizzazione bigquery.datasets.update.

  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 dell'elenco a cui vuoi abbonarti.
  • LOCATION: la posizione della scheda a cui vuoi abbonarti.
  • DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati dell'elenco a cui vuoi abbonarti.
  • LISTING_ID: l'ID della scheda a cui vuoi abbonarti.

Nel corpo della richiesta, specifica il set di dati in cui vuoi creare il set di dati collegato.

Per creare un abbonamento con repliche del set di dati collegato disponibili in più regioni (anteprima), specifica la regione principale del set di dati collegato utilizzando il campo location nel corpo della richiesta. Per le regioni secondarie in cui vuoi creare repliche del set di dati collegato, puoi utilizzare facoltativamente il campo destinationDataset.replica_locations nel corpo della richiesta ed elencare tutte le regioni secondarie di replica che preferisci. Assicurati che le regioni specificate nella proprietà location e nel campo destinationDataset.replica_locations siano regioni in cui è disponibile la scheda associata.

Se la richiesta ha esito positivo, il corpo della risposta contiene l'oggetto abbonamento. Se hai attivato il logging email dei sottoscrittori (Anteprima) per lo scambio di dati o la scheda, la risposta all'iscrizione contiene log_linked_dataset_query_user_email: true.

Visualizzare i set di dati collegati

I set di dati collegati vengono visualizzati insieme agli 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 (ritirato) o Dataplex Universal Catalog per cercare e visualizzare i set di dati collegati. Per trovare tutti i set di dati collegati di condivisione BigQuery, utilizza il predicato type=dataset.linked. Per saperne di più, consulta Sintassi di ricerca di Data Catalog o Sintassi di ricerca di Dataplex Universal 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

Eseguire query sui set di dati collegati

Puoi eseguire query su tabelle e viste nei set di dati collegati nello stesso modo in cui esegui 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 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 il collation, espandi la sezione Opzioni avanzate e segui questi passaggi:

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

  5. Fai clic su Salva.

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

Annullare l'iscrizione o eliminare i set di dati collegati

Per annullare l'iscrizione a un set di dati, devi eliminare il set di dati collegato. L'eliminazione di un set di dati collegato non elimina il set di dati di origine.

Non puoi recuperare un set di dati collegato dopo averlo eliminato. Tuttavia, puoi ricreare il set di dati collegato eliminato abbonandoti di nuovo alla scheda e aggiungendo il set di dati e i set di dati collegati creati dalle schede integrate di Google Cloud Marketplace al tuo progetto.

Se il tuo abbonamento viene rimosso da un publisher di Analytics Hub, il tuo set di dati collegato viene scollegato dal set di dati condiviso. Poiché si tratta di un'azione avviata dal publisher su una risorsa di proprietà del subscriber, il set di dati collegato rimane orfano nel progetto del subscriber. L'abbonato può rimuovere il set di dati orfano eliminandolo.

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