Gestisci abbonamenti

Questo documento descrive come gestire gli abbonamenti in BigQuery sharing (in precedenza Analytics Hub), trattando le attività sia per gli abbonati sia per i publisher.

Gli abbonati a BigQuery sharing possono:

  • Abbonarsi a una scheda.
  • Elencare gli abbonamenti correnti in un determinato Google Cloud progetto.
  • Eliminare un abbonamento.

I publisher di BigQuery sharing possono:

  • Visualizzare tutti gli abbonamenti alla loro scheda.
  • Revocare l'accesso a un abbonamento specifico.

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

Prima di iniziare

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

Per abilitare l'API Analytics Hub, devi disporre delle seguenti autorizzazioni 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.

Flussi di lavoro dell'abbonato per la gestione degli abbonamenti

Questa sezione descrive come gli abbonati a BigQuery sharing gestiscono gli abbonamenti.

Abbonarsi alle schede

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

Elenco sottoscrizioni

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

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

Sostituisci quanto segue:

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

Eliminare un abbonamento

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

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 località 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 abbonato a BigQuery sharing elimina un abbonamento, elimina anche il set di dati collegato dal progetto dell'abbonato.

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

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

Flussi di lavoro del publisher per la gestione degli abbonamenti

Questa sezione descrive 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 Sharing (Analytics Hub).

    Vai a Sharing (Analytics Hub)

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

  2. Seleziona il nome dello scambio di dati in cui vuoi elencare gli abbonamenti.

  3. Seleziona la 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 projects.locations.dataExchanges.listSubscriptions metodo.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto dello scambio di dati per il quale elencare gli abbonamenti.
  • LOCATION: la località dello scambio di dati per il quale elencare gli abbonamenti.
  • DATAEXCHANGE_ID: l'ID dello scambio di dati per il quale 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 dal publisher 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.

Se un publisher revoca un abbonamento da una scheda multiregionale (anteprima), 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 Sharing (Analytics Hub).

    Vai a Sharing (Analytics Hub)

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

  2. Seleziona il nome dello scambio di dati in cui vuoi revocare la scheda.

  3. Seleziona la 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 projects.locations.subscriptions.revoke metodo.

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 località 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 abbonamento richiesta.

Passaggi successivi