התצוגה FAILOVER_HISTORY

כדי לבקש משוב או תמיכה בנוגע לתכונה הזו, אפשר לשלוח אימייל לכתובת bigquery-wlm-feedback@google.com.

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

התפקידים הנדרשים

כדי לקבל את ההרשאה שנדרשת לשליחת שאילתה לתצוגה INFORMATION_SCHEMA.FAILOVER_HISTORY, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ BigQuery Resource Viewer (צפייה במשאבי BigQuery) ‏(roles/bigquery.resourceViewer) בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה bigquery.reservations.list, שנדרשת כדי לשלוח שאילתות לתצוגה INFORMATION_SCHEMA.FAILOVER_HISTORY.

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

סכימה

לתצוגה INFORMATION_SCHEMA.FAILOVER_HISTORY יש את הסכימה הבאה:

שם עמודה סוג נתונים ערך
project_id STRING מזהה פרויקט הניהול שמכיל את המקום השמור.
project_number INTEGER מספר פרויקט הניהול.
reservation_name STRING שם ההזמנה שצוין על ידי המשתמש. לדוגמה, אם ה-URI של ההזמנה הוא projects/my-project/locations/US/reservations/my-reservation, שם ההזמנה הוא my-reservation.
start_time TIMESTAMP השעה שבה הופעל המעבר לגיבוי.
original_primary_location STRING המיקום שבו נוצרה ההזמנה במקור.
from_location STRING המיקום הראשי לפני המעבר לגיבוי. המיקום הזה הופך למיקום המשני אחרי המעבר לגיבוי.
to_location STRING המיקום המשני לפני המעבר לגיבוי, שבו הופעל המעבר לגיבוי. המיקום הזה הופך למיקום הראשי אחרי המעבר לגיבוי.
end_time TIMESTAMP השעה שבה הושלם המעבר לגיבוי. ‫NULL בזמן שמתבצע מעבר גיבוי רך, ותמיד NULL במעבר גיבוי קשיח.
failover_mode STRING סוג המעבר לגיבוי. יכול להיות SOFT או HARD. מידע נוסף זמין במאמר בנושא התאוששות מאסון בניהול.
state STRING המצב של המעבר לגיבוי. יכול להיות STARTED (במהלך מעבר גיבוי אוטומטי גמיש, או במעבר גיבוי אוטומטי קשיח) או COMPLETED (אחרי שמעבר גיבוי אוטומטי גמיש מסתיים). מידע נוסף על מצב STARTED של מעבר גיבוי למצב פעיל במקרה של כשל חמור מופיע בקטע מגבלות.

כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כללי (SELECT *). ציון מפורש של העמודות מונע את השבירה של השאילתות אם הסכימה הבסיסית משתנה.

שמירת נתונים

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

היקף ותחביר

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

שם התצוגה היקף המשאבים היקף האזור
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT] רמת הפרויקט REGION
מחליפים את הערכים בשדות הבאים:
  • אופציונלי: PROJECT_ID: מזהה הפרויקט ב- Google Cloud . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל.
  • ‫REGION: כל שם של אזור במערך נתונים. לדוגמה, `region-us`.

מגבלות

המגבלות הבאות חלות על התצוגה INFORMATION_SCHEMA.FAILOVER_HISTORY:

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

  • כל אירוע של מעבר לגיבוי מתועד באזור שהופך למיקום הראשי החדש (to_location). לדוגמה, אם מעבירים הזמנה מ-US ל-EU, האירוע מתועד ב-region-eu. כדי לראות אירועי מעבר לגיבוי (failover) בשני הכיוונים בין מיקום ראשי למיקום משני, צריך להריץ שאילתה בתצוגה בנפרד בכל אזור.

  • במעבר גיבוי למצב פעיל (hard failover) לא מחכים לאישור הפעולה במיקום המשני, ולכן לא מתקבל אות על השלמת האירוע. הערך בעמודה state של אירוע מעבר לגיבוי (failover) קשיח נשאר STARTED, והערך בעמודה end_time נשאר NULL, גם אחרי שהמעבר לגיבוי נכנס לתוקף.

דוגמה

בדוגמה הבאה מאחזרים את אירועי המעבר לגיבוי ב-region-us (כאשר US היה מיקום היעד to_location של המעבר לגיבוי) להזמנה ולפרויקט ספציפיים, לפי סדר האירועים מהחדש לישן:

SELECT
  project_id,
  reservation_name,
  failover_mode,
  state,
  original_primary_location,
  from_location,
  to_location,
  start_time,
  end_time
FROM
  `reservation-admin-project.region-us`.INFORMATION_SCHEMA.FAILOVER_HISTORY
WHERE
  reservation_name = 'my-reservation'
ORDER BY
  start_time DESC;

הפלט אמור להיראות כך:

+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
|  project_id   | reservation_name | failover_mode |   state   | original_primary_location | from_location | to_location |     start_time      |      end_time       |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
| my-admin-proj | my-reservation   | SOFT          | COMPLETED | US                        | EU            | US          | 2026-03-15 14:20:00 | 2026-03-15 14:31:05 |
| my-admin-proj | my-reservation   | HARD          | STARTED   | US                        | EU            | US          | 2026-02-10 08:15:30 | NULL                |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+