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

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

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

‫MySQL | PostgreSQL | SQL Server

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

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

לפני שמתחילים

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

אם מפעילים את PITR במכונה קיימת, המכונה מופעלת מחדש.
כשיוצרים מכונה של Cloud SQL Enterprise במסוף Cloud de Confiance , האפשרות PITR מופעלת כברירת מחדל. אם אתם משתמשים ב-CLI של gcloud, ב-Terraform או ב-Cloud SQL Admin API ואתם רוצים להפעיל את התכונה, אתם צריכים לעשות את זה באופן ידני.
כשיוצרים מכונה של מהדורת Cloud SQL Enterprise Plus, התכונה PITR מופעלת כברירת מחדל, בלי קשר לשיטה שבה משתמשים. אם רוצים להשבית את התכונה, צריך לעשות את זה באופן ידני.
הגיבויים האוטומטיים מופעלים כברירת מחדל כשיוצרים מכון במסוף Cloud de Confiance . אם אתם משתמשים ב-CLI של gcloud, ב-Terraform או ב-Cloud SQL Admin API, ואתם רוצים להפעיל את התכונה, אתם צריכים לעשות את זה ידנית.

הפעלת PITR

התהליך הבא מפעיל את PITR במכונה ראשית קיימת.

המסוף

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

כניסה לדף Cloud SQL Instances
פותחים את תפריט הפעולות הנוספות של המכונה שרוצים להפעיל בה PITR ולוחצים על Edit.
בקטע Customize your instance, מרחיבים את הקטע הגנה על נתונים.
מסמנים את התיבה Enable point-in-time recovery.
בשדה Days of logs, מזינים את מספר הימים לשמירת היומנים, בין 1 ל-35 למהדורת Cloud SQL Enterprise Plus, או בין 1 ל-7 למהדורת Cloud SQL Enterprise.
לוחצים על Save.

gcloud

מציגים את הסקירה הכללית של המכונה:
```
gcloud sql instances describe INSTANCE_NAME
```
אם מופיע enabled: false בקטע backupConfiguration, צריך להפעיל את הגיבויים המתוזמנים:
```
gcloud sql instances patch INSTANCE_NAME \
--backup-start-time=HH:MM
```
מציינים את הפרמטר backup-start-time בפורמט של 24 שעות באזור הזמן UTC±00.
הפעלת PITR:
```
gcloud sql instances patch INSTANCE_NAME \
--enable-point-in-time-recovery
```
אם אתם מפעילים PITR במכונה ראשית, אתם יכולים גם להגדיר את מספר הימים שבהם אתם רוצים לשמור את יומני העסקאות, על ידי הוספת הפרמטר הבא:
```
--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS
```
מאשרים את השינוי:
```
gcloud sql instances describe INSTANCE_NAME
```
בקטע backupConfiguration, אם השינוי בוצע בהצלחה, מופיע הכיתוב pointInTimeRecoveryEnabled: true.

Terraform

כדי להפעיל את PITR, משתמשים במשאב של Terraform.

resource "google_sql_database_instance" "postgres_instance_pitr" {
  name             = ""
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled                        = true
      point_in_time_recovery_enabled = true
      start_time                     = "20:55"
      transaction_log_retention_days = "3"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

החלה של השינויים

כך מחילים את ההגדרות של Terraform בפרויקט ב- Cloud de Confiance :

הכנת Cloud Shell

מפעילים את Cloud Shell.
מגדירים את פרויקט ברירת המחדל ב- Cloud de Confiance שבו רוצים להחיל את ההגדרות של Terraform.

תצטרכו להריץ את הפקודה הזו רק פעם אחת לכל פרויקט, ותוכלו לעשות זאת בכל ספרייה.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
אם תגדירו ערכים ספציפיים בקובץ התצורה של Terraform, הם יבטלו את ערכי ברירת המחדל של משתני הסביבה.

הכנת הספרייה

לכל קובץ תצורה של Terraform צריכה להיות ספרייה משלו (שנקראת גם מודול ברמה הבסיסית).

יוצרים ספרייה חדשה ב-Cloud Shell ובה יוצרים קובץ חדש. שם הקובץ חייב לכלול את הסיומת .tf, למשל main.tf. במדריך הזה, הקובץ נקרא main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
אם אתם עוקבים אחרי המדריך, תוכלו להעתיק את הקוד לדוגמה בכל קטע או שלב.

מעתיקים את הקוד לדוגמה בקובץ main.tf החדש שיצרתם.

לחלופין, אפשר גם להעתיק את הקוד מ-GitHub. כדאי לעשות את זה כשקטע הקוד של Terraform הוא חלק מפתרון מקצה לקצה.
בודקים את הפרמטרים לדוגמה ומשנים אותם בהתאם לסביבה שלכם.
שומרים את השינויים.
מפעילים את Terraform. צריך לעשות זאת רק פעם אחת לכל ספרייה.
```
terraform init
```
אופציונלי: תוכלו לכלול את האפשרות -upgrade, כדי להשתמש בגרסה העדכנית ביותר של הספק של Google:
```
terraform init -upgrade
```

החלה של השינויים

בודקים את ההגדרות ומוודאים שהמשאבים שמערכת Terraform תיצור או תעדכן תואמים לציפיות שלכם:
```
terraform plan
```
מתקנים את ההגדרות לפי הצורך.
מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform:
```
terraform apply
```
ממתינים עד שב-Terraform תוצג ההודעה "Apply complete!‎".
פותחים את הפרויקט ב- Cloud de Confiance כדי להציג את התוצאות. במסוף Cloud de Confiance , נכנסים למשאבים בממשק המשתמש כדי לוודא שהם נוצרו או עודכנו ב-Terraform.

למחוק את השינויים

כדי למחוק את השינויים:

כדי להשבית את ההגנה מפני מחיקה, בקובץ התצורה של Terraform מגדירים את הארגומנט deletion_protection לערך false.
```
deletion_protection =  "false"
```
מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform המעודכנות:
```
terraform apply
```

כדי להסיר משאבים שהוחלו בעבר על הגדרות Terraform, מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה:
```
terraform destroy
```

REST v1

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

‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Cloud de Confiance שמכיל את המכונה
‫INSTANCE_NAME: השם של המכונה הראשית או של מכונת הרפליקה לקריאה בלבד שאתם מגדירים לזמינות גבוהה
‫START_TIME: השעה (בשעות ובדקות)

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

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

תוכן בקשת JSON:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

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

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

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

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

curl -X PATCH \
     -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/INSTANCE_NAME"

‎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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

תשובה

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

REST v1beta4

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

‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Cloud de Confiance שמכיל את המכונה
‫INSTANCE_NAME: השם של המכונה הראשית או של מכונת הרפליקה לקריאה בלבד שאתם מגדירים לזמינות גבוהה
‫START_TIME: השעה (בשעות ובדקות)

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

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

תוכן בקשת JSON:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

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

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

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

curl -X PATCH \
     -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/INSTANCE_NAME"

‎PowerShell (Windows)

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

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

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

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

תשובה

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

השבתת PITR

המסוף

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

כניסה לדף Cloud SQL Instances
פותחים את תפריט הפעולות הנוספות של המכונה שרוצים להשבית ובוחרים באפשרות Edit.
בקטע Customize your instance, מרחיבים את הקטע הגנה על נתונים.
מבטלים את הסימון של Enable point-in-time recovery.
לוחצים על Save.

gcloud

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

gcloud sql instances patch INSTANCE_NAME \
--no-enable-point-in-time-recovery

מאשרים את השינוי:
```
gcloud sql instances describe INSTANCE_NAME
```
בקטע backupConfiguration, אם השינוי בוצע בהצלחה, מופיע הכיתוב pointInTimeRecoveryEnabled: false.

REST v1

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

‫project-id: מזהה הפרויקט
‫instance-id: מזהה המכונה

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

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

תוכן בקשת JSON:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

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

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

curl -X PATCH \
     -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/instance-id"

‎PowerShell (Windows)

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

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

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

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

תשובה

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

REST v1beta4

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

‫project-id: מזהה הפרויקט
‫instance-id: מזהה המכונה

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

תוכן בקשת JSON:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

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

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

curl -X PATCH \
     -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/instance-id"

‎PowerShell (Windows)

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

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

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

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

תשובה

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

הגדרת שמירה של יומן עסקאות

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

המסוף

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

כניסה לדף Cloud SQL Instances
פותחים את תפריט הפעולות הנוספות של המכונה שבה רוצים להגדיר את יומן העסקאות, ובוחרים באפשרות Edit.
בקטע Customize your instance, מרחיבים את הקטע הגנה על נתונים.
בקטע Enable point-in-time recovery, מרחיבים את Advanced options.
מזינים את מספר הימים לשמירת היומנים: 1-35 למהדורת Cloud SQL Enterprise Plus או 1-7 למהדורת Cloud SQL Enterprise.
לוחצים על Save.

gcloud

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

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

‫INSTANCE_NAME: שם המכונה שבה רוצים להגדיר את יומן העסקאות.
‫DAYS_TO_RETAIN: מספר הימים שבהם יישמרו יומני הטרנזקציות. במהדורת Cloud SQL Enterprise Plus, הטווח התקין הוא בין יום אחד ל-35 ימים, והברירת המחדל היא 14 ימים. במהדורת Cloud SQL Enterprise, טווח הערכים התקין הוא בין יום אחד ל-7 ימים, וערך ברירת המחדל הוא 7 ימים.

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

  gcloud sql instances patch INSTANCE_NAME 

    --retained-transaction-log-days=DAYS_TO_RETAIN

REST v1

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

‫PROJECT_ID: מזהה הפרויקט.
‫INSTANCE_ID: מזהה המכונה.
‫DAYS_TO_RETAIN: מספר הימים לשמירת יומני הטרנזקציות. במהדורת Cloud SQL Enterprise Plus, הטווח התקין הוא בין יום אחד ל-35 ימים, והברירת המחדל היא 14 ימים. במהדורת Cloud SQL Enterprise, הטווח התקין הוא בין יום אחד ל-7 ימים, וברירת המחדל היא 7 ימים.

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

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

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

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

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

curl -X PATCH \
     -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/INSTANCE_ID"

‎PowerShell (Windows)

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

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

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

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

תשובה

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

REST v1beta4

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

‫PROJECT_ID: מזהה הפרויקט.
‫INSTANCE_ID: מזהה המכונה.
‫DAYS_TO_RETAIN: מספר הימים לשמירת יומני הטרנזקציות. במהדורת Cloud SQL Enterprise Plus, הטווח התקין הוא בין יום אחד ל-35 ימים, והברירת המחדל היא 14 ימים. במהדורת Cloud SQL Enterprise, הטווח התקין הוא בין יום אחד ל-7 ימים, וברירת המחדל היא 7 ימים.

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

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

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

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

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

curl -X PATCH \
     -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/INSTANCE_ID"

‎PowerShell (Windows)

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

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

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

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

תשובה

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

בדיקת מיקום האחסון של יומני העסקאות שמשמשים ל-PITR

אתם יכולים לבדוק איפה מאוחסנים יומני העסקאות של מכונת Cloud SQL שמשמשים ל-PITR.

gcloud

כדי לבדוק אם המכונה מאחסנת יומנים ל-PITR בדיסק או ב-Cloud Storage, משתמשים בפקודה הבאה:

   gcloud sql instances describe INSTANCE_NAME

מחליפים את INSTANCE_NAME בשם המכונה.

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

   gcloud sql instances list --show-transactional-log-storage-state

דוגמה לתגובה:

NAME  DATABASE_VERSION LOCATION         TRANSACTIONAL_LOG_STORAGE_STATE
my_01 POSTGRES_12      us-central-1     DISK
my_02 POSTGRES_12      us-central-1     CLOUD_STORAGE
...

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

‫DISK: המכונה שומרת בדיסק את יומני הטרנזקציות שמשמשים ל-PITR. אם משדרגים מכונה של Cloud SQL Enterprise ל-Cloud SQL Enterprise Plus, תהליך השדרוג מעביר את מיקום האחסון של היומנים ל-Cloud Storage באופן אוטומטי. מידע נוסף מופיע במאמר שדרוג מכונה למהדורת Cloud SQL Enterprise Plus באמצעות שדרוג במקום. אפשר גם להחליף את מיקום האחסון באמצעות ה-CLI של gcloud או Cloud SQL Admin API, בלי לשדרג את מהדורת המכונה ובלי לגרום לזמן השבתה. מידע נוסף זמין במאמר העברת האחסון של יומן העסקאות ל-Cloud Storage.
‫SWITCHING_TO_CLOUD_STORAGE: המכונה מעבירה את מיקום האחסון של יומני העסקאות של PITR ל-Cloud Storage.
‫SWITCHED_TO_CLOUD_STORAGE: המכונה סיימה להעביר את מיקום האחסון של יומני העסקאות של PITR מהדיסק ל-Cloud Storage.
‫CLOUD_STORAGE: המכונה שומרת את יומני הטרנזקציות שמשמשים ל-PITR ב-Cloud Storage.

העברת האחסון של יומן העסקאות ל-Cloud Storage

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

אחרי שהתהליך הכולל של המעבר ל-Cloud Storage מסתיים, Cloud SQL משתמש ביומני העסקאות מ-Cloud Storage ל-PITR.

gcloud

כדי להעביר את מיקום האחסון ל-Cloud Storage, משתמשים בפקודה הבאה:

   gcloud sql instances patch INSTANCE_NAME \
      --switch-transaction-logs-to-cloud-storage

מחליפים את INSTANCE_NAME בשם המכונה. המכונה חייבת להיות מכונה ראשית ולא מכונת רפליקה. התגובה אמורה להיראות כך:

The following message is used for the patch API method.
{"name": "INSTANCE_NAME", "project": "PROJECT_NAME", "switchTransactionalLogsToCloudStorageEnabled": "true"}

Patching Cloud SQL instance...done.
Updated
[https://sqladmin.prod.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME].

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

REST v1

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

‫PROJECT_ID: מזהה הפרויקט.
‫INSTANCE_ID: מזהה המכונה. המכונה חייבת להיות מכונה ראשית ולא מכונת רפליקה.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
   "switchTransactionLogsToCloudStorageEnabled": true
}

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

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

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

curl -X PATCH \
     -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/INSTANCE_ID"

‎PowerShell (Windows)

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

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

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

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

תשובה

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

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

REST v1beta4

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

‫PROJECT_ID: מזהה הפרויקט.
‫INSTANCE_ID: מזהה המכונה. המכונה חייבת להיות מכונה ראשית ולא מכונת רפליקה.

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
   "switchTransactionLogsToCloudStorageEnabled": true
}

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

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

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

curl -X PATCH \
     -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/INSTANCE_ID"

‎PowerShell (Windows)

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

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

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

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

תשובה

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

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

פתרון בעיות במעבר ל-Cloud Storage

בטבלה הבאה מפורטות שגיאות אפשריות שיכולות להחזיר את הקוד INVALID REQUEST כשמעבירים את מיקום האחסון של יומני העסקאות מדיסק ל-Cloud Storage.

שגיאה	פתרון בעיות
`Switching the storage location of the transaction logs used for PITR is not supported for instances with database type %s.`	חשוב לוודא שאתם מריצים את הפקודה של ה-CLI של gcloud או שולחים את בקשת ה-API במכונה של Cloud SQL ל-MySQL או של Cloud SQL ל-PostgreSQL. אי אפשר להחליף את מיקום האחסון של יומני הטרנזקציות באמצעות ה-CLI של gcloud או Cloud SQL Admin API ב-Cloud SQL ל-SQL Server.
`PostgreSQL transactional logging is not enabled on this instance.`	ב-PostgreSQL, כתיבה מראש ביומן (WAL) משמשת כיומני העסקאות לשחזור המערכת מנקודה מסוימת בזמן (PITR). כדי לתמוך ב-PITR, ב-PostgreSQL צריך להפעיל כתיבה מראש ביומן (WAL) במכונה. איך מפעילים כתיבה מראש ביומן (WAL)
`This instance is already storing transaction logs used for PITR in Cloud Storage`	כדי לוודא את מיקום האחסון של יומני הטרנזקציות, מריצים את הפקודה שמפורטת בקטע בדיקת מיקום האחסון של יומני הטרנזקציות שמשמשים ל-PITR.
`The instance is already switching transaction logs used for PITR from disk to Cloud Storage.`	מחכים עד שהמעבר יסתיים. כדי לבדוק את סטטוס הפעולה ואת מיקום האחסון של יומני הטרנזקציות, מריצים את הפקודה שמפורטת בקטע בדיקת מיקום האחסון של יומני הטרנזקציות שמשמשים ל-PITR.

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

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