יצירה וניהול של מסדי נתונים

‫MySQL   |  PostgreSQL   |  SQL Server

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

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

• ‫information_schema: מאפשר גישה למטא-נתונים של מסד הנתונים, מידע על שרת MySQL.
• ‫mysql: הסכימה של המערכת. היא מכילה טבלאות שמאחסנות מידע שנדרש לשרת MySQL בזמן שהוא פועל.
• ‫performance_schema: תכונה למעקב אחר הביצוע של שרת MySQL ברמה נמוכה.
• ‫sys: מכילה קבוצה של אובייקטים שעוזרים למנהלי מסדי נתונים ולמפתחים לפרש את הנתונים שנאספים על ידי סכימת הביצועים.

מידע נוסף על מסדי נתונים של MySQL זמין במאמרי העזרה של MySQL.

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

לפני שמבצעים את המשימות בדף הזה, צריך:

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

אם אתם מתכננים להשתמש בלקוח mysql כדי ליצור או לנהל את מסדי הנתונים, אתם צריכים:

• הגישה הוגדרה והחיבור למכונה בוצע באמצעות לקוח mysql. מידע נוסף על אפשרויות החיבור זמין במאמר אפשרויות חיבור לאפליקציות חיצוניות.

יצירת מסד נתונים במכונה של Cloud SQL

הערה: האורך המקסימלי של שם מסד הנתונים הוא 64 תווים. מידע נוסף על קריטריונים אחרים לשם הזה זמין במאמר שמות של אובייקטים בסכימה.

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

• ‫MySQL 5.6,‏ 5.7: (נוצר באמצעות מסוף Google Cloud , Cloud SQL Admin API,‏ ה-CLI של gcloud,‏ Terraform או mysql client)
• קבוצת תווים: utf8
• סדר מיון: utf8_general_ci
• ‫MySQL 8.0.x ואילך (נוצר באמצעות מסוף Google Cloud )
• קבוצת תווים: utf8
• סדר מיון: utf8_general_ci
• ‫MySQL 8.0.x ואילך (נוצר באמצעות Cloud SQL Admin API,‏ ה-CLI של gcloud,‏ Terraform או mysql client)
• קבוצת תווים: utf8mb4
• סדר מיון: utf8mb4_0900_ai_ci

אם אתם צריכים לשנות את מערכת התווים או את אוסף הכללים (collation) של מסד הנתונים אחרי שהוא נוצר, תוכלו לעיין במאמר עדכון מערכת התווים ואוסף הכללים (collation) של מסד נתונים.

המסוף

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

   כניסה לדף Cloud SQL Instances

2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
3. בתפריט הניווט של SQL, בוחרים באפשרות מסדי נתונים.
4. לוחצים על יצירת מסד נתונים.
5. בתיבת הדו-שיח יצירת מסד נתונים, מציינים את השם של מסד הנתונים, ואם רוצים, גם את ערכת התווים וההשוואה.

   מידע נוסף על ערכות תווים ומיון זמין במאמר ערכות תווים, מיון, Unicode.

6. לוחצים על יצירה.

gcloud

מידע נוסף זמין במאמר gcloud sql databases create.

מידע נוסף על ערכות תווים ומיון זמין במאמר ערכות תווים, מיון, Unicode.

gcloud sql databases create DATABASE_NAME \
--instance=INSTANCE_NAME \
[--charset=CHARSET] \
[--collation=COLLATION]

Terraform

כדי ליצור מסד נתונים, משתמשים במשאב של Terraform.

resource "google_sql_database" "database" {
  name     = "my-database"
  instance = google_sql_database_instance.instance.name
}

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

כדי להחיל את הגדרות Terraform בפרויקט ב- Google Cloud , מבצעים את השלבים בקטעים הבאים.

הכנת Cloud Shell

1. מפעילים את Cloud Shell.

2. מגדירים את פרויקט ברירת המחדל שבו רוצים להחיל את ההגדרות של Terraform. Google Cloud

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

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

הכנת הספרייה

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

1. יוצרים ספרייה חדשה ב-Cloud Shell ובה יוצרים קובץ חדש. שם הקובץ חייב לכלול את הסיומת .tf, למשל main.tf. במדריך הזה, הקובץ נקרא main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. אם אתם עוקבים אחרי המדריך, תוכלו להעתיק את הקוד לדוגמה בכל קטע או שלב.

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

   לחלופין, אפשר גם להעתיק את הקוד מ-GitHub. כדאי לעשות את זה כשקטע הקוד של Terraform הוא חלק מפתרון מקצה לקצה.

3. בודקים את הפרמטרים לדוגמה ומשנים אותם בהתאם לסביבה שלכם.
4. שומרים את השינויים.
5. מפעילים את Terraform. צריך לעשות זאת רק פעם אחת לכל ספרייה.

   terraform init

   אופציונלי: תוכלו לכלול את האפשרות -upgrade, כדי להשתמש בגרסה העדכנית ביותר של הספק של Google:

   terraform init -upgrade

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

1. בודקים את ההגדרות ומוודאים שהמשאבים שמערכת Terraform תיצור או תעדכן תואמים לציפיות שלכם:

   terraform plan

   מתקנים את ההגדרות לפי הצורך.

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

   terraform apply

   ממתינים עד שב-Terraform תוצג ההודעה "Apply complete!‎".

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

הערה: בדרך כלל הנחת העבודה בדוגמאות של Terraform היא שממשקי ה-API הנדרשים מופעלים ב Google Cloud פרויקט.

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

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

1. כדי להשבית את ההגנה מפני מחיקה, מגדירים בקובץ התצורה של Terraform את הארגומנט deletion_protection לערך false.

   deletion_protection =  "false"

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

   terraform apply

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

   terraform destroy

REST v1

בדוגמה הבאה נעשה שימוש ב-method‏ databases:insert כדי ליצור מסד נתונים חדש במופע שצוין.

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

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה
• ‫database-name: השם של מסד נתונים בתוך מופע Cloud SQL

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

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

תוכן בקשת JSON:

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "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/databases"

‎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/databases" | Select-Object -Expand Content

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

תשובה

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

REST v1beta4

בדוגמה הבאה נעשה שימוש ב-method‏ databases:insert כדי ליצור מסד נתונים חדש במופע שצוין.

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

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה
• ‫database-name: השם של מסד נתונים בתוך מופע Cloud SQL

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

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

תוכן בקשת JSON:

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "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/databases"

‎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/databases" | Select-Object -Expand Content

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

תשובה

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

לקוח MySQL

מידע נוסף מופיע במאמר בנושא CREATE DATABASE במסמכי התיעוד של MySQL.

מידע נוסף על ערכות תווים ומיון זמין במאמר ערכות תווים, מיון, Unicode.

CREATE DATABASE database_name
  [[CHARACTER SET charset_name][COLLATE collation_name]];

הצגת רשימת מסדי הנתונים

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

המסוף

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

   כניסה לדף Cloud SQL Instances

2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
3. בתפריט צד, לוחצים על מסדי נתונים. בדף Databases מופיעה רשימה של מסדי נתונים, לצד סוג האיסוף שלהם, ערכת התווים וסוג מסד הנתונים.

gcloud

מידע נוסף זמין במאמר gcloud sql databases list.

gcloud sql databases list \
--instance=INSTANCE_NAME

REST v1

הבקשה הבאה משתמשת בשיטה databases:list כדי להציג את רשימת מסדי הנתונים של מופע.

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

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

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

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

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

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

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

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases"

‎PowerShell (Windows)

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

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

$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-id/databases" | Select-Object -Expand Content

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

תשובה

{
  "kind": "sql#database",
  "charset": "utf8",
  "collation": "utf8_general_ci",
  "etag": "etag",
  "name": "sys",
  "instance": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/sys",
  "project": "project-id"
}

הערה: ה-API‏ databases.list תומך רק במטענים ייעודיים (payloads) של תגובות שכוללים עד 4 MB של טקסט.

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

REST v1beta4

הבקשה הבאה משתמשת בשיטה databases:list כדי להציג את רשימת מסדי הנתונים של מופע.

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

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

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

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

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

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

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

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

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

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

‎PowerShell (Windows)

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

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

$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-id/databases" | Select-Object -Expand Content

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

תשובה

{
  "kind": "sql#database",
  "charset": "utf8",
  "collation": "utf8_general_ci",
  "etag": "etag",
  "name": "sys",
  "instance": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/sys",
  "project": "project-id"
}

הערה: ה-API‏ databases.list תומך רק במטענים ייעודיים (payloads) של תגובות שכוללים עד 4 MB של טקסט.

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

לקוח MySQL

מידע נוסף מופיע במאמר SHOW DATABASES במסמכי העזרה של MySQL.

SHOW DATABASES;

מחיקה של מסד נתונים

כדי למחוק מסד נתונים במופע Cloud SQL:

המסוף

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

   כניסה לדף Cloud SQL Instances

2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
3. בתפריט צד, לוחצים על מסדי נתונים.
4. ברשימת מסדי הנתונים, מוצאים את מסד הנתונים שרוצים למחוק ולוחצים על סמל האשפה.
5. בתיבת הדו-שיח מחיקת מסד נתונים, מזינים את שם מסד הנתונים ולוחצים על מחיקה.

הערה: מחיקה של מסד נתונים מסירה את כל הקבצים בספרייה של מסד הנתונים, כולל קבצים שלא נמצאים בשימוש ישיר על ידי מסד הנתונים. דוגמאות לקבצים כאלה הם #sql-* קבצים שנוצרו מפעולות ALTER TABLE שהופסקו ב-MySQL 5.6 וב-MySQL 5.7.

gcloud

מידע נוסף זמין במאמר gcloud sql databases delete.

gcloud sql databases delete DATABASE_NAME \
--instance=INSTANCE_NAME

הערה: מחיקה של מסד נתונים מסירה את כל הקבצים בספרייה של מסד הנתונים, כולל קבצים שלא נמצאים בשימוש ישיר על ידי מסד הנתונים. דוגמאות לקבצים כאלה הם קבצי #sql-* שנוצרו מפעולות ALTER TABLE שהופסקו ב-MySQL 5.6 וב-MySQL 5.7.

REST v1

בדוגמה הבאה של בקשה נעשה שימוש בשיטה databases:delete כדי למחוק את מסד הנתונים שצוין.

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

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה
• ‫database-name: השם של מסד נתונים בתוך מופע Cloud SQL

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

DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name

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

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

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

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

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name"

‎PowerShell (Windows)

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

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

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name" | Select-Object -Expand Content

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

תשובה

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

REST v1beta4

בדוגמה הבאה של בקשה נעשה שימוש בשיטה databases:delete כדי למחוק את מסד הנתונים שצוין.

הערה: מחיקה של מסד נתונים מסירה את כל הקבצים בספרייה של מסד הנתונים, כולל קבצים שלא נמצאים בשימוש ישיר על ידי מסד הנתונים. דוגמאות לקבצים כאלה הן קובצי #sql-* שנוצרו מפעולות ALTER TABLE שהופסקו ב-MySQL 5.6 וב-MySQL 5.7.

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

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה
• ‫database-name: השם של מסד נתונים בתוך מופע Cloud SQL

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

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name

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

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

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

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

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name"

‎PowerShell (Windows)

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

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

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name" | Select-Object -Expand Content

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

תשובה

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

לקוח MySQL

מידע נוסף מופיע במאמר DROP DATABASE במסמכי התיעוד של MySQL.

DROP DATABASE [database_name];

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

• שגיאה בהסרת מסד נתונים (אי אפשר להשתמש בפקודה rmdir './database_name', errno: 39)
• שגיאה בהסרת מסד נתונים (אי אפשר להשתמש בפקודה rmdir './database_name', errno: 17)

דוגמאות לקבצים כאלה הם קבצי #sql-* שנוצרו מפעולות ALTER TABLE שהופסקו ב-MySQL 5.6 וב-MySQL 5.7. כדי למחוק את הקבצים האלה ולהשלים את הפעולה DROP DATABASE, צריך לחזור על הפעולה באמצעות אחת מהשיטות האחרות: המסוף, הפקודה gcloud או קריאת API בארכיטקטורת REST.

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

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