Configura e utilizza la risoluzione delle entità in BigQuery

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

Gli utenti finali possono utilizzare questo documento per connettersi con un provider di identità e utilizzare per far corrispondere i record. I provider di identità possono utilizzare questo documento per impostare e configurare i servizi da condividere con gli utenti finali sul in Google Cloud Marketplace.

Flusso di lavoro per gli utenti finali

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

Prima di iniziare

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire job di risoluzione delle entità, chiedi all'amministratore di concederti 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:

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

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Traduci o risolvi entità

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

LiveRamp

Prerequisiti

Configurazione

I seguenti passaggi sono necessari quando utilizzi LiveRamp Embedded Identity per per la prima volta. Al termine della configurazione, solo la tabella di input e la tabella dei metadati e modificare l'output tra le esecuzioni.

Crea una tabella di input

Crea una tabella nel set di dati di input. Compila la tabella con RampID, target domini e tipi di target. Per dettagli ed esempi, vedi Colonne e descrizioni della tabella di input.

Crea 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. Compila la tabella dei metadati con ID client, modalità di esecuzione e destinazione domini e tipi di target. Per dettagli ed esempi, vedi Colonne e descrizioni della tabella dei metadati.

Condividere le tabelle con LiveRamp

Concedi all'account di servizio Google Cloud LiveRamp l'accesso per visualizzare e elaborare i dati nel set di dati di input. Per dettagli ed esempi, vedi Condividere tabelle e set di dati con LiveRamp.

Esegui un job di identità incorporato

Per eseguire un job di identità incorporato con LiveRamp in BigQuery, esegui la seguenti:

  1. Verifica che tutti i RampID codificati nel tuo dominio siano presenti nel tuo input tabella.
  2. Verifica che la tabella dei metadati sia ancora accurata prima di eseguire il job.
  3. Contatto LiveRampIdentitySupport@liveramp.com con una richiesta di processo. Includi l'ID progetto, l'ID del set di dati e la tabella ID (se applicabile) per la tabella di input, la tabella di metadati e l'output del set di dati. Per ulteriori informazioni, vedi Invia una notifica a LiveRamp per l'avvio della transcodifica.

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

Supporto LiveRamp

Per problemi di assistenza, contatta Assistenza per LiveRamp Identity.

Fatturazione LiveRamp

LiveRamp gestisce la fatturazione per l'entità risoluzione del problema.

Flusso di lavoro per i provider di identità

Le sezioni seguenti mostrano ai provider di identità come configurare le entità in BigQuery. Per una rappresentazione visiva per completare la configurazione, consulta per la risoluzione delle entità.

Prima di iniziare

  1. Crea un Cloud Run un lavoro o un funzione Cloud Functions Functions per l'integrazione con la funzione remota. Entrambe le opzioni sono adatte a questo scopo che non ha uno scopo specifico.

  2. Prendi nota del nome dell'account di servizio associato all'account di servizio. Funzione Cloud Run o Cloud Functions:

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

      Vai a Cloud Functions

    2. Fai clic sul nome della funzione, quindi sulla scheda Dettagli.

    3. Nel riquadro Informazioni generali, individua e prendi nota del servizio il nome dell'account per la funzione remota.

  3. Crea un funzione remota.

  4. Raccogli le entità dell'utente finale dall'utente finale.

Ruoli obbligatori

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

  • Per consentire all'account di servizio associato alla tua funzione di leggere e scrivere sui set di dati associati e avviare job:
  • Per consentire all'entità dell'utente finale di visualizzare e connettersi alla funzione remota:

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

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Condividi funzione remota di risoluzione entità

Modifica e condividi il seguente codice dell'interfaccia remota con l'utente finale. Fine l'utente 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 sono 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. Esempi di includono 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. Ciò ti consente di impostare modello di determinazione del prezzo in base all'utilizzo del job di risoluzione delle entità, con Google che gestisce la fatturazione te. Per ulteriori informazioni, vedi Offerta di prodotti SaaS (Software as a Service).