Gestisci abbonamenti

Puoi gestire le tue sottoscrizioni in BigQuery sharing (in precedenza Analytics Hub) per controllare l'accesso e la condivisione dei dati. In qualità di abbonato, puoi iscriverti alle schede, visualizzare le tue iscrizioni ed eliminarle. In qualità di publisher, puoi monitorare chi ha accesso alle tue schede e revocare gli abbonamenti in base alle tue esigenze. Una sottoscrizione di condivisione BigQuery è una risorsa regionalizzata che risiede nel progetto del sottoscrittore. Gli abbonamenti memorizzano le informazioni 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 abilitare l'API Analytics Hub, seleziona una delle seguenti opzioni:

Console

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

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 le sottoscrizioni, chiedi all'amministratore di concederti il ruolo IAM Analytics Hub Subscription Owner (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.

Limitazioni

Le sottoscrizioni presentano le seguenti limitazioni:

  • Puoi utilizzare l'API Analytics Hub solo per gestire le sottoscrizioni create 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.

Gestisci gli abbonamenti come abbonato

Le sezioni seguenti descrivono in che modo i sottoscrittori di BigQuery sharing gestiscono le sottoscrizioni.

Iscriviti alle schede

Per sottoscrivere un abbonamento alle schede, segui i passaggi descritti in Visualizza e sottoscrivi un abbonamento a schede e scambi di dati.

Elenco sottoscrizioni

Per elencare le tue sottoscrizioni in un progetto, chiama il metodo projects.locations.subscriptions.list:

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

Sostituisci quanto segue:

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

Aggiorna un abbonamento

Uno scambio di dati o una data clean room può diventare inattivo quando un publisher o un collaboratore di dati aggiunge o rimuove dati. In questo caso, il set di dati collegato esistente non viene aggiornato automaticamente e devi aggiornare l'abbonamento per accedere alle nuove risorse.

Per aggiornare una sottoscrizione, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nel riquadro a sinistra, fai clic su database Explorer dati:

    Pulsante evidenziato per il riquadro Dati.

    Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro sinistro per aprirlo.

  3. Nel riquadro Dati, fai clic su Aggiungi dati.

  4. Seleziona Sharing (Analytics Hub). Si apre una pagina di scoperta.

  5. Trova e fai clic sulla data clean room o sullo scambio di dati a cui hai eseguito l'iscrizione.

  6. Fai clic su Abbonati. Poiché hai già un abbonamento attivo, la console presenta un'opzione Aggiorna.

  7. Fai clic su Aggiorna per aggiornare il set di dati collegato con le risorse più recenti.

API

Per aggiornare una sottoscrizione, utilizza il metodo projects.locations.subscriptions.refresh:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per la sottoscrizione che vuoi aggiornare.
  • LOCATION: la località della sottoscrizione che vuoi aggiornare.
  • SUBSCRIPTION_ID: l'ID della sottoscrizione che vuoi aggiornare.

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

Elimina una sottoscrizione

Per eliminare una sottoscrizione, chiama il metodo projects.locations.subscriptions.delete:

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

Sostituisci quanto segue:

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

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

Quando elimini una sottoscrizione, anche il set di dati collegato viene eliminato dal progetto.

Quando elimini una sottoscrizione da una scheda multiregionale, vengono eliminate dal progetto anche tutte le repliche dei set di dati collegati principali e secondari.

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

Gestisci gli abbonamenti come editore

Le sezioni seguenti descrivono come i publisher di BigQuery sharing gestiscono le sottoscrizioni. Per ulteriori informazioni sulla gestione degli abbonamenti alle schede, consulta Gestisci le schede.

Elenco sottoscrizioni

Per elencare tutte le sottoscrizioni, 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. Nell'elenco dei data exchange, fai clic sul nome del data exchange che contiene le sottoscrizioni che vuoi elencare.

  3. Fai clic sulla scheda Sottoscrizioni.

API

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto Google Cloud del progetto che contiene il data exchange.
  • LOCATION: la località del data exchange che contiene le sottoscrizioni che vuoi elencare.
  • DATAEXCHANGE_ID: l'ID del data exchange per cui elencare le sottoscrizioni.

Revocare un abbonamento

Quando revochi una sottoscrizione in qualità di publisher di BigQuery sharing, il sottoscrittore non può più eseguire query sul set di dati collegato. Poiché avvii questa azione su una risorsa di proprietà del sottoscrittore, il set di dati collegato rimane nel progetto del sottoscrittore. Il sottoscrittore può rimuovere il set di dati eliminandolo.

Quando revochi una sottoscrizione da una scheda multiregionale, i sottoscrittori non possono più eseguire query su nessuna replica di set di dati collegata principale o secondaria.

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. Nell'elenco dei data exchange, fai clic sul nome del data exchange che contiene la sottoscrizione che vuoi revocare.

  3. Fai clic sulla scheda Sottoscrizioni.

  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 metodo projects.locations.subscriptions.revoke:

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

Sostituisci quanto segue:

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

Passaggi successivi