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

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

ייצוא וייבוא של קבצים במקביל

MySQL | PostgreSQL

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

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

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

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

לפני שמתחילים פעולת ייצוא או ייבוא:

מוודאים שיש מספיק מקום פנוי במסד הנתונים.

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

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

ייצוא נתונים מ-Cloud SQL ל-MySQL למספר קבצים במקביל

בקטעים הבאים מוסבר איך לייצא נתונים מ-Cloud SQL ל-MySQL לכמה קבצים במקביל.

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

כדי לייצא נתונים מ-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, קראו את המאמר ניהול זהויות והרשאות גישה.

ייצוא נתונים לכמה קבצים במקביל

אתם יכולים לייצא נתונים במקביל מכמה קבצים שנמצאים ב-Cloud SQL אל Cloud Storage. הפונקציה gcloud sql export עם הדגל -parallel משתמשת בכלי dumpInstance כדי לייצא מכמה קבצים.

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

אם הקבצים מכילים משפטי DEFINER (תצוגות, טריגרים, stored_procedures וכו'), יכול להיות שהייבוא של הקבצים האלה ייכשל, בהתאם לסדר שבו ההצהרות האלה מופעלות. DEFINER מוסבר איך משתמשים ב-DEFINER ב-Cloud SQL ואיך אפשר לעקוף את הבעיה.

gcloud

כדי לייצא נתונים מ-Cloud SQL לכמה קבצים במקביל:

יצירת קטגוריה של Cloud Storage.
הערה: לא חייבים ליצור תיקייה בקטגוריה. אם התיקייה לא קיימת, Cloud SQL יוצר אותה כחלק מתהליך הייצוא של כמה קבצים במקביל. עם זאת, אם התיקייה קיימת, היא חייבת להיות ריקה, אחרת פעולת הייצוא תיכשל.
כדי למצוא את חשבון השירות של מכונת Cloud SQL שממנה אתם מייצאים קבצים, משתמשים בפקודה
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

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

בפלט, מחפשים את הערך שמשויך לשדה serviceAccountEmailAddress.

כדי להקצות לחשבון השירות את תפקיד ה-IAM storage.objectAdmin, משתמשים בפקודה gcloud storage buckets add-iam-policy-binding. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
כדי לייצא נתונים מ-Cloud SQL לכמה קבצים במקביל, משתמשים בפקודה gcloud sql export sql:
```
gcloud sql export sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--offload \
--parallel \
--threads=THREAD_NUMBER \
--database=DATABASE_NAME \
--table=TABLE_EXPRESSION
```
מחליפים את הפרטים הבאים:
- ‫INSTANCE_NAME: השם של מכונת Cloud SQL שממנה מייצאים קבצים במקביל.
- ‫BUCKET_NAME: השם של הקטגוריה ב-Cloud Storage.
- ‫BUCKET_PATH: הנתיב לקטגוריה שבה מאוחסנים קובצי הייצוא.
- ‫FOLDER_NAME: התיקייה שבה מאוחסנים קובצי הייצוא.
- ‫THREAD_NUMBER: מספר השרשורים שבהם Cloud SQL משתמש כדי לייצא קבצים במקביל. לדוגמה, אם רוצים לייצא שלושה קבצים בו-זמנית, מציינים 3 כערך של הפרמטר הזה.
- ‫DATABASE_NAME (אופציונלי): השם של מסדי הנתונים בתוך המכונה של Cloud SQL שממנה מתבצע הייצוא. אם לא תציינו מסדי נתונים, Cloud SQL ייצא את כל מסדי הנתונים של המכונה.
- ‫TABLE_EXPRESSION: הטבלאות שרוצים לייצא ממסד הנתונים שצוין.
הערה: אם רוצים להשתמש בייצוא ללא שרת (serverless) של עד 2 שרשורים, צריך להשתמש בפרמטר offload. כדי לייצא כמה קבצים במקביל, משתמשים בפרמטר parallel. אחרת, צריך להסיר את הפרמטרים האלה מהפקודה.

הפקודה export sql לא מכילה טריגרים או פרוצדורות מאוחסנות, אבל מכילה תצוגות. כדי לייצא טריגרים או פרוצדורות מאוחסנות, צריך להשתמש בשרשור אחד לייצוא. בשרשור הזה נעשה שימוש בכלי mysqldump.

בסיום הייצוא, הקבצים אמורים להופיע בתיקייה בקטגוריה של Cloud Storage בפורמט של MySQL Shell dump.
אם אתם לא צריכים את תפקיד ה-IAM שהגדרתם בקטע התפקידים וההרשאות הנדרשים לייצוא מ-Cloud SQL ל-MySQL, אתם יכולים לבטל אותו.

REST v1

כדי לייצא נתונים מ-Cloud SQL לכמה קבצים במקביל:

יוצרים קטגוריה של Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
מבצעים את ההחלפות הבאות:
- ‫BUCKET_NAME: השם של הקטגוריה, בכפוף לדרישות למתן שמות. לדוגמה, my-bucket.
- ‫PROJECT_NAME: שם הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה של Cloud Storage שאתם יוצרים.
- ‫LOCATION_NAME: המיקום של הקטגוריה שבה רוצים לאחסן את הקבצים שמייצאים. לדוגמה, us-east1.
הערה: לא חייבים ליצור תיקייה בקטגוריה. אם התיקייה לא קיימת, Cloud SQL יוצר אותה כחלק מתהליך הייצוא של כמה קבצים במקביל. עם זאת, אם התיקייה קיימת, היא חייבת להיות ריקה, אחרת פעולת הייצוא תיכשל.
מקצים למכונה את storage.objectAdmin תפקיד ה-IAM לקטגוריה. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
ייצוא נתונים מ-Cloud SQL לכמה קבצים במקביל:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫PROJECT_NAME: השם של הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה שיצרתם ב-Cloud Storage.
- ‫INSTANCE_NAME: השם של מכונת Cloud SQL שממנה מייצאים קבצים במקביל.
- ‫BUCKET_NAME: השם של הקטגוריה ב-Cloud Storage.
- ‫BUCKET_PATH: הנתיב לקטגוריה שבה מאוחסנים קובצי הייצוא.
- ‫FOLDER_NAME: התיקייה שבה מאוחסנים קובצי הייצוא.
- ‫DATABASE_NAME (אופציונלי): השם של מסדי הנתונים בתוך המכונה של Cloud SQL שממנה מתבצע הייצוא. אם לא תציינו מסדי נתונים, Cloud SQL ייצא את כל מסדי הנתונים של המכונה.
- ‫THREAD_NUMBER: מספר השרשורים שבהם Cloud SQL משתמש כדי לייצא קבצים במקביל. לדוגמה, אם רוצים לייצא שלושה קבצים בו-זמנית, מציינים 3 כערך של הפרמטר הזה.
הערה: הפרמטר offload מאפשר להשתמש בייצוא בלי שרת (serverless) לעד 2 שרשורים. הפרמטר parallel מאפשר לייצא כמה קבצים במקביל. כדי להשתמש בתכונות האלה, צריך להגדיר את הערכים של הפרמטרים האלה בתור TRUE. אחרת, מגדירים את הערכים שלהם כ-FALSE.

ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
תוכן בקשת JSON:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/export" | Select-Object -Expand Content
```
אתם אמורים לקבל תגובת JSON שדומה לזו:
תשובה
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/DESTINATION_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_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

בסיום הייצוא, הקבצים אמורים להופיע בתיקייה בקטגוריה של Cloud Storage בפורמט של MySQL Shell dump.

אם אתם לא צריכים את תפקיד ה-IAM שהגדרתם בקטע התפקידים וההרשאות הנדרשים לייצוא מ-Cloud SQL ל-MySQL, אתם יכולים לבטל אותו.

הרשימה המלאה של הפרמטרים לבקשה מופיעה בדף Cloud SQL Admin API.

‫REST v1beta4

כדי לייצא נתונים מ-Cloud SQL לכמה קבצים במקביל:

יוצרים קטגוריה של Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
מבצעים את ההחלפות הבאות:
- ‫BUCKET_NAME: השם של הקטגוריה, בכפוף לדרישות למתן שמות. לדוגמה, my-bucket.
- ‫PROJECT_NAME: שם הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה של Cloud Storage שאתם יוצרים.
- ‫LOCATION_NAME: המיקום של הקטגוריה שבה רוצים לאחסן את הקבצים שמייצאים. לדוגמה, us-east1.
הערה: לא חייבים ליצור תיקייה בקטגוריה. אם התיקייה לא קיימת, Cloud SQL יוצר אותה כחלק מתהליך הייצוא של כמה קבצים במקביל. עם זאת, אם התיקייה קיימת, היא חייבת להיות ריקה, אחרת פעולת הייצוא תיכשל.
מקצים למכונה את storage.objectAdmin תפקיד ה-IAM לקטגוריה. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
ייצוא נתונים מ-Cloud SQL לכמה קבצים במקביל:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫PROJECT_NAME: השם של הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה שיצרתם ב-Cloud Storage.
- ‫INSTANCE_NAME: השם של מכונת Cloud SQL שממנה מייצאים קבצים במקביל.
- ‫BUCKET_NAME: השם של הקטגוריה ב-Cloud Storage.
- ‫BUCKET_PATH: הנתיב לקטגוריה שבה מאוחסנים קובצי הייצוא.
- ‫FOLDER_NAME: התיקייה שבה מאוחסנים קובצי הייצוא.
- ‫DATABASE_NAME (אופציונלי): השם של מסדי הנתונים בתוך המכונה של Cloud SQL שממנה מתבצע הייצוא. אם לא תציינו מסדי נתונים, Cloud SQL ייצא את כל מסדי הנתונים של המכונה.
- ‫THREAD_NUMBER: מספר השרשורים שבהם Cloud SQL משתמש כדי לייצא קבצים במקביל. לדוגמה, אם רוצים לייצא שלושה קבצים בו-זמנית, מציינים 3 כערך של הפרמטר הזה.
הערה: הפרמטר offload מאפשר להשתמש בייצוא בלי שרת (serverless) לעד 2 שרשורים. הפרמטר parallel מאפשר לייצא כמה קבצים במקביל. כדי להשתמש בתכונות האלה, צריך להגדיר את הערכים של הפרמטרים האלה בתור TRUE. אחרת, מגדירים את הערכים שלהם כ-FALSE.

ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
תוכן בקשת JSON:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/export" | Select-Object -Expand Content
```
אתם אמורים לקבל תגובת JSON שדומה לזו:
תשובה
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/DESTINATION_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_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

בסיום הייצוא, הקבצים אמורים להופיע בתיקייה בקטגוריה של Cloud Storage בפורמט של MySQL Shell dump.

אם אתם לא צריכים את תפקיד ה-IAM שהגדרתם בקטע התפקידים וההרשאות הנדרשים לייצוא מ-Cloud SQL ל-MySQL, אתם יכולים לבטל אותו.

הרשימה המלאה של הפרמטרים לבקשה מופיעה בדף Cloud SQL Admin API.

ייבוא נתונים ממספר קבצים במקביל ל-Cloud SQL ל-MySQL

בקטעים הבאים מוסבר איך לייבא נתונים ממספר קבצים במקביל ל-Cloud SQL ל-MySQL.

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

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

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

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

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

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

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

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

gcloud

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

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

הערה: חשוב לוודא שהקבצים שאתם מעלים הם בפורמט של MySQL Shell dump. מידע נוסף זמין במאמר ייצוא נתונים מכמה קבצים במקביל.

לקבלת עזרה בהעלאת קבצים לקטגוריות, ראו העלאת אובייקטים מקבצים.
כדי למצוא את חשבון השירות של מכונת Cloud SQL שאליה מייבאים קבצים, משתמשים בפקודה
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

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

בפלט, מחפשים את הערך שמשויך לשדה serviceAccountEmailAddress.

כדי להקצות לחשבון השירות את תפקיד ה-IAM storage.objectAdmin, משתמשים בכלי gcloud storage buckets add-iam-policy-binding. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.
כדי לייבא נתונים מכמה קבצים במקביל ל-Cloud SQL, משתמשים בפקודה gcloud sql import sql:
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--parallel \
--threads=THREAD_NUMBER \
--database=DATABASE_NAME
```
מחליפים את הפרטים הבאים:
- ‫INSTANCE_NAME: השם של מכונת Cloud SQL שאליה מייבאים קבצים במקביל.
- ‫BUCKET_NAME: השם של הקטגוריה ב-Cloud Storage.
- ‫BUCKET_PATH: הנתיב לקטגוריה שבה מאוחסנים קובצי הייבוא.
- ‫FOLDER_NAME: התיקייה שבה מאוחסנים קובצי הייבוא.
- ‫THREAD_NUMBER: מספר השרשורים שבהם Cloud SQL משתמש כדי לייבא קבצים במקביל. לדוגמה, אם רוצים לייבא שלושה קבצים בו-זמנית, מציינים 3 כערך של הפרמטר הזה.
- ‫DATABASE_NAME (אופציונלי): השם של מסדי הנתונים בתוך המכונה של Cloud SQL שממנה מתבצע הייבוא. אם לא תציינו מסדי נתונים, Cloud SQL ייבא את כל מסדי הנתונים של המכונה.
הערה: אם רוצים לייבא כמה קבצים במקביל, משתמשים בפרמטר parallel.

אחרת, צריך להסיר את הפרמטרים האלה מהפקודה.

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

REST v1

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

יוצרים קטגוריה של Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
מבצעים את ההחלפות הבאות:
- ‫BUCKET_NAME: השם של הקטגוריה, בכפוף לדרישות למתן שמות. לדוגמה, my-bucket.
- ‫PROJECT_NAME: שם הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה של Cloud Storage שאתם יוצרים.
- ‫LOCATION_NAME: המיקום של הקטגוריה שבה רוצים לאחסן את הקבצים שמייבאים. לדוגמה, us-east1.
מעלים את הקבצים לקטגוריה.

הערה: חשוב לוודא שהקבצים שאתם מעלים הם בפורמט של MySQL Shell dump. מידע נוסף זמין במאמר ייצוא נתונים מכמה קבצים במקביל.

לקבלת עזרה בהעלאת קבצים לקטגוריות, ראו העלאת אובייקטים מקבצים.
נותנים למכונה את תפקיד ה-IAM storage.objectAdmin לקטגוריה. לקבלת עזרה בהגדרת הרשאות IAM, קראו את המאמר שימוש בהרשאות IAM.
ייבוא נתונים ממספר קבצים במקביל ל-Cloud SQL:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫PROJECT_NAME: השם של הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה שיצרתם ב-Cloud Storage.
- ‫INSTANCE_NAME: השם של מכונת Cloud SQL שאליה מייבאים קבצים במקביל.
- ‫BUCKET_NAME: השם של הקטגוריה ב-Cloud Storage.
- ‫BUCKET_PATH: הנתיב לקטגוריה שבה מאוחסנים קובצי הייבוא.
- ‫FOLDER_NAME: התיקייה שבה מאוחסנים קובצי הייבוא.
- ‫DATABASE_NAME (אופציונלי): השם של מסדי הנתונים בתוך המכונה של Cloud SQL שממנה מתבצע הייבוא. אם לא תציינו מסדי נתונים, Cloud SQL ייבא את כל מסדי הנתונים של המכונה.
- ‫THREAD_NUMBER: מספר השרשורים שבהם Cloud SQL משתמש כדי לייבא קבצים במקביל. לדוגמה, אם רוצים לייבא שלושה קבצים בו-זמנית, מציינים 3 כערך של הפרמטר הזה.
הערה: הפרמטר offload מאפשר להשתמש בייבוא ללא שרת (serverless) של עד 2 שרשורים. הפרמטר parallel מאפשר לייבא כמה קבצים במקביל.

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

ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
תוכן בקשת JSON:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlImportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/import" | Select-Object -Expand Content
```
אתם אמורים לקבל תגובת JSON שדומה לזו:
תשובה
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/DESTINATION_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_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
רשימת הפרמטרים המלאה של הבקשה מופיעה בדף Cloud SQL Admin API.
אם אתם לא צריכים את ההרשאות ב-IAM שהגדרתם בקטע התפקידים וההרשאות שנדרשים לייבוא ל-Cloud SQL ל-MySQL, אתם יכולים להשתמש ב-gcloud storage buckets remove-iam-policy-binding כדי להסיר אותן.

‫REST v1beta4

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

יוצרים קטגוריה של Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
מבצעים את ההחלפות הבאות:
- ‫BUCKET_NAME: השם של הקטגוריה, בכפוף לדרישות למתן שמות. לדוגמה, my-bucket.
- ‫PROJECT_NAME: שם הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה של Cloud Storage שאתם יוצרים.
- ‫LOCATION_NAME: המיקום של הקטגוריה שבה רוצים לאחסן את הקבצים שמייבאים. לדוגמה, us-east1.
מעלים את הקבצים לקטגוריה.

הערה: חשוב לוודא שהקבצים שאתם מעלים הם בפורמט של MySQL Shell dump. מידע נוסף זמין במאמר ייצוא נתונים מכמה קבצים במקביל.

לקבלת עזרה בהעלאת קבצים לקטגוריות, ראו העלאת אובייקטים מקבצים.
נותנים למכונה את תפקיד ה-IAM storage.objectAdmin לקטגוריה. לקבלת עזרה בהגדרת הרשאות IAM, קראו את המאמר שימוש בהרשאות IAM.
ייבוא נתונים ממספר קבצים במקביל ל-Cloud SQL:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- ‫PROJECT_NAME: השם של הפרויקט ב- Cloud de Confiance by S3NS שמכיל את הקטגוריה שיצרתם ב-Cloud Storage.
- ‫INSTANCE_NAME: השם של מכונת Cloud SQL שממנה מייבאים קבצים במקביל.
- ‫BUCKET_NAME: השם של הקטגוריה ב-Cloud Storage.
- ‫BUCKET_PATH: הנתיב לקטגוריה שבה מאוחסנים קובצי הייבוא.
- ‫FOLDER_NAME: התיקייה שבה מאוחסנים קובצי הייבוא.
- ‫DATABASE_NAME (אופציונלי): השם של מסדי הנתונים בתוך המכונה של Cloud SQL שממנה מתבצע הייבוא. אם לא תציינו מסדי נתונים, Cloud SQL ייבא את כל מסדי הנתונים של המכונה.
- ‫THREAD_NUMBER: מספר השרשורים שבהם Cloud SQL משתמש כדי לייבא קבצים במקביל. לדוגמה, אם רוצים לייבא שלושה קבצים בו-זמנית, מציינים 3 כערך של הפרמטר הזה.
הערה: הפרמטר offload מאפשר להשתמש בייבוא ללא שרת (serverless) של עד 2 שרשורים. הפרמטר parallel מאפשר לייבא כמה קבצים במקביל.

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

ה-method של ה-HTTP וכתובת ה-URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
תוכן בקשת JSON:
```
{
  "importContext":
    {
       "fileType": "SQL",
       "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
       "databases": ["DATABASE_NAME"],
       "offload": [TRUE|FALSE],
       "sqlImportOptions": {
         "parallel": [TRUE|FALSE],
         "threads": [THREAD_NUMBER]
        }
    }
 }
 
```
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
‫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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/import" | Select-Object -Expand Content
```
אתם אמורים לקבל תגובת JSON שדומה לזו:
תשובה
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/DESTINATION_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_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
רשימת הפרמטרים המלאה של הבקשה מופיעה בדף Cloud SQL Admin API.
אם אתם לא צריכים את ההרשאות ב-IAM שהגדרתם בקטע התפקידים וההרשאות שנדרשים לייבוא ל-Cloud SQL ל-MySQL, אתם יכולים להשתמש ב-gcloud storage buckets remove-iam-policy-binding כדי להסיר אותן.

מגבלות

אם תציינו יותר מדי שרשורים כשאתם מייבאים או מייצאים נתונים מכמה קבצים במקביל, יכול להיות שתשתמשו ביותר זיכרון ממה שיש במכונה של Cloud SQL. במקרה כזה, תופיע הודעת שגיאה פנימית. בודקים את השימוש בזיכרון של המכונה ומגדילים את המכונה לפי הצורך. מידע נוסף זמין במאמר מידע על הגדרות המכונה.
כשמבצעים ייצוא, אי אפשר להשתמש בפסיקים בשמות של מסדי נתונים או בשמות של טבלאות בשדות databases או tables.
חשוב לוודא שיש מספיק מקום בכונן להורדה הראשונית של קובץ ה-dump. אחרת, תופיע השגיאה no space left on disk.
אם למכונה יש רק מעבד וירטואלי (vCPU) אחד, אי אפשר לייבא או לייצא כמה קבצים במקביל. מספר המעבדים הווירטואליים של המכונה לא יכול להיות קטן ממספר הליכי המשנה שבהם אתם משתמשים לפעולת הייבוא או הייצוא, ומספר הליכי המשנה חייב להיות לפחות שניים.
ייבוא וייצוא מרובי-תהליכים (מקבילים) לא תואמים לייבוא וייצוא עם תהליך יחיד. לדוגמה, קובצי dump שנוצרו על ידי ייצוא עם שרשור יחיד אפשר לייבא רק באמצעות ייבוא עם שרשור יחיד. באופן דומה, קובצי dump שנוצרו על ידי ייצוא מקבילי יכולים להיות מיובאים רק על ידי ייבוא מקבילי.

אם תכתבו הצהרות של שפת הגדרת נתונים (DDL) כמו CREATE,‏ DROP או ALTER במהלך פעולת ייצוא, יכול להיות שהפעולה תיכשל או שהנתונים שייוצאו לא יהיו עקביים עם קובץ ה-snapshot של שחזור המערכת מנקודה מסוימת בזמן (PITR).
אם פעולת הייבוא נכשלת, יכול להיות שיישארו נתונים שיובאו באופן חלקי. ‫MySQL מבצע הצהרות DDL באופן אוטומטי. במקרה כזה, לפני שמייבאים שוב את הנתונים, צריך לנקות את הצהרות ה-DDL ואת הנתונים.
בדומה לפעולת ייבוא מקבילה של מסד נתונים יחיד, לפני שמריצים פעולת ייבוא מקבילה של מכונה שלמה, צריך לוודא שכל מסדי הנתונים נוצרו.

ייצוא וייבוא של קבצים במקביל

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

ייצוא נתונים מ-Cloud SQL ל-MySQL למספר קבצים במקביל

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

ייצוא נתונים לכמה קבצים במקביל

gcloud

REST v1

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

‎PowerShell (Windows)

תשובה

‫REST v1beta4

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

‎PowerShell (Windows)

תשובה

ייבוא נתונים ממספר קבצים במקביל ל-Cloud SQL ל-MySQL

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

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

gcloud

REST v1

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

‎PowerShell (Windows)

תשובה

‫REST v1beta4

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

‎PowerShell (Windows)

תשובה

מגבלות

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