התצוגה 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 (צפייה במשאבי BigQuery) ‏(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: מזהה הפרויקט ב- Cloud de Confiance . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל.
  • ‫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} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+