קודי סטטוס וקודי שגיאה של HTTP ב-BigQuery API

בדף הזה מתוארים קודי הסטטוס של HTTP והודעות השגיאה שמוחזרים על ידי BigQuery API. אתם יכולים להשתמש בקודים האלה כדי לפתור בעיות בבקשות שנכשלו, ולוודא שה-API פועל כמו שצריך.

מידע נוסף על שגיאות שאינן קשורות ל-API, שגיאות קישוריות של ספריית הלקוח ושגיאות במסוף Cloud de Confiance זמין במאמר הודעות שגיאה.

למידע נוסף על שגיאות בשאילתות, קראו את המאמר פתרון בעיות בשאילתות.

למידע נוסף על שגיאות בהזנת זרם נתונים, ראו פתרון בעיות בהזנת זרם נתונים.

פורמט התגובה לשגיאה

ב-BigQuery נעשה שימוש בפורמט הסטנדרטי של דיווח על שגיאות HTTP ב-API. בקשות שהצליחו מחזירות קודי סטטוס של HTTP בטווח 2xx. בקשות שנכשלו מחזירות קודי סטטוס בטווחים 4xx ו-5xx. בקשות שדורשות הפניה אוטומטית מחזירות קודי סטטוס בטווח 3xx. תגובות שגיאה בדרך כלל כוללות מסמך JSON בגוף התגובה, שמכיל אובייקט שגיאה עם מידע על השגיאה.

בתגובות מה-API של BigQuery, אובייקט השגיאה הוא בדרך כלל אחד מהבאים:

העמודה סיבה בטבלאות של קודי הסטטוס בדף הזה ממופה למאפיין reason באובייקט ErrorProto. אם אתם משתמשים בכלי שורת הפקודה של BigQuery כדי לבדוק את סטטוס המשימה, השתמשו בדגל --format=prettyjson (לדוגמה, bq --format=prettyjson show -j <var>JOB_ID</var>) או בדגל --apilog=stdout כדי להציג את אובייקט השגיאה ואת המאפיין reason שלו.

בטבלה הבאה מתוארים הרכיבים שיכולים להופיע בגוף התגובה של שגיאה. כדי לזהות את הבעיה, צריך להשתמש בשדות ביחד. בנוסף, הערכים לדוגמה בטבלה הבאה נועדו להמחשה בלבד, והם לא רשימה ממצה של כל הערכים האפשריים.

רכיב תיאור
code ערך של קוד סטטוס של HTTP, בלי התיאור הטקסטואלי.

ערכים לדוגמה: 400 (בקשה שגויה), 403 (אסור) ו-404 (לא נמצא).
error מאגר לפרטי השגיאה.
errors מאגר לפרטי השגיאה.
שגיאות.domain היקף השגיאה. ערכים לדוגמה: global ו-usageLimits.
שגיאות.location הפריט הספציפי בתוך locationType שגרם לשגיאה. לדוגמה, אם מציינים ערך לא חוקי לפרמטר, הערך של location יהיה שם הפרמטר.

ערכים לדוגמה: Authorization ו-project.
שגיאות.locationType המיקום או החלק בבקשה שגרמו לשגיאה. אפשר להשתמש בפרמטר הזה עם location כדי לאתר את השגיאה.

ערכים לדוגמה: header ו-parameter.
שגיאות.message תיאור השגיאה.

ערכים לדוגמה: Invalid argument,‏ Access Denied ו-Not Found: Dataset myproject:foo.
שגיאות.reason מזהה ייחודי של הגורם לשגיאה.

ערכים לדוגמה: invalid,‏ accessDenied ו-notFound.
message תיאור השגיאה. כמו בשגיאות.message.

קודי סטטוס וקודי שגיאה של HTTP

בקטע הזה מופיעה רשימה חלקית של קודי סטטוס וקודי שגיאה של HTTP מ-BigQuery API. קודי המידע 1xx וקודי ההצלחה 2xx לא נכללים. מידע נוסף זמין בקודים של סטטוס תגובה ב-RFC 7231 §6, ב-RFC 7232 §4, ב-RFC 7233 §4, ב-RFC 7235 §3 וב-RFC 6585.

‫400 — בקשה לא תקינה

סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
badRequest 400

פקודת DML מנסה לשנות שורות שהועברו לאחרונה בסטרימינג באמצעות ה-API הקודם של tabledata.insertAll, ונשארו במאגר הנתונים הזמני של הטבלה. השגיאה שמוחזרת: UPDATE or DELETE statement over table project.dataset.table would affect rows in the streaming buffer, which is not supported.

עבור אל BigQuery Storage Write API ‏(gRPC), המתן מספר דקות עד שמאגר הסטרימינג יתרוקן, או סנן את ההצהרה שלך כדי לא לכלול שורות שהוזרמות לאחרונה. מידע נוסף זמין במאמר הצהרות DML בטבלאות עם מאגר נתונים זמני (buffer) של סטרימינג.

invalid 400

הבקשה מכילה קלט לא חוקי, שהוא לא שאילתה לא חוקית, כולל המקרים הבאים:

  • אי התאמה בסכימה (Provided Schema does not match Table table).
  • עמודה, קובץ או שגרה מסוג RECORD שחורגים ממגבלת ההטמעה של 15 רמות (Schema nested too deeply).
  • טבלת יעד שנמחקת או שתוקפה פג במהלך משימה (Destination deleted/expired during operation).

צריך לוודא שהסכימות שסופקו תואמות לעמודות ולמצבים הקיימים, לשטח מבנים שחורגים מ-15 רמות של הטמעה (או לאחסן אותם כ-JSON), ולהגדיר זמני תפוגה של טבלת היעד כך שישרדו משימות שפועלות. במאמר פתרון בעיות של קלט לא תקין ושגיאות סכימה מוסבר איך לפתור בעיות לפי סוג משנה.

invalidQuery 400

שאילתת SQL נכשלת בבדיקות האימות או ההרצה, מאחת מהסיבות הבאות:

  • תחביר SQL, מזהים או סוגי נתונים לא תקינים.
  • אפשרויות תכונה לא מספקות או מסנני מחיצה נדרשים.
  • חריגה ממגבלות הפלט של המחיצות או של התצוגות המקוננות.
  • התנגשות בין עסקאות DML בו-זמניות (כמו Concurrent conflicting update to details).

צריך לבדוק את המיקום [line:column] כדי לראות אם יש חוסר התאמה בתחביר או בסוג של GoogleSQL, לעמוד בדרישות של מסנני OPTIONS או מסנני מחיצות, או לבטל סשנים תקועים ולנסות שוב להפעיל משימות DML מתנגשות. מידע נוסף זמין במאמרים שגיאות של שאילתות לא חוקיות והעסקה בוטלה בגלל עדכון בו-זמני.

jobBackendError 400

ב-jobs.query או ב-jobs.getQueryResults, נוצרה משימה שנכשלה במהלך הביצוע עם backendError. השגיאה שמוחזרת: The job encountered an error during execution. Retrying the job may solve the problem.

מנסים שוב את המשימה עם jobId חדש באמצעות השהיה מעריכית קצרה לפני ניסיון חוזר (exponential backoff), ומוודאים שלוגיקת הניסיון החוזר של הלקוח מטפלת בתגובות HTTP 400 בנוסף לקודי 5xx. למידע נוסף, ראו פתרון השגיאות jobBackendError ו-jobInternalError.

jobInternalError 400

ב-jobs.query או ב-jobs.getQueryResults, נוצרה משימה שנכשלה במהלך הביצוע בגלל שגיאה פנימית. השגיאה שמוחזרת: The job encountered an internal error during execution and was unable to complete.

מנסים שוב את המשימה עם jobId חדש באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff). למידע נוסף, ראו פתרון השגיאות jobBackendError ו-jobInternalError.

preconditionFailed 400

תנאי מקדים של בקשה לא מתקיים, כולל במקרים הבאים:

  • חוסר התאמה של ETag של If-Match במהלך עדכון מטא-נתונים.
  • מפתח הצפנה חסר של CMEK שנדרש לפי מדיניות הארגון.
  • תכונה שלא נתמכת במהדורת Standard.
  • כתיבה לקבוצת נתונים של יתירות כשל מחוץ להזמנה הראשית של Enterprise Plus.
  • שאילתה של תצוגה מהותית על מסד נתונים טבלאי של CDC עם פעולות upsert בהמתנה.

אחזרו את המשאב הנוכחי etag לפני שתנסו שוב, ציינו את המפתח הנדרש של Cloud Key Management Service, הפעילו את עומס העבודה בהזמנה של Enterprise או Enterprise Plus, או המתינו כמה דקות עד שהפעולות של הוספה או עדכון (upsert) של CDC בהמתנה יחולו. במאמר Request precondition failed מוסבר איך לפתור את הבעיה לפי סוג המשנה.

resourceInUse 400

בקשת מחיקה מטרגטת משאב שעדיין פעיל או מאוכלס:

  • קבוצת נתונים שעדיין מכילה טבלאות, תצוגות או שגרות.
  • משימה שעדיין בהמתנה או פועלת.

השגיאה שמוחזרת: resource_type resource_id is still in use.

מרוקנים את קבוצת הנתונים לפני שמוחקים אותה (או מגדירים את deleteContents=true, מריצים את bq rm -r -f -d או מפעילים את DROP SCHEMA IF EXISTS dataset_name CASCADE), או ממתינים עד שהמשימה הפעילה תסתיים או מבטלים אותה לפני שמוחקים את המטא-נתונים של המשימה. למידע נוסף, קראו את המאמר המשאב עדיין בשימוש.

resourcesExceeded 400

משימה חורגת ממגבלות המשאבים לביצוע באחד מהתחומים הבאים:

  • תורים של פעולות DML בו-זמניות לכל טבלה או מגבלות על סשנים בו-זמניים.
  • תקציבי זיכרון של מודלים של Worker,‏ UDF,‏ shuffle או ML.
  • מגבלות על חלוקת טבלאות למחיצות (10,000 מחיצות) או על עמודות פלט.
  • קצב הבקשות של CMEK ב-Cloud Key Management Service, קריאות בסטרימינג או העברות נתונים בין אזורים.
  • מגבלות על המורכבות של תוכניות לביצוע שאילתות.

השגיאה שמוחזרת: Resources exceeded during query execution: details.

כדי לפתור את הבעיה, אפשר לפשט את השאילתות, לבצע פעולות DML בכמות גדולה, לצמצם את העמודות או המחיצות שנסרקות, להימנע מהפעלת משימות בו-זמנית באותו סשן או להקצות קיבולת ייעודית של משבצות לעומסי עבודה שכוללים הרבה פעולות ערבוב. כדי לראות את השלבים לכל סוג משנה, קראו את המאמרים פתרון בעיות של חריגה במשאבים והשאילתה חורגת ממשאבי הזיכרון.

storageUnusable 400

האחסון הפנימי של BigQuery שבו נמצאים נתוני הטבלה לא זמין באופן זמני בגלל בעיית אחסון בצד השירות. השגיאה שמוחזרת: Storage of resource_id is unusable because reason.

מנסים שוב להפעיל את המשימה באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff). מידע נוסף זמין במאמר לא ניתן להשתמש באחסון הטבלה.

streamingDataUnavailable 400

נתונים שהועברו לאחרונה בסטרימינג לאחסון שמותאם לכתיבה לא זמינים באופן זמני למשימת קריאה. השגיאה שמוחזרת: Job failed because streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

מנסים שוב להפעיל את המשימה עם jobId חדש באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff), ומוודאים שהלוגיקה של הלקוח לניסיון חוזר מטפלת בתגובות HTTP מסוג 400. מידע נוסף מופיע בקטע נתוני הסטרימינג לא זמינים באופן זמני.

tableUnavailable 400

‫BigQuery לא יכול לקרוא טבלה שהנתונים שלה לא מנוהלים על ידו, כולל במקרים הבאים:

  • הזמן הקצוב לתפוגה של אחזור סכימת טבלה של Apache Iceberg או Delta Lake חלף.
  • בטבלה חיצונית שמחולקת למחיצות ב-Hive אין מפתחות של מחיצות.
  • טבלת גיבוי בניהול Google לא זמינה באופן זמני.

מנסים שוב לאחזר את הסכימה או את הזמן הקצוב לתפוגה של טבלת הגיבוי באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff), או מאמתים את נתיבי ה-URI של key=value Cloud Storage ויוצרים מחדש טבלאות חיצוניות עם מחיצות Hive עם מפתח מחיצה אחד לפחות. למידע נוסף, קראו את המאמר הטבלה החיצונית או טבלת הגיבוי לא זמינה.

userOwnedResourceError 400

משאב חיצוני שבבעלותכם מחזיר שגיאה כש-BigQuery ניגש אליו. השגיאה שמוחזרת: Error when accessing a user-owned external resource_type resource resource_name. The resource provided error: external_error.

כדי לזהות את המשאב החיצוני, בודקים את resource_type ואת resource_name בהודעת השגיאה, ופותרים את השגיאה הבסיסית שדווחה ב-external_error. מידע נוסף מופיע בקטע שגיאה במשאב חיצוני בבעלות המשתמש.

vortexDataUnavailable 400

נתונים שהועברו לאחרונה באמצעות BigQuery Storage Write API‏ (gRPC) לאחסון שמותאם לכתיבה, לא זמינים באופן זמני לשאילתה. השגיאה שמוחזרת: Job failed because vortex streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

מנסים שוב את משימת השאילתה עם jobId חדש באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff), ומוודאים שהלוגיקה של הניסיון החוזר של הלקוח מטפלת בתגובות HTTP 400. מידע נוסף מופיע בקטע נתוני הסטרימינג לא זמינים באופן זמני.

billingTierLimitExceeded 400

שאילתה על פי דרישה חורגת ממגבלת השימוש המקסימלי במעבד (CPU) לנתונים שנסרקו. השגיאה שמוחזרת: 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.

משנים את קוד ה-SQL כדי להסיר מכפלות קרטזיות לא מכוונות, איחודים לא מדויקים, פונקציות אנליטיות לא מחולקות או פונקציות JavaScript UDF כבדות, או עוברים לתמחור מבוסס-קיבולת (משבצות). למידע נוסף, ראו השאילתה חורגת ממשאבי ה-CPU והימנעות מתבניות anti-SQL.

bytesBilledLimitExceeded 400

הערכת הגבול העליון של הבייטים לפני הרצת השאילתה חורגת מ-maximumBytesBilled לפני תחילת ההרצה. השגיאה שמוחזרת: Query exceeded limit for bytes billed: limit_bytes. required_bytes or higher required.

כדי להפחית את כמות הנתונים שעובדו, אפשר להציג תצוגה מקדימה של הבייטים המשוערים באמצעות הרצה יבשה, לבחור רק את העמודות הדרושות ולסנן לפי עמודות מחולקות למחיצות. אפשר גם להגדיל את maximumBytesBilled ל-required_bytes לפחות. למידע נוסף, קראו את המאמר השאילתה חורגת ממגבלת הבייטים המקסימלית לחיוב.

jobRateLimitExceeded 400

ב-jobs.query או ב-jobs.getQueryResults, משימה נכשלת בגלל אחת מהסיבות הבאות:

  • המשימה חורגת ממגבלת הקצב במהלך הביצוע (Job exceeded rate limits: Your scope exceeded quota for quota_metric...).
  • השאילתה לא מתקבלת כי הגעתם למגבלת ה-concurrency של תור השאילתות או למגבלת ה-slots של השאילתות המתמשכות (לדוגמה, Query was not admitted as the maximum concurrency has been reached...).

צמצמו את מספר השליחות בו-זמנית (או השתמשו בעדיפות של אצווה או בהתאמה אוטומטית לעומס של יחידות קיבולת לשאילתות מתמשכות), ונסו שוב את המשימה עם jobId חדש באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff). למידע נוסף, קראו את המאמרים Job exceeded rate limits ו-Query admission denied.

timeout 400

פעולה חורגת ממגבלת זמן הביצוע שלה, כולל במקרים הבאים:

  • שאילתה או הרצת בדיקה חורגות ממגבלת הביצוע של 6 שעות.
  • משימת צאצא בתוך שאילתה עם כמה הצהרות נכשלת בגלל זמן קצוב לתפוגה.
  • הזמן הקצוב לזיהוי אוטומטי של סכימת טבלה חיצונית פג.

סננו עמודות מחולקות למחיצות או לאשכולות, ופצלו שאילתות מורכבות או שאילתות עם כמה הצהרות לשלבים קטנים יותר. לחלופין, ציינו סכימה מפורשת ומזהי URI צרים יותר של מקורות כשאתם יוצרים טבלאות חיצוניות. מידע נוסף זמין במאמרים השאילתה חורגת ממגבלת זמן הביצוע ופתרון שגיאות שקשורות למכסות ולמגבלות.

invalidUser 400

שאילתה מתוזמנת הוגדרה עם פרטי כניסה לא תקינים של משתמש.

מרעננים את פרטי הכניסה של המשתמש לשאילתה המתוזמנת. מידע נוסף זמין במאמר תזמון שאילתות.

required 400

חסר קלט חובה לפני ההפעלה:

  • לא צוין שדה חובה במטען הייעודי (payload) או בכתובת ה-URL של בקשת ה-API.
  • אובייקט הגדרה נדרש בספריית לקוח ריק או לא מוקצה.

השגיאה שמוחזרת: Required parameter is missing: parameter_name.

בודקים את גוף הבקשה ואת הפרמטרים של השאילתה שנדרשים במאמרי העזרה של BigQuery API או במסמכי התיעוד של ספריית הלקוח, ובודקים את אובייקט ההגדרה לפני ששולחים קריאה ל-API. מידע נוסף זמין במאמר אחד מהפרמטרים הנדרשים חסר.

‫401 – Unauthorized

הדוגמה הבאה היא תגובת שגיאה שמתקבלת אם הבקשה לא כוללת פרטי כניסה לאימות תקינים.

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"
  }
}
סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
unauthenticated 401

אימות הבקשה נכשל בגלל אחת מהסיבות הבאות:

  • בבקשה חסרים פרטי כניסה לאימות חוקיים, או שהיא משתמשת באסימון גישה של OAuth 2.0 שפג תוקפו.
  • חסרים פרטי הכניסה של משתמש הקצה או הרשאות ההתחזות לחשבון השירות.
  • חשבון המשתמש של מבצע הקריאה החוזרת מוגבל או נמחק.

צריך לרענן את פרטי הכניסה שמוגדרים כברירת מחדל של OAuth או של Application Default Credentials, לתת את ההרשאה roles/iam.serviceAccountUser או roles/iam.serviceAccountTokenCreator כשמריצים חשבון שירות או מתחזים אליו, או לפנות לאדמין כדי לשחזר חשבון מוגבל. מידע נוסף זמין במאמר פתרון בעיות של שגיאות אימות.

‫403 — Forbidden

זו דוגמה לתגובת שגיאה שתקבלו אם אין לכם הרשאת גישה למשאב המבוקש.

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."
  }
}
סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
responseTooLarge 403

תגובה לקריאה של שאילתה או טבלה חורגת ממגבלות הגודל באחת מהדרכים הבאות:

השגיאה שמוחזרת: Response too large to return. details.

מציינים טבלת יעד (ומגדירים את configuration.query.allowLargeResults ל-true בשביל SQL מדור קודם), מסירים את ORDER BY או מוסיפים את LIMIT, או קוראים שורות גדולות באמצעות BigQuery Storage Read API או EXPORT DATA. למידע נוסף, קראו את המאמרים התגובה לשאילתה גדולה מדי וחריגה ממגבלת הגודל של תגובה בשורה אחת.

apiLimitExceeded 403

בקשה חורגת מאחת מהמגבלות הבאות של ה-API או של המטא-נתונים:

  • מגבלות קצב של בקשות API לדקה.
  • מכסות להערכת מטא-נתונים של טבלאות או כללי מדיניות.
  • מגבלות על יצירת רפליקות של מערכי נתונים באזורים שונים (Cannot add more than limit replicas for a region within window day(s)).

השגיאה שמוחזרת: API limit exceeded: details.

נסו שוב לשלוח בקשות שנכשלו באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff), טעינות וקריאות באצווה, פשטו את כללי המדיניות של IAM ברמת הטבלה או את כללי המדיניות של אבטחה ברמת השורה, והמתינו לחלון הזמן הדינמי לפני שתוסיפו רפליקות של מערכי נתונים. למידע נוסף, קראו את המאמרים שגיאות שקשורות למגבלות על קצב ה-API והערכת המטא-נתונים ושגיאות שקשורות למגבלות על יצירת רפליקות של מערכי נתונים באזורים שונים.

quotaExceeded 403

הפרויקט חורג מאחת ממכסות השימוש הבאות:

השגיאה שמוחזרת: Quota exceeded: Your scope exceeded quota for quota_metric. For more information, see https://cloud.google.com/bigquery/docs/troubleshoot-quotas.

בודקים את השגיאה message כדי לזהות את המכסה שחרגתם ממנה, מבצעים אופטימיזציה של שאילתות עם סריקה גבוהה או משדרגים מארגז החול, או משנים את המכסות בהתאמה אישית בדף Quotas. מידע נוסף זמין במאמר שגיאות במכסת השאילתות היומית בהתאמה אישית.

rateLimitExceeded 403

בקשה נדחית בגלל אחת ממגבלות הקצב או הבו-זמניות הבאות:

  • מגבלות קצב לטווח קצר על משימות של שאילתות או API‏ (Exceeded rate limits: too many quota_metric for this scope...).
  • מגבלות על מספר השאילתות בתור או על מספר המשבצות שהוקצו לשאילתות מתמשכות (לדוגמה, Query was not admitted as the maximum concurrency has been reached...).

להאט את קצב הבקשות ולנסות שוב באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff), או להריץ שאילתות לא דחופות עם עדיפות באצווה ולהתאים את ההתאמה האוטומטית לעומס של ה-slots או את ההקצאה בו-זמנית של ההזמנות. למידע נוסף, קראו את המאמרים פתרון בעיות שקשורות לשגיאות במכסות ובמגבלות ודחיית בקשות לשאילתות.

accessDenied 403

הגישה למשאב BigQuery נדחתה מאחת מהסיבות הבאות:

  • לחשבון המשתמש אין את הרשאות ה-IAM הנדרשות בפרויקט, במערך הנתונים או בטבלה המיועדים.
  • תצוגה מורשית, מדיניות גישה ברמת השורה או תג מדיניות ברמת העמודה מגבילים את הגישה.
  • חסרות הרשאות CMEK של Cloud Key Management Service או הרשאות למקור נתונים חיצוני.

השגיאה שמוחזרת: Access Denied: resource_type resource_id: details.

בודקים את יומני הביקורת של Cloud (protoPayload.authorizationInfo) ואת כלי הניתוח למדיניות כדי לזהות את ההרשאה החסרה, ומקצים את התפקיד המוגדר מראש ב-BigQuery עם ההרשאות המינימליות. למידע נוסף, קראו את המאמר פתרון בעיות בתרחישים נפוצים של Access Denied.

policyViolation 403

הבקשה נחסמת על ידי מדיניות הארגון או היקף אבטחה:

  • היקף השירות של VPC Service Controls מגביל את הגישה (כולל ייצוא של Google Drive או טבלאות חיצוניות בפרויקטים של VPC-SC).
  • אילוץ של מדיניות הארגון, כמו constraints/gcp.resourceLocations, לא מאפשר את הפעולה.

מסננים את ה-Logs Explorer לפי vpcServiceControlsUniqueIdentifier ובודקים את Violation Analyzer, מייצאים או טוענים נתונים באמצעות קטגוריה של Cloud Storage בתוך ההיקף, או בוחרים אזור שמותר לפי האילוצים של מדיניות הארגון. פתרון בעיות שקשורות לשגיאות של הפרת מדיניות

billingNotEnabled 403

בפרויקט אין חיוב פעיל לפעולה המבוקשת:

  • החיוב לא מופעל בפרויקט.
  • הפרויקט פועל בארגז החול של BigQuery, שבו התוקף של טבלאות, תצוגות ומחיצות פג אחרי 60 יום (expiration time must be less than 60 days).

השגיאה שמוחזרת: Billing has not been enabled for this project. Enable billing at https://console.cloud.s3nscloud.fr/billing. details.

מפעילים את החיוב בפרויקט במסוףCloud de Confiance כדי לשדרג מארגז החול של BigQuery, ואז מעדכנים את זמני התפוגה שמוגדרים כברירת מחדל לטבלאות, לתצוגות ולמחיצות. מידע נוסף זמין במאמר החיוב לא מופעל בפרויקט.

blocked 403

‫BigQuery הוסיף באופן זמני את הפעולה שניסיתם לבצע לרשימת ישויות שנחסמו כדי למנוע הפסקה זמנית בשירות. השגיאה שמוחזרת: Request was blocked to protect the system's operation. Please contact support at https://cloud.google.com/support.

פנו ל-Cloud Customer Care וציינו את חותמת הזמן המדויקת, מזהה הפרויקט ומזהה המשימה ב-BigQuery כדי לבדוק את כלל ההפחתה הניהולי. מידע נוסף זמין במאמר הבקשה נחסמה כדי להגן על פעולת המערכת.

termsOfServiceNotAccepted 403

הפרויקט לא אישר את התנאים וההגבלות של BigQuery. השגיאה שמוחזרת: BigQuery Terms of Service have not been accepted.

נכנסים למסוףCloud de Confiance , בוחרים את המדינה ומסמנים את תיבת הסימון של התנאים וההגבלות בדף קבלת הפנים, אם מוצגת בקשה לעשות זאת, ולוחצים על Agree and continue. למידע נוסף, קראו את המאמר התנאים וההגבלות של BigQuery לא אושרו.

‫404 – לא נמצא

הדוגמה הבאה היא תגובת שגיאה שמתקבלת כשמנסים לאחזר מערך נתונים או משאב שלא קיימים.

404 Not Found

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "Not Found: Dataset myproject:foo"
      }
    ],
    "code": 404,
    "message": "Not Found: Dataset myproject:foo"
  }
}
סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
notFound 404

לא ניתן למצוא את המשאב המבוקש בגלל אחת מהסיבות הבאות:

  • מערך הנתונים, הטבלה או המשימה לא קיימים או שהתוקף שלהם פג.
  • לא קיים URI של קובץ חיצוני ב-Cloud Storage או ב-Google Drive.
  • מיקום הבקשה לא תואם למיקום של קבוצת הנתונים או של המשימה.

השגיאה שמוחזרת: Not found: resource_type resource_id.

צריך לוודא שהמיקום והמזהה של הפרויקט, מערך הנתונים והטבלה מדויקים ותלויי אותיות רישיות, לשחזר טבלאות שנמחקו בחלון הזמן של הנסיעה בזמן, להריץ מחדש שאילתות שטבלאות התוצאות שלהן במטמון פג תוקף, או לוודא שקיימים קבצים חיצוניים ב-Cloud Storage או ב-Google Drive. למידע נוסף, קראו את המאמרים Table not found,‏ Location not found ו-Job not found.

‫409 — Conflict

הדוגמה הבאה היא של תגובת שגיאה שמתקבלת כשמנסים ליצור משאב שכבר קיים.

409 Conflict

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "duplicate",
        "message": "Already Exists: Dataset myproject:mydataset"
      }
    ],
    "code": 409,
    "message": "Already Exists: Dataset myproject:mydataset"
  }
}
סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
abortd 409

פעולה נעצרת בגלל שינוי בו-זמני או התנגשות (מוחזרת עם הסיבה abortd).

נסו שוב את הפעולה אחרי שהפעולה המתנגשת תסתיים באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (exponential backoff), או החזירו למצב הקודם טרנזקציות מרובות-הצהרות שהופסקו לפני הניסיון החוזר. הפעולה בוטלה

duplicate 409

בקשה מתנגשת עם משאב קיים באחת מהדרכים הבאות:

  • יצירת משאב של מערך נתונים, טבלה או משימה שכבר קיימים.
  • הפעלת משימה שבה writeDisposition מוגדר לערך WRITE_EMPTY, כשכבר קיימת טבלת יעד.

השגיאה שמוחזרת: Already Exists: resource_type resource_id.

צריך להשתמש בשם משאב אחר, להשתמש ב-IF NOT EXISTS או ב-CREATE OR REPLACE בהצהרות DDL, לשנות את writeDisposition ל-WRITE_APPEND או ל-WRITE_TRUNCATE, או לאפשר ל-BigQuery ליצור jobId אקראי. במאמר המשאב כבר קיים מוסבר איך פותרים את הבעיה לפי סוג המשנה.

‫499 – הלקוח סגר את הבקשה

סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
stopped 499

משימה נעצרת לפני שהיא מסתיימת בגלל אחת מהסיבות הבאות (הסקר jobs.get מחזיר את קוד ה-HTTP‏ 200 עם reason: stopped):

  • המתקשר מבטל את המשימה באופן מפורש (User requested cancellation).
  • המשימה חורגת מהזמן הקצוב לתפוגה שהוגדר לביצוע או לתור (Job timed out after duration או Job timed out in the queue after duration).

השגיאה שמוחזרת: Job execution was cancelled: details.

מגדילים את אפשרויות הזמן הקצוב לתפוגה של configuration.jobTimeoutMs או של תור הפרויקט (או מבצעים אופטימיזציה של זמן הריצה והבו-זמניות של השאילתות), או בודקים את יומני הביקורת של Cloud כדי לאתר קריאות ל-jobservice.cancel. במאמר ביצוע המשימה בוטל מוסבר איך לפתור את הבעיה לפי סוג המשנה.

‫500 – שגיאת שרת פנימית

סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
internalError 500

אירעה שגיאה פנימית ב-BigQuery. השגיאה שמוחזרת: An internal error occurred and the request could not be completed.

ממתינים בהתאם לדרישות ההשהיה לפני ניסיון חוזר (backoff) שמפורטות בהסכם רמת השירות של BigQuery, ומנסים שוב באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff). אפשר גם להשתמש בהזמנות כדי להפחית את התדירות של שגיאות זמניות. מידע נוסף זמין במאמר פתרון בעיות שקשורות לשגיאות internalError.

‫501 — לא בוצע יישום

סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
notImplemented 501

בקשה שמנסה להשתמש בתכונה או בפעולה שלא הוטמעו במשאב היעד, למשל:

  • העתקת טבלה עם סוג אחסון לא מנוהל.
  • הפעלת אפשרות לא נתמכת של ALTER SEARCH INDEX.

השגיאה שמוחזרת: Not Implemented: details.

צריך להמיר מקורות לא נתמכים של העתקת טבלאות באמצעות CREATE TABLE destination_table AS SELECT * FROM source_table, או להסיר וליצור מחדש אינדקס החיפוש באמצעות DROP SEARCH INDEX ו-CREATE SEARCH INDEX. במאמר התכונה או הפעולה לא הוטמעו מוסבר איך לפתור את הבעיה לפי סוג המשנה.

‫503 – השירות לא זמין

סיבה קוד סטטוס של HTTP תיאור פתרון בעיות
backendError 503

השירות לא זמין כרגע בגלל אחת מהסיבות הבאות:

  • עלייה חדה בביקוש לשירות (השלת עומס) או מיצוי של משאבים פנימיים.
  • בעיות בחיבור לרשת לסירוגין.
  • בעיה זמנית ברכיב בקצה העורפי.

השגיאה שמוחזרת: Error encountered during execution. Retrying may solve the problem.

מנסים שוב לשלוח את הבקשות באמצעות השהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff), ומנסים שוב להפעיל את המשימות שנכשלו עם jobId חדש. אם השגיאות נמשכות גם אחרי כמה ניסיונות, השוו את שיעור הכשלים ב-30 הימים האחרונים להסכם רמת השירות (SLA) של BigQuery ופנו ל-Cloud Customer Care. תוכלו גם לקרוא איך לפתור שגיאות backendError.