Creazione di una collaborazione in AWS Clean Rooms

Una collaborazione è un limite logico sicuro AWS Clean Rooms in cui i membri possono eseguire query SQL su tabelle configurate.

Qualsiasi membro AWS Clean Rooms può creare una collaborazione.

Il creatore della collaborazione può designare un singolo membro per interrogare e ricevere risultati. Tuttavia, l'autore della collaborazione potrebbe voler impedire al membro che può eseguire la query di accedere ai risultati della query. In tal caso, l'autore della collaborazione può designare un membro che può eseguire le interrogazioni e un altro membro che può ricevere i risultati.

Nella maggior parte dei casi, il membro che può eseguire le query è anche il membro che paga i costi di elaborazione delle query. Tuttavia, il creatore della collaborazione può configurare un altro membro affinché sia responsabile del pagamento dei costi di elaborazione delle query.

Per informazioni su come creare una collaborazione utilizzando gli AWS SDK, consulta l'AWS Clean RoomsAPI Reference.

Crea una collaborazione

Prima di iniziare, assicurati di aver completato i seguenti prerequisiti:

• Hai il nome e l'Account AWSID di ogni membro che desideri invitare alla collaborazione.

• Hai il permesso di condividere il nome e l'Account AWSID di ogni membro con tutti i membri della collaborazione.

Nota

Non puoi aggiungere altri membri dopo la creazione della collaborazione.

Per creare una collaborazione utilizzando la AWS Clean Rooms console

1. Accedi AWS Management Console e apri la AWS Clean Roomsconsole con il programma Account AWS che fungerà da creatore della collaborazione.

2. Nel riquadro di navigazione a sinistra, scegli Collaborazioni.

3. Nell'angolo in alto a destra, scegli Crea collaborazione.

4. Per la Fase 1: Definizione della collaborazione, procedi come segue:

   1. Per i dettagli, inserisci il nome e la descrizione della collaborazione.

      Queste informazioni saranno visibili ai membri della collaborazione che sono invitati a partecipare alla collaborazione. Il nome e la descrizione li aiutano a capire a cosa si riferisce la collaborazione.

   2. Per i membri:

      1. Per Membro 1: Inserisci il nome visualizzato del Membro come desideri che appaia per la collaborazione.

         Nota

         Il tuo Account AWS ID viene incluso automaticamente come Account AWSID membro.

      2. Per Membro 2, inserisci il nome visualizzato del membro e l'Account AWSID membro per il membro che desideri invitare alla collaborazione.

         Il nome visualizzato del membro e l'Account AWSID membro saranno visibili a tutti gli invitati alla collaborazione. Dopo aver inserito e salvato i valori per questi campi, questi non sono modificabili.

         Nota

         È necessario informare il membro della collaborazione che l'Account AWSID membro e il nome visualizzato del membro saranno visibili a tutti i collaboratori invitati e attivi nella collaborazione.

      3. Se desideri aggiungere un altro membro, scegli Aggiungi un altro membro. Quindi inserisci il nome visualizzato del membro e l'Account AWSID membro per ogni membro che può contribuire con i dati che desideri invitare alla collaborazione.

   3. Per quanto riguarda le abilità dei soci, scegli una delle seguenti opzioni,

      Se vuoi ...	Quindi...
      Interroga i dati della collaborazione e ricevi i risultati	Scegli te stesso come membro che può eseguire le interrogazioni. Lascia che l'impostazione predefinita del membro che può ricevere risultati sia Uguale a chi esegue le interrogazioni.
      Interroga i dati della collaborazione e assegna un altro membro per ricevere i risultati	Scegli te stesso come membro che può eseguire le interrogazioni. Seleziona il membro che può ricevere risultati dall'elenco a discesa.
      Ricevi i risultati della query nella collaborazione e assegna un altro membro per interrogare i dati	Seleziona il membro che può eseguire interrogazioni dall'elenco a discesa. Scegli te stesso come membro che può ricevere risultati dall'elenco a discesa.
      Crea e gestisci la collaborazione, assegna un altro membro per interrogare i dati e assegna un altro membro per ricevere i risultati	Seleziona il membro che può eseguire interrogazioni dall'elenco a discesa. Seleziona il membro che può ricevere risultati dall'elenco a discesa.

   4. Per la configurazione del pagamento, scegli una delle seguenti opzioni:

      Se vuoi ...	Quindi...
      Assegna al membro che può eseguire le interrogazioni il ruolo di membro che paga i costi di calcolo delle query	Lascia che l'impostazione predefinita del membro che pagherà per le query sia la stessa di chi esegue le query.
      Assegna a un membro diverso il pagamento dei costi di elaborazione delle query	Seleziona il membro che pagherà per le domande dall'elenco a discesa.

   5. Se si desidera abilitare la registrazione delle query, selezionare la casella di controllo Supporta la registrazione delle query per questa collaborazione.

   6. Se desideri abilitare la funzionalità di calcolo crittografico, seleziona la casella di controllo Supporta il calcolo crittografico in questa collaborazione e scegli i seguenti parametri di calcolo crittografico:

      • Consenti colonne cleartext

        Scegli No se non desideri che cleartext le colonne siano consentite nella tabella crittografata.

        Scegli Sì se desideri che cleartext le colonne siano consentite nella tabella crittografata.

        Per essere eseguite SUM o AVG su determinate colonne, le colonne devono essere inseritecleartext.

      • Consenti duplicati

        Scegli No se non desideri che le voci duplicate siano consentite in una fingerprint colonna.

        Scegli Sì se desideri che le voci duplicate siano consentite in una fingerprint colonna.

      • Consenti JOIN colonne con nomi diversi

        Scegli No se non desideri unire fingerprint colonne con nomi diversi.

        Scegli Sì se desideri unire fingerprint colonne con nomi diversi.

      • Conserva NULL i valori

        Scegliete No se non desiderate conservare NULL i valori. NULLi valori non verranno visualizzati come NULL in una tabella crittografata.

        Scegli Sì se desideri conservare NULL i valori. NULLi valori verranno visualizzati come NULL in una tabella crittografata.

      Per ulteriori informazioni sui parametri di calcolo crittografico, vedereParametri di calcolo crittografico.

      Per ulteriori informazioni su come crittografare i dati per utilizzarli inAWS Clean Rooms, vedere. Preparazione di tabelle di dati crittografate con Cryptographic Computing per Clean Rooms

      Nota

      Verifica attentamente queste configurazioni prima di completare il passaggio successivo. Dopo aver creato la collaborazione, puoi solo modificare il nome, la descrizione e se i log delle query sono archiviati in Amazon CloudWatch Logs.

   7. Se desideri abilitare i tag per la risorsa di collaborazione, scegli Aggiungi nuovo tag e inserisci la coppia Chiave e Valore.

   8. Seleziona Avanti.

5. Per la Fase 2: Configurazione dell'iscrizione, procedi come segue:

   1. Scegli un'opzione:

      Se scegli...	Quindi...
      Sì, iscriviti creando subito l'iscrizione	Vengono create sia la collaborazione che la tua iscrizione. Il tuo status nella collaborazione è attivo.
      No, creerò un abbonamento in un secondo momento	Viene creata solo la collaborazione. Il tuo status nella collaborazione è inattivo.

   2. Se sei il membro che può ricevere risultati, in Impostazioni predefinite dei risultati delle query, scegli un'opzione:

      Se tu...	Allora...
      Mantieni selezionata la casella di controllo Imposta impostazioni predefinite ora. (È selezionata per impostazione predefinita).	Per la destinazione dei risultati in Amazon S3, inserisci la destinazione Amazon S3. Per il formato dei risultati della query, scegli CSV o PARQUET.
      Deselezionate la casella di controllo Imposta subito le impostazioni predefinite	Viene creata solo la collaborazione. Il tuo status nella collaborazione è inattivo.

   3. Se hai scelto di abilitare la registrazione delle query nella fase 4.e, scegli una delle seguenti opzioni per l'archiviazione dei log in Amazon CloudWatch Logs:

      Se scegli...	Quindi...
      Accendi	I log delle query che ti riguardano vengono archiviati in Amazon CloudWatch Logs. Ogni membro può ricevere solo i log delle query che ha avviato o che contengono i propri dati. Il membro che può ricevere risultati riceve anche i registri di tutte le query eseguite in una collaborazione, anche se non si accede ai relativi dati tramite una query.
      Disattiva	I log delle query che ti riguardano non vengono archiviati nel tuo account Amazon CloudWatch Logs.

      Nota

      Dopo aver attivato la registrazione delle query, possono essere necessari alcuni minuti per configurare l'archiviazione dei log e iniziare a ricevere i log in Amazon CloudWatch Logs. Durante questo breve periodo, il membro che può eseguire query potrebbe eseguire query che in realtà non inviano log.

   4. Se desideri abilitare i tag per la risorsa dedicata all'iscrizione, scegli Aggiungi nuovo tag e inserisci la coppia Chiave e Valore.

   5. Se sei il membro che paga per le query, indica la tua accettazione selezionando la casella di controllo Accetto di pagare i costi di calcolo delle query in questa collaborazione.

      Nota

      È necessario selezionare questa casella di controllo per procedere.

      Per ulteriori informazioni su come vengono calcolati i prezzi, consultaPrezzi per AWS Clean Rooms.

      Se sei il socio che paga i costi di elaborazione delle query ma non sei il socio che può eseguire le query, ti consigliamo di Budget AWS utilizzare l'opzione per configurare un budget AWS Clean Rooms e ricevere notifiche una volta raggiunto il budget massimo. Per ulteriori informazioni sulla configurazione di un budget, consulta Gestire i costi con Budget AWS nella Guida per l'AWS Cost Managementutente. Per ulteriori informazioni sulla configurazione delle notifiche, consulta l'argomento Creazione di un Amazon SNS per le notifiche sul budget nella Guida per l'AWS Cost Managementutente. Se è stato raggiunto il budget massimo, puoi contattare il membro che può eseguire domande o abbandonare la collaborazione. Se lasci la collaborazione, non sarà più consentita l'esecuzione di query e pertanto non ti verranno più addebitati i costi di elaborazione delle query.

   6. Seleziona Avanti.

6. Per il passaggio 3: revisione e creazione, procedi come segue:

   1. Rivedi le selezioni effettuate per i passaggi precedenti e modificale se necessario.

   2. Seleziona una delle seguenti opzioni:

      Se hai scelto di...	Allora scegli...
      Crea un abbonamento con la collaborazione (Sì, iscriviti creando un abbonamento ora)	Crea collaborazione e appartenenza
      Crea la collaborazione e non creare un'iscrizione in questo momento (No, creerò un'iscrizione in un secondo momento)	Crea collaborazione

Dopo che la collaborazione è stata creata con successo, puoi vedere la pagina dei dettagli della collaborazione in Collaborazioni.

Passaggi successivi

Ora sei pronto per:

• Prepara la tabella di dati in cui eseguire le interrogazioni. AWS Clean Rooms (Facoltativo se desideri interrogare i tuoi dati).

• Associa la tabella configurata alla tua collaborazione. (Facoltativo se desideri interrogare i tuoi dati).

• Configura una regola di analisi per la tabella configurata. (Facoltativo se desideri interrogare i tuoi dati).

• Crea un'iscrizione e partecipa a una collaborazione.

• Gestisci la tua collaborazione.