Gestisci abbonamenti

Questo documento descrive come gestire le sottoscrizioni di BigQuery sharing, coprendo le attività per sottoscrittori e publisher.

In qualità di abbonato alla condivisione di BigQuery, puoi:

  • Iscriversi a una scheda.
  • Elenca i tuoi abbonamenti attuali in un determinato progetto Google Cloud .
  • Eliminare un abbonamento.

In qualità di publisher di condivisione di BigQuery, puoi:

  • Visualizza tutti gli abbonamenti alla tua scheda.
  • Revocare l'accesso a un abbonamento specifico.

Un abbonamento BigQuery sharing è una risorsa regionalizzata che risiede nel progetto dell'abbonato. Gli abbonamenti memorizzano le informazioni pertinenti sull'abbonato e rappresentano il contratto tra l'editore e l'abbonato.

Prima di iniziare

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

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

  • 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 attivare 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 progetto Google Cloud .

Abilitare 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 Analytics Hub Subscription Owner (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.

Flussi di lavoro per la gestione degli abbonamenti

Le seguenti sezioni descrivono cosa possono fare gli abbonati alla condivisione di BigQuery con gli abbonamenti.

Iscriversi alle schede

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

Elenco sottoscrizioni

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto Google Cloud per gli abbonamenti che vuoi elencare.
  • LOCATION: la posizione degli abbonamenti che vuoi elencare.

Eliminare un abbonamento

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per l'abbonamento da eliminare.
  • LOCATION: la posizione dell'abbonamento da eliminare. Per saperne di più sulle località che supportano la condivisione, consulta Regioni supportate.
  • SUBSCRIPTION_ID: l'ID dell'abbonamento da eliminare.

Il corpo della richiesta deve essere vuoto. In caso di esito positivo, il corpo della risposta contiene un'istanza dell'operazione.

Quando un sottoscrittore di BigQuery sharing elimina un abbonamento, viene eliminato anche il set di dati collegato dal progetto del sottoscrittore.

Quando elimini un abbonamento da una scheda multiregionale (Anteprima), vengono eliminate anche tutte le repliche dei set di dati collegati primari e secondari dal progetto dell'abbonato.

Per ulteriori informazioni sulle attività che puoi svolgere con gli abbonamenti utilizzando l'API, consulta i metodi projects.locations.subscriptions.

Flussi di lavoro per la gestione degli abbonamenti per i publisher

Le seguenti sezioni descrivono cosa possono fare i publisher di BigQuery sharing con 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 console Google Cloud , vai alla pagina Condivisione (Analytics Hub).

    Vai a Condivisione (Analytics Hub)

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

  2. Fai clic sul nome dello scambio di dati in cui vuoi elencare gli abbonamenti.

  3. Fai clic sulla scheda Abbonamenti per visualizzare tutti gli abbonamenti per le schede all'interno dello scambio di dati.

API

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto del data exchange per cui elencare gli abbonamenti.
  • LOCATION: la posizione del data exchange per cui elencare gli abbonamenti.
  • DATAEXCHANGE_ID: l'ID dell'exchange di dati per cui elencare gli abbonamenti.

Revocare un abbonamento

Quando un publisher di BigQuery sharing revoca un abbonamento, l'abbonato non può più eseguire query sul set di dati collegato. Poiché questa azione viene avviata dall'editore su una risorsa di proprietà del subscriber, il set di dati collegato rimane nel progetto del subscriber. L'abbonato può rimuovere il set di dati eliminandolo.

Se un publisher revoca un abbonamento da una scheda multiregionale (Anteprima), gli abbonati non possono più eseguire query su nessuna replica del set di dati collegato principale o secondario.

Per revocare un abbonamento, seleziona una delle seguenti opzioni:

Console

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

    Vai a Condivisione (Analytics Hub)

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

  2. Fai clic sul nome dello scambio di dati in cui vuoi revocare la scheda.

  3. Fai clic sulla scheda Abbonamenti per visualizzare tutti gli abbonamenti per lo scambio di dati.

  4. Seleziona gli abbonamenti da revocare.

  5. Fai clic su Revoca abbonamenti.

API

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto dell'abbonamento da revocare.
  • LOCATION: la posizione dell'abbonamento.
  • SUBSCRIPTION_ID: l'ID dell'abbonamento da revocare.

Limitazioni

Gli abbonamenti presentano le seguenti limitazioni:

  • Puoi utilizzare l'API 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 sottoscrizione richiesta.

Passaggi successivi