Visualizzare le schede e gli scambi di dati e abbonarsi

Questo documento descrive come visualizzare le schede e gli scambi di dati e abbonarsi a questi in BigQuery sharing (in precedenza Analytics Hub). In qualità di abbonato a BigQuery sharing, puoi visualizzare le schede e gli scambi di dati a cui hai accesso e abbonarti. L'abbonamento a una scheda o a uno scambio di dati in BigQuery sharing crea un set di dati collegato nel tuo Cloud de Confiance progetto.

Ruoli obbligatori

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

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

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.

Scopri le schede

Per scoprire le schede pubbliche e private:

  1. Nella Cloud de Confiance console, vai alla pagina Sharing (Analytics Hub).

    Vai a Sharing (Analytics Hub)

  2. Fai clic su Cerca schede. Viene visualizzata una finestra di dialogo contenente le schede 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, le schede pubbliche schede o schede all'interno della tua organizzazione.

    • Categorie: seleziona una o più categorie.

    • Località: seleziona una località. Puoi eseguire ricerche solo in base alla località dello scambio di dati. Per saperne di più, 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 contatterà per condividere i suoi set di dati.

  5. Sfoglia le schede filtrate.

Scopri gli scambi di dati

Per scoprire gli scambi di dati:

  1. Nella Cloud de Confiance console, vai alla pagina Sharing (Analytics Hub).

    Vai a Sharing (Analytics Hub)

  2. Fai clic su Cerca schede. Viene visualizzata una finestra di dialogo contenente le schede e gli scambi di dati a cui puoi abbonarti.

  3. Per filtrare gli scambi di dati in base al nome o alla descrizione, inserisci il nome o la descrizione dello scambio di data clean room nel campo Cerca schede.

  4. Nella sezione Filtri, puoi filtrare gli scambi di data clean room in base ai seguenti campi:

    • Schede: seleziona la casella di controllo Data clean room per visualizzare le data clean room condivise con te.

    • Categorie: seleziona una o più categorie.

    • Località: seleziona una località. Puoi eseguire ricerche solo in base alla località dello scambio di dati. Per saperne di più, consulta Regioni supportate.

  5. Sfoglia le data clean room filtrate.

Abbonati alle schede

L'abbonamento 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 le schede e fai clic su una a cui vuoi abbonarti. Viene visualizzata una finestra di dialogo con i dettagli della scheda. La finestra di dialogo mostra se il fornitore ha abilitato la registrazione delle email degli abbonati. Nella sezione Dettagli aggiuntivi, puoi vedere le regioni in cui il fornitore ha reso disponibile la scheda.

  3. Se non hai accesso all'abbonamento a una scheda, ad esempio una scheda che fa riferimento a un set di dati commerciale, 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 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 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: 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 per il 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 abbonarti.
  • DATAEXCHANGE_ID: l'ID piattaforma di scambio della scheda 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, 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 di replica secondarie selezionate. Assicurati che le regioni specificate nella location proprietà e nel destinationDataset.replica_locations campo siano regioni in cui è disponibile la scheda associata.

Se la richiesta ha esito positivo, il corpo della risposta contiene l' oggetto dell'abbonamento.

Se abiliti la registrazione delle email degli abbonati per lo scambio di dati o la scheda con il campo logLinkedDatasetQueryUserEmail, la risposta dell'abbonamento contiene log_linked_dataset_query_user_email: true. I dati registrati sono disponibili in nel campo job_principal_subject della INFORMATION_SCHEMA.SHARED_DATASET_USAGE vista.

Se abiliti la condivisione di stored procedure (anteprima), la risposta della scheda contiene stored_procedure_config: true.

Abbonati agli scambi di dati

L'abbonamento a uno scambio di dati ti consente di accedere in sola lettura ai dati nello scambio di data clean room creando un set di dati collegato nel tuo progetto.

Per abbonarti a uno scambio di data clean room:

Console

  1. Per visualizzare un elenco degli scambi di data clean room a cui hai accesso, segui i passaggi descritti in Scopri gli scambi di dati.

  2. Sfoglia gli scambi di data clean room e fai clic su uno a cui vuoi abbonarti. Viene visualizzata una finestra di dialogo con i dettagli dello scambio di data clean room.

  3. Se fai clic su uno scambio di data clean room a cui puoi abbonarti, fai clic su Abbonati per aprire la finestra di dialogo Aggiungi data clean room al progetto.

  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 API Analytics Hub.

  5. Nella finestra di dialogo Aggiungi data clean room al progetto, specifica i seguenti dettagli:

    • Destinazione: specifica il nome del progetto in cui vuoi aggiungere il set di dati.

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

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

Sostituisci quanto segue:

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

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

Se la richiesta ha esito positivo, il corpo della risposta contiene l' oggetto dell'abbonamento. Se hai abilitato la registrazione delle email degli abbonati per lo scambio di dati, la risposta dell'abbonamento contiene log_linked_dataset_query_user_email: true.

Visualizza i set di dati collegati

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

Per visualizzare i set di dati collegati nel tuo progetto:

Console

  1. Nella Cloud de Confiance console, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nel riquadro Spazio di esplorazione classico, fai clic su categoria Spazio di esplorazione classico:

    Pulsante evidenziato per il riquadro Esplora classico.

    Se il riquadro Spazio di esplorazione classico non è visibile, fai clic su Espandi riquadro a sinistra per aprirlo.

  3. Nel riquadro Spazio di esplorazione classico, fai clic sul nome del progetto che contiene il Icona del set di dati collegato di Analytics Hub set di dati collegato.

In alternativa, puoi utilizzare anche Data Catalog (ritirato) o Knowledge Catalog per cercare e visualizzare i set di dati collegati. Per trovare tutti i set di dati collegati di BigQuery sharing, utilizza il predicato type=dataset.linked. Per saperne di più, consulta Sintassi di ricerca di Data Catalog o Sintassi di ricerca di Knowledge Catalog.

Cloud Shell

Esegui questo comando:

PROJECT=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

Sostituisci PROJECT_ID con l'ID progetto Cloud de Confiance .

Esegui 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 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 Cloud de Confiance console, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nel riquadro Explorer, fai clic su Explorer:

    Pulsante evidenziato per il riquadro Spazio di esplorazione.

  3. Nel riquadro Explorer , espandi il nome del progetto, fai clic su Set di dati e poi sul nome del set di dati collegato per aprirlo.

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

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

    2. Per abilitare le regole di confronto, espandi la sezione Opzioni avanzate e segui questi passaggi:

      1. Seleziona Abilita 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 INFORMATION_SCHEMA.TABLES vista:

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

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

Annulla l'abbonamento o elimina i set di dati collegati

Per annullare l'abbonamento 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 in Google Cloud Marketplace al tuo progetto.

Se l'abbonamento viene rimosso da un publisher di BigQuery sharing, il 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à dell'abbonato, il set di dati collegato rimane nel progetto dell'abbonato a BigQuery sharing in uno stato scollegato. Puoi rimuovere il set di dati scollegato eliminandolo.

Per eliminare un set di dati collegato:

  1. Nella Cloud de Confiance console, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nel riquadro Explorer, fai clic su Explorer:

    Pulsante evidenziato per il riquadro Spazio di esplorazione.

  3. Nel riquadro Explorer , espandi il nome del progetto, fai clic su Set di dati e poi sul nome del set di dati collegato per aprirlo.

  4. Fai clic su Elimina.

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

  6. Fai clic su Elimina.

Passaggi successivi