Gestisci abbonamenti

Puoi gestire gli abbonamenti in BigQuery sharing (in precedenza Analytics Hub) per controllare l'accesso ai dati e la condivisione. In qualità di abbonato, puoi abbonarti alle schede, visualizzare i tuoi abbonamenti ed eliminarli. In qualità di publisher, puoi monitorare chi ha accesso alle tue schede e revocare gli abbonamenti, se necessario. Un abbonamento a BigQuery sharing è una risorsa regionalizzata che risiede nel progetto dell'abbonato. Gli abbonamenti memorizzano le informazioni sull'abbonato e rappresentano il contratto tra il publisher e l'abbonato.

Prima di iniziare

Per iniziare a utilizzare BigQuery sharing (in precedenza Analytics Hub), devi abilitare l'API Analytics Hub nel tuo Google Cloud progetto.

Per abilitare l'API Analytics Hub, devi disporre delle seguenti autorizzazioni di Identity and Access Management (IAM):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per abilitare l'API Analytics Hub:

Per abilitare l'API Analytics Hub, seleziona una delle seguenti opzioni:

Console

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

Abilita l'API Analytics Hub

gcloud

Esegui il comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire gli abbonamenti, chiedi all'amministratore di concederti il ruolo IAM Proprietario dell'abbonamento Analytics Hub (roles/analyticshub.subscriptionOwner) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Gli abbonamenti presentano le seguenti limitazioni:

  • Puoi utilizzare l'API Analytics Hub solo per gestire gli abbonamenti creati dopo il 25 luglio 2023. I set di dati collegati creati prima di questa data non sono supportati perché non dispongono della risorsa di abbonamento richiesta.

Gestire gli abbonamenti come abbonato

Le sezioni seguenti descrivono come gli abbonati a BigQuery sharing gestiscono gli abbonamenti.

Abbonarsi alle schede

Per abbonarti alle schede, segui i passaggi descritti in Visualizzare e abbonarsi alle schede e agli scambi di dati.

Elenco sottoscrizioni

Per elencare gli abbonamenti in un progetto, chiama il projects.locations.subscriptions.list metodo:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto del Google Cloud progetto che contiene gli abbonamenti che vuoi elencare.
  • LOCATION: la località degli abbonamenti che vuoi elencare. Per saperne di più sulle località che supportano la condivisione, consulta Regioni supportate.

Eliminare un abbonamento

Per eliminare un abbonamento, chiama il projects.locations.subscriptions.delete metodo:

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto del Google Cloud progetto che contiene l'abbonamento che vuoi eliminare.
  • LOCATION: la località dell'abbonamento che vuoi eliminare.
  • SUBSCRIPTION_ID: l'ID dell'abbonamento che vuoi eliminare.

Il corpo della richiesta deve essere vuoto. Se l'operazione va a buon fine, il corpo della risposta contiene un'istanza dell'operazione.

Quando elimini un abbonamento, il set di dati collegato viene eliminato anche dal tuo progetto.

Quando elimini un abbonamento da una scheda multiregionale, dal tuo progetto vengono eliminate anche tutte le repliche dei set di dati collegati primari e secondari.

Per saperne di più sulla gestione degli abbonamenti utilizzando l'API Analytics Hub, consulta i projects.locations.subscriptions metodi.

Gestire gli abbonamenti come publisher

Le sezioni seguenti descrivono come i publisher di BigQuery sharing gestiscono gli abbonamenti. Per saperne di più sulla gestione degli abbonamenti alle schede, consulta Gestire le schede.

Elenco sottoscrizioni

Per elencare tutti gli abbonamenti, seleziona una delle seguenti opzioni:

Console

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

    Vai a Condivisione (Analytics Hub)

    La pagina elenca tutti gli scambi di dati a cui puoi accedere.

  2. Nell'elenco degli scambi di dati, fai clic sul nome dello scambio di dati che contiene gli abbonamenti che vuoi elencare.

  3. Fai clic sulla scheda Abbonamenti.

API

Per elencare gli abbonamenti per le schede in un determinato scambio di dati, chiama il projects.locations.dataExchanges.listSubscriptions metodo:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto del Google Cloud progetto che contiene lo scambio di dati.
  • LOCATION: la località dello scambio di dati che contiene gli abbonamenti che vuoi elencare.
  • DATAEXCHANGE_ID: l'ID dello scambio di dati per il quale elencare gli abbonamenti.

Revocare un abbonamento

Quando revochi un abbonamento in qualità di publisher di BigQuery sharing, l'abbonato non può più eseguire query sul set di dati collegato. Poiché avvii questa azione su una risorsa di proprietà dell'abbonato, il set di dati collegato rimane nel progetto dell'abbonato. L'abbonato può rimuovere il set di dati eliminandolo.

Quando revochi un abbonamento da una scheda multiregionale, gli abbonati non possono più eseguire query su repliche di set di dati collegati primari o secondari.

Per revocare un abbonamento, seleziona una delle seguenti opzioni:

Console

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

    Vai a Condivisione (Analytics Hub)

    La pagina elenca tutti gli scambi di dati a cui puoi accedere.

  2. Nell'elenco degli scambi di dati, fai clic sul nome dello scambio di dati che contiene l'abbonamento che vuoi revocare.

  3. Fai clic sulla scheda Abbonamenti.

  4. Seleziona la casella di controllo accanto a ogni abbonamento che vuoi revocare.

  5. Fai clic su Revoca abbonamenti.

API

Per revocare un abbonamento, chiama il projects.locations.subscriptions.revoke metodo:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto del Google Cloud progetto che contiene l'abbonamento che vuoi revocare.
  • LOCATION: la località dell'abbonamento che vuoi revocare.
  • SUBSCRIPTION_ID: l'ID dell'abbonamento che vuoi revocare.

Passaggi successivi