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

# Kueri memulihkan objek Amazon Glacier
<a name="querying-glacier"></a>

[Anda dapat menggunakan Athena untuk menanyakan objek yang dipulihkan dari Amazon Glacier Flexible Retrieval (sebelumnya Glacier) dan Amazon Glacier Deep Archive kelas penyimpanan Amazon S3.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html#sc-glacier) Anda harus mengaktifkan kemampuan ini berdasarkan per tabel. Jika Anda tidak mengaktifkan fitur pada tabel sebelum menjalankan kueri, Athena melewatkan semua objek Amazon Glacier Flexible Retrieval dan Amazon Glacier Deep Archive tabel selama eksekusi kueri. 

## Pertimbangan dan batasan
<a name="querying-glacier-considerations-and-limitations"></a>
+  Menanyakan objek Amazon 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
<a name="querying-glacier-configuring-a-table-to-use-restored-objects"></a>

 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 konsol. AWS Glue [Anda juga dapat menggunakan [AWS Glue CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/update-table.html), [AWS Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-catalog-tables.html#aws-glue-api-catalog-tables-UpdateTable), atau SDK AWS Glue .](https://docs.aws.amazon.com/glue/latest/dg/sdk-general-information-section.html) 

### Gunakan editor kueri Athena
<a name="querying-glacier-using-the-athena-query-editor"></a>

 Di Athena, Anda dapat menggunakan [ALTER TABLE SET TBLPROPERTIES](alter-table-set-tblproperties.md) perintah untuk mengatur properti tabel, seperti pada contoh berikut. 

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

### Gunakan AWS Glue konsol
<a name="querying-glacier-using-the-aws-glue-console"></a>

 Di AWS Glue konsol, lakukan langkah-langkah berikut untuk menambahkan properti `read_restored_glacier_objects` tabel. 

**Untuk mengkonfigurasi properti tabel di AWS Glue konsol**

1. Masuk ke Konsol Manajemen AWS dan buka AWS Glue konsol di [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/).

1. Lakukan salah satu tindakan berikut:
   + Pilih **Buka Katalog Data**.
   + Di panel navigasi, pilih **tabel Katalog Data**.

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

1. Pilih **Tindakan**, **Edit tabel**.

1. Pada halaman **Edit tabel**, di bagian **properti Tabel**, tambahkan pasangan kunci-nilai berikut.
   + Untuk **Kunci**, tambahkan`read_restored_glacier_objects`.
   + Untuk **Nilai**, masukkan `true`.

1. Pilih **Simpan**.

### Gunakan AWS CLI
<a name="querying-glacier-using-the-aws-cli"></a>

 Dalam AWS CLI, Anda dapat menggunakan perintah AWS Glue [update-table](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glue/update-table.html) 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 nilai`true`. 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}} dan {{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**  
 AWS Glue `update-table`Perintah 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.