Regla de análisis de tablas de mapeo de ID - AWS Clean Rooms

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Regla de análisis de tablas de mapeo de ID

En AWS Clean Rooms, una regla de análisis de tablas de mapeo de ID no es una regla de análisis independiente. Este tipo de regla de análisis se administra mediante datos de identidad dispares AWS Clean Rooms y se utiliza para unirlos a fin de facilitar las consultas. Se agrega automáticamente a las tablas de mapeo de ID y no se puede editar. Hereda los comportamientos de las demás reglas de análisis de la colaboración, siempre que esas reglas de análisis sean homogéneas.

La regla de análisis de la tabla de mapeo de ID refuerza la seguridad en una tabla de mapeo de ID. Impide que un miembro de la colaboración seleccione o inspeccione directamente la población no superpuesta entre los conjuntos de datos de los dos miembros mediante la tabla de mapeo de ID. La regla de análisis de la tabla de mapeo de ID se usa para proteger los datos confidenciales de la tabla de mapeo de ID cuando se usa implícitamente en consultas con otras reglas de análisis.

Con la regla de análisis de la tabla de mapeo de ID, se AWS Clean Rooms impone una superposición en ambos lados de la tabla de mapeo de ID si se expande. SQL Esto le permite realizar las siguientes tareas:

  • Utilice la superposición de la tabla de mapeo de ID en JOIN las declaraciones.

    AWS Clean Rooms permite una INNER o una RIGHT unión en la tabla de mapeo de ID si respeta la superposición. LEFT

  • Utilice las columnas de la tabla de mapeo en JOIN las declaraciones.

    No puede usar las columnas de la tabla de mapeo en las siguientes instrucciones:SELECT,, WHERE HAVINGGROUP BY, o ORDER BY (a menos que se modifiquen las protecciones en la asociación del espacio de nombres del ID de origen o la asociación del espacio de nombres del ID de destino).

  • En formato expandidoSQL, AWS Clean Rooms también admite OUTERJOIN, implícito y. JOIN CROSS JOIN Estas uniones no pueden satisfacer los requisitos de superposición. En su lugar, se AWS Clean Rooms utiliza requireOverlap para especificar en qué columnas se deben unir.

La estructura y la sintaxis de las consultas compatibles se definen en. Estructura y sintaxis de las consultas de la tabla de mapeo de ID

Los parámetros de la regla de análisis, definidos enControles de consulta de reglas de análisis de tablas de mapeo de ID, incluyen los controles de consulta y los controles de resultados de las consultas. Sus controles de consulta incluyen la capacidad de requerir la superposición de la tabla de mapeo de ID en JOIN las declaraciones (es decir,requireOverlap).

Estructura y sintaxis de las consultas de la tabla de mapeo de ID

Las consultas de las tablas que tienen una regla de análisis de tablas de mapeo de ID deben seguir la siguiente sintaxis.

--select_list_expression SELECT provider.data_col, consumer.data_col --table_expression FROM provider JOIN idMappingTable idmt ON provider.id = idmt.sourceId JOIN consumer ON consumer.id = idmt.targetId

Tablas de colaboración

Las siguientes tablas representan las tablas configuradas que existen en una AWS Clean Rooms colaboración. La columna de identificadores de las tablas cr_drivers_license y cr_insurance representa una columna que coincide con la tabla de mapeo de identificadores.

cr_drivers_license

id nombre_del_conductor estado_de_registro
1 Eduard TX
2 Dana MA
3 Gweneth IL

cr_insurance

id correo electrónico del titular de la póliza número_política
a eduardo@internal.company.com 17f9d04e-f5be-4426-bdc4-250ed59c6529
b gwen@internal.company.com 3f0092db-2316-48a8-8d44-09cf8f6e6c64
c rosa@internal.company.com d7692e84-3d3c-47b8-b46d-a0d5345f0601

Tabla de mapeo de ID

La siguiente tabla representa una tabla de mapeo de ID existente que coincide con las tablas cr_drivers_license y cr_insurance. No todas las entradas serán válidas para ambas tablas de colaboración. IDs

cr_drivers_license_id cr_insurance_id
1 a
2 null
3 b
null c

La regla de análisis de la tabla de mapeo de ID solo permite que las consultas se ejecuten en el conjunto de datos superpuestos, que tendría el siguiente aspecto:

cr_drivers_license_id cr_insurance_id nombre_del_conductor estado_de_registro policyholder_email número_política
1 a Eduard TX eduardo@internal.company.com 17f9d04e-f5be-4426-bdc4-250ed59c6529
3 b Gweneth IL gwen@internal.company.com 3f0092db-2316-48a8-8d44-09cf8f6e6c64

Consultas de ejemplo

Los siguientes ejemplos muestran ubicaciones válidas para las uniones de la tabla de mapeo de ID:

-- Single ID mapping table SELECT [ select_items ] FROM cr_drivers_license cr_dl [ INNER | LEFT | RIGHT ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id [ INNER | LEFT | RIGHT ] JOIN cr_insurance cr_in ON idmt.cr_insurance_id = cr_in.id ; -- Single ID mapping table (Subquery) SELECT [ select_items ] FROM ( SELECT [ select_items ] FROM cr_drivers_license cr_dl [ INNER | LEFT | RIGHT ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id [ INNER | LEFT | RIGHT ] JOIN cr_insurance cr_in ON idmt.cr_insurance_id = cr_in.id ) ; -- Single ID mapping table (CTE) WITH matched_ids AS ( SELECT [ select_items ] FROM cr_drivers_license cr_dl [ INNER | LEFT | RIGHT ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id [ INNER | LEFT | RIGHT ] JOIN cr_insurance cr_in ON idmt.cr_insurance_id = cr_in.id ) SELECT [ select_items ] FROM matched_ids ;

Consideraciones

Para conocer la estructura y la sintaxis de las consultas de la tabla de mapeo de ID, tenga en cuenta lo siguiente:

  • No puede editarlo.

  • Se aplica a la tabla de mapeo de ID de forma predeterminada.

  • Utiliza una asociación de espacio de nombres de ID de origen y destino dentro de la colaboración.

  • La tabla de mapeo de ID está configurada de forma predeterminada para proporcionar protecciones predeterminadas para la columna que proviene del espacio de nombres de ID. Puede modificar esta configuración para permitir que la columna que proviene del espacio de nombres de ID (sourceIDo bientargetID) esté permitida en cualquier parte de la consulta. Para obtener más información, consulte Espacios de nombres de ID en AWS Clean Rooms.

  • La regla de análisis de la tabla de mapeo de ID hereda las SQL restricciones de las demás reglas de análisis de la colaboración.

Controles de consulta de reglas de análisis de tablas de mapeo de ID

Con los controles de consulta de tablas de mapeo de ID, AWS Clean Rooms controla cómo se utilizan las columnas de la tabla para consultarla. Por ejemplo, controla qué columnas se utilizan para unir y qué columnas deben superponerse. La regla de análisis de tablas de mapeo de ID también incluye una funcionalidad que permite proyectar una, una o ambas sin necesidad de unaJOIN. sourceID targetID

En la siguiente tabla se explica cada control.

Control Definición Uso
joinColumns Las columnas que el miembro que puede realizar la consulta puede usar en la INNER JOIN declaración. No puede utilizarlas joinColumns en ninguna otra parte de la consulta que no sea INNERJOIN.

Para obtener más información, consulte Controles de combinación.

dimensionColumns Las columnas (si las hay) que el miembro que puede realizar la consulta puede usar en las sentencias GROUP IN SELECT y BY.

A se dimensionColumn puede usar en SELECT y GROUPBY.

A dimensionColumn puede aparecer comojoinKeys.

Solo puede utilizarla dimensionColumns en la JOIN cláusula si la especifica entre paréntesis.

queryContraints:RequireOverlap

Las columnas de la tabla de mapeo de ID que se deben unir para que se pueda ejecutar la consulta.

Estas columnas se deben usar en JOIN la tabla de mapeo de ID y en una tabla de colaboración.

Estructura predefinida de la regla de análisis de la tabla de mapeo de ID

La estructura predefinida para una regla de análisis de tablas de mapeo de ID incluye protecciones predeterminadas que se aplican a y. sourceID targetID Esto significa que la columna con las protecciones aplicadas debe usarse en las consultas.

Puede configurar la regla de análisis de la tabla de mapeo de ID de las siguientes maneras:

  • Ambos sourceID y targetID protegidos

    En esta configuración, no sourceID se targetID pueden proyectar ambos extremos. El sourceID y targetID debe usarse en una JOIN cuando se hace referencia a la tabla de mapeo de ID.

  • Solo targetID protegido

    En esta configuración, no se targetID puede proyectar. targetIDDebe usarse JOIN cuando se hace referencia a la tabla de mapeo de ID. Se sourceID puede usar en una consulta.

  • Solo sourceID protegido

    En esta configuración, no se sourceID puede proyectar. sourceIDDebe usarse en una tabla de mapeo de ID JOIN cuando se haga referencia a ella. Se targetID puede usar en una consulta.

  • Ninguno sourceID o targetID protegido

    En esta configuración, la tabla de mapeo de ID no está sujeta a ninguna aplicación específica que pueda usarse en una consulta.

El siguiente ejemplo muestra una estructura predefinida para una regla de análisis de tablas de mapeo de ID con las protecciones predeterminadas aplicadas a y. sourceID targetID En este ejemplo, la regla de análisis de la tabla de mapeo de ID solo permite una tanto INNER JOIN en la columna como en la sourceID columna. targetID

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [ "source_id", "target_id" ] } } ], "dimensionColumns": [] // columns that can be used in SELECT and JOIN }

El siguiente ejemplo muestra una estructura predefinida para una regla de análisis de tablas de mapeo de ID con protecciones aplicadas a la. targetID En este ejemplo, la regla de análisis de la tabla de mapeo de ID solo permite una INNER JOIN en la columna. sourceID

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [ "target_id" ] } } ], "dimensionColumns": [ "source_id" ] }

El siguiente ejemplo muestra una estructura predefinida para una regla de análisis de tablas de mapeo de ID con protecciones aplicadas a la. sourceID En este ejemplo, la regla de análisis de la tabla de mapeo de ID solo permite una INNER JOIN en la columna. targetID

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [ "source_id" ] } } ], "dimensionColumns": [ "target_id" ] }

El siguiente ejemplo muestra una estructura predefinida para una regla de análisis de tablas de mapeo de ID sin la protección aplicada a la o. sourceID targetID En este ejemplo, la regla de análisis de la tabla de mapeo de ID permite una tanto INNER JOIN en la columna como en la sourceID columna. targetID

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [] } } ], "dimensionColumns": [ "source_id", "target_id" ] }

Regla de análisis de tablas de mapeo de ID: ejemplo

En lugar de escribir una larga declaración en cascada que haga referencia a la información de identificación personal (PII), por ejemplo, las empresas pueden utilizar la regla de análisis de la tabla de mapeo de identidades para utilizar la LiveRamp transcodificación multipartita. El siguiente ejemplo demuestra cómo se puede colaborar en el AWS Clean Rooms uso de la regla de análisis de tablas de mapeo de ID.

La empresa A es un anunciante que tiene datos de clientes y ventas, que se utilizarán como fuente. La empresa A también realiza la transcodificación en nombre de las partes de la colaboración y aporta las LiveRamp credenciales.

La empresa B es una editorial que tiene datos de eventos, que se utilizarán como objetivo.

nota

La empresa A o la empresa B pueden proporcionar las credenciales de LiveRamp transcodificación y realizar la transcodificación.

Para crear una colaboración que permita analizar las tablas de mapeo de ID en colaboración, las empresas hacen lo siguiente:

  1. La empresa A crea una colaboración y crea una pertenencia. Agrega a la empresa B, que también crea una membresía en la colaboración.

  2. La empresa A asocia una fuente de espacio de nombres de ID existente o crea una nueva AWS Entity Resolution mediante la AWS Clean Rooms consola.

    La empresa A crea una tabla configurada con sus datos de ventas y una columna vinculada a la de la tabla de sourceId mapeo de ID.

    La fuente del espacio de nombres de ID proporciona datos para la transcodificación.

  3. La empresa B asocia un destino de espacio de nombres de ID existente o crea uno nuevo mediante la consola. AWS Entity Resolution AWS Clean Rooms

    La empresa B crea una tabla configurada con los datos de sus eventos y una columna vinculada a la de la tabla de targetId mapeo de ID.

    El destino del espacio de nombres del ID no proporciona datos para la transcodificación, solo los metadatos relacionados con la configuración. LiveRamp

  4. La empresa A descubre los dos espacios de nombres de ID asociados a la colaboración y crea y completa una tabla de mapeo de ID.

  5. La empresa A ejecuta una consulta en los dos conjuntos de datos uniéndolos en la tabla de mapeo de ID.

    --- this would be valid for Custom or List SELECT provider.data_col, consumer.data_col FROM provider JOIN idMappingTable-123123123123-myMappingWFName idmt ON provider.id = idmt.sourceId JOIN consumer ON consumer.id = idmt.targetId