Configura y usa la resolución de entidades en BigQuery

En este documento, se muestra cómo implementar la resolución de entidades para los usuarios finales de la resolución de entidades (en adelante, usuarios finales) y los proveedores de identidad.

Los usuarios finales pueden usar este documento para conectarse con un proveedor de identidad y usar el servicio del proveedor para correlacionar registros. Los proveedores de identidad pueden usar este documento para configurar los servicios para compartirlos con los usuarios finales en Google Cloud Marketplace.

Flujo de trabajo para usuarios finales

En las siguientes secciones, se muestra a los usuarios finales cómo configurar la resolución de entidades en BigQuery. Para obtener una representación visual de la configuración completa, consulta la arquitectura para la resolución de entidades.

Antes de comenzar

1. Comunícate con un proveedor de identidad y establece una relación con él. BigQuery admite la resolución de entidades con LiveRamp.
2. Adquiere los siguientes elementos del proveedor de identidad:
   • Credenciales de cuenta de servicio
   • Firma de la función remota
3. Crea dos conjuntos de datos en tu proyecto:
   • Conjunto de datos de entrada
   • Conjunto de datos de salida

Roles requeridos

Para obtener los permisos que necesitas para ejecutar trabajos de resolución de entidades, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Para que la cuenta de servicio del proveedor de identidad lea el conjunto de datos de entrada y escriba en el conjunto de datos de salida, sigue estos pasos:
  • Visualizador de datos de BigQuery (roles/bigquery.dataViewer) en el conjunto de datos de entrada
  • Editor de datos de BigQuery (roles/bigquery.dataEditor) en el conjunto de datos de salida

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Traducir o resolver entidades

Para obtener instrucciones específicas del proveedor de identidad, consulta las siguientes secciones.

LiveRamp

Requisitos previos

• Configurar la identidad incorporada de LiveRamp en BigQuery. Para obtener más información, consulta Cómo habilitar la identidad incorporada de LiveRamp en BigQuery.
• Coordínate con LiveRamp para habilitar las credenciales de la API para usarlas con la identidad integrada. Para obtener más información, consulta Autenticación.

Configuración

Los siguientes pasos son obligatorios cuando usas la identidad incorporada de LiveRamp por primera vez. Una vez que se completa la configuración, solo se deben modificar la tabla de entrada y la tabla de metadatos entre ejecuciones.

Crea una tabla de entrada

Crea una tabla en el conjunto de datos de entrada. Propaga la tabla con RampIDs, dominios de destino y tipos de destino. Para obtener detalles y ejemplos, consulta Columnas y descripciones de la tabla de entrada.

Crea una tabla de metadatos

La tabla de metadatos se usa para controlar la ejecución de la identidad incorporada de LiveRamp en BigQuery. Crea una tabla de metadatos en el conjunto de datos de entrada. Propaga la tabla de metadatos con los IDs de cliente, los modos de ejecución, los dominios de destino y los tipos de destino. Para obtener detalles y ejemplos, consulta Columnas y descripciones de la tabla de metadatos.

Comparte tablas con LiveRamp

Otorga a la cuenta de servicio de LiveRamp Google Cloud acceso para ver y procesar datos en tu conjunto de datos de entrada. Para obtener más detalles y ejemplos, consulta Comparte tablas y conjuntos de datos con LiveRamp.

Ejecuta un trabajo de identidad integrada

Para ejecutar un trabajo de identidad incorporada con LiveRamp en BigQuery, haz lo siguiente:

1. Confirma que todos los RampIDs codificados en tu dominio se encuentren en tu tabla de entrada.
2. Antes de ejecutar el trabajo, confirma que la tabla de metadatos siga siendo precisa.
3. Comunícate con [e-mail] para solicitar un proceso de trabajo. Incluye el ID del proyecto, el ID del conjunto de datos y el ID de la tabla (si corresponde) para tu tabla de entrada, tabla de metadatos y conjunto de datos de salida. Para obtener más información, consulta Notifica a LiveRamp para que inicie la transcodificación.

Por lo general, los resultados se entregan en tu conjunto de datos de salida en un plazo de tres días hábiles.

Asistencia de LiveRamp

Si tienes problemas con la asistencia, comunícate con el equipo de asistencia de LiveRamp Identity.

Facturación de LiveRamp

LiveRamp se encarga de la facturación de la resolución de entidades.

Flujo de trabajo para proveedores de identidad

En las siguientes secciones, se muestra a los proveedores de identidad cómo configurar la resolución de entidades en BigQuery. Para obtener una representación visual de la configuración completa, consulta la arquitectura para la resolución de entidades.

Antes de comenzar

1. Crea un trabajo de Cloud Run o una función de Cloud Run para integrarlo a la función remota. Ambas opciones son adecuadas para este propósito.

2. Toma nota del nombre de la cuenta de servicio asociada con la función de Cloud Run o con Cloud Run:

   1. En la Google Cloud consola, ve a la página de Cloud Functions.

      Ir a Cloud Functions

   2. Haz clic en el nombre de la función y, luego, en la pestaña Detalles.

   3. En el panel Información general, busca y anota el nombre de la cuenta de servicio de la función remota.

3. Crea una función remota

4. Recopila los principales del usuario final.

Roles requeridos

Para obtener los permisos que necesitas para ejecutar trabajos de resolución de entidades, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Para la cuenta de servicio asociada con tu función para leer y escribir en conjuntos de datos asociados y trabajos de inicio, sigue estos pasos:
  • Editor de datos de BigQuery (roles/bigquery.dataEditor) en el proyecto
  • Usuario de trabajo de BigQuery (roles/bigquery.jobUser) en el proyecto
• Para que el principal del usuario final vea la función remota y se conecte a ella, haz lo siguiente:
  • Usuario de conexión de BigQuery (roles/bigquery.connectionUser) en la conexión
  • Visualizador de datos de BigQuery (roles/bigquery.dataViewer) en el conjunto de datos del plano de control con la función remota

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Comparte la función remota de resolución de entidades

Modifica y comparte el siguiente código de la interfaz remota con el usuario final. El usuario final necesita este código para iniciar el trabajo de resolución de entidades.

`PARTNER_PROJECT_ID.DATASET_ID`.match`(LIST_OF_PARAMETERS)

Reemplaza LIST_OF_PARAMETERS por la lista de parámetros que se pasan a la función remota.

Opcional: Proporciona metadatos del trabajo

De manera opcional, puedes proporcionar metadatos del trabajo con una función remota independiente o escribiendo una tabla de estado nueva en el conjunto de datos de salida del usuario. Entre los ejemplos de metadatos, se incluyen los estados y las métricas de los trabajos.

Facturación de proveedores de identidad

Para optimizar la facturación y la integración del cliente, te recomendamos que integres el servicio de resolución de entidades en Google Cloud Marketplace. Esto te permite configurar un modelo de precios basado en el uso del trabajo de resolución de entidades, y Google se encarga de la facturación. Para obtener más información, consulta Cómo ofrecer productos de software como servicio (SaaS).