Kueri memulihkan objek Amazon S3 Glacier

Anda dapat menggunakan Athena untuk menanyakan objek yang dipulihkan dari kelas penyimpanan Amazon S3 Glacier Flexible Retrieval (sebelumnya Glacier) dan S3 Glacier Deep Archive kelas penyimpanan Amazon S3. Anda harus mengaktifkan kemampuan ini berdasarkan per tabel. Jika Anda tidak mengaktifkan fitur pada tabel sebelum menjalankan kueri, Athena melewatkan semua objek S3 Glacier Flexible Retrieval dan S3 Glacier Deep Archive tabel selama eksekusi kueri.

Pertimbangan dan batasan

• Menanyakan objek Amazon S3 Glacier yang dipulihkan hanya didukung pada mesin Athena versi 3.

• Fitur ini hanya didukung untuk tabel Apache Hive.

• Anda harus memulihkan objek Anda sebelum Anda menanyakan data Anda; Athena tidak mengembalikan objek untuk Anda.

Konfigurasikan tabel untuk menggunakan objek yang dipulihkan

Untuk mengonfigurasi tabel Athena Anda untuk menyertakan objek yang dipulihkan dalam kueri Anda, Anda harus mengatur properti read_restored_glacier_objects tabelnya. true Untuk melakukan ini, Anda dapat menggunakan editor kueri Athena atau AWS Glue konsol. Anda juga dapat menggunakan AWS Glue CLI, AWS Glue API, atau AWS Glue SDK.

Gunakan editor kueri Athena

Di Athena, Anda dapat menggunakan ALTER TABLE SET TBLPROPERTIES perintah untuk mengatur properti tabel, seperti pada contoh berikut.

ALTER TABLE table_name SET TBLPROPERTIES ('read_restored_glacier_objects' = 'true')

Gunakan AWS Glue konsol

Dalam AWS Glue konsol, melakukan langkah-langkah berikut untuk menambahkan properti read_restored_glacier_objects tabel.

Untuk mengkonfigurasi properti tabel di AWS Glue konsol

1. Masuk ke AWS Management Console dan buka AWS Glue konsol di https://console.aws.amazon.com/glue/.

2. Lakukan salah satu hal berikut ini:

   • Pilih Buka Katalog Data.

   • Di panel navigasi, pilih tabel Katalog Data.

3. Pada halaman Tabel, dalam daftar tabel, pilih tautan untuk tabel yang ingin Anda edit.

4. Pilih Tindakan, Edit tabel.

5. Pada halaman Edit tabel, di bagian properti Tabel, tambahkan pasangan kunci-nilai berikut.

   • Untuk Kunci, tambahkanread_restored_glacier_objects.

   • Untuk Nilai, masukkan true.

6. Pilih Simpan.

Gunakan AWS CLI

Dalam AWS CLI, Anda dapat menggunakan AWS Glue perintah update-table dan --table-input argumennya untuk mendefinisikan ulang tabel dan dengan demikian menambahkan properti. read_restored_glacier_objects Dalam --table-input argumen, gunakan Parameters struktur untuk menentukan read_restored_glacier_objects properti dan nilaitrue. Perhatikan bahwa argumen untuk tidak --table-input harus memiliki spasi dan harus menggunakan garis miring terbalik untuk menghindari tanda kutip ganda. Dalam contoh berikut, ganti my_database and my_table dengan nama database dan tabel Anda.

aws glue update-table \
   --database-name my_database \
   --table-input={\"Name\":\"my_table\",\"Parameters\":{\"read_restored_glacier_objects\":\"true\"}}

penting

Bagian AWS Glue update-tableperintah bekerja dalam mode overwrite, yang berarti menggantikan definisi tabel yang ada dengan definisi baru yang ditentukan oleh parameter. table-input Untuk alasan ini, pastikan untuk juga menentukan semua bidang yang Anda inginkan dalam tabel Anda dalam table-input parameter ketika Anda menambahkan read_restored_glacier_objects properti.