Configurare e utilizzare la risoluzione delle entità in BigQuery

Questo documento mostra come implementare la risoluzione dell'entità per gli utenti finali che si occupano di risoluzione delle entità (di seguito denominati utenti finali) e i provider di identità.

Gli utenti finali possono utilizzare questo documento per connettersi con un provider di identità e utilizzare il servizio del provider per associare i record. I provider di identità possono utilizzare questo documento per impostare e configurare i servizi da condividere con gli utenti finali su Google Cloud Marketplace.

Flusso di lavoro per gli utenti finali

Le seguenti sezioni mostrano agli utenti finali come configurare la risoluzione delle entità in BigQuery. Per una rappresentazione visiva della configurazione completa, consulta l'architettura per la risoluzione delle entità.

Prima di iniziare

Contatta e stabilisci una relazione con un provider di identità. BigQuery supporta la risoluzione delle entità con LiveRamp.
Acquisisci i seguenti elementi dal provider di identità:
- Credenziali dell'account di servizio
- Firma della funzione remota
Crea due set di dati nel progetto:
- Set di dati di input
- Set di dati di output

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire i job di risoluzione delle entità, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per consentire all'account di servizio del provider di identità di leggere il set di dati di input e scrivere nel set di dati di output:
- Visualizzatore dati BigQuery (roles/bigquery.dataViewer) sul set di dati di input
- Editor dati BigQuery (roles/bigquery.dataEditor) sul set di dati di output

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Tradurre o risolvere entità

Per le istruzioni specifiche per il provider di identità, consulta le sezioni seguenti.

LiveRamp

Prerequisiti

Configurare l'identità incorporata LiveRamp in BigQuery. Per ulteriori informazioni, consulta Abilitazione dell'identità incorporata LiveRamp in BigQuery.
Coordinati con LiveRamp per abilitare le credenziali API da utilizzare con Embedded Identity. Per ulteriori informazioni, consulta la sezione Autenticazione.

Configurazione

I passaggi seguenti sono obbligatori quando utilizzi per la prima volta l'identità LiveRamp Embedded. Al termine della configurazione, è necessario modificare solo la tabella di input e la tabella dei metadati tra un'esecuzione e l'altra.

Crea una tabella di input

Crea una tabella nel set di dati di input. Completare la tabella con RampID, domini di destinazione e tipi di destinazione. Per dettagli ed esempi, consulta Colonne e descrizioni della tabella di input.

Creare una tabella di metadati

La tabella dei metadati viene utilizzata per controllare l'esecuzione di LiveRamp Embedded Identity su BigQuery. Crea una tabella di metadati nel set di dati di input. Completare la tabella dei metadati con gli ID client, le modalità di esecuzione, i domini di destinazione e i tipi di destinazione. Per dettagli ed esempi, consulta Colonne e descrizioni della tabella dei metadati.

Condividere tabelle con LiveRamp

Concedi all'account di servizio LiveRamp Google Cloud l'accesso per visualizzare ed elaborare i dati nel tuo set di dati di input. Per dettagli ed esempi, consulta la pagina relativa alla condivisione di tabelle e set di dati con LiveRamp.

Esegui un job di identità incorporato

Per eseguire un job di identità incorporato con LiveRamp in BigQuery:

Verifica che tutti i RampID codificati nel tuo dominio siano presenti nella tabella di input.
Verifica che la tabella dei metadati sia ancora accurata prima di eseguire il job.
Contatta [email protected] con una richiesta di processo del job. Includi l'ID progetto, l'ID set di dati e l'ID tabella (se applicabile) per la tabella di input, la tabella dei metadati e il set di dati di output. Per maggiori informazioni, consulta Inviare una notifica a LiveRamp per avviare la transcodifica.

In genere i risultati vengono inviati al set di dati di output entro tre giorni lavorativi.

Supporto di LiveRamp

Per problemi, contatta l'assistenza di LiveRamp Identity.

Fatturazione LiveRamp

LiveRamp gestisce la fatturazione per la risoluzione dell'entità.

Flusso di lavoro per i provider di identità

Le seguenti sezioni mostrano i provider di identità come configurare la risoluzione delle entità in BigQuery. Per una rappresentazione visiva della configurazione completa, consulta l'architettura per la risoluzione delle entità.

Prima di iniziare

Crea un job Cloud Run o una funzione Cloud Functions da integrare con la funzione remota. Entrambe le opzioni sono adatte a questo scopo.
Prendi nota del nome dell'account di servizio associato a Cloud Run o alla Cloud Function:
1. Nella console Google Cloud, vai alla pagina Cloud Functions.
  
  Vai a Cloud Functions
2. Fai clic sul nome della funzione e poi sulla scheda Dettagli.
3. Nel riquadro Informazioni generali, individua e prendi nota del nome dell'account di servizio per la funzione remota.
Crea una funzione remota.
Raccogli le entità utente finale dall'utente finale.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire i job di risoluzione delle entità, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per l'account di servizio associato alla funzione per leggere e scrivere sui set di dati associati e sui job di avvio:
- Editor dati BigQuery (roles/bigquery.dataEditor) sul progetto
- Utente job BigQuery (roles/bigquery.jobUser) sul progetto
Affinché l'entità utente finale possa visualizzare e connettersi alla funzione remota:
- Utente connessione BigQuery (roles/bigquery.connectionUser) sulla connessione
- Visualizzatore dati BigQuery (roles/bigquery.dataViewer) sul set di dati del piano di controllo con la funzione remota

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Condividi funzione remota di risoluzione entità

Modifica e condividi il seguente codice dell'interfaccia remota con l'utente finale. L'utente finale ha bisogno di questo codice per avviare il job di risoluzione delle entità.

`PARTNER_PROJECT_ID.DATASET_ID`.match`(LIST_OF_PARAMETERS)

Sostituisci LIST_OF_PARAMETERS con l'elenco dei parametri che vengono passati alla funzione remota.

(Facoltativo) Fornisci i metadati del job

Facoltativamente, puoi fornire i metadati del job utilizzando una funzione remota separata o scrivendo una nuova tabella di stato nel set di dati di output dell'utente. Alcuni esempi di metadati sono gli stati e le metriche dei job.

Fatturazione per i provider di identità

Per semplificare la fatturazione e l'onboarding dei clienti, ti consigliamo di integrare il servizio di risoluzione delle entità con Google Cloud Marketplace. In questo modo puoi configurare un modello di prezzi basato sull'utilizzo del job di risoluzione delle entità, con Google che gestisce la fatturazione al posto tuo. Per maggiori informazioni, consulta la sezione Offerta di prodotti SaaS (Software as a Service).