יכול להיות שחלק מהמידע בדף הזה או כולו לא רלוונטי ל-Cloud de Confiance by S3NS. פרטים נוספים מופיעים במאמר מה ההבדל מ-Google Cloud.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ביצוע שחזור מנקודה מסוימת בזמן (PITR)

‫MySQL | PostgreSQL | SQL Server

אתם יכולים להשתמש בשחזור לנקודת זמן (PITR) כדי לשחזר את המכונות הראשיות של Cloud SQL, בין אם המכונה פעילה או נמחקה. שחזור מנקודה בזמן (PITR) מאפשר לשחזר את המופע לנקודה מסוימת בזמן. אם מוחקים מופע, אפשר לשחזר אותו לנקודת זמן ספציפית למופע חדש או קיים.

ב-Cloud SQL יש את האפשרויות הבאות לשחזור המכונה באמצעות PITR:

ביצוע PITR במופע פעיל
ביצוע PITR באמצעות כספת הגיבוי

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

ביצוע PITR במכונה שנמחקה

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

ביצוע PITR

המסוף

נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

כניסה לדף Cloud SQL Instances
פותחים את תפריט הפעולות הנוספות של המכונה שרוצים לשחזר ולוחצים על Create clone.
אופציונלי: בדף יצירת שיבוט, מעדכנים את המזהה של השיבוט החדש.
בוחרים באפשרות Clone from an earlier point in time (שיבוט מנקודה מוקדמת יותר בזמן).
מזינים את השעה של ה-PITR.
לוחצים על יצירת שיבוט.

gcloud

יצירת שיבוט באמצעות PITR.

מחליפים את מה שכתוב בשדות הבאים:

‫SOURCE_INSTANCE_NAME – השם של המכונה שמשחזרים ממנה.
‫NEW_INSTANCE_NAME – שם השכפול.
‫TIMESTAMP – אזור הזמן UTC של מופע המקור בפורמט RFC 3339. לדוגמה: ‏2012-11-15T16:19:00.094Z.

gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time 'TIMESTAMP'

REST v1

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫target-instance-id: מזהה מכונת היעד
‫source-instance-id: מזהה מופע המקור
restore-timestamp הנקודה בזמן לשחזור עד אליה

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone

תוכן בקשת JSON:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫target-instance-id: מזהה מכונת היעד
‫source-instance-id: מזהה מופע המקור
restore-timestamp הנקודה בזמן לשחזור עד אליה

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

תוכן בקשת JSON:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

ביצוע PITR באמצעות כספת הגיבוי

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

המסוף

נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

כניסה לדף Cloud SQL Instances
פותחים את תפריט הפעולות הנוספות של המכונה שרוצים לשחזר ולוחצים על Create clone.
בוחרים באפשרות Clone from an earlier point in time (שיבוט מנקודה מוקדמת יותר בזמן).
מזינים את השעה של ה-PITR.
לוחצים על יצירת שיבוט.

gcloud

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

  gcloud sql instances point-in-time-restore DATA_SOURCE TARGET_INSTANCE_NAME PITR_TIMESTAMP \
  --project=TARGET_PROJECT \
  --region=REGION

מחליפים את מה שכתוב בשדות הבאים:

‫DATA_SOURCE: הנתיב של data-source למופע המקור, שהכי קרוב לחותמת הזמן של PITR שרוצים לשחזר.
‫TARGET_INSTANCE_NAME: השם של המופע החדש שנוצר על ידי פעולת PITR.
‫PITR_TIMESTAMP: חותמת הזמן לפי שעון UTC של יומן ה-PITR של מופע המקור שרוצים לשחזר את המופע ממנו, בפורמט RFC 3339. לדוגמה, 2025-11-15T16:19:00.094Z.
‫TARGET_PROJECT: מזהה הפרויקט של המופע החדש.
‫REGION: האזור של מכונת היעד. השדה הזה נדרש אם מקור הנתונים של מופע המקור ממוקם במספר אזורים. האזור של מופע היעד צריך להיות זהה לאזור של מופע המקור.

REST v1

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את המופע החדש.
‫DATASOURCE: מקור הנתונים של Backup and DR שבו השירות ישתמש לפעולת השחזור לנקודת זמן מסוימת.
‫PITR_TIMESTAMP: חותמת הזמן לפי שעון UTC של יומן ה-PITR של מופע המקור שרוצים לשחזר את המופע אליו, בפורמט RFC 3339. לדוגמה: ‏2012-11-15T16:19:00.094Z.
‫TARGET_INSTANCE_NAME: השם של המכונה שנוצרה על ידי פעולת ה-PITR.
‫REGION: האזור של מכונת היעד. השדה הזה נדרש אם מקור הנתונים של מופע המקור ממוקם במספר אזורים. האזור של מופע היעד צריך להיות זהה לאזור של מופע המקור.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID:pointInTimeRestore

תוכן בקשת JSON:

{
  "datasource": "DATASOURCE",
  "pointInTime": "PITR_TIMESTAMP",
  "targetInstanceName": "TARGET_INSTANCE_NAME",
  "region": "REGION"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID:pointInTimeRestore"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID:pointInTimeRestore" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את המופע החדש.
‫DATASOURCE: מקור הנתונים של Backup and DR שבו השירות ישתמש לפעולת השחזור לנקודת זמן מסוימת.
‫PITR_TIMESTAMP: חותמת הזמן לפי שעון UTC של יומן ה-PITR של מופע המקור שרוצים לשחזר את המופע אליו, בפורמט RFC 3339. לדוגמה: ‏2012-11-15T16:19:00.094Z.
‫TARGET_INSTANCE_NAME: השם של המכונה שנוצרה על ידי פעולת ה-PITR.
‫REGION: האזור של מכונת היעד. השדה הזה נדרש אם מקור הנתונים של מופע המקור ממוקם במספר אזורים. האזור של מופע היעד צריך להיות זהה לאזור של מופע המקור.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID:pointInTimeRestore

תוכן בקשת JSON:

{
  "datasource": "DATASOURCE",
  "pointInTime": "PITR_TIMESTAMP",
  "targetInstanceName": "TARGET_INSTANCE_NAME",
  "region": "REGION"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID:pointInTimeRestore"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID:pointInTimeRestore" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

ביצוע שחזור לנקודת זמן (PITR) בין פרויקטים

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

שחזור PITR בין פרויקטים נתמך רק באמצעות ה-CLI של gcloud וממשקי API בארכיטקטורת REST.

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

אם אתם משתמשים ב-CLI של gcloud, מגדירים את הדגל --project לפרויקט שבו רוצים ליצור את מכונת היעד.
אם משתמשים בממשקי REST API, צריך להגדיר את השדה PROJECT_ID לפרויקט שבו רוצים ליצור את מופע היעד.

ביצוע PITR במופע שלא זמין

המסוף

יכול להיות שתרצו לשחזר מופע שלא זמין לאזור אחר מהסיבות הבאות:

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

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

נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

כניסה לדף Cloud SQL Instances
מוצאים את השורה של המופע שרוצים לשכפל.
בעמודה פעולות, לוחצים על התפריט עוד פעולות.
לוחצים על יצירת שיבוט.
בדף Create a clone, מבצעים את הפעולות הבאות:
1. בשדה Instance ID (מזהה מופע), מעדכנים את מזהה המופע אם צריך.
2. לוחצים על Clone from an earlier point in time (שיבוט מנקודת זמן קודמת).
3. בשדה Point in time (נקודה בזמן), בוחרים תאריך ושעה שממנה רוצים לשכפל את הנתונים. הפעולה הזו משחזרת את מצב המופע מאותה נקודה בזמן.
4. לוחצים על יצירת שיבוט.

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

gcloud

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

gcloud sql instances clone SOURCE_INSTANCE_NAME TARGET_INSTANCE_NAME \
--point-in-time DATE_AND_TIME_STAMP \
--preferred-zone ZONE_NAME \
--preferred-secondary-zone SECONDARY_ZONE_NAME

למשתמש או לחשבון השירות שמריצים את הפקודה gcloud sql instances clone צריכה להיות ההרשאה cloudsql.instances.clone. מידע נוסף על ההרשאות הנדרשות להרצת פקודות של ה-CLI של gcloud זמין במאמר הרשאות Cloud SQL.

REST v1

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫SOURCE_INSTANCE_NAME: השם של מופע המקור.
‫TARGET_INSTANCE_NAME: השם של מכונת היעד (המשובטת).
‫DATE_AND_TIME_STAMP: חותמת תאריך ושעה של מופע המקור באזור הזמן UTC ובפורמט RFC 3339 (לדוגמה,
2012-11-15T16:19:00.094Z).
‫ZONE_NAME: אופציונלי. השם של האזור הראשי של מופע היעד. הפרמטר הזה משמש לציון אזור ראשי אחר למופע Cloud SQL שרוצים לשכפל. במקרה של מופע אזורי, האזור הזה מחליף את האזור הראשי, אבל האזור המשני נשאר זהה למופע.
‫SECONDARY_ZONE_NAME: אופציונלי. השם של האזור המשני עבור מופע היעד. הפרמטר הזה משמש לציון אזור משני אחר למופע האזורי של Cloud SQL שרוצים לשכפל.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

תוכן בקשת JSON:

{
  "cloneContext":
  {
    "destinationInstanceName": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID",
  "instanceUid": "INSTANCE_ID"
}

למשתמש או לחשבון השירות שמשתמשים ב-method של instances.clone API צריכה להיות ההרשאה cloudsql.instances.clone. מידע נוסף על ההרשאות הנדרשות לשימוש בשיטות API זמין במאמר הרשאות Cloud SQL.

REST v1beta4

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫SOURCE_INSTANCE_NAME: השם של מופע המקור.
‫TARGET_INSTANCE_NAME: השם של מכונת היעד (המשובטת).
‫DATE_AND_TIME_STAMP: חותמת תאריך ושעה של מופע המקור באזור הזמן UTC ובפורמט RFC 3339 (לדוגמה,
2012-11-15T16:19:00.094Z).
‫ZONE_NAME: אופציונלי. השם של האזור הראשי של מופע היעד. הפרמטר הזה משמש לציון אזור ראשי אחר למופע Cloud SQL שרוצים לשכפל. במקרה של מופע אזורי, האזור הזה מחליף את האזור הראשי, אבל האזור המשני נשאר זהה למופע.
‫SECONDARY_ZONE_NAME: אופציונלי. השם של האזור המשני עבור מופע היעד. הפרמטר הזה משמש לציון אזור משני אחר למופע האזורי של Cloud SQL שרוצים לשכפל.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

תוכן בקשת JSON:

{
  "cloneContext":
  {
    "destinationInstanceName": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID",
  "instanceUid": "INSTANCE_ID"
}

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

The timestamp for point-in-time recovery is after the latest recovery time of
Timestamp of latest recovery time. Clone the instance with a time
that's earlier than this recovery time.

ביצוע PITR במופע שנמחק

כדי להשתמש ב-PITR לשחזור מופע שנמחק, צריך:

חותמת הזמן של PITR‏ (timestamp) שאליה רוצים לשחזר את המופע
שם מופע היעד
השעה שבה המופע של מקור המודעות נמחק (source-instance-deletion-time)

אפשר להשתמש ב-PITR במכונה שנמחקה רק באמצעות ה-CLI של gcloud או Cloud SQL API. מידע נוסף מופיע במאמר בנושא שחזור מופע שנמחק באמצעות PITR.

gcloud

גיבוי רגיל

איך מוצאים את חלון הזמן של PITR

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

חיפוש מחיקה של מופע של מקור

הנתונים source-instance-deletion-time ו-log-retention-days של המופע שנמחק מאוחסנים עם הגיבויים שנשמרו של המופע אחרי המחיקה. כדי לראות רשימה של כל הגיבויים הזמינים של המופע שנמחק, אפשר לעיין במאמר בנושא רשימת גיבויים שנשמרו.

אחרי שמזהים את הגיבוי שרוצים להשתמש בו, משתמשים בפקודה gcloud sql backups describe כדי לקבל את source-instance-deletion-time.

שחזור באמצעות PITR

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

gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time='PITR_TIMESTAMP' \
--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIMESTAMP

מחליפים את מה שכתוב בשדות הבאים:

‫SOURCE_INSTANCE_NAME: השם של מופע המקור שרוצים לשחזר.
‫NEW_INSTANCE_NAME: השם של המכונה החדשה.
‫PITR_TIMESTAMP: חותמת הזמן לפי שעון UTC של יומן ה-PITR של מופע המקור שרוצים לשחזר את המופע ממנו, בפורמט RFC 3339. לדוגמה: 2012-11-15T16:19:00.094Z.
‫SOURCE_INSTANCE_DELETION_TIMESTAMP: חותמת הזמן לפי שעון UTC של הזמן שבו מופע המקור נמחק, בפורמט RFC 3339. לדוגמה: ‏2012-11-15T16:19:00.094Z.

גיבוי משופר

איך מוצאים את חלון הזמן של PITR

חיפוש מקור הנתונים

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

שחזור באמצעות PITR

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

gcloud sql instances point-in-time-restore DATA_SOURCE \
--point-in-time='PITR_TIMESTAMP' \
--project='TARGET_PROJECT' \

מחליפים את מה שכתוב בשדות הבאים:

‫DATA_SOURCE: הנתיב של data-source לגיבוי שהכי קרוב לחותמת הזמן של ה-PITR שרוצים לשחזר.
‫PITR_TIMESTAMP: חותמת הזמן לפי שעון UTC של יומן ה-PITR של מופע המקור שרוצים לשחזר את המופע ממנו, בפורמט RFC 3339. לדוגמה: 2012-11-15T16:19:00.094Z.
‫TARGET_PROJECT: מזהה הפרויקט של מופע Cloud SQL.

REST v1

איך מוצאים את חלון הזמן של PITR

איך מוצאים את זמן המחיקה של מופע המקור ואת מספר הימים לשמירת היומן

הנתונים source-instance-deletion-time ו-log-retention-days של המופע שנמחק מאוחסנים עם הגיבויים שנשמרו של המופע אחרי המחיקה. כדי למצוא את הערכים האלה עבור המופע שנמחק, אפשר לעיין במאמר בנושא רשימת גיבויים שנשמרו.

שחזור באמצעות PITR

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫target-instance-id: מזהה מכונת היעד
‫source-instance-id: מזהה מכונת המקור
‫source-instance-deletion-time: שעת המחיקה של מופע המקור
restore-timestamp הנקודה בזמן שרוצים לשחזר את המכונה

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone

תוכן בקשת JSON:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "sourceInstanceDeletionTime: "source-instance-deletion-time",
    "pointInTime": "restore-timestamp"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

איך מוצאים את חלון הזמן של PITR

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

איך מוצאים את זמן המחיקה של מופע המקור ואת מספר הימים לשמירת היומן

שחזור באמצעות PITR

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫target-instance-id: מזהה מכונת היעד
‫source-instance-id: מזהה מכונת המקור
‫source-instance-deletion-time: שעת המחיקה של מופע המקור
restore-timestamp הנקודה בזמן שרוצים לשחזר את המכונה

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

תוכן בקשת JSON:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "sourceInstanceDeletionTime: "source-instance-deletion-time",
    "pointInTime": "restore-timestamp"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

הצגת הזמן המוקדם והמאוחר ביותר להתאוששות

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

gcloud

Unavailable instance

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

gcloud sql instances get-latest-recovery-time INSTANCE_NAME

מחליפים את מה שכתוב בשדות הבאים:

‫INSTANCE_NAME: השם של המכונה שרוצים למצוא את זמן השחזור האחרון שלה.

מכונה שנמחקה

כדי לקבל את השעה המוקדמת והשעה המאוחרת שבהן אפשר לשחזר מכונה שנמחקה ב-Cloud SQL, מריצים את הפקודה הבאה:

gcloud sql instances get-latest-recovery-time INSTANCE_NAME
--source-instance-deletion-time='SOURCE_INSTANCE_DELETION_TIMESTAMP'

מחליפים את מה שכתוב בשדות הבאים:

‫INSTANCE_NAME: השם של המכונה שרוצים למצוא את זמן השחזור האחרון שלה.
‫SOURCE_INSTANCE_DELETION_TIMESTAMP: חותמת הזמן לפי שעון UTC של הזמן שבו מופע המקור נמחק, בפורמט RFC 3339. לדוגמה: ‏2012-11-15T16:19:00.094Z.

REST v1

Unavailable instance

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫INSTANCE_NAME: השם של המכונה שעבורה מבצעים שאילתה לגבי זמן השחזור האחרון

ה-method של ה-HTTP וכתובת ה-URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

מכונה שנמחקה

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫INSTANCE_NAME: השם של מכונת המקור שעבורה אתם שולחים שאילתה לגבי זמן השחזור האחרון
‫SOURCE_INSTANCE_DELETION_TIME: השעה שבה מופע המקור נמחק

ה-method של ה-HTTP וכתובת ה-URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

REST v1beta4

Unavailable instance

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫INSTANCE_NAME: השם של המכונה שעבורה מבצעים שאילתה לגבי זמן השחזור האחרון

ה-method של ה-HTTP וכתובת ה-URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

מכונה שנמחקה

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫INSTANCE_NAME: השם של מכונת המקור שעבורה אתם שולחים שאילתה לגבי זמן השחזור האחרון
‫SOURCE_INSTANCE_DELETION_TIME: השעה שבה מופע המקור נמחק

ה-method של ה-HTTP וכתובת ה-URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

פתרון בעיות

שגיאה פתרון בעיות

שגיאה	פתרון בעיות
`argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z` או `Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,`	חותמת הזמן שסיפקת לא תקינה.
`HTTP Error 400: Successful backup required for carrying out the operation was not found.` או `Successful backup required for carrying out the operation was not found. or Time where no backups can be found.`	חותמת הזמן שסיפקתם היא של שעה שבה לא ניתן היה למצוא גיבויים או קואורדינטות של binlog.

argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z

או

Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,

חותמת הזמן שסיפקת לא תקינה.

HTTP Error 400: Successful backup required for carrying out the operation was not found.

או

Successful backup required for carrying out the operation was not found. or Time where no backups can be found.

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

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

הגדרת דיווחים על השיבוט