Halaman ini menjelaskan kode status HTTP dan pesan error yang ditampilkan oleh BigQuery API. Anda dapat menggunakan kode ini untuk memecahkan masalah dan menyelesaikan kegagalan permintaan, serta memverifikasi perilaku API.
Untuk mengetahui informasi selengkapnya tentang error non-API, error konektivitas library klien, dan error konsol Google Cloud , lihat Pesan error.
Untuk mengetahui informasi selengkapnya tentang error kueri, lihat Memecahkan masalah error kueri.
Untuk mengetahui informasi selengkapnya tentang error streaming insert, lihat Memecahkan masalah streaming insert.
Format respons error
BigQuery menggunakan format pelaporan error HTTP standar untuk API-nya. Permintaan yang berhasil akan menampilkan kode status HTTP dalam rentang 2xx. Permintaan yang gagal akan menampilkan kode status dalam rentang 4xx dan 5xx. Permintaan yang
memerlukan pengalihan akan menampilkan kode status dalam rentang 3xx. Respons error biasanya menyertakan dokumen JSON dalam isi respons, yang berisi objek error dengan informasi tentang error tersebut.
Dalam respons BigQuery API, objek error biasanya berupa salah satu dari hal berikut:
- Objek
errors, yang berisi array objekErrorProto. - Objek
errorResults, yang berisi satu objekErrorProto.
Kolom Alasan dalam tabel kode status di halaman ini dipetakan ke
properti reason dalam objek ErrorProto. Jika Anda menggunakan
alat command line bq untuk memeriksa status tugas, gunakan
flag --format=prettyjson (misalnya,
bq --format=prettyjson show -j <var>JOB_ID</var>) atau --apilog=stdout untuk melihat
objek error dan properti reason-nya.
Tabel berikut menjelaskan elemen yang dapat muncul dalam isi respons error. Kolom harus digunakan bersama untuk membantu menentukan masalah. Selain itu, nilai contoh dalam tabel berikut dimaksudkan untuk ilustrasi dan bukan daftar lengkap semua nilai yang mungkin.
| Elemen | Deskripsi |
|---|---|
code |
Nilai kode status HTTP, tanpa deskripsi tekstual. Contoh nilai mencakup: 400 (Permintaan Buruk), 403 (Dilarang), dan 404 (Tidak Ditemukan). |
error |
Penampung untuk informasi error. |
errors |
Penampung untuk detail error. |
error.domain |
Cakupan error. Contoh nilai mencakup: global dan usageLimits. |
error.location |
Item tertentu dalam locationType yang menyebabkan error. Misalnya, jika Anda menentukan nilai yang tidak valid untuk parameter, location akan menjadi nama parameter.Contoh nilai mencakup: Authorization dan project. |
error.locationType |
Lokasi atau bagian permintaan yang menyebabkan error. Gunakan dengan location untuk menunjukkan error.Contoh nilai mencakup header dan parameter. |
error.message |
Deskripsi error. Contoh nilai mencakup Invalid argument, Access Denied, dan Not Found: Dataset myproject:foo. |
error.reason |
ID unik untuk penyebab error. Contoh nilai mencakup invalid, accessDenied, dan notFound. |
message |
Deskripsi error. Sama seperti errors.message. |
Kode status dan error HTTP
Bagian ini berisi daftar tidak lengkap kode status dan kode error HTTP dari BigQuery API. Kode Informasi 1xx dan kode Berhasil 2xx dihilangkan. Untuk mengetahui informasi selengkapnya, lihat Kode Status Respons di RFC 7231 §6, RFC 7232 §4, RFC 7233 §4, RFC 7235 §3, dan RFC 6585.
400 — Bad Request
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
badRequest |
400 |
Pernyataan DML mencoba mengubah baris yang baru-baru ini di-streaming dengan |
Migrasikan ke BigQuery Storage Write API (gRPC), tunggu beberapa menit hingga buffering streaming dihapus, atau filter pernyataan Anda untuk mengecualikan baris yang baru saja di-streaming. Untuk mengetahui informasi selengkapnya, lihat Pernyataan DML pada tabel dengan buffering streaming. |
invalid |
400 |
Permintaan berisi input yang tidak valid selain kueri yang tidak valid, termasuk kasus berikut:
|
Pastikan skema yang disediakan cocok dengan kolom dan mode yang ada, ratakan struktur yang melebihi 15 tingkat bertingkat (atau simpan sebagai |
invalidQuery |
400 |
Kueri SQL gagal dalam pemeriksaan validasi atau eksekusi karena salah satu alasan berikut:
|
Periksa lokasi |
jobBackendError |
400 |
Di |
Coba lagi tugas dengan |
jobInternalError |
400 |
Di |
Coba lagi tugas dengan |
preconditionFailed |
400 |
Prasyarat permintaan tidak terpenuhi, termasuk kasus berikut:
|
Ambil resource |
resourceInUse |
400 |
Permintaan penghapusan menargetkan resource yang masih aktif atau terisi:
Error menampilkan: |
Kosongkan set data sebelum menghapusnya (atau tetapkan
|
resourcesExceeded |
400 |
Tugas melebihi batas resource eksekusi di salah satu area berikut:
Error menampilkan: |
Sederhanakan kueri, operasi DML batch, kurangi kolom atau partisi yang dipindai, hindari tugas serentak dalam sesi yang sama, atau sediakan kapasitas slot khusus untuk workload yang memerlukan banyak shuffle. Untuk langkah-langkah per subjenis, lihat Memecahkan masalah resource yang melebihi batas dan Kueri melebihi resource memori. |
storageUnusable |
400 |
Penyimpanan BigQuery internal yang menyimpan data tabel
tidak tersedia untuk sementara karena masalah penyimpanan di sisi layanan. Error akan menampilkan:
|
Coba lagi tugas menggunakan backoff eksponensial terpotong. Untuk mengetahui informasi selengkapnya, lihat Penyimpanan tabel tidak dapat digunakan. |
streamingDataUnavailable |
400 |
Data yang baru-baru ini di-streaming di penyimpanan yang dioptimalkan untuk tulis tidak tersedia untuk sementara
bagi tugas pembacaan. Error menampilkan: |
Coba lagi tugas dengan |
tableUnavailable |
400 |
BigQuery tidak dapat membaca tabel yang datanya tidak dikelola, termasuk kasus berikut:
|
Coba lagi waktu tunggu pengambilan skema atau tabel pendukung menggunakan
exponential backoff
terpotong, atau verifikasi jalur URI Cloud Storage |
userOwnedResourceError |
400 |
Resource eksternal yang Anda miliki menampilkan error saat diakses oleh BigQuery. Error menampilkan: |
Periksa resource_type dan resource_name dalam pesan error untuk mengidentifikasi resource eksternal, dan selesaikan error mendasar yang dilaporkan di external_error. Untuk mengetahui informasi selengkapnya, lihat Error resource eksternal milik pengguna. |
vortexDataUnavailable |
400 |
Data yang baru-baru ini di-streaming menggunakan BigQuery Storage Write API (gRPC) ke penyimpanan yang dioptimalkan untuk penulisan tidak tersedia untuk sementara untuk kueri. Error menampilkan: |
Coba lagi tugas kueri dengan |
billingTierLimitExceeded |
400 |
Kueri on-demand melebihi
batas penggunaan CPU maksimum per data
yang dipindai. Error menampilkan: |
Lakukan refaktorisasi SQL Anda untuk menghapus Cartesian product yang tidak diinginkan, penggabungan yang tidak tepat, fungsi jendela yang tidak dipartisi, atau UDF JavaScript yang berat, atau beralih ke harga berbasis kapasitas (slot). Untuk mengetahui informasi selengkapnya, lihat Kueri melebihi resource CPU dan Hindari anti-pola SQL. |
bytesBilledLimitExceeded |
400 |
Perkiraan byte batas atas pra-eksekusi untuk kueri melebihi
|
Lihat pratinjau estimasi byte dengan
uji coba, pilih hanya kolom yang diperlukan,
dan filter pada kolom yang dipartisi untuk
mengurangi
pemrosesan data, atau naikkan |
jobRateLimitExceeded |
400 |
Di
|
Kurangi pengiriman serentak (atau gunakan prioritas batch atau penskalaan otomatis slot untuk kueri berkelanjutan), dan coba lagi tugas dengan |
timeout |
400 |
Operasi melebihi batas waktu eksekusinya, termasuk kasus berikut:
|
Filter pada kolom yang dipartisi atau dikelompokkan dan bagi kueri kompleks atau multi-pernyataan menjadi tahap yang lebih kecil, atau tentukan skema eksplisit dan URI sumber yang lebih sempit saat membuat tabel eksternal. Untuk mengetahui informasi selengkapnya, lihat Kueri melebihi batas waktu eksekusi dan Memecahkan masalah error kuota dan batas. |
invalidUser |
400 |
Kueri terjadwal dikonfigurasi dengan kredensial pengguna yang tidak valid. |
Muat ulang kredensial pengguna untuk kueri terjadwal. Untuk mengetahui informasi selengkapnya, lihat Menjadwalkan kueri. |
required |
400 |
Input yang diperlukan tidak ada sebelum eksekusi:
Error menampilkan: |
Verifikasi isi permintaan dan parameter kueri yang diperlukan dalam referensi BigQuery API atau dokumentasi library klien, dan periksa objek konfigurasi sebelum memanggil API. Untuk mengetahui informasi selengkapnya, lihat Parameter yang diperlukan tidak ada. |
401 — Unauthorized
Berikut adalah contoh respons error yang Anda terima jika permintaan Anda tidak memiliki kredensial autentikasi yang valid.
401 Unauthorized
{
"error": {
"errors": [
{
"domain": "global",
"reason": "unauthenticated",
"message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential."
}
],
"code": 401,
"message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential.",
"status": "UNAUTHENTICATED"
}
}
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
unauthenticated |
401 |
Autentikasi untuk permintaan gagal karena salah satu alasan berikut:
|
Perbarui OAuth atau Kredensial Default Aplikasi Anda, berikan
|
403 — Forbidden
Berikut adalah contoh respons error yang Anda terima jika Anda tidak memiliki izin untuk mengakses resource yang diminta.
403 Forbidden
{
"error": {
"errors": [
{
"domain": "global",
"reason": "accessDenied",
"message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
}
],
"code": 403,
"message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
}
}
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
responseTooLarge |
403 |
Respons pembacaan kueri atau tabel melebihi batas ukuran dengan salah satu cara berikut:
Error menampilkan: |
Tentukan tabel tujuan (dan tetapkan
|
apiLimitExceeded |
403 |
Permintaan melebihi salah satu batas API atau metadata berikut:
Error menampilkan: |
Coba lagi permintaan yang gagal dengan backoff eksponensial terpotong, pemuatan dan pembacaan batch, sederhanakan kebijakan keamanan IAM per tabel atau tingkat baris yang terperinci, dan tunggu rolling window sebelum menambahkan replika set data. Untuk mengetahui informasi selengkapnya, lihat Error batas evaluasi metadata dan kapasitas API dan Error batas pembuatan replika set data lintas region. |
quotaExceeded |
403 |
Project Anda melebihi salah satu kuota penggunaan berikut:
Error menampilkan: |
Periksa error |
rateLimitExceeded |
403 |
Permintaan ditolak karena salah satu batas kapasitas atau konkurensi berikut:
|
Perlambat rasio permintaan dan coba lagi menggunakan backoff eksponensial terpotong, atau jalankan kueri yang tidak mendesak dengan prioritas batch dan sesuaikan konkurensi pemesanan atau penskalaan otomatis slot. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah error kuota dan batas serta Penerimaan kueri ditolak. |
accessDenied |
403 |
Akses ke resource BigQuery ditolak karena salah satu alasan berikut:
Error menampilkan: |
Periksa
Cloud Audit Logs
( |
policyViolation |
403 |
Perimeter keamanan atau kebijakan organisasi memblokir permintaan:
|
Filter Logs Explorer berdasarkan |
billingNotEnabled |
403 |
Project tidak memiliki penagihan aktif untuk operasi yang diminta:
Error menampilkan: |
Aktifkan penagihan untuk project di konsolGoogle Cloud untuk mengupgrade dari sandbox BigQuery, lalu perbarui waktu habis masa berlaku default untuk tabel, tampilan, dan partisi Anda. Untuk mengetahui informasi selengkapnya, lihat Penagihan tidak diaktifkan untuk project. |
blocked |
403 |
BigQuery menambahkan operasi yang dicoba ke daftar yang ditolak untuk sementara guna mencegah pemadaman layanan. Error menampilkan: |
Hubungi Cloud Customer Care dengan stempel waktu, project ID, dan ID pekerjaan BigQuery yang tepat untuk menyelidiki aturan mitigasi administratif. Untuk mengetahui informasi selengkapnya, lihat Permintaan diblokir untuk melindungi operasi sistem. |
termsOfServiceNotAccepted |
403 |
Project belum menyetujui Persyaratan Layanan BigQuery. Error
menampilkan: |
Login ke Google Cloud konsol, pilih negara Anda dan kotak centang Persyaratan Layanan di halaman sambutan jika diminta, lalu klik Agree and continue. Untuk mengetahui informasi selengkapnya, lihat Persyaratan Layanan BigQuery tidak diterima. |
404 — Not Found
Berikut adalah contoh respons error yang Anda terima jika Anda mencoba mengambil set data atau resource yang tidak ada.
404 Not Found
{
"error": {
"errors": [
{
"domain": "global",
"reason": "notFound",
"message": "Not Found: Dataset myproject:foo"
}
],
"code": 404,
"message": "Not Found: Dataset myproject:foo"
}
}
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
notFound |
404 |
Resource yang diminta tidak dapat ditemukan karena salah satu alasan berikut:
Error menampilkan: |
Verifikasi lokasi dan ID project, set data, dan tabel yang peka huruf besar/kecil, pulihkan tabel yang dihapus dalam jangka waktu perjalanan, jalankan ulang kueri yang tabel hasil cache-nya telah habis masa berlakunya, atau konfirmasi keberadaan file Cloud Storage atau Google Drive eksternal. Untuk mengetahui informasi selengkapnya, lihat Tabel tidak ditemukan, Lokasi tidak ditemukan, dan Tugas tidak ditemukan. |
409 — Conflict
Berikut adalah contoh respons error yang Anda terima jika Anda mencoba membuat resource yang sudah ada.
409 Conflict
{
"error": {
"errors": [
{
"domain": "global",
"reason": "duplicate",
"message": "Already Exists: Dataset myproject:mydataset"
}
],
"code": 409,
"message": "Already Exists: Dataset myproject:mydataset"
}
}
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
abortd |
409 |
Operasi berhenti karena modifikasi atau konflik serentak (ditampilkan dengan alasan yang dieja |
Coba lagi operasi setelah operasi yang bertentangan selesai menggunakan backoff eksponensial terpotong, atau roll back transaksi multi-pernyataan yang dihentikan sebelum mencoba lagi. Untuk mengetahui informasi selengkapnya, lihat Operasi dibatalkan. |
duplicate |
409 |
Permintaan bertentangan dengan resource yang ada dengan salah satu cara berikut:
Error menampilkan: |
Gunakan nama resource yang berbeda, gunakan |
499 — Permintaan ditutup klien
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
stopped |
499 |
Tugas berhenti sebelum selesai karena salah satu alasan berikut (polling
Error menampilkan: |
Tingkatkan opsi waktu tunggu antrean |
500 — Error server internal
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
internalError |
500 |
Terjadi error internal dalam BigQuery. Error akan menampilkan:
|
Tunggu sesuai dengan persyaratan backoff dalam Perjanjian Tingkat Layanan BigQuery dan coba lagi menggunakan backoff eksponensial terpotong, atau gunakan Reservasi untuk mengurangi frekuensi error sementara. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah error internalError. |
501 — Tidak diterapkan
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
notImplemented |
501 |
Permintaan mencoba menggunakan fitur atau operasi yang tidak diterapkan untuk resource target, seperti berikut:
Error menampilkan: |
Wujudkan sumber salinan tabel yang tidak didukung menggunakan |
503 — Layanan tidak tersedia
| Alasan | Kode Status HTTP | Deskripsi | Pemecahan masalah |
|---|---|---|---|
backendError |
503 |
Layanan ini tidak tersedia untuk sementara karena salah satu alasan berikut:
Error menampilkan: |
Coba lagi permintaan menggunakan
backoff eksponensial
terpotong, dan coba lagi tugas yang gagal dengan |