Création d'une collaboration dans AWS Clean Rooms

Une collaboration est une limite logique sécurisée AWS Clean Rooms dans laquelle les membres peuvent effectuer des requêtes SQL sur des tables configurées.

Tout membre AWS Clean Rooms peut créer une collaboration.

Le créateur de la collaboration peut désigner un seul membre pour interroger et recevoir les résultats. Toutefois, le créateur de la collaboration souhaitera peut-être empêcher le membre autorisé à effectuer une requête d'accéder aux résultats de la requête. Dans ce cas, le créateur de la collaboration peut désigner un membre qui peut effectuer des requêtes et un autre membre qui peut recevoir les résultats.

Dans la plupart des cas, le membre qui peut interroger est également le membre qui paie les coûts de calcul des requêtes. Cependant, le créateur de la collaboration peut configurer un autre membre pour qu'il soit responsable du paiement des coûts de calcul des requêtes.

Pour plus d'informations sur la création d'une collaboration à l'aide AWS des SDK, consultez la référence des AWS Clean Rooms API.

Créez une collaboration

Avant de commencer, assurez-vous d'avoir rempli les conditions préalables suivantes :

• Vous avez le nom et l'Compte AWSidentifiant de chaque membre que vous souhaitez inviter à rejoindre la collaboration.

• Vous êtes autorisé à partager le nom et l'Compte AWSidentifiant de chaque membre avec tous les membres de la collaboration.

Note

Vous ne pouvez pas ajouter d'autres membres une fois la collaboration créée.

Pour créer une collaboration à l'aide de la AWS Clean Rooms console

1. Connectez-vous à la console AWS Management Console et ouvrez-la avec la AWS Clean Roomsconsole Compte AWS qui fonctionnera en tant que créateur de collaboration.

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

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

4. 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.

   2. 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 AWSidentifiant de membre.

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

         Le nom d'affichage et l'Compte AWSidentifiant 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, elles ne sont plus modifiables.

         Note

         Vous devez informer le membre de la collaboration que son Compte AWSidentifiant de membre et son nom d'affichage seront visibles par tous les collaborateurs invités et actifs de la collaboration.

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

   3. Pour les capacités des membres, choisissez l'une des options suivantes :

      Si vous voulez...	Alors...
      Interrogez les données de la collaboration et recevez les résultats	Choisissez-vous comme membre autorisé à exécuter des requêtes. Laissez le paramètre par défaut du membre autorisé à recevoir des résultats identique à celui du membre qui exécute les requêtes.
      Interrogez les données de la collaboration et désignez un autre membre pour recevoir les résultats	Choisissez-vous comme membre autorisé à exécuter des requêtes. Sélectionnez le membre qui peut recevoir les résultats dans la liste déroulante.
      Recevez les résultats de la requête dans la collaboration et désignez un autre membre pour interroger les données	Sélectionnez le membre autorisé à exécuter des requêtes dans la liste déroulante. Choisissez vous-même en tant que membre qui peut recevoir les résultats dans la liste déroulante.
      Créez et gérez la collaboration, assignez un autre membre pour interroger les données et affectez un autre membre pour recevoir les résultats	Sélectionnez le membre autorisé à exécuter des requêtes dans la liste déroulante. Sélectionnez le membre qui peut recevoir les résultats dans la liste déroulante.

   4. Pour la configuration du paiement, choisissez l'une des options suivantes :

      Si vous voulez...	Alors...
      Désignez le membre qui peut exécuter des requêtes comme étant le membre qui paie les coûts de calcul de la requête	Laissez le paramètre par défaut du membre qui paiera pour les requêtes identique à celui du membre qui exécute les requêtes.
      Désignez un membre différent pour payer les coûts de calcul de la requête	Sélectionnez le membre qui paiera pour les requêtes dans la liste déroulante.

   5. Si vous souhaitez activer la journalisation des requêtes, cochez la case Support de la journalisation des requêtes pour cette collaboration.

   6. Si vous souhaitez activer la fonctionnalité de calcul cryptographique, cochez la case Soutenir le calcul cryptographique dans cette collaboration et choisissez les paramètres de calcul cryptographique suivants :

      • Autoriser cleartext les colonnes

        Choisissez Non si vous ne souhaitez pas que cleartext les colonnes soient autorisées dans la table cryptée.

        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.

      • 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.

      • 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.

      Pour plus d'informations sur les paramètres de calcul cryptographique, consultezParamètres de calcul cryptographique.

      Pour plus d'informations sur la façon de chiffrer vos données pour les utiliser dansAWS Clean Rooms, consultezPréparation de tables de données chiffrées à l'aide de l'informatique cryptographique pour Clean Rooms.

      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 de requêtes sont stockés dans Amazon CloudWatch Logs.

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

   8. Choisissez Suivant.

5. Pour l'étape 2 : configurer l'adhésion, procédez comme suit :

   1. Choisissez une option :

      Si vous choisissez…	Alors...
      Oui, inscrivez-vous en créant un abonnement dès maintenant	La collaboration et votre adhésion sont créées. Votre statut dans la collaboration est actif.
      Non, je créerai un abonnement ultérieurement	Seule la collaboration est créée. Votre statut dans la collaboration est inactif.

   2. Si vous êtes le membre habilité à recevoir les résultats, sous Paramètres des résultats de requête par défaut, choisissez l'une des options suivantes :

      Si tu...	Alors...
      Conservez la case Définir les paramètres par défaut maintenant cochée. (Il est sélectionné par défaut.)	Pour la destination des résultats dans Amazon S3, entrez la destination Amazon S3. Pour le format du résultat de la requête, choisissez CSV ou PARQUET.
      Désactivez la case à cocher Définir les paramètres par défaut maintenant.	Seule la collaboration est créée. Votre statut dans la collaboration est inactif.

   3. Si vous avez choisi d'activer la journalisation des requêtes à l'étape 4.e, choisissez l'une des options suivantes pour le stockage des CloudWatch journaux dans Amazon Logs :

      Si vous choisissez…	Alors...
      Allumez	Les journaux de requêtes qui vous concernent sont stockés dans 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.
      Éteindre	Les journaux de requêtes qui vous concernent ne sont pas stockés dans votre compte Amazon CloudWatch Logs.

      Note

      Après avoir activé la journalisation des requêtes, 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.

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

   5. Si vous êtes le membre qui paie pour les requêtes, indiquez votre acceptation en cochant la case J'accepte de payer les frais de calcul des requêtes 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, consultezTarification pour AWS Clean Rooms.

      Si vous êtes le membre qui paie les frais de calcul des requêtes, mais que vous n'êtes pas le membre habilité AWS Budgets à effectuer des requêtes, 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 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 dans le guide de l'AWS Cost Managementutilisateur. Si le budget maximum est atteint, vous pouvez contacter le membre qui pourra lancer des requêtes ou quitter la collaboration. 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.

   6. Choisissez Suivant.

6. Pour l'étape 3 : 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.

   2. Sélectionnez l'une des méthodes suivantes :

      Si vous avez choisi de...	Choisissez ensuite...
      Créez un abonnement avec la collaboration (Oui, inscrivez-vous en créant un abonnement maintenant)	Créez une collaboration et une adhésion
      Créez la collaboration et ne créez pas d'adhésion pour le moment (Non, je créerai un abonnement plus tard)	Créez une collaboration

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.

Étapes suivantes

Vous êtes maintenant prêt à :

• Préparez votre tableau de données à interroger. AWS Clean Rooms (Facultatif si vous souhaitez interroger vos propres données.)

• Associez le tableau configuré à votre collaboration. (Facultatif si vous souhaitez interroger vos propres données.)

• Configurez une règle d'analyse pour la table configurée. (Facultatif si vous souhaitez interroger vos propres données.)

• Créez un abonnement et rejoignez une collaboration.

• Gérez votre collaboration.