Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemeliharaan Tabel S3
Amazon S3 secara otomatis melakukan pemeliharaan untuk meningkatkan kinerja tabel Anda di bucket tabel S3. Pemeliharaan dilakukan di ember meja dan tingkat meja individu dan meliputi yang berikut:
**Perawatan tingkat ember meja:**
+ **Penghapusan file yang tidak direferensikan** - Membersihkan file yatim piatu untuk mengoptimalkan penggunaan dan biaya penyimpanan.
**Perawatan tingkat meja:**
+ **Pemadatan file** — Mengkonsolidasikan file kecil untuk meningkatkan kinerja kueri dan mengurangi biaya penyimpanan.
+ **Manajemen snapshot** — Mengontrol riwayat versi tabel dan mencegah pertumbuhan metadata yang berlebihan.
Opsi ini diaktifkan secara default. Anda dapat mengedit atau menonaktifkan operasi ini melalui file konfigurasi pemeliharaan.
Selain opsi ini, Anda juga dapat mengaktifkan dan mengonfigurasi pengaturan kedaluwarsa rekaman untuk tabel. Dengan opsi ini, Amazon S3 secara otomatis menghapus catatan dari tabel saat catatan kedaluwarsa.
**Topics**
+ [Status pekerjaan pemeliharaan Tabel S3](s3-tables-maintenance-status.md)
+ [Perawatan untuk ember meja](s3-table-buckets-maintenance.md)
+ [Pemeliharaan untuk tabel](s3-tables-maintenance.md)
+ [Rekam kedaluwarsa untuk tabel](s3-tables-record-expiration.md)
+ [Pertimbangan dan batasan untuk pekerjaan pemeliharaan](s3-tables-considerations.md)
# Status pekerjaan pemeliharaan Tabel S3
Pekerjaan pemeliharaan Tabel S3 berjalan secara berkala untuk tabel S3 atau ember meja Anda. Anda dapat menanyakan status pekerjaan ini dengan `GetTableMaintenanceJobStatus` API.
**Untuk mendapatkan status pekerjaan pemeliharaan Anda dengan menggunakan AWS CLI**
Contoh berikut akan mendapatkan status pekerjaan pemeliharaan menggunakan `GetTableMaintenanceJobStatus` API.
```
aws s3tables get-table-maintenance-job-status \
--table-bucket-arn="arn:aws:s3tables:arn:aws::111122223333:bucket/amzn-s3-demo-bucket1" \
--namespace="mynamespace" \
--name="testtable"
```
Untuk informasi selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html) dalam *AWS CLI Referensi Perintah*.
Pekerjaan pemeliharaan Tabel S3 dapat bertransisi di antara empat kemungkinan status:
+ `Successful`
+ `Failed`
+ `Disabled`
+ `Not_Yet_Run`
Pekerjaan dengan status gagal akan menyertakan pesan kegagalan. Daftar berikut menjelaskan kemungkinan pesan kegagalan.
+ Mengalami pengecualian validasi Iceberg saat mencoba membaca tabel. Pastikan tabel Anda dapat dibaca, mematuhi spesifikasi Iceberg, dan hanya berisi jalur S3 yang dimulai dengan alias Tabel S3 Anda.
+ Manajemen Iceberg Snapshot saat ini tidak mendukung tag atau referensi yang ditentukan pengguna.
+ Konfigurasi pemeliharaan tabel Iceberg tidak kompatibel dengan 'history.expire. max-snapshot-age-ms' dan 'history.expire. min-snapshots-to-keep' properti tabel.
+ Manajemen snapshot gunung es dan penghapusan file yang tidak direferensikan tidak didukung ketika properti tabel 'gc.enabled' salah. Pastikan properti ini tidak disetel atau disetel secara eksplisit ke true.
+ Gagal melakukan komit karena metadata kedaluwarsa. Pemeliharaan akan dicoba lagi pada kesempatan berikutnya yang tersedia.
+ Akses yang tidak memadai untuk melakukan pemeliharaan meja. Pastikan kunci yang digunakan untuk mengenkripsi tabel aktif, ada, dan memiliki kebijakan sumber daya yang memberikan akses ke prinsipal layanan S3. `maintenance.s3tables.amazonaws.com`
**catatan**
Untuk informasi selengkapnya tentang AWS KMS izin untuk Tabel S3, lihat. [Persyaratan izin untuk enkripsi SSE-KMS Tabel S3](s3-tables-kms-permissions.md)
+ Kesalahan internal
# Perawatan untuk ember meja
Amazon S3 menawarkan operasi pemeliharaan untuk meningkatkan manajemen dan kinerja bucket meja Anda. Opsi berikut diaktifkan secara default untuk semua bucket tabel. Anda dapat mengedit atau menonaktifkan opsi ini dengan menentukan file konfigurasi pemeliharaan untuk bucket tabel Anda.
Mengedit konfigurasi ini memerlukan `s3tables:PutTableBucketMaintenanceConfiguration` izin.
**Topics**
+ [Penghapusan file yang tidak direferensikan](#s3-table-bucket-maintenance-unreferenced)
+ [Pertimbangan dan keterbatasan](#s3-tables-buckets-considerations-see-more)
## Penghapusan file yang tidak direferensikan
Penghapusan file yang tidak direferensikan mengidentifikasi dan menghapus semua objek yang tidak direferensikan oleh snapshot tabel apa pun. Sebagai bagian dari kebijakan penghapusan file yang tidak direferensikan, Anda dapat mengonfigurasi dua properti: `unreferencedDays` (3 hari secara default) dan `nonCurrentDays` (10 hari secara default).
Untuk objek apa pun yang tidak direferensikan oleh tabel Anda dan lebih tua dari `unreferencedDays` properti, S3 menandai objek sebagai noncurrent. S3 menghapus objek noncurrent setelah jumlah hari yang ditentukan oleh properti. `nonCurrentDays`
**catatan**
Penghapusan objek noncurrent bersifat permanen tanpa cara untuk memulihkan objek ini.
Untuk melihat atau memulihkan objek yang telah ditandai sebagai noncurrent, Anda harus menghubungi AWS Dukungan. Untuk informasi tentang menghubungi AWS Dukungan, lihat [Kontak AWS](https://aws.amazon.com/contact-us/) atau [AWS Dukungan Dokumentasi](https://aws.amazon.com/documentation/aws-support/).
Penghapusan file yang tidak direferensikan menentukan objek yang akan dihapus dari tabel Anda dengan referensi hanya ke tabel itu. Referensi apa pun yang dibuat untuk objek-objek ini di luar tabel tidak akan mencegah penghapusan file yang tidak direferensikan dari menghapus objek.
Jika Anda menonaktifkan penghapusan file yang tidak direferensikan, pekerjaan apa pun yang sedang berlangsung tidak akan terpengaruh. Konfigurasi baru akan berlaku untuk pekerjaan berikutnya setelah perubahan konfigurasi. Untuk informasi selengkapnya, lihat informasi harga di harga [Amazon S3](https://aws.amazon.com/s3/pricing/).
Anda hanya dapat mengonfigurasi penghapusan file yang tidak direferensikan di tingkat bucket tabel. Konfigurasi ini akan berlaku untuk setiap tabel di bucket Anda.
**Untuk mengkonfigurasi penghapusan file yang tidak direferensikan dengan menggunakan AWS CLI**
Contoh berikut akan mengatur `unreferencedDays` ke 4 hari dan `nonCurrentDays` ke 10 hari menggunakan `PutTableBucketMaintenanceConfiguration` API.
```
aws s3tables put-table-bucket-maintenance-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
--type icebergUnreferencedFileRemoval \
--value '{"status":"enabled","settings":{"icebergUnreferencedFileRemoval":{"unreferencedDays":4,"nonCurrentDays":10}}}'
```
Untuk informasi selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-bucket-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-bucket-maintenance-configuration.html) dalam *AWS CLI Referensi Perintah*.
## Pertimbangan dan keterbatasan
Untuk mempelajari lebih lanjut tentang pertimbangan dan batasan tambahan untuk penghapusan file yang tidak direferensikan, lihat. [Pertimbangan dan batasan untuk pekerjaan pemeliharaan](s3-tables-considerations.md)
# Pemeliharaan untuk tabel
Tabel S3 menawarkan operasi pemeliharaan untuk meningkatkan manajemen dan kinerja tabel individual Anda. Opsi berikut diaktifkan secara default untuk semua tabel di bucket tabel. Anda dapat mengedit atau menonaktifkannya dengan menentukan file konfigurasi pemeliharaan untuk tabel S3 Anda.
Mengedit konfigurasi ini membutuhkan `s3tables:PutTableMaintenanceConfiguration` izin `s3tables:GetTableMaintenanceConfiguration` dan.
**catatan**
Anda dapat melacak operasi pemeliharaan otomatis Tabel S3 pada tabel Anda melalui CloudTrail log, untuk informasi selengkapnya, lihat[CloudTrail acara manajemen untuk pemeliharaan Tabel S3](s3-tables-logging.md#s3-tables-maintenance-events).
**Topics**
+ [Pemadatan](#s3-tables-maintenance-compaction)
+ [Manajemen snapshot](#s3-tables-maintenance-snapshot)
+ [Pertimbangan dan keterbatasan](#s3-tables-considerations-see-more)
## Pemadatan
Pemadatan dikonfigurasi pada tingkat tabel dan menggabungkan beberapa objek yang lebih kecil menjadi objek yang lebih sedikit dan lebih besar untuk meningkatkan kinerja Apache Iceberg kueri. Saat menggabungkan objek, pemadatan juga menerapkan efek penghapusan tingkat baris di tabel Anda.
Pemadatan diaktifkan secara default untuk semua tabel, dengan ukuran file target default 512MB, atau nilai kustom yang Anda tentukan antara 64MB hingga 512MB. File yang dipadatkan ditulis sebagai snapshot terbaru dari tabel Anda.
**catatan**
Pemadatan didukung padaApache Parquet,Avro, dan jenis ORC file.
### Strategi Pemadatan
Anda dapat memilih dari beberapa strategi pemadatan yang selanjutnya dapat meningkatkan kinerja kueri tergantung pada pola kueri dan urutan urutan tabel Anda.
Tabel S3 mendukung strategi pemadatan ini untuk tabel:
+ **Otomatis (Default)**
+ Amazon S3 memilih strategi pemadatan terbaik berdasarkan urutan pengurutan tabel Anda. Ini adalah strategi pemadatan default untuk semua tabel.
+ Untuk tabel dengan urutan pengurutan yang ditentukan dalam metadata mereka, secara otomatis `auto` akan menerapkan `sort` pemadatan.
+ Untuk tabel tanpa urutan pengurutan, `auto` akan default menggunakan `binpack` pemadatan.
+ **Binpack**
+ Menggabungkan file kecil menjadi file yang lebih besar, biasanya menargetkan ukuran lebih dari 100MB, sambil menerapkan penghapusan yang tertunda. Ini adalah strategi pemadatan default untuk tabel yang tidak disortir.
+ **Urutkan**
+ Mengatur data berdasarkan kolom tertentu yang diurutkan secara otomatis berdasarkan hierarki selama pemadatan, meningkatkan kinerja kueri untuk operasi yang difilter. Strategi ini direkomendasikan ketika kueri Anda sering memfilter pada kolom tertentu. Saat Anda menggunakan strategi ini, Tabel S3 secara otomatis menerapkan pengurutan hierarkis pada kolom saat a `sort_order` didefinisikan dalam properti tabel.
+ **Urutan Z**
+ Mengoptimalkan organisasi data dengan memadukan beberapa atribut ke dalam nilai skalar tunggal yang dapat digunakan untuk menyortir, memungkinkan kueri yang efisien di berbagai dimensi. Strategi ini direkomendasikan ketika Anda perlu melakukan kueri data di beberapa dimensi secara bersamaan. Strategi ini mengharuskan Anda untuk menentukan urutan pengurutan di properti tabel Iceberg Anda menggunakan properti `sort_order` tabel.
Pemadatan akan dikenakan biaya tambahan. Strategi `z-order` dan `sort` pemadatan dapat menimbulkan biaya yang lebih tinggi daripada. `binpack` Untuk informasi selengkapnya, lihat informasi harga di. [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
### Contoh Pemadatan
Contoh berikut menunjukkan konfigurasi untuk pemadatan tabel.
**Untuk mengkonfigurasi ukuran file target pemadatan dengan menggunakan AWS CLI**
Ukuran file pemadatan target minimum adalah 64MB; maksimum adalah 512MB.
Contoh berikut akan mengubah ukuran file target menjadi 256MB menggunakan API. `PutTableMaintenanceConfiguration`
```
aws s3tables put-table-maintenance-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1 \
--type icebergCompaction \
--namespace mynamespace \
--name testtable \
--value='{"status":"enabled","settings":{"icebergCompaction":{"targetFileSizeMB":256}}}'
```
Untuk informasi selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) dalam *AWS CLI Referensi Perintah*.
**Untuk mengkonfigurasi strategi pemadatan dengan menggunakan AWS CLI**
Contoh berikut akan mengubah strategi pemadatan untuk `sort` menggunakan `PutTableMaintenanceConfiguration` API. Saat mengatur pemadatan, Anda dapat memilih dari strategi pemadatan berikut:`auto`,,`binpack`, `sort` atau `z-order`
Untuk mengatur strategi pemadatan ke `sort` atau `z-order` Anda memerlukan prasyarat berikut:
+ Urutan pengurutan yang ditentukan dalam properti Iceberg tabel Anda.
+ `s3tables:GetTableData`Izin.
```
aws s3tables put-table-maintenance-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
--type icebergCompaction \
--namespace mynamespace \
--name testtable \
--value='{"status":"enabled","settings":{"icebergCompaction":{"strategy":"sort"}}}'
```
Untuk informasi selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) dalam *AWS CLI Referensi Perintah*.
**Untuk menonaktifkan pemadatan dengan menggunakan AWS CLI**
Contoh berikut akan menonaktifkan pemadatan menggunakan `PutTableMaintenanceConfiguration` API.
```
aws s3tables put-table-maintenance-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
--type icebergCompaction \
--namespace mynamespace \
--name testtable \
--value='{"status":"disabled","settings":{"icebergCompaction":{"targetFileSizeMB":256}}}'
```
Untuk informasi selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) dalam *AWS CLI Referensi Perintah*.
## Manajemen snapshot
Manajemen snapshot menentukan jumlah snapshot aktif untuk tabel Anda. Ini didasarkan pada `MinimumSnapshots` (1 secara default) dan `MaximumSnapshotAge` (120 jam secara default). Manajemen snapshot kedaluwarsa dan menghapus snapshot tabel berdasarkan konfigurasi ini.
Saat snapshot kedaluwarsa, Amazon S3 menandai objek apa pun yang hanya direferensikan oleh snapshot itu sebagai noncurrent. Objek noncurrent ini dihapus setelah jumlah hari yang ditentukan oleh `NoncurrentDays` properti dalam kebijakan penghapusan file yang tidak direferensikan.
**catatan**
Penghapusan objek noncurrent bersifat permanen tanpa cara untuk memulihkan objek ini.
Untuk melihat atau memulihkan objek yang telah ditandai sebagai noncurrent, Anda harus menghubungi AWS Dukungan. Untuk informasi tentang menghubungi AWS Dukungan, lihat [Kontak AWS](https://aws.amazon.com/contact-us/) atau [AWS Dukungan Dokumentasi](https://aws.amazon.com/documentation/aws-support/).
Manajemen snapshot menentukan objek yang akan dihapus dari tabel Anda dengan referensi hanya ke tabel itu. Referensi ke objek-objek ini dari luar tabel tidak akan mencegah manajemen snapshot menghapusnya.
**catatan**
Manajemen snapshot tidak mendukung nilai retensi yang Anda konfigurasikan sebagai properti tabel Iceberg dalam `metadata.json` file atau melalui perintah `ALTER TABLE SET TBLPROPERTIES` SQL, termasuk retensi berbasis cabang atau tag. Manajemen snapshot dinonaktifkan saat Anda mengonfigurasi kebijakan penyimpanan berbasis cabang atau tag, atau mengonfigurasi kebijakan penyimpanan pada `metadata.json` file yang lebih panjang dari nilai yang dikonfigurasi melalui API. `PutTableMaintenanceConfiguration` Dalam kasus ini S3 tidak akan kedaluwarsa atau menghapus snapshot dan Anda perlu menghapus snapshot secara manual atau menghapus properti dari tabel Iceberg Anda untuk menghindari biaya penyimpanan.
Anda hanya dapat mengonfigurasi manajemen snapshot di tingkat tabel. Untuk informasi selengkapnya, lihat informasi harga di harga [Amazon S3](https://aws.amazon.com/s3/pricing/).
### Contoh Manajemen Snapshot
Contoh berikut menunjukkan konfigurasi untuk manajemen snapshot tabel.
**Untuk mengkonfigurasi manajemen snapshot dengan menggunakan AWS CLI**
Contoh berikut akan mengatur `MinimumSnapshots` ke 10 dan 2500 jam menggunakan `PutTableMaintenanceConfiguration` API. `MaximumSnapshotAge`
```
aws s3tables put-table-maintenance-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
--namespace my_namespace \
--name my_table \
--type icebergSnapshotManagement \
--value '{"status":"enabled","settings":{"icebergSnapshotManagement":{"minSnapshotsToKeep":10,"maxSnapshotAgeHours":2500}}}'
```
**Untuk menonaktifkan manajemen snapshot dengan menggunakan AWS CLI**
Contoh berikut akan menonaktifkan manajemen snapshot menggunakan `PutTableMaintenanceConfiguration` API.
```
aws s3tables put-table-maintenance-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
--namespace my_namespace \
--name my_table \
--type icebergSnapshotManagement \
--value '{"status":"disabled","settings":{"icebergSnapshotManagement":{"minSnapshotsToKeep":1,"maxSnapshotAgeHours":120}}}'
```
Untuk informasi selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) dalam *AWS CLI Referensi Perintah*.
## Pertimbangan dan keterbatasan
Untuk mempelajari lebih lanjut tentang pertimbangan dan batasan tambahan untuk manajemen pemadatan dan snapshot, lihat. [Pertimbangan dan batasan untuk pekerjaan pemeliharaan](s3-tables-considerations.md)
**catatan**
Tabel S3 menerapkan row-group-default ukuran parket 128 MB.
# Rekam kedaluwarsa untuk tabel
Secara default, catatan dalam tabel S3 Anda tidak kedaluwarsa. Untuk membantu meminimalkan biaya penyimpanan untuk tabel Anda, Anda dapat mengaktifkan dan mengonfigurasi kedaluwarsa rekaman untuk tabel. Dengan opsi ini, Amazon S3 secara otomatis menghapus catatan dari tabel saat catatan kedaluwarsa.
Jika Anda mengaktifkan kedaluwarsa rekaman untuk tabel, Anda menentukan jumlah hari untuk menyimpan catatan dalam tabel sebelum catatan kedaluwarsa. Ini bisa berupa jumlah hari mulai dari 1 hari hingga 2.147.483.647 hari. Misalnya, untuk menyimpan catatan tabel selama satu tahun, tentukan `365` hari. Catatan kemudian bertahan selama 365 hari. Setelah 365 hari, catatan kedaluwarsa dan Amazon S3 secara otomatis menghapusnya.
Anda dapat mengaktifkan dan mengonfigurasi kedaluwarsa rekaman untuk tabel AWS terkelola yang menyimpan kumpulan data tertentu Layanan AWS dari Lensa Penyimpanan Amazon S3 dan Katalog Amazon tertentu saat ini. SageMaker Opsi kedaluwarsa rekaman saat ini tidak tersedia untuk tabel AWS terkelola lainnya. Pengecualiannya adalah tabel jurnal metadata Amazon S3. Tabel jurnal menggunakan setelan kedaluwarsa rekaman berbeda yang Anda tentukan di tingkat layanan. Untuk informasi tentang mengonfigurasi kedaluwarsa rekaman untuk jenis tabel ini, lihat. [Catatan tabel jurnal yang kedaluwarsa](metadata-tables-expire-journal-table-records.md) Perhatikan bahwa opsi kedaluwarsa rekaman tidak tersedia untuk tabel S3 yang Anda buat.
Setelah Anda mengaktifkan rekaman kedaluwarsa untuk tabel, Anda dapat menonaktifkannya kapan saja. Amazon S3 kemudian berhenti kedaluwarsa dan menghapus catatan dari tabel.
**Topics**
+ [Cara kerjanya](#s3-tables-record-expiration-how-it-works)
+ [Mengonfigurasi kedaluwarsa catatan](#s3-tables-record-expiration-configure)
+ [Memantau kedaluwarsa catatan](#s3-tables-record-expiration-monitor)
+ [Pertimbangan-pertimbangan](#s3-tables-expiration-considerations)
## Cara kerja kedaluwarsa rekaman
Kedaluwarsa rekaman secara otomatis menghapus catatan dari tabel S3 ketika catatan lebih tua dari jumlah hari yang Anda tentukan dalam pengaturan kedaluwarsa rekaman untuk tabel. Untuk menentukan kapan catatan kedaluwarsa, Amazon S3 menggunakan stempel waktu tertentu dalam catatan. Pilihan kolom timestamp berasal langsung dari skema tabel untuk tabel. Anda tidak perlu menentukan kolom timestamp mana yang akan digunakan. Tabel dikelola oleh AWS dan Amazon S3 secara otomatis memilih kolom yang sesuai untuk digunakan saat Anda mengaktifkan kedaluwarsa rekaman untuk tabel.
Anda dapat mengaktifkan dan mengonfigurasi setelan kedaluwarsa rekaman untuk tabel AWS terkelola yang menyimpan metrik Lensa Penyimpanan Amazon S3 tertentu atau metadata Katalog Amazon tertentu SageMaker . Opsi kedaluwarsa rekaman tersedia untuk tabel AWS terkelola berikut untuk layanan tersebut:
+ Lensa Penyimpanan S3 —`bucket_property_metrics`,`default_activity_metrics`,, `default_storage_metrics``expanded_prefixes_activity_metrics`, dan`expanded_prefixes_storage_metrics`. Untuk menentukan kapan catatan dalam tabel ini kedaluwarsa, Amazon S3 menggunakan bidang `report_time` dalam catatan.
+ SageMaker Katalog Amazon —`ASSET`. Untuk menentukan kapan catatan dalam tabel ini kedaluwarsa, Amazon S3 menggunakan bidang `snapshot_time` dalam catatan.
Setelah Anda mengaktifkan kedaluwarsa rekaman untuk tabel, Amazon S3 mulai menjalankan tugas kedaluwarsa rekaman yang melakukan operasi berikut untuk tabel:
1. Identifikasi catatan yang lebih tua dari pengaturan kedaluwarsa yang ditentukan.
1. Buat snapshot baru yang mengecualikan referensi ke catatan kedaluwarsa.
Penghapusan juga didasarkan pada kedaluwarsa snapshot dan pengaturan penghapusan file yang tidak direferensikan dalam pengaturan konfigurasi pemeliharaan untuk tabel. Untuk mempelajari lebih lanjut tentang pengaturan ini, lihat[Pemeliharaan untuk tabel](s3-tables-maintenance.md).
**Awas**
Amazon S3 kedaluwarsa dan menghapus catatan dalam waktu 24 hingga 48 jam setelah catatan memenuhi syarat untuk kedaluwarsa. Catatan tabel dihapus dari snapshot terbaru. Data dan penyimpanan untuk catatan dihapus melalui operasi pemeliharaan tabel. Catatan tabel tidak dapat dipulihkan setelah kedaluwarsa.
## Mengonfigurasi kedaluwarsa rekaman untuk tabel
Anda dapat mengaktifkan, mengonfigurasi, dan mengelola setelan kedaluwarsa rekaman untuk tabel S3 dengan menggunakan konsol Amazon S3, Amazon S3 REST API, (), atau. AWS Command Line Interface AWS CLI AWS SDKs
Sebelum Anda mencoba melakukan tugas-tugas ini untuk sebuah tabel, pastikan Anda memiliki izin AWS Identity and Access Management (IAM) berikut:
+ `s3tables:GetTableRecordExpirationConfiguration`— Tindakan ini memungkinkan Anda untuk mengakses pengaturan kedaluwarsa rekaman saat ini untuk tabel.
+ `s3tables:PutTableRecordExpirationConfiguration`— Tindakan ini memungkinkan Anda untuk mengaktifkan, mengkonfigurasi, dan menonaktifkan pengaturan kedaluwarsa rekaman untuk tabel.
+ `s3tables:GetTableRecordExpirationJobStatus`— Tindakan ini memungkinkan Anda untuk memantau status operasi kedaluwarsa rekaman (pekerjaan) untuk tabel dan metrik akses untuk operasi.
Bagian berikut menjelaskan cara mengaktifkan, mengonfigurasi, dan menonaktifkan setelan kedaluwarsa rekaman untuk tabel dengan menggunakan konsol Amazon S3 dan. AWS CLI Untuk melakukan tugas ini dengan Amazon S3 REST API atau AWS SDK, gunakan operasi. [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_PutTableRecordExpirationConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_PutTableRecordExpirationConfiguration.html) Untuk informasi selengkapnya, lihat [Mengembangkan dengan Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/API/developing-s3.html) di Referensi *API Layanan Penyimpanan Sederhana Amazon*.
### Menggunakan konsol S3
Untuk mengaktifkan dan mengonfigurasi setelan kedaluwarsa rekaman untuk tabel S3 menggunakan konsol, ikuti langkah-langkah berikut.
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 tabel**.
1. Pada halaman **Table bucket**, pilih bucket yang menyimpan tabel.
1. Pada tab **Tabel**, pilih tabel.
1. **Pada tab **Maintenance**, di bagian **Record expiration**, pilih Edit.**
1. **Di bawah **Rekam kedaluwarsa**, pilih Aktifkan.**
1. Untuk **Hari setelah catatan kedaluwarsa**, masukkan jumlah hari untuk menyimpan catatan dalam tabel. Ini bisa berupa bilangan bulat mulai dari 1 hingga 2.147.483.647. Misalnya, untuk menyimpan catatan selama satu tahun, masukkan**365**.
**Awas**
Saat Anda menentukan periode retensi yang sesuai untuk catatan dalam tabel, perhatikan bahwa catatan tidak dapat dipulihkan setelah habis masa berlakunya.
1. Pilih **Simpan perubahan**.
Untuk selanjutnya mengubah periode retensi, ulangi langkah-langkah sebelumnya.
Untuk selanjutnya menonaktifkan kedaluwarsa rekaman, ulangi langkah 1 hingga 5. Kemudian, untuk langkah 6, pilih **Nonaktifkan**. Setelah selesai, pilih **Simpan perubahan**.
### Menggunakan AWS CLI
Untuk mengonfigurasi dan mengelola pengaturan kedaluwarsa rekaman untuk tabel S3 dengan menggunakan AWS CLI, jalankan perintah. [https://docs.aws.amazon.com/cli/latest/reference/s3tables/put-table-record-expiration-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/s3tables/put-table-record-expiration-configuration.html)
Anda dapat memulai dengan membuat file JSON yang berisi pengaturan kedaluwarsa catatan untuk diterapkan ke tabel. Contoh berikut menunjukkan isi dari file JSON yang memungkinkan rekaman kedaluwarsa untuk tabel. Ini juga menentukan periode retensi 30 hari untuk catatan dalam tabel. Dengan kata lain, ini menentukan bahwa catatan tabel harus kedaluwarsa setelah 30 hari.
```
{
"status": "enabled",
"settings": {
"days": 30
{
}
```
Untuk menggunakan contoh sebelumnya, ganti `user input placeholders` dengan informasi Anda sendiri.
**Awas**
Saat Anda menentukan periode retensi yang sesuai untuk catatan dalam tabel, perhatikan bahwa catatan tidak dapat dipulihkan setelah habis masa berlakunya.
Untuk menonaktifkan kedaluwarsa rekaman untuk tabel, tentukan `disabled` `status` bidang dan hilangkan `settings` objek dari file. Contoh:
```
{
"status": "disabled"
}
```
Setelah Anda membuat file JSON dengan pengaturan untuk diterapkan, jalankan `put-table-record-expiration-configuration` perintah. Untuk `table-arn` parameter, tentukan Nama Sumber Daya Amazon (ARN) dari tabel. Untuk `value` parameter, tentukan nama file yang menyimpan pengaturan.
Misalnya, perintah berikut memperbarui pengaturan kedaluwarsa rekaman untuk tabel. Pengaturan ditentukan dalam file bernama*`record-expiration-config.json`*.
```
aws s3tables put-table-record-expiration-configuration \
--table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table \
--value file://./record-expiration-config.json
```
Untuk menggunakan contoh sebelumnya, ganti `user input placeholders` dengan informasi Anda sendiri.
## Memantau kedaluwarsa catatan untuk tabel
Untuk memantau status dan hasil operasi kedaluwarsa rekaman untuk tabel S3 Anda, gunakan [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_GetTableRecordExpirationJobStatus.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_GetTableRecordExpirationJobStatus.html)operasi atau, jika Anda menggunakan AWS CLI, jalankan perintah. [https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-record-expiration-job-status.html](https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-record-expiration-job-status.html) Dalam permintaan Anda, tentukan Nama Sumber Daya Amazon (ARN) dari tabel.
Misalnya, AWS CLI perintah berikut mengambil status operasi kedaluwarsa rekaman untuk tabel tertentu dalam keranjang tabel. Untuk menggunakan contoh ini, ganti `user input placeholders`dengan informasi Anda sendiri.
```
aws s3tables get-table-record-expiration-job-status \
--table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table
```
Jika permintaan Anda berhasil, Anda menerima respons yang memberikan detail seperti saat Amazon S3 baru-baru ini menjalankan operasi kedaluwarsa rekaman untuk tabel dan status proses tersebut. Jika proses terbaru berhasil, respons juga mencakup metrik pemrosesan—misalnya, jumlah file data dan catatan yang dihapus, dan ukuran total data yang dihapus. Jika terjadi kesalahan selama proses terbaru, respons menyertakan pesan kegagalan yang menjelaskan mengapa proses gagal.
## Pertimbangan-pertimbangan
Saat Anda mengonfigurasi dan mengelola setelan kedaluwarsa rekaman untuk tabel S3 AWS terkelola, ingatlah hal berikut:
+ Kedaluwarsa rekaman hanya tersedia untuk tabel AWS terkelola tertentu yang dibuat oleh Lensa Penyimpanan Amazon S3 yang didukung Layanan AWS, dan Katalog Amazon. SageMaker Selain itu, catatan kedaluwarsa hanya tersedia untuk tabel individual, bukan seluruh ember tabel.
+ Untuk menentukan kapan catatan kedaluwarsa, Amazon S3 menggunakan stempel waktu tertentu dalam tabel. Stempel waktu ini mewakili kapan data dibuat, bukan saat Amazon S3 menelan catatan dalam tabel. Kolom stempel waktu yang digunakan bergantung pada layanan yang menerbitkan tabel: untuk metrik Lensa Penyimpanan S3, bidang; dan, untuk metadata SageMaker Katalog Amazon, `report_time` bidang tersebut. `snapshot_time` Anda tidak dapat menentukan bidang mana yang akan digunakan karena tabel dikelola oleh AWS.
+ Jika ada penundaan saat data diekspor ke tabel, catatan mungkin memenuhi syarat untuk kedaluwarsa lebih cepat dari yang Anda harapkan. Untuk alasan ini, kami menyarankan Anda memperhitungkan potensi penundaan konsumsi dengan menambahkan buffer ke periode retensi dalam pengaturan kedaluwarsa untuk tabel Anda.
+ Catatan kedaluwarsa dan dihapus dalam waktu 24 hingga 48 jam setelah memenuhi syarat untuk kedaluwarsa. Amazon S3 tidak kedaluwarsa dan menghapus catatan segera setelah memenuhi syarat untuk kedaluwarsa.
+ Catatan tidak dapat dipulihkan setelah kedaluwarsa dan dihapus.
# Pertimbangan dan batasan untuk pekerjaan pemeliharaan
Amazon S3 menawarkan operasi pemeliharaan untuk meningkatkan kinerja tabel S3 atau bucket meja Anda. Opsi ini adalah pemadatan file, manajemen snapshot, dan penghapusan file yang tidak direferensikan. Berikut ini adalah batasan dan pertimbangan untuk opsi manajemen ini.
**Topics**
+ [Pertimbangan untuk pemadatan](#s3-tables-compaction-considerations)
+ [Pertimbangan untuk manajemen snapshot](#s3-tables-snapshot-considerations)
+ [Pertimbangan untuk penghapusan file yang tidak direferensikan](#s3-tables-unreferenced-file-removal-considerations)
+ [Batas operasi pemeliharaan tabel dan ember meja S3 dan terkait APIs](#s3-tables-maintenance-limits)
## Pertimbangan untuk pemadatan
Pertimbangan berikut berlaku untuk pemadatan. Untuk informasi lebih lanjut tentang pemadatan, lihat[Pemeliharaan untuk tabel](s3-tables-maintenance.md).
+ Pemadatan didukung padaApache Parquet,Avro, dan jenis ORC file.
+ Compaction menulis file baru dalam Apache Parquet format secara default. Untuk memadatkan file ke dalam Avro atau ORC format sebagai gantinya, atur properti `write.format.default` tabel ke `avro` atau`orc`.
+ Pemadatan tidak mendukung tipe data:`Fixed`.
+ Pemadatan tidak mendukung jenis kompresi:`brotli`,`lz4`.
+ Pemadatan terjadi pada jadwal otomatis. Jika Anda ingin mencegah biaya yang terkait dengan pemadatan, Anda dapat menonaktifkannya secara manual untuk tabel menggunakan operasi [PutTableMaintenanceConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_PutTableMaintenanceConfiguration.html)API.
**catatan**
Apache Icebergmenggunakan model konkurensi optimis bersama dengan deteksi konflik untuk menengahi transaksi tulis. Dengan konkurensi optimis, transaksi pengguna dan pemadatan dapat menimbulkan konflik yang menyebabkan transaksi gagal. Jika konflik terjadi, pekerjaan pemadatan akan mencoba lagi pada kegagalan. Disarankan bahwa pipeline Anda juga menggunakan logika coba ulang untuk mengatasi transaksi yang gagal dari operasi yang bertentangan.
## Pertimbangan untuk manajemen snapshot
Pertimbangan berikut berlaku untuk manajemen snapshot. Untuk informasi selengkapnya tentang manajemen snapshot, lihat[Pemeliharaan untuk tabel](s3-tables-maintenance.md).
+ Snapshot akan dipertahankan hanya jika kedua kriteria terpenuhi: jumlah minimum snapshot yang harus disimpan dan periode retensi yang ditentukan.
+ Manajemen snapshot menghapus metadata snapshot kedaluwarsa dari Apache Iceberg, mencegah kueri perjalanan waktu untuk snapshot kedaluwarsa dan secara opsional menghapus file data terkait.
+ Manajemen snapshot tidak mendukung nilai retensi yang Anda konfigurasikan sebagai properti tabel Iceberg dalam `metadata.json` file atau melalui perintah `ALTER TABLE SET TBLPROPERTIES` SQL, termasuk retensi berbasis cabang atau tag. Manajemen snapshot dinonaktifkan saat Anda mengonfigurasi kebijakan penyimpanan berbasis cabang atau tag, atau mengonfigurasi kebijakan penyimpanan pada `metadata.json` file yang lebih panjang dari nilai yang dikonfigurasi melalui API. `PutTableMaintenanceConfiguration` Dalam kasus ini S3 tidak akan kedaluwarsa atau menghapus snapshot dan Anda perlu menghapus snapshot secara manual atau menghapus properti dari tabel Iceberg Anda untuk menghindari biaya penyimpanan.
## Pertimbangan untuk penghapusan file yang tidak direferensikan
Pertimbangan berikut berlaku untuk penghapusan file yang tidak direferensikan. Untuk informasi selengkapnya tentang penghapusan file yang tidak direferensikan, lihat. [Perawatan untuk ember meja](s3-table-buckets-maintenance.md)
+ Penghapusan file yang tidak direferensikan menghapus data dan file metadata yang tidak lagi direferensikan oleh metadata Iceberg jika waktu pembuatannya sebelum periode retensi.
## Batas operasi pemeliharaan tabel dan ember meja S3 dan terkait APIs
| Operasi pemeliharaan | Properti | Dapat dikonfigurasi pada tingkat ember meja? | Dapat dikonfigurasi di tingkat tabel? | Nilai default | Nilai minimum | Rutin Iceberg pemeliharaan terkait | Mengontrol API Tabel S3 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Pemadatan | targetFileSizeMB | Tidak | Ya | 512MB | 64MB | [https://iceberg.apache.org/docs/latest/maintenance/#compact-data-files](https://iceberg.apache.org/docs/latest/maintenance/#compact-data-files) | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html) |
| Manajemen snapshot | minimumSnapshots | Tidak | Ya | 1 | 1 | [https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots](https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots) retainLast | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html) |
| Manajemen snapshot | maximumSnapshotAge | Tidak | Ya | 120 jam | 1 jam | [https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots](https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots) expireOlderThan | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html) |
| Penghapusan file yang tidak direferensikan | unreferencedDays | Ya | Tidak | 3 hari | 1 hari | [https://iceberg.apache.org/docs/latest/maintenance/#delete-orphan-files](https://iceberg.apache.org/docs/latest/maintenance/#delete-orphan-files) | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html) |
| Penghapusan file yang tidak direferensikan | nonCurrentDays | Ya | Tidak | 10 hari | 1 hari | N/A | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html) |
**catatan**
Tabel S3 menerapkan row-group-default ukuran parket 128 MB.