Kode status dan error HTTP untuk BigQuery API

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:

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 tabledata.insertAll API lama dan tetap berada di buffering streaming tabel. Error menampilkan: UPDATE or DELETE statement over table project.dataset.table would affect rows in the streaming buffer, which is not supported.

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:

  • Skema tidak cocok (Provided Schema does not match Table table).
  • Kolom, file, atau rutinitas RECORD yang melebihi batas bertingkat 15 level (Schema nested too deeply).
  • Tabel tujuan yang dihapus atau habis masa berlakunya selama tugas (Destination deleted/expired during operation).

Pastikan skema yang disediakan cocok dengan kolom dan mode yang ada, ratakan struktur yang melebihi 15 tingkat bertingkat (atau simpan sebagai JSON), dan tetapkan waktu habis masa berlaku tabel tujuan agar lebih lama dari tugas yang berjalan. Untuk mengetahui langkah-langkah per subjenis, lihat Memecahkan masalah input tidak valid dan error skema.

invalidQuery 400

Kueri SQL gagal dalam pemeriksaan validasi atau eksekusi karena salah satu alasan berikut:

  • Sintaksis, ID, atau jenis data SQL tidak valid.
  • Opsi fitur yang tidak terpenuhi atau filter partisi yang diperlukan.
  • Melebihi batas output partisi atau bertingkat tampilan.
  • Konflik transaksi DML serentak (seperti Concurrent conflicting update to details).

Periksa lokasi [line:column] untuk mengetahui ketidakcocokan sintaksis atau jenis GoogleSQL, penuhi filter OPTIONS atau partisi yang diperlukan, atau rollback sesi yang terhenti dan coba lagi tugas DML yang bertentangan. Untuk mengetahui informasi selengkapnya, lihat Error kueri tidak valid dan Transaksi dibatalkan karena update serentak.

jobBackendError 400

Di jobs.query atau jobs.getQueryResults, tugas dibuat, lalu gagal selama eksekusi dengan backendError. Error yang ditampilkan: The job encountered an error during execution. Retrying the job may solve the problem.

Coba lagi tugas dengan jobId baru menggunakan backoff eksponensial terpotong, memastikan logika percobaan ulang klien menangani respons HTTP 400 selain kode 5xx. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah error jobBackendError dan jobInternalError.

jobInternalError 400

Di jobs.query atau jobs.getQueryResults, tugas dibuat, lalu gagal selama eksekusi dengan error internal. Error menampilkan: The job encountered an internal error during execution and was unable to complete.

Coba lagi tugas dengan jobId baru menggunakan backoff eksponensial terpotong. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah error jobBackendError dan jobInternalError.

preconditionFailed 400

Prasyarat permintaan tidak terpenuhi, termasuk kasus berikut:

  • ETag If-Match tidak cocok selama update metadata.
  • Kunci enkripsi CMEK yang diperlukan oleh kebijakan organisasi tidak ada.
  • Fitur yang tidak didukung di edisi Standard.
  • Penulisan ke set data failover di luar reservasi utama Enterprise Plus.
  • Kueri tampilan terwujud di atas tabel dasar CDC dengan upsert yang tertunda.

Ambil resource etag saat ini sebelum mencoba lagi, tentukan kunci Cloud Key Management Service yang diperlukan, jalankan workload dalam pemesanan Enterprise atau Enterprise Plus, atau tunggu beberapa menit hingga upsert CDC yang tertunda diterapkan. Untuk langkah-langkah per subjenis, lihat Prasyarat permintaan gagal.

resourceInUse 400

Permintaan penghapusan menargetkan resource yang masih aktif atau terisi:

  • Set data yang masih berisi tabel, tampilan, atau rutinitas.
  • Tugas yang masih tertunda atau berjalan.

Error menampilkan: resource_type resource_id is still in use.

Kosongkan set data sebelum menghapusnya (atau tetapkan deleteContents=true, jalankan bq rm -r -f -d, atau jalankan DROP SCHEMA IF EXISTS dataset_name CASCADE), atau tunggu tugas aktif selesai atau batalkan sebelum menghapus metadata tugas. Untuk mengetahui informasi selengkapnya, lihat Resource masih digunakan.

resourcesExceeded 400

Tugas melebihi batas resource eksekusi di salah satu area berikut:

  • Antrean konkurensi DML per tabel atau batas konkurensi sesi.
  • Anggaran memori worker, UDF, shuffle, atau model ML.
  • Batas partisi tabel (10.000 partisi) atau kolom output.
  • Rasio permintaan CMEK Cloud Key Management Service, pembacaan streaming, atau transfer data lintas region.
  • Batas kompleksitas perencanaan kueri.

Error menampilkan: Resources exceeded during query execution: details.

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: Storage of resource_id is unusable because reason.

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: Job failed because streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Coba lagi tugas dengan jobId baru menggunakan backoff eksponensial terpotong, untuk memastikan logika percobaan ulang klien menangani respons HTTP 400. Untuk mengetahui informasi selengkapnya, lihat Data streaming tidak tersedia untuk sementara.

tableUnavailable 400

BigQuery tidak dapat membaca tabel yang datanya tidak dikelola, termasuk kasus berikut:

  • Pengambilan waktu tunggu skema tabel Apache Iceberg atau Delta Lake habis.
  • Tabel eksternal yang dipartisi Hive tidak memiliki kunci partisi.
  • Tabel pendukung yang dikelola Google tidak tersedia untuk sementara.

Coba lagi waktu tunggu pengambilan skema atau tabel pendukung menggunakan exponential backoff terpotong, atau verifikasi jalur URI Cloud Storage key=value dan buat ulang tabel eksternal yang dipartisi Hive dengan setidaknya satu kunci partisi. Untuk mengetahui informasi selengkapnya, lihat Tabel eksternal atau pendukung tidak tersedia.

userOwnedResourceError 400

Resource eksternal yang Anda miliki menampilkan error saat diakses oleh BigQuery. Error menampilkan: Error when accessing a user-owned external resource_type resource resource_name. The resource provided error: external_error.

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: Job failed because vortex streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Coba lagi tugas kueri dengan jobId baru menggunakan backoff eksponensial terpotong, untuk memastikan logika percobaan ulang klien menangani respons HTTP 400. Untuk mengetahui informasi selengkapnya, lihat Data streaming tidak tersedia untuk sementara.

billingTierLimitExceeded 400

Kueri on-demand melebihi batas penggunaan CPU maksimum per data yang dipindai. Error menampilkan: Query exceeded resource limits. This query used cpu_seconds_used CPU seconds but would charge only analysis_megabytes_billed M Analysis bytes... cpu_seconds_used CPU seconds were used, and this query must use less than cpu_seconds_limit CPU seconds.

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 maximumBytesBilled sebelum eksekusi dimulai. Error menampilkan: Query exceeded limit for bytes billed: limit_bytes. required_bytes or higher required.

Lihat pratinjau estimasi byte dengan uji coba, pilih hanya kolom yang diperlukan, dan filter pada kolom yang dipartisi untuk mengurangi pemrosesan data, atau naikkan maximumBytesBilled ke setidaknya required_bytes. Untuk mengetahui informasi selengkapnya, lihat Kueri melebihi batas byte maksimum yang ditagih.

jobRateLimitExceeded 400

Di jobs.query atau jobs.getQueryResults, tugas gagal karena salah satu alasan berikut:

  • Tugas melebihi batas kapasitas selama eksekusi (Job exceeded rate limits: Your scope exceeded quota for quota_metric...).
  • Kueri tidak diterima karena konkurensi antrean kueri atau batas slot kueri berkelanjutan tercapai (misalnya, Query was not admitted as the maximum concurrency has been reached...).

Kurangi pengiriman serentak (atau gunakan prioritas batch atau penskalaan otomatis slot untuk kueri berkelanjutan), dan coba lagi tugas dengan jobId baru menggunakan backoff eksponensial terpotong. Untuk mengetahui informasi selengkapnya, lihat Tugas melebihi pembatasan kapasitas dan Penerimaan kueri ditolak.

timeout 400

Operasi melebihi batas waktu eksekusinya, termasuk kasus berikut:

  • Kueri atau uji coba melebihi batas eksekusi 6 jam.
  • Tugas turunan di dalam kueri multi-pernyataan mengalami waktu tunggu habis.
  • Deteksi otomatis skema tabel eksternal mengalami waktu tunggu habis.

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:

  • Kolom wajib diisi dalam payload atau URL permintaan API tidak diberikan.
  • Objek konfigurasi yang diperlukan di library klien kosong atau tidak ditetapkan.

Error menampilkan: Required parameter is missing: parameter_name.

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:

  • Permintaan tidak memiliki kredensial autentikasi yang valid atau menggunakan token akses OAuth 2.0 yang sudah tidak berlaku.
  • Kredensial pengguna akhir atau izin peniruan akun layanan tidak ada.
  • Akun pengguna pemanggil dibatasi atau dihapus.

Perbarui OAuth atau Kredensial Default Aplikasi Anda, berikan roles/iam.serviceAccountUser atau roles/iam.serviceAccountTokenCreator saat menjalankan atau meniru akun layanan, atau hubungi administrator Anda untuk memulihkan akun yang dibatasi. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah error yang tidak diautentikasi.

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: Response too large to return. details.

Tentukan tabel tujuan (dan tetapkan configuration.query.allowLargeResults ke true untuk legacy SQL), hapus ORDER BY atau tambahkan LIMIT, atau baca baris besar menggunakan BigQuery Storage Read API atau EXPORT DATA. Untuk mengetahui informasi selengkapnya, lihat Respons kueri terlalu besar dan Batas ukuran respons satu baris terlampaui.

apiLimitExceeded 403

Permintaan melebihi salah satu batas API atau metadata berikut:

  • Batas rasio permintaan API per menit.
  • Kuota evaluasi metadata tabel atau kebijakan.
  • Batas pembuatan replika set data lintas region (Cannot add more than limit replicas for a region within window day(s)).

Error menampilkan: API limit exceeded: details.

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: Quota exceeded: Your scope exceeded quota for quota_metric. For more information, see https://cloud.google.com/bigquery/docs/troubleshoot-quotas.

Periksa error message untuk mengidentifikasi kuota yang terlampaui, optimalkan kueri pemindaian tinggi atau upgrade dari sandbox, atau sesuaikan kuota kustom di halaman Kuota. Untuk mengetahui informasi selengkapnya, lihat Error kuota kueri harian kustom.

rateLimitExceeded 403

Permintaan ditolak karena salah satu batas kapasitas atau konkurensi berikut:

  • Pembatasan kapasitas API atau tugas kueri jangka pendek (Exceeded rate limits: too many quota_metric for this scope...).
  • Konkurensi antrean kueri atau batas slot pemesanan kueri berkelanjutan (misalnya, Query was not admitted as the maximum concurrency has been reached...).

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:

  • Akun utama tidak memiliki izin IAM yang diperlukan pada project, set data, atau tabel target.
  • Tampilan yang diotorisasi, kebijakan akses tingkat baris, atau tag kebijakan tingkat kolom membatasi akses.
  • Izin CMEK Cloud Key Management Service atau izin sumber data eksternal tidak ada.

Error menampilkan: Access Denied: resource_type resource_id: details.

Periksa Cloud Audit Logs (protoPayload.authorizationInfo) dan Penganalisis Kebijakan untuk mengidentifikasi izin yang tidak ada, dan berikan peran BigQuery yang telah ditetapkan dengan hak istimewa terendah. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah skenario Akses Ditolak yang umum.

policyViolation 403

Perimeter keamanan atau kebijakan organisasi memblokir permintaan:

  • Perimeter Kontrol Layanan VPC membatasi akses (termasuk ekspor Google Drive atau tabel eksternal dalam project VPC-SC).
  • Batasan kebijakan organisasi seperti constraints/gcp.resourceLocations melarang operasi.

Filter Logs Explorer berdasarkan vpcServiceControlsUniqueIdentifier dan periksa Violation Analyzer, ekspor atau muat data menggunakan bucket Cloud Storage di dalam perimeter, atau pilih region yang diizinkan oleh batasan kebijakan organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah error pelanggaran kebijakan.

billingNotEnabled 403

Project tidak memiliki penagihan aktif untuk operasi yang diminta:

  • Penagihan tidak diaktifkan untuk project.
  • Project berjalan di sandbox BigQuery, tempat tabel, tampilan, dan partisi akan berakhir masa berlakunya setelah 60 hari (expiration time must be less than 60 days).

Error menampilkan: Billing has not been enabled for this project. Enable billing at https://console.cloud.google.com/billing. details.

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: Request was blocked to protect the system's operation. Please contact support at https://cloud.google.com/support.

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: BigQuery Terms of Service have not been accepted.

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:

  • Set data, tabel, atau tugas target tidak ada atau telah habis masa berlakunya.
  • URI file Cloud Storage atau Google Drive eksternal tidak ada.
  • Lokasi permintaan tidak cocok dengan lokasi set data atau tugas.

Error menampilkan: Not found: resource_type resource_id.

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 abortd).

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:

  • Membuat resource set data, tabel, atau tugas yang sudah ada.
  • Menjalankan tugas dengan writeDisposition yang ditetapkan ke WRITE_EMPTY saat tabel tujuan sudah ada.

Error menampilkan: Already Exists: resource_type resource_id.

Gunakan nama resource yang berbeda, gunakan IF NOT EXISTS atau CREATE OR REPLACE dalam pernyataan DDL, ubah writeDisposition menjadi WRITE_APPEND atau WRITE_TRUNCATE, atau biarkan BigQuery membuat jobId acak. Untuk langkah-langkah per subjenis, lihat Resource sudah ada.

499 — Permintaan ditutup klien

Alasan Kode Status HTTP Deskripsi Pemecahan masalah
stopped 499

Tugas berhenti sebelum selesai karena salah satu alasan berikut (polling jobs.get menampilkan HTTP 200 dengan reason: stopped):

  • Pemanggil secara eksplisit membatalkan tugas (User requested cancellation).
  • Tugas melebihi waktu tunggu eksekusi atau antrean yang dikonfigurasi (Job timed out after duration atau Job timed out in the queue after duration).

Error menampilkan: Job execution was cancelled: details.

Tingkatkan opsi waktu tunggu antrean configuration.jobTimeoutMs atau project (atau optimalkan runtime dan konkurensi kueri), atau periksa Cloud Audit Logs untuk panggilan jobservice.cancel. Untuk langkah-langkah per subjenis, lihat Eksekusi tugas dibatalkan.

500 — Error server internal

Alasan Kode Status HTTP Deskripsi Pemecahan masalah
internalError 500

Terjadi error internal dalam BigQuery. Error akan menampilkan: An internal error occurred and the request could not be completed.

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:

  • Menyalin tabel dengan jenis penyimpanan yang tidak dikelola.
  • Menjalankan opsi ALTER SEARCH INDEX yang tidak didukung.

Error menampilkan: Not Implemented: details.

Wujudkan sumber salinan tabel yang tidak didukung menggunakan CREATE TABLE destination_table AS SELECT * FROM source_table, atau hapus dan buat ulang indeks penelusuran dengan DROP SEARCH INDEX dan CREATE SEARCH INDEX. Untuk langkah-langkah per subjenis, lihat Fitur atau operasi tidak diterapkan.

503 — Layanan tidak tersedia

Alasan Kode Status HTTP Deskripsi Pemecahan masalah
backendError 503

Layanan ini tidak tersedia untuk sementara karena salah satu alasan berikut:

  • Lonjakan permintaan layanan (pelepasan beban) atau kehabisan resource internal.
  • Masalah konektivitas jaringan yang terputus-putus.
  • Masalah komponen backend sementara.

Error menampilkan: Error encountered during execution. Retrying may solve the problem.

Coba lagi permintaan menggunakan backoff eksponensial terpotong, dan coba lagi tugas yang gagal dengan jobId baru. Jika error tetap ada setelah dicoba lagi, bandingkan tingkat kegagalan 30 hari Anda dengan SLA BigQuery dan hubungi Cloud Customer Care; lihat Memecahkan masalah error backendError.