

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

# Ubah versi mesin Athena
<a name="engine-versions-changing"></a>

Athena terkadang merilis versioning mesin baru untuk memberikan peningkatan performa, fungsionalitas, dan perbaikan kode. Jika versioning mesin baru tersedia, Athena akan memberi tahu Anda di konsol. Anda dapat memilih untuk membiarkan Athena memutuskan kapan akan memutakhirkan, atau secara manual menentukan versioning mesin Athena per grup kerja.

## Temukan versi mesin untuk grup kerja
<a name="engine-versions-changing-finding-the-query-engine-version-for-a-workgroup"></a>

Anda dapat menggunakan halaman **Workgroups** untuk menemukan versi mesin saat ini untuk workgroup apa pun.

**Untuk menemukan versioning mesin saat ini untuk setiap grup kerja**

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

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 konsol Athena, pilih Workgroups.**

1. Pada halaman **Workgroups**, temukan workgroup yang Anda inginkan. Kolom **versi mesin Query** untuk workgroup menampilkan versi mesin kueri.

## Gunakan konsol Athena untuk mengubah versi mesin
<a name="engine-versions-changing-changing-the-engine-version"></a>

Saat versioning mesin baru tersedia, Anda dapat memilih untuk membiarkan Athena memutuskan kapan akan memutakhirkan grup kerja, atau secara manual menentukan versioning mesin Athena yang digunakan grup kerja. Jika hanya satu versi yang tersedia saat ini, menentukan versi yang berbeda secara manual tidak dimungkinkan.

**catatan**  
Untuk mengubah versioning mesin untuk grup kerja, Anda harus memiliki izin untuk melakukan tindakan `athena:ListEngineVersions` pada grup kerja. Untuk contoh kebijakan IAM, lihat [Contoh kebijakan workgroup](example-policies-workgroup.md). 

**Untuk membiarkan Athena memutuskan kapan akan memutakhirkan grup kerja**

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

1. Jika panel navigasi konsol tidak terlihat, pilih menu ekspansi di sebelah kiri.

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

1. Dalam daftar workgroup, pilih link untuk workgroup yang ingin Anda konfigurasi.

1. Pilih **Edit**.

1. Di bagian **Versi mesin kueri**, untuk **mesin kueri Perbarui**, pilih **Otomatis** untuk membiarkan Athena memilih kapan harus meningkatkan grup kerja Anda. Ini adalah pengaturan default.

1. Pilih **Simpan perubahan**.

   **Dalam daftar kelompok kerja, **status pembaruan mesin kueri** untuk grup kerja menunjukkan Otomatis.**

**Cara memilih versioning mesin secara manual**

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

1. Jika panel navigasi konsol tidak terlihat, pilih menu ekspansi di sebelah kiri.

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

1. Dalam daftar workgroup, pilih link untuk workgroup yang ingin Anda konfigurasi.

1. Pilih **Edit**.

1. Di bagian **Versi mesin kueri**, untuk **Perbarui mesin kueri**, pilih **Manual** untuk memilih versi mesin secara manual.

1. Gunakan opsi **Query engine version** untuk memilih versi mesin yang ingin digunakan oleh workgroup. Jika versi mesin yang berbeda tidak tersedia, versi mesin yang berbeda tidak dapat ditentukan.

1. Pilih **Simpan perubahan**.

   **Dalam daftar workgroup, **status update mesin Query** untuk workgroup menunjukkan Manual.**

## Gunakan AWS CLI untuk mengubah versi mesin
<a name="engine-versions-changing-changing-the-engine-version-cli"></a>

Untuk mengubah versi mesin menggunakan AWS CLI, gunakan sintaks dalam contoh berikut.

```
aws athena update-work-group --work-group workgroup-name --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}
```

## Tentukan versi mesin saat Anda membuat grup kerja
<a name="engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup"></a>

Saat Anda membuat grup kerja, Anda dapat menentukan versioning mesin yang menggunakan grup kerja atau membiarkan Athena memutuskan kapan akan memutakhirkan grup kerja. Jika versi mesin baru tersedia, praktik terbaik adalah membuat grup kerja untuk menguji mesin baru sebelum Anda meningkatkan grup kerja Anda yang lain. Untuk menentukan versioning mesin untuk grup kerja, Anda harus memiliki izin `athena:ListEngineVersions` pada grup kerja. Untuk contoh kebijakan IAM, lihat [Contoh kebijakan workgroup](example-policies-workgroup.md).

**Untuk menentukan versioning mesin saat Anda membuat grup kerja**

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

1. Jika panel navigasi konsol tidak terlihat, pilih menu ekspansi di sebelah kiri.

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

1. Pada **Grup Kerja**, pilih **Buat grup kerja**.

1. Pada halaman **Create workgroup**, di bagian **Query Engine Version**, lakukan salah satu hal berikut:
   + Pilih **Otomatis** untuk membiarkan Athena memilih kapan harus meng-upgrade workgroup Anda. Ini adalah pengaturan default.
   + Pilih **Manual** untuk memilih versi mesin yang berbeda secara manual jika tersedia.

1. Masukkan informasi untuk bidang lain yang diperlukan. Untuk informasi tentang bidang lainnya, lihat [Buat grup kerja](creating-workgroups.md).

1. Pilih **Buat grup kerja**.

## Kueri uji sebelum peningkatan versi mesin
<a name="engine-versions-testing"></a>

Saat workgroup ditingkatkan ke versi mesin baru, beberapa kueri Anda dapat rusak karena ketidakcocokan. Untuk memastikan pemutakhiran versioning mesin Anda berjalan lancar, Anda dapat menguji kueri Anda terlebih dahulu.

**Untuk menguji kueri Anda sebelum pemutakhiran versioning mesin**

1. Verifikasi versioning mesin grup kerja yang Anda gunakan. Versi mesin yang Anda gunakan ditampilkan pada halaman **Workgroups** di kolom **Query engine version** untuk workgroup. Untuk informasi selengkapnya, lihat [Temukan versi mesin untuk grup kerja](#engine-versions-changing-finding-the-query-engine-version-for-a-workgroup).

1. Buat grup kerja tes yang menggunakan versioning mesin baru. Untuk informasi selengkapnya, lihat [Tentukan versi mesin saat Anda membuat grup kerja](#engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup).

1. Gunakan grup kerja baru untuk menjalankan kueri yang ingin Anda uji.

1. Jika kueri gagal, periksa perubahan yang melanggar di mesin baru yang mungkin memengaruhi kueri. Beberapa perubahan mungkin mengharuskan Anda untuk memperbarui sintaks kueri Anda.

1. Jika pertanyaan Anda masih gagal, hubungi AWS Dukungan untuk bantuan. Di bagian Konsol Manajemen AWS, pilih **Support**, **Support Center**, atau ajukan pertanyaan di [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) menggunakan tag **Amazon Athena**.

## Memecahkan masalah kueri yang gagal setelah upgrade versi engine
<a name="engine-versions-troubleshooting"></a>

Jika kueri gagal setelah upgrade versi engine, periksa perubahan yang melanggar, termasuk perubahan yang dapat memengaruhi sintaks dalam kueri Anda.

Jika pertanyaan Anda masih gagal, hubungi AWS Dukungan untuk bantuan. Di bagian Konsol Manajemen AWS, pilih **Support**, **Support Center**, atau ajukan pertanyaan di [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) menggunakan tag **Amazon Athena**.