Gestire le schede

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

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

   Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.

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

3. Fai clic su add_box Crea scheda.

4. Nella sezione Configura dati, seleziona Set di dati BigQuery o Argomento Pub/Sub dal menu Tipo di risorsa.

   • Se selezioni Set di dati BigQuery, procedi nel seguente modo:

     1. Nel menu Set di dati condiviso, seleziona un set di dati esistente o fai clic su Crea un set di dati per crearne uno nuovo. Seleziona il set di dati che vuoi elencare nello scambio di dati. Il set di dati deve trovarsi nella stessa regione del data exchange. Non puoi aggiornare questo campo dopo la creazione della scheda. Il nome del set di dati di origine e l'ID del progetto che contiene il set di dati vengono restituiti quando i sottoscrittori visualizzano i metadati del set di dati collegato.

     2. Espandi il menu Disponibilità dei dati per regione (anteprima) per rendere disponibile il set di dati condiviso in altre regioni. Il menu mostra le regioni in cui esistono repliche del set di dati con l'etichetta Pronto per l'uso. Prima di configurare la scheda per più regioni, verifica di aver attivato la replica dei set di dati tra regioni nel set di dati condiviso, in quanto puoi selezionare solo le regioni in cui è attivata la replica dei set di dati tra regioni. Tutte le altre regioni sono contrassegnate come Non disponibile. Se non viene selezionata alcuna regione aggiuntiva, la scheda utilizza per impostazione predefinita la regione principale del set di dati condiviso, etichettata come Provider principale.

     3. In Controlli del traffico in uscita dei dati, seleziona l'opzione traffico in uscita dei dati appropriata.

        • Per applicare restrizioni all'uscita dei dati al set di dati condiviso, ma non ai risultati delle query del set di dati condiviso, seleziona Disattiva copia ed esportazione dei dati condivisi.
        • Per applicare restrizioni all'uscita dei dati al set di dati condiviso e ai risultati delle query del set di dati condiviso, seleziona Disabilita la copia e l'esportazione dei risultati delle query, che imposterà automaticamente anche Disabilita la copia e l'esportazione dei dati condivisi.
        • Per applicare le limitazioni di uscita della copia e dell'esportazione dell'API Data al tuo set di dati condiviso, seleziona Disabilita la copia e l'esportazione delle tabelle nelle API, che imposterà automaticamente anche Disabilita la copia e l'esportazione dei dati condivisi.

   • Se selezioni Argomento Pub/Sub, nel menu Argomento condiviso puoi selezionare un argomento Pub/Sub esistente o fare clic su Crea un argomento per crearne uno nuovo.

5. Nella sezione Dettagli scheda, in Nome visualizzato, inserisci il nome della scheda.

6. Inserisci i seguenti dettagli facoltativi:

   • Categoria: seleziona fino a due categorie che rappresentano al meglio la tua scheda. Gli iscritti possono filtrare gli elenchi in base a queste categorie.

   • Affinità dei dati: le regioni utilizzate dall'editore per la pubblicazione dei dati se utilizzi un argomento Pub/Sub. Queste informazioni sono utili per gli abbonati per ridurre al minimo o evitare i costi di traffico in uscita dalla rete Pub/Sub leggendo i dati dalla stessa regione. Per ulteriori informazioni sui costi di uscita, consulta Costi di trasferimento dei dati.

   • Icona: un'icona per la tua scheda. Sono supportati i formati file PNG e JPEG. Le icone devono avere una dimensione file inferiore a 512 KiB e dimensioni non superiori a 512 x 512 pixel.

   • Descrizione: una breve descrizione della scheda. Gli abbonati possono cercare annunci in base alla descrizione.

   • Rilevabilità pubblica: attiva la rilevabilità pubblica della tua scheda nel catalogo di condivisione BigQuery. Se attivi questa opzione, concedi a allUsers o allAuthenticatedUsers il ruolo di Visualizzatore di Analytics Hub (roles/analyticshub.viewer). Per saperne di più, vedi Concedere il ruolo per una scheda. Se l'exchange è già pubblico, le autorizzazioni per le schede sono già ereditate e non sono necessari ulteriori interventi.

     Gli scambi rilevabili pubblicamente non possono avere schede private a causa dell'ereditarietà delle autorizzazioni, ma gli scambi privati possono avere schede pubbliche. Per creare schede pubbliche, il progetto in cui si trova la scheda di dati deve avere un'organizzazione e un account di fatturazione associati. Se stai creando una scheda commerciale integrata in Cloud Marketplace, ti consigliamo di renderla rilevabile pubblicamente.

   • Documentazione > Markdown: informazioni aggiuntive, ad esempio link a documentazione pertinente e qualsiasi informazione aggiuntiva che possa aiutare gli abbonati a utilizzare l'argomento.

7. Nella sezione Informazioni di contatto della scheda, inserisci i seguenti dettagli facoltativi:

   • Contatto principale: inserisci un ID email o un URL del contatto principale per la scheda.

   • Contatto per la richiesta di accesso: inserisci un ID email o un URL del modulo di acquisizione per consentire agli abbonati di contattarti.

   • Fornitore: espandi la sezione Fornitore e specifica i dettagli nei seguenti campi:

     • Nome del fornitore: il nome del fornitore dell'argomento.
     • Contatto principale del provider: un ID email o un URL del contatto principale del provider dell'argomento.

     Gli abbonati possono filtrare le schede in base ai fornitori di dati.

   • Publisher: espandi la sezione Publisher e specifica i dettagli nei seguenti campi:

     • Nome publisher: il nome del publisher che sta creando la scheda.
     • Contatto principale dell'editore: un ID email o un URL del contatto principale dell'editore dell'argomento.

8. Esamina la sezione Anteprima scheda.

9. Fai clic su Pubblica.

API

Utilizza il metodo projects.locations.dataExchanges.listings.create.

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 il data exchange in cui vuoi creare la scheda.
• LOCATION: la posizione dello scambio di dati. Per ulteriori informazioni sulle località che supportano la condivisione di BigQuery, consulta Regioni supportate.
• DATAEXCHANGE_ID: l'ID dello scambio di dati.
• LISTING_ID: l'ID scheda.

Nel corpo della richiesta, fornisci i dettagli della scheda.

Per creare una scheda per più regioni (anteprima), specifica le regioni aggiuntive nel campo bigqueryDataset.replicaLocations nel corpo della richiesta. Prima di configurare la scheda per più regioni, verifica di aver attivato la replica dei set di dati tra regioni nel set di dati condiviso. Puoi selezionare solo le regioni in cui è abilitata la replica dei set di dati tra regioni. Se questo campo facoltativo non è incluso, la scheda viene creata utilizzando la regione principale del set di dati condiviso.

Se la richiesta ha esito positivo, il corpo della risposta contiene i dettagli della scheda. Se attivi la registrazione delle email degli iscritti (anteprima), la risposta alla scheda contiene log_linked_dataset_query_user_email: true.

Per saperne di più sulle attività che puoi eseguire sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Fai clic sul nome dello scambio di dati contenente la scheda.

3. Fai clic sulla scheda per cui vuoi aggiungere iscritti.

4. Fai clic su person Imposta autorizzazioni.

5. Per aggiungere entità, fai clic su person_add Aggiungi entità.

6. Nel campo Nuove entità, aggiungi i seguenti dettagli in base al tipo di scheda:

   • Per una scheda privata, inserisci gli ID email dell'identità a cui vuoi concedere l'accesso.

   • Per una scheda pubblica, aggiungi allAuthenticatedUsers.

   • Per una scheda pubblica rilevabile da tutti, inclusi gli utenti nonGoogle Cloud, aggiungi allUsers.

7. 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 (incluse le schede integrate in Cloud Marketplace), seleziona il ruolo Visualizzatore Analytics Hub. Questo ruolo consente agli utenti di visualizzare l'elenco e richiedere l'accesso.

   • Per una scheda pubblica privata o non commerciale, seleziona il ruolo Abbonato ad Analytics Hub. Questo ruolo consente agli utenti di iscriversi alla tua scheda.

   • Per le schede integrate in Cloud Marketplace, non è necessario concedere il ruolo Abbonato di Analytics Hub, in quanto gli abbonamenti sono gestiti e regolati automaticamente in base all'ordine di Cloud Marketplace.

   Per ulteriori informazioni, vedi Ruoli di abbonato e visualizzatore di Analytics Hub.

8. Fai clic su Salva.

   Per ulteriori informazioni, vedi Ruoli di abbonato e visualizzatore di Analytics Hub.

9. Fai clic su Salva.

API

1. Leggi la policy esistente con il metodo getIamPolicy della scheda utilizzando il metodo projects.locations.dataExchanges.listings.getIamPolicy.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto, ad esempio my-project-1.
   • LOCATION: la posizione del data exchange che contiene la scheda.
   • DATAEXCHANGE_ID: l'ID dello scambio di dati.
   • LISTING_ID: l'ID scheda.

   La condivisione restituisce la policy corrente nella risposta.

2. Per aggiungere o rimuovere i membri e i relativi ruoli associati, modifica la policy con un editor di testo. Utilizza il seguente formato per aggiungere membri:

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   Ad esempio, per concedere il ruolo roles/analyticshub.subscriber a group:subscribers@example.com, aggiungi la seguente associazione alla policy:

   {
    "members": [
      "group:subscribers@example.com"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Scrivi la policy aggiornata utilizzando il metodo projects.locations.dataExchanges.listings.setIamPolicy. Nel corpo della richiesta, fornisci la policy IAM aggiornata del passaggio precedente.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy
   

   Nel corpo della richiesta, fornisci i dettagli della scheda. Se la richiesta ha esito positivo, il corpo della risposta contiene i dettagli della scheda.

Per saperne di più sulle attività che puoi eseguire sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Fai clic sul nome dello scambio di dati contenente la scheda per la quale vuoi gestire gli abbonamenti.

3. Fai clic sulla scheda per cui vuoi elencare tutti gli iscritti.

4. Per visualizzare tutti gli iscritti al tuo annuncio, fai clic su Gestisci abbonamenti.

   

5. (Facoltativo) Puoi filtrare i risultati in base ai dettagli degli iscritti.

In alternativa, se hai accesso al set di dati condiviso, puoi seguire questi passaggi per elencare gli abbonati:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e seleziona il set di dati condiviso.

3. Nell'elenco Condivisione di person_add, seleziona Gestisci abbonamenti.

SQL

Il seguente esempio utilizza la vista INFORMATION_SCHEMA.SCHEMATA_LINKS per elencare tutti i set di dati collegati a un set di dati condiviso in myproject che si trovano nella regione us:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

L'output è simile al seguente. Alcune colonne vengono omesse per semplificare l'output.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

Per una scheda con più regioni (Anteprima), puoi visualizzare gli abbonamenti nelle diverse regioni sostituendo la regione us con la posizione di replica prevista. Ad esempio, per visualizzare i set di dati collegati a un set di dati condiviso in myproject che si trovano nella regione eu, utilizza la seguente query:

SELECT * FROM `myproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

API

Utilizza il metodo projects.locations.dataExchanges.listings.listSubscriptions.

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto dell'elenco a cui vuoi abbonarti.
• LOCATION: la posizione dell'annuncio a cui vuoi abbonarti.
• DATAEXCHANGE_ID: l'ID piattaforma di scambio di dati che contiene l'elenco a cui vuoi abbonarti.
• LISTING_ID: l'ID della scheda a cui vuoi abbonarti.

Console

1. Per elencare tutti gli iscritti a una scheda, segui le istruzioni della console Google Cloud in Visualizzare tutti gli abbonamenti.

2. Fai clic sulla scheda Sottoscrizioni.

3. Per rimuovere un abbonato da un elenco, seleziona gli abbonamenti che vuoi rimuovere e fai clic su delete Rimuovi abbonamenti.

4. Nella finestra di dialogo Rimuovere l'abbonamento?, inserisci remove per confermare.

5. Fai clic su Rimuovi.

API

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 che vuoi rimuovere.
• LOCATION: la posizione dell'abbonamento che vuoi rimuovere.
• SUBSCRIPTION: l'ID dell'abbonamento che vuoi rimuovere.

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Fai clic sul nome dello scambio di dati contenente la scheda.

3. Fai clic sulla scheda che vuoi aggiornare.

4. Fai clic su mode_edit Modifica scheda.

5. Modifica i valori nei campi. Puoi modificare tutti i valori, ad eccezione del set di dati di origine della scheda.

6. Facoltativamente,

   • Se attivi la visibilità pubblica, concedi allUsers o allAuthenticatedUsers il ruolo Visualizzatore Analytics Hub (roles/analyticshub.viewer). Per ulteriori informazioni, vedi Concedere il ruolo per una scheda
   • Se disattivi la visibilità pubblica, rimuovi il ruolo Visualizzatore Analytics Hub da allUsers e allAuthenticatedUsers. Gli scambi pubblici non possono avere schede private, ma gli scambi privati possono avere schede pubbliche.
   • Se abiliti e salvi il logging delle email dei sottoscrittori, questa impostazione non può essere modificata. Per disabilitare il logging, elimina la scheda e ricreala senza fare clic sul pulsante di attivazione/disattivazione Logging email dei sottoscrittori (Anteprima).
   • Aggiungi o rimuovi regioni dalla scheda (Anteprima). Prima di aggiungere più regioni, verifica di aver attivato la replica dei set di dati tra regioni nel set di dati condiviso. Quando rimuovi le regioni, elimina prima la replica del set di dati condiviso in quella regione.

7. Visualizza l'anteprima della scheda.

8. Per salvare le modifiche, fai clic su Salva. Per evitare discrepanze con le schede integrate in Cloud Marketplace, viene visualizzata una notifica che richiede un aggiornamento della scheda di prodotto di dati di Cloud Marketplace.

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 UPDATEMASK con l'elenco dei campi che vuoi aggiornare. Per aggiornare più valori, utilizza un elenco separato da virgole. Nel corpo della richiesta, specifica i valori aggiornati.

Nel corpo della richiesta, specifica i valori aggiornati per i seguenti campi:

• Nome visualizzato
• Descrizione
• Categorie
• Documentazione
• Icona
• Contatto principale
• Rilevabilità pubblica
• Logging email dei sottoscrittori (anteprima)

Per informazioni dettagliate su questi campi, consulta Risorsa: scheda.

Quando aggiorni le regioni di replica per la tua scheda, assicurati di specificare tutte le regioni applicabili. Prima di aggiornare la scheda, verifica di aver attivato la replica dei set di dati tra regioni sul set di dati condiviso. Puoi aggiungere solo regioni (anteprima) in cui il set di dati condiviso è replicato. Per rimuovere una regione, elimina la replica del set di dati condiviso per la regione prima di rimuoverla dall'elenco. Puoi aggiornare le regioni di replica solo per le schede appena create per più regioni. Non puoi convertire le schede preesistenti in schede per più regioni.

Per saperne di più sulle attività che puoi eseguire sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.

Console

1. Vai alla pagina Condivisione (Analytics Hub).

   Vai a Condivisione (Analytics Hub)

2. Fai clic sul nome dello scambio di dati contenente la scheda.

3. Fai clic sulla scheda che vuoi eliminare.

4. Fai clic su delete Elimina.

5. Nella finestra di dialogo Vuoi eliminare la scheda?, conferma l'eliminazione digitando elimina.

6. 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

Per saperne di più sulle attività che puoi eseguire sulle schede utilizzando le API, consulta i metodi projects.locations.dataExchanges.listings.