פתרון בעיות בהגדרות ההעברה

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

אם נתקלתם בבעיות שלא מפורטות במסמך הזה, אתם יכולים לפנות לתמיכה.

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

בדיקת השגיאות

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

אפשר גם להציג הודעות שגיאה של עבודת העברה ספציפית באמצעות Logs Explorer. מסנן Logs Explorer הבא מחזיר מידע על משימת הגדרת העברה ספציפית, יחד עם הודעות שגיאה:

resource.type="bigquery_dts_config"
labels.run_id="RUN_ID"
resource.labels.config_id="CONFIG_ID"

מחליפים את מה שכתוב בשדות הבאים:

  • RUN_ID: מספר המזהה של הפעלת משימה ספציפית
  • ‫CONFIG_ID: מספר המזהה של עבודת הגדרת העברה

לפני שפונים לתמיכת הלקוחות, כדאי לתעד את כל המידע הרלוונטי מהיסטוריית ההרצה או מכלי Logs Explorer, כולל הודעות שגיאה.

אם אתם משתמשים בהעברות מבוססות-אירועים, יכול להיות שההגדרה של העברה מבוססת-אירועים לא תפעיל את ההרצה של ההעברה. הודעות השגיאה מופיעות בחלק העליון של הדף run history או בדף configuration.

בעיות כלליות

כדי לאבחן בעיות כלליות בהעברה, צריך לבדוק את הדברים הבאים:

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

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

שגיאה: An unexpected issue was encountered. If this issue persists, please contact customer support.
פתרון: בדרך כלל השגיאה הזו מציינת שיש הפסקה זמנית בשירות או בעיה ב-BigQuery. מחכים כשעתיים עד שהבעיה תיפתר. אם הבעיה נמשכת, אפשר לפנות לתמיכה.
שגיאה: INTERNAL: An internal error occurred and the request could not be completed. This is usually caused by a transient issue...
פתרון: השגיאה הזו בדרך כלל מעידה על בעיה פנימית זמנית. אם נתקלתם בשגיאה הזו, אתם יכולים לחכות ולראות אם היא תיפתר בהרצה המתוזמנת הבאה, או שאתם יכולים להפעיל ידנית מילוי חוזר לתאריכים המושפעים. אם הבעיה נמשכת, אפשר לפנות לתמיכה.
שגיאה: Quota Exceeded.

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

אם אתם טוענים נתוני ייצוא של החיוב ב-Cloud ל-BigQuery, יכול להיות שתיתקלו בשגיאה Quota Exceeded. גם הטבלאות של נתוני החיוב ב-Cloud וגם טבלאות היעד ב-BigQuery שנוצרות על ידי שירות העברת הנתונים ל-BigQuery מחולקות למחיצות. אם בוחרים באפשרות overwrite (החלפה) כשמגדירים משימות כאלה של שירות העברת נתונים ל-BigQuery, יכולות להופיע שגיאות שקשורות למכסת השימוש, בהתאם לכמות הנתונים שמיוצאת. למידע על פתרון בעיות שקשורות למכסות, אפשר לעיין במאמר פתרון בעיות שקשורות למכסות ולמגבלות.

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

שגיאה: The caller does not have permission.

פתרון: מוודאים שהחשבון שמחוברים אליו במסוף Google Cloud הוא אותו חשבון שבחרתם בשירות העברת הנתונים ל-BigQuery כשיוצרים את ההעברה.

  • החשבון שמחובר למסוף Google Cloud :

    פתרון בעיות שקשורות להרשאות

  • בחירת החשבון שבאמצעותו תתבצע הכניסה אל שירות העברת נתונים ל-BigQuery:

    פתרון בעיות שקשורות להרשאות

שגיאה: Access Denied: ... Permission bigquery.tables.get denied on table ...

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

שגיאה: region violates constraint constraints/gcp.resourceLocations on the resource projects/project_id

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

שגיאה: Please look into the errors[] collection for more details.

פתרון: השגיאה הזו יכולה להתרחש אם העברת נתונים נכשלת. כדי לקבל מידע נוסף על הסיבה לכשל בהעברת הנתונים, אפשר להשתמש ב-Cloud Logging כדי להציג את היומנים. אפשר למצוא יומנים של ריצה ספציפית באמצעות חיפוש בכלי ההעברה run_id.

שגיאה: Network Attachment with connected endpoints cannot be deleted.

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

שגיאה: Error while reading data, error message: CSV processing encountered too many errors, giving up.

פתרון: השגיאה הזו יכולה להתרחש אם יש חוסר התאמה בין ההגדרה של קובץ ה-CSV במקור הנתונים לבין ההגדרה של קובץ ה-CSV בהגדרת ההעברה. לדוגמה, השגיאה הזו יכולה להתרחש אם הערך של שורות כותרת לדילוג מוגדר כ-0, אבל קובץ ה-CSV של המקור מכיל שורת כותרת אחת או יותר. כדי לפתור את השגיאה הזו, צריך לוודא שהגדרות ה-CSV בהגדרות ההעברה נכונות ושהן תואמות להגדרות של קובץ ה-CSV של המקור.

שגיאה: Error 400: DTS service agent needs iam.serviceAccounts.getAccessToken permission or [SERVICE_ACCOUNT] doesn't exist.

הגורם הבסיסי: השגיאה הזו מציינת לסוכן השירות של שירות העברת הנתונים ל-BigQuery (DTS) אין את ההרשאה הנדרשת להתחזות לחשבון השירות שמשמש להעברה. זה קורה בדרך כלל בתרחישי הרשאה בין פרויקטים או כשההעברה מוגדרת באמצעות כלים של תשתית כקוד (IaC) כמו Terraform.

פתרון: צריך להקצות לסוכן השירות של DTS את התפקיד 'יצירת אסימונים בחשבון שירות' (roles/iam.serviceAccountTokenCreator) בחשבון השירות הספציפי שאליו הוא צריך להתחזות.

gcloud iam service-accounts add-iam-policy-binding service_account \
--member serviceAccount:service-destination_project_number@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com \
--role roles/iam.serviceAccountTokenCreator

כאשר:

שגיאה: For asset "ASSET", no eligible column found for splitting (Reason: Primary or Indexed Key columns found, but none are of supported types (INTEGER, TINYINT, SMALLINT, FLOAT, REAL, DOUBLE, NUMERIC, BIGINT, DECIMAL, DATE, BOOLEAN))
פתרון: השגיאה הזו יכולה להתרחש כשמנסים להעביר יותר מ-2,000,000 רשומות מטבלת מקור לטבלה ב-BigQuery, ואין בטבלת המקור מפתח ראשי או עמודה עם אינדקס מסוג נתונים נתמך. כדי לפתור את הבעיה, צריך להגדיר עמודה עם אחד מסוגי הנתונים הנתמכים כמפתח ראשי או כעמודה עם אינדקס בטבלת המקור. מידע נוסף מופיע בקטע 'מגבלות' במדריך למקור ההעברה.
שגיאה: Permission bigquery.tables.create denied.

תסמין:

Error code 7 : Access Denied : Dataset [PROJECT_ID]:[DATASET_ID] : Permission bigquery.tables.create denied on dataset [PROJECT_ID]:[DATASET_ID] (or it may not exist).

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

הסיבה: השגיאה הזו מתרחשת כשמריצים העברה ב-Cloud Storage שכוללת יותר מ-10,000 קבצים, ולא ניתנה ההרשאה bigquery.tables.create. אם ההעברות כוללות יותר מ-10,000 קבצים, השירות מפצל את הנתונים לטבלאות זמניות של הכנה, שנוצרות באופן דינמי. כדי לעשות זאת, נדרשת ההרשאה bigquery.tables.create גם אם הפרויקט רשום להעברות בכמות גדולה (או אם אושרה לו הגדלת מכסה).

פתרון: כדי להעביר יותר מ-10,000 קבצים בהצלחה, צריך לוודא שאתם עומדים בשני התנאים הבאים:

  1. בדיקת המכסה וההרשמה לתכונות: מוודאים שהפרויקט רשום להעברות של נפח גדול ב-Cloud Storage (מעל 10,000 קבצים). אם אתם צריכים להעביר יותר מ-10,000 קבצים, פנו לתמיכה כדי לבקש הגדלה של המכסה של מספר הקבצים המקסימלי להעברה בכל הפעלה.

  2. נותנים את ההרשאות הנדרשות ב-IAM: נותנים לחשבון השירות או לזהות המשתמש שמריצים את ההעברה את ההרשאה bigquery.tables.create במערך הנתונים של היעד. ההרשאה הזו כלולה בתפקידים BigQuery Data Editor (roles/bigquery.dataEditor) ו-BigQuery Admin (roles/bigquery.admin). אם השגיאות ממשיכות להופיע אחרי שמעניקים את ההרשאות הנדרשות, יכול להיות שצריך לפנות לתמיכה כדי לוודא שהסטטוס שלכם ברשימת ההיתרים תקין.

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

בעיות בהרשאות ובאישור

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

שגיאה: BigQuery Data Transfer Service is not enabled for <project_id>
שגיאה: BigQuery Data Transfer Service has not been used in project <project_id> before or it is disabled ...

פתרון: כדי לוודא שהתפקיד של סוכן השירות הוענק, מבצעים את השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin.

    כניסה לדף IAM & Admin

  2. מסמנים את תיבת הסימון Include Google-provided role grants.

  3. מוודאים שחשבון השירות עם השם service-<project_number>@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com מוצג או שניתנה לו הרשאת סוכן של שירות העברת נתונים ל-BigQuery.

    בודקים אם לחשבון השירות יש תפקיד של סוכן שירות.

אם חשבון השירות לא מוצג, או שלא הוקצה לו תפקיד סוכן שירות של שירות העברת הנתונים ל-BigQuery, צריך להקצות את התפקיד המוגדר מראש ב Google Cloud מסוף Google Cloud או על ידי הפעלת הפקודה הבאה ב-CLI של Google Cloud:

gcloud projects add-iam-policy-binding PROJECT_NUMBER \
--member serviceAccount:service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com \
--role roles/bigquerydatatransfer.serviceAgent

מחליפים את הערך PROJECT_NUMBER במספר הפרויקט שמשויך לחשבון השירות הזה.

שגיאה: There was an error loading this table. Check that the table exists and that you have the correct permissions.

פתרון:

  1. במסוף Google Cloud , עוברים לדף BigQuery.

    כניסה ל-BigQuery

  2. לוחצים על מערך הנתונים של היעד שבו נעשה שימוש בהעברה.

  3. לוחצים על התפריט שיתוף ואז על הרשאות.

  4. מרחיבים את התפקיד BigQuery Data Editor.

  5. מוודאים שסוכן השירות של שירות העברת הנתונים ל-BigQuery נוסף לתפקיד הזה. אם לא, צריך להעניק את התפקיד BigQuery Data Editor ‏ (roles/bigquery.dataEditor) לסוכן השירות של שירות העברת הנתונים ל-BigQuery.

מוודאים שהתפקיד BigQuery Data Editor (עריכת נתונים ב-BigQuery) נוסף.

שגיאה: A permission denied error was encountered: PERMISSION_DENIED. Please ensure that the user account setting up the transfer config has the necessary permissions, and that the configuration settings are correct

פתרון:

  1. נכנסים לדף Data Transfers במסוף Google Cloud .

    מעבר אל 'העברות נתונים'

  2. לוחצים על ההעברה שנכשלה ואז על הכרטיסייה הגדרות.

  3. מוודאים שלבעלי ההעברה שמופיעים בשדה משתמש יש את כל ההרשאות הנדרשות למקור הנתונים.

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

שגיאה: Authentication failure: User Id not found. Error code: INVALID_USERID

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

שגיאה: The user does not have permission

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

שגיאה: HttpError 403 when requesting returned "The caller does not have permission"

googleapiclient.errors.HttpError: <HttpError 403 when requesting returned "The caller does not have permission". Details: "The caller does not have permission">

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

פתרון: מוודאים שלחשבון השירות יש את כל ההרשאות הנדרשות לתזמון או לשינוי של שאילתה מתוזמנת, ומוודאים שלמשתמש שמגדיר את השאילתה המתוזמנת יש גישה לחשבון השירות.

אם כל ההרשאות הנכונות הוקצו אבל עדיין מופיעה השגיאה, צריך לבדוק אם המדיניות השבתת השימוש בחשבונות שירות בפרויקטים שונים נאכפת בפרויקט כברירת מחדל. כדי לבדוק אם המדיניות קיימת במסוף Google Cloud , עוברים אל IAM & Admin ‏> Organization Policies ומחפשים את המדיניות.

בודקים אם מדיניות השימוש בחשבון שירות בין פרויקטים נאכפת בחשבון שירות.

אם המדיניות השבתת השימוש בחשבון שירות בפרויקטים שונים נאכפת, אפשר להשבית את המדיניות כך:

  1. כדי לזהות את חשבונות השירות שמשויכים לפרויקט באמצעות המסוף, עוברים אל IAM & Admin > Service Accounts. Google Cloud בתצוגה הזו מופיעים כל חשבונות השירות של הפרויקט הנוכחי.
  2. משביתים את המדיניות בפרויקט שבו נמצאים חשבונות השירות באמצעות הפקודה הבאה. כדי להשבית את המדיניות הזו, המשתמש צריך להיות אדמין של מדיניות הארגון. רק אדמין הארגון יכול להעניק למשתמש את התפקיד הזה.
gcloud resource-manager org-policies disable-enforce iam.disableCrossProjectServiceAccountUsage --project=[PROJECT-ID]

בעיות בהגדרת העברה מבוססת-אירועים

ריכזנו כאן כמה בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה מבוססת-אירועים.

שגיאה: Data Transfer Service is not authorized to pull message from the provided Pub/Sub subscription.

פתרון: מוודאים שלסוכן השירות של שירות העברת הנתונים ל-BigQuery הוקצה התפקיד pubsub.subscriber:

  1. נכנסים לדף Pub/Sub במסוף Google Cloud .

    מעבר אל Pub/Sub

  2. בוחרים את מינוי Pub/Sub שבו השתמשתם בהעברה מבוססת-אירועים.

  3. אם חלונית המידע מוסתרת, לוחצים על Show info panel בפינה השמאלית העליונה.

  4. בכרטיסייה הרשאות, מוודאים שלסוכן השירות של שירות העברת הנתונים ל-BigQuery הוקצה התפקיד pubsub.subscriber.

בודקים אם לסוכן השירות יש הרשאה pubsub.subscriber במינוי.

אם לסוכן השירות לא הוקצה התפקיד pubsub.subscriber. לוחצים על Add principal כדי לתת את התפקיד pubsub.subscriber לחשבון service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com

שגיאה: Cloud Pub/Sub API has not been used in project PROJECT_NUMBER before or it is disabled.

פתרון: מוודאים ש-Cloud Pub/Sub API מופעל בפרויקט:

  1. במסוף Google Cloud , נכנסים לדף APIs & Services.

    כניסה אל APIs & Services

  2. לוחצים על Enable APIs and services.

  3. מחפשים את Cloud Pub/Sub API, בוחרים את התוצאה הראשונה ולוחצים על הפעלה.

שגיאה: Data Transfer Service does not have required permission to use project quota of project PROJECT_NUMBER to access Pub/Sub.

פתרון: מוודאים שלסוכן השירות של שירות העברת הנתונים ל-BigQuery הוקצה התפקיד serviceusage.serviceUsageConsumer:

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin.

    כניסה לדף IAM & Admin

  2. מסמנים את תיבת הסימון Include Google-provided role grants.

  3. מוודאים שחשבון השירות עם השם service-<project_number>@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com מוצג ושהוקצה לו התפקיד Service Usage Consumer.

    בודקים אם לחשבון השירות יש את התפקיד serviceusage.serviceUsageConsumer.

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

הפעלת ההעברה לא מתבצעת מיד אחרי קבלת אירוע. יכול להיות שיחלפו כמה דקות עד שהעברת הנתונים תתחיל. כדי לבדוק את הסטטוס של ההרצה הבאה של ההעברה, אפשר לעיין בשדה Target date for next run בrun history. בשדה הזה מוצג זמן התזמון של ההרצה הבאה, או שמוצגת ההודעה waiting for events to schedule next run (המתנה לאירועים כדי לתזמן את ההרצה הבאה) אם לא התקבלו אירועים. אם העליתם או עדכנתם קבצים בקטגוריה של Cloud Storage, אבל תאריך היעד להפעלה הבאה לא עודכן ולא מופעלות הרצות במשך 10-20 דקות, כדאי לנסות את הפתרון הבא.

פתרון: מוודאים שהמינוי ל-Pub/Sub שצוין בהגדרות ההעברה יכול לקבל הודעות שפורסמו מאירועים ב-Cloud Storage:

  1. נכנסים לדף Pub/Sub במסוף Google Cloud .

    מעבר אל Pub/Sub

  2. בוחרים את מינוי Pub/Sub שבו השתמשתם בהעברה מבוססת-אירועים.

  3. בכרטיסייה Metrics (מדדים), בודקים את התרשים 'Oldest unacked message age' (הגיל של ההודעה הכי ישנה שלא אושרה) ורואים אם יש הודעות.

איך בודקים אם נשלחות הודעות

אם לא מתפרסמות הודעות, צריך לבדוק אם התראת Pub/Sub מוגדרת בצורה נכונה ל-Cloud Storage. אפשר להשתמש בפקודה הבאה של Google Cloud CLI כדי לבדוק את הגדרות ההתראות שמשויכות לקטגוריה:

gcloud storage buckets notifications list gs://BUCKET_NAME

מחליפים את BUCKET_NAME בשם הקטגוריה שבה משתמשים להתראות. מידע על הגדרת התראת Pub/Sub ל-Cloud Storage זמין במאמר הגדרת התראת Pub/Sub ל-Cloud Storage.

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

בעיות בהעברה ב-Amazon S3

בטבלה הבאה ריכזנו כמה מהשגיאות הנפוצות שמשתמשים נתקלים בהן כשיוצרים העברה ב-Amazon S3.

שגיאות ב-Amazon S3 PERMISSION_DENIED

שגיאה: The AWS Access Key Id you provided does not exist in our records.
פתרון: מוודאים שמפתח הגישה קיים ושהמזהה נכון.
שגיאה: The request signature we calculated does not match the signature you provided. Check your key and signing method.
פתרון: מוודאים שבהגדרות ההעברה מוגדר מפתח הגישה הסודי המתאים
שגיאה: Failed to obtain the location of the source S3 bucket. Additional details: Access Denied
שגיאה: Failed to obtain the location of the source S3 bucket. Additional details: HTTP/1.1 403 Forbidden
שגיאה: Access Denied (הודעת שגיאה של S3)
פתרון: מוודאים שלמשתמש AWS IAM יש הרשאה לבצע את הפעולות הבאות:
  • מציגים את רשימת הקטגוריות ב-Amazon S3.
  • קבלת המיקום של הקטגוריה.
  • קריאת האובייקטים בקטגוריה.
שגיאה: Server unable to initialize object upload.; InvalidObjectState: The operation is not valid for the object's storage class
שגיאה: Failed to obtain the location of the source S3 bucket. Additional details: All access to this object has been disabled
פתרון: משחזרים את כל האובייקטים שארכבתם ב-Amazon Glacier. לא ניתן לגשת לאובייקטים ב-Amazon S3 שארכובו ב-Amazon Glacier עד שהם ישוחזרו
שגיאה: All access to this object has been disabled
פתרון: מוודאים שמזהה ה-URI של Amazon S3 בהגדרות ההעברה נכון

שגיאות במגבלות ההעברה ב-Amazon S3

שגיאה: Number of files in transfer exceeds limit of 10,000.
פתרון: בודקים אם אפשר לצמצם את מספר תוויי ה-wildcard ב-URI של Amazon S3 לאחד בלבד. אם זה אפשרי, כדאי לנסות שוב עם הגדרת העברה חדשה, כי המספר המקסימלי של קבצים בכל הפעלה של העברה יהיה גבוה יותר. אפשר גם לבדוק אם אפשר לפצל את הגדרת ההעברה לכמה הגדרות העברה, כשכל אחת מהן מעבירה חלק מנתוני המקור.
שגיאה: Size of files in transfer exceeds limit of 16492674416640 bytes.
פתרון: בודקים אם אפשר לפצל את הגדרת ההעברה לכמה הגדרות העברה, שכל אחת מהן מעבירה חלק מנתוני המקור.

בעיות כלליות ב-Amazon S3

בעיה: קבצים מועברים מ-Amazon S3 אבל לא נטענים ל-BigQuery.

יומני ההעברה עשויים להיראות כך: Moving data from Amazon S3 to Google Cloud complete: Moved N object(s). No new files found matching Amazon_S3_URI.

פתרון: מוודאים שמזהה ה-URI של Amazon S3 בהגדרות ההעברה נכון. אם הגדרתם את העברת הנתונים כך שתטען את כל הקבצים עם קידומת משותפת, צריך לוודא שמזהה ה-URI של Amazon S3 מסתיים בתו כללי. לדוגמה, כדי לטעון את כל הקבצים ב-s3://my-bucket/my-folder/, ה-URI של Amazon S3 בהגדרת ההעברה צריך להיות s3://my-bucket/my-folder/*, ולא רק s3://my-bucket/my-folder/.

בעיות בהעברה של Azure Blob Storage

בהמשך מפורטות שגיאות נפוצות שנתקלים בהן כשיוצרים העברה של Blob Storage.

שגיאה: Number of files in transfer exceeds the limit of 10,000.
פתרון: צריך להקטין את מספר תוויי ה-Wildcard בנתיב הנתונים של Blob Storage ל-0 או ל-1, כדי שמגבלת הקבצים תגדל ל-10,000,000. אפשר גם לפצל את ההעברה לכמה הגדרות העברה, כשכל אחת מהן מעבירה חלק מהמקור.
שגיאה: Size of files in transfer exceeds the limit of 15 TB.
פתרון: פיצול לכמה הגדרות העברה, כשכל אחת מעבירה חלק מנתוני המקור.
שגיאה: Provided Azure SAS Token does not have required permissions.
פתרון: מוודאים שטוקן ה-SAS של Azure בהגדרות ההעברה נכון. מידע נוסף זמין במאמר בנושא חתימת גישה משותפת (SAS).
שגיאה: Transfer encountered error, status:PERMISSION_DENIED, details:[This request is not authorized to perform this operation.]
פתרון: מוודאים שטווח כתובות ה-IP שמשמש את העובדים של שירות העברת נתונים ל-BigQuery נוסף לרשימת כתובות ה-IP המותרות. מידע נוסף מופיע במאמר בנושא הגבלות על כתובות IP.
בעיה: קבצים מועברים מ-Blob Storage אבל לא נטענים ל-BigQuery.

יומני ההעברה עשויים להיראות כך: Moving data to Google Cloud complete: Moved <var>N</var> object(s). No new files found matching Blob Storage data path.

פתרון: מוודאים שנתיב הנתונים ב-Blob Storage בהגדרת ההעברה נכון.

בעיות בהעברה ב-Campaign Manager

בהמשך מפורטות שגיאות נפוצות שמתרחשות כשיוצרים העברה ב-Campaign Manager.

שגיאה: Import failed - no data was available for import. Please verify that data existence was expected.
שגיאה: No data available for the requested date. Please try an earlier run date or verify that data existence was expected.

פתרון: מוודאים שמשתמשים במזהה הנכון להעברה. אם אתם משתמשים במזהה הנכון, צריך לוודא שקטגוריית Cloud Storage של Campaign Manager מכילה קבצים של העברת נתונים בגרסה 2.0 לטווח התאריכים שצוין. אם הקבצים קיימים, מתזמנים מילוי חוסרים לטווח התאריכים הרלוונטי. מידע נוסף על יצירת בקשה למילוי חוסרים ב-Campaign Manager זמין במאמר בנושא הפעלה ידנית של העברה או מילוי חוסרים.

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

שגיאה: A permission denied error was encountered: PERMISSION_DENIED. Please ensure that the user account setting up the transfer config has the necessary permissions, and that the configuration settings are correct.

פתרון: למשתמש שיוצר את ההעברה ב-Campaign Manager צריכה להיות הרשאת קריאה לקטגוריה של Cloud Storage שמכילה את הקבצים של העברת נתונים גרסה 2.0. אפשר לקבל מידע על קטגוריית Cloud Storage ולבקש גישה מהאדמין של Campaign Manager.

בעיות בהעברה של נתונים מ-Google Ads

בהמשך מפורטות שגיאות נפוצות שמתרחשות כשיוצרים העברה של חשבון Google Ads.

בעיה: ההרצה של ההעברה הושלמה בהצלחה, אבל חלק מהחשבונות לא מופיעים בטבלת היעד.

פתרון: יכולות להיות הרבה סיבות לכך שחשבון לא מופיע בדוח. הנה כמה סיבות נפוצות:

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

  • זה יכול לקרות גם אם חשבון Google Ads שלכם לא פעיל, או CANCELLED. ‫Google Ads API לא תומך בשאילתות בחשבונות לא פעילים, ולכן המחבר של Google Ads סינן חשבונות לא פעילים מהרצת ההעברה. כדי להפעיל מחדש את החשבון ב-Google Ads, אפשר לעיין במאמר הפעלה מחדש של חשבון Google Ads שבוטל.

שגיאה: AUTH_ERROR_TWO_STEP_VERIFICATION_NOT_ENROLLED

פתרון: השגיאה הזו מציינת שלא הופעל אימות דו-שלבי למשתמש ב-Google Ads שמשמש להעברה הזו. מידע על הפעלת אימות דו-שלבי זמין במאמר הפעלת אימות דו-שלבי.

שגיאה: No jobs to start for run

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

  • בודקים את יומן ההיסטוריה של הרצת ההעברה כדי לראות אם יש שגיאות ואזהרות.
  • אם בטבלאות שאתם מנסים לטעון אין עמודות segments_date, segments_week, segments_month, segments_quarter או segments_year, המערכת אמורה לדלג על הטעינה אם run_date הוא לא התאריך האחרון. מידע נוסף זמין במאמרים בנושא הפעלה ידנית של העברה ב-Google Ads ודוחות בהתאמה אישית.
  • אם אתם מתקשים למצוא את שורש הבעיה, אתם יכולים לשלוח בקשה לתמיכה.
שגיאה: Import failed - no data was available for import. Please verify that data existence was expected.
שגיאה: No data available for the requested date. Please try an earlier run date or verify that data existence was expected.

פתרון: אם השגיאה הזו מופיעה כשיוצרים העברה של נתונים מ-Google Ads, צריך לפנות לתמיכה ולצרף צילום מסך של הודעת השגיאה.

שגיאה: AuthenticationError.NOT_ADS_USER.

פתרון: המשתמש שמגדיר את ההעברה של Google Ads צריך להיות בעל חשבון Google Ads או פרטי התחברות לחשבון כזה.

שגיאה: Request is missing required authentication credential

פתרון: למשתמש או לחשבון השירות אין גישה לחשבון Google Ads. פועלים לפי ההוראות בקטע הרשאות נדרשות כדי להעניק למשתמש או לחשבון השירות את ההרשאות הנדרשות.

שגיאה: ERROR_GETTING_RESPONSE_FROM_BACKEND.

פתרון: אם הפעלת העברה של Google Ads נכשלת ומוחזרת ERROR_GETTING_RESPONSE_FROM_BACKEND, מפעילים את האפשרות החרגת פריטים שהוסרו או שהושבתו בהגדרת ההעברה ומגדירים מילוי חוסרים כדי לנסות לאחזר נתונים מהימים שהושפעו מהפעלת ההעברה שנכשלה.

אזהרה: Data for the report ClickStats was not available for the specified date.
שגיאה: INVALID_DATE_RANGE_FOR_REPORT.

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

שגיאה: Error while processing report for table table_name for account id account_id. Http(400) Bad Request;
שגיאה: AuthorizationError.TWO_STEP_VERIFICATION_NOT_ENROLLED

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

שגיאה: Quota exceeded: Your project exceeded quota for imports per project

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

בהמשך מפורטות שגיאות נפוצות שנתקלים בהן כשיוצרים העברה ב-Google Ad Manager.

שגיאה: Another transfer run is concurrently processing table.

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

  • אם זמן האחזור נגרם בגלל קבצים גדולים של העברת נתונים (DT) ב-Google Ad Manager, כדאי להפעיל את פורמט Parquet, שמאפשר טעינה מהירה יותר.
  • אם השהייה נגרמת בגלל טבלאות התאמה, אפשר לדלג על טבלאות ההתאמה על ידי הגדרת הפרמטר load_match_tables לערך false.
  • אם העיבוד של ההעברה נמשך באופן עקבי יותר זמן מהתדירות הנוכחית של החזרה, כדאי לשנות את התדירות.
שגיאה: No data available for the requested date. Please try an earlier run date or verify that data existence was expected.
שגיאה: Import failed - no data was available for import. Please verify that data existence was expected.

פתרון: צריך לוודא שקטגוריית Cloud Storage ב-Google Ad Manager מכילה קבצים של העברת נתונים לטווח התאריכים שצוין. האדמין שלכם ב-Google Ad Manager מנהל את קטגוריה של Cloud Storage שכוללת את הקבצים של העברת הנתונים. משתמשים שיוצרים העברות ב-Google Ad Manager צריכים להיות חברים בקבוצת Google עם הרשאת קריאה לדלי.

כדי לאמת את ההרשאות ב-Cloud Storage, אפשר לנסות לקרוא קבצים בקטגוריה של העברת נתונים ב-Google Ad Manager. מידע נוסף על קטגוריות של Google Ad Manager Cloud Storage זמין במאמר גישה לקטגוריות של Google Ad Manager Storage.

כדי לבדוק אם הקבצים היו קיימים כשתוזמן ההעברה, אפשר לבדוק את זמן היצירה של הקבצים בקטגוריה של Cloud Storage. במקרים מסוימים, יכול להיות שההפעלה הראשונה של העברת הנתונים באותו יום תתוזמן לפני יצירת הקבוצה הראשונה של קובצי העברת נתונים של Google Ad Manager. הפעלות עוקבות באותו יום וביום שאחריו יטענו את כל הקבצים שנוצרו על ידי Google Ad Manager.

אם הקבצים קיימים בדלי של העברת הנתונים ויש לכם הרשאות קריאה, צריך לתזמן מילוי חוסרים לטווח התאריכים הרלוונטי. מידע נוסף על יצירת בקשה למילוי חוזר ב-Google Ad Manager זמין במאמר הגדרת מילוי חוזר.

שגיאה: AuthenticationError: NO_NETWORKS_TO_ACCESS.

פתרון: צריך לוודא שיש לכם הרשאת קריאה לרשת Google Ad Manager. אם אתם צריכים עזרה בקביעת גישה לרשת, אתם יכולים לפנות אל התמיכה של Google Ad Manager.

שגיאה: Error code 9 : Field field_name?field_name?field_name?RefererURL is unknown.; Table: table_name

פתרון: מוודאים שלא משתמשים במפריד thorn (þ). אין תמיכה בתו המפריד thorn. השימוש באות thorn מסומן בסימן השאלה ? בהודעת השגיאה.

שגיאה: Incompatible table partitioning specification. Destination table exists with partitioning specification interval(type:Day,field:) clustering

פתרון: מחבר חשבון הניהול של Google Ads לא תומך בהעברת נתונים לקבוצת נתונים עם אשכולות. במקום זאת, אפשר להשתמש במערך נתונים בלי אשכולות.

בעיות בהעברה של חשבון Google Merchant Center

אלה שגיאות נפוצות שנתקלים בהן כשיוצרים העברה של Google Merchant Center.

שגיאה: No data to transfer found for the Merchant account. If you have just created this transfer - you may need to wait for up to 90 minutes before the data of your Merchant account are prepared and available for the transfer.
פתרון: השגיאה הזו מתקבלת אם מגדירים העברה באמצעות תאריך ושעת ההתחלה שמוגדרים כברירת מחדל בקטע 'תזמון'. אם משתמשים בערכי התזמון שמוגדרים כברירת מחדל, ההרצה הראשונה של ההעברה מתחילה מיד אחרי יצירת ההעברה, אבל היא נכשלת כי צריך להכין את הנתונים בחשבון של המוכר/ת לפני שאפשר להעביר אותם. צריך להמתין 90 דקות ואז להגדיר מילוי חוסרים להיום, או לחכות עד מחר להרצה המתוזמנת הבאה.
שגיאה: No data to transfer found for Merchant account. This can be because your account currently doesn't have any products.
פתרון: השגיאה הזו מציינת שאין מוצרים בחשבון שלכם ב-Merchant Center. ההעברה תתחיל לפעול אחרי שתוסיפו מוצרים לחשבון Merchant Center.
שגיאה: Transfer user doesn't have access to the Merchant account. Please verify access in the Users section of the Google Merchant Center.
פתרון: השגיאה הזו מציינת שלמשתמש שהגדיר את ההעברה אין גישה לחשבון המוכר שבו נעשה שימוש בהעברה. כדי לפתור את הבעיה, צריך לאמת את החשבון ולהעניק את הגישה החסרה ב-Google Merchant Center.
שגיאה: Transfer user doesn't have user roles that allows access to the product data of the Merchant account. Please verify access and roles in the Users section of the Google Merchant Center.
פתרון: השגיאה הזו מציינת שלמשתמש שהגדיר את ההעברה אין גישה לנתוני המוצרים של חשבון של מוכר/ת שבו נעשה שימוש בהעברה. כדי לפתור את הבעיה, צריך לאמת את תפקידי המשתמשים החסרים ולהעניק אותם ב-Google Merchant Center.
שגיאה: Historical backfills are not supported.
פתרון: השגיאה הזו מתרחשת אם הגדרתם מילוי חוסרים לימים קודמים. זו שגיאה צפויה. אין תמיכה במילוי חוסרים היסטוריים. אפשר להגדיר מילוי חוסרים רק להיום, כדי לרענן את הנתונים של היום אחרי שהריצה היומית המתוזמנת כבר הסתיימה.

בעיות בהעברה ב-Google Play

בהמשך מפורטות שגיאות נפוצות שנתקלים בהן כשיוצרים העברה ב-Google Play.

שגיאה: No jobs to start for run
פתרון: מוודאים שלמשתמש יש הרשאות מספיקות כדי להתחיל העברה של נתונים מ-Google Play, ואז מוודאים שהמשתמש ציין את דליקת Cloud Storage הנכונה כשהגדיר את ההעברה. אם השגיאה עדיין מופיעה אצל המשתמש, אפשר לשלוח בקשת תמיכה.
בעיה: דוחות הכנסות ודוחות פיננסיים לא נטענו ב-BigQuery
פתרון: כדי לגשת לדוחות פיננסיים של Google Play, למשתמשים צריכה להיות ההרשאה View financial data. הוראות לניהול הרשאות בחשבון למפתחים מופיעות במאמר הוספת משתמשים לחשבון למפתחים וניהול הרשאות.

בעיות בהעברה ב-HubSpot

שגיאה: PERMISSION_DENIED: Permission denied. Your Access Token may lack required access to the provided account. Please also check for typos like whitespace or if the provided accountId even exists
פתרון: בודקים שאסימון הגישה לאפליקציה הפרטית נכון, שלמשתמש ב-HubSpot יש תפקיד של סופר-אדמין, ושלאפליקציה הפרטית יש את כל ההיקפים הנדרשים. מידע נוסף זמין במאמר בנושא דרישות מוקדמות ל-HubSpot.
שגיאה: INVALID_ARGUMENT: Table 'NAME' does not exist in asset "ASSET"
פתרון: בודקים ששם הנכס שצוין תקין ושאין בו רווחים בתחילת השם או בסופו. כשיוצרים העברה של HubSpot, מומלץ ללחוץ על עיון כדי לבחור את הנכס מתוך רשימת האובייקטים הזמינים.
שגיאה: FAILED_PRECONDITION: Rate limit exceeded.
פתרון: חריגה ממגבלת הקצב של יצירת הבקשות ב-HubSpot API. מחכים קצת לפני שמנסים שוב להעביר את הנתונים. אפשר גם לצמצם את התדירות של העברות נתונים ולהגביל את ההעברות בו-זמנית בחשבונות דומים.
שגיאה: UNAUTHENTICATED: Authentication failed. Please verify your HubSpot access token.
פתרון: צריך לוודא שאסימון הגישה לאפליקציה הפרטית נכון. מידע נוסף זמין במאמר דרישות מוקדמות לשימוש ב-HubSpot.
שגיאה: UNKNOWN: An unknown error occurred while processing the request.
פתרון: מוודאים שאסימון הגישה לאפליקציה הפרטית של HubSpot נכון, ושההרשאות הנדרשות קיימות לאובייקטים שאליהם מתבצעת הגישה, ואז מנסים שוב להעביר את העבודה.

בעיות בהעברה ב-Klaviyo

ריכזנו כאן כמה בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה ב-Klaviyo.

שגיאה: PERMISSION_DENIED: Permission denied. Your API key may lack required access scopes
פתרון: מוודאים שלמפתח הפרטי של Klaviyo API יש לפחות את רמת הגישה READ ONLY. מידע נוסף זמין במאמר בנושא דרישות מוקדמות ל-Klaviyo.
שגיאה: FAILED_PRECONDITION
פתרון: מנסים שוב להעביר את הנתונים עם טווח תאריכים קצר יותר.
שגיאה: UNKNOWN: An unknown error occurred while processing the request.
פתרון: מוודאים שמפתח ה-API של החשבון תקין, ואז מנסים שוב להפעיל את העברת הנתונים.
שגיאה: INTERNAL: An unknown error occurred while processing the request.
פתרון: מוודאים שמפתח ה-API של החשבון תקף, ואז מנסים שוב להפעיל את העברת הנתונים.

בעיות בהעברה של Microsoft SQL Server

ריכזנו כאן בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה של Microsoft SQL Server.

שגיאה: FAILED PRECONDITION: A TLS/SSL handshake error occurred: unable to find valid certification path to requested target. Please check your TLS/SSL configuration and certificate validity.

פתרון: כדי לוודא שהאישור שלכם תקף, צריך לבצע את השלבים הבאים:

  1. מחליפים את אישור ה-SSL או ה-TLS ב-SQL Server באישור שהונפק על ידי Public Certificate Authority מהימנה. מידע נוסף זמין במאמר בנושא הגדרת TLS.
  2. מוודאים שהאישור החדש כולל את שרשרת האישורים המלאה, כולל כל אישורי הביניים והבסיס.
  3. אחרי שמעדכנים את האישור, מפעילים מחדש את שירות SQL Server כדי להחיל את הגדרות ה-SSL/TLS החדשות.
  4. אחרי שהשרת מופעל מחדש, יוצרים שוב את הגדרת ההעברה כדי לוודא שהאישור המעודכן מהימן ושהלחיצת יד של TLS/SSL הושלמה בהצלחה.
שגיאה: INVALID_ARGUMENT: Catalog 'SCHEMA' does not exist in asset "SCHEMA/TABLE"

פתרון: מוודאים שהקטלוג והטבלה קיימים ב-SQL Server ושאין שגיאות איות. צריך גם לוודא שלמשתמש יש הרשאות גישה מספיקות כדי לעיין בקטלוג ובתוכן שלו או לשלוח אליו שאילתות.

בעיות בהעברה מ-Mailchimp

ריכזנו כאן כמה בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה של Mailchimp.

שגיאה: INVALID_ARGUMENT: Invalid request. Please check the input parameters (Credentials, Table, etc.) and try again.
פתרון: בודקים ששם הנכס שצוין תקין ושאין בו רווחים בתחילת השם או בסופו. כשיוצרים העברה של Mailchimp, מומלץ ללחוץ על עיון כדי לבחור את הנכס מתוך רשימת האובייקטים הזמינים.
שגיאה: PERMISSION_DENIED: Permission denied. Your credentials may lack required access.
פתרון: בודקים שלמשתמש ב-Mailchimp יש את כל ההרשאות הנדרשות. Admin רמת המשתמש ב-Mailchimp היא רמת הגישה המינימלית להעברת כל האובייקטים ב-Mailchimp.
שגיאה: FAILED_PRECONDITION: Operation failed due to precondition violation (ex- Rate limit exceeded, Server Error). Please try again later.
פתרון: צריך להמתין זמן מה לפני שמנסים שוב להעביר את הנתונים. אפשר גם לבדוק את הסטטוס של Mailchimp כדי לראות אם יש הפסקות שירות.
שגיאה: UNKNOWN: An unknown error occurred while processing the request.
פתרון: מוודאים שמפתח ה-API תקין ושלמשתמש יש את כל ההרשאות הנדרשות, ואז מנסים שוב להפעיל את העברת הנתונים.

בעיות בהעברה של MySQL

ריכזנו כאן בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה של MySQL.

שגיאה: PERMISSION_DENIED. Failed to authenticate or permission denied with the provided credentials when starting to transfer asset asset-name.
פתרון: בודקים אם הפרמטרים connector.authentication.username ו-connector.authentication.password שסיפקתם תקינים ופועלים.
שגיאה: NOT_FOUND. Invalid data source configuration provided when starting to transfer asset asset-name: APPLICATION_ERROR;google.cloud.bigquery.federationv1alpha1/ConnectorService.StartQuery;INVALID_ARGUMENT:Exception was thrown by the Connector implementation: Table table-name does not exist in asset asset-name.

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

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

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

אם מציינים שם של טבלה או תצוגה, צריך לוודא שהוא מוגדר כ-object_name; אחרת, הוא יהיה ריק.

שגיאה: SERVICE_UNAVAILABLE. Timed out when starting to transfer asset asset-name. Ensure the datasource is reachable and the datasource configuration (Credentials, Network Attachment etc.) is correct.
שגיאה: DEADLINE_EXCEEDED. Timed out when starting to transfer asset asset-name. Ensure the datasource is reachable and the datasource configuration (Credentials, Network Attachment etc.) is correct.

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

שגיאה: INTERNAL

פתרון: משהו אחר גרם לכך שההעברה נכשלה. כדי לקבל עזרה בפתרון הבעיה הזו, אפשר לפנות ל-Cloud Customer Care.

שגיאה: INVALID_ARGUMENT. Connection to the host and port failed. Please check that the host, port, encryptionMode and network attachment are correct.

פתרון: מוודאים שההגדרות של המארח, היציאה, מצב ההצפנה והרשת מוגדרות בצורה נכונה. מוודאים שיש חיבור לרשת ושאפשר לגשת לשרת מסד הנתונים. אם הערך של EncryptionMode הוא FULL, צריך לוודא שהשרת תומך בפרוטוקולים הנדרשים, שיש לו אישור תקין ושהוא מאפשר חיבורים מאובטחים. אם הערך של EncryptionMode הוא DISABLE, צריך לוודא שהשרת מאפשר חיבורים ללא SSL. בודקים את היומנים של האפליקציה ומסד הנתונים כדי לזהות שגיאות שקשורות לחיבור או ל-SSL/TLS.

שגיאה: Failed to connect to MySQL instance INSTANCE_NAME. : Failed to connect to MySQL instance. Please ensure provided instance details are correct.

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

בעיות בהעברה של Oracle

ריכזנו כאן כמה בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה של Oracle.

שגיאה: PERMISSION_DENIED. ORA-01017: invalid username/password; logon denied
פתרון: צריך לוודא שפרטי הכניסה של Oracle שסופקו תקינים.
שגיאה: PERMISSION_DENIED. ORA-01045: user lacks CREATE SESSION privilege; logon denied
פתרון: מעניקים למשתמש Oracle את הרשאות המערכת CREATE SESSION. מידע נוסף על מתן הרשאות Oracle זמין במאמר GRANT.
שגיאה: SERVICE_UNAVAILABLE. ORA-12541: Cannot connect. No listener at host HOSTNAME port PORT או SERVICE_UNAVAILABLE. Connection failed: IO Error. The Network Adapter could not establish the connection
פתרון: צריך לוודא שפרטי שם המארח והיציאה שצוינו נכונים, ושחיבור הרשת מוגדר בצורה נכונה.
שגיאה: NOT_FOUND. ORA-00942: table or view does not exist

פתרון: צריך לבדוק את כל אחד מהדברים הבאים:

  • האיות של שם הטבלה או התצוגה נכון.
  • שם הטבלה או התצוגה שאליהן מתבצעת ההפניה קיים.
  • המילה הנרדפת מצביעה על טבלה או תצוגה קיימות. אם הטבלה או התצוגה קיימות, צריך לוודא שהמשתמש במסד הנתונים שזקוק לגישה לטבלה קיבל את הרשאות הגישה הנכונות. אם לא, יוצרים את הטבלה.
  • אם אתם מנסים לגשת לטבלה או לתצוגה בסכימה אחרת, ודאו שהסכימה הנכונה מצוינת ושהגישה לאובייקט מוענקת.
שגיאה: NOT_FOUND. Schema schema does not exist.
פתרון: הסכימה שצוינה לא קיימת.
שגיאה: DEADLINE_EXCEEDED
פתרון: ההעברה לא הסתיימה בתוך מגבלת הזמן המקסימלית של שש שעות. כדי לקצר את משך ההרצה של ההעברה, אפשר לפצל העברות גדולות לכמה העברות קטנות יותר.
שגיאה: INTERNAL
פתרון: משהו אחר גרם לכשל בהעברה. כדי לקבל עזרה בפתרון הבעיה הזו, אפשר לפנות ל-Cloud Customer Care.
שגיאה: INVALID_ARGUMENT
פתרון: ערך שסופק בהגדרות ההעברה לא תקין, ולכן ההעברה נכשלת. מידע על ערכי הגדרות העברה תקינים זמין במאמר בנושא הגדרת העברה של Oracle.
שגיאה: SQL Error [1950] [42000]: ORA-01950: no privileges on tablespace 'TablespaceName'
פתרון: מקצים למשתמש את ברירת המחדל של מרחב הטבלאות. מידע נוסף מופיע במאמר הקצאת מרחב טבלאות שמוגדר כברירת מחדל.
שגיאה: 403 PERMISSION_DENIED. Required 'compute.subnetworks.use' permission for project

פתרון: השגיאה הזו יכולה להתרחש אם קובץ הרשת המצורף נמצא בפרויקט אחר מזה שבו נמצאת הגדרת ההעברה. כדי לפתור את הבעיה הזו, צריך להעניק לחשבון השירות (לדוגמה, service-customer_project_number@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) את ההרשאות הבאות בפרויקט שבו נמצאת ההצמדה לרשת:

  • compute.networkAttachments.get
  • compute.networkAttachments.update
  • compute.subnetworks.use
  • compute.regionOperations.get

השגיאה הזו יכולה להתרחש גם אם קובץ הצירוף לרשת מנסה להתחבר לענן וירטואלי פרטי (VPC) שנמצא בפרויקט אחר, כמו VPC משותף. במקרה כזה,צריך לתת לחשבון השירות (לדוגמה, service-customer_project_number@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) את ההרשאה compute.subnetworks.use בפרויקט האירוח של ה-VPC המשותף.

בעיות בהעברה ב-PayPal

ריכזנו כאן כמה בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה בפייפאל.

שגיאה: PERMISSION_DENIED: Authorization failed due to insufficient permissions.
פתרון: מוודאים שללקוח ולסוד הלקוח יש את הרשאות הגישה הנדרשות לאובייקט PayPal שמועבר.
שגיאה: INVALID_ARGUMENT: Table 'OBJECT' does not exist in asset "OBJECT"
פתרון: מוודאים ששם האובייקט תקין.
שגיאה: INVALID_ARGUMENT: The given start date 'DATE' cannot be parsed. Please provide it in 'yyyy-MM-dd' format.
פתרון: מוודאים שתאריך ההתחלה מופיע בתחביר הנכון.
שגיאה: UNAUTHENTICATED: Please provide a valid clientId and client secret.
פתרון: מוודאים שמספר הלקוח והסוד של הלקוח נכונים.
שגיאה: UNKNOWN: An unknown error occurred while processing the request.
פתרון: מוודאים שהמפתח הסודי ומזהה החשבון תקינים ושיש הרשאות נדרשות לאובייקטים שנבחרו, ואז מנסים שוב להפעיל את העברת הנתונים. אם הבעיה נמשכת, פנו ל-Cloud Customer Care.
שגיאה: INTERNAL: An unknown error occurred while processing the request.
פתרון: מוודאים שהמפתח הסודי ומזהה החשבון תקינים ושיש הרשאות נדרשות לאובייקטים שנבחרו, ואז מנסים שוב להפעיל את העברת הנתונים. אם הבעיה נמשכת, פנו ל-Cloud Customer Care.

בעיות בהעברה של PostgreSQL

ריכזנו כאן כמה בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה של PostgreSQL.

שגיאה: PERMISSION_DENIED. Failed to authenticate or permission denied with the provided credentials when starting to transfer asset asset-name.
פתרון: בודקים אם הפרמטרים connector.authentication.username ו-connector.authentication.password שסיפקתם תקינים ופועלים.
שגיאה: NOT_FOUND. Invalid data source configuration provided when starting to transfer asset asset-name: APPLICATION_ERROR;google.cloud.bigquery.federationv1alpha1/ConnectorService.StartQuery;INVALID_ARGUMENT:Exception was thrown by the Connector implementation: Table table-name does not exist in asset asset-name.

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

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

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

אם מציינים שם של טבלה או תצוגה, צריך לוודא שהוא מוגדר כ-object_name; אחרת, הוא יהיה ריק.

שגיאה: SERVICE_UNAVAILABLE. Timed out when starting to transfer asset asset-name. Ensure the datasource is reachable and the datasource configuration (Credentials, Network Attachment etc.) is correct.
שגיאה: DEADLINE_EXCEEDED. Timed out when starting to transfer asset asset-name. Ensure the datasource is reachable and the datasource configuration (Credentials, Network Attachment etc.) is correct.

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

שגיאה: INTERNAL

פתרון: משהו אחר גרם לכך שההעברה נכשלה. כדי לקבל עזרה בפתרון הבעיה הזו, אפשר לפנות ל-Cloud Customer Care.

שגיאה: INVALID_ARGUMENT. Connection to the host and port failed. Please check that the host, port, encryptionMode and network attachment are correct.

פתרון: מוודאים שההגדרות של המארח, היציאה, מצב ההצפנה והרשת מוגדרות בצורה נכונה. מוודאים שיש חיבור לרשת ושאפשר לגשת לשרת מסד הנתונים. אם הערך של EncryptionMode הוא FULL, צריך לוודא שהשרת תומך בפרוטוקולים הנדרשים, שיש לו אישור תקין ושהוא מאפשר חיבורים מאובטחים. אם הערך של EncryptionMode הוא DISABLE, צריך לוודא שהשרת מאפשר חיבורים ללא SSL. בודקים את היומנים של האפליקציה ומסד הנתונים כדי לזהות שגיאות שקשורות לחיבור או ל-SSL/TLS.

שגיאה: INVALID_ARGUMENT: For Asset "postgres"."auth"."sessions", row count exceeds the max supported unIndexed read size of 2000000 records.

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

בעיות בהעברה של Salesforce

אלה שגיאות נפוצות שנתקלים בהן כשיוצרים העברה של Salesforce.

שגיאה: Permission Denied: invalid_client. invalid client credentials
פתרון: מוודאים שהערך של ClientSecret שסופק תקין.
שגיאה: Permission Denied: invalid_client. client identifier invalid
פתרון: מוודאים שמזהה הלקוח שצוין תקין.
שגיאה: Permission Denied: Error encountered while establishing connection
פתרון: צריך לבדוק אם השם של MyDomain ב-Salesforce שצוין נכון.
שגיאה: NOT_FOUND. asset type asset_name is not supported. If you are attempting to use a custom object, be sure to append the "__c" after the entity name. Please reference your WSDL or use the describe call for the appropriate names.
פתרון: פועלים לפי ההנחיות שמופיעות בקוד השגיאה ומוודאים ששם הנכס שצוין נכון.
שגיאה: SERVICE_UNAVAILABLE
פתרון: השירות לא יכול לטפל בבקשה באופן זמני. צריך להמתין כמה דקות ולנסות שוב לבצע את הפעולה.
שגיאה: DEADLINE_EXCEEDED
פתרון: ההעברה לא הסתיימה בתוך מגבלת הזמן המקסימלית של שש שעות. כדי לצמצם את משך ההרצה של ההעברה, אפשר לפצל העברות גדולות לכמה העברות קטנות יותר.
שגיאה: Failed to create recordReader to read partition : Batch failed. BatchId='batch_id', Reason='FeatureNotEnabled : Binary field not supported'
פתרון: המחבר לא תומך במבני נתונים של sObject שמכילים שדות בינאריים. מסירים מעבודות ההעברה מבני נתונים של sObject שמכילים שדות בינאריים. מידע נוסף זמין במאמר Error 'Batch failed: FeatureNotEnabled: Binary field not supported' when you export related object (שגיאה 'העברת הנתונים נכשלה: התכונה לא הופעלה: שדה בינארי לא נתמך' כשמייצאים אובייקט קשור) במסמכי התיעוד של Salesforce.
שגיאה: RESOURCE_EXHAUSTED: PrepareQuery failed : ExceededQuota : ApiBatchItems Limit exceeded
פתרון: השגיאה הזו מופיעה כשחורגים מהמגבלה היומית של ApiBatchItems API להפעלת משימות. ל-Salesforce יש מגבלת API יומית שמתאפסת כל 24 שעות. כדי לפתור את השגיאה הזו, מומלץ לפצל את ההרצות של ההעברה ולתזמן אותן כך שהן לא יחרגו מהמגבלה היומית של ה-API של אצווה. אפשר גם לפנות לתמיכה של Salesforce כדי להגדיל את המגבלה היומית.
שגיאה: Permission Denied: invalid_grant. no client credentials user enabled
פתרון: מוודאים שבשדה Run as בקטע Client Credentials Flow של אפליקציית Salesforce Connected מופיע שם המשתמש הנכון. מידע נוסף זמין במאמר בנושא יצירת אפליקציה מקושרת ב-Salesforce.
שגיאה: FAILED_PRECONDITION: BatchId='batch-id', Reason='InvalidBatch : Failed to process query: OPERATION_TOO_LARGE: exceeded 100000 distinct ids'
פתרון: מוודאים שבפרופיל של המשתמש לא מוגדרות מגבלות על שאילתות חילוץ של אובייקט sObject. אם הבעיה נמשכת, צריך להשתמש בפרטי הכניסה של משתמש Salesforce עם הרשאות אדמין מערכת כדי להשלים את החילוץ.
שגיאה: FAILED_PRECONDITION: Batch failed. BatchId='batch-id', Reason='InvalidBatch : Failed to process query: TXN_SECURITY_NO_ACCESS: The operation you requested isn't allowed due to a security policy in your organization. Contact your administrator for more information about security policies.
פתרון: מוודאים שפרופיל המשתמש או קבוצת ההרשאות שלו כוללים את ההרשאות הנדרשות ברמת האובייקט והשדה עבור אובייקט ה-sObject שחולץ. צריך לפנות לאדמין כדי לעדכן את ההרשאות האלה או להקצות תפקיד עם הגישה הנדרשת.
שגיאה: FAILED_PRECONDITION: Cannot establish connection to Salesforce to describe SObject: 'SObject_Name' due to error: TotalRequests Limit exceeded., Cause:null Retry after some time post quota reset.
פתרון: השגיאה הזו יכולה להתרחש אם חרגתם מהמגבלה של משימות טעינה. צריך להמתין עד לאיפוס המכסה ואז לנסות שוב.
שגיאה: FAILED_PRECONDITION: There was an issue connecting to Salesforce Bulk API.
פתרון: השגיאה הזו יכולה להתרחש כשכוללים העברה של קובץ מצורף לרשת, אבל לא מגדירים את ה-NAT הציבורי ולא יוצרים רשימת היתרים של כתובות IP. כדי לפתור את השגיאה, צריך לבצע את כל השלבים במאמר הגדרת רשימת היתרים של כתובות IP להעברות ב-Salesforce.
שגיאה: SYSTEM ERROR when starting to transfer asset asset_name, try again later.
פתרון: השגיאה הזו יכולה להתרחש אם ה-Bulk API לא מופעל בארגון Salesforce שלכם. כדי לפתור את השגיאה הזו, צריך לעדכן את רישיון Salesforce כך שיכלול תמיכה ב-Bulk API. מידע נוסף מופיע במאמר הפעלת API אסינכרוני.

בעיות בהעברה ב-Shopify

שגיאה: [NOT_FOUND] Your app doesn't have a publication for this shop.

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

  1. להסיר את אפליקציית Shopify.
  2. יוצרים אפליקציה בהתאמה אישית עם ההגדרות הבאות.
    1. במהלך יצירת האפליקציה, בוחרים באפשרות הפצה בהתאמה אישית. תצטרכו לספק את הדומיין של החנות או את כתובת ה-URL של האדמין. אחרי ההגדרה, Shopify יוצר קישור להשלמת ההתקנה של האפליקציה. מידע נוסף זמין במאמר בנושא בחירת שיטת הפצה.
    2. במהלך יצירת האפליקציה, לוחצים על בקשת גישה ל-API, בוחרים באפשרות הפעלת חנות ומפעילים את היקף read_all_orders.
    3. מתקינים את האפליקציה בהתאמה אישית.
  3. אחרי שמתקינים מחדש את האפליקציה המותאמת אישית, מריצים מחדש את העברת הנתונים.
שגיאה: PERMISSION_DENIED: Permission denied. Your API key may lack required access to the provided account. Please also check for typos like whitespace or if the provided accountId even exists

פתרון: מוודאים שטוקן הגישה ל-Shopify Admin API נכון, ומוודאים שלאפליקציית Shopify יש את כל תפקידי הגישה הנדרשים.

שגיאה: INVALID_ARGUMENT: Table 'NAME' does not exist in asset "ASSET"

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

שגיאה: UNAUTHENTICATED: Authentication failed. Please verify your Shopify access token.

פתרון: צריך לוודא שטוקן הגישה ל-Shopify Admin API נכון. מידע נוסף זמין במאמר בנושא דרישות מוקדמות ל-Shopify.

שגיאה: UNKNOWN: An unknown error occurred while processing the request.

פתרון: מוודאים שטוקן הגישה ל-Shopify Admin API ושם החנות נכונים, ואז מנסים שוב להפעיל את העברת הנתונים. אם הבעיה נמשכת, פנו ל-Cloud Customer Care.

בעיות בהעברה ב-Stripe

אלה שגיאות נפוצות שמתרחשות כשיוצרים העברה ב-Stripe.

שגיאה: PERMISSION_DENIED: Permission denied. Your API key may lack required access to the provided account. Please also check for typos like whitespace or if the provided accountId even exists
פתרון: אם אתם משתמשים במפתח API מוגבל, ודאו שיש למפתח הרשאה לגשת לאובייקט Stripe שמועבר. אחרי שמעדכנים את ההרשאות במפתח המוגבל, מנסים להפעיל שוב את העברת הנתונים. מידע על ניהול מפתחות סודיים זמין במאמר מפתחות סודיים ומפתחות מוגבלים.
שגיאה: INVALID_ARGUMENT: Table 'NAME' does not exist in asset "ASSET"
פתרון: בודקים ששם הנכס שצוין תקין ולא מכיל רווחים בהתחלה או בסוף. כשיוצרים העברה ב-Stripe, מומלץ ללחוץ על עיון כדי לבחור את הנכס מתוך רשימת האובייקטים הזמינים.
שגיאה: UNAUTHENTICATED: Authentication failed. Please verify your Stripe API key.
פתרון: בודקים שמפתח הגישה ומספר החשבון נכונים. במאמר דרישות מוקדמות ל-Stripe מוסבר איך לאחזר את המידע הזה.
שגיאה: RESOURCE_EXHAUSTED: Rate limit exceeded.
פתרון: חרגתם ממגבלת הקצב של Stripe API. צריך להמתין זמן מה לפני שמנסים שוב לשלוח את בקשת העברת הנתונים. כדי למנוע את הבעיה הזו, כדאי להפחית את התדירות של העברות הנתונים ולהגביל את מספר ההעברות שמתבצעות בו-זמנית מאותו חשבון.
שגיאה: UNAVAILABLE: Stripe service is temporarily unavailable. Please try again shortly.
פתרון: צריך להמתין זמן מה לפני שמנסים שוב להעביר את הנתונים. אפשר לבדוק את הסטטוס של Stripe כדי לראות אם יש הפסקות זמניות בשירות.
שגיאה: UNKNOWN: An unknown error occurred while processing the request.
פתרון: מוודאים שהמפתח הסודי ומזהה החשבון תקינים, ושיש את ההרשאות הנדרשות לאובייקטים שנבחרו, ואז מנסים שוב להפעיל את העברת הנתונים. אם הבעיה נמשכת, אפשר לפנות ל-Cloud Customer Care.
שגיאה: INTERNAL: An unknown error occurred while processing the request.
פתרון: מוודאים שהמפתח הסודי ומזהה החשבון תקינים, ושיש את ההרשאות הנדרשות לאובייקטים שנבחרו, ואז מנסים שוב להפעיל את העברת הנתונים. אם הבעיה נמשכת, אפשר לפנות ל-Cloud Customer Care.

בעיות בהעברה ב-ServiceNow

ריכזנו כאן בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה ב-ServiceNow.

שגיאה: UNAUTHENTICATED. Required authentication credentials were not provided when starting to transfer asset asset-name.
‫
פתרון: מוודאים שפרטי הכניסה שסופקו (username,‏ password,‏ ClientID ו-Client Secret) תקפים, שהם הוגדרו בצורה נכונה ושלא פג תוקפם.
שגיאה: INVALID_ARGUMENT. Invalid datasource configuration provided when starting to transfer asset
שגיאה: INVALID_ARGUMENT: Http call to ServiceNow instance returned status code 400.. Please make sure the instance/endpoint provided exists/is correct.
פתרון: צריך לוודא שכתובת ה-URL של מופע ServiceNow ונקודת קצה ל-API נכונות, ושהטבלה שאליה מתייחסים קיימת ונגישה באמצעות פרטי הכניסה שסופקו.
שגיאה: PERMISSION_DENIED. User credentials don't have permission or are invalid for accessing the ServiceNow asset or API.
פתרון: מוודאים שפרטי הכניסה שסופקו נכונים, ושבחשבון ServiceNow יש הרשאות מספיקות לגישה לנכסים או לטבלאות שצוינו.
שגיאה: UNAVAILABLE. ServiceNow instance is temporarily unreachable or experiencing downtime.
פתרון: מוודאים שהחיבור לרשת יציב ומנסים שוב אחרי זמן מה. השגיאה הזו כנראה נובעת מהפסקה זמנית בשירות של ServiceNow או מבעיה זמנית בקישוריות.
שגיאה: RESOURCE EXHAUSTED. ServiceNow API rate limit or quota has been exceeded, or operations are too large.
פתרון: חרגתם מהמכסה או מההגבלה על קצב שליחת הבקשות ב-ServiceNow API. כדאי לצמצם את נפח הבקשות או את התדירות שלהן ולנסות שוב.
שגיאה: FAILED_PRECONDITION: There was an issue connecting to API.
פתרון: השגיאה הזו יכולה להתרחש כשכוללים העברה של קובץ מצורף לרשת, אבל לא מגדירים את ה-NAT הציבורי ולא יוצרים רשימת היתרים של כתובות IP. כדי לפתור את השגיאה הזו, צריך ליצור קובץ מצורף לרשת על ידי הגדרת כתובת IP סטטית.

בעיות בהעברה של Teradata

ריכזנו כאן כמה בעיות נפוצות שאפשר להיתקל בהן כשיוצרים העברה של Teradata.

שגיאה: Skipping extraction since table does not have change tracking column.

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

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

בעיה: העברה של CHAR(N) סוגי נתונים מוסיפה רווחים עד N תווים למחרוזות קצרות יותר.

פתרון: ממירים את נתוני CHAR ל-VARCHAR ומסירים את הרווחים המיותרים במקור. הבעיה הזו מתרחשת כי CHAR היא מחרוזת באורך קבוע, ואילו VARCHAR צריכה לשמש למחרוזות באורך משתנה. אפשר גם להסיר את הרווחים ב-BigQuery אחרי ההעברה באמצעות הפונקציה RTRIM. השאילתה לשימוש בפונקציה RTRIM דומה לדוגמה הבאה:

UPDATE migrated_table
SET migrated_char_column = RTRIM(migrated_char_column)
WHERE true;

בעיות בהעברה אל YouTube

ריכזנו כאן שגיאות נפוצות שנתקלים בהן כשיוצרים העברה של YouTube.

שגיאה: Import failed - no data was available for import. Please verify that data existence was expected.
שגיאה: No data available for requested date. Please try an earlier run date or verify that data existence was expected.

פתרון: אם לא יצרתם בעבר משימות דיווח ב-YouTube, צריך לתת לשירות העברת הנתונים ל-BigQuery לפחות יומיים כדי ליצור את הדוחות בשמכם. אין צורך לבצע פעולה נוספת. ההעברות ייכשלו במשך יומיים, ויצליחו ביום השלישי. אם יצרתם בעבר משימות דיווח ב-YouTube, ודאו שלמשתמש שיוצר את ההעברות יש גישת קריאה לדוחות.

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

שגיאה: No reports for reporting job with name name.

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

בעיה: הטבלאות שנוצרו כתוצאה מההעברה לא מלאות, או שהתוצאות לא צפויות.
פתרון: אם יש לכם כמה חשבונות, אתם צריכים לבחור את החשבון הנכון כשמופיע תיבת הדו-שיח של הרשאות YouTube.
בעיה: הנתונים ב-YouTube Analytics לא זהים לנתונים בהעברות של YouTube ב-BigQuery.

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

פתרון: אם המספרים שדווחו אכן שגויים, המערכת של YouTube ושירות העברת הנתונים ל-BigQuery של YouTube מוגדרים למילוי חוסרים במספרים ולהצגתם בדוחות חדשים שנוצרו עבור הימים שבהם בוצע מילוי החוסרים. ההגדרה של שירות העברת הנתונים ל-BigQuery ב-YouTube טוענת את כל הדוחות שנוצרו על ידי YouTube Reporting API. לכן, כששירות העברת הנתונים ל-BigQuery מייבא אוטומטית דוחות עתידיים של YouTube, הוא יביא בחשבון גם את הנתונים החדשים והמעודכנים, ויטען אותם לטבלת המחיצות הנכונה לפי תאריך.

בעיות בהרשאות ב-YouTube

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

בעיות שקשורות למכסות

שגיאה: Quota exceeded: Your project exceeded quota for imports per project.
פתרון: מוודאים שלא תזמנתם יותר מדי העברות בפרויקט. מידע על חישוב מספר העבודות של טעינת נתונים שהופעלו על ידי העברה זמין במאמר מכסות ומגבלות.