Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bekerja dengan metadata objek
*Ada dua jenis metadata objek di Amazon S3*: metadata yang ditentukan sistem dan metadata yang* ditentukan pengguna.* Metadata yang ditentukan sistem mencakup metadata seperti tanggal pembuatan objek, ukuran, dan kelas penyimpanan. Metadata yang ditentukan pengguna adalah metadata yang dapat Anda pilih untuk disetel pada saat Anda mengunggah objek. Metadata yang ditentukan pengguna ini adalah sekumpulan pasangan nama-nilai. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan sistem](#SysMetadata) dan [Metadata objek yang ditentukan pengguna](#UserMetadata).
Saat membuat objek, Anda menentukan *kunci objek* (atau *nama kunci*), yang secara unik mengidentifikasi objek dalam bucket Amazon S3. Untuk informasi selengkapnya, lihat [Menamai objek Amazon S3](object-keys.md). Anda juga dapat mengatur [metadata yang ditentukan pengguna di Amazon](#UserMetadata) S3 pada saat Anda mengunggah objek.
Setelah mengunggah objek, Anda tidak dapat mengubah metadata yang ditentukan pengguna ini. Satu-satunya cara untuk memodifikasi metadata ini adalah dengan membuat salinan objek dan mengatur metadata. Untuk informasi selengkapnya tentang mengedit metadata menggunakan konsol Amazon S3, lihat. [Mengedit metadata objek di konsol Amazon S3](add-object-metadata.md)
**Kueri metadata Anda dan percepat penemuan data dengan S3 Metadata**
Untuk menemukan, menyimpan, dan menanyakan metadata objek S3 dengan mudah, Anda dapat menggunakan Metadata S3. Dengan S3 Metadata, Anda dapat dengan cepat menyiapkan data untuk digunakan dalam analisis bisnis, pengambilan konten, kecerdasan buatan dan pelatihan model pembelajaran mesin (AI/ML), dan banyak lagi.
Metadata S3 mempercepat penemuan data dengan secara otomatis menangkap metadata untuk objek di bucket tujuan umum Anda dan menyimpannya dalam tabel hanya-baca dan terkelola penuh yang dapat Anda kueri. Apache Iceberg Tabel hanya baca ini disebut *tabel metadata*. Saat objek ditambahkan, diperbarui, dan dihapus dari bucket tujuan umum Anda, Metadata S3 secara otomatis menyegarkan tabel metadata yang sesuai untuk menampilkan perubahan terbaru.
[Secara default, Metadata S3 menyediakan metadata [objek yang ditentukan sistem, seperti waktu pembuatan objek dan kelas penyimpanan, dan metadata](#SysMetadata) khusus, seperti tag dan metadata yang ditentukan pengguna yang disertakan selama pengunggahan objek.](#UserMetadata) Metadata S3 juga menyediakan metadata peristiwa, seperti ketika objek diperbarui atau dihapus, dan yang membuat permintaan. Akun AWS
Tabel metadata disimpan dalam bucket tabel S3, yang menyediakan penyimpanan yang dioptimalkan untuk data tabular. Untuk menanyakan metadata Anda, Anda dapat mengintegrasikan keranjang meja Anda dengan layanan AWS analitik, seperti Amazon Athena, Amazon Redshift, dan Amazon Quick.
Untuk informasi selengkapnya tentang Metadata S3, lihat. [Menemukan data Anda dengan tabel Metadata S3](metadata-tables-overview.md)
## Metadata objek yang ditentukan sistem
Untuk setiap objek yang disimpan dalam sebuah bucket, Amazon S3 akan menyimpan serangkaian metadata sistem. Amazon S3 memproses metadata sistem ini sesuai dengan kebutuhan. Misalnya, Amazon S3 mempertahankan tanggal pembuatan objek dan metadata ukuran, menggunakan informasi ini sebagai bagian dari manajemen objek.
Terdapat dua kategori metadata sistem:
+ **Sistem dikendalikan** — Metadata seperti tanggal pembuatan objek dikendalikan oleh sistem, yang berarti hanya Amazon S3 yang dapat mengubah nilai tanggal.
+ **Dikontrol pengguna**–Metadata sistem lainnya, seperti kelas penyimpanan yang dikonfigurasi untuk objek dan apakah enkripsi di sisi server objek diaktifkan, adalah beberapa contoh metadata sistem yang nilai-nilainya Anda kendalikan. Jika bucket Anda dikonfigurasi sebagai situs web, terkadang Anda mungkin ingin mengarahkan permintaan halaman ke halaman lain atau URL eksternal. Dalam hal ini, halaman laman web adalah sebuah objek di dalam bucket Anda. Amazon S3 menyimpan nilai pengalihan halaman sebagai metadata sistem, yang dapat Anda kontrol.
Saat membuat objek, Anda dapat mengonfigurasi nilai item metadata sistem ini, atau memperbarui nilai saat Anda membutuhkannya. Untuk informasi selengkapnya tentang kelas penyimpanan, lihat [Memahami dan mengelola kelas penyimpanan Amazon S3](storage-class-intro.md).
Amazon S3 menggunakan AWS KMS kunci untuk mengenkripsi objek Amazon S3 Anda. AWS KMS mengenkripsi hanya data objek. Checksum dan algoritma yang ditentukan disimpan sebagai bagian dari metadata objek. Jika enkripsi di sisi server diminta untuk objek, maka checksum disimpan dalam bentuk terenkripsi. Untuk informasi lebih lanjut tentang enkripsi di sisi server, lihat [Melindungi data dengan enkripsi](UsingEncryption.md).
**catatan**
Header permintaan `PUT` dibatasi hingga ukuran 8 KB. Dalam header permintaan `PUT`, metadata yang ditentukan sistem dibatasi ke dalam ukuran 2 KB. Ukuran metadata yang ditentukan sistem diukur dengan menjumlahkan jumlah byte dalam pengodean US-ASCII dari setiap kunci dan nilai.
Tabel berikut ini menyediakan daftar metadata yang ditentukan sistem, dan apakah Anda dapat memperbaruinya.
| Nama | Deskripsi | Apakah pengguna dapat mengubah nilainya? |
| --- | --- | --- |
| Date | Tanggal dan waktu saat ini. | Tidak |
| Cache-Control | Bidang header umum yang digunakan untuk menentukan kebijakan caching. | Ya |
| Content-Disposition | Informasi presentasi objek. | Ya |
| Content-Encoding | Pengkodean konten (seperti kompresi) yang telah diterapkan pada data objek | Ya |
| Content-Length | Ukuran objek dalam byte. | Tidak |
| Content-Type | Jenis objek. | Ya |
| Last-Modified | Tanggal pembuatan objek atau tanggal modifikasi terakhir, mana pun yang terbaru. Untuk unggahan multibagian, tanggal pembuatan objek adalah tanggal inisiasi unggahan multibagian. | Tidak |
| ETag | Tag entitas (ETag) yang mewakili versi tertentu dari suatu objek. Untuk objek yang tidak diunggah sebagai unggahan multibagian dan tidak dienkripsi atau dienkripsi oleh enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3), ini adalah intisari data. ETag MD5 | Tidak |
| x-amz-server-side-encryption | Header yang menunjukkan apakah enkripsi sisi server diaktifkan untuk objek, dan apakah enkripsi tersebut menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS) atau menggunakan kunci enkripsi terkelola Amazon S3 (SSE-S3). Untuk informasi selengkapnya, lihat [Melindungi data dengan enkripsi di sisi klien](serv-side-encryption.md). | Ya |
| x-amz-checksum-crc64nvme, x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-sha1, x-amz-checksum-sha256 | Header yang berisi checksum atau intisari objek. Biasanya, salah satu header ini akan diatur pada satu waktu, bergantung pada algoritma checksum yang Anda perintahkan untuk digunakan oleh Amazon S3. Untuk informasi selengkapnya tentang memilih algoritma checksum, lihat [Memeriksa integritas objek di Amazon S3](checking-object-integrity.md). | Tidak |
| x-amz-checksum-type | Tipe checksum, yang menentukan bagaimana checksum tingkat bagian digabungkan untuk membuat checksum tingkat objek untuk objek multipart. | Ya |
| x-amz-version-id | Versi objek tersebut. Saat Anda mengaktifkan Penentuan Versi pada bucket, Amazon S3 menetapkan ID versi ke objek yang ditambahkan ke bucket. Untuk informasi selengkapnya, lihat [Mempertahankan beberapa versi objek dengan Versi S3](Versioning.md). | Tidak |
| x-amz-delete-marker | Penanda Boolean yang mengindikasikan apakah objek tersebut adalah penanda hapus. Penanda ini hanya digunakan dalam bucket yang mengaktifkan Penentuan Versi, | Tidak |
| x-amz-storage-class | Kelas penyimpanan yang digunakan untuk menyimpan objek tersebut. Untuk informasi selengkapnya, lihat [Memahami dan mengelola kelas penyimpanan Amazon S3](storage-class-intro.md). | Ya |
| x-amz-website-redirect-location | Sebuah header yang mengalihkan permintaan objek terkait ke objek lain di bucket yang sama, atau ke URL eksternal. Untuk informasi selengkapnya, lihat [(Opsional) Mengonfigurasi pengalihan halaman web](how-to-page-redirect.md). | Ya |
| x-amz-server-side-encryption-aws-kms-key-id | Header yang menunjukkan ID kunci KMS enkripsi AWS KMS simetris yang digunakan untuk mengenkripsi objek. Header ini hanya digunakan ketika header x-amz-server-side-encryption muncul, dan memiliki nilai aws:kms. | Ya |
| x-amz-server-side-encryption-customer-algorithm | Header yang menunjukkan apakah enkripsi di sisi server dengan kunci enkripsi yang disediakan pelanggan (SSE-C) telah diaktifkan. Untuk informasi selengkapnya, lihat [Menggunakan enkripsi di sisi server dengan kunci yang disediakan pelanggan (SSE-C)](ServerSideEncryptionCustomerKeys.md). | Ya |
| x-amz-tagging | Tag-set untuk objek tersebut. Kumpulan tag harus dikodekan sebagai parameter Kueri URL. | Ya |
## Metadata objek yang ditentukan pengguna
Saat mengunggah objek, Anda juga dapat menetapkan metadata pada objek tersebut. Anda memberikan informasi opsional ini sebagai pasangan nama-nilai (nilai-kunci) saat Anda mengirimkan permintaan `PUT` atau `POST` untuk membuat objek. Saat Anda mengunggah objek menggunakan API REST, nama metadata opsional yang ditentukan pengguna harus dimulai dengan `x-amz-meta-` untuk membedakannya dari header HTTP lainnya. Saat Anda mengambil objek menggunakan API REST, prefiks ini akan ditampilkan. Saat Anda mengunggah objek menggunakan SOAP API, prefiks tidak dibutuhkan. Saat Anda mengambil objek menggunakan SOAP API, prefiks akan dihapus, tanpa menghiraukan API apa yang Anda gunakan untuk mengunggah objek tersebut.
**catatan**
SOAP APIs untuk Amazon S3 tidak tersedia untuk pelanggan baru, dan mendekati End of Life (EOL) pada 31 Agustus 2025. Kami menyarankan Anda menggunakan REST API atau AWS SDKs.
Saat metadata diambil melalui API REST, Amazon S3 menggabungkan header yang memiliki nama yang sama (kasus pengabaian) ke dalam daftar yang dibatasi koma. Jika beberapa metadata berisi karakter yang tidak dapat dicetak, maka metadata tidak akan ditampilkan. Sebaliknya, header `x-amz-missing-meta` ditampilkan dengan nilai jumlah dari entri metadata yang tidak dapat dicetak. Tindakan `HeadObject` mengambil metadata dari sebuah objek tanpa mengembalikan objek itu sendiri. Operasi ini berguna jika Anda hanya tertarik pada metadata objek. Untuk menggunakan `HEAD`, Anda harus memiliki akses `READ` ke objek. Untuk informasi selengkapnya, lihat [HeadObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)di *Referensi API Amazon Simple Storage Service*.
Metadata yang ditentukan pengguna adalah sekumpulan pasangan nilai-kunci. Amazon S3 menyimpan kunci metadata yang ditentukan pengguna dalam huruf kecil.
Amazon S3 memungkinkan karakter Unicode arbitrer dalam nilai metadata Anda.
Untuk menghindari masalah yang terkait dengan penyajian nilai metadata ini, Anda harus menyesuaikan diri dengan menggunakan karakter US-ASCII saat menggunakan REST dan UTF-8 saat menggunakan SOAP atau unggahan berbasis browser melalui. `POST`
Saat menggunakan non-US-ASCII karakter dalam nilai metadata Anda, string Unicode yang disediakan diperiksa untuk karakter. non-US-ASCII Nilai header tersebut didekodekan karakternya sesuai [RFC 2047](https://datatracker.ietf.org/doc/html/rfc2047) sebelum disimpan dan dikodekan sesuai [RFC 2047](https://datatracker.ietf.org/doc/html/rfc2047) agar aman untuk email sebelum dikembalikan. Jika string hanya berisi karakter US-ASCII, string akan ditampilkan sebagaimana adanya.
Berikut adalah contohnya.
```
PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-nonascii: ÄMÄZÕÑ S3
HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-nonascii: =?UTF-8?B?w4PChE3Dg8KEWsODwpXDg8KRIFMz?=
PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3
HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3
```
**catatan**
Header permintaan `PUT` dibatasi hingga ukuran 8 KB. Dalam header permintaan `PUT`, metadata yang ditentukan pengguna dibatasi hingga ke dalam ukuran 2 KB. Ukuran metadata yang ditentukan pengguna diukur dengan menjumlahkan jumlah byte dalam pengodean UTF-8 dari setiap kunci dan nilai.
Untuk informasi tentang mengubah metadata objek Anda setelah diunggah dengan membuat salinan objek, memodifikasinya, dan mengganti objek lama, atau membuat versi baru, lihat [Mengedit metadata objek di konsol Amazon S3](add-object-metadata.md).
# Mengedit metadata objek di konsol Amazon S3
**Anda dapat menggunakan konsol Amazon S3 untuk mengedit metadata objek S3 yang ada dengan menggunakan tindakan Salin.** Untuk mengedit metadata, Anda menyalin objek ke tujuan yang sama dan menentukan metadata baru yang ingin Anda terapkan, yang menggantikan metadata lama untuk objek tersebut. Beberapa metadata diatur oleh Amazon S3 saat Anda mengunggah objek. Misalnya, `Content-Length` dan `Last-Modified` merupakan bidang metadata objek yang ditentukan sistem yang tidak dapat dimodifikasi oleh pengguna.
Anda juga dapat mengatur metadata yang ditentukan pengguna saat mengunggah objek dan menggantinya saat kebutuhan Anda berubah. Misalnya, Anda mungkin memiliki serangkaian objek yang awalnya Anda simpan di dalam kelas penyimpanan `STANDARD`. Seiring waktu, Anda mungkin tidak lagi memerlukan data ini untuk menjadi sangat tersedia. Jadi, Anda dapat mengubah kelas penyimpanan `GLACIER` dengan mengganti nilai `x-amz-storage-class` kunci dari `STANDARD` ke`GLACIER`.
**catatan**
Pertimbangkan hal berikut saat Anda mengganti metadata objek di Amazon S3:
Anda harus menentukan metadata yang ada yang ingin Anda pertahankan, metadata yang ingin Anda tambahkan, dan metadata yang ingin Anda edit.
Jika objek Anda kurang dari 5 GB, Anda dapat menggunakan tindakan **Copy** di konsol S3 untuk mengganti metadata objek. Jika objek Anda lebih besar dari 5 GB, Anda dapat mengganti metadata objek saat Anda menyalin objek dengan unggahan multipart dengan menggunakan or. [AWS CLI[AWS SDKs](CopyingObjectsMPUapi.md)](mpu-upload-object.md#UsingCLImpUpload) Untuk informasi selengkapnya, lihat [Menyalin objek menggunakan unggahan multibagian](CopyingObjectsMPUapi.md).
Untuk daftar izin tambahan yang diperlukan untuk mengganti metadata, lihat. [Izin yang diperlukan untuk operasi API Amazon S3](using-with-s3-policy-actions.md) Misalnya kebijakan yang memberikan izin ini, lihat[Contoh kebijakan berbasis identitas untuk Amazon S3](example-policies-s3.md).
Tindakan ini membuat *salinan* objek dengan pengaturan yang diperbarui dan tanggal modifikasi terakhir. Jika Penentuan Versi S3 diaktifkan, versi baru objek akan dibuat, dan objek yang sudah ada menjadi versi yang lebih lama. Jika Pembuatan Versi S3 tidak diaktifkan, salinan baru objek menggantikan objek asli. Akun AWS Terkait dengan peran IAM yang mengubah properti juga menjadi pemilik objek baru atau (versi objek).
Mengedit metadata menggantikan nilai untuk nama kunci yang ada.
Objek yang dienkripsi dengan kunci enkripsi yang disediakan pelanggan (SSE-C) tidak dapat disalin dengan menggunakan konsol. Anda harus menggunakan AWS CLI, AWS SDK, atau Amazon S3 REST API.
Saat menyalin objek menggunakan konsol Amazon S3, Anda mungkin menerima pesan kesalahan “Metadata yang disalin tidak dapat diverifikasi.” Konsol menggunakan header untuk mengambil dan mengatur metadata untuk objek Anda. Jika konfigurasi jaringan atau browser Anda mengubah permintaan jaringan Anda, perilaku ini dapat menyebabkan metadata yang tidak diinginkan (seperti `Cache-Control` header yang dimodifikasi) ditulis ke objek yang Anda salin. Amazon S3 tidak dapat memverifikasi metadata yang tidak diinginkan ini.
Untuk mengatasi masalah ini, periksa konfigurasi jaringan dan browser Anda untuk memastikan tidak mengubah header, seperti`Cache-Control`. Untuk informasi selengkapnya, lihat [Model Tanggung Jawab Bersama](https://docs.aws.amazon.com/whitepapers/latest/applying-security-practices-to-network-workload-for-csps/the-shared-responsibility-model.html).
**Awas**
Saat mengganti metadata untuk folder, tunggu hingga tindakan **Salin** selesai sebelum menambahkan objek baru ke folder. Jika tidak, objek baru juga akan diedit.
Topik berikut menjelaskan cara mengganti metadata untuk objek dengan menggunakan tindakan **Salin** di konsol Amazon S3.
## Mengganti metadata yang ditentukan sistem
Anda dapat mengganti beberapa metadata yang ditentukan sistem untuk objek S3. Untuk daftar metadata dan nilai yang ditentukan sistem yang dapat Anda modifikasi, lihat. [Metadata objek yang ditentukan sistem](UsingMetadata.md#SysMetadata)
**Untuk mengganti metadata objek yang ditentukan sistem**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih Bucket **tujuan umum atau ember** **Direktori**.
1. Dalam daftar ember, pilih nama bucket yang berisi objek yang ingin Anda ubah.
1. Pilih kotak centang untuk objek yang ingin Anda ubah.
1. Pada menu **Tindakan**, pilih **Salin** dari daftar opsi yang muncul.
1. Untuk menentukan jalur tujuan, pilih **Browse S3**, navigasikan ke tujuan yang sama dengan objek sumber, dan pilih kotak centang tujuan. Pilih **Pilih tujuan** di sudut kanan bawah.
Atau, masukkan jalur tujuan.
1. Jika Anda *tidak* mengaktifkan versi bucket, Anda akan melihat peringatan yang merekomendasikan Anda mengaktifkan Bucket Versioning untuk membantu melindungi dari penimpaan atau penghapusan objek secara tidak sengaja. Jika Anda ingin menyimpan semua versi objek dalam bucket ini, pilih **Aktifkan Penentuan Versi Bucket**. Anda juga dapat melihat enkripsi default dan properti Object Lock di **Detail tujuan**.
1. Di bawah **Pengaturan salinan tambahan**, pilih **Tentukan pengaturan** untuk menentukan pengaturan untuk **Metadata**.
1. Gulir ke bagian **Metadata**, lalu pilih **Ganti semua** metadata.
1. Pilih **Tambah Metadata**.
1. Untuk metadata **Jenis**, pilih **Ditentukan sistem**.
1. Tentukan **Kunci** unik dan **Nilai** metadata.
1. Untuk mengedit metadata tambahan, pilih **Tambahkan metadata**. Anda juga dapat memilih **Hapus** untuk menghapus satu set type-key-values.
1. Pilih **Salin**. Amazon S3 menyimpan perubahan metadata Anda.
## Mengganti metadata yang ditentukan pengguna
Anda dapat mengganti metadata objek yang ditentukan pengguna dengan menggabungkan awalan metadata`x-amz-meta-`, dan nama yang Anda pilih untuk membuat kunci kustom. Misalnya, jika Anda menambahkan nama kustom `alt-name`, kunci metadata adalah `x-amz-meta-alt-name`.
Metadata yang ditentukan pengguna dapat berukuran sebesar 2 KB. Untuk menghitung ukuran total metadata yang ditentukan pengguna, hitung jumlah byte dalam pengodean UTF-8 untuk setiap kunci dan nilai. Kunci dan nilainya harus sesuai dengan standar US-ASCII. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan pengguna](UsingMetadata.md#UserMetadata).
**Untuk mengganti metadata objek yang ditentukan pengguna**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi, pilih **Bucket**, lalu pilih tab Bucket **tujuan umum atau Bucket** **direktori**. Arahkan ke bucket Amazon S3 atau folder yang berisi objek yang ingin Anda ubah.
1. Pilih kotak centang untuk objek yang ingin Anda ubah.
1. Pada menu **Tindakan**, pilih **Salin** dari daftar opsi yang muncul.
1. Untuk menentukan jalur tujuan, pilih **Browse S3**, navigasikan ke tujuan yang sama dengan objek sumber, dan pilih kotak centang tujuan. Pilih **Pilih tujuan**.
Atau, masukkan jalur tujuan.
1. Jika Anda *tidak* mengaktifkan versi bucket, Anda akan melihat peringatan yang merekomendasikan Anda mengaktifkan Bucket Versioning untuk membantu melindungi dari penimpaan atau penghapusan objek secara tidak sengaja. Jika Anda ingin menyimpan semua versi objek dalam bucket ini, pilih **Aktifkan Penentuan Versi Bucket**. Anda juga dapat melihat enkripsi default dan properti Object Lock di **Detail tujuan**.
1. Di bawah **Pengaturan salinan tambahan**, pilih **Tentukan pengaturan** untuk menentukan pengaturan untuk **Metadata**.
1. Gulir ke bagian **Metadata**, lalu pilih **Ganti semua** metadata.
1. Pilih **Tambah Metadata**.
1. Untuk metadata **Jenis**, pilih **Ditetapkan pengguna**.
1. Memasukkan **Kunci** kustom yang unik, yang mengikuti `x-amz-meta-`. Masukkan juga metadata **Nilai**.
1. Untuk menambahkan metadata tambahan, pilih **Tambahkan metadata**. Anda juga dapat memilih **Hapus** untuk menghapus satu set type-key-values.
1. Pilih **Salin**. Amazon S3 menyimpan perubahan metadata Anda.
# Menemukan data Anda dengan tabel Metadata S3
Amazon S3 Metadata mempercepat penemuan data dengan secara otomatis menangkap metadata untuk objek di bucket tujuan umum Anda dan menyimpannya dalam tabel hanya-baca dan terkelola penuh yang dapat Anda kueri. Apache Iceberg Tabel hanya baca ini disebut *tabel metadata*. Saat objek ditambahkan, diperbarui, atau dihapus dari bucket tujuan umum Anda, Metadata S3 secara otomatis menyegarkan tabel metadata yang sesuai untuk mencerminkan perubahan terbaru.
Secara default, Metadata S3 menyediakan tiga jenis metadata:
+ [Metadata yang ditentukan sistem](UsingMetadata.md#SysMetadata), seperti waktu pembuatan objek dan kelas penyimpanan
+ Metadata kustom, seperti tag dan [metadata yang ditentukan pengguna yang disertakan selama pengunggahan objek](UsingMetadata.md#UserMetadata)
+ Metadata peristiwa, seperti ketika objek diperbarui atau dihapus, dan Akun AWS yang membuat permintaan
Dengan Metadata S3, Anda dapat dengan mudah menemukan, menyimpan, dan menanyakan metadata untuk objek S3 Anda, sehingga Anda dapat dengan cepat menyiapkan data untuk digunakan dalam analisis bisnis, pengambilan konten, kecerdasan buatan dan pelatihan model pembelajaran mesin (AI/ML), dan banyak lagi.
Untuk setiap bucket tujuan umum, Anda dapat membuat satu konfigurasi tabel metadata yang berisi dua tabel metadata pelengkap:
+ **Tabel jurnal** – Secara default, konfigurasi tabel metadata Anda berisi sebuah *tabel jurnal*, yang mencatat peristiwa yang terjadi untuk objek di dalam bucket Anda. Tabel jurnal mencatat perubahan yang dilakukan pada data Anda hampir secara real time, sehingga membantu Anda mengidentifikasi data baru yang diunggah ke bucket Anda, melacak objek yang baru saja dihapus, memantau transisi siklus hidup, dan banyak lagi. Tabel jurnal mencatat objek baru dan pembaruan untuk objek Anda serta metadatanya (pembaruan yang memerlukan operasi `PUT` atau operasi `DELETE`).
Tabel jurnal menangkap metadata hanya untuk peristiwa perubahan (seperti unggahan, pembaruan, dan penghapusan) yang terjadi setelah Anda membuat konfigurasi tabel metadata Anda. Karena tabel ini dapat dikueri, Anda dapat mengaudit perubahan pada bucket Anda melalui kueri SQL sederhana.
Tabel jurnal diperlukan untuk setiap konfigurasi tabel metadata. (Dalam rilis awal S3 Metadata, tabel jurnal disebut "tabel metadata".)
Untuk informasi selengkapnya tentang data apa yang disimpan dalam tabel jurnal, lihat[Skema tabel jurnal Metadata S3](metadata-tables-schema.md).
Untuk membantu meminimalkan biaya penyimpanan, Anda dapat memilih untuk mengaktifkan kedaluwarsa catatan tabel jurnal. Untuk informasi selengkapnya, lihat [Catatan tabel jurnal yang kedaluwarsa](metadata-tables-expire-journal-table-records.md).
+ **Tabel inventaris langsung** – Anda memiliki opsi untuk menambahkan *tabel inventaris langsung* ke konfigurasi tabel metadata Anda. Tabel inventaris langsung menyediakan inventaris sederhana dan dapat dikueri untuk semua objek serta versinya di dalam bucket Anda sehingga Anda dapat menentukan status terbaru data Anda.
Anda dapat menggunakan tabel inventaris langsung untuk menyederhanakan serta mempercepat alur kerja bisnis dan tugas big data dengan mengidentifikasi objek yang ingin Anda proses untuk berbagai beban kerja. Misalnya, Anda dapat menanyakan tabel inventaris langsung untuk menemukan semua objek yang disimpan dalam kelas penyimpanan tertentu, semua objek dengan tag tertentu, semua objek yang tidak dienkripsi dengan enkripsi sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS), dan banyak lagi.
Saat Anda mengaktifkan tabel inventaris langsung untuk konfigurasi tabel metadata, tabel akan melalui proses yang dikenal sebagai *penimbunan ulang*, di mana Amazon S3 memindai bucket tujuan umum Anda untuk mengambil metadata awal untuk semua objek yang ada di bucket. Tergantung pada jumlah objek dalam ember Anda, proses ini dapat memakan waktu beberapa menit (minimal 15 menit) hingga jam. **Ketika proses penimbunan ulang selesai, status tabel inventaris langsung Anda berubah dari **Penimbunan** Ulang menjadi Aktif.** Setelah penimbunan ulang selesai, pembaruan objek Anda biasanya tercermin dalam tabel inventaris langsung dalam waktu satu jam.
Anda dikenakan biaya untuk mengisi kembali tabel inventaris Anda. Jika ember tujuan umum Anda memiliki lebih dari satu miliar objek, Anda juga dikenakan biaya bulanan untuk tabel inventaris langsung Anda. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
Untuk informasi selengkapnya tentang data apa yang disimpan dalam tabel inventaris langsung, lihat[Skema tabel inventaris langsung Metadata S3](metadata-tables-inventory-schema.md).
Tabel metadata Anda disimpan dalam bucket tabel S3 AWS terkelola, yang menyediakan penyimpanan yang dioptimalkan untuk data tabular. Untuk menanyakan metadata Anda, Anda dapat mengintegrasikan keranjang meja Anda dengan Amazon SageMaker Lakehouse. Integrasi ini, yang menggunakan AWS Glue Data Catalog dan AWS Lake Formation, memungkinkan layanan AWS analitik untuk secara otomatis menemukan dan mengakses data tabel Anda.
Setelah bucket meja terintegrasi dengan AWS Glue Data Catalog, Anda dapat langsung menanyakan tabel metadata Anda dengan layanan AWS analitik seperti Amazon Athena, Amazon EMR, dan Amazon Redshift. Anda juga dapat membuat dasbor interaktif dengan data kueri Anda dengan menggunakan Amazon Quick. Untuk informasi selengkapnya tentang mengintegrasikan bucket tabel S3 AWS terkelola Anda dengan Amazon SageMaker Lakehouse, lihat. [Mengintegrasikan Tabel AWS Amazon S3 dengan layanan analitik](s3-tables-integrating-aws.md)
Anda juga dapat menanyakan tabel metadata Anda denganApache Spark,Apache Trino, dan aplikasi lain yang mendukung Apache Iceberg format dengan menggunakan titik akhir AWS Glue Iceberg REST, titik akhir Amazon S3 Tables Iceberg REST, atau Katalog Tabel Amazon S3 untuk katalog klien. Apache Iceberg Untuk informasi selengkapnya tentang mengakses tabel metadata Anda, lihat. [Mengakses data tabel](s3-tables-access.md)
[Untuk harga Metadata S3, lihat Harga Amazon S3.](https://aws.amazon.com/s3/pricing/)
## Cara kerja tabel metadata
Tabel metadata dikelola oleh Amazon S3, dan tidak dapat dimodifikasi oleh prinsipal IAM di luar Amazon S3 itu sendiri. Namun, Anda dapat menghapus tabel metadata Anda. Akibatnya, tabel metadata bersifat hanya-baca, yang membantu memastikan bahwa tabel tersebut mencerminkan konten bucket tujuan umum Anda dengan benar.
Untuk membuat dan menyimpan metadata objek dalam tabel metadata AWS terkelola, Anda membuat konfigurasi tabel metadata untuk bucket tujuan umum Anda. Amazon S3 dirancang untuk terus memperbarui tabel metadata untuk mencerminkan perubahan terbaru pada data Anda selama konfigurasi aktif pada bucket tujuan umum.
Sebelum Anda membuat konfigurasi tabel metadata, pastikan Anda memiliki izin AWS Identity and Access Management (IAM) yang diperlukan untuk membuat dan mengelola tabel metadata. Untuk informasi selengkapnya, lihat [Menyiapkan izin untuk mengonfigurasi tabel metadata](metadata-tables-permissions.md).
**Penyimpanan tabel metadata, organisasi, dan enkripsi**
Saat Anda membuat konfigurasi tabel metadata, tabel metadata Anda disimpan dalam keranjang tabel terkelola AWS . Semua konfigurasi tabel metadata di akun Anda dan di Wilayah yang sama disimpan dalam satu keranjang tabel AWS terkelola. Bucket tabel AWS terkelola ini diberi nama `aws-s3` dan memiliki format Amazon Resource Name (ARN) berikut:
`arn:aws:s3tables:region:account_id:bucket/aws-s3`
Misalnya, jika ID akun Anda adalah 123456789012 dan bucket tujuan umum Anda berada di US East (Virginia N.) (`us-east-1`), bucket tabel AWS terkelola Anda juga dibuat di US East (Virginia N.) () `us-east-1` dan memiliki ARN berikut:
`arn:aws:s3tables:us-east-1:123456789012:bucket/aws-s3`
Secara default, bucket tabel AWS terkelola dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3). Setelah membuat konfigurasi metadata pertama, Anda dapat mengatur setelan enkripsi default untuk bucket tabel AWS terkelola agar menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-KMS). Untuk informasi selengkapnya, lihat [Enkripsi untuk bucket tabel AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-aws-managed-buckets.html#aws-managed-buckets-encryption) dan[Menentukan enkripsi sisi server dengan AWS KMS kunci (SSE-KMS) di bucket tabel](s3-tables-kms-specify.md).
Dalam bucket tabel AWS terkelola, tabel metadata untuk konfigurasi biasanya disimpan dalam namespace dengan format penamaan berikut:
`b_general-purpose-bucket-name`
**catatan**
Jika nama bucket tujuan umum Anda berisi periode apa pun, periode akan dikonversi menjadi garis bawah (`_`) dalam nama namespace.
Jika ember tujuan umum Anda dibuat sebelum 1 Maret 2018, namanya mungkin berisi huruf besar dan garis bawah, dan mungkin juga panjangnya hingga 255 karakter. Jika nama bucket Anda memiliki karakteristik ini, namespace tabel metadata Anda akan memiliki format yang berbeda. Nama bucket tujuan umum akan diawali dengan`b_`, dipotong menjadi 63 karakter, dikonversi ke semua huruf kecil, dan diakhiran dengan hash.
Tabel metadata memiliki format Amazon Resource Name (ARN) berikut, yang menyertakan ID tabel tabel metadata:
`arn:aws:s3tables:region-code:account-id:bucket/aws-s3/table/table-id`
Misalnya, tabel metadata di Wilayah AS Timur (Virginia N.) akan memiliki ARN seperti berikut:
`arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3/table/a12bc345-67d8-912e-3456-7f89123g4h56`
Tabel jurnal memiliki nama`journal`, dan tabel inventaris langsung memiliki nama`inventory`.
Saat membuat konfigurasi tabel metadata, Anda dapat memilih untuk mengenkripsi tabel metadata AWS terkelola dengan enkripsi sisi server menggunakan kunci () (SSE-KMS). AWS Key Management Service AWS KMS Jika Anda memilih untuk menggunakan SSE-KMS, Anda harus menyediakan kunci KMS yang dikelola pelanggan di Wilayah yang sama dengan bucket tujuan umum Anda. Anda dapat mengatur jenis enkripsi untuk tabel Anda hanya selama pembuatan tabel. Setelah tabel yang dikelola AWS dibuat, Anda tidak dapat mengubah pengaturan enkripsinya. Guna menentukan SSE-KMS untuk tabel metadata Anda, Anda harus memiliki izin tertentu. Untuk informasi selengkapnya, lihat [Izin untuk SSE-KMS](metadata-tables-permissions.md#metadata-kms-permissions).
Pengaturan enkripsi untuk tabel metadata lebih diutamakan daripada pengaturan enkripsi tingkat bucket default. Jika Anda tidak menentukan enkripsi untuk tabel, itu akan mewarisi pengaturan enkripsi default dari bucket.
AWS bucket tabel terkelola tidak dihitung dalam kuota Tabel S3 Anda. Untuk informasi selengkapnya tentang bekerja dengan bucket tabel AWS terkelola dan tabel AWS terkelola, lihat [Bekerja dengan bucket tabel AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-aws-managed-buckets.html).
Untuk memantau pembaruan konfigurasi tabel metadata Anda, Anda dapat menggunakannya. AWS CloudTrail Untuk informasi selengkapnya, lihat [Tindakan tingkat ember Amazon S3 yang dilacak dengan logging CloudTrail](cloudtrail-logging-s3-info.md#cloudtrail-bucket-level-tracking).
**Pemeliharaan tabel metadata dan kedaluwarsa catatan**
Agar tabel metadata Anda berkinerja terbaik, Amazon S3 melakukan aktivitas pemeliharaan berkala pada tabel Anda, seperti pemadatan dan penghapusan file yang tidak direferensikan. Aktivitas pemeliharaan ini membantu meminimalkan biaya penyimpanan tabel metadata Anda dan mengoptimalkan kinerja kueri. Pemeliharaan tabel ini terjadi secara otomatis, tidak memerlukan keikutsertaan atau manajemen berkelanjutan oleh Anda.
**catatan**
Anda tidak dapat mengontrol kedaluwarsa tabel jurnal atau snapshot tabel inventaris. Untuk setiap tabel, Amazon S3 menyimpan minimal 1 snapshot selama maksimal 24 jam.
Untuk membantu meminimalkan biaya, Anda dapat mengonfigurasi kedaluwarsa catatan tabel jurnal. Secara default, catatan tabel jurnal tidak kedaluwarsa, dan catatan tabel jurnal harus disimpan selama minimal 7 hari. Untuk informasi selengkapnya, lihat [Catatan tabel jurnal yang kedaluwarsa](metadata-tables-expire-journal-table-records.md).
**Topics**
+ [
## Cara kerja tabel metadata
](#metadata-tables-how-they-work)
+ [
# Batasan dan batasan tabel metadata
](metadata-tables-restrictions.md)
+ [
# Skema tabel jurnal Metadata S3
](metadata-tables-schema.md)
+ [
# Skema tabel inventaris langsung Metadata S3
](metadata-tables-inventory-schema.md)
+ [
# Mengonfigurasi tabel metadata
](metadata-tables-configuring.md)
+ [
# Menanyakan tabel metadata
](metadata-tables-querying.md)
+ [
# Pemecahan Masalah Metadata S3
](metadata-tables-troubleshooting.md)
# Batasan dan batasan tabel metadata
Metadata Amazon S3 memiliki batasan dan batasan berikut:
+ Metadata S3 saat ini hanya tersedia di Wilayah tertentu. Untuk informasi selengkapnya, lihat [Metadata S3 Wilayah AWS](#metadata-tables-regions).
+ S3 Metadata mendukung semua kelas penyimpanan yang didukung oleh bucket tujuan umum. Untuk kelas penyimpanan S3 Intelligent-Tiering, tingkat tertentu tidak ditampilkan dalam tabel metadata.
+ Saat Anda membuat konfigurasi tabel metadata, tabel metadata Anda disimpan dalam keranjang tabel terkelola AWS . Anda tidak dapat menyimpan konfigurasi di bucket tabel yang dikelola pelanggan.
+ Metadata S3 tidak didukung untuk bucket direktori, bucket tabel, atau bucket vektor. Anda dapat membuat konfigurasi tabel metadata hanya untuk bucket tujuan umum. Tabel jurnal menangkap metadata hanya untuk peristiwa perubahan (seperti unggahan, pembaruan, dan penghapusan) yang terjadi setelah Anda membuat konfigurasi tabel metadata Anda.
+ Anda tidak dapat mengontrol kedaluwarsa tabel jurnal atau snapshot tabel inventaris. Untuk setiap tabel, Amazon S3 menyimpan minimal 1 snapshot selama maksimal 24 jam.
Untuk membantu meminimalkan biaya, Anda dapat mengonfigurasi kedaluwarsa catatan tabel jurnal. Secara default, catatan tabel jurnal tidak kedaluwarsa, dan catatan tabel jurnal harus disimpan selama minimal 7 hari. Untuk informasi selengkapnya, lihat [Catatan tabel jurnal yang kedaluwarsa](metadata-tables-expire-journal-table-records.md).
+ Anda dapat membuat konfigurasi tabel metadata hanya untuk seluruh bucket tujuan umum. Anda tidak dapat menerapkan konfigurasi tabel metadata di tingkat awalan.
+ Anda tidak dapat menjeda dan melanjutkan pembaruan ke tabel metadata. Namun, Anda dapat menghapus konfigurasi metadata terkait untuk jurnal atau tabel inventaris langsung. Menghapus konfigurasi Anda tidak akan menghapus jurnal atau tabel inventaris terkait. Untuk membuat ulang konfigurasi Anda, Anda harus terlebih dahulu menghapus jurnal lama atau tabel inventaris, dan kemudian Amazon S3 dapat membuat jurnal atau tabel inventaris baru. Saat Anda mengaktifkan kembali tabel inventaris, Amazon S3 membuat tabel inventaris baru, dan Anda dikenakan biaya lagi untuk mengisi kembali tabel inventaris baru.
+ Tabel metadata tidak berisi semua metadata yang sama seperti yang tersedia melalui S3 Inventory atau melalui Amazon S3 REST API. Misalnya, informasi berikut tidak tersedia dalam tabel metadata:
+ Kelayakan kedaluwarsa Siklus Hidup S3 atau status transisi
+ Periode retensi Object Lock atau mode tata kelola
+ Informasi daftar kontrol akses objek (ACL)
+ Status replikasi
+ Saat Anda menggunakan Amazon Athena atau Amazon Redshift untuk menanyakan tabel metadata Anda, Anda harus mengelilingi nama namespace tabel metadata Anda dalam tanda kutip () atau backticks `"` (), jika tidak kueri mungkin tidak berfungsi. ``` Sebagai contoh, lihat [Contoh kueri tabel metadata](metadata-tables-example-queries.md).
+ Saat menggunakan EMR Apache Spark Amazon atau mesin pihak ketiga lainnya untuk menanyakan tabel metadata Anda, sebaiknya gunakan titik akhir REST Amazon S3 Tables. Iceberg Kueri Anda mungkin tidak berhasil berjalan jika Anda tidak menggunakan titik akhir ini. Untuk informasi selengkapnya, lihat [Mengakses tabel menggunakan endpoint Amazon S3 Iceberg REST Tables](s3-tables-integrating-open-source.md).
## Metadata S3 Wilayah AWS
Metadata S3 saat ini tersedia sebagai berikut: Wilayah AWS
| Wilayah AWS nama | Wilayah AWS kode |
| --- | --- |
| Africa (Cape Town) | `af-south-1` |
| Asia Pasifik (Hong Kong) | `ap-east-1` |
| Asia Pasifik (Jakarta) | `ap-southeast-3` |
| Asia Pasifik (Melbourne) | `ap-southeast-4` |
| Asia Pasifik (Mumbai) | `ap-south-1` |
| Asia Pasifik (Osaka) | `ap-northeast-3` |
| Asia Pasifik (Seoul) | `ap-northeast-2` |
| Asia Pasifik (Singapura) | `ap-southeast-1` |
| Asia Pasifik (Sydney) | `ap-southeast-2` |
| Asia Pasifik (Tokyo) | `ap-northeast-1` |
| (Canada (Central) | `ca-central-1` |
| Kanada Barat (Calgary) | `ca-west-1` |
| Eropa (Frankfurt) | `eu-central-1` |
| Europe (Zurich) | `eu-central-2` |
| Eropa (Irlandia) | `eu-west-1` |
| Eropa (London) | `eu-west-2` |
| Eropa (Milan) | `eu-south-1` |
| Eropa (Paris) | `eu-west-3` |
| Eropa (Spanyol) | `eu-south-2` |
| Eropa (Stockholm) | `eu-north-1` |
| Israel (Tel Aviv) | `il-central-1` |
| Timur Tengah (Bahrain) | `me-south-1` |
| Timur Tengah (UEA) | `me-central-1` |
| Amerika Selatan (Sao Paulo) | `sa-east-1` |
| AS Timur (Virginia Utara) | `us-east-1` |
| AS Timur (Ohio) | `us-east-2` |
| AS Barat (California Utara) | `us-west-1` |
| AS Barat (Oregon) | `us-west-2` |
| China (Beijing) | `cn-north-1` |
| China (Ningxia) | `cn-northwest-1` |
# Skema tabel jurnal Metadata S3
Tabel jurnal mencatat perubahan yang dilakukan pada data Anda hampir secara real time, sehingga membantu Anda mengidentifikasi data baru yang diunggah ke bucket Anda, melacak objek yang baru saja dihapus, memantau transisi siklus hidup, dan banyak lagi. Tabel jurnal mencatat objek baru dan pembaruan untuk objek Anda serta metadatanya (pembaruan yang memerlukan operasi `PUT` atau operasi `DELETE`). Karena tabel ini dapat dikueri, Anda dapat mengaudit perubahan pada bucket Anda melalui kueri SQL sederhana.
Anda dapat menggunakan tabel jurnal untuk kasus penggunaan keamanan, audit, dan kepatuhan untuk melacak objek yang diunggah, dihapus, dan diubah dalam bucket. Misalnya, Anda dapat menanyakan tabel jurnal untuk menjawab pertanyaan seperti:
+ Objek mana yang dihapus dalam 24 jam terakhir oleh S3 Lifecycle?
+ Alamat IP mana `PUT` permintaan terbaru berasal?
+ Kunci AWS Key Management Service (AWS KMS) mana yang digunakan untuk `PUT` permintaan dalam 7 hari terakhir?
+ Objek apa di ember Anda yang dibuat oleh Amazon Bedrock dalam lima hari terakhir?
Tabel jurnal Metadata Amazon S3 berisi baris dan kolom. Setiap baris mewakili peristiwa mutasi yang telah membuat, memperbarui, atau menghapus objek di bucket tujuan umum Anda. Sebagian besar peristiwa ini dihasilkan dari tindakan pengguna, tetapi beberapa peristiwa ini dihasilkan dari tindakan yang diambil oleh Amazon S3 atas nama Anda, seperti kedaluwarsa Siklus Hidup S3 atau transisi kelas penyimpanan.
Tabel jurnal Metadata S3 pada akhirnya konsisten dengan perubahan yang terjadi di bucket tujuan umum Anda. Dalam beberapa kasus, pada saat Metadata S3 diberi tahu bahwa objek dibuat atau diperbarui, objek tersebut mungkin sudah ditimpa atau dihapus di bucket. Dalam kasus seperti itu, objek tidak dapat lagi diambil dan beberapa kolom mungkin menunjukkan nilai NULL untuk menunjukkan skema metadata yang hilang.
Berikut ini adalah contoh tabel jurnal untuk ember tujuan umum bernama `amzn-s3-demo-bucket:`
```
bucket key sequence_number record_type record_timestamp version_id is_delete_marker size last_modified_date e_tag storage_class is_multipart encryption_status is_bucket_key_enabled kms_key_arn checksum_algorithm object_tags user_metadata requester source_ip_address request_id
amzn-s3-demo-bucket Finance/statement1.pdf 80e737d8b4d82f776affffffffffffffff006737d8b4d82f776a00000000000000000000000000000000000000000000000072 CREATE 2024-11-15 23:26:44.899 FALSE 6223 11/15/2024 23:26 e131b86632dda753aac4018f72192b83 STANDARD FALSE SSE-KMS FALSE arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890df SSECRC32 {} {count -> Asia, customs -> false, family -> true, location -> Mary, name -> football, user -> United States} 111122223333 192.0.2.1 CVK8FWYRW0M9JW65
amzn-s3-demo-bucket s3-dg.pdf 80e737d8b4e39f1dbdffffffffffffffff006737d8b4e39f1dbd00000000000000000000000000000000000000000000000072 CREATE 2024-11-15 23:26:44.942 FALSE 3554 11/15/2024 23:26 9bb49efc2d92c05558ddffbbde8636d5 STANDARD FALSE DSSE-KMS FALSE arn:aws:kms:us-east-1:936810216292:key/0dcebce6-49fd-4cae-b2e2-5512ad281afd SSESHA1 {} {} 111122223333 192.0.2.1 CVKAQDRAZEG7KXAY
amzn-s3-demo-bucket Development/Projects.xls 80e737d8b4ed9ac5c6ffffffffffffffff006737d8b4ed9ac5c600000000000000000000000000000000000000000000000072 CREATE 2024-11-15 23:26:44.966 FALSE 7746 11/15/2024 23:26 729a6863e47fb9955b31bfabce984908 STANDARD FALSE SSE-S3 FALSE NULL SSECRC32 {} {count -> Asia, customs -> Canada, family -> Billiards, filter -> true, location -> Europe, name -> Asia, user -> United States} 111122223333 192.0.2.1 CVK7Z6XQTQ90BSRV
```
Tabel jurnal memiliki skema berikut:
| Nama kolom | Diperlukan? | Jenis data | |
| --- | --- | --- | --- |
| `bucket` | Ya | String | Nama ember tujuan umum. Untuk informasi selengkapnya, lihat [Aturan penamaan bucket tujuan umum](bucketnamingrules.md). |
| `key` | Ya | String | Nama kunci objek (atau kunci) yang secara unik mengidentifikasi objek dalam ember. Untuk informasi selengkapnya, lihat [Menamai objek Amazon S3](object-keys.md). |
| `sequence_number` | Ya | String | Nomor urut, yang merupakan ordinal yang disertakan dalam catatan untuk objek tertentu. Untuk memesan catatan dari ember dan kunci yang sama, Anda dapat mengurutkan`sequence_number`. Untuk ember dan kunci tertentu, `sequence_number` nilai leksikografis yang lebih besar menyiratkan bahwa catatan diperkenalkan ke ember baru-baru ini. |
| `record_type` | Ya | String | Jenis rekaman ini, salah satu `CREATE``UPDATE_METADATA`, atau`DELETE`. `CREATE`catatan menunjukkan bahwa objek baru (atau versi baru dari objek) ditulis ke ember. `UPDATE_METADATA`catatan menangkap perubahan metadata yang bisa berubah untuk objek yang ada, seperti kelas penyimpanan atau tag. `DELETE`catatan menunjukkan bahwa objek ini (atau versi objek ini) telah dihapus. Saat pembuatan versi diaktifkan, `DELETE` catatan mewakili penanda hapus atau penghapusan permanen. Mereka selanjutnya disambiguasi dengan berkonsultasi dengan kolom opsional`is_delete_marker`. Untuk informasi selengkapnya, lihat [Menghapus versi objek dari bucket dengan dukungan Penentuan Versi](DeletingObjectVersions.md). Penghapusan permanen membawa `NULL` s di semua kolom, *kecuali*`bucket`,`key`,,`sequence_number`, `record_type``record_timestamp`, dan `version_id` (yaitu kolom yang ditandai sebagai Diperlukan). |
| `record_timestamp` | Ya | Timestamp NTZ (tidak ada zona waktu) | Stempel waktu yang terkait dengan catatan ini. |
| `version_id` | Tidak | String | ID versi objek. Saat Anda mengaktifkan Penentuan Versi di bucket, Amazon S3 akan menetapkan nomor versi untuk objek yang ditambahkan ke dalam bucket. Untuk informasi selengkapnya, lihat [Mempertahankan beberapa versi objek dengan Versi S3](Versioning.md). Objek yang disimpan di bucket sebelum Anda menyetel status pembuatan versi memiliki ID versi null. |
| `is_delete_marker` | Tidak | Boolean | Status penanda hapus objek. Untuk catatan DELETE yang merupakan penanda hapus, nilai ini adalah`TRUE`. Untuk penghapusan permanen, nilai ini dihilangkan (). `NULL` Jenis rekaman lainnya (CREATE dan UPDATE\$1METADATA) memiliki nilai. `FALSE` Untuk informasi selengkapnya, lihat [Bekerja dengan penanda hapus](DeleteMarker.md). Baris yang ditambahkan untuk penanda hapus memiliki `record_type` nilai`DELETE`, bukan`UPDATE_METADATA`. Jika penanda hapus dibuat sebagai hasil dari kedaluwarsa Siklus Hidup S3, nilainya adalah. `requester` `s3.amazonaws.com` |
| `size` | Tidak | Panjang | Ukuran objek dalam byte, tidak termasuk ukuran unggahan multibagian yang tidak lengkap atau metadata objek. Jika `is_delete_marker` ya`TRUE`, ukurannya`0`. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan sistem](UsingMetadata.md#SysMetadata). |
| `last_modified_date` | Tidak | Timestamp NTZ (tidak ada zona waktu) | Tanggal pembuatan objek atau tanggal modifikasi terakhir, mana pun yang terbaru. Untuk unggahan multipart, tanggal pembuatan objek adalah tanggal saat unggahan multipart dimulai. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan sistem](UsingMetadata.md#SysMetadata). |
| `e_tag` | Tidak | String | Entity tag (ETag), yang merupakan hash dari objek. ETag Merefleksikan perubahan hanya pada isi objek, bukan metadatanya. Itu ETag bisa menjadi MD5 intisari dari data objek. Apakah MD5 intisari ETag adalah tergantung pada bagaimana objek itu dibuat dan bagaimana itu dienkripsi. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html) di *Referensi API Amazon S3*. |
| `storage_class` | Tidak | String | Kelas penyimpanan yang digunakan untuk menyimpan objek. Salah satu`STANDARD`,`REDUCED_REDUNDANCY`,`STANDARD_IA`,`ONEZONE_IA`,`INTELLIGENT_TIERING`,`GLACIER`,`DEEP_ARCHIVE`, atau`GLACIER_IR`. Untuk informasi selengkapnya, lihat [Memahami dan mengelola kelas penyimpanan Amazon S3](storage-class-intro.md). |
| `is_multipart` | Tidak | Boolean | Jenis upload objek. Jika objek diunggah sebagai unggahan multipart, nilai ini adalah. `TRUE` Kalau tidak, itu`FALSE`. Untuk informasi selengkapnya, lihat [Mengunggah dan menyalin objek menggunakan unggahan multipart di Amazon S3](mpuoverview.md). |
| `encryption_status` | Tidak | String | Status enkripsi sisi server objek, tergantung pada jenis kunci enkripsi yang digunakan: enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3), enkripsi sisi server dengan kunci () (SSE-KMS), enkripsi sisi server dua lapis AWS Key Management Service dengan AWS KMS(DSSE-KMS), atau enkripsi sisi server dengan kunci yang disediakan pelanggan (SSE-C). AWS KMS keys Jika objek tidak dienkripsi, nilai ini adalah null. Nilai yang mungkin adalah`SSE-S3`,`SSE-KMS`,`DSSE-KMS`,`SSE-C`, atau nol. Untuk informasi selengkapnya, lihat [Melindungi data dengan enkripsi](UsingEncryption.md). |
| `is_bucket_key_enabled` | Tidak | Boolean | Status pengaktifan Kunci Bucket S3 objek. Jika objek menggunakan S3 Bucket Key untuk SSE-KMS, nilai ini adalah. `TRUE` Kalau tidak, itu`FALSE`. Untuk informasi selengkapnya, lihat [Mengonfigurasi Kunci Bucket S3 pada tingkat objek](configuring-bucket-key-object.md). |
| `kms_key_arn` | Tidak | String | Nama Sumber Daya Amazon (ARN) untuk kunci KMS yang dengannya objek dienkripsi, untuk baris di mana atau. `encryption_status` `SSE-KMS` `DSSE-KMS` Jika objek tidak dienkripsi dengan SSE-KMS atau DSSE-KMS, nilainya nol. Untuk informasi selengkapnya, lihat [Menggunakan enkripsi sisi server dengan AWS KMS kunci (SSE-KMS)](UsingKMSEncryption.md) dan [Menggunakan enkripsi sisi server dual-layer dengan kunci (DSSE-KMS) AWS KMS](UsingDSSEncryption.md). Jika baris mewakili versi objek yang tidak lagi ada pada saat peristiwa hapus atau timpa diproses, `kms_key_arn` berisi nilai null, bahkan jika nilai `encryption_status` kolom adalah `SSE-KMS` atau. `DSSE-KMS` |
| `checksum_algorithm` | Tidak | String | Algoritma yang digunakan untuk membuat checksum untuk objek, salah satu dari`CRC64NVME`,,`CRC32`, `CRC32C``SHA1`, atau`SHA256`. Jika tidak ada checksum hadir, nilai ini adalah null. Untuk informasi selengkapnya, lihat [Menggunakan algoritma checksum yang didukung](checking-object-integrity-upload.md#using-additional-checksums). |
| `object_tags` | Tidak | Peta | Tag objek yang terkait dengan objek. Tag objek disimpan sebagai peta pasangan kunci-nilai. Jika objek tidak memiliki tag objek, peta kosong (`{}`) disimpan. Untuk informasi selengkapnya, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). Jika `record_type` nilainya`DELETE`, `object_tags` kolom berisi nilai null. Jika `record_type` nilainya `CREATE` atau`UPDATE_METADATA`, baris yang mewakili versi objek yang tidak ada lagi pada saat peristiwa hapus atau timpa diproses akan berisi nilai null di `object_tags` kolom. |
| `user_metadata` | Tidak | Peta | Metadata pengguna yang terkait dengan objek. Metadata pengguna disimpan sebagai peta pasangan kunci-nilai. Jika objek tidak memiliki metadata pengguna, peta kosong (`{}`) disimpan. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan pengguna](UsingMetadata.md#UserMetadata). Jika `record_type` nilainya`DELETE`, `user_metadata` kolom berisi nilai null. Jika `record_type` nilainya `CREATE` atau`UPDATE_METADATA`, baris yang mewakili versi objek yang tidak ada lagi pada saat peristiwa hapus atau timpa diproses akan berisi nilai null di `user_metadata` kolom. |
| `requester` | Tidak | String | Akun AWS ID pemohon atau Layanan AWS kepala sekolah yang membuat permintaan. Misalnya, jika pemohon adalah Siklus Hidup S3, nilai ini adalah. `s3.amazonaws.com` |
| `source_ip_address` | Tidak | String | Alamat IP sumber permintaan. Untuk catatan yang dihasilkan oleh permintaan pengguna, kolom ini berisi alamat IP sumber permintaan. Untuk tindakan yang diambil oleh Amazon S3 atau lainnya Layanan AWS atas nama pengguna, kolom ini berisi nilai nol. |
| `request_id` | Tidak | String | ID permintaan yang terkait dengan permintaan. |
# Skema tabel inventaris langsung Metadata S3
Tabel inventaris langsung menyediakan inventaris sederhana dan dapat dikueri untuk semua objek serta versinya di dalam bucket Anda sehingga Anda dapat menentukan status terbaru data Anda. Pembaruan objek Anda biasanya tercermin dalam tabel inventaris dalam waktu satu jam.
Anda dapat menggunakan tabel ini untuk menyederhanakan dan mempercepat alur kerja bisnis dan pekerjaan data besar dengan mengidentifikasi objek yang ingin Anda proses untuk berbagai beban kerja. Misalnya, Anda dapat menanyakan tabel inventaris untuk melakukan hal berikut:
+ Temukan semua objek yang disimpan di kelas penyimpanan S3 Glacier Deep Archive.
+ Buat distribusi tag objek atau temukan objek tanpa tag.
+ Temukan semua objek yang tidak dienkripsi dengan menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-KMS).
Saat Anda mengaktifkan tabel inventaris untuk konfigurasi tabel metadata, tabel akan melalui proses yang dikenal sebagai *penimbunan ulang*, di mana Amazon S3 memindai bucket tujuan umum Anda untuk mengambil metadata awal untuk semua objek di bucket. Tergantung pada jumlah objek dalam ember Anda, proses ini dapat memakan waktu beberapa menit (minimal 15 menit) hingga jam. **Ketika proses penimbunan ulang selesai, status tabel inventaris Anda berubah dari **Penimbunan** Ulang menjadi Aktif.** Setelah penimbunan ulang selesai, pembaruan objek Anda biasanya tercermin dalam tabel inventaris dalam waktu satu jam.
**catatan**
Anda dikenakan biaya untuk mengisi kembali tabel inventaris Anda. Jika ember tujuan umum Anda memiliki lebih dari satu miliar objek, Anda juga dikenakan biaya bulanan untuk tabel inventaris Anda. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
Tabel inventaris Metadata Amazon S3 berisi baris dan kolom. Setiap baris mewakili status objek saat ini di bucket tujuan umum Anda. Tabel inventaris menyediakan inventaris sederhana dan dapat dikueri dari semua objek di bucket Anda sehingga Anda dapat menentukan status data Anda saat ini.
Berikut ini adalah contoh tabel inventaris untuk bucket tujuan umum bernama `amzn-s3-demo-bucket:`
```
bucket key sequence_number version_id is_delete_marker size last_modified_date e_tag storage_class is_multipart encryption_status is_bucket_key_enabled kms_key_arn checksum_algorithm object_tags user_metadata
amzn-s3-demo-bucket Finance/statement1.pdf 80e737d8b4d82f776affffffffffffffff006737d8b4d82f776a00000000000000000000000000000000000000000000000072 FALSE 6223 11/15/2024 23:26 e131b86632dda753aac4018f72192b83 STANDARD FALSE SSE-KMS FALSE arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890df SSECRC32 {} {count -> Asia, customs -> false, family -> true, location -> Mary, name -> football, user -> United States}
amzn-s3-demo-bucket s3-dg.pdf 80e737d8b4e39f1dbdffffffffffffffff006737d8b4e39f1dbd00000000000000000000000000000000000000000000000072 FALSE 3554 11/15/2024 23:26 9bb49efc2d92c05558ddffbbde8636d5 STANDARD FALSE DSSE-KMS FALSE arn:aws:kms:us-east-1:936810216292:key/0dcebce6-49fd-4cae-b2e2-5512ad281afd SSESHA1 {} {}
amzn-s3-demo-bucket Development/Projects.xls 80e737d8b4ed9ac5c6ffffffffffffffff006737d8b4ed9ac5c600000000000000000000000000000000000000000000000072 FALSE 7746 11/15/2024 23:26 729a6863e47fb9955b31bfabce984908 STANDARD FALSE SSE-S3 FALSE NULL SSECRC32 {} {count -> Asia, customs -> Canada, family -> Billiards, filter -> true, location -> Europe, name -> Asia, user -> United States}
```
Tabel inventaris memiliki skema berikut:
| Nama kolom | Diperlukan? | Jenis data | |
| --- | --- | --- | --- |
| `bucket` | Ya | String | Nama ember tujuan umum. Untuk informasi selengkapnya, lihat [Aturan penamaan bucket tujuan umum](bucketnamingrules.md). |
| `key` | Ya | String | Nama kunci objek (atau kunci) yang secara unik mengidentifikasi objek dalam ember. Untuk informasi selengkapnya, lihat [Menamai objek Amazon S3](object-keys.md). |
| `sequence_number` | Ya | String | Nomor urut, yang merupakan ordinal yang disertakan dalam catatan untuk objek tertentu. Untuk memesan catatan dari ember dan kunci yang sama, Anda dapat mengurutkan`sequence_number`. Untuk ember dan kunci tertentu, `sequence_number` nilai leksikografis yang lebih besar menyiratkan bahwa catatan diperkenalkan ke ember baru-baru ini. |
| `version_id` | Tidak | String | ID versi objek. Saat Anda mengaktifkan Penentuan Versi di bucket, Amazon S3 akan menetapkan nomor versi untuk objek yang ditambahkan ke dalam bucket. Untuk informasi selengkapnya, lihat [Mempertahankan beberapa versi objek dengan Versi S3](Versioning.md). Objek yang disimpan di bucket sebelum Anda menyetel status pembuatan versi memiliki ID versi null. |
| `is_delete_marker` | Tidak | Boolean | Status penanda hapus objek. Jika objek adalah penanda hapus, nilai ini adalah`True`. Kalau tidak, itu`False`. Untuk informasi selengkapnya, lihat [Bekerja dengan penanda hapus](DeleteMarker.md). Baris yang ditambahkan untuk penanda hapus memiliki `record_type` nilai`DELETE`, bukan`UPDATE_METADATA`. Jika penanda hapus dibuat sebagai hasil dari kedaluwarsa Siklus Hidup S3, nilainya adalah. `requester` `s3.amazonaws.com` |
| `size` | Tidak | Panjang | Ukuran objek dalam byte, tidak termasuk ukuran unggahan multibagian yang tidak lengkap atau metadata objek. Jika `is_delete_marker` ya`True`, ukurannya`0`. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan sistem](UsingMetadata.md#SysMetadata). |
| `last_modified_date` | Tidak | Timestamp NTZ (tidak ada zona waktu) | Tanggal pembuatan objek atau tanggal modifikasi terakhir, mana pun yang terbaru. Untuk unggahan multipart, tanggal pembuatan objek adalah tanggal saat unggahan multipart dimulai. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan sistem](UsingMetadata.md#SysMetadata). |
| `e_tag` | Tidak | String | Entity tag (ETag), yang merupakan hash dari objek. ETag Merefleksikan perubahan hanya pada isi objek, bukan metadatanya. Itu ETag bisa menjadi MD5 intisari dari data objek. Apakah MD5 intisari ETag adalah tergantung pada bagaimana objek itu dibuat dan bagaimana itu dienkripsi. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html) di *Referensi API Amazon S3*. |
| `storage_class` | Tidak | String | Kelas penyimpanan yang digunakan untuk menyimpan objek. Salah satu`STANDARD`,`REDUCED_REDUNDANCY`,`STANDARD_IA`,`ONEZONE_IA`,`INTELLIGENT_TIERING`,`GLACIER`,`DEEP_ARCHIVE`, atau`GLACIER_IR`. Untuk informasi selengkapnya, lihat [Memahami dan mengelola kelas penyimpanan Amazon S3](storage-class-intro.md). |
| `is_multipart` | Tidak | Boolean | Jenis upload objek. Jika objek diunggah sebagai unggahan multipart, nilai ini adalah. `True` Kalau tidak, itu`False`. Untuk informasi selengkapnya, lihat [Mengunggah dan menyalin objek menggunakan unggahan multipart di Amazon S3](mpuoverview.md). |
| `encryption_status` | Tidak | String | Status enkripsi sisi server objek, tergantung pada jenis kunci enkripsi yang digunakan: enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3), enkripsi sisi server dengan kunci () (SSE-KMS), enkripsi sisi server dua lapis AWS Key Management Service dengan AWS KMS(DSSE-KMS), atau enkripsi sisi server dengan kunci yang disediakan pelanggan (SSE-C). AWS KMS keys Jika objek tidak dienkripsi, nilai ini adalah null. Nilai yang mungkin adalah`SSE-S3`,`SSE-KMS`,`DSSE-KMS`,`SSE-C`, atau nol. Untuk informasi selengkapnya, lihat [Melindungi data dengan enkripsi](UsingEncryption.md). |
| `is_bucket_key_enabled` | Tidak | Boolean | Status pengaktifan Kunci Bucket S3 objek. Jika objek menggunakan S3 Bucket Key untuk SSE-KMS, nilai ini adalah. `True` Kalau tidak, itu`False`. Untuk informasi selengkapnya, lihat [Mengonfigurasi Kunci Bucket S3 pada tingkat objek](configuring-bucket-key-object.md). |
| `kms_key_arn` | Tidak | String | Nama Sumber Daya Amazon (ARN) untuk kunci KMS yang dengannya objek dienkripsi, untuk baris di mana atau. `encryption_status` `SSE-KMS` `DSSE-KMS` Jika objek tidak dienkripsi dengan SSE-KMS atau DSSE-KMS, nilainya nol. Untuk informasi selengkapnya, lihat [Menggunakan enkripsi sisi server dengan AWS KMS kunci (SSE-KMS)](UsingKMSEncryption.md) dan [Menggunakan enkripsi sisi server dual-layer dengan kunci (DSSE-KMS) AWS KMS](UsingDSSEncryption.md). Jika baris mewakili versi objek yang tidak lagi ada pada saat peristiwa hapus atau timpa diproses, `kms_key_arn` berisi nilai null, bahkan jika nilai `encryption_status` kolom adalah `SSE-KMS` atau. `DSSE-KMS` |
| `checksum_algorithm` | Tidak | String | Algoritma yang digunakan untuk membuat checksum untuk objek, salah satu dari`CRC64-NVME`,,`CRC32`, `CRC32C``SHA1`, atau`SHA256`. Jika tidak ada checksum hadir, nilai ini adalah null. Untuk informasi selengkapnya, lihat [Menggunakan algoritma checksum yang didukung](checking-object-integrity-upload.md#using-additional-checksums). |
| `object_tags` | Tidak | Peta | Tag objek yang terkait dengan objek. Tag objek disimpan sebagai peta pasangan kunci-nilai. Jika objek tidak memiliki tag objek, peta kosong (`{}`) disimpan. Untuk informasi selengkapnya, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). Jika `record_type` nilainya`DELETE`, `object_tags` kolom berisi nilai null. Jika `record_type` nilainya `CREATE` atau`UPDATE_METADATA`, baris yang mewakili versi objek yang tidak ada lagi pada saat peristiwa hapus atau timpa diproses akan berisi nilai null di `object_tags` kolom. |
| `user_metadata` | Tidak | Peta | Metadata pengguna yang terkait dengan objek. Metadata pengguna disimpan sebagai peta pasangan kunci-nilai. Jika objek tidak memiliki metadata pengguna, peta kosong (`{}`) disimpan. Untuk informasi selengkapnya, lihat [Metadata objek yang ditentukan pengguna](UsingMetadata.md#UserMetadata). Jika `record_type` nilainya`DELETE`, `user_metadata` kolom berisi nilai null. Jika `record_type` nilainya `CREATE` atau`UPDATE_METADATA`, baris yang mewakili versi objek yang tidak ada lagi pada saat peristiwa hapus atau timpa diproses akan berisi nilai null di `user_metadata` kolom. |
# Mengonfigurasi tabel metadata
Amazon S3 Metadata mempercepat penemuan data dengan secara otomatis mencatat metadata untuk objek di bucket tujuan umum Anda dan menyimpannya dalam tabel Apache Iceberg hanya baca dan terkelola penuh yang dapat Anda kueri. Tabel hanya baca ini disebut *tabel metadata*. Saat objek ditambahkan, diperbarui, dan dihapus dari bucket tujuan umum Anda, Metadata S3 secara otomatis menyegarkan tabel metadata yang sesuai untuk menampilkan perubahan terbaru.
Dengan Metadata S3, Anda dapat dengan mudah menemukan, menyimpan, dan mengueri metadata untuk objek S3 Anda, sehingga Anda dapat dengan cepat menyiapkan data untuk digunakan dalam analitik bisnis, pelatihan model kecerdasan buatan dan machine learning (AI/ML), dan banyak lagi.
Untuk membuat dan menyimpan metadata objek dalam tabel metadata AWS terkelola, Anda membuat konfigurasi tabel metadata untuk bucket tujuan umum Anda. Amazon S3 dirancang untuk terus memperbarui tabel metadata untuk menampilkan perubahan terbaru pada data Anda asalkan konfigurasinya aktif pada bucket. Selain itu, Amazon S3 terus mengoptimalkan tabel metadata Anda untuk membantu mengurangi biaya penyimpanan dan meningkatkan performa kueri analitik.
Untuk membuat konfigurasi tabel metadata, pastikan Anda memiliki izin AWS Identity and Access Management (IAM) yang diperlukan untuk membuat dan mengelola tabel metadata.
Untuk memantau pembaruan konfigurasi tabel metadata Anda, Anda dapat menggunakannya. AWS CloudTrail Untuk informasi selengkapnya, lihat [Tindakan tingkat ember Amazon S3 yang dilacak dengan logging CloudTrail](cloudtrail-logging-s3-info.md#cloudtrail-bucket-level-tracking).
**Topics**
+ [
# Menyiapkan izin untuk mengonfigurasi tabel metadata
](metadata-tables-permissions.md)
+ [
# Membuat konfigurasi tabel metadata
](metadata-tables-create-configuration.md)
+ [
# Mengontrol akses ke tabel metadata
](metadata-tables-access-control.md)
+ [
# Catatan tabel jurnal yang kedaluwarsa
](metadata-tables-expire-journal-table-records.md)
+ [
# Mengaktifkan atau menonaktifkan tabel inventaris langsung
](metadata-tables-enable-disable-inventory-tables.md)
+ [
# Melihat konfigurasi tabel metadata
](metadata-tables-view-configuration.md)
+ [
# Menghapus konfigurasi tabel metadata
](metadata-tables-delete-configuration.md)
+ [
# Menghapus tabel metadata
](metadata-tables-delete-table.md)
# Menyiapkan izin untuk mengonfigurasi tabel metadata
Untuk membuat konfigurasi tabel metadata, Anda harus memiliki izin AWS Identity and Access Management (IAM) yang diperlukan untuk membuat dan mengelola konfigurasi tabel metadata Anda dan untuk membuat dan mengelola tabel metadata dan keranjang tabel tempat tabel metadata Anda disimpan.
Untuk membuat dan mengelola konfigurasi tabel metadata Anda, Anda harus memiliki izin berikut:
+ `s3:CreateBucketMetadataTableConfiguration`— Izin ini memungkinkan Anda membuat konfigurasi tabel metadata untuk bucket tujuan umum Anda. Untuk membuat konfigurasi tabel metadata, izin tambahan, termasuk izin Tabel S3, diperlukan, seperti yang dijelaskan di bagian berikut. Untuk ringkasan izin yang diperlukan, lihat[Operasi dan izin bucket](using-with-s3-policy-actions.md#using-with-s3-policy-actions-related-to-buckets).
+ `s3:GetBucketMetadataTableConfiguration`— Izin ini memungkinkan Anda untuk mengambil informasi tentang konfigurasi tabel metadata Anda.
+ `s3:DeleteBucketMetadataTableConfiguration`— Izin ini memungkinkan Anda untuk menghapus konfigurasi tabel metadata Anda.
+ `s3:UpdateBucketMetadataJournalTableConfiguration`— Izin ini memungkinkan Anda untuk memperbarui konfigurasi tabel jurnal Anda untuk kedaluwarsa catatan tabel jurnal.
+ `s3:UpdateBucketMetadataInventoryTableConfiguration`— Izin ini memungkinkan Anda untuk memperbarui konfigurasi tabel inventaris Anda untuk mengaktifkan atau menonaktifkan tabel inventaris. Untuk memperbarui konfigurasi tabel inventaris, izin tambahan, termasuk izin Tabel S3, diperlukan. Untuk daftar izin yang diperlukan, lihat[Operasi dan izin bucket](using-with-s3-policy-actions.md#using-with-s3-policy-actions-related-to-buckets).
**catatan**
`s3:DeleteBucketMetadataTableConfiguration`Izin `s3:CreateBucketMetadataTableConfiguration``s3:GetBucketMetadataTableConfiguration`,, dan digunakan untuk konfigurasi Metadata V1 dan V2 S3. Untuk V2, nama operasi API yang sesuai adalah`CreateBucketMetadataConfiguration`,`GetBucketMetadataConfiguration`, dan`DeleteBucketMetadataConfiguration`.
Untuk membuat dan bekerja dengan tabel dan bucket tabel, Anda harus memiliki `s3tables` izin tertentu. Minimal, untuk membuat konfigurasi tabel metadata, Anda harus memiliki izin berikut: `s3tables`
+ `s3tables:CreateTableBucket`— Izin ini memungkinkan Anda untuk membuat bucket tabel AWS terkelola. Semua konfigurasi tabel metadata di akun Anda dan di Wilayah yang sama disimpan dalam satu keranjang tabel AWS terkelola bernama. `aws-s3` Untuk informasi selengkapnya, lihat [Cara kerja tabel metadata](metadata-tables-overview.md#metadata-tables-how-they-work) dan [Bekerja dengan bucket tabel AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-aws-managed-buckets.html).
+ `s3tables:CreateNamespace`— Izin ini memungkinkan Anda untuk membuat namespace di keranjang meja. Tabel metadata biasanya menggunakan namespace. `b_general_purpose_bucket_name` Untuk informasi selengkapnya tentang ruang nama tabel metadata, lihat. [Cara kerja tabel metadata](metadata-tables-overview.md#metadata-tables-how-they-work)
+ `s3tables:CreateTable`— Izin ini memungkinkan Anda untuk membuat tabel metadata Anda.
+ `s3tables:GetTable`— Izin ini memungkinkan Anda untuk mengambil informasi tentang tabel metadata Anda.
+ `s3tables:PutTablePolicy`— Izin ini memungkinkan Anda untuk menambahkan atau memperbarui kebijakan tabel metadata Anda.
+ `s3tables:PutTableEncryption`— Izin ini memungkinkan Anda untuk mengatur enkripsi sisi server untuk tabel metadata Anda. Izin tambahan diperlukan jika Anda ingin mengenkripsi tabel metadata Anda dengan enkripsi sisi server dengan () kunci (SSE-KMS). AWS Key Management Service AWS KMS Untuk informasi selengkapnya, lihat [Izin untuk SSE-KMS](#metadata-kms-permissions).
+ `kms:DescribeKey`— Izin ini memungkinkan Anda untuk mengambil informasi tentang kunci KMS.
+ `s3tables:PutTableBucketPolicy`— Izin ini memungkinkan Anda untuk membuat atau memperbarui kebijakan keranjang tabel baru.
Untuk informasi mendetail tentang semua izin bucket tabel dan tabel, lihat [Manajemen akses untuk Tabel S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-setting-up.html).
**penting**
Jika Anda juga ingin mengintegrasikan bucket tabel Anda dengan layanan AWS analitik sehingga Anda dapat menanyakan tabel metadata Anda, Anda memerlukan izin tambahan. Untuk informasi selengkapnya, lihat [Mengintegrasikan Tabel Amazon S3 AWS dengan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html) layanan analitik.
**Izin untuk SSE-KMS**
Untuk mengenkripsi tabel metadata Anda dengan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-KMS), Anda harus memiliki izin tambahan.
1. Peran pengguna atau AWS Identity and Access Management (IAM) memerlukan izin berikut. Anda dapat memberikan izin ini dengan menggunakan konsol IAM:. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. `s3tables:PutTableEncryption`untuk mengkonfigurasi enkripsi tabel
1. `kms:DescribeKey`pada AWS KMS kunci yang digunakan
1. Pada kebijakan sumber daya untuk kunci KMS, Anda memerlukan izin berikut. Anda dapat memberikan izin ini dengan menggunakan AWS KMS konsol: [https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms).
1. Berikan `kms:GenerateDataKey` izin untuk `metadata.s3.amazonaws.com` dan`maintenance.s3tables.amazonaws.com`.
1. Berikan `kms:Decrypt` izin untuk `metadata.s3.amazonaws.com` dan`maintenance.s3tables.amazonaws.com`.
1. Berikan `kms:DescribeKey` izin kepada kepala sekolah AWS pemohon.
Selain izin ini, pastikan kunci KMS yang dikelola pelanggan yang digunakan untuk mengenkripsi tabel masih ada, aktif, berada di Wilayah yang sama dengan bucket tujuan umum Anda.
**Contoh kebijakan**
Untuk membuat dan bekerja dengan tabel metadata dan bucket tabel, Anda dapat menggunakan contoh kebijakan berikut. Dalam kebijakan ini, bucket tujuan umum tempat Anda menerapkan konfigurasi tabel metadata disebut sebagai. `amzn-s3-demo-bucket` Untuk menggunakan kebijakan ini, ganti `user input placeholders` dengan informasi Anda sendiri.
Saat Anda membuat konfigurasi tabel metadata, tabel metadata Anda disimpan dalam keranjang tabel terkelola AWS . Semua konfigurasi tabel metadata di akun Anda dan di Wilayah yang sama disimpan dalam satu keranjang tabel AWS terkelola bernama. `aws-s3`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "PermissionsToWorkWithMetadataTables",
"Effect": "Allow",
"Action": [
"s3:CreateBucketMetadataTableConfiguration",
"s3:GetBucketMetadataTableConfiguration",
"s3:DeleteBucketMetadataTableConfiguration",
"s3:UpdateBucketMetadataJournalTableConfiguration",
"s3:UpdateBucketMetadataInventoryTableConfiguration",
"s3tables:*",
"kms:DescribeKey"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3",
"arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3/table/*"
]
}
]
}
```
------
Untuk menanyakan tabel metadata, Anda dapat menggunakan contoh kebijakan berikut. Jika tabel metadata Anda telah dienkripsi dengan SSE-KMS, Anda akan memerlukan izin seperti yang ditunjukkan. `kms:Decrypt` Untuk menggunakan kebijakan ini, ganti `user input placeholders` dengan informasi Anda sendiri.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "PermissionsToQueryMetadataTables",
"Effect": "Allow",
"Action": [
"s3tables:GetTable",
"s3tables:GetTableData",
"s3tables:GetTableMetadataLocation",
"kms:Decrypt"
],
"Resource": [
"arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3",
"arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3/table/*"
]
}
]
}
```
------
# Membuat konfigurasi tabel metadata
Untuk membuat dan menyimpan Metadata Amazon S3 dalam tabel metadata yang dikelola sepenuhnya, Anda membuat Apache Iceberg konfigurasi tabel metadata untuk bucket tujuan umum Anda. Amazon S3 dirancang untuk terus memperbarui tabel metadata untuk menampilkan perubahan terbaru pada data Anda asalkan konfigurasinya aktif pada bucket. Selain itu, Amazon S3 terus mengoptimalkan tabel metadata Anda untuk membantu mengurangi biaya penyimpanan dan meningkatkan performa kueri analitik.
Untuk setiap bucket tujuan umum, Anda dapat membuat satu konfigurasi tabel metadata yang berisi dua tabel metadata pelengkap:
+ **Tabel jurnal** – Secara default, konfigurasi tabel metadata Anda berisi sebuah *tabel jurnal*, yang mencatat peristiwa yang terjadi untuk objek di dalam bucket Anda. Tabel jurnal mencatat perubahan yang dilakukan pada data Anda hampir secara real time, sehingga membantu Anda mengidentifikasi data baru yang diunggah ke bucket Anda, melacak objek yang baru saja dihapus, memantau transisi siklus hidup, dan banyak lagi. Tabel jurnal mencatat objek baru dan pembaruan untuk objek Anda serta metadatanya (pembaruan yang memerlukan operasi `PUT` atau operasi `DELETE`).
Tabel jurnal menangkap metadata hanya untuk peristiwa perubahan (seperti unggahan, pembaruan, dan penghapusan) yang terjadi setelah Anda membuat konfigurasi tabel metadata Anda. Karena tabel ini dapat dikueri, Anda dapat mengaudit perubahan pada bucket Anda melalui kueri SQL sederhana.
Tabel jurnal diperlukan untuk setiap konfigurasi tabel metadata. (Dalam rilis awal S3 Metadata, tabel jurnal disebut "tabel metadata".)
Untuk informasi selengkapnya tentang data apa yang disimpan dalam tabel jurnal, lihat[Skema tabel jurnal Metadata S3](metadata-tables-schema.md).
Untuk membantu meminimalkan biaya penyimpanan, Anda dapat memilih untuk mengaktifkan kedaluwarsa catatan tabel jurnal. Untuk informasi selengkapnya, lihat [Catatan tabel jurnal yang kedaluwarsa](metadata-tables-expire-journal-table-records.md).
+ **Tabel inventaris langsung** – Anda memiliki opsi untuk menambahkan *tabel inventaris langsung* ke konfigurasi tabel metadata Anda. Tabel inventaris langsung menyediakan inventaris sederhana dan dapat dikueri untuk semua objek serta versinya di dalam bucket Anda sehingga Anda dapat menentukan status terbaru data Anda.
Anda dapat menggunakan tabel inventaris langsung untuk menyederhanakan serta mempercepat alur kerja bisnis dan tugas big data dengan mengidentifikasi objek yang ingin Anda proses untuk berbagai beban kerja. Misalnya, Anda dapat mengueri tabel inventaris langsung untuk menemukan semua objek yang disimpan di kelas penyimpanan tertentu, semua objek dengan tanda tertentu, semua objek yang tidak dienkripsi dengan enkripsi di sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS), dan banyak lagi.
Saat Anda mengaktifkan tabel inventaris langsung untuk konfigurasi tabel metadata, tabel akan melalui proses yang dikenal sebagai *penimbunan ulang*, di mana Amazon S3 memindai bucket tujuan umum Anda untuk mengambil metadata awal untuk semua objek yang ada di bucket. Tergantung pada jumlah objek dalam ember Anda, proses ini dapat memakan waktu beberapa menit (minimal 15 menit) hingga jam. **Ketika proses penimbunan ulang selesai, status tabel inventaris langsung Anda berubah dari **Penimbunan** Ulang menjadi Aktif.** Setelah penimbunan ulang selesai, pembaruan objek Anda biasanya tercermin dalam tabel inventaris langsung dalam waktu satu jam.
Anda dikenakan biaya untuk mengisi kembali tabel inventaris langsung Anda. Jika ember tujuan umum Anda memiliki lebih dari satu miliar objek, Anda juga dikenakan biaya bulanan untuk tabel inventaris langsung Anda. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
Untuk informasi selengkapnya tentang data apa yang disimpan dalam tabel inventaris langsung, lihat[Skema tabel inventaris langsung Metadata S3](metadata-tables-inventory-schema.md).
Tabel metadata memiliki format Amazon Resource Name (ARN) berikut, yang menyertakan ID tabel tabel metadata:
`arn:aws:s3tables:region-code:account-id:bucket/aws-s3/table/table-id`
Misalnya, tabel metadata di Wilayah AS Timur (Virginia N.) akan memiliki ARN seperti berikut:
`arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3/table/a12bc345-67d8-912e-3456-7f89123g4h56`
Tabel jurnal memiliki nama`journal`, dan tabel inventaris langsung memiliki nama`inventory`.
Saat Anda membuat konfigurasi tabel metadata, tabel metadata Anda disimpan dalam keranjang tabel terkelola AWS . Semua konfigurasi tabel metadata di akun Anda dan di Wilayah yang sama disimpan dalam satu keranjang tabel AWS terkelola. Bucket tabel AWS terkelola ini diberi nama `aws-s3` dan memiliki format Amazon Resource Name (ARN) berikut:
`arn:aws:s3tables:region:account_id:bucket/aws-s3`
Misalnya, jika ID akun Anda adalah 123456789012 dan bucket tujuan umum Anda berada di US East (Virginia N.) (`us-east-1`), bucket tabel AWS terkelola Anda juga dibuat di US East (Virginia N.) () `us-east-1` dan memiliki ARN berikut:
`arn:aws:s3tables:us-east-1:123456789012:bucket/aws-s3`
Secara default, bucket tabel AWS terkelola dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3). Setelah membuat konfigurasi metadata pertama, Anda dapat mengatur setelan enkripsi default untuk bucket tabel AWS terkelola agar menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-KMS). Untuk informasi selengkapnya, lihat [Enkripsi untuk bucket tabel AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-aws-managed-buckets.html#aws-managed-buckets-encryption) dan[Menentukan enkripsi sisi server dengan AWS KMS kunci (SSE-KMS) di bucket tabel](s3-tables-kms-specify.md).
Dalam bucket tabel AWS terkelola, tabel metadata untuk konfigurasi biasanya disimpan dalam namespace dengan format penamaan berikut:
`b_general-purpose-bucket-name`
Untuk informasi selengkapnya tentang ruang nama tabel metadata, lihat. [Cara kerja tabel metadata](metadata-tables-overview.md#metadata-tables-how-they-work)
Saat membuat konfigurasi tabel metadata, Anda dapat memilih untuk mengenkripsi tabel metadata AWS terkelola dengan enkripsi sisi server menggunakan kunci () (SSE-KMS). AWS Key Management Service AWS KMS Jika Anda memilih untuk menggunakan SSE-KMS, Anda harus menyediakan kunci KMS yang dikelola pelanggan di Wilayah yang sama dengan bucket tujuan umum Anda. Anda dapat mengatur jenis enkripsi untuk tabel Anda hanya selama pembuatan tabel. Setelah tabel yang dikelola AWS dibuat, Anda tidak dapat mengubah pengaturan enkripsinya. Guna menentukan SSE-KMS untuk tabel metadata Anda, Anda harus memiliki izin tertentu. Untuk informasi selengkapnya, lihat [Izin untuk SSE-KMS](metadata-tables-permissions.md#metadata-kms-permissions).
Pengaturan enkripsi untuk tabel metadata lebih diutamakan daripada pengaturan enkripsi tingkat bucket default. Jika Anda tidak menentukan enkripsi untuk tabel, itu akan mewarisi pengaturan enkripsi default dari bucket.
AWS bucket tabel terkelola tidak dihitung dalam kuota Tabel S3 Anda. Untuk informasi selengkapnya tentang bekerja dengan bucket tabel AWS terkelola dan tabel AWS terkelola, lihat [Bekerja dengan bucket tabel AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-aws-managed-buckets.html).
Anda dapat membuat konfigurasi tabel metadata menggunakan konsol Amazon S3,AWS CLI(), API AWS Command Line Interface REST Amazon S3, AWS SDKs atau Amazon S3.
**catatan**
Jika Anda membuat konfigurasi Metadata S3 sebelum 15 Juli 2025, kami sarankan Anda menghapus dan membuat ulang konfigurasi Anda sehingga Anda dapat kedaluwarsa catatan tabel jurnal dan membuat tabel inventaris. Untuk informasi selengkapnya, lihat [Mengaktifkan tabel inventaris pada konfigurasi metadata yang dibuat sebelum 15 Juli 2025](#metadata-tables-migration).
Jika Anda telah menghapus konfigurasi tabel metadata dan ingin membuat ulang konfigurasi untuk bucket tujuan umum yang sama, Anda harus terlebih dahulu menghapus jurnal dan tabel inventaris lama secara manual dari keranjang tabel AWS terkelola. Jika tidak, membuat konfigurasi tabel metadata baru gagal karena tabel tersebut sudah ada. Untuk menghapus tabel metadata Anda, lihat. [Hapus tabel metadata](metadata-tables-delete-table.md#delete-metadata-table-procedure)
Menghapus konfigurasi tabel metadata hanya menghapus konfigurasi. Bucket tabel AWS terkelola dan tabel metadata Anda masih ada, meskipun Anda menghapus konfigurasi tabel metadata.
**Prasyarat**
Sebelum Anda membuat konfigurasi tabel metadata pastikan bahwa Anda telah memenuhi prasyarat berikut:
+ Sebelum Anda membuat konfigurasi tabel metadata, pastikan Anda memiliki izin AWS Identity and Access Management (IAM) yang diperlukan untuk membuat dan mengelola tabel metadata. Untuk informasi selengkapnya, lihat [Menyiapkan izin untuk mengonfigurasi tabel metadata](metadata-tables-permissions.md).
+ Jika Anda berencana untuk menanyakan tabel metadata Anda dengan Amazon Athena atau mesin kueri AWS lain, pastikan AWS Anda mengintegrasikan bucket AWS tabel terkelola dengan layanan analitik. Untuk informasi selengkapnya, lihat [Mengintegrasikan Tabel AWS Amazon S3 dengan layanan analitik](s3-tables-integrating-aws.md).
Jika Anda telah mengintegrasikan bucket tabel yang ada di Wilayah ini, bucket tabel AWS terkelola Anda juga terintegrasi secara otomatis. Untuk menentukan status integrasi bucket tabel di Wilayah ini, buka konsol Amazon S3, lalu **pilih Bucket tabel** di panel navigasi kiri. Di bawah **Integrasi dengan layanan AWS analitik**, periksa Wilayah dan apakah status integrasi mengatakan **Diaktifkan**.
## Buat konfigurasi tabel metadata
### Menggunakan konsol S3
**Untuk membuat konfigurasi tabel metadata**
Sebelum Anda membuat konfigurasi tabel metadata, pastikan bahwa Anda telah meninjau dan memenuhi [prasyarat](#metadata-table-config-prereqs) dan bahwa Anda telah meninjau. [Batasan dan batasan tabel metadata](metadata-tables-restrictions.md)
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Pilih bucket tujuan umum yang Anda inginkan untuk membuat konfigurasi tabel metadata.
**catatan**
Pastikan ember tujuan umum ini adalah Wilayah AWS tempat ember meja tersedia. Bucket meja hanya tersedia di Wilayah AS Timur (Virginia N.), AS Timur (Ohio), dan AS Barat (Oregon).
1. Pada halaman detail bucket, pilih tab **Metadata**.
1. Pada tab **Metadata**, pilih **Buat konfigurasi metadata**.
1. Pada halaman **Buat konfigurasi metadata**, di bawah **tabel Jurnal**, Anda dapat memilih apakah akan mengenkripsi tabel Anda dengan enkripsi sisi server menggunakan AWS Key Management Service () kunci (AWS KMS SSE-KMS). Secara default, tabel jurnal dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3).
Jika Anda memilih untuk menggunakan SSE-KMS, Anda harus menyediakan kunci KMS yang dikelola pelanggan di Wilayah yang sama dengan bucket tujuan umum Anda.
**penting**
Anda hanya dapat menetapkan jenis enkripsi untuk tabel metadata Anda selama pembuatan tabel. Setelah tabel AWS terkelola dibuat, Anda tidak dapat mengubah pengaturan enkripsi.
+ Untuk mengenkripsi tabel jurnal Anda dengan SSE-S3 (default), pilih **Jangan** tentukan jenis enkripsi.
+ **Untuk mengenkripsi tabel jurnal Anda dengan SSE-KMS, pilih Tentukan jenis enkripsi.** Di bawah **Jenis enkripsi**, pilih **Enkripsi sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS)**. Di bawah **AWS KMS kunci**, pilih dari kunci KMS yang ada, atau masukkan ARN kunci KMS Anda. Jika Anda belum memiliki kunci KMS, pilih **Masukkan KMS kunci ARN**, lalu pilih **Buat** kunci KMS.
Pastikan Anda telah menyiapkan izin yang diperlukan untuk SSE-KMS. Untuk informasi selengkapnya, lihat [Izin untuk SSE-KMS](metadata-tables-permissions.md#metadata-kms-permissions).
1. (Opsional) Secara default, catatan dalam tabel jurnal Anda tidak kedaluwarsa. Untuk membantu meminimalkan biaya penyimpanan untuk tabel jurnal Anda, pilih **Diaktifkan** untuk **Rekam kedaluwarsa**.
Jika Anda mengaktifkan kedaluwarsa catatan tabel jurnal, Anda dapat mengatur jumlah hari untuk menyimpan catatan tabel jurnal Anda. Untuk mengatur nilai **Hari setelah catatan kedaluwarsa**, Anda dapat menentukan bilangan bulat antara `7` dan`2147483647`. Misalnya, untuk menyimpan catatan tabel jurnal Anda selama satu tahun, tetapkan nilai ini`365`.
Catatan akan kedaluwarsa dalam waktu 24 hingga 48 jam setelah memenuhi syarat untuk kedaluwarsa.
**penting**
Setelah catatan tabel jurnal kedaluwarsa, mereka tidak dapat dipulihkan.
Di bawah **Catatan tabel jurnal akan kedaluwarsa setelah jumlah hari yang ditentukan**, pilih kotak centang.
1. (Opsional) Jika Anda ingin menambahkan tabel inventaris ke konfigurasi tabel metadata Anda, di bawah **tabel inventaris langsung**, pilih **Diaktifkan untuk status** **Konfigurasi**.
Anda dapat memilih apakah akan mengenkripsi tabel Anda dengan enkripsi sisi server menggunakan AWS Key Management Service (AWS KMS) kunci (SSE-KMS). Secara default, tabel inventaris dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3).
Jika Anda memilih untuk menggunakan SSE-KMS, Anda harus menyediakan kunci KMS yang dikelola pelanggan di Wilayah yang sama dengan bucket tujuan umum Anda.
**penting**
Anda hanya dapat menetapkan jenis enkripsi untuk tabel metadata Anda selama pembuatan tabel. Setelah tabel AWS terkelola dibuat, Anda tidak dapat mengubah pengaturan enkripsi.
+ Untuk mengenkripsi tabel inventaris Anda dengan SSE-S3 (default), pilih **Jangan** tentukan jenis enkripsi.
+ **Untuk mengenkripsi tabel inventaris Anda dengan SSE-KMS, pilih Tentukan jenis enkripsi.** Di bawah **Jenis enkripsi**, pilih **Enkripsi sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS)**. Di bawah **AWS KMS kunci**, pilih dari kunci KMS yang ada, atau masukkan ARN kunci KMS Anda. Jika Anda belum memiliki kunci KMS, pilih **Masukkan KMS kunci ARN**, lalu pilih **Buat** kunci KMS.
Pastikan Anda telah menyiapkan izin yang diperlukan untuk SSE-KMS. Untuk informasi selengkapnya, lihat [Izin untuk SSE-KMS](metadata-tables-permissions.md#metadata-kms-permissions).
1. Pilih **Buat konfigurasi tabel metadata**.
Jika konfigurasi tabel metadata berhasil, nama dan ARNs tabel metadata akan ditampilkan di tab Metadata, bersama dengan nama **bucket** tabel terkelola dan namespace. AWS
Jika Anda memilih untuk mengaktifkan tabel inventaris untuk konfigurasi tabel metadata, tabel akan melalui proses yang dikenal sebagai *penimbunan ulang*, di mana Amazon S3 memindai bucket tujuan umum Anda untuk mengambil metadata awal untuk semua objek yang ada di bucket. Tergantung pada jumlah objek dalam ember Anda, proses ini dapat memakan waktu beberapa menit (minimal 15 menit) hingga jam. **Ketika proses penimbunan ulang selesai, status tabel inventaris Anda berubah dari **Penimbunan** Ulang menjadi Aktif.** Setelah penimbunan ulang selesai, pembaruan objek Anda biasanya tercermin dalam tabel inventaris dalam waktu satu jam.
Untuk memantau pembaruan konfigurasi tabel metadata Anda, Anda dapat menggunakannya. AWS CloudTrail Untuk informasi selengkapnya, lihat [Tindakan tingkat ember Amazon S3 yang dilacak dengan logging CloudTrail](cloudtrail-logging-s3-info.md#cloudtrail-bucket-level-tracking).
### Menggunakan AWS CLI
Untuk menjalankan perintah berikut, Anda harus AWS CLI menginstal dan mengkonfigurasi. Jika Anda belum menginstal, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
Atau, Anda dapat menjalankan AWS CLI perintah dari konsol dengan menggunakan AWS CloudShell. AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS Untuk informasi lebih lanjut, lihat [Apa itu CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) dan [Memulai dengan AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html) di *Panduan AWS CloudShell Pengguna*.
**Untuk membuat konfigurasi tabel metadata dengan menggunakan AWS CLI**
Sebelum Anda membuat konfigurasi tabel metadata, pastikan bahwa Anda telah meninjau dan memenuhi [prasyarat](#metadata-table-config-prereqs) dan bahwa Anda telah meninjau. [Batasan dan batasan tabel metadata](metadata-tables-restrictions.md)
Untuk menggunakan perintah contoh berikut, ganti `user input placeholders` dengan informasi Anda sendiri.
1. Buat file JSON yang berisi konfigurasi tabel metadata Anda, dan simpan (misalnya,). `metadata-config.json` Berikut ini adalah konfigurasi sampel.
Anda harus menentukan apakah akan mengaktifkan atau menonaktifkan kedaluwarsa catatan tabel jurnal. Jika Anda memilih untuk mengaktifkan kedaluwarsa rekaman, Anda juga harus menentukan jumlah hari setelah catatan tabel jurnal Anda akan kedaluwarsa. Untuk mengatur `Days` nilai, Anda dapat menentukan bilangan bulat antara `7` dan`2147483647`. Misalnya, untuk menyimpan catatan tabel jurnal Anda selama satu tahun, tetapkan nilai ini`365`.
Anda dapat memilih untuk mengonfigurasi tabel inventaris secara opsional.
Untuk tabel jurnal dan tabel inventaris, Anda dapat menentukan konfigurasi enkripsi secara opsional. Secara default, tabel metadata dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3), yang dapat Anda tentukan dengan menyetelnya. `SseAlgorithm` `AES256`
Untuk mengenkripsi tabel metadata Anda dengan enkripsi sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS), atur ke. `SseAlgorithm` `aws:kms` Anda juga harus menyetel `KmsKeyArn` ke ARN kunci KMS yang dikelola pelanggan di Wilayah yang sama di mana bucket tujuan umum Anda berada.
```
{
"JournalTableConfiguration": {
"RecordExpiration": {
"Expiration": "ENABLED",
"Days": 10
},
"EncryptionConfiguration": {
"SseAlgorithm": "AES256"
}
},
"InventoryTableConfiguration": {
"ConfigurationState": "ENABLED",
"EncryptionConfiguration": {
"SseAlgorithm": "aws:kms",
"KmsKeyArn": "arn:aws:kms:us-east-2:account-id:key/key-id"
}
}
}
```
1. Gunakan perintah berikut untuk menerapkan konfigurasi tabel metadata ke bucket tujuan umum Anda (misalnya,`amzn-s3-demo-bucket`):
```
aws s3api create-bucket-metadata-configuration \
--bucket amzn-s3-demo-bucket \
--metadata-configuration file://./metadata-config.json \
--region us-east-2
```
1. Untuk memverifikasi bahwa konfigurasi telah dibuat, gunakan perintah berikut:
```
aws s3api get-bucket-metadata-configuration \
--bucket amzn-s3-demo-bucket \
--region us-east-2
```
Untuk memantau pembaruan konfigurasi tabel metadata Anda, Anda dapat menggunakannya. AWS CloudTrail Untuk informasi selengkapnya, lihat [Tindakan tingkat ember Amazon S3 yang dilacak dengan logging CloudTrail](cloudtrail-logging-s3-info.md#cloudtrail-bucket-level-tracking).
### Penggunaan API REST
Anda dapat mengirim permintaan REST untuk membuat konfigurasi tabel metadata. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com//AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html](https://docs.aws.amazon.com//AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html) di *Referensi API Amazon S3*.
### Menggunakan AWS SDKs
Anda dapat menggunakan AWS SDKs untuk membuat konfigurasi tabel metadata di Amazon S3. Untuk selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com//AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html#API_CreateBucketMetadataConfiguration_SeeAlso) di Referensi *API Amazon S3*.
## Mengaktifkan tabel inventaris pada konfigurasi metadata yang dibuat sebelum 15 Juli 2025
Jika Anda membuat konfigurasi Metadata S3 sebelum 15 Juli 2025, kami sarankan Anda menghapus dan membuat ulang konfigurasi Anda sehingga Anda dapat kedaluwarsa catatan tabel jurnal dan membuat tabel inventaris. Setiap perubahan pada bucket tujuan umum Anda yang terjadi antara menghapus konfigurasi lama dan membuat yang baru tidak dicatat di salah satu tabel jurnal Anda.
Untuk bermigrasi dari konfigurasi metadata lama ke konfigurasi baru, lakukan hal berikut:
1. Hapus konfigurasi tabel metadata yang ada. Untuk step-by-step instruksi, lihat[Menghapus konfigurasi tabel metadata](metadata-tables-delete-configuration.md).
1. Buat konfigurasi tabel metadata baru. Untuk step-by-step instruksi, lihat[Membuat konfigurasi tabel metadata](#metadata-tables-create-configuration).
Jika Anda memerlukan bantuan untuk memigrasi konfigurasi Anda, hubungi AWS Dukungan.
Setelah Anda membuat konfigurasi metadata baru Anda, Anda akan memiliki dua tabel jurnal. Jika Anda tidak lagi membutuhkan tabel jurnal lama, Anda dapat menghapusnya. Untuk step-by-step instruksi, lihat[Menghapus tabel metadata](metadata-tables-delete-table.md). Jika Anda telah mempertahankan tabel jurnal lama Anda dan ingin bergabung dengan yang baru, lihat [Menggabungkan metadata kustom dengan tabel metadata S3](metadata-tables-join-custom-metadata.md) contoh cara menggabungkan dua tabel.
Setelah migrasi, Anda dapat melakukan hal berikut:
1. Untuk melihat konfigurasi Anda, Anda sekarang dapat menggunakan operasi `GetBucketMetadataConfiguration` API. Untuk menentukan apakah konfigurasi Anda sudah lama atau baru, Anda dapat melihat atribut respons `GetBucketMetadataConfiguration` API berikut. Tipe bucket AWS terkelola (`"aws"`) menunjukkan konfigurasi baru, dan tipe bucket yang dikelola pelanggan (`"customer"`) menunjukkan konfigurasi lama.
```
"MetadataTableConfigurationResult": {
"TableBucketType": ["aws" | "customer"]
```
Untuk informasi selengkapnya, lihat [Melihat konfigurasi tabel metadata](metadata-tables-view-configuration.md).
**catatan**
Anda dapat menggunakan operasi `GetBucketMetadataConfiguration` dan `DeleteBucketMetadataConfiguration` API dengan konfigurasi tabel metadata lama atau baru. Namun, jika Anda mencoba menggunakan operasi `DeleteBucketMetadataTableConfiguration` API `GetBucketMetadataTableConfiguration` dan dengan konfigurasi baru, Anda akan menerima `405 Method Not Allowed` kesalahan HTTP.
Pastikan Anda memperbarui proses untuk menggunakan operasi API baru (`CreateBucketMetadataConfiguration`,`GetBucketMetadataConfiguration`, dan`DeleteBucketMetadataConfiguration`) alih-alih operasi API lama.
1. Jika Anda berencana untuk menanyakan tabel metadata Anda dengan Amazon Athena atau mesin kueri AWS lain, pastikan AWS Anda mengintegrasikan bucket AWS tabel terkelola dengan layanan analitik. Jika Anda telah mengintegrasikan bucket tabel yang ada di Wilayah ini, bucket tabel AWS terkelola Anda juga terintegrasi secara otomatis. Untuk informasi selengkapnya, lihat [Mengintegrasikan Tabel AWS Amazon S3 dengan layanan analitik](s3-tables-integrating-aws.md).
# Mengontrol akses ke tabel metadata
Untuk mengontrol akses ke tabel metadata Amazon S3, Anda dapat menggunakan kebijakan berbasis sumber daya AWS Identity and Access Management (IAM) yang dilampirkan ke keranjang tabel dan tabel metadata Anda. Dengan kata lain, Anda dapat mengontrol akses ke tabel metadata Anda di tingkat bucket tabel dan tingkat tabel.
Untuk informasi selengkapnya tentang mengontrol akses ke bucket dan tabel tabel, lihat [Manajemen akses untuk Tabel S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-setting-up.html).
**penting**
Saat membuat atau memperbarui kebijakan bucket atau tabel tabel, pastikan Anda tidak membatasi `metadata.s3.amazonaws.com` prinsip layanan Amazon S3 `maintenance.s3tables.amazonaws.com` dan dari menulis ke keranjang meja atau tabel metadata Anda.
Jika Amazon S3 tidak dapat menulis ke keranjang tabel atau tabel metadata, Anda harus menghapus konfigurasi metadata, menghapus tabel metadata, dan kemudian membuat konfigurasi baru. Jika Anda memiliki tabel inventaris dalam konfigurasi Anda, tabel inventaris baru harus dibuat, dan Anda akan dikenakan biaya lagi untuk mengisi kembali tabel inventaris baru.
Anda juga dapat mengontrol akses ke baris dan kolom dalam tabel metadata Anda. AWS Lake Formation*Untuk informasi selengkapnya, lihat [Mengelola izin Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) dan [Pemfilteran data serta keamanan tingkat sel di Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) di Panduan Pengembang.AWS Lake Formation *
# Catatan tabel jurnal yang kedaluwarsa
Secara default, catatan dalam tabel jurnal Anda tidak kedaluwarsa. Untuk membantu meminimalkan biaya penyimpanan untuk tabel jurnal Anda, Anda dapat mengaktifkan kedaluwarsa catatan tabel jurnal.
**catatan**
Jika Anda membuat konfigurasi Metadata S3 sebelum 15 Juli 2025, Anda tidak dapat mengaktifkan kedaluwarsa catatan tabel jurnal pada konfigurasi itu. Kami menyarankan Anda menghapus dan membuat ulang konfigurasi Anda sehingga Anda dapat kedaluwarsa catatan tabel jurnal dan membuat tabel inventaris. Untuk informasi selengkapnya, lihat [Mengaktifkan tabel inventaris pada konfigurasi metadata yang dibuat sebelum 15 Juli 2025](metadata-tables-create-configuration.md#metadata-tables-migration).
Jika Anda mengaktifkan kedaluwarsa catatan tabel jurnal, Anda dapat mengatur jumlah hari untuk menyimpan catatan tabel jurnal Anda. Untuk mengatur nilai ini, tentukan bilangan bulat antara `7` dan`2147483647`. Misalnya, untuk menyimpan catatan tabel jurnal Anda selama satu tahun, tetapkan nilai ini`365`.
**penting**
Setelah catatan tabel jurnal kedaluwarsa, mereka tidak dapat dipulihkan.
Catatan kedaluwarsa dalam waktu 24 hingga 48 jam setelah memenuhi syarat untuk kedaluwarsa. Catatan jurnal dihapus dari snapshot terbaru. Data dan penyimpanan untuk catatan yang dihapus dihapus melalui operasi pemeliharaan tabel.
Jika Anda telah mengaktifkan kedaluwarsa catatan tabel jurnal, Anda dapat menonaktifkannya kapan saja untuk berhenti kedaluwarsa catatan tabel jurnal Anda.
Anda dapat kedaluwarsa catatan tabel jurnal dengan menggunakan konsol Amazon S3,AWS CLI(), AWS Command Line Interface AWS SDKs the, atau Amazon S3 REST API.
## Cara kedaluwarsa catatan tabel jurnal
### Menggunakan konsol S3
**Untuk kedaluwarsa catatan tabel jurnal**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Pilih bucket tujuan umum yang berisi konfigurasi tabel metadata dengan tabel jurnal tempat Anda ingin kedaluwarsa catatan.
1. Pada halaman detail bucket, pilih tab **Metadata**.
1. Pada tab **Metadata**, pilih **Edit, lalu pilih Edit** **catatan tabel jurnal kedaluwarsa**.
1. Pada halaman **Edit catatan tabel jurnal kedaluwarsa**, pilih **Diaktifkan** di bawah **Rekam** kedaluwarsa.
1. Tetapkan jumlah hari untuk menyimpan catatan tabel jurnal Anda. Untuk mengatur nilai **Hari setelah catatan kedaluwarsa**, tentukan bilangan bulat antara `7` dan`2147483647`. Misalnya, untuk menyimpan catatan tabel jurnal Anda selama satu tahun, tetapkan nilai ini`365`.
**penting**
Setelah catatan tabel jurnal kedaluwarsa, mereka tidak dapat dipulihkan.
1. Di bawah **Catatan tabel jurnal akan kedaluwarsa setelah jumlah hari yang ditentukan**, pilih kotak centang.
1. Pilih **Simpan perubahan**.
**Jika Anda ingin menonaktifkan kedaluwarsa catatan tabel jurnal, ulangi langkah sebelumnya, tetapi pilih **Dinonaktifkan alih-alih Diaktifkan** untuk langkah 6.**
### Menggunakan AWS CLI
Untuk menjalankan perintah berikut, Anda harus AWS CLI menginstal dan mengkonfigurasi. Jika Anda belum menginstal, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
Anda juga dapat menjalankan AWS CLI perintah dari konsol dengan menggunakan AWS CloudShell. AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS Untuk informasi lebih lanjut, lihat [Apa itu CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) dan [Memulai dengan AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html) di *Panduan AWS CloudShell Pengguna*.
**Untuk kedaluwarsa catatan tabel jurnal dengan menggunakan AWS CLI**
Untuk menggunakan perintah contoh berikut, ganti `user input placeholders` dengan informasi Anda sendiri.
1. Buat file JSON yang berisi konfigurasi tabel jurnal Anda, dan simpan (misalnya,`journal-config.json`). Berikut ini adalah konfigurasi sampel.
Untuk mengatur `Days` nilai, tentukan bilangan bulat antara `7` dan`2147483647`. Misalnya, untuk menyimpan catatan tabel jurnal Anda selama satu tahun, tetapkan nilai ini`365`.
```
{
"RecordExpiration": {
"Expiration": "ENABLED",
"Days": 10
}
}
```
Untuk menonaktifkan kedaluwarsa catatan tabel jurnal, buat konfigurasi sampel berikut sebagai gantinya. Jika `Expiration` diatur ke`DISABLED`, Anda tidak harus menentukan `Days` nilai dalam konfigurasi.
```
{
"RecordExpiration": {
"Expiration": "DISABLED"
}
}
```
1. Gunakan perintah berikut untuk menghapus catatan dari tabel jurnal di bucket tujuan umum Anda (misalnya,`amzn-s3-demo-bucket`):
```
aws s3api update-bucket-metadata-journal-table-configuration \
--bucket amzn-s3-demo-bucket \
--journal-table-configuration file://./journal-config.json \
--region us-east-2
```
### Penggunaan API REST
Anda dapat mengirim permintaan REST untuk kedaluwarsa catatan tabel jurnal. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html).
### Menggunakan AWS SDKs
Anda dapat menggunakan catatan tabel jurnal AWS SDKs untuk kedaluwarsa di Amazon S3. Untuk selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html#API_UpdateBucketMetadataJournalTableConfiguration_SeeAlso).
# Mengaktifkan atau menonaktifkan tabel inventaris langsung
Secara default, konfigurasi tabel metadata Anda berisi *tabel jurnal*, yang mencatat peristiwa yang terjadi untuk objek di bucket Anda. Tabel jurnal diperlukan untuk setiap konfigurasi tabel metadata.
Secara opsional, Anda dapat menambahkan *tabel inventaris langsung ke konfigurasi tabel* metadata Anda. Tabel inventaris langsung menyediakan inventaris sederhana dan dapat dikueri untuk semua objek serta versinya di dalam bucket Anda sehingga Anda dapat menentukan status terbaru data Anda.
**catatan**
Jika Anda membuat konfigurasi Metadata S3 sebelum 15 Juli 2025, Anda tidak dapat mengaktifkan tabel inventaris pada konfigurasi itu. Kami menyarankan Anda menghapus dan membuat ulang konfigurasi Anda sehingga Anda dapat membuat tabel inventaris dan kedaluwarsa catatan tabel jurnal. Untuk informasi selengkapnya, lihat [Mengaktifkan tabel inventaris pada konfigurasi metadata yang dibuat sebelum 15 Juli 2025](metadata-tables-create-configuration.md#metadata-tables-migration).
Tabel inventaris berisi metadata terbaru untuk semua objek di bucket Anda. Anda dapat menggunakan tabel ini untuk menyederhanakan dan mempercepat alur kerja bisnis dan pekerjaan data besar dengan mengidentifikasi objek yang ingin Anda proses untuk berbagai beban kerja. Misalnya, Anda dapat menanyakan tabel inventaris untuk melakukan hal berikut:
+ Temukan semua objek yang disimpan di kelas penyimpanan S3 Glacier Deep Archive.
+ Buat distribusi tag objek atau temukan objek tanpa tag.
+ Temukan semua objek yang tidak dienkripsi dengan menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-KMS).
+ Bandingkan tabel inventaris Anda di dua titik waktu yang berbeda untuk memahami pertumbuhan objek dengan tag tertentu.
Jika Anda memilih untuk mengaktifkan tabel inventaris untuk konfigurasi tabel metadata, tabel akan melalui proses yang dikenal sebagai *penimbunan ulang*, di mana Amazon S3 memindai bucket tujuan umum Anda untuk mengambil metadata awal untuk semua objek yang ada di bucket. Tergantung pada jumlah objek dalam ember Anda, proses ini dapat memakan waktu beberapa menit (minimal 15 menit) hingga jam. **Ketika proses penimbunan ulang selesai, status tabel inventaris Anda berubah dari **Penimbunan** Ulang menjadi Aktif.** Setelah penimbunan ulang selesai, pembaruan objek Anda biasanya tercermin dalam tabel inventaris dalam waktu satu jam.
**catatan**
Anda dikenakan biaya untuk mengisi kembali tabel inventaris Anda. Jika ember tujuan umum Anda memiliki lebih dari satu miliar objek, Anda juga dikenakan biaya bulanan untuk tabel inventaris Anda. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
Anda tidak dapat menjeda pembaruan ke tabel inventaris Anda dan kemudian melanjutkannya. Namun, Anda dapat menonaktifkan konfigurasi tabel inventaris. Menonaktifkan tabel inventaris tidak menghapusnya. Tabel inventaris disimpan untuk catatan Anda sampai Anda memutuskan untuk menghapusnya.
Jika Anda telah menonaktifkan tabel inventaris dan kemudian ingin mengaktifkannya kembali, Anda harus terlebih dahulu menghapus tabel inventaris lama dari keranjang tabel AWS terkelola Anda. Saat Anda mengaktifkan kembali konfigurasi tabel inventaris, Amazon S3 membuat tabel inventaris baru, dan Anda dikenakan biaya lagi untuk mengisi ulang tabel inventaris baru.
Anda dapat mengaktifkan atau menonaktifkan tabel inventaris menggunakan konsol Amazon S3, AWS Command Line Interface (AWS CLI), the AWS SDKs, atau Amazon S3 REST API.
**Prasyarat**
Jika Anda telah menonaktifkan tabel inventaris dan sekarang ingin mengaktifkannya kembali, Anda harus terlebih dahulu menghapus tabel inventaris lama secara manual dari keranjang tabel AWS terkelola Anda. Jika tidak, mengaktifkan kembali tabel inventaris gagal karena tabel inventaris sudah ada di keranjang tabel. Untuk menghapus tabel inventaris Anda, lihat[Hapus tabel metadata](metadata-tables-delete-table.md#delete-metadata-table-procedure).
Saat Anda mengaktifkan kembali konfigurasi tabel inventaris, Amazon S3 membuat tabel inventaris baru, dan Anda dikenakan biaya lagi untuk mengisi ulang tabel inventaris baru.
## Mengaktifkan atau menonaktifkan tabel inventaris
### Menggunakan konsol S3
**Untuk mengaktifkan atau menonaktifkan tabel inventaris**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Pilih bucket tujuan umum dengan konfigurasi tabel metadata yang ingin Anda aktifkan atau nonaktifkan tabel inventaris.
1. Pada halaman detail bucket, pilih tab **Metadata**.
1. Pada tab **Metadata**, pilih **Edit, lalu pilih Edit** **konfigurasi tabel inventaris**.
1. Pada halaman **konfigurasi Edit tabel inventaris**, pilih **Diaktifkan** **atau Dinonaktifkan** di bawah **tabel Inventaris**.
**catatan**
Sebelum Anda memilih **Diaktifkan**, pastikan Anda telah meninjau dan memenuhi [prasyarat](#inventory-table-config-prereqs).
+ Jika Anda memilih **Diaktifkan**, Anda dapat memilih apakah akan mengenkripsi tabel Anda dengan enkripsi sisi server menggunakan AWS Key Management Service (AWS KMS) kunci (SSE-KMS). Secara default, tabel inventaris dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3).
Jika Anda memilih untuk menggunakan SSE-KMS, Anda harus menyediakan kunci KMS yang dikelola pelanggan di Wilayah yang sama dengan bucket tujuan umum Anda.
**penting**
Anda hanya dapat menetapkan jenis enkripsi untuk tabel metadata Anda selama pembuatan tabel. Setelah tabel AWS terkelola dibuat, Anda tidak dapat mengubah pengaturan enkripsi.
+ Untuk mengenkripsi tabel inventaris Anda dengan SSE-S3 (default), pilih **Jangan** tentukan jenis enkripsi.
+ **Untuk mengenkripsi tabel inventaris Anda dengan SSE-KMS, pilih Tentukan jenis enkripsi.** Di bawah **Jenis enkripsi**, pilih **Enkripsi sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS)**. Di bawah **AWS KMS kunci**, pilih dari kunci KMS yang ada, atau masukkan ARN kunci KMS Anda. Jika Anda belum memiliki kunci KMS, pilih **Masukkan KMS kunci ARN**, lalu pilih **Buat** kunci KMS.
+ Jika Anda memilih **Dinonaktifkan**, di bawah **Setelah tabel inventaris dinonaktifkan, tabel tidak akan diperbarui lagi, dan pembaruan tidak dapat dilanjutkan**, pilih kotak centang.
1. Pilih **Simpan perubahan**.
### Menggunakan AWS CLI
Untuk menjalankan perintah berikut, Anda harus AWS CLI menginstal dan mengkonfigurasi. Jika Anda belum menginstal, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
Atau, Anda dapat menjalankan AWS CLI perintah dari konsol dengan menggunakan AWS CloudShell. AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS Untuk informasi lebih lanjut, lihat [Apa itu CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) dan [Memulai dengan AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html) di *Panduan AWS CloudShell Pengguna*.
**Untuk mengaktifkan atau menonaktifkan tabel inventaris dengan menggunakan AWS CLI**
Untuk menggunakan perintah contoh berikut, ganti `user input placeholders` dengan informasi Anda sendiri.
**catatan**
Sebelum mengaktifkan konfigurasi inventaris, pastikan Anda telah meninjau dan memenuhi [prasyarat](#inventory-table-config-prereqs).
1. Buat file JSON yang berisi konfigurasi tabel inventaris Anda, dan simpan (misalnya,`inventory-config.json`). Berikut ini adalah konfigurasi sampel untuk mengaktifkan tabel inventaris baru.
Jika Anda mengaktifkan tabel inventaris, Anda dapat menentukan konfigurasi enkripsi secara opsional. Secara default, tabel metadata dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3), yang dapat Anda tentukan dengan menyetelnya. `SseAlgorithm` `AES256`
Untuk mengenkripsi tabel inventaris Anda dengan enkripsi sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS), atur ke. `SseAlgorithm` `aws:kms` Anda juga harus menyetel `KmsKeyArn` ke ARN kunci KMS yang dikelola pelanggan di Wilayah yang sama di mana bucket tujuan umum Anda berada.
```
{
"ConfigurationState": "ENABLED",
"EncryptionConfiguration": {
"SseAlgorithm": "aws:kms",
"KmsKeyArn": "arn:aws:kms:us-east-2:account-id:key/key-id"
}
}
```
Jika Anda ingin menonaktifkan tabel inventaris yang ada, gunakan konfigurasi berikut:
```
{
"ConfigurationState": "DISABLED" }
}
```
1. Gunakan perintah berikut untuk memperbarui konfigurasi tabel inventaris untuk bucket tujuan umum Anda (misalnya,`amzn-s3-demo-bucket`):
```
aws s3api update-bucket-metadata-inventory-table-configuration \
--bucket amzn-s3-demo-source-bucket \
--inventory-table-configuration file://./inventory-config.json \
--region us-east-2
```
### Penggunaan API REST
Anda dapat mengirim permintaan REST untuk mengaktifkan atau menonaktifkan tabel inventaris. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html).
### Menggunakan AWS SDKs
Anda dapat menggunakan AWS SDKs untuk mengaktifkan atau menonaktifkan tabel inventaris di Amazon S3. Untuk selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html#API_UpdateBucketMetadataInventoryTableConfiguration_SeeAlso).
# Melihat konfigurasi tabel metadata
Jika Anda telah membuat konfigurasi tabel metadata untuk bucket tujuan umum, Anda dapat melihat informasi tentang konfigurasi, seperti apakah tabel inventaris telah diaktifkan, atau apakah kedaluwarsa catatan tabel jurnal telah diaktifkan. Anda juga dapat melihat status jurnal dan tabel inventaris Anda.
Anda dapat melihat konfigurasi tabel metadata untuk bucket tujuan umum menggunakan konsol Amazon S3,AWS CLI(), AWS Command Line Interface the, atau Amazon S3 REST API. AWS SDKs
## Melihat konfigurasi tabel metadata
### Menggunakan konsol S3
**Untuk melihat konfigurasi tabel metadata**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Pilih bucket tujuan umum yang berisi konfigurasi tabel metadata yang ingin Anda lihat.
1. Pada halaman detail bucket, pilih tab **Metadata**.
1. Pada tab **Metadata**, gulir ke bawah ke bagian konfigurasi **Metadata**. Di bagian **tabel Jurnal** dan **tabel Inventaris**, Anda dapat melihat berbagai informasi untuk konfigurasi ini, seperti Nama Sumber Daya Amazon (ARNs), status tabel Anda, dan apakah Anda telah mengaktifkan kedaluwarsa catatan tabel jurnal atau tabel inventaris.
### Menggunakan AWS CLI
Untuk menjalankan perintah berikut, Anda harus AWS CLI menginstal dan mengkonfigurasi. Jika Anda belum menginstal, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
Atau, Anda dapat menjalankan AWS CLI perintah dari konsol dengan menggunakan AWS CloudShell. AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS Untuk informasi lebih lanjut, lihat [Apa itu CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) dan [Memulai dengan AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html) di *Panduan AWS CloudShell Pengguna*.
**Untuk melihat konfigurasi tabel metadata dengan menggunakan AWS CLI**
Untuk menggunakan perintah contoh berikut, ganti `user input placeholders` dengan informasi Anda sendiri.
1. Gunakan perintah berikut untuk melihat konfigurasi tabel metadata untuk bucket tujuan umum Anda (misalnya,`amzn-s3-demo-bucket`):
```
aws s3api get-bucket-metadata-configuration \
--bucket amzn-s3-demo-bucket \
--region us-east-2
```
1. Lihat output dari perintah ini untuk melihat status konfigurasi tabel metadata Anda. Contoh:
```
{
"GetBucketMetadataConfigurationResult": {
"MetadataConfigurationResult": {
"DestinationResult": {
"TableBucketType": "aws",
"TableBucketArn": "arn:aws:s3tables:us-east-2:111122223333:bucket/aws-managed-s3-111122223333-us-east-2",
"TableNamespace": "b_general-purpose-bucket-name"
},
"JournalTableConfigurationResult": {
"TableStatus": "ACTIVE",
"TableName": "journal",
"TableArn": "arn:aws:s3tables:us-east-2:111122223333:bucket/aws-managed-s3-111122223333-us-east-2/table/0f01234c-fe7a-492f-a4c7-adec3864ea85",
"EncryptionConfiguration": {
"SseAlgorithm": "AES256"
},
"RecordExpiration": {
"Expiration": "ENABLED",
"Days": 10
}
},
"InventoryTableConfigurationResult": {
"ConfigurationState": "ENABLED",
"TableStatus": "BACKFILL_COMPLETE",
"TableName": "inventory",
"TableArn": "arn:aws:s3tables:us-east-2:111122223333:bucket/aws-managed-s3-111122223333-us-east-2/table/e123456-b876-4e5e-af29-bb055922ee4d",
"EncryptionConfiguration": {
"SseAlgorithm": "AES256"
}
}
}
}
}
```
### Penggunaan API REST
Anda dapat mengirim permintaan REST untuk melihat konfigurasi tabel metadata. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html).
**catatan**
Anda dapat menggunakan operasi V2 `GetBucketMetadataConfiguration` API dengan konfigurasi tabel metadata V1 atau V2. Namun, jika Anda mencoba menggunakan operasi `GetBucketMetadataTableConfiguration` API V1 dengan konfigurasi V2, Anda akan menerima kesalahan HTTP`405 Method Not Allowed`.
### Menggunakan AWS SDKs
Anda dapat menggunakan AWS SDKs untuk melihat konfigurasi tabel metadata di Amazon S3. Untuk selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html#API_GetBucketMetadataTableConfiguration_SeeAlso).
# Menghapus konfigurasi tabel metadata
Jika ingin berhenti memperbarui konfigurasi tabel metadata untuk bucket tujuan umum Amazon S3, Anda dapat menghapus konfigurasi tabel metadata yang dilampirkan ke bucket. Menghapus konfigurasi tabel metadata hanya menghapus konfigurasi. Bucket tabel AWS terkelola dan tabel metadata Anda masih ada, meskipun Anda menghapus konfigurasi tabel metadata. Namun, tabel metadata tidak akan lagi diperbarui.
**catatan**
Jika Anda menghapus konfigurasi tabel metadata dan ingin membuat ulang konfigurasi untuk bucket tujuan umum yang sama, Anda harus terlebih dahulu menghapus jurnal dan tabel inventaris lama secara manual dari keranjang tabel AWS terkelola. Jika tidak, membuat konfigurasi tabel metadata baru gagal karena tabel tersebut sudah ada. Untuk menghapus tabel metadata Anda, lihat. [Menghapus tabel metadata](metadata-tables-delete-table.md)
Untuk menghapus tabel metadata Anda, lihat. [Hapus tabel metadata](metadata-tables-delete-table.md#delete-metadata-table-procedure) Untuk menghapus bucket tabel, lihat [Menghapus bucket tabel](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-delete.html) dan [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucket.html)di Referensi API *Amazon S3*.
Anda dapat menghapus konfigurasi tabel metadata menggunakan konsol Amazon S3,AWS CLI(), API AWS Command Line Interface REST Amazon S3, AWS SDKs atau Amazon S3.
## Hapus konfigurasi tabel metadata
### Menggunakan konsol S3
**Untuk menghapus konfigurasi tabel metadata**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Pilih bucket tujuan umum tempat Anda ingin menghapus konfigurasi tabel metadata.
1. Pada halaman detail bucket, pilih tab **Metadata**.
1. **Pada tab **Metadata**, pilih Hapus.**
1. Di kotak dialog **Hapus konfigurasi metadata**, masukkan **confirm** untuk mengonfirmasi bahwa Anda ingin menghapus konfigurasi. Lalu pilih **Hapus**.
### Menggunakan AWS CLI
Untuk menjalankan perintah berikut, Anda harus AWS CLI menginstal dan mengkonfigurasi. Jika Anda belum menginstal, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
Atau, Anda dapat menjalankan AWS CLI perintah dari konsol dengan menggunakan AWS CloudShell. AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS Untuk informasi lebih lanjut, lihat [Apa itu CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) dan [Memulai dengan AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html) di *Panduan AWS CloudShell Pengguna*.
**Untuk menghapus konfigurasi tabel metadata dengan menggunakan AWS CLI**
Untuk menggunakan perintah contoh berikut, ganti `user input placeholders` dengan informasi Anda sendiri.
1. Gunakan perintah berikut untuk menghapus konfigurasi tabel metadata dari bucket tujuan umum Anda (misalnya,`amzn-s3-demo-bucket`):
```
aws s3api delete-bucket-metadata-configuration \
--bucket amzn-s3-demo-bucket \
--region us-east-2
```
1. Untuk memverifikasi bahwa konfigurasi telah dihapus, gunakan perintah berikut:
```
aws s3api get-bucket-metadata-configuration \
--bucket amzn-s3-demo-bucket \
--region us-east-2
```
### Penggunaan API REST
Anda dapat mengirim permintaan REST untuk menghapus konfigurasi tabel metadata. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataConfiguration.html).
**catatan**
Anda dapat menggunakan operasi V2 `DeleteBucketMetadataConfiguration` API dengan konfigurasi tabel metadata V1 atau V2. Namun, jika Anda mencoba menggunakan operasi `DeleteBucketMetadataTableConfiguration` API V1 dengan konfigurasi V2, Anda akan menerima kesalahan HTTP`405 Method Not Allowed`.
### Menggunakan AWS SDKs
Anda dapat menggunakan AWS SDKs untuk menghapus konfigurasi tabel metadata di Amazon S3. Untuk selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataConfiguration.html#API_DeleteBucketMetadataConfiguration_SeeAlso).
# Menghapus tabel metadata
Jika ingin menghapus tabel metadata yang dibuat untuk bucket tujuan umum Amazon S3, Anda dapat menghapus tabel metadata dari bucket tabel terkelola. AWS
**penting**
Menghapus tabel bersifat permanen dan tidak dapat dibatalkan. Sebelum menghapus tabel, pastikan Anda telah mencadangkan data penting apa pun.
Sebelum menghapus tabel metadata, sebaiknya hapus terlebih dahulu konfigurasi tabel metadata terkait pada bucket tujuan umum. Untuk informasi selengkapnya, lihat [Menghapus konfigurasi tabel metadata](metadata-tables-delete-configuration.md).
Untuk menghapus bucket tabel AWS terkelola, lihat [Menghapus bucket tabel](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-delete.html) dan [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucket.html)di Referensi API *Amazon S3*. Sebelum menghapus bucket tabel AWS terkelola, sebaiknya hapus dulu semua konfigurasi tabel metadata yang terkait dengan bucket ini. Anda juga harus menghapus semua tabel metadata di bucket terlebih dahulu.
Anda dapat menghapus tabel metadata menggunakan AWS Command Line Interface (AWS CLI), the AWS SDKs, atau Amazon S3 REST API.
## Hapus tabel metadata
### Menggunakan AWS CLI
Untuk menjalankan perintah berikut, Anda harus AWS CLI menginstal dan mengkonfigurasi. Jika Anda belum menginstal, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
Atau, Anda dapat menjalankan AWS CLI perintah dari konsol dengan menggunakan AWS CloudShell. AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS Untuk informasi lebih lanjut, lihat [Apa itu CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) dan [Memulai dengan AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html) di *Panduan AWS CloudShell Pengguna*.
**Untuk menghapus konfigurasi tabel metadata dengan menggunakan AWS CLI**
Untuk menggunakan perintah contoh berikut, ganti `user input placeholders` dengan informasi Anda sendiri.
1. Gunakan perintah berikut untuk menghapus tabel metadata dari bucket tabel AWS terkelola:
```
aws s3tables delete-table \
--table-bucket-arn arn:aws:s3tables:us-east-2:111122223333:bucket/aws-s3 \
--namespace b_general-purpose-bucket-name \
--name journal \
--region us-east-2
```
1. Untuk memverifikasi bahwa tabel telah dihapus, gunakan perintah berikut:
```
aws s3tables get-table \
--table-bucket-arn arn:aws:s3tables:us-east-2:111122223333:bucket/aws-s3 \
--namespace b_general-purpose-bucket-name \
--name journal \
--region us-east-2
```
### Penggunaan API REST
Anda dapat mengirim permintaan REST untuk menghapus konfigurasi tabel metadata. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTable.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTable.html) di *Referensi API Amazon S3*.
### Menggunakan AWS SDKs
Anda dapat menggunakan AWS SDKs untuk menghapus konfigurasi tabel metadata di Amazon S3. Untuk selengkapnya, lihat [daftar yang didukung SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTable.html#API_s3TableBuckets_DeleteTable_SeeAlso) di Referensi *API Amazon S3*.
# Menanyakan tabel metadata
Tabel Metadata Amazon S3 Anda disimpan dalam bucket tabel S3 AWS terkelola, yang menyediakan penyimpanan yang dioptimalkan untuk data tabular. Untuk menanyakan metadata Anda, Anda dapat mengintegrasikan keranjang meja Anda dengan Amazon SageMaker Lakehouse. Integrasi ini, yang menggunakan AWS Glue Data Catalog dan AWS Lake Formation, memungkinkan layanan AWS analitik untuk secara otomatis menemukan dan mengakses data tabel Anda.
Setelah bucket meja terintegrasi dengan AWS Glue Data Catalog, Anda dapat langsung menanyakan tabel metadata Anda dengan layanan AWS analitik seperti Amazon Athena, Amazon EMR, dan Amazon Redshift. Anda juga dapat membuat dasbor interaktif dengan data kueri Anda dengan menggunakan Amazon Quick.
Untuk informasi selengkapnya tentang mengintegrasikan bucket tabel S3 AWS terkelola Anda dengan Amazon SageMaker Lakehouse, lihat. [Mengintegrasikan Tabel AWS Amazon S3 dengan layanan analitik](s3-tables-integrating-aws.md)
Anda juga dapat menanyakan tabel metadata Anda denganApache Spark,Apache Trino, dan aplikasi lain yang mendukung Apache Iceberg format dengan menggunakan titik akhir AWS Glue Iceberg REST, titik akhir Amazon S3 Tables Iceberg REST, atau Katalog Tabel Amazon S3 untuk katalog klien. Apache Iceberg Untuk informasi selengkapnya tentang mengakses tabel metadata Anda, lihat. [Mengakses data tabel](s3-tables-access.md)
Anda dapat menganalisis tabel metadata Anda dengan mesin kueri apa pun yang mendukung format. Apache Iceberg Misalnya, Anda dapat menanyakan tabel metadata Anda untuk melakukan hal berikut:
+ Temukan pola dan tren penggunaan penyimpanan
+ Audit AWS Key Management Service (AWS KMS) penggunaan kunci enkripsi di seluruh objek Anda
+ Cari objek berdasarkan metadata yang ditentukan pengguna dan tag objek
+ Memahami perubahan metadata objek dari waktu ke waktu
+ Pelajari kapan objek diperbarui atau dihapus, termasuk Akun AWS ID atau alamat IP yang membuat permintaan
Anda juga dapat bergabung dengan tabel metadata terkelola S3 dan tabel metadata kustom, memungkinkan Anda untuk melakukan kueri di beberapa kumpulan data.
## Pertimbangan harga kueri
Harga tambahan berlaku untuk menjalankan kueri pada tabel metadata Anda. Untuk informasi selengkapnya, lihat informasi harga untuk mesin kueri yang Anda gunakan.
Untuk informasi tentang membuat kueri Anda lebih hemat biaya, lihat[Mengoptimalkan kinerja kueri tabel metadata](metadata-tables-optimizing-query-performance.md).
**Topics**
+ [
## Pertimbangan harga kueri
](#metadata-tables-querying-pricing)
+ [
# Izin untuk menanyakan tabel metadata
](metadata-tables-bucket-query-permissions.md)
+ [
# Menanyakan tabel metadata dengan layanan analitik AWS
](metadata-tables-bucket-integration.md)
+ [
# Kueri tabel metadata dengan mesin kueri sumber terbuka
](metadata-tables-bucket-integration-open-source.md)
+ [
# Mengoptimalkan kinerja kueri tabel metadata
](metadata-tables-optimizing-query-performance.md)
+ [
# Contoh kueri tabel metadata
](metadata-tables-example-queries.md)
# Izin untuk menanyakan tabel metadata
Sebelum Anda dapat menanyakan jurnal Metadata S3 dan tabel inventaris langsung, Anda harus memiliki izin Tabel S3 tertentu. Jika tabel metadata Anda telah dienkripsi dengan enkripsi sisi server menggunakan kunci AWS Key Management Service (AWS KMS) (SSE-KMS), Anda juga harus memiliki izin untuk mendekripsi data tabel. `kms:Decrypt`
Saat Anda membuat konfigurasi tabel metadata, tabel metadata Anda disimpan dalam keranjang tabel terkelola AWS . Semua konfigurasi tabel metadata di akun Anda dan di Wilayah yang sama disimpan dalam satu keranjang tabel AWS terkelola bernama. `aws-s3`
Untuk menanyakan tabel metadata, Anda dapat menggunakan contoh kebijakan berikut. Untuk menggunakan kebijakan ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
{
"Version":"2012-10-17",
"Statement":[
{
"Sid":"PermissionsToQueryMetadataTables",
"Effect":"Allow",
"Action":[
"s3tables:GetTable",
"s3tables:GetTableData",
"s3tables:GetTableMetadataLocation",
"kms:Decrypt"
],
"Resource":[
"arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3",
"arn:aws:s3tables:us-east-1:111122223333:bucket/aws-s3/table/*",
"arn:aws:kms:us-east-1:111122223333:key/01234567-89ab-cdef-0123-456789abcdef"
]
}
]
}
```
# Menanyakan tabel metadata dengan layanan analitik AWS
Anda dapat menanyakan tabel metadata terkelola S3 Anda dengan layanan AWS analitik seperti Amazon Athena, Amazon Redshift, dan Amazon EMR.
Sebelum dapat menjalankan kueri, Anda harus terlebih dahulu [mengintegrasikan bucket tabel S3 AWS terkelola](s3-tables-integrating-aws.md) di wilayah Akun AWS dan wilayah Anda dengan AWS layanan analitik.
## Menanyakan tabel metadata dengan Amazon Athena
Setelah [mengintegrasikan bucket tabel S3 AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html) dengan layanan AWS analitik, Anda dapat mulai menanyakan tabel metadata di Athena. Dalam pertanyaan Anda, lakukan hal berikut:
+ Tentukan katalog Anda sebagai `s3tablescatalog/aws-s3` dan database Anda sebagai `b_general_purpose_bucket_name` (yang biasanya merupakan namespace untuk tabel metadata Anda).
+ Pastikan untuk mengelilingi nama namespace tabel metadata Anda dalam tanda kutip (`"`) atau backticks (```), jika tidak, kueri mungkin tidak berfungsi.
Untuk informasi selengkapnya, lihat [Menanyakan tabel Amazon S3 dengan Athena](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-athena.html).
Anda juga dapat menjalankan kueri di Athena dari konsol Amazon S3.
### Menggunakan konsol S3 dan Amazon Athena
Prosedur berikut menggunakan konsol Amazon S3 untuk mengakses editor kueri Athena sehingga Anda dapat menanyakan tabel dengan Amazon Athena.
**Untuk menanyakan tabel metadata**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Pada tab **Bucket tujuan umum**, pilih bucket yang berisi konfigurasi metadata untuk tabel metadata yang ingin Anda kueri.
1. Pada halaman detail bucket, pilih tab **Metadata**.
1. Pilih **tabel Kueri dengan Athena**, lalu pilih salah satu contoh kueri untuk jurnal atau tabel inventaris.
1. Konsol Amazon Athena terbuka dan editor kueri Athena muncul dengan contoh kueri yang dimuat untuk Anda. Ubah kueri ini sesuai kebutuhan untuk kasus penggunaan Anda.
Di editor kueri, bidang **Katalog** harus diisi dengan **s3tablescatalog/aws-s3**. **Bidang **Database** harus diisi dengan namespace tempat tabel Anda disimpan (misalnya, b\$1). *general-purpose-bucket-name***
**catatan**
Jika Anda tidak melihat nilai ini di bidang **Katalog** dan **Database**, pastikan Anda telah mengintegrasikan bucket tabel AWS terkelola dengan layanan AWS analitik di Wilayah ini. Untuk informasi selengkapnya, lihat [Mengintegrasikan Tabel AWS Amazon S3 dengan layanan analitik](s3-tables-integrating-aws.md).
1. Untuk menjalankan kueri, pilih **Jalankan**.
**catatan**
Jika Anda menerima kesalahan “Izin tidak cukup untuk menjalankan kueri. Principal tidak memiliki hak istimewa pada sumber daya tertentu “ketika Anda mencoba menjalankan kueri di Athena, Anda harus diberikan izin Formasi Danau yang diperlukan di atas meja. Untuk informasi selengkapnya, lihat [Memberikan izin Lake Formation di atas meja atau database](grant-permissions-tables.md#grant-lf-table).
Pastikan juga bahwa Anda memiliki izin AWS Identity and Access Management (IAM) yang sesuai untuk menanyakan tabel metadata. Untuk informasi selengkapnya, lihat [Izin untuk menanyakan tabel metadata](metadata-tables-bucket-query-permissions.md).
Jika Anda menerima kesalahan “Gunung es tidak dapat mengakses sumber daya yang diminta” ketika Anda mencoba menjalankan kueri, buka AWS Lake Formation konsol dan pastikan bahwa Anda telah memberikan diri Anda izin pada katalog keranjang tabel dan database (namespace) yang Anda buat. Jangan tentukan tabel saat memberikan izin ini. Untuk informasi selengkapnya, lihat [Memberikan izin Lake Formation di atas meja atau database](grant-permissions-tables.md#grant-lf-table).
## Menanyakan tabel metadata dengan Amazon Redshift
Setelah [mengintegrasikan bucket tabel S3 AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html) dengan layanan AWS analitik, lakukan hal berikut:
+ [Buat tautan sumber daya](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html#database-link-tables) ke namespace tabel metadata Anda (biasanya). `b_general_purpose_bucket_name`
+ Pastikan untuk mengelilingi nama namespace tabel metadata Anda dalam tanda kutip (`"`) atau backticks (```), jika tidak, kueri mungkin tidak berfungsi.
Setelah selesai, Anda dapat mulai menanyakan tabel metadata Anda di konsol Amazon Redshift. Untuk informasi selengkapnya, lihat [Mengakses tabel Amazon S3 dengan Amazon Redshift](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-redshift.html).
## Menanyakan tabel metadata dengan Amazon EMR
Untuk menanyakan tabel metadata Anda menggunakan Amazon EMR, Anda membuat klaster EMR Amazon yang dikonfigurasi Apache Iceberg dan terhubung ke tabel metadata Anda menggunakan. Apache Spark Anda dapat mengaturnya dengan mengintegrasikan bucket tabel S3 AWS terkelola dengan layanan AWS analitik atau menggunakan Katalog Tabel Amazon S3 sumber terbuka untuk katalog klien. Iceberg
**catatan**
Saat menggunakan EMR Apache Spark Amazon atau mesin pihak ketiga lainnya untuk menanyakan tabel metadata Anda, sebaiknya gunakan titik akhir REST Amazon S3 Tables. Iceberg Kueri Anda mungkin tidak berhasil berjalan jika Anda tidak menggunakan titik akhir ini. Untuk informasi selengkapnya, lihat [Mengakses tabel menggunakan endpoint Amazon S3 Iceberg REST Tables](s3-tables-integrating-open-source.md).
Untuk informasi selengkapnya, lihat [Mengakses tabel Amazon S3 dengan Amazon EMR](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-emr.html).
# Kueri tabel metadata dengan mesin kueri sumber terbuka
Anda dapat menanyakan tabel metadata terkelola S3 Anda dengan menggunakan mesin kueri sumber terbuka, seperti. Apache Spark Saat menggunakan EMR Apache Spark Amazon atau mesin pihak ketiga lainnya untuk menanyakan tabel metadata Anda, sebaiknya gunakan titik akhir REST Amazon S3 Tables. Iceberg Kueri Anda mungkin tidak berhasil berjalan jika Anda tidak menggunakan titik akhir ini. Untuk informasi selengkapnya, lihat [Mengakses tabel menggunakan endpoint Amazon S3 Iceberg REST Tables](s3-tables-integrating-open-source.md).
# Mengoptimalkan kinerja kueri tabel metadata
Karena Metadata S3 didasarkan pada format Apache Iceberg tabel, Anda dapat mengoptimalkan kinerja dan [biaya](#metadata-tables-optimizing-query-performance) kueri tabel jurnal Anda dengan menggunakan rentang waktu tertentu.
Misalnya, kueri SQL berikut memberikan tingkat sensitivitas objek baru dalam bucket tujuan umum S3:
```
SELECT key, object_tags['SensitivityLevel']
FROM "b_general-purpose-bucket-name"."journal"
WHERE record_type = 'CREATE'
GROUP BY object_tags['SensitivityLevel']
```
Kueri ini memindai seluruh tabel jurnal, yang mungkin membutuhkan waktu lama untuk dijalankan. Untuk meningkatkan kinerja, Anda dapat menyertakan `record_timestamp` kolom untuk fokus pada rentang waktu tertentu. **Kami juga merekomendasikan untuk menggunakan nama tabel yang memenuhi syarat, yang dapat Anda temukan di konsol Amazon S3 pada halaman detail konfigurasi metadata pada tab Metadata bucket tujuan umum.** Berikut adalah versi terbaru dari kueri sebelumnya yang melihat objek baru dari bulan lalu:
```
SELECT key, object_tags['SensitivityLevel']
FROM b_general-purpose-bucket-name"."aws-s3.b_general-purpose-bucket-name.journal"
WHERE record_type = 'CREATE'
AND record_timestamp > (CURRENT_TIMESTAMP – interval '1' month)
GROUP BY object_tags['SensitivityLevel']
```
Untuk meningkatkan kinerja kueri pada tabel inventaris, pastikan Anda melakukan kueri hanya pada kolom minimum yang Anda butuhkan.
# Contoh kueri tabel metadata
Contoh berikut menunjukkan bagaimana Anda bisa mendapatkan informasi jenis yang berbeda dari tabel Metadata S3 Anda dengan menggunakan kueri SQL standar.
Ingat saat menggunakan contoh-contoh ini:
+ Contohnya ditulis untuk bekerja dengan Amazon Athena. Anda mungkin harus memodifikasi contoh untuk bekerja dengan mesin kueri yang berbeda.
+ Pastikan Anda memahami cara [mengoptimalkan kueri Anda](metadata-tables-optimizing-query-performance.md).
+ Ganti `b_general-purpose-bucket-name` dengan nama namespace Anda.
+ Untuk daftar lengkap kolom yang didukung, lihat [Skema tabel jurnal Metadata S3](metadata-tables-schema.md) dan[Skema tabel inventaris langsung Metadata S3](metadata-tables-inventory-schema.md).
**Contents**
+ [
## Contoh pertanyaan tabel jurnal
](#metadata-tables-example-queries-journal-tables)
+ [
### Menemukan objek dengan ekstensi file
](#metadata-tables-example-query-object-pattern)
+ [
### Daftar penghapusan objek
](#metadata-tables-example-query-delete-events)
+ [
### Daftar kunci AWS KMS enkripsi yang digunakan oleh objek Anda
](#metadata-tables-example-query-objects-using-kms-key)
+ [
### Daftar objek yang tidak menggunakan kunci KMS
](#metadata-tables-example-query-objects-not-using-kms-key)
+ [
### Daftar kunci AWS KMS enkripsi yang digunakan untuk `PUT` operasi dalam 7 hari terakhir
](#metadata-tables-example-query-objects-using-kms-key-puts)
+ [
### Mencantumkan objek yang dihapus dalam 24 jam terakhir oleh Siklus Hidup S3
](#metadata-tables-example-query-objects-deleted-lifecycle)
+ [
### Melihat metadata yang disediakan oleh Amazon Bedrock
](#metadata-tables-example-query-bedrock)
+ [
### Memahami keadaan objek Anda saat ini
](#metadata-tables-example-query-current-state)
+ [
## Contoh pertanyaan tabel inventaris
](#metadata-tables-example-queries-inventory-tables)
+ [
### Menemukan kumpulan data yang menggunakan tag tertentu
](#metadata-tables-example-query-datasets-specific-tags)
+ [
### Daftar objek yang tidak dienkripsi dengan SSE-KMS
](#metadata-tables-example-query-objects-not-kms-encrypted)
+ [
### Daftar objek yang tidak dienkripsi
](#metadata-tables-example-query-objects-not-encrypted)
+ [
### Daftar objek yang dihasilkan oleh Amazon Bedrock
](#metadata-tables-example-query-objects-generated-bedrock)
+ [
### Rekonsiliasi tabel inventaris dengan tabel jurnal
](#metadata-tables-example-query-generate-latest-inventory)
+ [
### Menemukan versi objek Anda saat ini
](#metadata-tables-example-query-latest-version)
+ [
# Menggabungkan metadata kustom dengan tabel metadata S3
](metadata-tables-join-custom-metadata.md)
+ [
# Memvisualisasikan data tabel metadata dengan Amazon Quick
](metadata-tables-quicksight-dashboards.md)
## Contoh pertanyaan tabel jurnal
Anda dapat menggunakan contoh query berikut untuk query tabel jurnal Anda.
### Menemukan objek dengan ekstensi file
Query berikut mengembalikan objek dengan ekstensi file tertentu (`.jpg`dalam hal ini):
```
SELECT key FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal"
WHERE key LIKE '%.jpg'
AND record_type = 'CREATE'
```
### Daftar penghapusan objek
Kueri berikut mengembalikan peristiwa penghapusan objek, termasuk Akun AWS ID atau prinsip AWS layanan yang membuat permintaan:
```
SELECT DISTINCT bucket, key, sequence_number, record_type, record_timestamp, requester, source_ip_address, version_id
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal"
WHERE record_type = 'DELETE';
```
### Daftar kunci AWS KMS enkripsi yang digunakan oleh objek Anda
Query berikut mengembalikan ARNs kunci AWS Key Management Service (AWS KMS) mengenkripsi objek Anda:
```
SELECT DISTINCT kms_key_arn
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal";
```
### Daftar objek yang tidak menggunakan kunci KMS
Kueri berikut mengembalikan objek yang tidak dienkripsi dengan AWS KMS kunci:
```
SELECT DISTINCT kms_key_arn
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal"
WHERE encryption_status NOT IN ('SSE-KMS', 'DSSE-KMS')
AND record_type = 'CREATE';
```
### Daftar kunci AWS KMS enkripsi yang digunakan untuk `PUT` operasi dalam 7 hari terakhir
Query berikut mengembalikan ARNs kunci AWS Key Management Service (AWS KMS) mengenkripsi objek Anda:
```
SELECT DISTINCT kms_key_arn
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal"
WHERE record_timestamp > (current_date - interval '7' day)
AND kms_key_arn is NOT NULL;
```
### Mencantumkan objek yang dihapus dalam 24 jam terakhir oleh Siklus Hidup S3
Hasil kueri berikut mencantumkan objek yang kedaluwarsa pada hari terakhir oleh Siklus Hidup S3:
```
SELECT bucket, key, version_id, last_modified_date, record_timestamp, requester
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal"
WHERE requester = 's3.amazonaws.com'
AND record_type = 'DELETE'
AND record_timestamp > (current_date - interval '1' day)
```
### Melihat metadata yang disediakan oleh Amazon Bedrock
Beberapa AWS layanan (seperti [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/welcome.html)), mengunggah objek ke Amazon S3. Anda dapat menanyakan metadata objek yang disediakan oleh layanan ini. Misalnya, kueri berikut menyertakan `user_metadata` kolom untuk menentukan apakah ada objek yang diunggah oleh Amazon Bedrock ke bucket tujuan umum:
```
SELECT DISTINCT bucket, key, sequence_number, record_type, record_timestamp, user_metadata
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal"
WHERE record_type = 'CREATE'
AND user_metadata['content-source'] = 'AmazonBedrock';
```
Jika Amazon Bedrock mengunggah objek ke bucket Anda, `user_metadata` kolom akan menampilkan metadata berikut yang terkait dengan objek dalam hasil kueri:
```
user_metadata
{content-additional-params -> requestid="CVK8FWYRW0M9JW65", signedContentSHA384="38b060a751ac96384cd9327eb1b1e36a21fdb71114be07434c0cc7bf63f6e1da274edebfe76f65fbd51ad2f14898b95b", content-model-id -> bedrock-model-arn, content-source -> AmazonBedrock}
```
### Memahami keadaan objek Anda saat ini
Kueri berikut dapat membantu Anda menentukan keadaan objek Anda saat ini. Kueri mengidentifikasi versi terbaru dari setiap objek, menyaring objek yang dihapus, dan menandai versi terbaru dari setiap objek berdasarkan nomor urut. Hasil diurutkan oleh`bucket`,`key`, dan `sequence_number` kolom.
```
WITH records_of_interest as (
-- Start with a query that can narrow down the records of interest.
SELECT * from "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal"
),
version_stacks as (
SELECT *,
-- Introduce a column called 'next_sequence_number', which is the next larger
-- sequence_number for the same key version_id in sorted order.
LEAD(sequence_number, 1) over (partition by (bucket, key, coalesce(version_id, '')) order by sequence_number ASC) as next_sequence_number
from records_of_interest
),
-- Pick the 'tip' of each version stack triple: (bucket, key, version_id).
-- The tip of the version stack is the row of that triple with the largest sequencer.
-- Selecting only the tip filters out any row duplicates.
-- This isn't typical, but some events can be delivered more than once to the table
-- and include rows that might no longer exist in the bucket (since the
-- table contains rows for both extant and extinct objects).
-- In the next subquery, eliminate the rows that contain deleted objects.
current_versions as (
SELECT * from version_stacks where next_sequence_number is NULL
),
-- Eliminate the rows that are extinct from the bucket by filtering with
-- record_type. An object version has been deleted from the bucket if its tip is
-- record_type==DELETE.
existing_current_versions as (
SELECT * from current_versions where not (record_type = 'DELETE' and is_delete_marker = FALSE)
),
-- Optionally, to determine which of several object versions is the 'latest',
-- you can compare their sequence numbers. A version_id is the latest if its
-- tip's sequencer is the largest among all other tips in the same key.
with_is_latest as (
SELECT *,
-- Determine if the sequence_number of this row is the same as the largest sequencer for the key that still exists.
sequence_number = (MAX(sequence_number) over (partition by (bucket, key))) as is_latest_version
FROM existing_current_versions
)
SELECT * from with_is_latest
ORDER BY bucket, key, sequence_number;
```
## Contoh pertanyaan tabel inventaris
Anda dapat menggunakan contoh kueri berikut untuk menanyakan tabel inventaris Anda.
### Menemukan kumpulan data yang menggunakan tag tertentu
Query berikut mengembalikan dataset yang menggunakan tag tertentu:
```
SELECT *
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."inventory"
WHERE object_tags['key1'] = 'value1'
AND object_tags['key2'] = 'value2';
```
### Daftar objek yang tidak dienkripsi dengan SSE-KMS
Kueri berikut mengembalikan objek yang tidak dienkripsi dengan SSE-KMS:
```
SELECT key, encryption_status
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."inventory"
WHERE encryption_status != 'SSE-KMS';
```
### Daftar objek yang tidak dienkripsi
Kueri berikut mengembalikan objek yang tidak dienkripsi:
```
SELECT bucket, key, version_id
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."inventory"
WHERE encryption_status IS NULL;
```
### Daftar objek yang dihasilkan oleh Amazon Bedrock
Kueri berikut mencantumkan objek yang dihasilkan oleh Amazon Bedrock:
```
SELECT DISTINCT bucket, key, sequence_number, user_metadata
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."inventory"
WHERE user_metadata['content-source'] = 'AmazonBedrock';
```
### Rekonsiliasi tabel inventaris dengan tabel jurnal
Kueri berikut menghasilkan inventory-table-like daftar yang up to date dengan konten bucket saat ini. Lebih tepatnya, daftar yang dihasilkan menggabungkan snapshot terbaru dari tabel inventaris dengan peristiwa terbaru di tabel jurnal.
Agar kueri ini menghasilkan hasil yang paling akurat, baik jurnal maupun tabel inventaris harus dalam status Aktif.
Kami merekomendasikan penggunaan kueri ini untuk ember tujuan umum yang berisi kurang dari satu miliar (10^9) objek.
Contoh kueri ini menerapkan penyederhanaan berikut untuk hasil daftar (dibandingkan dengan tabel inventaris):
+ **Kelalaian kolom** — Kolom `bucket``is_multipart`,`encryption_status`,,`is_bucket_key_enabled`,`kms_key_arn`, dan `checksum_algorithm` bukan bagian dari hasil akhir. Menjaga set kolom opsional seminimal mungkin meningkatkan kinerja.
+ **Penyertaan semua catatan** - Kueri mengembalikan semua kunci objek dan versi, termasuk versi null (dalam bucket yang tidak berversi atau ditangguhkan versi) dan menghapus penanda. Untuk contoh cara memfilter hasil agar hanya menampilkan kunci yang Anda minati, lihat `WHERE` klausa di akhir kueri.
+ **Rekonsiliasi yang dipercepat** - Kueri dapat, dalam kasus yang jarang terjadi, melaporkan sementara objek yang tidak lagi ada di ember. Perbedaan tersebut dihilangkan segera setelah snapshot berikutnya dari tabel inventaris tersedia. Perilaku ini merupakan tradeoff antara kinerja dan akurasi.
Untuk menjalankan kueri ini di Amazon Athena, pastikan untuk memilih `s3tablescatalog/aws-s3` katalog dan `b_general-purpose-bucket-name` database untuk konfigurasi metadata bucket tujuan umum yang berisi jurnal dan tabel inventaris Anda.
```
WITH inventory_time_cte AS (
SELECT COALESCE(inventory_time_from_property, inventory_time_default) AS inventory_time FROM
(
SELECT * FROM
(VALUES (TIMESTAMP '2024-12-01 00:00')) AS T (inventory_time_default)
LEFT OUTER JOIN
(
SELECT from_unixtime(CAST(value AS BIGINT) / 1000.0) AS inventory_time_from_property FROM "journal$properties"
WHERE key = 'aws.s3metadata.oldest-uncoalesced-record-timestamp' LIMIT 1
)
ON TRUE
)
),
working_set AS (
SELECT
key,
sequence_number,
version_id,
is_delete_marker,
size,
COALESCE(last_modified_date, record_timestamp) AS last_modified_date,
e_tag,
storage_class,
object_tags,
user_metadata,
(record_type = 'DELETE' AND NOT COALESCE(is_delete_marker, FALSE)) AS _is_perm_delete
FROM journal j
CROSS JOIN inventory_time_cte t
WHERE j.record_timestamp > (t.inventory_time - interval '15' minute)
UNION ALL
SELECT
key,
sequence_number,
version_id,
is_delete_marker,
size,
last_modified_date,
e_tag,
storage_class,
object_tags,
user_metadata,
FALSE AS _is_perm_delete
FROM inventory i
),
updated_inventory AS (
SELECT * FROM (
SELECT *,
MAX(sequence_number) OVER (PARTITION BY key, version_id) AS _supremum_sn
FROM working_set
)
WHERE sequence_number = _supremum_sn
)
SELECT
key,
sequence_number,
version_id,
is_delete_marker,
size,
last_modified_date,
e_tag,
storage_class,
object_tags,
user_metadata
FROM updated_inventory
-- This filter omits only permanent deletes from the results. Delete markers will still be shown.
WHERE NOT _is_perm_delete
-- You can add additional filters here. Examples:
-- AND object_tags['department'] = 'billing'
-- AND starts_with(key, 'reports/')
ORDER BY key ASC, sequence_number DESC;
```
### Menemukan versi objek Anda saat ini
Kueri berikut menggunakan tabel inventaris untuk menghasilkan tabel keluaran baru yang menunjukkan versi objek mana yang saat ini. Tabel keluaran sengaja mirip dengan laporan Inventaris S3. Tabel output mencakup `is_latest` bidang, yang menunjukkan apakah suatu objek adalah versi saat ini. `is_latest`Bidang ini setara dengan **IsLatest**bidang dalam [laporan Inventaris S3](storage-inventory.md#storage-inventory-contents).
Kueri ini berfungsi untuk bucket tujuan umum dengan Pembuatan Versi [S3 dalam status berkemampuan versi atau ditangguhkan](Versioning.md) versi.
**Prasyarat**
Kueri mengeluarkan hasil ke tabel S3 baru untuk mendukung kueri lebih lanjut dan untuk kinerja yang lebih tinggi dibandingkan baris keluaran di layar. Oleh karena itu, sebelum menjalankan kueri ini, pastikan Anda telah memenuhi kondisi berikut. Jika Anda memilih untuk tidak menampilkan hasil ke tabel baru, Anda dapat melewati langkah-langkah ini.
+ Anda harus memiliki keranjang tabel yang dikelola pelanggan dengan namespace yang ada sebagai tempat untuk menampilkan tabel baru. Untuk informasi selengkapnya, lihat [Membuat ember meja](s3-tables-buckets-create.md) dan [Membuat namespace](s3-tables-namespace-create.md).
+ Untuk menanyakan tabel keluaran baru Anda, Anda harus menyiapkan metode akses untuk menanyakannya. Untuk informasi selengkapnya, lihat [Mengakses data tabel](s3-tables-access.md). Jika Anda ingin menanyakan tabel keluaran dengan layanan AWS analitik seperti Amazon Athena, keranjang tabel yang dikelola pelanggan Anda harus terintegrasi dengan layanan analitik. AWS Untuk informasi selengkapnya, lihat [Integrasi Amazon S3 Tabel dengan ikhtisar layanan AWS analitik](s3-tables-integration-overview.md).
Untuk menggunakan kueri ini, ganti `amzn-s3-demo-table-bucket` dengan nama bucket tabel yang dikelola pelanggan yang ada di mana Anda ingin tabel keluaran baru dibuat. Ganti *`existing_namespace`* dengan nama namespace tempat Anda ingin tabel keluaran dibuat di bucket tabel Anda. Ganti *`new_table`* dengan nama yang ingin Anda gunakan untuk tabel output. Pastikan bahwa nama tabel output Anda mengikuti [aturan penamaan tabel](s3-tables-buckets-naming.md#naming-rules-table).
Untuk menjalankan kueri ini di Amazon Athena, pastikan untuk memilih `s3tablescatalog/aws-s3` katalog dan `b_general-purpose-bucket-name` database untuk konfigurasi metadata bucket tujuan umum yang berisi tabel inventaris Anda.
```
-- If you don't want to output the results to a new table, remove the following two lines
-- (everything before the WITH clause).
CREATE TABLE "s3tablescatalog/amzn-s3-demo-table-bucket"."existing_namespace"."new_table"
as (
WITH
my_inventory AS (
SELECT
bucket,
key,
version_id,
sequence_number,
is_delete_marker,
size,
last_modified_date,
storage_class
FROM inventory
-- For prefix filtering, use a WHERE clause with % at the end.
-- WHERE key LIKE 'prefix%'
),
inventory_with_is_latest as (
SELECT *,
ROW_NUMBER() OVER (
PARTITION BY key
ORDER BY sequence_number DESC
) = 1 AS is_latest
FROM my_inventory
)
SELECT
bucket,
key,
version_id,
sequence_number,
is_delete_marker,
size,
last_modified_date,
storage_class,
is_latest
FROM inventory_with_is_latest
-- If you want only the current version of each key, uncomment the following WHERE clause.
-- WHERE is_latest = TRUE
-- If you aren't outputting the results to a new table, remove the next line:
);
```
# Menggabungkan metadata kustom dengan tabel metadata S3
Anda dapat menganalisis data di seluruh tabel metadata AWS terkelola dan tabel metadata pelanggan (dikelola sendiri). Dengan menggunakan `JOIN` operator SQL standar, Anda dapat melakukan kueri data dari berbagai sumber ini.
Contoh query SQL berikut menemukan catatan yang cocok antara tabel jurnal AWS terkelola (`"journal"`) dan tabel metadata yang dikelola sendiri (). `my_self_managed_metadata_table` Kueri juga memfilter informasi berdasarkan `CREATE` peristiwa, yang menunjukkan bahwa objek baru (atau versi baru objek) ditulis ke ember. (Untuk informasi lebih lanjut, lihat[Skema tabel jurnal Metadata S3](metadata-tables-schema.md).)
```
SELECT *
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."journal" a
JOIN "my_namespace"."my_self_managed_metadata_table" b
ON a.bucket = b.bucket AND a.key = b.key AND a.version_id = b.version_id
WHERE a.record_type = 'CREATE';
```
Contoh kueri SQL berikut menemukan catatan yang cocok antara tabel inventaris AWS terkelola (`"inventory"`) dan tabel metadata yang dikelola sendiri (): `my_self_managed_metadata_table`
```
SELECT *
FROM "s3tablescatalog/aws-s3"."b_general-purpose-bucket-name"."inventory" a
JOIN "my_namespace"."my_self_managed_metadata_table" b
ON a.bucket = b.bucket AND a.key = b.key AND a.version_id = b.version_id;
```
# Memvisualisasikan data tabel metadata dengan Amazon Quick
Dengan Amazon Quick, Anda dapat membuat dasbor interaktif untuk menganalisis dan memvisualisasikan hasil kueri SQL tentang tabel metadata terkelola S3 Anda. Dasbor cepat dapat membantu Anda memantau statistik, melacak perubahan, dan mendapatkan wawasan operasional tentang tabel metadata Anda.
Dasbor tentang tabel jurnal Anda mungkin menunjukkan kepada Anda:
+ Berapa persentase unggahan objek dibandingkan dengan penghapusan?
+ Objek mana yang dihapus oleh Siklus Hidup S3 dalam 24 jam terakhir?
+ Alamat IP mana `PUT` permintaan terbaru berasal?
Dasbor tentang tabel inventaris Anda mungkin menunjukkan kepada Anda:
+ Berapa banyak objek di kelas penyimpanan yang berbeda?
+ Berapa persentase data penyimpanan Anda adalah objek kecil dibandingkan dengan objek besar?
+ Jenis objek apa yang ada di ember saya?
Setelah [mengintegrasikan bucket tabel S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html) dengan layanan AWS analitik, Anda dapat membuat kumpulan data dari tabel metadata dan bekerja dengannya di Amazon Quick menggunakan SPICE atau mengarahkan kueri SQL dari mesin kueri Anda. Quick mendukung Amazon Athena dan Amazon Redshift sebagai sumber data.
Untuk informasi selengkapnya, lihat [Memvisualisasikan data tabel dengan Amazon Quick](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-quicksight.html).
# Pemecahan Masalah Metadata S3
Gunakan informasi berikut untuk membantu Anda mendiagnosis dan memperbaiki masalah umum yang mungkin Anda temui saat bekerja dengan Metadata Amazon S3.
## Saya tidak dapat menghapus keranjang tabel AWS terkelola dan tabel metadata saya
Sebelum menghapus tabel metadata, Anda harus terlebih dahulu menghapus konfigurasi tabel metadata terkait pada bucket tujuan umum Anda. Untuk informasi selengkapnya, lihat [Menghapus konfigurasi tabel metadata](metadata-tables-delete-configuration.md).
Sebelum menghapus bucket tabel AWS terkelola, Anda harus menghapus semua konfigurasi tabel metadata yang terkait dengan bucket ini dan semua tabel metadata di bucket. Untuk informasi selengkapnya, lihat [Menghapus konfigurasi tabel metadata](metadata-tables-delete-configuration.md) dan [Menghapus tabel metadata](metadata-tables-delete-table.md).
## Saya tidak dapat mengatur atau mengubah pengaturan enkripsi untuk tabel metadata AWS terkelola saya
Saat membuat konfigurasi tabel metadata, Anda dapat memilih untuk mengenkripsi tabel metadata AWS terkelola dengan enkripsi sisi server menggunakan kunci () (SSE-KMS). AWS Key Management Service AWS KMS Jika Anda memilih untuk menggunakan SSE-KMS, Anda harus menyediakan kunci KMS yang dikelola pelanggan di Wilayah yang sama dengan bucket tujuan umum Anda. Anda dapat mengatur jenis enkripsi untuk tabel Anda hanya selama pembuatan tabel. Setelah tabel yang dikelola AWS dibuat, Anda tidak dapat mengubah pengaturan enkripsinya. Guna menentukan SSE-KMS untuk tabel metadata Anda, Anda harus memiliki izin tertentu. Untuk informasi selengkapnya, lihat [Izin untuk SSE-KMS](metadata-tables-permissions.md#metadata-kms-permissions).
Pengaturan enkripsi untuk tabel metadata lebih diutamakan daripada pengaturan enkripsi tingkat bucket default. Jika Anda tidak menentukan enkripsi untuk tabel, itu akan mewarisi pengaturan enkripsi default dari bucket.
Secara default, bucket tabel AWS terkelola dienkripsi dengan enkripsi sisi server menggunakan kunci terkelola Amazon S3 (SSE-S3). Setelah membuat konfigurasi metadata pertama, Anda dapat mengatur setelan enkripsi default untuk bucket tabel AWS terkelola agar menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-KMS). Untuk informasi selengkapnya, lihat [Enkripsi untuk bucket tabel AWS terkelola](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-aws-managed-buckets.html#aws-managed-buckets-encryption) dan[Menentukan enkripsi sisi server dengan AWS KMS kunci (SSE-KMS) di bucket tabel](s3-tables-kms-specify.md).
## Ketika saya mencoba membuat ulang konfigurasi tabel metadata saya, saya mendapatkan kesalahan
Menghapus konfigurasi tabel metadata hanya menghapus konfigurasi. Bucket tabel AWS terkelola dan tabel metadata Anda masih ada, meskipun Anda menghapus konfigurasi tabel metadata.
Jika Anda menghapus konfigurasi tabel metadata dan ingin membuat ulang konfigurasi untuk bucket tujuan umum yang sama, Anda harus terlebih dahulu menghapus jurnal dan tabel inventaris lama secara manual dari keranjang tabel AWS terkelola. Jika tidak, membuat konfigurasi tabel metadata baru gagal karena tabel tersebut sudah ada.
Untuk menghapus tabel metadata Anda, lihat. [Menghapus tabel metadata](metadata-tables-delete-table.md)
## Saya tidak dapat mengaktifkan tabel inventaris pada konfigurasi saya
Jika Anda membuat konfigurasi Metadata S3 sebelum 15 Juli 2025, Anda tidak dapat mengaktifkan tabel inventaris pada konfigurasi itu. Kami menyarankan Anda menghapus dan membuat ulang konfigurasi Anda sehingga Anda dapat membuat tabel inventaris dan kedaluwarsa catatan tabel jurnal. Untuk informasi selengkapnya, lihat [Mengaktifkan tabel inventaris pada konfigurasi metadata yang dibuat sebelum 15 Juli 2025](metadata-tables-create-configuration.md#metadata-tables-migration).
## Saya tidak dapat mengaktifkan kedaluwarsa catatan tabel jurnal pada konfigurasi saya
Jika Anda membuat konfigurasi Metadata S3 sebelum 15 Juli 2025, Anda tidak dapat mengaktifkan kedaluwarsa catatan tabel jurnal pada konfigurasi itu. Kami menyarankan Anda menghapus dan membuat ulang konfigurasi Anda sehingga Anda dapat kedaluwarsa catatan tabel jurnal dan membuat tabel inventaris. Untuk informasi selengkapnya, lihat [Mengaktifkan tabel inventaris pada konfigurasi metadata yang dibuat sebelum 15 Juli 2025](metadata-tables-create-configuration.md#metadata-tables-migration).
## Saya tidak dapat menanyakan tabel metadata saya
Jika Anda tidak dapat menanyakan tabel metadata Anda, periksa hal berikut:
+ Saat Anda menggunakan Amazon Athena atau Amazon Redshift untuk menanyakan tabel metadata Anda, Anda harus mengelilingi nama namespace tabel metadata Anda dalam tanda kutip () atau backticks `"` (), jika tidak kueri mungkin tidak berfungsi. ```
+ Saat menggunakan EMR Apache Spark Amazon atau mesin pihak ketiga lainnya untuk menanyakan tabel metadata Anda, sebaiknya gunakan titik akhir REST Amazon S3 Tables. Iceberg Kueri Anda mungkin tidak berhasil berjalan jika Anda tidak menggunakan titik akhir ini. Untuk informasi selengkapnya, lihat [Mengakses tabel menggunakan endpoint Amazon S3 Iceberg REST Tables](s3-tables-integrating-open-source.md).
+ Pastikan Anda memiliki izin AWS Identity and Access Management (IAM) yang sesuai untuk menanyakan tabel metadata. Untuk informasi selengkapnya, lihat [Izin untuk menanyakan tabel metadata](metadata-tables-bucket-query-permissions.md).
+ Jika Anda menggunakan Amazon Athena dan menerima kesalahan saat mencoba menjalankan kueri, lakukan hal berikut:
+ Jika Anda menerima kesalahan “Izin tidak cukup untuk menjalankan kueri. Principal tidak memiliki hak istimewa pada sumber daya tertentu “ketika Anda mencoba menjalankan kueri di Athena, Anda harus diberikan izin Formasi Danau yang diperlukan di atas meja. Untuk informasi selengkapnya, lihat [Memberikan izin Lake Formation di atas meja atau database](grant-permissions-tables.md#grant-lf-table).
+ Jika Anda menerima kesalahan “Gunung es tidak dapat mengakses sumber daya yang diminta” ketika Anda mencoba menjalankan kueri, buka AWS Lake Formation konsol dan pastikan bahwa Anda telah memberikan diri Anda izin pada katalog keranjang tabel dan database (namespace) yang Anda buat. Jangan tentukan tabel saat memberikan izin ini. Untuk informasi selengkapnya, lihat [Memberikan izin Lake Formation di atas meja atau database](grant-permissions-tables.md#grant-lf-table).
## Saya menerima 405 kesalahan ketika saya mencoba menggunakan perintah Metadata AWS CLI S3 dan operasi API tertentu
Memanggil operasi `GetBucketMetadataTableConfiguration` API V1 atau menggunakan perintah `get-bucket-metadata-table-configuration` AWS Command Line Interface (AWS CLI) terhadap konfigurasi tabel metadata V2 menghasilkan kesalahan HTTP. `405 Method Not Allowed` Demikian juga, memanggil operasi `DeleteBucketMetadataTableConfiguration` API V1 atau menggunakan `delete-bucket-metadata-table-configuration` AWS CLI perintah juga menyebabkan kesalahan 405.
Anda dapat menggunakan operasi V2 `GetBucketMetadataConfiguration` API atau `get-bucket-metadata-configuration` AWS CLI perintah terhadap konfigurasi tabel metadata V1 atau V2. Demikian juga, Anda dapat menggunakan operasi V2 `DeleteBucketMetadataConfiguration` API atau `delete-bucket-metadata-configuration` AWS CLI perintah terhadap konfigurasi tabel metadata V1 atau V2.
Sebaiknya perbarui proses Anda untuk menggunakan operasi API V2 baru (`CreateBucketMetadataConfiguration``GetBucketMetadataConfiguraion`,, dan`DeleteBucketMetadataConfiguration`) alih-alih operasi API V1. Untuk informasi selengkapnya tentang migrasi dari V1 Metadata S3 ke V2, lihat. [Mengaktifkan tabel inventaris pada konfigurasi metadata yang dibuat sebelum 15 Juli 2025](metadata-tables-create-configuration.md#metadata-tables-migration)
Untuk menentukan apakah konfigurasi Anda adalah V1 atau V2, Anda dapat melihat atribut respons `GetBucketMetadataConfiguration` API berikut. Tipe bucket AWS terkelola (`"aws"`) menunjukkan konfigurasi V2, dan bucket type (`"customer"`) yang dikelola pelanggan menunjukkan konfigurasi V1.
```
"MetadataTableConfigurationResult": {
"TableBucketType": ["aws" | "customer"]
```
Untuk informasi selengkapnya, lihat [Melihat konfigurasi tabel metadata](metadata-tables-view-configuration.md).