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

המסמך הזה נועד לעזור לכם לפתור את הבעיות הנפוצות ביותר שנתקלים בהן כשמגדירים העברה באמצעות שירות העברת הנתונים ל-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 של המקור.

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

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

שגיאה: 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 ...

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

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

כניסה לדף IAM & Admin
מסמנים את תיבת הסימון Include Google-provided role grants.
מוודאים שחשבון השירות עם השם 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.

פתרון:

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

כניסה ל-BigQuery
לוחצים על מערך הנתונים של היעד שבו נעשה שימוש בהעברה.
לוחצים על התפריט שיתוף ואז על הרשאות.
מרחיבים את התפקיד BigQuery Data Editor.
מוודאים שסוכן השירות של שירות העברת נתונים ל-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

פתרון:

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

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

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

שגיאה: 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 ומחפשים את המדיניות.

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

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

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

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:

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

מעבר אל Pub/Sub
בוחרים את מינוי Pub/Sub שבו השתמשתם בהעברה מבוססת-אירועים.
אם חלונית המידע מוסתרת, לוחצים על Show info panel בפינה השמאלית העליונה.
בכרטיסייה הרשאות, מוודאים שלסוכן השירות של שירות העברת הנתונים ל-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 מופעל בפרויקט:

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

כניסה אל APIs & Services
לוחצים על Enable APIs and services.
מחפשים את 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:

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

כניסה לדף IAM & Admin
מסמנים את תיבת הסימון Include Google-provided role grants.
מוודאים שחשבון השירות עם השם service-<project_number>@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com מוצג ושהוקצה לו התפקיד Service Usage Consumer.

בעיה: כשמשתמשים בהעברה מבוססת-אירוע ב-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:

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

מעבר אל Pub/Sub
בוחרים את מינוי Pub/Sub שבו השתמשתם בהעברה מבוססת-אירועים.
בכרטיסייה מדדים, בודקים את התרשים 'הגיל של ההודעה הישנה ביותר שלא אושרה' ורואים אם יש הודעות.

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

אם לא מתפרסמות הודעות, צריך לבדוק אם התראות 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

בהמשך מפורטות שגיאות נפוצות שנתקלים בהן כשיוצרים העברה ב-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 Manager לא תומך בהעברת נתונים למערך נתונים עם אשכולות. במקום זאת, אפשר להשתמש במערך נתונים בלי אשכולות.

בעיות בהעברה של חשבון 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.

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

מחליפים את אישור ה-SSL או ה-TLS ב-SQL Server באישור שהונפק על ידי Public Certificate Authority מהימנה. מידע נוסף זמין במאמר בנושא הגדרת TLS.
מוודאים שהאישור החדש כולל את שרשרת האישורים המלאה, כולל כל אישורי הביניים והבסיס.
אחרי שמעדכנים את האישור, מפעילים מחדש את שירות SQL Server כדי להחיל את הגדרת ה-SSL/TLS החדשה.
אחרי שהשרת מופעל מחדש, יוצרים שוב את הגדרת ההעברה כדי לוודא שהאישור המעודכן מהימן ושהלחיצת יד של 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.

בעיות בהעברה של 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 שסיפקתם תקינים ופועלים.

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

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

שגיאה: 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.

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

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

שגיאה: Permission Denied: invalid_client. invalid client credentials: פתרון: מוודאים שהערך של ClientSecret שצוין תקין.
שגיאה: Permission Denied: invalid_client. client identifier invalid: פתרון: מוודאים שמזהה הלקוח שצוין תקין.
שגיאה: Permission Denied: Error encountered while establishing connection: פתרון: צריך לבדוק אם השם של Salesforce MyDomain שצוין נכון.
שגיאה: 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 (שגיאה 'הפעולה נכשלה: FeatureNotEnabled: Binary field לא נתמך' כשמייצאים אובייקט קשור) במסמכי התיעוד של 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

שגיאה: 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.

בעיות בהעברה ב-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 Analytics תוך 24 עד 48 שעות אחרי סוף היום הזה (לפעמים יותר). לכן, גם דוחות YouTube והעברות ל-BigQuery שנוצרים בהמשך מושפעים מהעיכוב הזה.

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

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

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

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

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

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

בעיות כלליות

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

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

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

שגיאות ב-Amazon S3 PERMISSION_DENIED

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

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

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

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

בעיות בהעברה של Google Ads

בעיות בהעברה של Google Ad Manager

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שגיאות ב-Amazon S3 `PERMISSION_DENIED`