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

# Bekerja dengan hasil kueri dan kueri terbaru


Amazon Athena secara otomatis menyimpan hasil kueri dan metadata hasil eksekusi kueri untuk setiap kueri yang berjalan di *lokasi hasil kueri* yang dapat Anda tentukan di Amazon S3. Jika perlu, Anda dapat mengakses file di lokasi ini untuk bekerja dengan mereka. Anda juga dapat mengunduh file hasil kueri langsung dari konsol Athena.

Athena sekarang menawarkan dua opsi untuk mengelola hasil kueri; Anda dapat menggunakan bucket S3 milik pelanggan atau memilih fitur hasil kueri terkelola. Dengan bucket Anda sendiri, Anda mempertahankan kontrol penuh atas penyimpanan, izin, kebijakan siklus hidup, dan retensi, memberikan fleksibilitas maksimum tetapi memerlukan lebih banyak manajemen. Atau, bila Anda memilih opsi hasil kueri terkelola, layanan akan secara otomatis menangani penyimpanan dan manajemen siklus hidup, sehingga tidak perlu mengonfigurasi bucket hasil terpisah dan secara otomatis membersihkan hasil setelah periode retensi yang telah ditentukan sebelumnya. Untuk informasi selengkapnya, lihat [Hasil kueri terkelola](managed-results.md).

Untuk mengatur lokasi hasil kueri Amazon S3 untuk pertama kalinya, lihat [Tentukan lokasi hasil kueri menggunakan konsol Athena](query-results-specify-location-console.md).

File output disimpan secara otomatis untuk setiap kueri yang berjalan. Untuk mengakses dan melihat file keluaran kueri menggunakan konsol Athena, kepala sekolah IAM (pengguna dan peran) memerlukan izin untuk tindakan Amazon S3 untuk lokasi hasil kueri, serta izin untuk [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)tindakan Athena. [GetQueryResults](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetQueryResults.html) Lokasi hasil kueri dapat dienkripsi. Jika lokasi dienkripsi, pengguna harus memiliki izin kunci yang sesuai untuk mengenkripsi dan mendekripsi lokasi hasil permintaan.

**penting**  
IAM utama dengan izin ke Amazon S3`GetObject`tindakan untuk lokasi hasil kueri dapat mengambil hasil kueri dari Amazon S3 bahkan jika izin ke Athena`GetQueryResults`tindakan ditolak.

**catatan**  
Dalam kasus kueri yang dibatalkan atau gagal, Athena mungkin telah menulis sebagian hasil ke Amazon S3. Dalam kasus seperti itu, Athena tidak menghapus sebagian hasil dari awalan Amazon S3 tempat hasil disimpan. Anda harus menghapus awalan Amazon S3 dengan hasil sebagian. Athena menggunakan unggahan multipart Amazon S3 untuk menulis data Amazon S3. Kami menyarankan Anda menyetel kebijakan siklus hidup bucket untuk mengakhiri unggahan multibagian jika kueri gagal. Untuk informasi selengkapnya, lihat [Membatalkan unggahan multibagian yang tidak lengkap menggunakan kebijakan siklus hidup bucket di](https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config) Panduan Pengguna Layanan Penyimpanan *Sederhana Amazon*. 
Dalam kondisi tertentu, Athena dapat secara otomatis mencoba kembali eksekusi kueri. Dalam kebanyakan kasus, kueri ini dapat diselesaikan dengan sukses dan ID kueri ditandai sebagai`Completed`. Kueri ini mungkin telah menulis sebagian hasil selama upaya awal dan dapat menghasilkan unggahan multibagian yang tidak lengkap.

**Topics**
+ [

# Hasil kueri terkelola
](managed-results.md)
+ [

# Tentukan lokasi hasil kueri
](query-results-specify-location.md)
+ [

# Unduh file hasil kueri menggunakan konsol Athena
](saving-query-results.md)
+ [

# Lihat kueri terbaru di konsol Athena
](queries-viewing-history.md)
+ [

# Unduh beberapa kueri terbaru ke file CSV
](queries-downloading-multiple-recent-queries-to-csv.md)
+ [

# Konfigurasikan opsi tampilan kueri terbaru
](queries-recent-queries-configuring-options.md)
+ [

# Simpan riwayat kueri Anda lebih dari 45 hari
](querying-keeping-query-history.md)
+ [

# Temukan file keluaran kueri di Amazon S3
](querying-finding-output-files.md)

# Hasil kueri terkelola


Dengan hasil kueri terkelola, Anda dapat menjalankan kueri SQL tanpa menyediakan bucket Amazon S3 untuk penyimpanan hasil kueri. Ini menyelamatkan Anda dari keharusan menyediakan, mengelola, mengontrol akses ke, dan membersihkan bucket S3 Anda sendiri. Untuk memulai, buat workgroup baru atau edit workgroup yang sudah ada. Di bawah **Konfigurasi hasil kueri**, pilih **Athena** yang dikelola. 

**Fitur utama**
+ Menyederhanakan alur kerja Anda dengan menghapus persyaratan untuk memilih lokasi bucket S3 sebelum Anda menjalankan kueri.
+ Tidak ada biaya tambahan untuk menggunakan hasil kueri terkelola dan penghapusan otomatis hasil kueri mengurangi overhead administrasi dan kebutuhan akan proses pembersihan bucket S3 yang terpisah.
+ Mudah untuk memulai: kelompok kerja baru dan yang sudah ada sebelumnya dapat dengan mudah dikonfigurasi untuk menggunakan hasil kueri terkelola. Anda dapat memiliki campuran hasil kueri terkelola Athena dan yang dikelola pelanggan di akun Anda AWS .
+ Izin IAM yang disederhanakan dengan akses untuk membaca hasil `GetQueryResults` dan `GetQueryResultsStream` terkait dengan kelompok kerja individu.
+ Hasil kueri secara otomatis dienkripsi dengan pilihan kunci AWS milik Anda atau kunci milik pelanggan.

## Pertimbangan dan batasan


****
+ Akses ke hasil kueri dikelola di tingkat workgroup di Athena. Untuk ini, Anda memerlukan izin eksplisit untuk `GetQueryResults` dan tindakan `GetQueryResultsStream` IAM pada workgroup tertentu. `GetQueryResults`Tindakan menentukan siapa yang dapat mengambil hasil kueri yang telah selesai dalam format paginasi, sementara `GetQueryResultsStream` tindakan menentukan siapa yang dapat mengalirkan hasil kueri yang telah selesai (biasanya digunakan oleh driver Athena).
+ Anda tidak dapat mengunduh file hasil kueri yang lebih besar dari 200 MB dari konsol. Gunakan `UNLOAD` pernyataan untuk menulis hasil yang lebih besar dari 200 MB ke lokasi yang dapat Anda unduh secara terpisah.
+ Fitur hasil kueri terkelola tidak mendukung [penggunaan kembali hasil Kueri](reusing-query-results.md).
+ Hasil kueri tersedia selama 24 jam. Hasil kueri disimpan tanpa biaya kepada Anda selama periode ini. Setelah periode ini, hasil kueri dihapus secara otomatis.

## Membuat atau mengedit grup kerja dengan hasil kueri terkelola


Untuk membuat grup kerja atau memperbarui grup kerja yang ada dengan hasil kueri terkelola dari konsol:

1. Buka konsol Athena di [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/).

1. Dari navigasi kiri, pilih **Workgroups**.

1. Pilih **Buat Workgroup** untuk membuat workgroup baru atau mengedit workgroup yang ada dari daftar.

1. Di bawah **Konfigurasi hasil kueri**, pilih **Athena** yang dikelola.   
![\[Menu konfigurasi hasil Query.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/athena-managed.png)

1. Untuk **hasil kueri Enkripsi**, pilih opsi enkripsi yang Anda inginkan. Untuk informasi selengkapnya, lihat [Pilih enkripsi hasil kueri](#managed-query-results-encryption-at-rest).

1. Isi semua detail lain yang diperlukan dan pilih **Simpan perubahan**. 

## Pilih enkripsi hasil kueri


Ada dua opsi untuk konfigurasi enkripsi:
+ **Enkripsi menggunakan kunci yang AWS dimiliki** — Ini adalah opsi default saat Anda menggunakan hasil kueri terkelola. Pilih opsi ini jika Anda ingin hasil kueri dienkripsi oleh kunci yang AWS dimiliki.
+ **Enkripsi menggunakan kunci yang dikelola pelanggan** — Pilih opsi ini jika Anda ingin mengenkripsi dan mendekripsi hasil kueri dengan kunci yang dikelola pelanggan. Untuk menggunakan kunci yang dikelola pelanggan, tambahkan layanan Athena di elemen Utama bagian kebijakan utama. Untuk informasi selengkapnya, lihat [Menyiapkan kebijakan AWS KMS kunci untuk hasil kueri terkelola](#managed-query-results-set-up). Agar berhasil menjalankan kueri, pengguna yang menjalankan kueri memerlukan izin untuk mengakses kunci. AWS KMS 

## Menyiapkan kebijakan AWS KMS kunci untuk hasil kueri terkelola


`Principal`Bagian pada kebijakan kunci menentukan siapa yang dapat menggunakan kunci ini. Fitur hasil kueri terkelola memperkenalkan prinsipal `encryption.athena.amazonaws.com` yang harus Anda tentukan di `Principal` bagian. Prinsipal layanan ini khusus untuk mengakses kunci yang tidak dimiliki oleh Athena. Anda juga harus menambahkan`kms:Decrypt`,`kms:GenerateDataKey`, dan `kms:DescribeKey` tindakan ke kebijakan utama yang Anda gunakan untuk mengakses hasil terkelola. Ketiga tindakan ini adalah tindakan minimum yang diizinkan.

Hasil kueri terkelola menggunakan ARN workgroup Anda [untuk](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context) konteks enkripsi. Karena `Principal` bagian ini adalah AWS layanan, Anda juga perlu menambahkan `aws:sourceArn` dan `aws:sourceAccount` ke kondisi kebijakan utama. Contoh berikut menunjukkan kebijakan AWS KMS kunci yang memiliki izin minimum pada satu grup kerja.

```
 {
    "Sid": "Allow athena service principal to use the key",
    "Effect": "Allow",
    "Principal": {
        "Service": "encryption.athena.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey",
        "kms:DescribeKey"
      ],
    "Resource": "arn:aws:kms:us-east-1:{account-id}:key/{key-id}",
    "Condition": {
    "ArnLike": {
        "kms:EncryptionContext:aws:athena:arn": "arn:aws:athena:us-east-1:{account-id}:workgroup/{workgroup-name}",
        "aws:SourceArn": "arn:aws:athena:us-east-1:{account-id}:workgroup/{workgroup-name}"
    },
    "StringEquals": {
        "aws:SourceAccount": "{account-id}"
    }
}
```

Contoh kebijakan AWS KMS kunci berikut memungkinkan semua kelompok kerja dalam akun yang sama *account-id* untuk menggunakan AWS KMS kunci yang sama.

```
{
    "Sid": "Allow athena service principal to use the key",
    "Effect": "Allow",
    "Principal": {
        "Service": "encryption.athena.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey",
        "kms:DescribeKey"
    ],
    "Resource": "arn:aws:kms:us-east-1:account-id:key/{key-id}",
    "Condition": {
        "ArnLike": {
          "kms:EncryptionContext:aws:athena:arn": "arn:aws:athena:us-east-1:account-id:workgroup/*",
          "aws:SourceArn": "arn:aws:athena:us-east-1:account-id:workgroup/*"
        },
        "StringEquals": {
          "aws:SourceAccount": "account-id"
        }
    }
}
```

Selain izin Athena dan Amazon S3, Anda juga harus mendapatkan izin untuk melakukan dan bertindak. `kms:GenerateDataKey` `kms:Decrypt` Untuk informasi selengkapnya, lihat [Izin untuk data terenkripsi di Amazon S3](encryption.md#permissions-for-encrypting-and-decrypting-data). 

Untuk informasi selengkapnya tentang enkripsi hasil kueri terkelola, lihat[Enkripsi hasil kueri terkelola](encrypting-managed-results.md).

# Enkripsi hasil kueri terkelola


Athena menawarkan opsi berikut untuk mengenkripsi. [Hasil kueri terkelola](managed-results.md)

## Enkripsi menggunakan kunci yang AWS dimiliki


Ini adalah opsi default saat Anda menggunakan hasil kueri terkelola. Opsi ini menunjukkan bahwa Anda ingin mengenkripsi hasil kueri menggunakan kunci yang AWS dimiliki. AWS kunci yang dimiliki tidak disimpan di AWS akun Anda dan merupakan bagian dari kumpulan kunci KMS yang AWS dimiliki. Anda tidak dikenakan biaya ketika Anda menggunakan kunci yang AWS dimiliki, dan mereka tidak dihitung terhadap AWS KMS kuota untuk akun Anda.

## Enkripsi menggunakan kunci yang dikelola AWS KMS pelanggan


Kunci yang dikelola pelanggan adalah kunci KMS di AWS akun Anda yang Anda buat, miliki, dan kelola. Anda memiliki kontrol penuh atas kunci KMS ini, yang mencakup menetapkan dan memelihara kebijakan utama mereka, kebijakan dan hibah IAM, mengaktifkan dan menonaktifkannya, memutar materi kriptografi mereka, menambahkan tag, membuat alias yang merujuk kepada mereka, dan menjadwalkannya untuk dihapus. Untuk informasi selengkapnya, lihat [Kunci terkelola pelanggan](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk).

## Bagaimana Athena menggunakan kunci yang dikelola pelanggan untuk mengenkripsi hasil


Saat Anda menentukan kunci terkelola pelanggan, Athena menggunakannya untuk mengenkripsi hasil kueri saat disimpan dalam hasil kueri terkelola. Kunci yang sama digunakan untuk mendekripsi hasil saat Anda menelepon. `GetQueryResults` Ketika Anda menyetel status kunci yang dikelola pelanggan untuk dinonaktifkan atau menjadwalkannya untuk dihapus, ini mencegah Athena dan semua pengguna mengenkripsi atau mendekripsi hasil dengan kunci itu.

Athena menggunakan enkripsi amplop dan hierarki kunci untuk mengenkripsi data. Kunci AWS KMS enkripsi Anda digunakan untuk menghasilkan dan mendekripsi kunci root dari hierarki kunci ini.

Setiap hasil dienkripsi menggunakan kunci terkelola pelanggan yang dikonfigurasi di workgroup pada saat enkripsi. Mengalihkan kunci ke kunci yang dikelola pelanggan yang berbeda atau ke kunci yang AWS dimiliki tidak mengenkripsi ulang hasil yang ada dengan kunci baru. Menghapus dan menonaktifkan kunci terkelola pelanggan tertentu hanya memengaruhi dekripsi hasil yang dienkripsi oleh kunci tersebut.

Athena membutuhkan akses ke kunci enkripsi Anda untuk melakukan`kms:Decrypt`,`kms:GenerateDataKey`, dan `kms:DescribeKey` operasi untuk mengenkripsi dan mendekripsi hasil. Untuk informasi selengkapnya, lihat [Izin untuk data terenkripsi di Amazon S3](encryption.md#permissions-for-encrypting-and-decrypting-data). 

Prinsipal yang mengirimkan kueri menggunakan `StartQueryExecution` API dan membaca hasil menggunakan juga `GetQueryResults` harus memiliki izin ke kunci yang dikelola pelanggan untuk`kms:Decrypt`,`kms:GenerateDataKey`, dan `kms:DescribeKey` operasi selain izin Athena dan Amazon S3. Untuk informasi selengkapnya, lihat [Kebijakan utama di AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html#key-policy-default-allow-users).

# Tentukan lokasi hasil kueri


Lokasi hasil kueri yang digunakan Athena ditentukan oleh kombinasi pengaturan grup kerja dan*Pengaturan sisi klien*. Pengaturan sisi klien didasarkan pada bagaimana Anda menjalankan kueri. 
+  Jika Anda menjalankan kueri menggunakan konsol Athena,**Lokasi hasil kueri**dimasukkan di bawah**Pengaturan**di bilah navigasi menentukan pengaturan sisi klien. 
+ Jika Anda menjalankan kueri menggunakan Athena API, `OutputLocation` parameter [StartQueryExecution](https://docs.aws.amazon.com/athena/latest/APIReference/API_StartQueryExecution.html)tindakan menentukan setelan sisi klien. 
+ Jika Anda menggunakan ODBC atau JDBC driver untuk menjalankan kueri,`S3OutputLocation` properti yang ditentukan dalam URL koneksi menentukan pengaturan sisi klien. 

**penting**  
Saat Anda menjalankan kueri menggunakan API atau menggunakan ODBC atau JDBC driver, pengaturan konsol tidak berlaku. 

Setiap konfigurasi grup kerja memiliki[Menimpa pengaturan sisi klien](https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html)pilihan yang dapat diaktifkan. Saat opsi ini diaktifkan, pengaturan grup kerja diutamakan atas pengaturan sisi klien berlaku saat utama IAM terkait dengan kelompok kerja yang menjalankan kueri.

## Tentang lokasi default yang dibuat sebelumnya


Sebelumnya di Athena, jika Anda menjalankan kueri tanpa menentukan nilai untuk **lokasi hasil Kueri, dan pengaturan lokasi** hasil kueri tidak diganti oleh grup kerja, Athena membuat lokasi default untuk Anda. Lokasi default adalah`aws-athena-query-results-MyAcctID-MyRegion`, di mana *MyAcctID* ID akun Amazon Web Services dari prinsipal IAM yang menjalankan kueri, dan *MyRegion* merupakan wilayah tempat kueri dijalankan (misalnya,`us-west-1`.)

Sekarang, sebelum Anda dapat menjalankan kueri Athena di wilayah tempat akun Anda belum digunakan Athena sebelumnya, Anda harus menentukan lokasi hasil kueri, atau menggunakan grup kerja yang menimpa pengaturan lokasi hasil kueri. Meski Athena tidak lagi membuat lokasi hasil kueri default untuk Anda, default yang sebelumnya dibuat lokasi `aws-athena-query-results-MyAcctID-MyRegion` tetap valid dan Anda dapat terus menggunakannya.

**Topics**
+ [

## Tentang lokasi default yang dibuat sebelumnya
](#query-results-specify-location-previous-defaults)
+ [

# Tentukan lokasi hasil kueri menggunakan konsol Athena
](query-results-specify-location-console.md)
+ [

# Menentukan lokasi hasil kueri menggunakan workgroup
](query-results-specify-location-workgroup.md)

# Tentukan lokasi hasil kueri menggunakan konsol Athena
Gunakan konsol Athena

Sebelum Anda dapat menjalankan kueri, kueri hasil bucket lokasi di Amazon S3 harus ditentukan, atau Anda harus menggunakan grup kerja yang telah ditentukan bucket dan konfigurasi yang menimpa pengaturan klien.

**Untuk menentukan lokasi hasil kueri pengaturan sisi klien menggunakan konsol Athena**

1. [Beralih](switching-workgroups.md) ke workgroup yang ingin Anda tentukan lokasi hasil kueri. Nama workgroup default adalah **primary**.

1. Dari bilah navigasi, pilih **Pengaturan**.

1. Dari bilah navigasi, pilih **Kelola**.

1. Untuk **Mengelola pengaturan**, lakukan salah satu hal berikut:
   + Di kotak **Lokasi hasil kueri**, masukkan jalur ke bucket yang dibuat di Amazon S3 untuk hasil kueri. Awalan jalur dengan`s3://`.
   + **Pilih **Browse S3**, pilih bucket Amazon S3 yang Anda buat untuk Wilayah saat ini, lalu pilih Pilih.**
**catatan**  
Jika Anda menggunakan workgroup yang menentukan lokasi hasil kueri untuk semua pengguna workgroup, opsi untuk mengubah lokasi hasil kueri tidak tersedia.

1. (Opsional) Pilih **Lihat konfigurasi siklus hidup** untuk melihat dan mengonfigurasi aturan [siklus hidup Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) pada bucket hasil kueri Anda. Aturan siklus hidup Amazon S3 yang Anda buat dapat berupa aturan kedaluwarsa atau aturan transisi. Aturan kedaluwarsa secara otomatis menghapus hasil kueri setelah jangka waktu tertentu. Aturan transisi memindahkannya ke tingkat penyimpanan Amazon S3 lainnya. Untuk informasi selengkapnya, lihat [Menyetel konfigurasi siklus hidup pada bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-set-lifecycle-configuration-intro.html) di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

1. (Opsional) Untuk **pemilik bucket yang Diharapkan**, masukkan ID Akun AWS yang Anda harapkan sebagai pemilik bucket lokasi keluaran. Ini adalah langkah keamanan tambahan. Jika ID akun pemilik bucket tidak cocok dengan ID yang Anda tentukan di sini, upaya untuk menampilkan ke bucket akan gagal. Untuk informasi lebih lanjut, lihat [Memverifikasi kepemilikan bucket dengan kondisi pemilik bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html) di Panduan Pengguna *Amazon S3*.
**catatan**  
Setelan pemilik bucket yang diharapkan hanya berlaku untuk lokasi keluaran Amazon S3 yang Anda tentukan untuk hasil kueri Athena. Ini tidak berlaku untuk lokasi Amazon S3 lainnya seperti lokasi sumber data di bucket Amazon S3 eksternal`CTAS`, `INSERT INTO` dan lokasi tabel tujuan, lokasi keluaran pernyataan`UNLOAD`, operasi untuk menumpahkan bucket untuk kueri federasi, `SELECT` atau kueri yang dijalankan terhadap tabel di akun lain.

1. (Opsional) Pilih **Enkripsi hasil kueri** jika Anda ingin mengenkripsi hasil kueri yang disimpan di Amazon S3. Untuk informasi lebih lanjut tentang enkripsi di Athena, lihat. [Enkripsi saat diam](encryption.md)

1. (Opsional) Pilih **Tetapkan kontrol penuh pemilik bucket atas hasil kueri** untuk memberikan akses kontrol penuh atas hasil kueri kepada pemilik bucket saat [ACLs diaktifkan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) untuk bucket hasil kueri. Misalnya, jika lokasi hasil kueri Anda dimiliki oleh akun lain, Anda dapat memberikan kepemilikan dan kontrol penuh atas hasil kueri Anda ke akun lain. Untuk informasi selengkapnya, lihat [Mengontrol kepemilikan objek dan menonaktifkan ACLs bucket Anda di Panduan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) Pengguna *Amazon S3*.

1. Pilih **Simpan**.

# Menentukan lokasi hasil kueri menggunakan workgroup
Menggunakan workgroup

Anda menentukan lokasi hasil kueri dalam konfigurasi grup kerja menggunakan Konsol Manajemen AWS, AWS CLI, atau API Athena.

Saat menggunakan AWS CLI, tentukan lokasi hasil kueri menggunakan `OutputLocation` parameter `--configuration` opsi saat Anda menjalankan [https://docs.aws.amazon.com/cli/latest/reference/athena/update-work-group.html](https://docs.aws.amazon.com/cli/latest/reference/athena/update-work-group.html)perintah [https://docs.aws.amazon.com/cli/latest/reference/athena/create-work-group.html](https://docs.aws.amazon.com/cli/latest/reference/athena/create-work-group.html)or.

**Untuk menentukan lokasi hasil permintaan untuk kelompok kerja menggunakan konsol Athena**

1. Jika panel navigasi konsol tidak terlihat, pilih menu ekspansi di sebelah kiri.  
![\[Pilih menu ekspansi.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/nav-pane-expansion.png)

1. Di panel navigasi, pilih **Workgroups**.

1. Dalam daftar workgroup, pilih link workgroup yang ingin Anda edit.

1. Pilih **Edit**.

1. Untuk **lokasi dan enkripsi hasil Query**, lakukan salah satu hal berikut:
   + Di kotak **Lokasi hasil kueri**, masukkan jalur ke bucket di Amazon S3 untuk hasil kueri Anda. Awalan jalur dengan`s3://`.
   + **Pilih **Browse S3**, pilih bucket Amazon S3 untuk Wilayah saat ini yang ingin Anda gunakan, lalu pilih Pilih.**

1. (Opsional) Untuk **pemilik bucket yang Diharapkan**, masukkan ID Akun AWS yang Anda harapkan sebagai pemilik bucket lokasi keluaran. Ini adalah langkah keamanan tambahan. Jika ID akun pemilik bucket tidak cocok dengan ID yang Anda tentukan di sini, upaya untuk menampilkan ke bucket akan gagal. Untuk informasi lebih lanjut, lihat [Memverifikasi kepemilikan bucket dengan kondisi pemilik bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html) di Panduan Pengguna *Amazon S3*.
**catatan**  
Setelan pemilik bucket yang diharapkan hanya berlaku untuk lokasi keluaran Amazon S3 yang Anda tentukan untuk hasil kueri Athena. Ini tidak berlaku untuk lokasi Amazon S3 lainnya seperti lokasi sumber data di bucket Amazon S3 eksternal`CTAS`, `INSERT INTO` dan lokasi tabel tujuan, lokasi keluaran pernyataan`UNLOAD`, operasi untuk menumpahkan bucket untuk kueri federasi, `SELECT` atau kueri yang dijalankan terhadap tabel di akun lain.

1. (Opsional) Pilih **Enkripsi hasil kueri** jika Anda ingin mengenkripsi hasil kueri yang disimpan di Amazon S3. Untuk informasi lebih lanjut tentang enkripsi di Athena, lihat. [Enkripsi saat diam](encryption.md)

1. (Opsional) Pilih **Tetapkan kontrol penuh pemilik bucket atas hasil kueri** untuk memberikan akses kontrol penuh atas hasil kueri kepada pemilik bucket saat [ACLs diaktifkan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) untuk bucket hasil kueri. Misalnya, jika lokasi hasil kueri Anda dimiliki oleh akun lain, Anda dapat memberikan kepemilikan dan kontrol penuh atas hasil kueri Anda ke akun lain. 

   Jika setelan Kepemilikan Objek S3 **bucket lebih disukai pemilik Bucket**, pemilik bucket juga memiliki semua objek hasil kueri yang ditulis dari workgroup ini. Misalnya, jika grup kerja akun eksternal mengaktifkan opsi ini dan menetapkan lokasi hasil kueri ke bucket Amazon S3 akun Anda yang memiliki pengaturan Kepemilikan Objek S3 **dari pemilik Bucket** yang lebih disukai, Anda memiliki dan memiliki akses kontrol penuh atas hasil kueri grup kerja eksternal. 

   Memilih opsi ini ketika setelan Kepemilikan Objek S3 bucket hasil kueri **diberlakukan oleh pemilik Bucket** tidak berpengaruh. Untuk informasi selengkapnya, lihat [Mengontrol kepemilikan objek dan menonaktifkan ACLs bucket Anda di Panduan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) Pengguna *Amazon S3*. 

1. Jika Anda ingin meminta semua pengguna workgroup untuk menggunakan lokasi hasil kueri yang Anda tentukan, gulir ke bawah ke bagian **Pengaturan** dan pilih Ganti pengaturan **sisi klien**.

1. Pilih **Simpan perubahan**.

# Unduh file hasil kueri menggunakan konsol Athena
Unduh hasil kueri

Anda dapat mengunduh file CSV hasil kueri dari panel kueri segera setelah Anda menjalankan kueri. Anda juga dapat mengunduh hasil kueri dari kueri terbaru dari tab **Kueri terbaru**.

**catatan**  
File hasil kueri Athena adalah file data yang berisi informasi yang dapat dikonfigurasi oleh pengguna individu. Beberapa program yang membaca dan menganalisis data ini berpotensi menafsirkan beberapa data sebagai perintah (CSV injection). Untuk alasan ini, saat Anda mengimpor data CSV hasil kueri ke program spreadsheet, program tersebut mungkin akan memperingatkan Anda tentang masalah keamanan. Untuk menjaga sistem Anda aman, Anda harus selalu memilih untuk menonaktifkan tautan atau makro dari hasil kueri yang diunduh.

**Untuk menjalankan kueri dan mengunduh hasil kueri**

1. Masukkan kueri Anda di editor kueri dan kemudian pilih **Jalankan**.

   Saat kueri selesai berjalan,**Hasil**menampilkan hasil kueri.

1. Untuk mengunduh file CSV hasil kueri, pilih **Unduh hasil** di atas panel hasil kueri. Bergantung pada konfigurasi browser dan browser Anda, Anda mungkin perlu mengonfirmasi unduhan.  
![\[Menyimpan hasil kueri ke.csvfail dalam konsol Athena.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/getting-started-query-results-download-csv.png)

**Untuk mengunduh file hasil kueri untuk mengkueri sebelumnya**

1. Pilih **Kueri terbaru**.  
![\[Pilih Kueri terbaru untuk melihat kueri sebelumnya.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/getting-started-recent-queries.png)

1. Gunakan kotak pencarian untuk menemukan kueri, pilih kueri, lalu pilih **Unduh hasil**.
**catatan**  
Anda tidak dapat menggunakan opsi **Unduh hasil** untuk mengambil hasil kueri yang telah dihapus secara manual, atau mengambil hasil kueri yang telah dihapus atau dipindahkan ke lokasi lain oleh aturan siklus hidup Amazon [S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-set-lifecycle-configuration-intro.html).  
![\[Pilih Kueri terbaru untuk menemukan dan mengunduh hasil kueri sebelumnya.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/querying-recent-queries-tab-download.png)

# Lihat kueri terbaru di konsol Athena
Lihat pertanyaan terbaru

Anda dapat menggunakan konsol Athena untuk melihat kueri mana yang berhasil atau gagal, dan melihat detail kesalahan untuk kueri yang gagal. Athena menyimpan sejarah pertanyaan selama 45 hari. 

**Untuk melihat kueri terbaru di konsol Athena**

1. Buka konsol Athena di [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Pilih **Kueri terbaru**. Tab **Kueri terbaru** menampilkan informasi tentang setiap kueri yang dijalankan.

1. Untuk membuka pernyataan kueri di editor kueri, pilih ID eksekusi kueri.  
![\[Pilih ID eksekusi kueri untuk melihatnya di editor kueri.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/querying-view-query-statement.png)

1. Untuk melihat detail kueri yang gagal, pilih tautan **Gagal** untuk kueri.  
![\[Pilih tautan Gagal untuk kueri untuk melihat informasi tentang kegagalan.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/querying-view-query-failure-details.png)

# Unduh beberapa kueri terbaru ke file CSV
Unduh kueri terbaru

Anda dapat menggunakan tab **Kueri terbaru** dari konsol Athena untuk mengekspor satu atau beberapa kueri terbaru ke file CSV untuk melihatnya dalam format tabel. File yang diunduh tidak berisi hasil kueri, tetapi string kueri SQL itu sendiri dan informasi lain tentang kueri. Bidang yang diekspor mencakup ID eksekusi, konten string kueri, waktu mulai kueri, status, waktu berjalan, jumlah data yang dipindai, versi mesin kueri yang digunakan, dan metode enkripsi. Anda dapat mengekspor maksimal 500 kueri terbaru, atau maksimum 500 kueri yang difilter menggunakan kriteria yang Anda masukkan di kotak pencarian.

**Untuk mengekspor satu atau beberapa kueri terbaru ke file CSV**

1. Buka konsol Athena di [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Pilih **Kueri terbaru**.

1. (Opsional) Gunakan kotak pencarian untuk memfilter kueri terbaru yang ingin Anda unduh.

1. Pilih **Unduh CSV**.  
![\[Pilih Unduh CSV.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/querying-recent-queries-csv.png)

1. Pada prompt penyimpanan file, pilih **Simpan**. Nama file default `Recent Queries` diikuti oleh stempel waktu (misalnya,) `Recent Queries 2022-12-05T16 04 27.352-08 00.csv`

# Konfigurasikan opsi tampilan kueri terbaru
Konfigurasikan opsi kueri terbaru

Anda dapat mengonfigurasi opsi untuk tab **Kueri terbaru** seperti kolom untuk ditampilkan dan pembungkus teks.

**Untuk mengonfigurasi opsi untuk tab **Kueri terbaru****

1. Buka konsol Athena di [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Pilih **Kueri terbaru**.

1. Pilih tombol opsi (ikon roda gigi).  
![\[Pilih tombol opsi untuk mengonfigurasi tampilan kueri terbaru.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/querying-recent-queries-options.png)

1. Di kotak dialog **Preferensi**, pilih jumlah baris per halaman, perilaku pembungkus baris, dan kolom yang akan ditampilkan.  
![\[Mengkonfigurasi tampilan kueri terbaru.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/querying-recent-queries-preferences.png)

1. Pilih **Konfirmasi**.

# Simpan riwayat kueri Anda lebih dari 45 hari
Simpan riwayat kueri Anda lebih lama

Jika Anda ingin menyimpan riwayat kueri lebih lama dari 45 hari, Anda dapat mengambil riwayat kueri dan menyimpannya ke toko data seperti Amazon S3. Untuk mengotomatiskan proses ini, Anda dapat menggunakan Athena dan Amazon S3 API tindakan dan perintah CLI. Prosedur berikut merangkum langkah-langkah ini.

**Untuk mengambil dan menyimpan sejarah permintaan pemrograman**

1. Gunakan tindakan Athena [ListQueryExecutions](https://docs.aws.amazon.com/athena/latest/APIReference/API_ListQueryExecutions.html)API atau perintah [list-query-executions](https://docs.aws.amazon.com/cli/latest/reference/athena/list-query-executions.html)CLI untuk mengambil kueri. IDs

1. Gunakan tindakan Athena [GetQueryExecution](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetQueryExecution.html)API atau perintah [get-query-execution](https://docs.aws.amazon.com/cli/latest/reference/athena/get-query-execution.html)CLI untuk mengambil informasi tentang setiap kueri berdasarkan ID-nya.

1. Gunakan tindakan Amazon S3 [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)API atau perintah CLI [put-object](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-object.html) untuk menyimpan informasi di Amazon S3.

# Temukan file keluaran kueri di Amazon S3


File output permintaan disimpan dalam sub-folder di Amazon S3 dalam pola jalur berikut kecuali permintaan terjadi dalam kelompok kerja yang konfigurasi menimpa pengaturan sisi klien. Saat konfigurasi grup kerja menimpa pengaturan sisi klien, permintaan menggunakan jalur hasil yang ditentukan oleh kelompok kerja.

```
QueryResultsLocationInS3/[QueryName|Unsaved/yyyy/mm/dd/]
```
+ *QueryResultsLocationInS3*adalah lokasi hasil kueri yang ditentukan baik oleh pengaturan grup kerja atau pengaturan sisi klien. Untuk informasi selengkapnya, lihat [Tentukan lokasi hasil kueri](query-results-specify-location.md) nanti dalam dokumen ini.
+ Sub-folder berikut dibuat hanya untuk permintaan menjalankan dari konsol jalur hasil yang belum ditimpa oleh konfigurasi grup kerja. Kueri yang dijalankan dari AWS CLI atau menggunakan Athena API disimpan langsung ke file. *QueryResultsLocationInS3*
  + *QueryName*adalah nama kueri yang hasilnya disimpan. Jika permintaan berjalan tetapi tidak disimpan,`Unsaved`digunakan. 
  + *yyyy/mm/dd*adalah tanggal kueri dijalankan.

File yang diasosiasikan dengan`CREATE TABLE AS SELECT`permintaan disimpan dalam`tables`sub-folder dari pola di atas.

## Identifikasi file keluaran kueri


File disimpan ke lokasi hasil kueri di Amazon S3 berdasarkan nama kueri, ID kueri, dan tanggal permintaan berlari. File untuk setiap kueri diberi nama menggunakan*QueryID*, yang merupakan pengidentifikasi unik yang Athena tetapkan untuk setiap kueri saat dijalankan.

Tipe fail berikut disimpan:


| Tipe file | Pola penamaan file | Deskripsi | 
| --- | --- | --- | 
|  **File hasil kueri**  |  `QueryID.csv` `QueryID.txt`  |  File hasil kueri DDLL disimpan dalam format nilai yang dipisahkan koma (CSV). Hasil kueri DDL disimpan sebagai file teks biasa.  Anda dapat mengunduh berkas hasil dari konsol dari**Hasil**saat menggunakan konsol atau dari query**riwayat**. Untuk informasi selengkapnya, lihat [Unduh file hasil kueri menggunakan konsol Athena](saving-query-results.md).  | 
|  **Kueri file metadata**  |  `QueryID.csv.metadata` `QueryID.txt.metadata`  |  DDLL dan DDL kueri file metadata disimpan dalam format biner dan tidak dapat dibaca manusia. Ekstensi file sesuai dengan file hasil kueri terkait. Athena menggunakan metadata saat membaca hasil kueri menggunakan`GetQueryResults`Tindakan. Meski file-file ini dapat dihapus, kami tidak merekomendasikannya karena informasi penting tentang kueri hilang.  | 
|  **File manifes data**  |  `QueryID-manifest.csv`  |  File manifest data dibuat untuk melacak file yang dibuat Athena di lokasi sumber data Amazon S3 saat[INSERT INTO](insert-into.md)berjalan kueri. Jika permintaan gagal, manifest juga melacak file yang permintaan dimaksudkan untuk menulis. Manifest berguna untuk mengidentifikasi file yatim piatu yang dihasilkan dari permintaan gagal.  | 

## Gunakan AWS CLI untuk mengidentifikasi lokasi dan file keluaran kueri
Gunakan AWS CLI

Untuk menggunakan AWS CLI untuk mengidentifikasi lokasi output query dan file hasil, jalankan `aws athena get-query-execution` perintah, seperti pada contoh berikut. Ganti *abc1234d-5efg-67hi-jklm-89n0op12qr34* dengan ID kueri.

```
aws athena get-query-execution --query-execution-id abc1234d-5efg-67hi-jklm-89n0op12qr34
```

Perintah ini menghasilkan output serupa dengan berikut: Untuk deskripsi dari setiap parameter output, lihat [get-query-execution](https://docs.aws.amazon.com/cli/latest/reference/athena/get-query-execution.html)di *AWS CLI Command Reference*.

```
{
    "QueryExecution": {
        "Status": {
            "SubmissionDateTime": 1565649050.175,
            "State": "SUCCEEDED",
            "CompletionDateTime": 1565649056.6229999
        },
        "Statistics": {
            "DataScannedInBytes": 5944497,
            "DataManifestLocation": "s3://amzn-s3-demo-bucket/athena-query-results-123456789012-us-west-1/MyInsertQuery/2019/08/12/abc1234d-5efg-67hi-jklm-89n0op12qr34-manifest.csv",
            "EngineExecutionTimeInMillis": 5209
        },
        "ResultConfiguration": {
            "EncryptionConfiguration": {
                "EncryptionOption": "SSE_S3"
            },
            "OutputLocation": "s3://amzn-s3-demo-bucket/athena-query-results-123456789012-us-west-1/MyInsertQuery/2019/08/12/abc1234d-5efg-67hi-jklm-89n0op12qr34"
        },
        "QueryExecutionId": "abc1234d-5efg-67hi-jklm-89n0op12qr34",
        "QueryExecutionContext": {},
        "Query": "INSERT INTO mydb.elb_log_backup SELECT * FROM mydb.elb_logs LIMIT 100",
        "StatementType": "DML",
        "WorkGroup": "primary"
    }
}
```