

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.

# Création d'une collaboration pour les requêtes et les tâches
<a name="create-collab-queries-and-jobs"></a>

Dans cette procédure, en tant que [créateur de la collaboration](glossary.md#glossary-collaboration-creator), vous effectuez les tâches suivantes :
+ [Créez une collaboration](create-collaboration.md).
+ Invitez un ou plusieurs [membres](glossary.md#glossary-member) à rejoindre la [collaboration](glossary.md#glossary-collaboration).
+ Attribuez des capacités aux membres, telles que le [membre qui peut exécuter des requêtes et des tâches](glossary.md#glossary-member-who-can-run-queries-jobs) et le [membre qui peut recevoir des résultats](glossary.md#glossary-member-who-can-receive-results).

  Si le créateur de la collaboration est également le membre habilité à recevoir les résultats, il spécifie la destination et le format des résultats. Ils fournissent également un rôle de service Amazon Resource Name (ARN) pour écrire les résultats dans la destination des résultats.
+ Configurez quel [membre est chargé de payer les coûts de calcul des requêtes et des tâches dans le cadre de la collaboration](glossary.md#glossary-member-paying-for-query-job-compute).

Avant de commencer, assurez-vous de remplir les prérequis suivants : 
+ Vous avez le nom et l' Compte AWS identifiant de chaque membre que vous souhaitez inviter à rejoindre la collaboration.
+ Vous êtes autorisé à partager le nom et l' Compte AWS identifiant de chaque membre avec tous les membres de la collaboration.
**Note**  
Vous ne pouvez pas ajouter d'autres membres après avoir créé la collaboration. 

Pour plus d'informations sur la création d'une collaboration à l'aide du AWS SDKs, consultez la *[référence des AWS Clean Rooms API](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)*.

**Pour créer une collaboration pour les requêtes et les tâches**

1. Connectez-vous à la console AWS Management Console et ouvrez-la avec la [AWS Clean Rooms console](https://console.aws.amazon.com/cleanrooms/home) Compte AWS qui fonctionnera en tant que créateur de collaboration.

1. Dans le volet de navigation de gauche, sélectionnez **Collaborations**.

1. Dans le coin supérieur droit, choisissez **Créer une collaboration**.

1. Pour **l'étape 1 : définir la collaboration**, procédez comme suit :

   1. Pour **plus de détails**, entrez le **nom** et la **description** de la collaboration.

      Ces informations seront visibles par les membres de la collaboration qui sont invités à participer à la collaboration. Le **nom** et la **description** les aident à comprendre à quoi fait référence la collaboration. 

   1. Pour les **membres** :

      1. Pour le **membre 1 : vous devez** saisir le **nom d'affichage de votre membre** tel que vous souhaitez qu'il apparaisse pour la collaboration.
**Note**  
Votre Compte AWS identifiant est automatiquement inclus comme ** Compte AWS identifiant de membre**.

      1. Pour **Membre 2**, entrez le **nom d'affichage du** **membre et l' Compte AWS ID** du membre que vous souhaitez inviter à rejoindre la collaboration.

         Le **nom d'affichage** et l'** Compte AWS identifiant du membre** seront visibles par toutes les personnes invitées à la collaboration. Une fois que vous avez saisi et enregistré les valeurs de ces champs, vous ne pouvez pas les modifier.
**Note**  
Vous devez informer le membre de la collaboration que son ** Compte AWS identifiant** de **membre et son nom d'affichage** seront visibles par tous les collaborateurs invités et actifs de la collaboration.

      1. Si vous souhaitez ajouter un autre membre, choisissez **Ajouter un autre membre**. Entrez ensuite le **nom d'affichage du** **membre et l' Compte AWS identifiant** de membre pour chaque membre susceptible de fournir les données que vous souhaitez inviter à la collaboration.

   1. Si vous souhaitez activer la **journalisation des analyses**, cochez la case **Activer la journalisation des analyses**, puis choisissez les **types de journaux pris en charge**.
      + Si vous souhaitez recevoir les journaux générés à partir de requêtes SQL, cochez la case **Journaux à partir de requêtes**.
      + Si vous souhaitez recevoir les journaux générés à partir des tâches à l'aide de PySpark, cochez la case **Journaux des tâches**.

   1. Si vous souhaitez activer la **surveillance détaillée**, cochez la case **Activer la surveillance détaillée**.

      Le responsable de l'analyse et le payeur configuré peuvent choisir d'activer des métriques détaillées lors de la création de leur adhésion. Lorsque cette option est activée, des mesures de surveillance détaillées seront publiées CloudWatch pour le suivi opérationnel des collaborations, notamment les performances des requêtes et l'utilisation des ressources. Ces statistiques seront mises à la disposition du responsable de l'analyse et du payeur configuré dans leurs versions respectives Compte AWS.

      Pour plus d'informations sur la CloudWatch tarification, consultez la section [CloudWatch Tarification](https://aws.amazon.com/cloudwatch/pricing/).

   1. Sous **Régions de résultats de requête autorisées**, sélectionnez un ou plusieurs Régions AWS endroits où vous souhaitez envoyer les résultats de la requête.

      Par défaut, seule la région actuelle (telle que North Virginia us-east-1) est sélectionnée. 
**Important**  
Lorsque vous activez la livraison des résultats de requêtes entre régions, vos résultats peuvent être traités et stockés en dehors de la région source.

      Pour plus d'informations sur les régions, voir [Régions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html) dans le *Références générales AWS*. 

   1. (Facultatif) Gérez l'accès à vos données grâce à **l'approbation automatique des demandes de modification** en configurant les paramètres qui peuvent être modifiés automatiquement sans approbation manuelle pour une demande de modification. Par défaut, certains paramètres ne peuvent être modifiés qu'en soumettant une demande de modification qui doit être approuvée par tous les membres avant qu'elle ne prenne effet.
      + **Accorder des capacités aux membres** : choisissez les capacités qui peuvent être accordées aux membres de la collaboration sans approbation manuelle. Les membres peuvent toujours fournir des données.
        + Choisissez des capacités :
          + Contribuer aux données *(toujours activé)*
          + Recevez les résultats
        + **Approuver automatiquement les nouveaux membres dotés de ces capacités** : si cela est autorisé, tous les membres ajoutés avec les capacités sélectionnées ci-dessus rejoindront instantanément la collaboration. Les membres ajoutés avec d'autres capacités devront toujours être approuvés manuellement pour s'inscrire.
      + **Capacités pouvant être révoquées automatiquement** - Choisissez les capacités qui peuvent être révoquées sans approbation manuelle. Les membres peuvent toujours fournir des données.
        + Choisissez des capacités :
          + Contribuer aux données *(toujours activé)*
          + Recevez les résultats

      Si vous choisissez cette option, vous pouvez suivre toutes les modifications de configuration de collaboration via l'**historique des demandes de modification**, situé dans l'onglet **Détails** de la page des détails de la collaboration.

   1. (Facultatif) Si vous souhaitez activer la fonctionnalité de **calcul cryptographique**, cochez la case **Activer le calcul cryptographique**.

      1. Choisissez les **paramètres de couverture cryptographique** suivants :
         + **Autoriser plaintext les colonnes**

           Choisissez **Non** si vous avez besoin de tables entièrement chiffrées.

           Choisissez **Oui** si vous souhaitez que cleartext les colonnes soient autorisées dans la table cryptée.

           Pour fonctionner SUM ou AVG sur certaines colonnes, les colonnes doivent être inséréescleartext.
         + **Préservez NULL les valeurs**

           Choisissez **Non** si vous ne souhaitez pas conserver NULL les valeurs. NULLles valeurs n'apparaîtront pas comme NULL dans une table cryptée.

           Choisissez **Oui** si vous souhaitez conserver NULL les valeurs. NULLles valeurs apparaîtront comme NULL dans une table cryptée.

      1. Choisissez les **paramètres d'empreinte** suivants :
         + **Autoriser les doublons**

           Choisissez **Non** si vous ne souhaitez pas que les doublons soient autorisés dans une fingerprint colonne.

           Choisissez **Oui** si vous souhaitez que les entrées dupliquées soient autorisées dans une fingerprint colonne.
         + **JOINAutorisation de colonnes portant des noms différents**

           Choisissez **Non** si vous ne souhaitez pas joindre des fingerprint colonnes portant des noms différents.

           Choisissez **Oui** si vous souhaitez joindre des fingerprint colonnes portant des noms différents.

      Pour plus d'informations sur les **paramètres de calcul cryptographique**, consultez[Paramètres de calcul cryptographique](crypto-computing-parameters.md).

      Pour plus d'informations sur la façon de chiffrer vos données pour les utiliser dans AWS Clean Rooms, consultez[Préparation de tables de données chiffrées à l'aide de l'informatique cryptographique pour Clean Rooms](prepare-encrypted-data.md).
**Note**  
Vérifiez soigneusement ces configurations avant de passer à l'étape suivante. Après avoir créé la collaboration, vous pouvez uniquement modifier le nom et la description de la collaboration et indiquer si les journaux sont stockés dans Amazon CloudWatch Logs.

   1. Si vous souhaitez activer les **balises** pour la ressource de collaboration, choisissez **Ajouter une nouvelle balise**, puis entrez la paire ****clé/valeur****.

   1. Choisissez **Suivant**.

1. Pour **l'étape 2 : Spécifier les capacités des membres**, procédez comme suit :

   1. Pour **l'analyse à l'aide de requêtes et de tâches**, sous **Types d'analyse pris en charge**, cochez la case **Tâches**.

      La case **Requêtes** est cochée par défaut.

      1. Sélectionnez le membre autorisé à **exécuter des requêtes et des tâches** dans la liste déroulante.

      1. Sélectionnez le membre qui peut **recevoir les résultats des analyses** dans la liste déroulante.
**Note**  
Le membre qui crée le modèle PySpark d'analyse doit également être celui qui reçoit les résultats. 

   1. Si vous utilisez Clean Rooms ML, pour la **modélisation du ML à l'aide de flux de travail spécialement conçus**, 

      1. (Facultatif) Sélectionnez le membre qui peut **recevoir les résultats des modèles entraînés** dans la liste déroulante.

      1. (Facultatif) Sélectionnez le membre qui peut **recevoir le résultat de l'inférence du modèle dans** la liste déroulante.

   1. Consultez les capacités des membres sous **Résolution d'identification en utilisant Résolution des entités AWS**.

   1. Choisissez **Suivant**.

1. Pour **l'étape 3 : configurer le paiement**, 

   1. Pour une **analyse utilisant des requêtes et des tâches**, choisissez le membre qui **paiera pour les requêtes et les tâches**.

      Vous pouvez désigner le membre habilité à **exécuter des requêtes et des tâches** comme étant le membre qui paie les requêtes et les tâches calculent les coûts.

      Vous pouvez désigner un autre membre pour payer les requêtes et les tâches calculent les coûts.

   1. Pour la **modélisation ML à l'aide de flux de travail spécialement conçus**, le **créateur du modèle de similarité configuré est le** membre qui **paiera** pour la modélisation de similarité.

   1. Pour la **résolution des identifiants avec Résolution des entités AWS**, le **créateur de la table de mappage des identifiants** est le membre qui **paiera pour la table de mappage des identifiants**.

   1. Choisissez **Suivant**.

1. Pour **l'étape 4 : Configuration de l'adhésion**, choisissez l'une des options suivantes :

------
#### [ Yes, join by creating membership now ]

   1. Pour les **paramètres de résultats par défaut**, pour les **paramètres de résultats de requête**, si vous êtes le membre autorisé à **recevoir les résultats**, 

      1. Cochez la case **Définir les paramètres par défaut pour les requêtes**. Pour la **destination des résultats dans Amazon S3**, entrez la destination Amazon S3 ou choisissez **Browse S3** pour sélectionner un compartiment S3.

      1. Pour le **format du résultat** de la requête, choisissez **CSV** ou **PARQUET**.

      1. (Spark uniquement) Pour les **fichiers de résultats**, choisissez **Multiple** ou **Single**.

      1. (Facultatif) Pour **accéder au service**, si vous souhaitez envoyer des requêtes qui prennent jusqu'à 24 heures à votre destination S3, cochez la case **Ajouter un rôle de service pour prendre en charge les requêtes dont le traitement prend jusqu'à 24 heures**.

         Les requêtes volumineuses dont le traitement prend jusqu'à 24 heures seront livrées à votre destination S3.

         Si vous ne cochez pas cette case, seules les requêtes traitées dans les 12 heures seront livrées à votre agence S3. 

      1. Spécifiez les autorisations **d'accès au service** en sélectionnant **Créer et utiliser un nouveau rôle de service** ou **Utiliser un rôle de service existant**.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/create-collab-queries-and-jobs.html)
**Note**  
AWS Clean Rooms nécessite des autorisations pour effectuer des requêtes conformément aux règles d'analyse. Pour plus d'informations sur les autorisations pour AWS Clean Rooms, voir[AWS politiques gérées pour AWS Clean Rooms](security-iam-awsmanpol.md).
Si le rôle ne dispose pas d'autorisations suffisantes pour AWS Clean Rooms, vous recevez un message d'erreur indiquant que le rôle ne dispose pas d'autorisations suffisantes pour AWS Clean Rooms. La politique de rôle doit être ajoutée avant de continuer.
Si vous ne parvenez pas à modifier la politique de rôle, vous recevez un message d'erreur indiquant que AWS Clean Rooms la politique pour le rôle de service est introuvable.

   1. Pour les **résultats du Job**,   
**Example**  

      Par exemple : **s3://bucket/prefix**

      1. Cochez la case **Définir les paramètres par défaut pour les tâches**, puis spécifiez la **destination des résultats dans Amazon S3** en saisissant la destination S3 ou choisissez **Parcourir S3** pour effectuer une sélection dans la liste des compartiments S3 disponibles.

      1. Spécifiez les autorisations **d'accès au service** en choisissant un **nom de rôle de service existant** dans la liste déroulante.

   1. Pour les **paramètres des journaux**, choisissez l'une des options suivantes pour le **stockage des CloudWatch journaux dans Amazon Logs** :
**Note**  
La section **Paramètres des journaux** apparaît si vous avez choisi d'activer la **journalisation des requêtes**. 

      1. Choisissez **Activer** et les journaux de requêtes qui vous concernent seront stockés dans votre compte Amazon CloudWatch Logs.

         Chaque membre ne peut recevoir que les journaux des requêtes qu'il a initiées ou qui contiennent ses données.

         Le membre qui peut recevoir les résultats reçoit également des journaux pour toutes les requêtes exécutées dans le cadre d'une collaboration, même si ses données ne sont pas accessibles dans le cadre d'une requête.

         Sous **Types de journaux pris en charge**, choisissez parmi les types de journaux que le créateur de la collaboration a choisi de prendre en charge :

         Sous **Types de journaux pris en charge**, les cases à cocher **Query** Logs et **Job logs** sont activées par défaut.
**Note**  
Après avoir activé la **journalisation d'analyse**, la configuration du stockage des journaux et le début de la réception des journaux dans Amazon CloudWatch Logs peuvent prendre quelques minutes. Pendant cette brève période, le membre autorisé à effectuer des requêtes peut exécuter des requêtes qui n'envoient pas réellement de journaux.

      1. Choisissez **Désactiver** et les journaux de requêtes qui vous concernent ne seront pas stockés dans votre compte Amazon CloudWatch Logs.

   1. Si vous souhaitez activer les **balises d'adhésion** pour la ressource d'adhésion, choisissez **Ajouter une nouvelle balise**, puis entrez la paire ****clé/valeur****. 

   1. Si vous êtes le membre qui paie pour **Query Compute**, **Job Compute**, ou les deux, indiquez votre acceptation en cochant la case **J'accepte de payer les coûts de calcul dans le cadre de cette collaboration**.
**Note**  
Vous devez cocher cette case pour continuer.  
Pour plus d'informations sur le mode de calcul des prix, consultez[Tarification pour AWS Clean Rooms](what-is.md#pricing).

      Si vous êtes le [membre qui paie les frais de calcul des requêtes](glossary.md#glossary-member-paying-for-query-compute)[, mais que vous n'êtes pas le membre habilité AWS Budgets à effectuer des requêtes](glossary.md#glossary-member-who-can-run-queries-jobs), il est recommandé de configurer un budget AWS Clean Rooms et de recevoir des notifications une fois le budget maximum atteint. Pour plus d'informations sur la configuration d'un budget, consultez [la section Gérer vos coûts AWS Budgets](https://docs.aws.amazon.com/cost-management/latest/userguide/budgets-managing-costs.html) dans le *Guide de AWS Cost Management l'utilisateur*. Pour plus d'informations sur la configuration des notifications, consultez la rubrique [Création d'un compte Amazon SNS pour les notifications budgétaires](https://docs.aws.amazon.com/cost-management/latest/userguide/budgets-sns-policy.html) dans le guide de l'*AWS Cost Management utilisateur*. Si le budget maximum est atteint, vous pouvez contacter le membre qui pourra lancer des requêtes ou [quitter la collaboration](leave-collab.md). Si vous quittez la collaboration, aucune autre requête ne sera autorisée à être exécutée et, par conséquent, les frais de calcul des requêtes ne vous seront plus facturés.

   1. Choisissez **Suivant**.

   La collaboration et votre adhésion sont créées. 

   Votre statut dans la collaboration est actif.

------
#### [ No, I will create a membership later ]

   1. Choisissez **Suivant**.

      Seule la collaboration est créée. 

      Votre statut dans la collaboration est inactif.

------

1. Pour **l'étape 5 : révision et création**, procédez comme suit :

   1. Passez en revue les sélections que vous avez effectuées lors des étapes précédentes et modifiez-les si nécessaire. 

   1. Choisissez l'une des options.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/create-collab-queries-and-jobs.html)

Une fois que votre collaboration a été créée avec succès, vous pouvez voir la page des détails de la collaboration sous **Collaborations**.

Vous êtes maintenant prêt à : 
+ [Préparez votre tableau de données à analyser AWS Clean Rooms](prepare-data.md). (Facultatif si vous souhaitez analyser vos propres données d'événement ou si vous souhaitez interroger des données d'identité.)
+ [Associez le tableau configuré à votre collaboration](associate-configured-table.md). (Facultatif si vous souhaitez analyser vos propres données d'événement.)
+ [Ajoutez une règle d'analyse pour la table configurée](add-analysis-rule.md). (Facultatif si vous souhaitez analyser vos propres données d'événement.)
+ [Créez un abonnement et rejoignez une collaboration](create-membership.md). (Facultatif si vous avez déjà créé un abonnement.)
+ [Invitez des membres à rejoindre la collaboration](invite-members.md).