

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membuat tabel yang dikonfigurasi di AWS Clean Rooms
<a name="create-configured-table"></a>

*Tabel yang dikonfigurasi* adalah referensi ke tabel yang ada di sumber data. Ini berisi aturan analisis yang menentukan bagaimana data dapat ditanyakan. AWS Clean Rooms Tabel yang dikonfigurasi dapat dikaitkan dengan satu atau lebih kolaborasi.

Untuk informasi tentang cara membuat tabel yang dikonfigurasi menggunakan AWS SDKs, lihat [https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html).

**Topics**
+ [Membuat tabel yang dikonfigurasi - sumber data Amazon S3](create-config-table-s3.md)
+ [Membuat tabel yang dikonfigurasi - sumber data Amazon Athena](create-config-table-athena.md)
+ [Membuat tabel yang dikonfigurasi — Sumber data Snowflake](create-config-table-snowflake.md)

# Membuat tabel yang dikonfigurasi - sumber data Amazon S3
<a name="create-config-table-s3"></a>

Dalam prosedur ini, [anggota](glossary.md#glossary-member) melakukan tugas-tugas berikut: 
+  Mengkonfigurasi AWS Glue tabel yang ada untuk digunakan di AWS Clean Rooms. (Langkah ini dapat dilakukan sebelum atau sesudah bergabung dengan kolaborasi, kecuali menggunakan Cryptographic Computing untukClean Rooms.)
**catatan**  
AWS Clean Rooms mendukung AWS Glue tabel. Untuk informasi selengkapnya tentang memasukkan data Anda AWS Glue, lihat[Langkah 3: Unggah tabel data Anda ke Amazon S3](prepare-data-S3.md#upload-to-s3). 
+ Beri nama [tabel yang dikonfigurasi](glossary.md#glossary-configured-table) dan pilih kolom mana yang akan digunakan dalam kolaborasi.

Prosedur berikut mengasumsikan bahwa:
+ Anggota kolaborasi telah [mengunggah tabel data mereka ke Amazon](prepare-data-S3.md#upload-to-s3) S3 [dan membuat AWS Glue](prepare-data-S3.md#create-glue-crawler) tabel.
**catatan**  
**Tujuan Hasil di Amazon S3** tidak dapat berada dalam bucket S3 yang sama dengan sumber data apa pun.
+ (Opsional) Hanya untuk tabel data [terenkripsi](glossary.md#glossary-encryption), anggota kolaborasi telah [menyiapkan tabel data terenkripsi menggunakan klien enkripsi](prepare-encrypted-data.md) C3R.

Anda dapat menggunakan generasi statistik yang disediakan oleh AWS Glue untuk menghitung statistik tingkat kolom untuk tabel. AWS Glue Data Catalog Setelah AWS Glue menghasilkan statistik untuk tabel di Katalog Data, Amazon Redshift Spectrum secara otomatis menggunakan statistik tersebut untuk mengoptimalkan paket kueri. *Untuk informasi selengkapnya tentang menggunakan statistik tingkat kolom komputasi AWS Glue, lihat [Mengoptimalkan performa kueri menggunakan statistik kolom](https://docs.aws.amazon.com/glue/latest/dg/column-statistics.html) di Panduan Pengguna.AWS Glue * Untuk informasi selengkapnya AWS Glue, lihat *[Panduan Pengembang AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/what-is-glue.html)*.

**Untuk membuat tabel yang dikonfigurasi - sumber data Amazon S3**

1. Masuk ke Konsol Manajemen AWS dan buka AWS Clean Rooms konsol di [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. Di panel navigasi kiri, pilih **Tabel**.

1. Di sudut kanan atas, pilih **Konfigurasi tabel baru**.

1. Untuk **Sumber data**, di bawah **sumber AWS data**, pilih **Amazon S3**. 

1. Di bawah **tabel Amazon S3**: 

   1. Pilih **Wilayah** tempat tabel S3 di-host.

      Secara default, Wilayah saat ini (seperti N. Virginia us-east-1) dipilih. 
**Awas**  
Jika sumber data Amazon S3 Anda berada di Wilayah yang berbeda dari lokasi pemrosesan Anda, pemrosesan data dapat terjadi sementara di luar Wilayah sumber. Sebelum melanjutkan, verifikasi bahwa pergerakan data lintas wilayah mematuhi persyaratan kedaulatan data Anda, kebijakan kepatuhan terhadap peraturan, dan standar tata kelola data. 

      Untuk informasi selengkapnya tentang Wilayah, lihat [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html) di. *Referensi Umum AWS* 

   1. Pilih **Database** dari daftar dropdown.

   1. Pilih **Tabel** yang ingin Anda konfigurasi dari daftar dropdown.
**catatan**  
Untuk memverifikasi bahwa ini adalah tabel yang benar, lakukan salah satu dari yang berikut:  
Pilih **Lihat di AWS Glue**.
Aktifkan **Lihat skema dari AWS Glue** untuk melihat skema.
**penting**  
Untuk AWS Glue tabel di mana data dalam format CSV, nama kolom dan urutan dalam skema Glue harus sama persis dengan data CSV. Jika tidak sejajar, daftar kolom yang diizinkan untuk tabel yang dikonfigurasi mungkin tidak diterapkan dengan benar.

1. Untuk **Kolom dan metode analisis yang diizinkan dalam kolaborasi,** 

   1. Untuk **kolom mana yang ingin Anda izinkan dalam kolaborasi?**
      + Pilih **Semua kolom** untuk memungkinkan semua kolom ditanyakan dalam kolaborasi.
      + Pilih **Daftar kustom** untuk mengizinkan satu atau beberapa kolom dari daftar tarik-turun **Tentukan kolom yang diizinkan** untuk ditanyakan dalam kolaborasi.

   1. Untuk **metode analisis yang diizinkan**,

      1. Pilih **Kueri langsung** untuk memungkinkan kueri SQL dijalankan langsung di tabel ini

      1. Pilih **Pekerjaan langsung** untuk memungkinkan PySpark pekerjaan dijalankan langsung di tabel ini.  
**Example Contoh**  

   Misalnya, jika Anda ingin mengizinkan anggota kolaborasi menjalankan kueri SQL langsung dan PySpark pekerjaan di semua kolom, pilih **Semua kolom**, **Kueri langsung**, dan Pekerjaan **langsung**.

1. Untuk **detail tabel yang Dikonfigurasi**, 

   1. Masukkan **Nama** untuk tabel yang dikonfigurasi.

      Anda dapat menggunakan nama default atau mengganti nama tabel ini.

   1. Masukkan **Deskripsi** tabel. 

      Deskripsi membantu membedakan antara tabel lain yang dikonfigurasi dengan nama yang mirip.

1. Jika Anda ingin mengaktifkan **Tag** untuk sumber daya tabel yang dikonfigurasi, pilih **Tambahkan tag baru** lalu masukkan pasangan **Kunci** dan **Nilai**. 

1. Pilih **Konfigurasikan tabel baru**. 

Sekarang setelah Anda membuat tabel yang dikonfigurasi, Anda siap untuk: 
+ [Tambahkan aturan analisis ke tabel yang dikonfigurasi](add-analysis-rule.md)
+ [Kaitkan tabel yang dikonfigurasi ke kolaborasi](associate-configured-table.md)

# Membuat tabel yang dikonfigurasi - sumber data Amazon Athena
<a name="create-config-table-athena"></a>

Opsi sumber data Amazon Athena memungkinkan Anda untuk menanyakan data yang disimpan di Amazon S3, dikatalogkan dalam katalog data atau katalog gabungan, AWS Glue dan akses yang dikontrol melalui. AWS Lake Formation Kedua tabel dan AWS Glue Data Catalog Tampilan didukung. Tautan sumber daya Lake Formation dapat digunakan untuk berbagi tabel dan tampilan di seluruh Akun AWS dan di seberang Wilayah AWS ke akun AWS Clean Rooms anggota yang menggabungkannya ke AWS Clean Rooms kolaborasi. 

**catatan**  
Hanya kumpulan data berbasis Amazon S3 yang dapat ditanyakan melalui integrasi sumber data Athena.

Dalam prosedur ini, [anggota](glossary.md#glossary-member) melakukan tugas-tugas berikut: 
+ Mengkonfigurasi tabel atau tampilan yang ada di AWS Glue Data Catalog untuk digunakan AWS Clean Rooms
+ Beri nama [tabel yang dikonfigurasi](glossary.md#glossary-configured-table) dan pilih kolom mana yang akan digunakan dalam kolaborasi.

Prosedur berikut mengasumsikan bahwa:
+ Anggota kolaborasi telah membuat AWS Glue Data Catalog database dan tabel atau tampilan GDC. 

**Untuk membuat tabel yang dikonfigurasi — sumber data Athena**

1. Masuk ke Konsol Manajemen AWS dan buka AWS Clean Rooms konsol di [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. Di panel navigasi kiri, pilih **Tabel**.

1. Di sudut kanan atas, pilih **Konfigurasi tabel baru**.

1. Untuk **Sumber data**, di bawah **sumber AWS data**, pilih **Amazon Athena**. 

1. Di bawah **tabel Amazon Athena**: 

   1. Pilih **Wilayah** tempat tabel Amazon Athena di-host.

      Secara default, Wilayah saat ini (seperti N. Virginia us-east-1) dipilih. 
**Awas**  
Jika sumber data Amazon Athena Anda berada di Wilayah yang berbeda dari lokasi pemrosesan Anda, pemrosesan data dapat terjadi sementara di luar Wilayah sumber. Sebelum melanjutkan, verifikasi bahwa pergerakan data lintas wilayah mematuhi persyaratan kedaulatan data Anda, kebijakan kepatuhan terhadap peraturan, dan standar tata kelola data. 

      Untuk informasi selengkapnya tentang Wilayah, lihat [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html) di. *Referensi Umum AWS* 

   1. Pilih **Katalog** dari daftar dropdown.

      Secara default, **Katalog AWS Glue Data** dipilih.
      + **AWS Glue Katalog Data** — Katalog default untuk tabel di AWS Glue.
      + **Katalog federasi** - Tersedia jika Anda telah mengonfigurasi Federasi AWS Glue Katalog untuk terhubung ke katalog Apache Iceberg REST jarak jauh. Untuk informasi selengkapnya, lihat [Federasi katalog](https://docs.aws.amazon.com/lake-formation/latest/dg/catalog-federation.html) di *Panduan AWS Lake Formation Pengembang*.

   1. Pilih **Database** dari daftar dropdown.

   1. Pilih **Tabel** yang ingin Anda konfigurasi dari daftar dropdown.
**catatan**  
Untuk memverifikasi bahwa ini adalah tabel yang benar, lakukan salah satu dari yang berikut:  
Pilih **Lihat di AWS Glue** atau **Lihat di AWS Lake Formation** (tergantung pada jenis katalog Anda).
Aktifkan **Lihat skema dari AWS Glue** untuk melihat skema.

1. Untuk **konfigurasi Amazon Athena**,

   1. Pilih **Workgroup** dari daftar dropdown.

   1. Untuk **lokasi keluaran S3**, pilih tindakan yang disarankan, berdasarkan salah satu skenario berikut.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/clean-rooms/latest/userguide/create-config-table-athena.html)

1. Untuk **Kolom yang diizinkan dalam kolaborasi**, pilih opsi berdasarkan tujuan Anda.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/clean-rooms/latest/userguide/create-config-table-athena.html)

1. Untuk **detail tabel yang Dikonfigurasi**, 

   1. Masukkan **Nama** untuk tabel yang dikonfigurasi.

      Anda dapat menggunakan nama default atau mengganti nama tabel ini.

   1. Masukkan **Deskripsi** tabel. 

      Deskripsi membantu membedakan antara tabel lain yang dikonfigurasi dengan nama yang mirip.

   1. Jika Anda ingin mengaktifkan **Tag** untuk sumber daya tabel yang dikonfigurasi, pilih **Tambahkan tag baru** lalu masukkan pasangan **Kunci** dan **Nilai**. 

1. Pilih **Konfigurasikan tabel baru**. 

Sekarang setelah Anda membuat tabel yang dikonfigurasi, Anda siap untuk: 
+ [Tambahkan aturan analisis ke tabel yang dikonfigurasi](add-analysis-rule.md)
+ [Kaitkan tabel yang dikonfigurasi ke kolaborasi](associate-configured-table.md)

# Membuat tabel yang dikonfigurasi — Sumber data Snowflake
<a name="create-config-table-snowflake"></a>

Dalam prosedur ini, [anggota](glossary.md#glossary-member) melakukan tugas-tugas berikut: 
+ Mengkonfigurasi tabel Snowflake yang ada untuk digunakan di. AWS Clean Rooms(Langkah ini dapat dilakukan sebelum atau sesudah bergabung dengan kolaborasi, kecuali menggunakan Cryptographic Computing untukClean Rooms.)
+ Beri nama [tabel yang dikonfigurasi](glossary.md#glossary-configured-table) dan pilih kolom mana yang akan digunakan dalam kolaborasi.

Prosedur berikut mengasumsikan bahwa:
+ Anggota kolaborasi telah mengunggah tabel data mereka ke Snowflake.
+ (Opsional) Hanya untuk tabel data [terenkripsi](glossary.md#glossary-encryption), anggota kolaborasi telah [menyiapkan tabel data terenkripsi menggunakan klien enkripsi](prepare-encrypted-data.md) C3R.

**Untuk membuat tabel yang dikonfigurasi — Sumber data Snowflake**

1. Masuk ke Konsol Manajemen AWS dan buka AWS Clean Rooms konsol di [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. Di panel navigasi kiri, pilih **Tabel**.

1. Di sudut kanan atas, pilih **Konfigurasi tabel baru**.

1. Untuk **sumber data**, di bawah **awan pihak ketiga dan sumber data**, pilih **Snowflake**. 

1. Tentukan **kredenal Snowflake** menggunakan ARN rahasia yang ada atau menyimpan rahasia baru untuk tabel ini.

------
#### [ Use existing secret ARN ]

   1. Jika Anda memiliki ARN rahasia, masukkan di bidang Rahasia **ARN**. 

      Anda dapat mencari ARN rahasia Anda dengan memilih **Go** to. AWS Secrets Manager

   1. Jika Anda memiliki rahasia yang ada dari tabel lain, pilih **Impor rahasia ARN dari tabel yang ada**. 

**catatan**  
Rahasia ARN bisa lintas akun. 

------
#### [ Store a new secret for this table ]

   1. Masukkan kredensi Snowflake berikut:
      + **Nama pengguna Snowflake**
      + **Gudang kepingan salju**
      + **Peran kepingan salju**
      + **Kunci pribadi Snowflake Privacy Enhanced Mail (PEM)** 

   1. Untuk enkripsi, lakukan salah satu hal berikut:
      + Untuk menggunakan Kunci yang dikelola AWS (default), biarkan kotak centang **Sesuaikan pengaturan enkripsi** dihapus. 
      + Untuk menggunakan kustom AWS KMS key:
        + Pilih kotak centang **Sesuaikan pengaturan enkripsi**.
        + Untuk **tombol KMS**, masukkan kunci ARN atau pilih salah satu dari daftar.

   1. Masukkan **nama Rahasia** untuk membantu Anda menemukan kredensialnya nanti.

------

1. Untuk detail **tabel dan skema kepingan salju, masukkan detail** secara manual atau impor detailnya secara otomatis.

------
#### [ Enter the details manually ]

   1. Masukkan pengidentifikasi **akun Snowflake**.

      Untuk informasi selengkapnya, lihat [Pengenal akun](https://docs.snowflake.com/en/user-guide/admin-account-identifier#finding-the-organization-and-account-name-for-an-account) di dokumentasi Snowflake. 

      Pengidentifikasi akun Anda harus dalam format yang digunakan untuk driver Snowflake. Anda perlu mengganti periode (.) dengan tanda hubung (-) sehingga pengenal diformat sebagai. **<orgname>-<account\$1name>**

   1. Masukkan database **Snowflake**.

      Untuk informasi selengkapnya, lihat [database Snowflake di dokumentasi](https://docs.snowflake.com/en/sql-reference/snowflake-db) Snowflake.

   1. Masukkan nama **skema Snowflake**.

   1. Masukkan nama **tabel Snowflake**.

      Untuk informasi lebih lanjut, lihat [Memahami Struktur Tabel Kepingan Salju dalam dokumentasi](https://docs.snowflake.com/en/user-guide/tables-micro-partitions) Kepingan Salju. 

   1. Untuk **Skema**, masukkan **nama Kolom** dan pilih **tipe Data dari daftar** dropdown. 

   1. Pilih **Tambahkan kolom** untuk menambahkan lebih banyak kolom.
      +  Jika Anda memilih **tipe data Object**, tentukan **skema Object**.   
**Example Contoh skema objek**  

        ```
        name STRING,
        location OBJECT(
            x INT, 
            y INT, 
            metadata OBJECT(uuid STRING)
        ),
        history ARRAY(TEXT)
        ```
      + Jika Anda memilih **tipe data Array**, tentukan **skema Array**.  
**Example Contoh skema array**  

        ```
        OBJECT(x INT, y INT)
        ```
      + Jika Anda memilih **tipe data Peta**, tentukan **skema Peta**.  
**Example Contoh skema peta**  

        ```
        STRING, OBJECT(x INT, y INT)
        ```

------
#### [ Automatically import the details ]

   1. Ekspor tampilan KOLOM Anda dari Snowflake sebagai file CSV.

      Untuk informasi selengkapnya tentang tampilan Snowflake COLUMNS, lihat tampilan [COLUMNS di dokumentasi](https://docs.snowflake.com/en/sql-reference/info-schema/columns) Snowflake.

   1. Pilih **Impor dari file** untuk mengimpor file CSV dan menentukan informasi tambahan apa pun. 

      Nama database, nama skema, nama tabel, nama kolom dan tipe data secara otomatis diimpor.
      +  Jika Anda memilih **tipe data Object**, tentukan **skema Object**. 
      + Jika Anda memilih **tipe data Array**, tentukan **skema Array**.
      + Jika Anda memilih **tipe data Peta**, tentukan **skema Peta**.

   1. Masukkan pengidentifikasi **akun Snowflake**.

      Untuk informasi selengkapnya, lihat [Pengenal akun](https://docs.snowflake.com/en/user-guide/admin-account-identifier#finding-the-organization-and-account-name-for-an-account) di dokumentasi Snowflake. 

**catatan**  
 Hanya tabel S3 yang dikatalogkan AWS Glue dapat digunakan untuk mengambil skema tabel secara otomatis.

------

1. Untuk **Kolom yang diizinkan dalam kolaborasi**, pilih opsi berdasarkan tujuan Anda.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/clean-rooms/latest/userguide/create-config-table-snowflake.html)

1. Untuk **detail tabel yang Dikonfigurasi**, 

   1. Masukkan **Nama** untuk tabel yang dikonfigurasi.

      Anda dapat menggunakan nama default atau mengganti nama tabel ini.

   1. Masukkan **Deskripsi** tabel. 

      Deskripsi membantu membedakan antara tabel lain yang dikonfigurasi dengan nama yang mirip.

   1. Jika Anda ingin mengaktifkan **Tag** untuk sumber daya tabel yang dikonfigurasi, pilih **Tambahkan tag baru** lalu masukkan pasangan **Kunci** dan **Nilai**. 

1. Pilih **Konfigurasikan tabel baru**. 

Sekarang setelah Anda membuat tabel yang dikonfigurasi, Anda siap untuk: 
+ [Tambahkan aturan analisis ke tabel yang dikonfigurasi](add-analysis-rule.md)
+ [Kaitkan tabel yang dikonfigurasi ke kolaborasi](associate-configured-table.md)