Gestisci gli abbonamenti

In qualità di abbonato ad Analytics Hub, puoi eseguire le seguenti attività:

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

In qualità di publisher di Analytics Hub, puoi eseguire le seguenti attività:

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

Un abbonamento è una risorsa regionalizzata che risiede nel progetto dell'abbonato. Gli abbonamenti memorizzano 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 .

Autorizzazioni obbligatorie

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:

• roles/serviceusage.serviceUsageAdmin

Per saperne di più sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Abilita l'API Analytics Hub

Per abilitare l'API Analytics Hub:

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 abbonamento Analytics Hub (roles/analyticshub.subscriptionOwner) nel 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.

Flusso di lavoro per gli iscritti

Gli abbonati possono eseguire le seguenti azioni con gli abbonamenti.

Iscriversi alle schede

Per abbonarti alle schede, segui i passaggi descritti in Abbonarsi alle schede.

Elenco sottoscrizioni

Per visualizzare 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 che contiene gli abbonamenti che vuoi elencare.

• LOCATION: la località per cui vuoi elencare gli abbonamenti esistenti.

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 che contiene l'abbonamento che vuoi eliminare.
• LOCATION: la posizione dell'abbonamento che vuoi eliminare. Per saperne di più sulle località che supportano la condivisione BigQuery, consulta Regioni supportate.
• SUBSCRIPTION_ID: l'ID dell'abbonamento che vuoi eliminare.

Il corpo della richiesta deve essere vuoto. Se la richiesta ha esito positivo, il corpo della risposta contiene un'istanza dell'operazione.

Se avviata da un abbonato, l'eliminazione di un abbonamento elimina il set di dati collegato dal progetto dell'abbonato.

Quando elimini un abbonamento da una scheda per più regioni (Anteprima), vengono eliminate anche tutte le repliche dei set di dati collegati primari e secondari dal progetto del sottoscrittore.

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

Workflow del publisher

Gli editori possono eseguire le seguenti azioni con gli abbonamenti. Per ulteriori informazioni sulla gestione degli abbonamenti alle schede, consulta Gestire le schede.

Elenco sottoscrizioni

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

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

Revocare un abbonamento

Quando un editore revoca un abbonamento, l'abbonato perde la possibilità di interrogare il set di dati collegato. Poiché si tratta di un'azione avviata dal publisher su una risorsa di proprietà del subscriber, il set di dati collegato rimane sospeso nel progetto del subscriber. L'abbonato può scegliere di rimuovere il set di dati orfano eliminandolo.

Se un editore revoca un abbonamento da una scheda per più regioni (anteprima), gli abbonati non possono più interrogare le repliche di set di dati collegati primari o secondari.

Per revocare un abbonamento, seleziona una delle seguenti opzioni:

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

Limitazioni

Gli abbonamenti sono soggetti alle seguenti limitazioni:

• I set di dati collegati creati prima del 25 luglio 2023 non vengono sottoposti a backfill. Solo gli abbonamenti creati dopo il 25 luglio 2023 funzionano con i metodi API.

Passaggi successivi

• Scopri di più sull'architettura di condivisione di BigQuery.
• Scopri come visualizzare le schede e abbonarti.
• Scopri di più sui ruoli utente di Analytics Hub.
• Scopri di più sulla creazione di set di dati.
• Scopri di più sull'audit logging della condivisione di BigQuery.