‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

MySQL | PostgreSQL | SQL Server

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

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

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

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

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

ביצוע PITR

המסוף

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

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

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'

הערה: כברירת מחדל, שחזור מערכת מנקודה מסוימת בזמן (PITR) מיועד לכל מסדי הנתונים. אפשר גם לציין שם של מסד נתונים ספציפי אחד, באופן הבא: --database_names 'DATABASE'

REST v1

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

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

בבקשת ה-JSON, אפשר לציין עד שם אחד של מסד נתונים ספציפי, באופן הבא: "databaseNames": "my-database"

ה-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 נקודת הזמן שאליה רוצים לשחזר את הנתונים

בבקשת ה-JSON, אפשר לציין עד שם אחד של מסד נתונים ספציפי, באופן הבא: "databaseNames": "my-database"

ה-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 מופעלת האפשרות להשתמש בגיבויים משופרים, אתם יכולים לבצע שחזור מערכת מנקודה מסוימת בזמן (PITR) למכונה באמצעות כספת הגיבוי.

המסוף

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

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

gcloud

כדי לבצע PITR במכונה מכספת הגיבוי, צריך למצוא את ה-data-source של הגיבוי שהכי קרוב לזמן שבו רוצים לבצע את ה-PITR. כדי למצוא את הגיבוי, עיינו במאמר הצגת רשימה של כל הגיבויים בכספת הגיבוי של מכונה. אחרי שמזהים את הגיבוי, מריצים את הפקודה הבאה כדי לבצע את ה-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

כדי לבצע שחזור מערכת מנקודה מסוימת בזמן (PITR) באמצעות מקור נתונים מכספת הגיבוי, משתמשים ב-method‏ 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

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

‫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.

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

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

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

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

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

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

gcloud

גיבוי רגיל

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

כדי למצוא את חלון ה-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 \
    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

איך מוצאים את חלון ה-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

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

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

בבקשת ה-JSON, אפשר לציין עד שם אחד של מסד נתונים ספציפי, באופן הבא: "databaseNames": "my-database"

ה-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

מכונה לא זמינה

כדי לקבל את הזמן המוקדם ביותר והמאוחר ביותר שבהם אפשר לשחזר מכונה של 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

מכונה לא זמינה

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

‫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

מכונה לא זמינה

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

‫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.

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

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

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

ביצוע PITR

המסוף

gcloud

REST v1

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

‎PowerShell (Windows)

תשובה

‫REST v1beta4

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

‎PowerShell (Windows)

תשובה

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

המסוף

gcloud

REST v1

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

‎PowerShell (Windows)

תשובה

‫REST v1beta4

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

‎PowerShell (Windows)

תשובה

ביצוע PITR בין פרויקטים

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

gcloud

גיבוי רגיל

גיבוי משופר

REST v1

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

‎PowerShell (Windows)

תשובה

‫REST v1beta4

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

‎PowerShell (Windows)

תשובה

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

gcloud

REST v1

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

‎PowerShell (Windows)

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

‎PowerShell (Windows)

‫REST v1beta4

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

‎PowerShell (Windows)

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

‎PowerShell (Windows)

פתרון בעיות

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

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