

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

# Memecahkan masalah di Athena
<a name="troubleshooting-athena"></a>

Tim Athena telah mengumpulkan informasi pemecahan masalah berikut dari masalah pelanggan. Meskipun tidak komprehensif, ini mencakup saran mengenai beberapa masalah kinerja umum, batas waktu, dan kehabisan memori.

**Topics**
+ [BUAT TABEL SEBAGAI PILIH (CTAS)](#troubleshooting-athena-create-table-as-select-ctas)
+ [Masalah file data](#troubleshooting-athena-data-file-issues)
+ [Tabel Linux Foundation Delta Lake](#troubleshooting-athena-delta-lake-tables)
+ [Pertanyaan federasi](#troubleshooting-athena-federated-queries)
+ [Kesalahan terkait JSON](#troubleshooting-athena-json-related-errors)
+ [TABEL PERBAIKAN MSCK](#troubleshooting-athena-msck-repair-table)
+ [Masalah keluaran](#troubleshooting-athena-output-issues)
+ [Masalah parket](#troubleshooting-athena-parquet-issues)
+ [Masalah partisi](#troubleshooting-athena-partitioning-issues)
+ [Izin](#troubleshooting-athena-permissions)
+ [Masalah sintaks kueri](#troubleshooting-athena-query-syntax-issues)
+ [Masalah batas waktu kueri](#troubleshooting-athena-query-timeout-issues)
+ [Masalah pelambatan](#troubleshooting-athena-throttling-issues)
+ [Tampilan](#troubleshooting-athena-views)
+ [Grup Kerja](#troubleshooting-athena-workgroups)
+ [Sumber daya tambahan](#troubleshooting-athena-additional-resources)
+ [Katalog kesalahan Athena](error-reference.md)

## BUAT TABEL SEBAGAI PILIH (CTAS)
<a name="troubleshooting-athena-create-table-as-select-ctas"></a>

### Data duplikat terjadi dengan pernyataan CTAS bersamaan
<a name="troubleshooting-athena-duplicated-data-occurs-with-concurrent-ctas-statements"></a>

Athena tidak mempertahankan validasi bersamaan untuk CTAS. Pastikan bahwa tidak ada pernyataan CTAS duplikat untuk lokasi yang sama pada saat yang sama. Bahkan jika pernyataan CTAS atau INSERT INTO gagal, data yatim piatu dapat ditinggalkan di lokasi data yang ditentukan dalam pernyataan.

### HIVE\$1TOO\$1MANY\$1OPEN\$1PARTITIONS
<a name="troubleshooting-athena-ctas-hive-too-many-open-partitions"></a>

Bila Anda menggunakan pernyataan CTAS untuk membuat tabel dengan lebih dari 100 partisi, Anda mungkin menerima kesalahan HIVE\$1TOO\$1MANY\$1OPEN\$1PARTITIONS: Melebihi batas 100 penulis terbuka untuk partisi/ember. Untuk mengatasi batasan ini, Anda dapat menggunakan pernyataan CTAS dan serangkaian `INSERT INTO` pernyataan yang membuat atau menyisipkan hingga 100 partisi masing-masing. Untuk informasi selengkapnya, lihat [Gunakan CTAS dan INSERT INTO untuk bekerja di sekitar batas partisi 100](ctas-insert-into.md).

## Masalah file data
<a name="troubleshooting-athena-data-file-issues"></a>

### Athena tidak dapat membaca file tersembunyi
<a name="troubleshooting-athena-athena-cannot-read-hidden-files"></a>

Athena memperlakukan file sumber yang dimulai dengan garis bawah (\$1) atau titik (.) sebagai tersembunyi. Untuk mengatasi batasan ini, ganti nama file.

### Athena membaca file yang saya kecualikan dari crawler AWS Glue
<a name="troubleshooting-athena-athena-reads-files-that-i-excluded-from-the-glue-crawler"></a>

Athena tidak mengenali [pola pengecualian](https://docs.aws.amazon.com/glue/latest/dg/define-crawler.html#crawler-data-stores-exclude) yang Anda tentukan crawler. AWS Glue Misalnya, jika Anda memiliki bucket Amazon S3 yang berisi keduanya`.csv`dan`.json`file dan Anda mengecualikan`.json`file dari crawler, Athena mengkueri kedua grup file. Untuk menghindari hal ini, menempatkan file yang ingin Anda mengecualikan di lokasi yang berbeda.

### HIVE\$1BAD\$1DATA: Kesalahan mengurai nilai bidang
<a name="troubleshooting-athena-hive_bad_data-error-parsing-field-value"></a>

Kesalahan ini dapat terjadi dalam skenario berikut:
+ Tipe data yang ditentukan dalam tabel tidak cocok dengan data sumber, atau satu bidang berisi berbagai jenis data. Untuk resolusi yang disarankan, lihat [Kueri Amazon Athena saya gagal dengan kesalahan “HIVE\$1BAD\$1DATA: Error parsing field value for field x: For input string: “12312845691"” di Pusat](https://aws.amazon.com/premiumsupport/knowledge-center/athena-hive-bad-data-parsing-field-value/) Pengetahuan. AWS 
+ Nilai nol hadir dalam bidang integer. Salah satu solusinya adalah membuat kolom dengan nilai nol sebagai `string` dan kemudian digunakan `CAST` untuk mengonversi bidang dalam kueri, memberikan nilai default untuk nol. `0` Untuk informasi lebih lanjut, lihat [Ketika saya menanyakan data CSV di Athena, saya mendapatkan kesalahan “HIVE\$1BAD\$1DATA: Nilai bidang penguraian kesalahan" untuk bidang x: Untuk string input: “"” di Pusat](https://aws.amazon.com/premiumsupport/knowledge-center/athena-hive-bad-data-error-csv/) Pengetahuan. AWS 

### HIVE\$1CANNOT\$1OPEN\$1SPLIT: Kesalahan saat membuka pemisahan Hive s3://amzn-s3-demo-bucket
<a name="troubleshooting-athena-hive_cannot_open_split-error-opening-hive-split-s3bucket-name"></a>

Kesalahan ini dapat terjadi saat Anda menanyakan awalan bucket Amazon S3 yang memiliki banyak objek. Untuk informasi lebih lanjut, lihat [Bagaimana cara mengatasi kesalahan “HIVE\$1CANNOT\$1OPEN\$1SPLIT: Error opening Hive split s3://amzn-s3-demo-bucket/: Slow](https://aws.amazon.com/premiumsupport/knowledge-center/hive-cannot-open-split-503-athena/) down” di Athena? di pusat AWS pengetahuan.

### HIVE\$1CURSOR\$1ERROR: com.amazonaws.services.s3.model.amazons3Exception: Kunci yang ditentukan tidak ada
<a name="troubleshooting-athena-hive_cursor_error-com.amazonaws.services.s3.model.amazons3exception-the-specified-key-does-not-exist"></a>

Kesalahan ini biasanya terjadi ketika file dihapus ketika kueri sedang berjalan. Jalankan kembali kueri, atau periksa alur kerja Anda untuk melihat apakah pekerjaan atau proses lain memodifikasi file saat kueri sedang berjalan.

### HIVE\$1CURSOR\$1ERROR: Akhir aliran input yang tidak terduga
<a name="troubleshooting-athena-hive_cursor_error-unexpected-end-of-input-stream"></a>

Pesan ini menunjukkan file rusak atau kosong. Periksa integritas file dan jalankan kembali kueri.

### HIVE\$1FILESYSTEM\$1ERROR: FileSize salah untuk file *1234567*
<a name="troubleshooting-athena-hive_filesystem_error-incorrect-file-size"></a>

Pesan ini dapat terjadi ketika file telah berubah antara perencanaan kueri dan eksekusi kueri. Biasanya terjadi ketika file di Amazon S3 diganti di tempat (misalnya, a `PUT` dilakukan pada kunci di mana objek sudah ada). Athena tidak mendukung penghapusan atau penggantian isi file saat kueri sedang berjalan. Untuk menghindari kesalahan ini, jadwalkan pekerjaan yang menimpa atau menghapus file pada saat kueri tidak berjalan, atau hanya menulis data ke file atau partisi baru.

### HIVE\$1UNKNOWN\$1ERROR: Tidak dapat membuat format masukan
<a name="troubleshooting-athena-hive_unknown_error-unable-to-create-input-format"></a>

Kesalahan ini dapat disebabkan oleh masalah seperti berikut:
+  AWS Glue Crawler tidak dapat mengklasifikasikan format data
+ Properti definisi AWS Glue tabel tertentu kosong
+ Athena tidak mendukung format data file di Amazon S3

Untuk informasi selengkapnya, lihat [Bagaimana cara mengatasi kesalahan “tidak dapat membuat format input” di Athena](https://aws.amazon.com/premiumsupport/knowledge-center/athena-unable-to-create-input-format/)? di Pusat AWS Pengetahuan atau tonton [video](https://www.youtube.com/watch?v=CGzXW3hRa8g) Pusat Pengetahuan.

### Lokasi S3 yang disediakan untuk menyimpan hasil kueri Anda tidak valid.
<a name="troubleshooting-athena-the-s3-location-provided-to-save-your-query-results-is-invalid."></a>

Pastikan Anda telah menentukan lokasi S3 yang valid untuk hasil kueri Anda. Untuk informasi selengkapnya, lihat [Tentukan lokasi hasil kueri](query-results-specify-location.md) dalam topik [Bekerja dengan hasil kueri dan kueri terbaru](querying.md).

## Tabel Linux Foundation Delta Lake
<a name="troubleshooting-athena-delta-lake-tables"></a>

### Skema tabel Delta Lake tidak sinkron
<a name="troubleshooting-athena-delta-lake-table-schema-out-of-sync"></a>

Saat Anda menanyakan tabel Delta Lake yang memiliki skema AWS Glue yang sudah usang, Anda dapat menerima pesan galat berikut:

```
INVALID_GLUE_SCHEMA: Delta Lake table schema in Glue does not match the most recent schema of the 
Delta Lake transaction log. Please ensure that you have the correct schema defined in Glue.
```

Skema dapat menjadi usang jika dimodifikasi AWS Glue setelah ditambahkan ke Athena. Untuk memperbarui skema, lakukan salah satu langkah berikut:
+ Masuk AWS Glue, jalankan [AWS Glue crawler](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html).
+ Di Athena, [jatuhkan meja](drop-table.md) dan [buat lagi](create-table.md).
+ Tambahkan kolom yang hilang secara manual, baik dengan menggunakan [ALTER TABLE ADD COLUMNS](alter-table-add-columns.md) pernyataan di Athena, atau dengan [mengedit skema tabel di](https://docs.aws.amazon.com/glue/latest/dg/console-tables.html#console-tables-details). AWS Glue

## Pertanyaan federasi
<a name="troubleshooting-athena-federated-queries"></a>

### Batas waktu saat menelepon ListTableMetadata
<a name="troubleshooting-athena-federated-queries-list-table-metadata-timeout"></a>

Panggilan ke [ListTableMetadata](https://docs.aws.amazon.com/athena/latest/APIReference/API_ListTableMetadata.html)API dapat batas waktu jika ada banyak tabel di sumber data, jika sumber data lambat, atau jika jaringan lambat. Untuk memecahkan masalah ini, coba langkah-langkah berikut.
+ **Periksa jumlah tabel** — Jika Anda memiliki lebih dari 1000 tabel, coba kurangi jumlah tabel. Untuk `ListTableMetadata` respons tercepat, kami sarankan memiliki kurang dari 1000 tabel per katalog.
+ **Periksa konfigurasi Lambda** - Memantau perilaku fungsi Lambda sangat penting. Saat Anda menggunakan katalog federasi, pastikan untuk memeriksa log eksekusi fungsi Lambda. Berdasarkan hasil, sesuaikan nilai memori dan batas waktu yang sesuai. Untuk mengidentifikasi potensi masalah dengan batas waktu, kunjungi kembali konfigurasi Lambda Anda. Untuk informasi selengkapnya, lihat [Mengonfigurasi batas waktu fungsi (konsol)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-timeout-console) di Panduan *AWS Lambda Pengembang*.
+ **Periksa log sumber data federasi** — Periksa log dan pesan kesalahan dari sumber data federasi untuk melihat apakah ada masalah atau kesalahan. Log dapat memberikan wawasan berharga tentang penyebab batas waktu.
+ **Gunakan `StartQueryExecution` untuk mengambil metadata** — Jika Anda memiliki lebih dari 1000 tabel, dibutuhkan waktu lebih lama dari yang diharapkan untuk mengambil metadata menggunakan konektor federasi Anda. Karena sifat asinkron memastikan [StartQueryExecution](https://docs.aws.amazon.com/athena/latest/APIReference/API_StartQueryExecution.html)bahwa Athena menjalankan kueri dengan cara yang paling optimal, pertimbangkan untuk menggunakan `StartQueryExecution` sebagai alternatif untuk. `ListTableMetadata` AWS CLI Contoh berikut menunjukkan bagaimana `StartQueryExecution` bisa digunakan bukan `ListTableMetadata` untuk mendapatkan semua metadata tabel dalam katalog data Anda.

  Pertama, jalankan query yang mendapatkan semua tabel, seperti pada contoh berikut.

  ```
  aws athena start-query-execution --region us-east-1 \
  --query-string "SELECT table_name FROM information_schema.tables LIMIT 50" \
  --work-group "your-work-group-name"
  ```

  Selanjutnya, ambil metadata tabel individual, seperti pada contoh berikut.

  ```
  aws athena start-query-execution --region us-east-1 \
  --query-string "SELECT * FROM information_schema.columns \
  WHERE table_name = 'your-table-name' AND \
  table_catalog = 'your-catalog-name'" \
  --work-group "your-work-group-name"
  ```

  Waktu yang dibutuhkan untuk mendapatkan hasil tergantung pada jumlah tabel dalam katalog Anda.

[Untuk informasi selengkapnya tentang pemecahan masalah kueri gabungan, lihat [Common\$1Problems](https://github.com/awslabs/aws-athena-query-federation/wiki/Common_Problems) di aws-athena-query-federation bagian awslabs/, GitHub atau lihat dokumentasi untuk masing-masing konektor sumber data Athena.](connectors-available.md)

## Kesalahan terkait JSON
<a name="troubleshooting-athena-json-related-errors"></a>

### Kesalahan data NULL atau salah saat mencoba membaca data JSON
<a name="troubleshooting-athena-null-or-incorrect-data-errors-when-trying-to-read-json-data"></a>

Kesalahan data NULL atau salah saat Anda mencoba membaca data JSON dapat disebabkan oleh sejumlah penyebab. Untuk mengidentifikasi garis yang menyebabkan kesalahan saat Anda menggunakan OpenX SerDe, atur `ignore.malformed.json` ke. `true` Catatan cacat akan kembali sebagai NULL. [Untuk informasi lebih lanjut, lihat [Saya mendapatkan kesalahan ketika saya mencoba membaca data JSON di Amazon](https://aws.amazon.com/premiumsupport/knowledge-center/error-json-athena/) Athena di AWS Pusat Pengetahuan atau menonton video Pusat Pengetahuan.](https://youtu.be/ME7Pv1qPFLM)

### HIVE\$1BAD\$1DATA: Kesalahan mengurai nilai bidang untuk bidang 0: java.lang.String tidak dapat dilemparkan ke org.openx.data.jsonserde.json. JSONObject
<a name="troubleshooting-athena-hive-bad-data-openx-json-serde"></a>

Ini [OpenX JSON SerDe](openx-json-serde.md) melempar kesalahan ini ketika gagal mengurai kolom dalam kueri Athena. Ini bisa terjadi jika Anda mendefinisikan kolom sebagai `map` atau`struct`, tetapi data yang mendasarinya sebenarnya adalah`string`,`int`, atau tipe primitif lainnya.

### HIVE\$1CURSOR\$1ERROR: Baris bukan objek JSON yang valid -: Kunci duplikat JSONException
<a name="troubleshooting-athena-hive_cursor_error-row-is-not-a-valid-json-object---jsonexception-duplicate-key"></a>

Kesalahan ini terjadi ketika Anda menggunakan Athena untuk menanyakan AWS Config sumber daya yang memiliki beberapa tag dengan nama yang sama dalam kasus yang berbeda. Solusinya adalah menjalankan `CREATE TABLE` menggunakan `WITH SERDEPROPERTIES 'case.insensitive'='false'` dan memetakan nama. Untuk informasi tentang `case.insensitive` dan pemetaan, lihat[Perpustakaan JSON SerDe](json-serde.md). Untuk informasi lebih lanjut, lihat [Bagaimana cara mengatasi “HIVE\$1CURSOR\$1ERROR: Baris bukan objek JSON yang valid - JSONException: Kunci duplikat”](https://aws.amazon.com/premiumsupport/knowledge-center/json-duplicate-key-error-athena-config/) saat membaca file dari Athena? AWS Config di pusat AWS pengetahuan.

### Pesan HIVE\$1CURSOR\$1ERROR dengan JSON yang dicetak cantik
<a name="troubleshooting-athena-json-serde-hive-cursor-error"></a>

[OpenX JSON SerDe](openx-json-serde.md)Pustaka [Sarang JSON SerDe](hive-json-serde.md) dan mengharapkan setiap dokumen JSON berada pada satu baris teks tanpa karakter penghentian baris yang memisahkan bidang dalam catatan. Jika teks JSON dalam format cetak cantik, Anda mungkin menerima pesan kesalahan seperti HIVE\$1CURSOR\$1ERROR: Row is not a valid JSON Object or HIVE\$1CURSOR\$1ERROR:: Unexpected JsonParseException end-of-input: expected close marker for OBJECT saat Anda mencoba menanyakan tabel setelah Anda membuatnya. Untuk informasi selengkapnya, lihat [file data JSON](https://github.com/rcongiu/Hive-JSON-Serde#json-data-files) dalam dokumentasi SerDe OpenX pada. GitHub

### Beberapa catatan JSON mengembalikan HITUNGAN SELECT 1
<a name="troubleshooting-athena-multiple-json-records-return-a-select-count-of-1"></a>

Jika Anda menggunakan[OpenX JSON SerDe](openx-json-serde.md), pastikan bahwa catatan dipisahkan oleh karakter baris baru. Untuk informasi selengkapnya, lihat [Kueri SELECT COUNT di Amazon Athena hanya menampilkan satu catatan meskipun file JSON masukan memiliki beberapa catatan di Pusat](https://aws.amazon.com/premiumsupport/knowledge-center/select-count-query-athena-json-records/) Pengetahuan. AWS 

### Tidak dapat menanyakan tabel yang dibuat oleh AWS Glue crawler yang menggunakan pengklasifikasi JSON kustom
<a name="troubleshooting-athena-cannot-query-a-table-created-by-a-glue-crawler-that-uses-a-custom-json-classifier"></a>

Mesin Athena tidak mendukung pengklasifikasi [JSON khusus](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json). Untuk mengatasi masalah ini, buat tabel baru tanpa pengklasifikasi khusus. Untuk mengubah JSON, Anda dapat menggunakan CTAS atau membuat tampilan. Misalnya, jika Anda bekerja dengan array, Anda dapat menggunakan opsi UNNEST untuk meratakan JSON. Pilihan lain adalah menggunakan pekerjaan AWS Glue ETL yang mendukung pengklasifikasi khusus, mengonversi data menjadi parket di Amazon S3, dan kemudian menanyakannya di Athena.

## TABEL PERBAIKAN MSCK
<a name="troubleshooting-athena-msck-repair-table"></a>

Untuk informasi tentang masalah terkait MSCK REPAIR TABLE, lihat [Pemecahan masalah](msck-repair-table.md#msck-repair-table-troubleshooting) bagian [Pertimbangan dan batasan](msck-repair-table.md#msck-repair-table-considerations) dan [MSCK REPAIR TABLE](msck-repair-table.md) halaman.

## Masalah keluaran
<a name="troubleshooting-athena-output-issues"></a>

### Tidak dapat verify/create mengeluarkan bucket
<a name="troubleshooting-athena-unable-to-verifycreate-output-bucket"></a>

Kesalahan ini dapat terjadi jika lokasi hasil kueri yang ditentukan tidak ada atau jika izin yang tepat tidak ada. Untuk informasi selengkapnya, lihat [Bagaimana cara mengatasi kesalahan “tidak dapat verify/create mengeluarkan bucket” di Amazon Athena](https://aws.amazon.com/premiumsupport/knowledge-center/athena-output-bucket-error/)? di pusat AWS pengetahuan.

### Hasil TIMESTAMP kosong
<a name="troubleshooting-athena-timestamp-result-is-empty"></a>

Athena membutuhkan format Java TIMESTAMP. Untuk informasi selengkapnya, lihat [Saat saya menanyakan tabel di Amazon Athena, hasil TIMESTAMP kosong di Pusat](https://aws.amazon.com/premiumsupport/knowledge-center/query-table-athena-timestamp-empty/) Pengetahuan. AWS 

### Simpan output kueri Athena dalam format selain CSV
<a name="troubleshooting-athena-store-athena-query-output-in-a-format-other-than-csv"></a>

Secara default, Athena hanya mengeluarkan file dalam format CSV. Untuk menampilkan hasil `SELECT` kueri dalam format yang berbeda, Anda dapat menggunakan `UNLOAD` pernyataan tersebut. Untuk informasi selengkapnya, lihat [MEMBONGKAR](unload.md). Anda juga dapat menggunakan kueri CTAS yang menggunakan [properti `format` tabel](create-table-as.md#ctas-table-properties) untuk mengkonfigurasi format output. Tidak seperti`UNLOAD`, teknik CTAS membutuhkan pembuatan tabel. Untuk informasi selengkapnya, [lihat Bagaimana cara menyimpan output kueri Athena dalam format selain CSV, seperti format terkompresi?](https://aws.amazon.com/premiumsupport/knowledge-center/athena-query-output-different-format/) di pusat AWS pengetahuan.

### Lokasi S3 yang disediakan untuk menyimpan hasil kueri Anda tidak valid
<a name="troubleshooting-athena-the-s3-location-provided-to-save-your-query-results-is-invalid"></a>

Anda dapat menerima pesan galat ini jika lokasi bucket keluaran tidak berada di Region yang sama dengan Region tempat Anda menjalankan kueri. Untuk menghindari hal ini, tentukan lokasi hasil kueri di Wilayah tempat Anda menjalankan kueri. Untuk langkah, lihat [Tentukan lokasi hasil kueri](query-results-specify-location.md).

## Masalah parket
<a name="troubleshooting-athena-parquet-issues"></a>

### org.apache.parquet.io. GroupColumnIO tidak dapat dilemparkan ke org.apache.parquet.io. PrimitiveColumnIO
<a name="troubleshooting-athena-org.apache.parquet.io.groupcolumnio-cannot-be-cast-to-org.apache.parquet.io.primitivecolumnio"></a>

Kesalahan ini disebabkan oleh ketidakcocokan skema parket. Kolom yang memiliki tipe non-primitif (misalnya,`array`) telah dideklarasikan sebagai tipe primitif (misalnya,`string`) di. AWS Glue Untuk memecahkan masalah ini, periksa skema data dalam file dan bandingkan dengan skema yang dideklarasikan. AWS Glue

### Masalah statistik parket
<a name="troubleshooting-athena-parquet-statistics-issues"></a>

Ketika Anda membaca data Parket, Anda mungkin menerima pesan kesalahan seperti berikut:

```
HIVE_CANNOT_OPEN_SPLIT: Index x out of bounds for length y
HIVE_CURSOR_ERROR: Failed to read x bytes
HIVE_CURSOR_ERROR: FailureException at Malformed input: offset=x
HIVE_CURSOR_ERROR: FailureException at java.io.IOException: 
can not read class org.apache.parquet.format.PageHeader: Socket is closed by peer.
```

Untuk mengatasi masalah ini, gunakan [ALTER TABLE SET TBLPROPERTIES](alter-table-set-tblproperties.md) pernyataan [CREATE TABLE](create-table.md) or untuk menyetel SerDe `parquet.ignore.statistics` properti Parket`true`, seperti pada contoh berikut. 

CREATE TABLE contoh

```
...
ROW FORMAT SERDE  
'org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe' 
WITH SERDEPROPERTIES ('parquet.ignore.statistics'='true')  
STORED AS PARQUET 
...
```

Contoh ALTER TABLE

```
ALTER TABLE ... SET TBLPROPERTIES ('parquet.ignore.statistics'='true')
```

Untuk informasi lebih lanjut tentang Parquet Hive SerDe, lihat. [Parket SerDe](parquet-serde.md) 

## Masalah partisi
<a name="troubleshooting-athena-partitioning-issues"></a>

### MSCK REPAIR TABLE tidak menghapus partisi basi
<a name="troubleshooting-athena-msck-repair-table-does-not-remove-stale-partitions"></a>

Jika Anda menghapus partisi secara manual di Amazon S3 dan kemudian menjalankan MSCK REPAIR TABLE, Anda mungkin menerima pesan kesalahan Partisi hilang dari sistem file. Hal ini terjadi karena MSCK REPAIR TABLE tidak menghapus partisi basi dari metadata tabel. Gunakan [ALTER TABLE DROP PARTITION](alter-table-drop-partition.md) untuk menghapus partisi basi secara manual. Untuk informasi selengkapnya, lihat bagian “Pemecahan Masalah” pada topik. [MSCK REPAIR TABLE](msck-repair-table.md)

### Kegagalan TABEL PERBAIKAN MSCK
<a name="troubleshooting-athena-msck-repair-table-failure"></a>

Ketika sejumlah besar partisi (misalnya, lebih dari 100.000) dikaitkan dengan tabel tertentu, `MSCK REPAIR TABLE` dapat gagal karena keterbatasan memori. Untuk mengatasi batas ini, gunakan [ALTER TABLE ADD PARTITION](alter-table-add-partition.md) sebagai gantinya.

### MSCK REPAIR TABLE mendeteksi partisi tetapi tidak menambahkannya AWS Glue
<a name="troubleshooting-athena-msck-repair-table-detects-partitions-but-doesnt-add-them-to-glue"></a>

Masalah ini dapat terjadi jika jalur Amazon S3 dalam kasus unta, bukan huruf kecil atau kebijakan IAM tidak mengizinkan tindakan tersebut. `glue:BatchCreatePartition` Untuk informasi lebih lanjut, lihat [MSCK REPAIR TABLE mendeteksi partisi di Athena tetapi tidak menambahkannya ke](https://aws.amazon.com/premiumsupport/knowledge-center/athena-aws-glue-msck-repair-table/) dalam Pusat Pengetahuan. AWS Glue Data Catalog AWS 

### Proyeksi partisi berkisar dengan format tanggal dd-MM-yyyy-HH -mm-ss atau tidak berfungsi yyyy-MM-dd
<a name="troubleshooting-athena-partition-projection-ranges-with-the-date-format-of-dd-mm-yyyy-hh-mm-ss-or-yyyy-mm-dd-do-not-work"></a>

Agar berfungsi dengan benar, format tanggal harus diatur ke`yyyy-MM-dd HH:00:00`. Untuk informasi selengkapnya, lihat [Proyeksi partisi Stack Overflow post Athena tidak](https://stackoverflow.com/questions/63943920/athena-partition-projection-not-working-as-expected) berfungsi seperti yang diharapkan.

### PARTITION BY tidak mendukung tipe BIGINT
<a name="troubleshooting-athena-partition-by-doesnt-support-the-bigint-type"></a>

Konversikan tipe data ke `string` dan coba lagi.

### Tidak ada partisi yang berarti tersedia
<a name="troubleshooting-athena-no-meaningful-partitions-available"></a>

Pesan kesalahan ini biasanya berarti pengaturan partisi telah rusak. Untuk mengatasi masalah ini, jatuhkan tabel dan buat tabel dengan partisi baru.

### Proyeksi partisi tidak bekerja bersama dengan partisi rentang
<a name="troubleshooting-athena-partition-projection-does-not-work-in-conjunction-with-range-partitions"></a>

Periksa apakah [proyeksi unit rentang waktu. *<columnName>*.interval.unit](partition-projection-supported-types.md#partition-projection-date-type) cocok dengan pembatas untuk partisi. Misalnya, jika partisi dibatasi oleh hari, maka satuan rentang jam tidak akan berfungsi.

### Kesalahan proyeksi partisi ketika rentang ditentukan oleh tanda hubung
<a name="troubleshooting-athena-partition-projection-range-issue-with-hyphen"></a>

Menentukan properti `range` tabel dengan tanda hubung alih-alih koma menghasilkan kesalahan seperti INVALID\$1TABLE\$1PROPERTY: Untuk string input: "-". *number* *number* Pastikan bahwa nilai rentang dipisahkan oleh koma, bukan tanda hubung. Untuk informasi selengkapnya, lihat [Jenis bilangan bulat](partition-projection-supported-types.md#partition-projection-integer-type).

### HIVE\$1UNKNOWN\$1ERROR: Tidak dapat membuat format masukan
<a name="troubleshooting-athena-hive_unknown_error-unable-to-create-input-format-1"></a>

Satu atau lebih partisi lem dinyatakan dalam format yang berbeda karena setiap partisi lem memiliki format input spesifiknya sendiri secara independen. Silakan periksa bagaimana partisi Anda didefinisikan dalam AWS Glue.

### HIVE\$1PARTITION\$1SCHEMA\$1MISMATCH
<a name="troubleshooting-athena-hive_partition_schema_mismatch"></a>

Jika skema partisi berbeda dari skema tabel, kueri dapat gagal dengan pesan kesalahan HIVE\$1PARTITION\$1SCHEMA\$1MISMATCH.

Untuk setiap tabel dalam Katalog AWS Glue Data yang memiliki kolom partisi, skema disimpan pada tingkat tabel dan untuk setiap partisi individu dalam tabel. Skema untuk partisi diisi oleh AWS Glue crawler berdasarkan sampel data yang dibaca dalam partisi.

Saat Athena menjalankan kueri, itu memvalidasi skema tabel dan skema dari setiap partisi yang diperlukan untuk kueri. validasi membandingkan jenis data kolom dalam rangka dan memastikan bahwa mereka cocok untuk kolom yang tumpang tindih. Ini mencegah operasi tak terduga seperti menambahkan atau menghapus kolom dari tengah tabel. Jika Athena mendeteksi bahwa skema partisi berbeda dari skema tabel, Athena mungkin tidak dapat memproses kueri dan gagal dengan`HIVE_PARTITION_SCHEMA_MISMATCH`.

Ada beberapa cara untuk memperbaiki masalah ini. Pertama, jika data tidak sengaja ditambahkan, Anda dapat menghapus file data yang menyebabkan perbedaan dalam skema, menjatuhkan partisi, dan re-crawl data. Kedua, Anda dapat drop partisi individu dan kemudian jalankan`MSCK REPAIR`dalam Athena untuk menciptakan kembali partisi menggunakan skema tabel ini. Opsi kedua ini bekerja hanya jika Anda yakin bahwa skema diterapkan akan terus membaca data dengan benar.

### SemanticException tabel tidak dipartisi tetapi spesifikasi partisi ada
<a name="troubleshooting-athena-semanticexception-table-is-not-partitioned-but-partition-spec-exists"></a>

Kesalahan ini dapat terjadi ketika tidak ada partisi yang didefinisikan dalam `CREATE TABLE` pernyataan. Untuk informasi selengkapnya, [lihat Bagaimana cara memecahkan masalah kesalahan “GAGAL: SemanticException tabel tidak dipartisi tetapi spesifikasi partisi ada](https://aws.amazon.com/premiumsupport/knowledge-center/athena-failed-semanticexception-table/)” di Athena? di pusat AWS pengetahuan.

### `_$folder$`File byte nol
<a name="troubleshooting-athena-alter-table-add-partition-zero-byte-folder-files"></a>

Jika Anda menjalankan `ALTER TABLE ADD PARTITION` pernyataan dan salah menentukan partisi yang sudah ada dan lokasi Amazon S3 yang salah, file placeholder nol byte dari `partition_value_$folder$` format dibuat di Amazon S3. Anda harus menghapus file-file ini secara manual.

Untuk mencegah hal ini terjadi, gunakan `ADD IF NOT EXISTS` sintaks dalam `ALTER TABLE ADD PARTITION` pernyataan Anda, seperti ini:

```
ALTER TABLE table_name ADD IF NOT EXISTS PARTITIION […]
```

### Nol catatan dikembalikan dari data yang dipartisi
<a name="troubleshooting-athena-zero-records-returned-from-partitioned-data"></a>

Masalah ini dapat terjadi karena berbagai alasan. Untuk kemungkinan penyebab dan resolusi, lihat [Saya membuat tabel di Amazon Athena dengan partisi yang ditentukan, tetapi ketika saya menanyakan tabel, nol catatan dikembalikan di AWS Pusat](https://aws.amazon.com/premiumsupport/knowledge-center/athena-empty-results/) Pengetahuan.

Lihat juga [HIVE\$1TOO\$1MANY\$1OPEN\$1PARTITIONS](#troubleshooting-athena-ctas-hive-too-many-open-partitions).

## Izin
<a name="troubleshooting-athena-permissions"></a>

### Kesalahan akses ditolak saat menanyakan Amazon S3
<a name="troubleshooting-athena-access-denied-error-when-querying-amazon-s3"></a>

Hal ini dapat terjadi jika Anda tidak memiliki izin untuk membaca data di bucket, izin untuk menulis ke bucket hasil, atau jalur Amazon S3 berisi titik akhir Wilayah seperti. `us-east-1.amazonaws.com` Untuk informasi selengkapnya, lihat [Ketika saya menjalankan kueri Athena, saya mendapatkan kesalahan “akses ditolak”](https://aws.amazon.com/premiumsupport/knowledge-center/access-denied-athena/) di Pusat AWS Pengetahuan.

### Akses ditolak dengan kode status: Kesalahan 403 saat menjalankan kueri DDL pada data terenkripsi di Amazon S3
<a name="troubleshooting-athena-access-denied-error-when-querying-amazon-s3-encrypted"></a>

Ketika Anda mungkin menerima pesan kesalahan Akses Ditolak (Layanan: Amazon S3; Kode Status: 403; Kode Kesalahan: AccessDenied; ID Permintaan:*<request\$1id>*) jika kondisi berikut benar:

1. Anda menjalankan query DDL seperti `ALTER TABLE ADD PARTITION` atau`MSCK REPAIR TABLE`.

1. Anda memiliki bucket yang memiliki [enkripsi default](https://docs.aws.amazon.com/AmazonS3/latest/userguide/default-bucket-encryption.html) yang dikonfigurasi untuk digunakan`SSE-S3`.

1. Bucket juga memiliki kebijakan bucket seperti berikut ini yang memaksa `PutObject` permintaan untuk menentukan `PUT` header `"s3:x-amz-server-side-encryption": "true"` dan`"s3:x-amz-server-side-encryption": "AES256"`.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Deny",
               "Principal": "*",
               "Action": "s3:PutObject",
               "Resource": "arn:aws:s3:::<resource-name>/*",
               "Condition": {
                   "Null": {
                       "s3:x-amz-server-side-encryption": "true"
                   }
               }
           },
           {
               "Effect": "Deny",
               "Principal": "*",
               "Action": "s3:PutObject",
               "Resource": "arn:aws:s3:::<resource-name>/*",
               "Condition": {
                   "StringNotEquals": {
                       "s3:x-amz-server-side-encryption": "AES256"
                   }
               }
           }
       ]
   }
   ```

------

Dalam kasus seperti ini, solusi yang disarankan adalah menghapus kebijakan bucket seperti yang di atas mengingat enkripsi default bucket sudah ada.

### Akses ditolak dengan kode status: 403 saat menanyakan bucket Amazon S3 di akun lain
<a name="troubleshooting-athena-access-denied-with-status-code-403-when-querying-an-amazon-s3-bucket-in-another-account"></a>

Kesalahan ini dapat terjadi ketika Anda mencoba menanyakan log yang ditulis oleh orang lain Layanan AWS dan akun kedua adalah pemilik bucket tetapi tidak memiliki objek di ember. Untuk informasi lebih lanjut, lihat [saya mendapatkan pengecualian Amazon S3 “akses ditolak dengan kode status: 403" di Amazon Athena ketika saya menanyakan ember di akun lain di Pusat Pengetahuan](https://aws.amazon.com/premiumsupport/knowledge-center/athena-access-denied-status-code-403/). AWS 

### Gunakan kredensi peran IAM untuk terhubung ke driver Athena JDBC
<a name="troubleshooting-athena-use-IAM-role-credentials-to-connect-to-the-athena-jdbc-driver"></a>

Anda dapat mengambil kredensi sementara peran untuk mengautentikasi koneksi [JDBC](connect-with-jdbc.md) ke Athena. Kredensi sementara memiliki umur maksimum 12 jam. Untuk informasi selengkapnya, [lihat Bagaimana cara menggunakan kredensi peran IAM saya atau beralih ke peran IAM lain saat menyambung ke Athena](https://aws.amazon.com/premiumsupport/knowledge-center/athena-iam-jdbc-driver/) menggunakan driver JDBC? di pusat AWS pengetahuan.

### Deskriptor penyimpanan tabel yang diperlukan tidak diisi
<a name="troubleshooting-athena-access-denied-table-storage"></a>

Hal ini dapat terjadi ketika Anda mencoba untuk query atau melihat tabel yang Anda tidak memiliki izin untuk. Untuk ini, solusi yang disarankan adalah memberikan `DESCRIBE` dan `SELECT` mengizinkan sumber daya melalui AWS Lake Formation. Jika sumber daya Anda dibagikan di seluruh akun, di mana sumber daya asli ada di akun A dan Anda ingin melakukan kueri terhadap sumber daya tertaut di akun B. Anda harus memastikan bahwa peran Anda memiliki `DESCRIBE` izin pada sumber daya asli di akun A, dan `SELECT` izin pada sumber daya tertaut di akun B.

## Masalah sintaks kueri
<a name="troubleshooting-athena-query-syntax-issues"></a>

### GAGAL: NullPointerException nama adalah null
<a name="troubleshooting-athena-nullpointerexception-name-is-null"></a>

Jika Anda menggunakan operasi AWS Glue [CreateTable](https://docs.aws.amazon.com/glue/latest/webapi/API_CreateTable.html)API atau CloudFormation [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-table.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-table.html)template untuk membuat tabel untuk digunakan di Athena tanpa menentukan `TableType` properti dan kemudian menjalankan kueri DDL seperti `SHOW CREATE TABLE` atau`MSCK REPAIR TABLE`, Anda dapat menerima pesan kesalahan GAGAL: NullPointerException  Nama adalah null. 

Untuk mengatasi kesalahan, tentukan nilai [TableInput](https://docs.aws.amazon.com/glue/latest/webapi/API_TableInput.html)`TableType`atribut sebagai bagian dari panggilan AWS Glue `CreateTable` API atau [CloudFormation templat](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-glue-table-tableinput.html). Nilai yang mungkin untuk `TableType` include `EXTERNAL_TABLE` atau`VIRTUAL_VIEW`.

Persyaratan ini hanya berlaku ketika Anda membuat tabel menggunakan operasi AWS Glue `CreateTable` API atau `AWS::Glue::Table` template. Jika Anda membuat tabel untuk Athena menggunakan pernyataan DDL atau AWS Glue crawler, `TableType` properti didefinisikan untuk Anda secara otomatis. 

### Fungsi tidak terdaftar
<a name="troubleshooting-athena-function-not-registered"></a>

Kesalahan ini terjadi ketika Anda mencoba menggunakan fungsi yang tidak didukung Athena. Untuk daftar fungsi yang didukung Athena, lihat [Fungsi di Amazon Athena](functions.md) atau jalankan `SHOW FUNCTIONS` pernyataan di Editor Kueri. Anda juga dapat menulis [fungsi yang ditentukan pengguna (UDF)](querying-udf.md) Anda sendiri. Untuk informasi selengkapnya, lihat [Bagaimana cara mengatasi kesalahan sintaks “fungsi tidak terdaftar” di Athena](https://aws.amazon.com/premiumsupport/knowledge-center/athena-syntax-function-not-registered/)? di pusat AWS pengetahuan.

### PENGECUALIAN GENERIC\$1INTERNAL\$1ERROR
<a name="troubleshooting-athena-generic-internal-error"></a>

`GENERIC_INTERNAL_ERROR`pengecualian dapat memiliki berbagai penyebab, termasuk yang berikut:
+ **GENERIC\$1INTERNAL\$1ERROR: Null** — Anda mungkin melihat pengecualian ini di bawah salah satu kondisi berikut:
  + Anda memiliki ketidakcocokan skema antara tipe data kolom dalam definisi tabel dan tipe data aktual dari kumpulan data.
  + Anda menjalankan kueri `CREATE TABLE AS SELECT` (CTAS) dengan sintaks yang tidak akurat.
+ **GENERIC\$1INTERNAL\$1ERROR: Pembuat induk adalah null** - Anda mungkin melihat pengecualian ini saat Anda menanyakan tabel dengan kolom tipe data`array`, dan Anda menggunakan pustaka Open De. CSVSer CSVSerde Format Open tidak mendukung tipe `array` data.
+ **GENERIC\$1INTERNAL\$1ERROR: Nilai melebihi MAX\$1INT** — Anda mungkin melihat pengecualian ini ketika kolom data sumber didefinisikan dengan tipe data `INT` dan memiliki nilai numerik lebih besar dari 2.147,483.647.
+ **GENERIC\$1INTERNAL\$1ERROR: Nilai melebihi MAX\$1BYTE** — Anda mungkin melihat pengecualian ini ketika kolom data sumber memiliki nilai numerik melebihi ukuran yang diizinkan untuk tipe data. `BYTE` Tipe data `BYTE` setara dengan`TINYINT`. `TINYINT`adalah bilangan bulat bertanda 8-bit dalam format komplemen dua dengan nilai minimum -128 dan nilai maksimum 127.
+ **GENERIC\$1INTERNAL\$1ERROR: Jumlah nilai partisi tidak cocok dengan jumlah filter** — Anda mungkin melihat pengecualian ini jika Anda memiliki partisi yang tidak konsisten pada data Amazon Simple Storage Service (Amazon S3). Anda mungkin memiliki partisi yang tidak konsisten di bawah salah satu dari kondisi berikut:
  + Partisi di Amazon S3 telah berubah (contoh: partisi baru ditambahkan).
  + Jumlah kolom partisi dalam tabel tidak cocok dengan yang ada di metadata partisi.

Untuk informasi lebih rinci tentang masing-masing kesalahan ini, lihat [Bagaimana cara mengatasi kesalahan “GENERIC\$1INTERNAL\$1ERROR” saat saya menanyakan tabel](https://aws.amazon.com/premiumsupport/knowledge-center/athena-generic-internal-error/) di Amazon Athena? di pusat AWS pengetahuan.

### Jumlah grup yang cocok tidak cocok dengan jumlah kolom
<a name="troubleshooting-athena-number-of-matching-groups-doesnt-match-the-number-of-columns"></a>

Kesalahan ini terjadi ketika Anda menggunakan [Regex SerDe](regex-serde.md) dalam pernyataan CREATE TABLE dan jumlah grup pencocokan regex tidak cocok dengan jumlah kolom yang Anda tentukan untuk tabel. Untuk informasi selengkapnya, lihat [Bagaimana cara mengatasi RegexSerDe kesalahan “jumlah grup yang cocok tidak cocok dengan jumlah kolom” di Amazon Athena](https://aws.amazon.com/premiumsupport/knowledge-center/regexserde-error-athena-matching-groups/)? di pusat AWS pengetahuan.

### QueryString gagal memenuhi kendala: Anggota harus memiliki panjang kurang dari atau sama dengan 262144
<a name="troubleshooting-athena-querystring-failed-to-satisfy-constraint-member-must-have-length-less-than-or-equal-to-262144"></a>

Panjang string kueri maksimum di Athena (262.144 byte) bukanlah kuota yang dapat disesuaikan. AWS Dukungan tidak dapat menambah kuota untuk Anda, tetapi Anda dapat mengatasi masalah dengan membagi kueri panjang menjadi yang lebih kecil. Untuk informasi selengkapnya, lihat[Bagaimana cara meningkatkan panjang string kueri maksimum di Athena?](https://aws.amazon.com/premiumsupport/knowledge-center/athena-query-string-length/)di AWS Pusat Pengetahuan.

### SYNTAX\$1ERROR: Kolom tidak dapat diselesaikan
<a name="troubleshooting-athena-syntax_error-column-cannot-be-resolved"></a>

Kesalahan ini dapat terjadi ketika Anda menanyakan tabel yang dibuat oleh AWS Glue crawler dari file CSV yang dikodekan UTF-8 yang memiliki tanda urutan byte (BOM). AWS Glue tidak mengenali BOMs dan mengubahnya menjadi tanda tanya, yang tidak dikenali Amazon Athena. Solusinya adalah menghapus tanda tanya di Athena atau di. AWS Glue

### Terlalu banyak argumen untuk pemanggilan fungsi
<a name="troubleshooting-athena-too-many-arguments"></a>

Di mesin Athena versi 3, fungsi tidak dapat mengambil lebih dari 127 argumen. Keterbatasan ini berdasarkan desain. Jika Anda menggunakan fungsi dengan lebih dari 127 parameter, pesan kesalahan seperti berikut terjadi:

TOO\$1MANY\$1ARGUMENTS: baris: *nnn**nn*: Terlalu banyak argumen untuk panggilan fungsi (). *function\$1name*

Untuk mengatasi masalah ini, gunakan lebih sedikit parameter per panggilan fungsi.

## Masalah batas waktu kueri
<a name="troubleshooting-athena-query-timeout-issues"></a>

Jika Anda mengalami kesalahan batas waktu dengan kueri Athena Anda, periksa log Anda. CloudTrail Kueri dapat habis karena pembatasan atau Lake AWS Glue Formation. APIs Ketika kesalahan ini terjadi, pesan kesalahan terkait dapat menunjukkan masalah batas waktu kueri daripada masalah pelambatan. Untuk memecahkan masalah, Anda dapat memeriksa CloudTrail log Anda sebelum menghubungi. Dukungan Untuk informasi selengkapnya, lihat [AWS CloudTrail Log kueri](cloudtrail-logs.md) dan [Log panggilan API Amazon Athena dengan AWS CloudTrail](monitor-with-cloudtrail.md).

Untuk informasi tentang masalah batas waktu kueri dengan kueri gabungan saat Anda memanggil `ListTableMetadata` API, lihat. [Batas waktu saat menelepon ListTableMetadata](#troubleshooting-athena-federated-queries-list-table-metadata-timeout)

## Masalah pelambatan
<a name="troubleshooting-athena-throttling-issues"></a>

Jika kueri Anda melebihi batas layanan dependen seperti Amazon S3 AWS KMS,, AWS Glue, AWS Lambda atau, pesan berikut dapat diharapkan. Untuk mengatasi masalah ini, kurangi jumlah panggilan bersamaan yang berasal dari akun yang sama.


****  

| Layanan | Pesan kesalahan | 
| --- | --- | 
| AWS Glue | AWSGluePengecualian: Tingkat terlampaui. | 
| AWS KMS | Anda telah melampaui tingkat di mana Anda dapat menghubungi KMS. Kurangi frekuensi panggilan Anda. | 
| AWS Lambda |  Tarif terlampaui TooManyRequestsException  | 
| Amazon S3 | Amazons3Exception: Harap kurangi tingkat permintaan Anda. | 

Untuk informasi tentang cara mencegah pelambatan Amazon S3 saat Anda menggunakan Athena, lihat. [Cegah pelambatan Amazon S3](performance-tuning-s3-throttling.md)

## Tampilan
<a name="troubleshooting-athena-views"></a>

### Tampilan yang dibuat di shell Apache Hive tidak berfungsi di Athena
<a name="troubleshooting-athena-views-created-in-hive-shell-do-not-work-in-athena"></a>

Karena implementasinya yang berbeda secara fundamental, tampilan yang dibuat di Apache Hive shell tidak kompatibel dengan Athena. Untuk mengatasi masalah ini, buat kembali tampilan di Athena.

### Tampilan sudah basi; itu harus dibuat ulang
<a name="troubleshooting-athena-view-is-stale-it-must-be-re-created"></a>

Anda dapat menerima kesalahan ini jika tabel yang mendasari tampilan telah diubah atau dijatuhkan. Resolusinya adalah untuk menciptakan kembali tampilan. Untuk informasi lebih lanjut, [lihat Bagaimana cara mengatasi kesalahan “tampilan sudah basi; itu harus dibuat ulang” di Athena](https://aws.amazon.com/premiumsupport/knowledge-center/athena-view-is-stale-error/)? di pusat AWS pengetahuan.

## Grup Kerja
<a name="troubleshooting-athena-workgroups"></a>

Untuk informasi tentang pemecahan masalah grup kerja, lihat. [Memecahkan masalah kesalahan kelompok kerja](workgroups-troubleshooting.md)

## Sumber daya tambahan
<a name="troubleshooting-athena-additional-resources"></a>

Halaman-halaman berikut memberikan informasi tambahan untuk mengatasi masalah dengan Amazon Athena.
+ [Katalog kesalahan Athena](error-reference.md)
+ [Service Quotas](service-limits.md)
+ [Pertimbangan dan batasan untuk kueri SQL di Amazon Athena](other-notable-limitations.md)
+ [DDL tidak didukung](unsupported-ddl.md)
+ [Nama database, tabel, dan kolom](tables-databases-columns-names.md)
+ [Tipe data di Amazon Athena](data-types.md)
+ [Pilih SerDe untuk data Anda](supported-serdes.md)
+ [Gunakan kompresi di Athena](compression-formats.md)
+ [Melarikan diri dari kata kunci yang dicadangkan dalam kueri](reserved-words.md)
+ [Memecahkan masalah kesalahan kelompok kerja](workgroups-troubleshooting.md)

 AWS Sumber daya berikut juga dapat membantu:
+  [Topik Athena di pusat pengetahuan AWS](https://aws.amazon.com/premiumsupport/knowledge-center/#Amazon_Athena) 
+  [Pertanyaan Amazon Athena di re:posting AWS](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena)
+  [Posting Athena di blog data AWS besar](https://aws.amazon.com/blogs/big-data/tag/amazon-athena/) 

Pemecahan masalah sering membutuhkan permintaan berulang dan penemuan oleh seorang ahli atau dari komunitas pembantu. Jika Anda terus mengalami masalah setelah mencoba saran di halaman ini, hubungi AWS Dukungan (di, klik **Support Konsol Manajemen AWS, Support** **Center**) atau ajukan pertanyaan di [AWS re:post menggunakan tag](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) **Amazon Athena**.

# Katalog kesalahan Athena
<a name="error-reference"></a>

Athena menyediakan informasi kesalahan standar untuk membantu Anda memahami kueri yang gagal dan mengambil langkah-langkah setelah kegagalan kueri terjadi. `AthenaError`Fitur ini mencakup `ErrorCategory` bidang dan `ErrorType` bidang. `ErrorCategory`menentukan apakah penyebab kueri gagal adalah karena kesalahan sistem, kesalahan pengguna, atau kesalahan lainnya. `ErrorType`memberikan informasi yang lebih terperinci mengenai sumber kegagalan. Dengan menggabungkan dua bidang, Anda bisa mendapatkan pemahaman yang lebih baik tentang keadaan di sekitarnya dan penyebab kesalahan spesifik yang terjadi.

## Kategori kesalahan
<a name="error-reference-error-category"></a>

Tabel berikut mencantumkan nilai kategori kesalahan Athena dan artinya.


****  

| Kategori kesalahan | Sumber | 
| --- | --- | 
| 1 | SISTEM | 
| 2 | USER | 
| 3 | LAINNYA | 

## Referensi tipe kesalahan
<a name="error-reference-error-type-reference"></a>

Tabel berikut mencantumkan nilai jenis kesalahan Athena dan artinya.


****  

| Jenis kesalahan | Deskripsi | 
| --- | --- | 
| 0 | Kueri sumber daya yang habis pada faktor skala ini | 
| 1 | Kueri sumber daya yang habis pada faktor skala ini | 
| 2 | Kueri sumber daya yang habis pada faktor skala ini | 
| 3 | Kueri sumber daya yang habis pada faktor skala ini | 
| 4 | Kueri sumber daya yang habis pada faktor skala ini | 
| 5 | Kueri sumber daya yang habis pada faktor skala ini | 
| 6 | Kueri sumber daya yang habis pada faktor skala ini | 
| 7 | Kueri sumber daya yang habis pada faktor skala ini | 
| 8 | Kueri sumber daya yang habis pada faktor skala ini | 
| 100 | Kesalahan layanan internal | 
| 200 | Mesin kueri memiliki kesalahan internal | 
| 201 | Mesin kueri memiliki kesalahan internal | 
| 202 | Mesin kueri memiliki kesalahan internal | 
| 203 | Kesalahan driver | 
| 204 | Metastore memiliki kesalahan | 
| 205 | Mesin kueri memiliki kesalahan internal | 
| 206 | Waktu kueri habis | 
| 207 | Mesin kueri memiliki kesalahan internal | 
| 208 | Mesin kueri memiliki kesalahan internal | 
| 209 | Gagal membatalkan kueri | 
| 210 | Waktu kueri habis | 
| 211 | Mesin kueri memiliki kesalahan internal | 
| 212 | Mesin kueri memiliki kesalahan internal | 
| 213 | Mesin kueri memiliki kesalahan internal | 
| 214 | Mesin kueri memiliki kesalahan internal | 
| 215 | Mesin kueri memiliki kesalahan internal | 
| 216 | Mesin kueri memiliki kesalahan internal | 
| 217 | Mesin kueri memiliki kesalahan internal | 
| 218 | Mesin kueri memiliki kesalahan internal | 
| 219 | Mesin kueri memiliki kesalahan internal | 
| 220 | Mesin kueri memiliki kesalahan internal | 
| 221 | Mesin kueri memiliki kesalahan internal | 
| 222 | Mesin kueri memiliki kesalahan internal | 
| 223 | Mesin kueri memiliki kesalahan internal | 
| 224 | Mesin kueri memiliki kesalahan internal | 
| 225 | Mesin kueri memiliki kesalahan internal | 
| 226 | Mesin kueri memiliki kesalahan internal | 
| 227 | Mesin kueri memiliki kesalahan internal | 
| 228 | Mesin kueri memiliki kesalahan internal | 
| 229 | Mesin kueri memiliki kesalahan internal | 
| 230 | Mesin kueri memiliki kesalahan internal | 
| 231 | Mesin kueri memiliki kesalahan internal | 
| 232 | Mesin kueri memiliki kesalahan internal | 
| 233 | Kesalahan gunung es | 
| 234 | Kesalahan Lake Formation | 
| 235 | Mesin kueri memiliki kesalahan internal | 
| 236 | Mesin kueri memiliki kesalahan internal | 
| 237 | Kesalahan serialisasi | 
| 238 | Gagal mengunggah metadata ke Amazon S3 | 
| 239 | Kesalahan persistensi umum | 
| 240 | Gagal mengirimkan kueri | 
| 300 | Kesalahan layanan internal | 
| 301 | Kesalahan layanan internal | 
| 302 | Kesalahan layanan internal | 
| 303 | Kesalahan layanan internal | 
| 400 | Kesalahan layanan internal | 
| 401 | Gagal menulis hasil kueri ke Amazon S3 | 
| 402 | Gagal menulis hasil kueri ke Amazon S3 | 
| 1000 | Kesalahan pengguna | 
| 1001 | Kesalahan data | 
| 1002 | Kesalahan data | 
| 1003 | Tugas DDL gagal | 
| 1004 | Kesalahan skema | 
| 1005 | Kesalahan serialisasi | 
| 1006 | Kesalahan sintaks | 
| 1007 | Kesalahan data | 
| 1008 | Kueri ditolak | 
| 1009 | Kueri gagal | 
| 1010 | Kesalahan layanan internal | 
| 1011 | Kueri dibatalkan oleh pengguna | 
| 1012 | Mesin kueri memiliki kesalahan internal | 
| 1013 | Mesin kueri memiliki kesalahan internal | 
| 1014 | Kueri dibatalkan oleh pengguna | 
| 1100 | Argumen tidak valid disediakan | 
| 1101 | Properti tidak valid yang disediakan | 
| 1102 | Mesin kueri memiliki kesalahan internal | 
| 1103 | Properti tabel tidak valid disediakan | 
| 1104 | Mesin kueri memiliki kesalahan internal | 
| 1105 | Mesin kueri memiliki kesalahan internal | 
| 1106 | Argumen fungsi tidak valid disediakan | 
| 1107 | Tampilan tidak valid | 
| 1108 | Gagal mendaftarkan fungsi | 
| 1109 | Asalkan jalur Amazon S3 tidak ditemukan | 
| 1110 | Tabel atau tampilan yang disediakan tidak ada | 
| 1200 | Kueri tidak didukung | 
| 1201 | Dekoder yang disediakan tidak didukung | 
| 1202 | Jenis kueri tidak didukung | 
| 1300 | Kesalahan umum tidak ditemukan | 
| 1301 | Entitas umum tidak ditemukan | 
| 1302 | File tidak ditemukan | 
| 1303 | Fungsi yang disediakan atau implementasi fungsi tidak ditemukan | 
| 1304 | Mesin kueri memiliki kesalahan internal | 
| 1305 | Mesin kueri memiliki kesalahan internal | 
| 1306 | Bucket Amazon S3 tidak ditemukan | 
| 1307 | Mesin yang dipilih tidak ditemukan | 
| 1308 | Mesin kueri memiliki kesalahan internal | 
| 1400 | Kesalahan pelambatan | 
| 1401 | Kueri gagal karena AWS Glue pembatasan | 
| 1402 | Kueri gagal karena terlalu banyak versi tabel di AWS Glue | 
| 1403 | Kueri gagal karena pelambatan Amazon S3 | 
| 1404 | Kueri gagal karena Amazon Athena melambat | 
| 1405 | Kueri gagal karena Amazon Athena melambat | 
| 1406 | Kueri gagal karena Amazon Athena melambat | 
| 1500 | Kesalahan izin | 
| 1501 | Kesalahan izin Amazon S3 | 
| 1602 |  Melebihi batas kapasitas cadangan. Kapasitas yang tidak memadai untuk mengeksekusi query ini.  | 
| 1700 | Kueri gagal karena pengecualian internal Lake Formation | 
| 1701 | Kueri gagal karena pengecualian AWS Glue internal | 
| 9999 | Kesalahan layanan internal | 