Condivisione dei flussi con Pub/Sub
Puoi condividere argomenti Pub/Sub tramite Analytics Hub per organizzare e distribuire una libreria di flussi di dati attraverso più confini organizzativi interni ed esterni. I flussi di dati in tempo reale vengono condivisi tramite le piattaforme di scambio e le schede di Analytics Hub, in modo da classificare e raggruppare logicamente grandi insiemi di argomenti Pub/Sub ed eseguire il provisioning dell'accesso su larga scala.
Puoi condividere i flussi di dati per:
- Servizi finanziari:
- Condividi in tempo reale prezzi, preventivi e ordini degli strumenti in rapida evoluzione
- Rilevare il riciclaggio di denaro e le frodi nei pagamenti
- Supporta i calcoli del rischio di trading
- Vendita al dettaglio e beni di largo consumo:
- Aiuta i negozi a gestire l'inventario in tempo reale
- Personalizza marketing e assistenza clienti
- Regola i prezzi in modo dinamico
- Monitorare i canali dei social media
- Ottimizza i layout dei negozi fisici
- Sanità:
- Supporta algoritmi predittivi per monitorare i pazienti e analizzare il rischio in tempo reale
- Monitoraggio dei parametri vitali con dispositivi medici indossabili
- Acquisizione, struttura, archiviazione ed elaborazione automatici dei dati di pazienti, operatori sanitari e amministrazione della struttura
- Telecomunicazioni:
- Rivedi l'integrità della rete e prevedi gli errori
- Scoprire i modelli di comportamento degli utenti per individuare meglio dispositivi e antenne
Ruoli
I ruoli per la condivisione degli argomenti Pub/Sub sono analoghi alla condivisione dei set di dati BigQuery:
- Amministratore:un utente che gestisce le autorizzazioni, la visibilità e l'iscrizione a piattaforme di scambio e schede. Utilizza il ruolo Amministratore Analytics Hub.
- Publisher (di un argomento condiviso): un utente che crea, gestisce e concede l'accesso a schede degli argomenti Pub/Sub condivisi. Utilizza il ruolo Publisher Analytics Hub o Amministratore elenco Analytics Hub. Il publisher indicato qui è un utente e non l'applicazione del publisher che crea e invia i messaggi all'argomento.
- Iscritto (di un argomento condiviso): un utente che si abbona all'elenco di argomenti condivisi. I sottoscrittori possono configurare la modalità di recapito dei messaggi degli argomenti. Utilizza il ruolo Abbonato Analytics Hub o il ruolo Proprietario abbonamenti Analytics Hub. A seconda di come vengono consegnati i dati dei messaggi, potrebbero essere necessari ruoli aggiuntivi (ad es. autorizzazioni dell'account di servizio Pub/Sub per la scrittura di messaggi in BigQuery).
Architettura
Il seguente diagramma descrive in che modo publisher e abbonati alle risorse Pub/Sub interagiscono con Analytics Hub:
Argomenti condivisi
Un argomento condiviso è l'unità di condivisione di un argomento Pub/Sub in Analytics Hub. In qualità di publisher, puoi creare o utilizzare un argomento Pub/Sub esistente per distribuire i dati dei messaggi ai sottoscrittori. Analytics Hub non replica l'argomento Pub/Sub di origine.
Schede
Una scheda viene creata quando un publisher aggiunge un argomento condiviso a una piattaforma di scambio pubblicitario. Contiene un riferimento all'argomento condiviso.
Piattaforme di scambio pubblicitario
Una piattaforma di scambio è un raggruppamento logico di schede che fanno riferimento ad argomenti condivisi.
Sottoscrizioni Pub/Sub collegate
Quando ti abboni a una scheda con un argomento condiviso, nel progetto del sottoscrittore viene creata una sottoscrizione Pub/Sub collegata. Una sottoscrizione Pub/Sub è rappresentata anche nel progetto Publisher come una sottoscrizione Pub/Sub e una sottoscrizione per l'elenco di Analytics Hub.
Limitazioni
La condivisione dei flussi con Pub/Sub presenta le seguenti limitazioni:
- Un argomento condiviso può avere un massimo di 10.000 sottoscrizioni Pub/Sub. Questo limite include le sottoscrizioni Pub/Sub collegate e le sottoscrizioni Pub/Sub create al di fuori di Analytics Hub, ad esempio le sottoscrizioni create direttamente da Pub/Sub.
- Gli argomenti condivisi vengono indicizzati in Data Catalog, ma non puoi applicare filtri specifici in base al tipo di risorsa.
- Le metriche di utilizzo non vengono acquisite per le sottoscrizioni Pub/Sub collegate in Analytics Hub. Puoi visualizzare le metriche di utilizzo in Pub/Sub.
Abilitare l'API Analytics Hub
Per attivare l'API Analytics Hub:
Console
Vai alla libreria API e abilita l'API Analytics Hub per il tuo progetto Google Cloud.
gcloud
Esegui gcloud services enable
.
:
gcloud services enable analyticshub.googleapis.com
Abilita l'API Pub/Sub
Vai alla libreria API e abilita l'API Pub/Sub per il tuo progetto Google Cloud.
Flussi di lavoro per i publisher
In qualità di publisher Analytics Hub, puoi:
- Aggiungi argomenti condivisi a uno scambio creando una scheda
- Aggiornare una scheda
- Eliminare una scheda
- Condividere una scheda
- Gestisci le iscrizioni alla tua scheda
- Rimuovere abbonati dalla tua scheda
Autorizzazioni publisher aggiuntive
Per eseguire le attività dei publisher, devi disporre del ruolo Publisher Analytics Hub (roles/analyticshub.publisher
) in una piattaforma di scambio o in una scheda. Per visualizzare tutti gli scambi di dati nei progetti di un'organizzazione a cui hai accesso, devi disporre dell'autorizzazione resourcemanager.organizations.get.
Inoltre, devi disporre dell'autorizzazione pubsub.topics.setIamPolicy
per l'argomento Pub/Sub che vuoi elencare. Per condividere gli argomenti a cui è associato uno schema, devi concedere agli abbonati di Analytics Hub l'autorizzazione pubsub.schemas.get
per lo schema associato all'argomento. In questo modo i sottoscrittori Analytics Hub possono analizzare correttamente i messaggi della sottoscrizione Pub/Sub.
Creare una scheda (per aggiungere un argomento condiviso)
Per aggiungere un argomento condiviso a una scheda, seleziona una delle seguenti opzioni:
Console
Vai alla pagina Analytics Hub.
Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.
Fai clic sul nome dello scambio di dati in cui vuoi creare la scheda.
Fai clic su
Crea scheda.Nella pagina Crea scheda, seleziona "Argomento Pub/Sub" nell'elenco a discesa Tipo di risorsa.
Seleziona un argomento Pub/Sub esistente nel menu a discesa Argomento condiviso oppure fai clic su Crea un argomento.
Nella pagina Dettagli scheda, in Nome visualizzato, inserisci il nome della scheda.
Inserisci i seguenti dettagli facoltativi:
Categoria: seleziona fino a due categorie che meglio rappresentano la tua dell'annuncio. Gli iscritti possono filtrare le schede in base a queste categorie.
Affinità dati: regioni utilizzate dal publisher per pubblicare i dati. Queste informazioni sono utili agli abbonati per ridurre al minimo o evitare i costi del traffico in uscita dalla rete Pub/Sub leggendo i dati dalla stessa regione. Per ulteriori informazioni sui costi del traffico in uscita, vedi Costi del trasferimento di dati.
Icona: un'icona per la tua scheda. I formati di file PNG e JPEG sono supportati. Le dimensioni dei file delle icone devono essere inferiori a 512 KiB e non superiori a 512 x 512 pixel.
Descrizione: una breve descrizione della tua scheda. Gli abbonati possono cercare schede in base alla descrizione.
Rilevabilità pubblica: attiva la rilevabilità pubblica della tua scheda nel catalogo Analytics Hub. Devi anche impostare le autorizzazioni per la scheda. Fai clic su Azioni della piattaforma di scambio pubblicitario e su Imposta autorizzazioni. Assegna a
allUsers
oallAuthenticatedusers
il ruolo Visualizzatore Analytics Hub. Fai clic su Consenti accesso pubblico.Documentazione > Markdown: informazioni aggiuntive come link a qualsiasi documentazione pertinente e qualsiasi informazione aggiuntiva che può aiutare gli abbonati a utilizzare il tuo argomento.
Nella pagina Elenco dei dati di contatto, inserisci i seguenti dettagli facoltativi:
Contatto principale: inserisci un indirizzo email o un URL del contatto principale per la scheda.
Richiedi contatto di accesso: inserisci un'email o un URL del modulo di richiesta per consentire agli abbonati di contattarti.
Provider: espandi la sezione Provider e specifica i dettagli nel campo seguenti campi:
- Nome provider: il nome del provider dell'argomento.
- Contatto principale del fornitore: un indirizzo email o un URL dell'argomento contatto principale del fornitore.
Gli abbonati possono filtrare le schede in base ai fornitori di dati.
Editore: espandi la sezione Editore e specifica i dettagli in nei seguenti campi:
- Nome publisher: il nome del publisher che crea l'account di servizio dell'annuncio.
- Contatto principale del publisher: un indirizzo email o un URL dell'argomento. contatto principale del publisher.
Consulta la pagina Anteprima scheda.
Fai clic su Pubblica.
API
Utilizza la projects.locations.dataExchanges.listings.create
gcloud.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene i dati scambio in cui vuoi creare la scheda.LOCATION
: la località dello scambio di dati. Per ulteriori informazioni sulle sedi Analytics Hub, consulta Regioni supportate.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati.LISTING_ID
: l'ID scheda.
Nel corpo della richiesta, fornisci i dettagli della scheda. Se la richiesta ha esito positivo, il corpo della risposta conterrà i dettagli dell'elenco.
Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando
API, vedi i metodi projects.locations.dataExchanges.listings
.
Aggiornare una scheda
Per aggiornare una scheda, seleziona una delle seguenti opzioni:
Console
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda.
Fai clic sulla scheda da aggiornare.
Fai clic su
Modifica scheda.Modifica i valori nei campi. Puoi modificare tutti i valori tranne l'argomento condiviso della scheda.
Per salvare le modifiche, fai clic su Pubblica.
API
Utilizza il metodo projects.locations.dataExchanges.listings.patch
.
PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene i dati scambio in cui vuoi creare la scheda.LOCATION
: la località dello scambio di dati. Per ulteriori informazioni sulle sedi Analytics Hub, consulta Regioni supportate.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati.LISTING_ID
: l'ID scheda.UPDATEMASK
: elenco dei campi che vuoi aggiornare. Per aggiornare più valori, utilizza i valori separati da virgole dall'elenco di lettura.
Nel corpo della richiesta, specifica i valori aggiornati.
Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando
API, vedi i metodi projects.locations.dataExchanges.listings
.
Eliminare una scheda
Le schede con argomenti Pub/Sub condivisi non possono essere eliminate con sottoscrizioni attive. Revoca tutte le sottoscrizioni attive prima di tentare di eliminare una scheda di un argomento condiviso. Una volta eliminata una scheda, non puoi annullarla. Per eliminare una scheda, seleziona una delle seguenti opzioni:
Console
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda.
Fai clic sulla scheda da eliminare.
Fai clic su
Elimina.Nella finestra di dialogo Vuoi eliminare la scheda?, conferma l'eliminazione digitando delete.
Fai clic su Elimina.
API
Utilizza il metodo projects.locations.dataExchanges.listings.delete
.
DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene i dati scambio in cui vuoi creare la scheda.LOCATION
: la località dello scambio di dati. Per ulteriori informazioni sulle sedi Analytics Hub, consulta Regioni supportate.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati.LISTING_ID
: l'ID scheda.
Per ulteriori informazioni sulle attività che puoi eseguire nelle schede utilizzando
API, vedi i metodi projects.locations.dataExchanges.listings
.
Condividere una scheda
Se vuoi concedere agli utenti l'accesso a una scheda privata, devi impostare il criterio IAM per una singola scheda o un gruppo per quella scheda. Per una scheda commerciale, lo scambio di dati deve essere pubblico. Le schede in uno scambio di dati pubblico vengono visualizzate in Analytics Hub per tutti gli utenti Google Cloud (allAuthenticatedUsers). Per consentire agli utenti di richiedere l'accesso per le schede commerciali, devi concedere loro il ruolo Visualizzatore Analytics Hub.
Per concedere agli utenti l'accesso per visualizzare o abbonarsi alla tua scheda, svolgi i passaggi che seguono:
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda.
Fai clic sulla scheda alla quale vuoi aggiungere abbonati.
Fai clic su
Imposta autorizzazioni.Per aggiungere entità, fai clic su
Aggiungi principal.Nel campo Nuove entità, aggiungi i seguenti dettagli in base al tipo di scheda:
- Per una scheda privata, inserisci gli indirizzi email dell'identità a cui vuoi concedere l'accesso.
- Per una scheda pubblica, aggiungi
allAuthenticatedUsers
.
Per Seleziona un ruolo, tieni il puntatore del mouse su Analytics Hub e poi, in base al tipo di scheda, seleziona uno dei seguenti ruoli:
- Per una scheda commerciale, seleziona il ruolo Visualizzatore Analytics Hub. Questo ruolo consente agli utenti di visualizzare la scheda e richiedere l'accesso.
- Per una scheda pubblica privata o non commerciale, seleziona il ruolo Abbonato a Analytics Hub. Questo ruolo consente agli utenti di iscriversi alla tua scheda.
Fai clic su Salva.
Per saperne di più, consulta i ruoli di abbonato e visualizzatore Analytics Hub.
Gestisci gli abbonamenti
Per consentire a un utente di abbonarsi a una scheda con un argomento condiviso, assegnagli i ruoli Iscritto ad Analytics Hub (roles/analyticshub.subscriber
) e Proprietario abbonamento Analytics Hub (roles/analyticshub.subscriptionOwner
) per una scheda specifica:
Vai alla pagina Analytics Hub.
Fai clic sul nome dello scambio di dati che contiene la scheda per cui vuoi gestire gli abbonamenti.
Fai clic sulla scheda per cui desideri elencare tutti gli iscritti.
Fai clic su
Imposta autorizzazioni.Per aggiungere entità, fai clic su
Aggiungi principal.Nel campo Nuove entità, inserisci i nomi utente o gli indirizzi email dei sottoscrittori che vuoi aggiungere.
In Seleziona un ruolo, scegli Analytics Hub > abbonato Analytics Hub.
Fai clic su
Aggiungi un altro ruolo.In Seleziona un ruolo, scegli Analytics Hub > proprietario abbonamento Analytics Hub.
Fai clic su Salva.
Puoi eliminare e aggiornare gli abbonati in qualsiasi momento facendo clic su Imposta autorizzazioni.
Revocare un abbonamento
Per rimuovere una sottoscrizione a un elenco di argomenti condivisi da Analytics Hub, seleziona una delle seguenti opzioni:
Console
Per elencare tutti gli abbonati di una scheda, segui le istruzioni della console Google Cloud in Visualizzare tutti gli abbonamenti.
Fai clic sulla scheda Abbonamenti per visualizzare tutti gli abbonamenti ai dati. piattaforma di scambio pubblicitario.
Seleziona la casella di controllo accanto agli abbonamenti che vuoi rimuovere oppure seleziona tutte le sottoscrizioni.
Nella finestra di dialogo Revocare l'abbonamento?, inserisci la revoca per confermare.
Fai clic su Revoca.
API
Per rimuovere un abbonamento, utilizza 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 della sottoscrizione che da rimuovere.LOCATION
: località dell'abbonamento.SUBSCRIPTION_ID
: l'ID dell'abbonamento che vuoi rimuovere.
Revocando un abbonamento da Analytics Hub, un sottoscrittore non riceverà più i dati dei messaggi dall'argomento condiviso. La sottoscrizione Pub/Sub è scollegata dall'argomento condiviso. Se un abbonamento viene eliminato direttamente da Pub/Sub, l'abbonamento ad Analytics Hub verrà mantenuto e dovrà essere ripulito.
Flussi di lavoro dei sottoscrittori
Grazie al tuo abbonamento ad Analytics Hub, puoi visualizzare e iscriverti a una scheda. L'iscrizione a un elenco di un argomento condiviso crea una sottoscrizione Pub/Sub collegata nel progetto del sottoscrittore. La sottoscrizione Pub/Sub sarà visibile nel progetto del publisher.
Autorizzazioni aggiuntive per gli abbonati
Per eseguire le attività degli iscritti, devi disporre del ruolo Abbonato ad Analytics Hub (roles/analyticshub.subscriber
) a livello di progetto, piattaforma di scambio o scheda.
Iscriversi a un elenco di argomenti condivisi
Per iscriverti a una scheda con un argomento condiviso, seleziona una delle seguenti opzioni:
Console
Per visualizzare un elenco di schede a cui hai accesso, segui i passaggi descritti in Visualizzare le schede.
Sfoglia le schede e fai clic su una a cui vuoi iscriverti. Viene visualizzata una finestra di dialogo con i dettagli della scheda.
Fai clic su Abbonati per aprire la finestra di dialogo Crea abbonamento.
Se l'API Analytics Hub non è abilitata nel tuo progetto, viene visualizzato un messaggio di errore con un link per abilitare l'API. Fai clic su Abilita API Analytics Hub.
Nella finestra di dialogo Crea abbonamento, specifica i seguenti dettagli:
- Subscription ID (ID abbonamento): specifica il nome dell'abbonamento che stai creando.
- Tipo di recapito: seleziona il meccanismo di recapito dei dati del messaggio.
- Durata di conservazione dei messaggi:imposta la durata di conservazione dei messaggi.
- Periodo di scadenza:viene impostato quando l'abbonamento scadrà dopo un periodo di inattività, se presente.
- Scadenza per la conferma: imposta la data e l'ora della scadenza per la conferma.
- Filtro sottoscrizioni:imposta la sintassi del filtro per i messaggi.
- Consegna "exactly-once":attiva la consegna "exactly-once".
- Ordinamento dei messaggi:abilita l'ordinamento dei messaggi con una chiave di ordine.
- Messaggi non recapitabili: abilita i messaggi non recapitabili.
- Criterio per i nuovi tentativi: imposta un criterio per i nuovi tentativi.
Per ulteriori informazioni sulle proprietà delle sottoscrizioni Pub/Sub, consulta le proprietà delle sottoscrizioni.
Per salvare le modifiche, fai clic su Crea. La sottoscrizione Pub/Sub collegata viene creata nel progetto.
API
Utilizza il metodo projects.locations.dataExchanges.listings.subscribe
.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto della scheda che a cui vuoi abbonarti.LOCATION
: posizione della scheda che a cui vuoi abbonarti.DATAEXCHANGE_ID
: l'ID piattaforma di scambio di dati del scheda a cui vuoi abbonarti.LISTING_ID
: l'ID scheda che vuoi .
Nel corpo della richiesta, specifica la sottoscrizione Pub/Sub in cui vuoi creare abbonamento Pub/Sub collegato. In caso di esito positivo, il corpo della risposta è vuoto.
Per ulteriori informazioni sulle sottoscrizioni Pub/Sub, consulta la panoramica delle sottoscrizioni.
Prezzi
I publisher di argomenti Pub/Sub possono elencare e condividere gli argomenti tramite Analytics Hub senza costi aggiuntivi. Ai publisher viene addebitato il numero totale di byte scritti (velocità effettiva di pubblicazione) nell'argomento condiviso e in uscita dalla rete (se applicabile). Ai sottoscrittori viene addebitato il numero totale di byte letti (velocità effettiva di sottoscrizione) dall'abbonamento collegato e dal traffico in uscita dalla rete (se applicabile). Per ulteriori dettagli, vedi Prezzi di Pub/Sub.
Controlli di servizio VPC
Per gli argomenti condivisi da progetti che hanno perimetri Controlli di servizio VPC, puoi impostare le regole appropriate in entrata e in uscita necessarie per concedere l'accesso a publisher e sottoscrittori.