

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Connexion à une analyse AWS Clean Rooms
<a name="query-logs"></a>

La *journalisation des analyses* est une fonctionnalité de AWS Clean Rooms. Lorsque vous [créez une collaboration](create-collaboration.md) et que vous activez la **journalisation des analyses**, les membres peuvent stocker les journaux pertinents issus de requêtes ou les journaux de tâches dans Amazon CloudWatch Logs.

Grâce aux journaux des requêtes et aux journaux des tâches, les membres peuvent déterminer si les requêtes sont conformes aux règles d'analyse et à l'accord de collaboration. En outre, les journaux de requêtes facilitent les audits.

Lorsque l'option de **journalisation de l'analyse** est activée dans la AWS Clean Rooms console, les journaux de requêtes incluent les éléments suivants :
+ `analysisRule`— Règle d'analyse pour la table configurée.
+ `analysisTemplateArn`— Le modèle d'analyse qui a été exécuté (apparaît en fonction de la règle d'analyse).
+ `collaborationId`— Identifiant unique pour la collaboration dans laquelle la requête a été exécutée.
+ `configuredTableID`— Identifiant unique de la table configurée référencée dans la requête.
+ `directQueryAnalysisRulePolicy.custom.allowedAnalysis`— Le modèle d'analyse autorisé à s'exécuter sur une table configurée (apparaît en fonction de la règle d'analyse).
+ `directQueryAnalysisRulePolicy.v1.custom.allowedAnalysisProviders`— Les fournisseurs de requêtes autorisés à créer des requêtes (apparaissent en fonction de la règle d'analyse).
+ `errorCode`— Code d'erreur lorsqu'une requête ne s'exécute pas correctement.
+ `errorMessage`— Le message d'erreur lorsqu'une requête ne s'est pas exécutée correctement.
+ `eventID`— Identifiant unique de la requête exécutée. Après le 31 août 2023, l'identifiant unique est le même que le`protectedQueryID`.
+ `eventTimestamp`— Durée d'exécution de la requête.
+ `parameters.parametervalue`— Les valeurs des paramètres (apparaissent en fonction du texte de la requête).
+ `queryText`— Définition SQL de la requête exécutée. S'il existe des paramètres, ils sont étiquetés comme`:parametervalue`.
+ `queryValidationErrors`— Les erreurs de requête lors de la validation de la requête.
+ `schemaName`— Nom de l'association de tables configurée référencée dans la requête.
+ `status`— État d'exécution de la requête.

# Recevoir les journaux des requêtes et des tâches
<a name="receiving-query-logs"></a>

Vous n'avez pas besoin d'effectuer d'actions en dehors de la AWS Clean Rooms configuration des journaux de requêtes et des journaux de tâches. AWS Clean Rooms crée des groupes de journaux pour les collaborations une fois que chaque membre de la collaboration [a créé une adhésion](create-membership.md). 

Les membres autorisés à effectuer des requêtes, à exécuter des requêtes et à exécuter des tâches, à recevoir des résultats et aux membres dont les tables de configuration sont référencées dans la requête recevront un journal des requêtes ou un journal des tâches. 

Le membre autorisé à effectuer une requête et le membre autorisé à recevoir des résultats recevront des journaux de requêtes pour chaque table configurée référencée dans la requête. S'ils ne possèdent pas la table configurée, ils ne pourront pas voir l'ID de table configuré (`configuredTableID`). 

Le membre qui peut exécuter des requêtes et des tâches et le membre qui peut recevoir des résultats recevront des journaux de tâches pour chaque table configurée référencée dans la tâche. S'ils ne possèdent pas la table configurée, ils ne pourront pas voir l'ID de table configuré (`configuredTableID`). 

Si un membre possède plusieurs associations de tables configurées référencées dans la requête, il recevra un journal des requêtes pour chaque table configurée.

Si un membre possède plusieurs associations de tables configurées référencées dans la tâche, il recevra un journal des tâches pour chaque table configurée.

Des journaux sont créés pour les requêtes contenant du code SQL non pris en charge et pris en charge dans AWS Clean Rooms. Pour plus de détails, consultez la [référence AWS Clean Rooms SQL](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html).

Des journaux sont également créés lorsque des requêtes ou des tâches font référence à des tables configurées qui ne sont pas associées à la collaboration.

Les journaux peuvent contenir des informations relatives à un code SQL incorrect.

Les journaux des requêtes et des tâches indiquent le statut d'une requête mais n'indiquent pas si le résultat de la requête a été fourni. Ils confirment qu'une requête ou un travail a été soumis par le membre habilité à effectuer la requête. Les journaux de requêtes confirment également que la requête contient du code SQL pris en charge AWS Clean Rooms et fait référence aux tables configurées associées à la collaboration. 

**Example**  
Par exemple, aucun journal n'est produit si la requête a été annulée après avoir AWS Clean Rooms validé sa conformité aux règles d'analyse et pendant le traitement de la requête. 

Si vous supprimez le groupe de journaux, vous devez le recréer manuellement avec le même nom de groupe de journaux (ID de collaboration de la collaboration). Vous pouvez également désactiver et activer la déconnexion dans votre abonnement.

Pour plus d'informations sur la façon d'activer la journalisation des analyses, consultez[Création d'une collaboration](create-collaboration.md).

Pour plus d'informations sur Amazon CloudWatch Logs, consultez le [guide de l'utilisateur Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html).

# Actions recommandées pour les journaux de requêtes et de tâches
<a name="using-query-logs"></a>

Nous recommandons aux membres de prendre régulièrement les mesures suivantes : 
+ Pour vérifier que les requêtes et les tâches correspondent aux cas d'utilisation ou aux requêtes convenus pour la collaboration, passez en revue les requêtes et les tâches exécutées dans le cadre de la collaboration.

  Pour plus d'informations sur l'affichage des requêtes récentes, consultez la section [Affichage des requêtes récentes](https://docs.aws.amazon.com/clean-rooms/latest/userguide/query-data.html#view-queries-console).

  Pour plus d'informations sur la façon de consulter les offres d'emploi récentes, consultez[Afficher les offres d'emploi récentes](view-recent-jobs.md).
+ Pour vérifier que les colonnes de table configurées correspondent à ce qui a été convenu pour la collaboration, passez en revue les colonnes de table configurées qui sont utilisées dans les règles d'analyse des membres de la collaboration et dans les requêtes.

  Pour plus d'informations sur la façon d'afficher les colonnes configurées, consultez la section [Affichage des tables et des règles d'analyse](https://docs.aws.amazon.com/clean-rooms/latest/userguide/manage-configured-tables.html#view-tables).