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

ייצוא וייבוא באמצעות קובצי SQL מוכנים לשימוש

‫MySQL | PostgreSQL | SQL Server

בדף הזה מוסבר איך לייצא ולייבא נתונים למכונות Cloud SQL באמצעות קובצי SQL dump.

הערה: אם מעבירים מסד נתונים שלם משרת מסד נתונים נתמך (במקום, ב-AWS או ב-Cloud SQL) למופע חדש של Cloud SQL, אפשר להשתמש בDatabase Migration Service במקום לייצא ואז לייבא קבצים. אם אתם מייצאים כדי ליצור מכונה חדשה מהקובץ שיוצא, כדאי לשחזר מגיבוי למכונה אחרת או לשכפל את המכונה.

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

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

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

שיטות מומלצות לייבוא ולייצוא של נתונים

אחרי שמסיימים את פעולת הייבוא, מאמתים את התוצאות.

ייצוא נתונים מ-Cloud SQL ל-PostgreSQL

התפקידים וההרשאות שנדרשים כדי לייצא מ-Cloud SQL ל-PostgreSQL

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

התפקיד עריכה ב-Cloud SQL
תפקיד בהתאמה אישית, שכולל את ההרשאות הבאות:
- cloudsql.instances.get
- cloudsql.instances.export

בנוסף, לחשבון השירות של מכונת Cloud SQL צריך להיות אחד מהתפקידים הבאים:

תפקיד storage.objectAdmin ניהול הזהויות והרשאות הגישה (IAM)
תפקיד בהתאמה אישית, כולל ההרשאות הבאות:
- storage.objects.create
- ‫storage.objects.list (לייצוא קבצים במקביל בלבד)
- ‫storage.objects.delete (לייצוא קבצים במקביל בלבד)

לעזרה בנושא תפקידי IAM, קראו את המאמר ניהול זהויות והרשאות גישה.

ייצוא לקובץ SQL dump מ-Cloud SQL ל-PostgreSQL

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

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

כדי לייצא נתונים ממסד נתונים במכונה של Cloud SQL לקובץ SQL מוכן לשימוש בקטגוריה של Cloud Storage:

המסוף

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

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
לוחצים על ייצוא.
בקטע File format, לוחצים על SQL כדי ליצור קובץ SQL מוכן לשימוש.
בקטע Data to export, משתמשים בתפריט הנפתח Database כדי לבחור את מסד הנתונים שממנו רוצים לייצא.
אופציונלי: בוחרים באפשרות Offload export to a temporary instance כדי לאפשר פעולות אחרות בזמן שהייצוא מתבצע.
בקטע Destination, לוחצים על Browse כדי לחפש קטגוריה של Cloud Storage או תיקייה לייצוא.
לוחצים על ייצוא כדי להתחיל בייצוא.

gcloud

יצירת קטגוריה של Cloud Storage
מחפשים את חשבון השירות של מכונת Cloud SQL שממנה מייצאים את הנתונים. כדי לעשות את זה, מריצים את הפקודה gcloud sql instances describe. מחפשים את השדה serviceAccountEmailAddress בפלט.
```
gcloud sql instances describe INSTANCE_NAME
  
```
משתמשים ב-gcloud storage buckets add-iam-policy-binding כדי להקצות לחשבון השירות את התפקיד ב-IAM storage.objectAdmin. במאמר שימוש בהרשאות IAM מוסבר איך להגדיר הרשאות IAM.
מייצאים את מסד הנתונים לקטגוריה של Cloud Storage:
הערה: אם רוצים להשתמש בייצוא ללא שרת, צריך להשתמש בפרמטר offload. אם רוצים לכלול את הצהרת ה-SQL של DROP <object> שנדרשת כדי להסיר (לנקות) אובייקטים של מסד נתונים לפני שמייבאים אותם, משתמשים בפרמטר clean. אם רוצים לכלול את IF EXISTS הצהרת ה-SQL עם כל הצהרת DROP שנוצרת על ידי הפרמטר clean, צריך להשתמש בפרמטר if-exists.

אם לא, צריך להסיר את הפרמטרים האלה מהפקודה הבאה.
```
gcloud sql export sql INSTANCE_NAME gs://BUCKET_NAME/sqldumpfile.gz \
--database=DATABASE_NAME \
--offload
  
```
הפקודה export sql לא מכילה טריגרים או פרוצדורות מאוחסנות, אבל היא מכילה תצוגות. כדי לייצא טריגרים או פרוצדורות מאוחסנות, משתמשים בכלי pg_dump.

מידע נוסף על השימוש בפקודה export sql זמין בדף העזרה של הפקודה sql export sql.
אם אתם לא צריכים לשמור את תפקיד ה-IAM שהגדרתם קודם, בטלו אותו עכשיו.

REST v1

יוצרים קטגוריה לייצוא:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
השלב הזה לא נדרש, אבל מומלץ מאוד לבצע אותו כדי שלא תהיה גישה לנתונים אחרים.
נותנים למכונה את storage.objectAdmin תפקיד ה-IAM לקטגוריה. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
מייצאים את מסד הנתונים:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫PROJECT_ID: מזהה הפרויקט
- ‫INSTANCE_ID: מזהה המכונה
- ‫BUCKET_NAME: שם הקטגוריה של Cloud Storage
- ‫PATH_TO_DUMP_FILE: הנתיב לקובץ ה-SQL dump
- ‫DATABASE_NAME_1: השם של מסד נתונים במכונה של Cloud SQL
- ‫DATABASE_NAME_2: השם של מסד נתונים במכונה של Cloud SQL
הערה: אם רוצים להשתמש בייצוא בלי שרת (serverless), צריך להשתמש בפרמטר offload. אם רוצים לכלול את הצהרת ה-SQL של DROP <object> שנדרשת כדי להסיר (לנקות) אובייקטים של מסד נתונים לפני שמייבאים אותם, משתמשים בפרמטר clean. אם רוצים לכלול את IF EXISTS הצהרת ה-SQL עם כל הצהרת DROP שנוצרת על ידי הפרמטר clean, צריך להשתמש בפרמטר ifExists.

כדי להשתמש בתכונות האלה, צריך להגדיר את הערכים של הפרמטרים האלה ל-TRUE. אחרת, מגדירים את הערכים שלהם כ-FALSE.
ייצוא ללא שרת כרוך בעלות נוספת. למידע נוסף, תוכלו לעיין במחירון.

ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export
```
תוכן בקשת JSON:
```
{
  "exportContext":
    {
       "fileType": "SQL",
       "uri": "gs://BUCKET_NAME/PATH_TO_DUMP_FILE",
       "databases": ["DATABASE_NAME"],
       "offload": TRUE | FALSE,
       "sqlExportOptions": {
        "clean": [TRUE|FALSE],
        "ifExists": [TRUE|FALSE]
       }
    }
 }
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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/INSTANCE_ID/export"
```
‎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/INSTANCE_ID/export" | 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": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
אם אין לכם צורך לשמור את תפקיד ה-IAM שהגדרתם קודם, אתם יכולים להסיר אותו עכשיו.

הרשימה המלאה של הפרמטרים לבקשה מופיעה בדף instances:export.

REST v1beta4

יוצרים קטגוריה לייצוא:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
השלב הזה לא נדרש, אבל מומלץ מאוד לבצע אותו כדי שלא תהיה גישה לנתונים אחרים.
נותנים למכונה את storage.objectAdmin תפקיד ה-IAM לקטגוריה. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
מייצאים את מסד הנתונים:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫PROJECT_ID: מזהה הפרויקט
- ‫INSTANCE_ID: מזהה המכונה
- ‫BUCKET_NAME: שם הקטגוריה של Cloud Storage
- ‫PATH_TO_DUMP_FILE: הנתיב לקובץ ה-SQL dump
- ‫DATABASE_NAME_1: השם של מסד נתונים במכונה של Cloud SQL
- ‫DATABASE_NAME_2: השם של מסד נתונים במכונה של Cloud SQL
הערה: אם רוצים להשתמש בייצוא בלי שרת (serverless), צריך להשתמש בפרמטר offload. אם רוצים לכלול את הצהרת ה-SQL של DROP <object> שנדרשת כדי להסיר (לנקות) אובייקטים של מסד נתונים לפני שמייבאים אותם, משתמשים בפרמטר clean. אם רוצים לכלול את IF EXISTS הצהרת ה-SQL עם כל הצהרת DROP שנוצרת על ידי הפרמטר clean, צריך להשתמש בפרמטר ifExists.

כדי להשתמש בתכונות האלה, צריך להגדיר את הערכים של הפרמטרים האלה ל-TRUE. אחרת, מגדירים את הערכים שלהם כ-FALSE.
ייצוא ללא שרת כרוך בעלות נוספת. לדף המחירים

ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export
```
תוכן בקשת JSON:
```
{
   "exportContext":
     {
        "fileType": "SQL",
        "uri": "gs://BUCKET_NAME/PATH_TO_DUMP_FILE",
        "databases": ["DATABASE_NAME"],
        "offload": TRUE | FALSE,
        "sqlExportOptions": {
         "clean": [TRUE|FALSE],
         "ifExists": [TRUE|FALSE]
        }
     }
  }
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export"
```
‎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/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export" | 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": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
אם אתם לא צריכים לשמור את תפקיד ה-IAM שהגדרתם קודם, בטלו אותו עכשיו.

הרשימה המלאה של הפרמטרים לבקשה מופיעה בדף instances:export.

ייבוא נתונים ל-Cloud SQL ל-PostgreSQL

התפקידים וההרשאות שנדרשים כדי לייבא ל-Cloud SQL ל-PostgreSQL

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

התפקיד אדמין ב-Cloud SQL
תפקיד בהתאמה אישית, שכולל את ההרשאות הבאות:
- cloudsql.instances.get
- cloudsql.instances.import

בנוסף, לחשבון השירות של מכונת Cloud SQL צריך להיות אחד מהתפקידים הבאים:

תפקיד ה-IAM‏ storage.objectAdmin
תפקיד בהתאמה אישית, כולל ההרשאות הבאות:
- storage.objects.get
- ‫storage.objects.list (לייבוא קבצים במקביל בלבד)

לעזרה בנושא תפקידי IAM, קראו את המאמר ניהול זהויות והרשאות גישה.

ייבוא קובץ SQL מוכן לשימוש ל-Cloud SQL ל-PostgreSQL

קובצי SQL הם קובצי טקסט פשוט עם רצף של פקודות SQL.

המסוף

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

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
לוחצים על Import.
בקטע פורמט קובץ, בוחרים באפשרות SQL.
בקטע Select source file, מזינים את הנתיב לקטגוריה ולקובץ ה-SQL המוכן לשימוש שרוצים לייבא, או מאתרים קובץ קיים או מעלים קובץ מקומי.
אפשר לייבא קובץ דחוס (.gz) או קובץ לא דחוס (.sql).
בקטע Destination, בוחרים את מסד הנתונים שאליו רוצים לייבא את הנתונים.

כך Cloud SQL יריץ את ההצהרה USE DATABASE לפני הייבוא.

אם קובץ ה-SQL המוכן לשימוש כולל הצהרת USE DATABASE, היא מבטלת את מסד הנתונים שהגדרתם במסוף Google Cloud .
אם רוצים לציין משתמש שיבצע את הייבוא, בוחרים את המשתמש.

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

gcloud

יצירת קטגוריה של Cloud Storage
מעלים את הקובץ לקטגוריה.

לקבלת עזרה בהעלאת קבצים לקטגוריות, ראו העלאת אובייקטים.
תיאור המכונה שאליה מייבאים:
```
gcloud sql instances describe INSTANCE_NAME
```
מעתיקים את השדה serviceAccountEmailAddress.
משתמשים ב-gcloud storage buckets add-iam-policy-binding כדי להקצות את תפקיד ה-IAM storage.objectAdmin לחשבון השירות של הקטגוריה.
```
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
  --member=serviceAccount:SERVICE-ACCOUNT \
  --role=roles/storage.objectAdmin
  
```
לקבלת עזרה בהגדרת הרשאות IAM, קראו את המאמר שימוש בהרשאות IAM.
מייבאים את מסד הנתונים:
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/IMPORT_FILE_NAME \
--database=DATABASE_NAME
```
מידע על השימוש בפקודה import sql מופיע בדף העזרה של הפקודה sql import sql.

אם הפקודה מחזירה שגיאה כמו ERROR_RDBMS, בודקים את ההרשאות. השגיאה הזו נגרמת בדרך כלל בגלל בעיות בהרשאות.
אם אתם לא צריכים לשמור את הרשאות ה-IAM שהגדרתם קודם, אתם יכולים להסיר אותן באמצעות gcloud storage buckets remove-iam-policy-binding.

REST v1

יוצרים קובץ SQL מוכן לשימוש. בהוראות המקושרות מוגדרים דגלים מסוימים שמאפשרים להשתמש בקובץ ה-dump ב-Cloud SQL.
- אם אתם מייבאים נתונים משרת PostgreSQL מקומי:
יצירת קטגוריה של Cloud Storage
מעלים את הקובץ לקטגוריה.

לקבלת עזרה בהעלאת קבצים לקטגוריות, אפשר לעיין במאמר העלאת אובייקטים.
נותנים למופע את תפקידי ה-IAM ‏storage.objectAdmin ו-objectViewer לקטגוריה. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
מייבאים את קובץ ה-dump:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫project-id: מזהה הפרויקט
- ‫instance-id: מזהה המכונה
- ‫bucket_name: השם של הקטגוריה של Cloud Storage
- ‫path_to_sql_file: הנתיב לקובץ ה-SQL
- database_name: השם של מסד נתונים בתוך המכונה של Cloud SQL
ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import
```
תוכן בקשת JSON:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://bucket_name/path_to_sql_file",
      "database": "database_name"
    }
}
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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/instance-id/import"
```
‎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/instance-id/import" | 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": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
כדי להשתמש במשתמש אחר לייבוא, צריך לציין את המאפיין importContext.importUser.
הרשימה המלאה של הפרמטרים לבקשה מופיעה בדף instances:import.
אם אתם לא צריכים לשמור את הרשאות ה-IAM שהגדרתם קודם, הסירו אותן עכשיו.

REST v1beta4

יוצרים קובץ SQL מוכן לשימוש. בהוראות המקושרות מוגדרים דגלים מסוימים שמאפשרים להשתמש בקובץ ה-dump ב-Cloud SQL.
- אם מייבאים נתונים משרת PostgreSQL מקומי:
יוצרים קטגוריה של Cloud Storage.
מעלים את הקובץ לקטגוריה.

לקבלת עזרה בהעלאת קבצים לקטגוריות, ראו העלאת אובייקטים.
נותנים למכונה את תפקיד ה-IAM של הקטגוריה storage.objectAdmin. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
מייבאים את קובץ ה-dump:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫project-id: מזהה הפרויקט
- ‫instance-id: מזהה המכונה
- ‫bucket_name: השם של הקטגוריה של Cloud Storage
- ‫path_to_sql_file: הנתיב לקובץ ה-SQL
- database_name: השם של מסד נתונים בתוך המכונה של Cloud SQL
ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import
```
תוכן בקשת JSON:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://bucket_name/path_to_sql_file",
      "database": "database_name"
    }
}
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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/sql/v1beta4/projects/project-id/instances/instance-id/import"
```
‎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/sql/v1beta4/projects/project-id/instances/instance-id/import" | 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": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
כדי להשתמש במשתמש אחר לייבוא, מציינים את המאפיין importContext.importUser.
הרשימה המלאה של הפרמטרים לבקשה מופיעה בדף instances:import.
אם אתם לא צריכים לשמור את הרשאות ה-IAM שהגדרתם קודם, הסירו אותן עכשיו.

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

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

ייצוא נתונים מ-Cloud SQL ל-PostgreSQL

התפקידים וההרשאות שנדרשים כדי לייצא מ-Cloud SQL ל-PostgreSQL

ייצוא לקובץ SQL dump מ-Cloud SQL ל-PostgreSQL

המסוף

gcloud

REST v1

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

‎PowerShell (Windows)

תשובה

REST v1beta4

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

‎PowerShell (Windows)

תשובה

ייבוא נתונים ל-Cloud SQL ל-PostgreSQL

התפקידים וההרשאות שנדרשים כדי לייבא ל-Cloud SQL ל-PostgreSQL

ייבוא קובץ SQL מוכן לשימוש ל-Cloud SQL ל-PostgreSQL

המסוף

gcloud

REST v1

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

‎PowerShell (Windows)

תשובה

REST v1beta4

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

‎PowerShell (Windows)

תשובה

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

ייצוא וייבוא באמצעות קובצי SQL מוכנים לשימוש