Gestire gli scambi di dati nella condivisione BigQuery

Console

Vai alla pagina API Analytics Hub e abilita l'API Analytics Hub per il tuo progetto Google Cloud .

Abilitare l'API Analytics Hub

gcloud

Esegui il comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Fai clic su add_box Crea scambio.

3. Nella finestra di dialogo Crea scambio, seleziona un progetto e una regione per lo scambio di dati. Non puoi aggiornare il progetto e la regione dopo aver creato lo scambio di dati.

4. In Nome visualizzato, inserisci un nome per lo scambio di dati.

5. (Facoltativo) Inserisci i valori nei seguenti campi:

   • Contatto principale: inserisci l'URL o l'indirizzo email del contatto principale per lo scambio di dati.
   • Descrizione: inserisci una descrizione dello scambio di dati.

6. Per registrare tutti gli identificatori principali degli utenti che eseguono job e query sui set di dati collegati, fai clic sul pulsante di attivazione/disattivazione Registrazione email dei sottoscrittori (anteprima). Quando attivi questa opzione, il logging email dei sottoscrittori viene attivato per tutte le schede nello scambio di dati.

7. Per attivare la rilevabilità pubblica, fai clic sul pulsante di attivazione/disattivazione Rilevabilità pubblica. Una volta che un exchange è rilevabile pubblicamente, tutte le schede dell'exchange vengono visualizzate e possono essere cercate nel catalogo. Se attivi la visibilità pubblica, devi configurare le autorizzazioni di scambio. A causa dell'ereditarietà delle autorizzazioni, tutte le schede verranno impostate per impostazione predefinita con lo stesso tipo di rilevabilità pubblica dello scambio. Pertanto, gli scambi pubblici non possono avere schede private, ma gli scambi privati possono avere schede pubbliche (ad esempio, puoi impostare il tipo di visibilità pubblica a livello di singola scheda). Il progetto in cui stai creando lo scambio di dati deve avere un'organizzazione e un account di fatturazione associati.

8. Fai clic su Crea scambio.

9. (Facoltativo) Nella sezione Autorizzazioni di Exchange, segui questi passaggi:

   1. Inserisci gli indirizzi email nei seguenti campi per concedere i ruoli utente di Analytics Hub:

      • Amministratori: a questi utenti viene assegnato il ruolo Amministratore di Analytics Hub.
      • Editori: a questi utenti viene assegnato il ruolo Editore Analytics Hub. Per informazioni sulle attività che possono essere eseguite dagli editori, consulta Gestire le schede.
      • Iscritti: a questi utenti viene assegnato il ruolo Iscritto ad Analytics Hub. Per informazioni sulle attività che gli iscritti possono svolgere, vedi Visualizzare le schede e iscriversi.
      • Visualizzatori: a questi utenti viene assegnato il ruolo Visualizzatore Analytics Hub. Gli spettatori possono visualizzare le schede.
        • Se la visibilità pubblica è attivata, assegna il ruolo Visualizzatore Analytics Hub (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers.

   2. Per salvare le autorizzazioni, fai clic su Imposta autorizzazioni.

10. Se non hai impostato le autorizzazioni per lo scambio di dati, fai clic su Salta.

API

Utilizza il metodo projects.locations.dataExchanges.create.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges?dataExchangeId=DATAEXCHANGE_ID

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui vuoi creare lo scambio di dati.
• LOCATION: la posizione per lo scambio di dati. Per ulteriori informazioni sulle località che supportano BigQuery sharing (in precedenza Analytics Hub), consulta Regioni supportate.
• DATAEXCHANGE_ID: l'ID del tuo scambio di dati.

Nel corpo della richiesta, fornisci i dettagli dello scambio di dati. Se la richiesta ha esito positivo, il corpo della risposta contiene i dettagli dello scambio di dati. Se hai attivato il logging email dei sottoscrittori (Anteprima), la risposta dello scambio di dati contiene log_linked_dataset_query_user_email: true.

Per ulteriori informazioni sulle attività che puoi eseguire sugli scambi di dati utilizzando le API, consulta i metodi projects.locations.dataExchanges.

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Nell'elenco degli scambi di dati, fai clic su uno scambio di dati che vuoi aggiornare.

3. Vai alla scheda Dettagli.

4. Fai clic su mode_edit Modifica scambio.

5. Nella finestra di dialogo Modifica scambio, aggiorna i seguenti campi:

   • Nome visualizzato
   • Contatto principale
   • Descrizione
   • Rilevabilità pubblica
     • Se attivi la visibilità pubblica, assegna il ruolo Visualizzatore Analytics Hub (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers.
     • Se disattivi la visibilità pubblica, rimuovi il ruolo Visualizzatore di Analytics Hub (roles/analyticshub.viewer) da allUsers o allAuthenticatedUsers. Gli scambi pubblici non possono avere schede private, ma gli scambi privati possono avere schede pubbliche.

   • Logging email dei sottoscrittori (anteprima)

6. Fai clic su Salva.

API

Utilizza il metodo projects.locations.dataExchanges.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID?updateMask=UPDATEMASK

Sostituisci UPDATEMASK con l'elenco dei campi che vuoi aggiornare. Per aggiornare più valori, utilizza un elenco separato da virgole. Ad esempio, per aggiornare il nome visualizzato e il contatto principale per uno scambio di dati, inserisci displayName,primaryContact.

Nel corpo della richiesta, specifica i valori aggiornati per i seguenti campi:

• Nome visualizzato
• Descrizione
• Documentazione
• Icona
• Contatto principale
• Rilevabilità pubblica
• Logging email dei sottoscrittori (anteprima)

Per maggiori dettagli su questi campi, vedi Risorsa: DataExchange.

Per ulteriori informazioni sulle attività che puoi eseguire sugli scambi di dati utilizzando le API, consulta i metodi projects.locations.dataExchanges.

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Visualizza l'elenco degli scambi di dati all'interno del tuo progetto Google Cloud . Se disponi dell'autorizzazione resourcemanager.organizations.get, puoi anche visualizzare l'elenco degli scambi di dati all'interno della tua organizzazione Google Cloud .

API

Per visualizzare gli scambi di dati nel tuo progetto, utilizza il metodo projects.locations.dataExchanges.list:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto
• LOCATION: la località per cui vuoi elencare gli scambi di dati esistenti.

Per visualizzare gli scambi di dati nella tua organizzazione, utilizza il metodo organizations.locations.dataExchanges.list:

GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID organizzazione. Per saperne di più, vedi Ottenere l'ID organizzazione.
• LOCATION: la località per cui vuoi elencare gli scambi di dati esistenti.

Console

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

   Vai a Condivisione (Analytics Hub)

2. Fai clic sul nome dello scambio di dati per cui vuoi impostare le autorizzazioni.

3. Vai alla scheda Dettagli.

4. Fai clic su person Imposta autorizzazioni.

5. Per aggiungere entità, fai clic su person_add Aggiungi entità.

6. Nel campo Nuove entità, aggiungi gli ID email a cui vuoi concedere l'accesso. Puoi anche utilizzare allUsers per rendere una risorsa pubblica e accessibile a tutti su internet oppure allAuthenticatedUsers per renderla accessibile solo agli utenti Google che hanno eseguito l'accesso.

7. Nel menu Seleziona un ruolo, seleziona Analytics Hub, quindi seleziona uno dei seguenti ruoli Identity and Access Management (IAM):

   • Analytics Hub Admin
   • Analytics Hub Listing Admin
   • Analytics Hub Publisher
   • Analytics Hub Subscriber
   • Analytics Hub Subscription Owner
   • Analytics Hub Viewer

8. Fai clic su Salva.

API

1. Leggi il criterio esistente con il metodo di elenco getIamPolicy utilizzando il metodo projects.locations.dataExchanges.getIamPolicy:

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto, ad esempio my-project-1.
   • LOCATION: la posizione per lo scambio di dati. Utilizza lettere minuscole.
   • DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati.

   BigQuery sharing (in precedenza Analytics Hub) restituisce le norme attuali.

2. Per aggiungere o rimuovere membri e i relativi ruoli IAM (Identity and Access Management), modifica il criterio con un editor di testo. Utilizza il formato seguente per aggiungere membri:

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   Ad esempio, per concedere il ruolo roles/analyticshub.subscriber a group:subscribers@example.com, aggiungi il seguente binding al criterio:

   {
    "members": [
      "group:subscribers@example.com"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Scrivi la policy aggiornata utilizzando il metodo projects.locations.dataExchanges.setIamPolicy. Nel corpo della richiesta, fornisci il criterio IAM aggiornato dal passaggio precedente.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy
   

   Nel corpo della richiesta, fornisci i dettagli della scheda. Se la richiesta ha esito positivo, il corpo della risposta contiene i dettagli della scheda.

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Nell'elenco degli scambi di dati, fai clic su quello che vuoi eliminare.

3. Vai alla scheda Dettagli.

4. Fai clic su delete Elimina scambio.

5. Nella finestra di dialogo Eliminare lo scambio?, conferma l'eliminazione digitando elimina.

6. Fai clic su Elimina.

API

Utilizza il metodo projects.locations.dataExchanges.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID

Per ulteriori informazioni sulle attività che puoi eseguire sugli scambi di dati utilizzando le API, consulta i metodi projects.locations.dataExchanges.