Inicio de sesión de consultas AWS Clean Rooms

El registro de consultas es una función de AWS Clean Rooms. Al crear una colaboración y activar el registro de consultas, los miembros pueden almacenar los registros de consultas relevantes para ellos en Amazon CloudWatch Logs.

Los registros de consultas permiten a los miembros determinar si las consultas cumplen las reglas de análisis y se ajustan al acuerdo de colaboración. Además, los registros de consultas respaldan las auditorías.

Cuando la opción de registro de consultas está activada en la AWS Clean Rooms consola, los registros de consultas incluyen lo siguiente:

• analysisRule: la regla de análisis de la tabla configurada.

• analysisTemplateArn: la plantilla de análisis que se ejecutó (aparece en función de la regla de análisis).

• collaborationId: el identificador único de la colaboración en la que se ejecutó la consulta.

• configuredTableID: el identificador único de la tabla configurada a la que hace referencia la consulta.

• directQueryAnalysisRulePolicy.custom.allowedAnalysis: la plantilla de análisis que se puede ejecutar en una tabla configurada (aparece según la regla de análisis).

• directQueryAnalysisRulePolicy.v1.custom.allowedAnalysisProviders: los proveedores de consultas que tienen permitido crear consultas (aparece según la regla de análisis).

• eventID: el identificador único de ejecución de la consulta. Desde el 31 de agosto de 2023, el identificador único coincidirá con el protectedQueryID.

• eventTimestamp: el momento de ejecución de la consulta.

• parameters.parametervalue: los valores de los parámetros (aparecen en función del texto de la consulta).

• queryText: la definición SQL de la ejecución de la consulta. Si hay parámetros, se etiquetan como :parametervalue.

• queryValidationErrors: los errores de consulta durante la validación de la consulta.

• schemaName: el nombre de la asociación de tablas configuradas a la que se hace referencia en la consulta.

Recibir registros de consultas

No es necesario realizar ninguna acción aparte de AWS Clean Rooms configurar los registros de consultas. AWS Clean Rooms crea grupos de registro para las colaboraciones después de que cada miembro de la colaboración cree una membresía.

Los miembros que pueden realizar consultas, los miembros que pueden recibir los resultados y los miembros a cuyas tablas de configuración se haga referencia en la consulta recibirán un registro de consultas.

El miembro que puede realizar consultas y el miembro que puede recibir los resultados recibirán registros de consultas para cada tabla configurada a la que se haga referencia en la consulta. Si no son el propietario de la tabla configurada, no podrán ver el ID de la tabla configurada (configuredTableID).

Si un miembro tiene varias asociaciones de tablas configuradas a las que se hace referencia en la consulta, recibirá un registro de consultas por cada tabla configurada.

Se crean registros para las consultas que contienen SQL admitido y no admitido en AWS Clean Rooms. Para obtener más información, consulte la Referencia de SQL de AWS Clean Rooms.

También se crean registros cuando las consultas hacen referencia a tablas configuradas que no están asociadas a la colaboración.

No se crean registros si el código SQL no es correcto. AWS Clean Rooms

Los registros de consultas no indican si la consulta se ha realizado correctamente o si se ha entregado el resultado de la consulta. Simplemente confirman que un miembro que puede realizar consultas envió una consulta. Los registros de consultas también confirman que la consulta contiene SQL compatible AWS Clean Rooms y hace referencia a las tablas configuradas asociadas a la colaboración.

Por ejemplo, no se genera un registro si la consulta se canceló después de AWS Clean Rooms validar su conformidad con las reglas de análisis y durante el procesamiento de la consulta.

Si elimina el grupo de registros, debe volver a crearlo manualmente con el mismo nombre de grupo de registros (ID de colaboración de la colaboración). O bien, puede activar y desactivar el registro en su pertenencia.

Para obtener más información acerca de cómo activar el registro de consultas, consulte Crear una colaboración en AWS Clean Rooms.

Para obtener más información sobre Amazon CloudWatch Logs, consulta la Guía del usuario de Amazon CloudWatch Logs.

Usar los registros de consultas

Es aconsejable que los miembros tomen las siguientes medidas de forma periódica:

• Revisar las consultas ejecutadas en la colaboración para comprobar que coinciden con los casos de uso o con las consultas acordadas para la colaboración.

  Para obtener más información sobre cómo ver consultas recientes, consulte Visualización de consultas recientes.

• Revisar las columnas de la tabla configurada que se utilizan en las reglas de análisis de los miembros de la colaboración y en las consultas para asegurarse de que las columnas de la tabla configurada se ajustan a lo acordado para la colaboración.

  Para obtener más información sobre cómo ver las columnas configuradas, consulte Ver tablas y reglas de análisis.