פתרון בעיות בניהול עומסי עבודה ב-BigQuery

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

כדי לראות ולנהל את ההזמנות, ההתחייבויות והתרשימים של המשאבים האדמיניסטרטיביים, ודאו שיש לכם את התפקידים הנדרשים בניהול זהויות והרשאות גישה (IAM), כמו התפקיד "צפייה במשאבים ב-BigQuery" (roles/bigquery.resourceViewer) או "ניהול משאבים ב-BigQuery" (roles/bigquery.resourceAdmin) בפרויקט האדמיניסטרטיבי. למידע נוסף כדאי לקרוא את המאמר בקרת גישה באמצעות IAM.

פתרון בעיות בהזמנות

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

אי אפשר להוסיף עוד משבצות לגודל ההזמנה

אם מופיעות שגיאות כמו Failed to allocate slots for reservation in the current system state או Failed to update reservation: Failed to allocate slots for reservation כשמנסים להוסיף עוד משבצות ל-reservation, בדרך כלל מדובר בבעיה זמנית. כדי לפתור את הבעיה:

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

אם ניסיתם כמה פעמים וחיכיתם 30 דקות ועדיין מופיעה אותה הודעת שגיאה, פנו ל-Cloud Customer Care.

אין מספיק מכסה כדי להשלים את הבקשה הזו

אם הודעת השגיאה היא There is insufficient quota to complete this request, הבקשה חורגת ממגבלת המכסה שהוגדרה לפרויקט.

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

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

הזמנה שלא משמשת את BigQuery להרצת משימה

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

השאילתה וההזמנה נמצאות באזורים שונים

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

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

שליחת שאילתות לטבלאות ב-BigQuery Omni

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

ההזמנה נוצרה, אבל הפרויקט לא הוקצה לה

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

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

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

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

שאילתות עם כמה הצהרות

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

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

אחזור תוצאות שנשמרו במטמון

כשמשימת שאילתה מאחזרת תוצאות שנשמרו במטמון, השדה reservation ריק כי BigQuery לא מבצע חישוב, אלא מאחזר את התוצאות ישירות מהטבלה הזמנית.

פעולות לשינוי שורות של סימון נתונים שהשתנו (CDC)

אם יש לכם טבלאות של סימון נתונים שהשתנו (CDC), המערכת של BigQuery מבצעת שינויים בשורות בהמתנה במרווח הזמן של max_staleness כמשימות ברקע שמשתמשות בסוג ההקצאה BACKGROUND. אם אין הקצאות של BACKGROUND, המשימות האלה מתומחרות לפי דרישה. כדי להימנע מעלויות בלתי צפויות על פי דרישה, כדאי ליצור הקצאה של BACKGROUND לפרויקט. אפשר לזהות את המשימות האלה לפי מחרוזת המשנה queueworker_cdc_background_merge_coalesce במזהה המשימה.

סוגי מודלים של BigQuery ML שמשתמשים בשירותים חיצוניים

אם בפרויקט לא נמצאת הקצאת הזמנה עם סוג משימה ML_EXTERNAL, משימות ליצירת מודלים חיצוניים פועלות באמצעות תמחור על פי דרישה. הקצאת סוג העבודה QUERY חלה על מודלים סטנדרטיים של BigQuery ML ועל מודלים של פירוק לגורמים של מטריצות (שמחייבים הזמנה של מהדורת Enterprise או Enterprise Plus), ואילו מודלים חיצוניים מחייבים הקצאה של ML_EXTERNAL. מידע נוסף זמין במאמר הקצאת חריצים לעומסי עבודה ב-BigQuery.

זוהו בפרויקט הזמנות לא מזוהות

ל-BigQuery יש מקומות שמורים שמייצגים מאגר משותף של יחידות קיבולת (slots) בחינם לפעולות מסוימות ב-BigQuery.

default-pipeline

כברירת מחדל, טעינה או ייצוא של נתונים באצוות ב-BigQuery מתבצעים באמצעות מאגר משותף של משבצות ללא תשלום. כשבודקים את משימות הטעינה או החילוץ האלה, בשדה reservation מופיע הערך default-pipeline.

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

פתרון בעיות במשימות של ניהול הזמנות

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

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

הודעת שגיאה

  • Max reservation size can only be configured in multiples of 50, except when covered by excess commitments.
  • Baseline slots can only be configured in multiples of 50, except when covered by excess commitments.

הסיבה

ה-slots תמיד מותאמים אוטומטית לכפולות של 50. ‫BigQuery מגדיל את מספר ה-slots בהתאם לשימוש בפועל, ומעגל כלפי מעלה למספר הקרוב ביותר שמתחלק ב-50. אם אין התחייבות לשימוש או אם ההתחייבות לשימוש לא יכולה לכסות את העליות, אפשר להגדיל את יחידות הקיבולת הבסיסיות ואת יחידות הקיבולת להתאמה אוטומטית לעומס רק בכפולות של 50.

אם הערך של baseline slots או של max reservation size - baseline slots הוא לא כפולה של 50 (ולא נכלל בהתחייבויות לקיבולת עודפת), אי אפשר להגדיל את ההזמנה לגודל המקסימלי, ומופיעה השגיאה הזו.

פתרון

מבצעים אחת מהפעולות הבאות:

  • רוכשים עוד התחייבויות לקיבולת כדי לכסות את הגידול במספר ה-slots.
  • בוחרים את מספר המשבצות הבסיסי והמקסימלי בכפולות של 50.

אי אפשר להשתמש במספר המקסימלי של משבצות בלי להפעיל הוגנות מבוססת-הזמנה

הודעת שגיאה

  • Cannot use max slots without enabling reservation-based fairness.

הסיבה

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

פתרון

צריך להפעיל הוגנות מבוססת-הזמנה בפרויקט.

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

בקטע הזה מתוארים שלבים לפתרון בעיות שעשויות לצוץ כשמשתמשים בהתחייבויות לקיבולת ב-BigQuery.

המשבצות שרכשתם בהמתנה

יחידות הקיבולת (Slots) כפופות לכמות הקיבולת הזמינה. אחרי שרוכשים התחייבויות ל-slots, המערכת של BigQuery מקצה אותן ובעמודה Status מוצג סימן וי. אם המערכת של BigQuery לא מצליחה להקצות את יחידות ה-slot המבוקשות באופן מיידי, בעמודה Status יישאר הסטטוס Pending. יכול להיות שיהיה צורך להמתין כמה שעות עד שיחידות הקיבולת יהיו זמינות. אם אתם צריכים גישה למשבצות מוקדם יותר, נסו את הפעולות הבאות:

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

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

פתרון בעיות שקשורות למחסור ביחידות קיבולת (slots)

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

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

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

עלייה חדה במספר המשימות שפועלות בו-זמנית

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

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

שימוש גבוה במשבצות (slots)

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

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

משימות שנמשכות זמן רב

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

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

הודעות על מחסור ביחידות קיבולת (slots)

בטבלת התובנות יכולות להופיע הודעות כמו There were NUMBER jobs detected with slot_contention in the reservation., שמצביעות על בעיות של תחרות על משבצות. כדי לבדוק את הפרטים של המשימות הספציפיות שסומנו בהודעות האלה, אפשר להשתמש בסייר המשימות.

שיטה מומלצת: בצעו אופטימיזציה של השאילתות שזוהו או התאימו את הקצאת ה-slots של ההזמנה.

פתרון בעיות במעקב אחרי הזמנות

בקטעים הבאים מוסבר איך לפתור בעיות נפוצות שקשורות למעקב אחרי ההזמנות והשימוש ב-slots ב-BigQuery.

מדדי השימוש ביחידות ה-Slot לא תואמים ל-INFORMATION_SCHEMA

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

  • להפחית את רמת הפירוט. משנים את רמת הפירוט של התרשים למרווחים של שנייה אחת במקום מרווחים של שעה.
  • יישור צבירת הנתונים. חשוב לוודא שאתם משתמשים בשיטות צבירה שתואמות בין תרשימי המשאבים לבין נתוני INFORMATION_SCHEMA. לדוגמה, כדי לשקף טוב יותר את שיא השימוש בתרשימי המשאבים, צריך לשנות את צבירת המדדים ל-p99 או ל-p90 באופן עקבי.

משבצות מושאלות מופיעות כשמשבצות לא פעילות מושבתות

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

המשבצות המושאלות האלה מופיעות במקרים הבאים:

  • השאלה להזמנות אחרות. בהזמנה עם ignore_idle_slots=true, אפשר להשאיל את יחידות ה-Baseline שלא בשימוש להזמנות אחרות באותו פרויקט אדמין, באותו אזור ובאותה מהדורה שכן מאפשרות השאלה של יחידות קיבולת לא פעילות (ignore_idle_slots=false). אם כל ההזמנות בפרויקט אדמין, באזור ובמהדורה מסוימים מוגדרות עם ignore_idle_slots=true, יחידות הקיבולת הלא פעילות לא משותפות ביניהן.

    לדוגמה, נניח שב-Reservation A יש 100 משבצות, 0 שימוש, והיא מוגדרת עם ignore_idle_slots=true. הזמנה ב' נמצאת באותו פרויקט אדמין, באותו אזור ובאותה מהדורה, יש לה 100 חריצים, היא צריכה 150 חריצים לעומס העבודה שלה ומוגדרת עם ignore_idle_slots=false. הזמנה ב' יכולה לשאול 50 יחידות קיבולת לא פעילות מהזמנה א' כדי לענות על הצרכים שלה. במקרה כזה, בתרשימי המעקב ידווחו 50 lent_slots עבור Reservation A ו-50 borrowed_slots עבור Reservation B.

  • השימוש חורג מהקיבולת. אם השימוש במשבצות של הזמנה חורג באופן זמני מהקיבולת שלה (משבצות בסיסיות + משבצות בהתאמה אוטומטית לעומס), ההפרש הזה מוצג בתרשימי המעקב בתור borrowed_slots. זה יכול לקרות גם בהזמנות עם ignore_idle_slots=true.

השימוש ב-slots יכול לפעמים לחרוג מסכום ה-slots הבסיסיים וה-slots המותאמים. לא תחויבו על שימוש ב-slots מעבר למספר ה-slots הבסיסי בתוספת ה-slots שהוגדלו.

משבצות מושאלות מופיעות לפני שכל המשבצות שהוזמנו מנוצלות

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

כדי לנתח בצורה מדויקת יותר את השימוש ב-slots, אפשר לשלוח שאילתה לעמודות שקשורות ל-slots לא פעילים, כמו העמודות borrowed_slots ו-lent_slots בתצוגה INFORMATION_SCHEMA.RESERVATIONS_TIMELINE.

פתרון בעיות ברישום ביומן של השיחות

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

טבלת היומן חסרה או ריקה

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

  • השיחות לא נשמרות או מתפרסמות. ב-BigQuery Studio, מרעננים את הדף, פותחים מחדש את הגדרות הנציג ומוודאים שהאפשרות Enable conversation logging מופעלת, שקבוצת הנתונים והטבלה של היעד מוגדרות ושהשינויים פורסמו.

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

  • מערך הנתונים של היעד הוא מערך נתונים לקריאה בלבד, כמו מערך נתונים מקושר. מערך נתונים מקושר ששותף ב-BigQuery או מערך נתונים חיצוני (לדוגמה, מערך נתונים מאוחד של AWS Glue) הם לקריאה בלבד, ואי אפשר לאחסן בהם יומני שיחות. כדי לבדוק את סוג מערך הנתונים, מריצים את הפקודה bq show --format=prettyjson PROJECT_ID:LOG_DATASET ובודקים את השדה "type" ("LINKED" או "EXTERNAL"). בוחרים מערך נתונים רגיל שניתן לכתיבה באותו פרויקט שבו נמצא הסוכן לאינטראקציה עם נתונים.

  • חסר סוכן שירות או חסרות הרשאות CMEK. מוודאים שלסוכן השירות של Conversational Analytics API (service-PROJECT_NUMBER@gcp-sa-geminidataanalytics.iam.gserviceaccount.com, באמצעות מספר הפרויקט של הסוכן במקום מזהה הפרויקט) יש את התפקיד "עריכת נתונים ב-BigQuery" (roles/bigquery.dataEditor) במערך הנתונים של היומן. אם מערך הנתונים משתמש במפתחות Cloud KMS בניהול הלקוח (CMEK), ודאו שלחשבון השירות של הצפנת BigQuery‏ (bq-PROJECT_NUMBER@bigquery-encryption.iam.gserviceaccount.com) יש את התפקיד roles/cloudkms.cryptoKeyEncrypterDecrypter במפתח.

  • היקף ההרשאות של VPC Service Controls חוסם כתיבה. סוכן השירות של Conversational Analytics API כותב לטבלת היומן מתשתית שמנוהלת על ידי Google, ולכן הקצאת roles/bigquery.dataEditor בלבד לא מספיקה כשגבולות הגזרה לשירות מגבילים את bigquery.googleapis.com. בניגוד לסיבות אחרות ברשימה הזו, חסימה של היקף מתעדת יומני ביקורת של Policy Denied ב-Cloud Logging בפרויקט של הנציג. כדי לאשר את החסימה, מסננים לפי log_id("cloudaudit.googleapis.com/policy") בקטע bigquery.googleapis.com (לחיפוש או ליצירה של טבלה) ולפי bigquerystorage.googleapis.com (להוספת שורות). מוודאים שגם geminidataanalytics.googleapis.com וגם bigquery.googleapis.com נמצאים בגבולות הגזרה, ומוסיפים כלל לתעבורת נתונים נכנסת לסוכן השירות ב-bigquery.googleapis.com. במאמר בקרת גישה, הצפנה ואבטחת רשת מופיעה דוגמה לכלל תעבורת נתונים נכנסת. הנחיות כלליות להגדרת היקף אבטחה מופיעות במאמר הגדרת היקף אבטחה באמצעות VPC Service Controls.

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

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

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

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

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

הסיבה

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

פתרון

מקצים לכל המשתמשים בצ'אט את התפקיד BigQuery Data Viewer (roles/bigquery.dataViewer) בטבלאות של מקורות הידע, ואת התפקיד BigQuery Job User (roles/bigquery.jobUser) בפרויקט שבו מריצים את השאילתות שלהם. לחלופין, מקצים תפקיד בהתאמה אישית עם ההרשאות bigquery.tables.get ו-bigquery.rowAccessPolicies.list בטבלאות של מקורות הידע.

שמירת הסוכן נכשלת עם השגיאה INVALID_ARGUMENT

הודעת שגיאה

  • The BigQuery Agent Analytics table must be in the same project as the agent (agent project: ..., table project: ...).

  • BigQuery Agent Analytics can only be enabled on agents whose datasource is BigQuery. Remove bigquery_agent_analytics_enabled and bigquery_agent_analytics_table, or point the agent at a BigQuery datasource.

הסיבה

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

פתרון

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

הענקת הגישה למערך הנתונים נכשלה כי סוכן השירות לא קיים

הודעת שגיאה

  • Service account service-PROJECT_NUMBER@gcp-sa-geminidataanalytics... does not exist

הסיבה

סוכן השירות של Conversational Analytics API עדיין לא הוקצה בפרויקט.

פתרון

מבצעים אחת מהפעולות הבאות:

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

  • מריצים את הפקודה הבאה כדי להקצות את זהות השירות:

    gcloud beta services identity create \
        --service=geminidataanalytics.googleapis.com \
        --project=PROJECT_ID

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

הגדרות תיעוד השיחות לא זמינות ב-BigQuery Studio

הסיבה

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

פתרון

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

המאמרים הבאים