Method: hive.v1.projects.catalogs.failover

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

בקשת HTTP


POST https://biglake.googleapis.com/hive/v1/{name=projects/*/catalogs/*}:failover

כתובות ה-URL כתובות בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם הקטלוג בפורמט projects/{projectId}/catalogs/{catalogId}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "primaryReplica": string,
  "validateOnly": boolean,
  "conditionalFailoverReplicationTime": string
}
שדות
primaryReplica

string

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

boolean

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

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

גוף התשובה

הודעת תגובה ל-catalogs.failover.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "replicationTime": string
}
שדות
replicationTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.