התצוגה SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

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

התפקיד הנדרש

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

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

סכימה

לתצוגה INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION יש את הסכימה הבאה:
עמודה סוג תיאור
failover_reservation_project_id STRING מזהה הפרויקט של האדמין של המקום השמור למעבר לגיבוי אם הוא משויך לרפליקה.
failover_reservation_name STRING השם של ההקצאה לגיבוי אם היא משויכת לרפליקה.
catalog_name STRING מזהה הפרויקט שמכיל את מערך הנתונים.
schema_name STRING המזהה של מערך הנתונים.
replica_name STRING השם של הרפליקה.
location STRING האזור או מספר האזורים שבהם נוצרה הרפליקה.
replica_primary_assigned BOOL אם הערך הוא TRUE, הרפליקה היא בעלת ההקצאה הראשית. כשמשנים רפליקה משנית לרפליקה ראשית, המצב הזה נכנס לתוקף באופן מיידי.
replica_primary_assignment_complete BOOL אם הערך הוא TRUE, ההקצאה הראשית הושלמה. אם הערך הוא FALSE, הרפליקה אינה (עדיין) הרפליקה הראשית, גם אם replica_primary_assigned שווה ל-TRUE. מידע על משך הזמן שנדרש כדי שרפליקה משנית תהפוך לרפליקה ראשית זמין במאמר קידום הרפליקה המשנית.
creation_time TIMESTAMP מועד היצירה של העותק. כשמשכפלים את הרפליקה בפעם הראשונה, היא לא מסונכרנת באופן מלא עם הרפליקה הראשית עד ש-creation_complete שווה ל-TRUE. הערך של creation_time מוגדר לפני ש-creation_complete שווה ל- TRUE.
creation_complete BOOL אם הערך הוא TRUE, הסנכרון המלא הראשוני של הרפליקה הראשית לרפליקה המשנית הושלם.
replication_time TIMESTAMP

הערך של replication_time מציין את מידת העדכניות של מערך הנתונים.

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

אם מערך הנתונים מכיל טבלה עם נתונים בזמן אמת, הערך של replication_time לא יהיה מדויק.
sync_status JSON הסטטוס של הסנכרון בין הרפליקות הראשיות והמשניות של מערכי נתונים של רפליקציה בין אזורים ושל תוכנית התאוששות מאסון (DR). הפונקציה מחזירה NULL אם העותק הוא עותק ראשי או אם מערך הנתונים לא משתמש בשכפול.
replica_primary_assignment_time TIMESTAMP השעה שבה הופעל המעבר הראשי לרפליקה.
replica_primary_assignment_completion_time TIMESTAMP השעה שבה הושלם המעבר הראשי אל הרפליקה.

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

היקף ותחביר

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

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

דוגמאות

בקטע הזה מפורטות דוגמאות לשאילתות של התצוגה המפורטת INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

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

בדוגמה הבאה מפורטים כל מערכי הנתונים המשוכפלים באזור US:

SELECT *
FROM `region-us`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION
WHERE failover_reservation_name = "failover_reservation";

התוצאה אמורה להיראות כך:

+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| catalog_name | schema_name  | replica_name | location | replica_primary_assigned | replica_primary_assignment_complete |    creation_time    | creation_complete |  replication_time   | failover_reservation_project_id | failover_reservation_name |                                  sync_status                                  |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| project2     | test_dataset | us-east4     | us-east4 |                     true |                                true | 2024-05-09 20:34:06 |              true |                NULL | project1                        | failover_reservation      |                                                                          NULL |
| project2     | test_dataset | us           | US       |                    false |                               false | 2024-05-09 20:34:05 |              true | 2024-05-10 18:31:06 | project1                        | failover_reservation      | {"last_completion_time":"2024-06-06 18:31:06","error_time":null,"error":null} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+