סקירה כללית
בדף הזה מוסבר איך להשתמש ב-Database Migration Service API כדי לנהל פרופילי חיבור למסד נתונים של PostgreSQL כמקור ול-AlloyDB כיעד.
יש שתי דרכים להשתמש ב-API של Database Migration Service. אפשר לבצע קריאות ל-API בארכיטקטורת REST או להשתמש ב-Google Cloud CLI (CLI).
כדי לראות מידע כללי על השימוש ב-gcloud לניהול פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.
יצירת פרופיל חיבור למסד נתונים של PostgreSQL
בדוגמה הבאה מוצגת בקשה ליצירת פרופיל חיבור למסד נתונים של PostgreSQL כמקור.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
- connection-profile-display-name: השם המוצג של פרופיל החיבור
- host-ip-address: כתובת ה-IP של המקור
- username: שם המשתמש במסד הנתונים
- password: הסיסמה של משתמש מסד הנתונים
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
תוכן בקשת JSON:
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כדי לראות מידע כללי על השימוש ב-gcloud ליצירת פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.
אחרי שיוצרים את פרופיל החיבור, אפשר לראות את המידע עליו באמצעות הקריאה לשיטה connectionProfiles/get.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
ה-method של ה-HTTP וכתובת ה-URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
gcloud
מידע נוסף על שימוש ב-gcloud כדי לאחזר מידע על פרופיל החיבור זמין כאן.
יצירת פרופיל חיבור למסד נתונים של Cloud SQL ל-PostgreSQL
בדוגמה הבאה מוצגת בקשה ליצירת פרופיל חיבור למסד נתונים של Cloud SQL ל-PostgreSQL כמקור. בדוגמה הזו נעשה שימוש בפרופיל חיבור של PostgreSQL כי הוא מתחבר למנוע מסד הנתונים של PostgreSQL ולא לשכבת הניהול של Cloud SQL.
כדי ליצור את ההתאמה בין המקור לבין העותק באמצעות Cloud SQL, צריך לספק את מזהה המכונה של מסד הנתונים ב-Cloud SQL. אפשר למצוא את הערך של מזהה המופע באמצעות ה-method databases/list של Cloud SQL Admin API.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
- connection-profile-display-name: השם המוצג של פרופיל החיבור
- host-ip-address: כתובת ה-IP של המקור
- username: שם המשתמש במסד הנתונים
- password: הסיסמה של משתמש מסד הנתונים
- cloud-sql-instance-id: מזהה מופע Cloud SQL
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
תוכן בקשת JSON:
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כדי לראות מידע כללי על השימוש ב-gcloud ליצירת פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.
יצירת פרופיל חיבור ליעד AlloyDB ל-PostgreSQL
בדוגמה הבאה מוצגת בקשה ליצירת פרופיל חיבור ליעד AlloyDB ל-PostgreSQL. Database Migration Service משתמש במידע שבבקשה הזו כדי ליצור מכונת AlloyDB חדשה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
- connection-profile-display-name: השם המוצג של פרופיל החיבור
- cluster-id: מזהה אשכול AlloyDB שרוצים ליצור
- user: שם המשתמש שרוצים לתת למשתמש הראשוני
- password: הסיסמה שמוקצית למשתמש הראשוני
- vpc-network: רשת ה-VPC שאליה יתחבר אשכול AlloyDB
- instance-id: מזהה מופע AlloyDB שרוצים ליצור
- cpu-count: מספר יחידות ה-CPU להגדרת המכונה
כל הנתונים שמאוחסנים ב- Google Cloud מוצפנים במצב לא פעיל באמצעות אותן מערכות מוקשחות לניהול מפתחות שבהן אנחנו משתמשים לנתונים המוצפנים שלנו. מערכות ניהול המפתחות האלה מספקות בקרות גישה מחמירות למפתחות וביקורת, ומצפינות את נתוני המשתמשים באחסון במצב מנוחה באמצעות תקני הצפנה של AES-256. לא נדרשת הגדרה, קביעת תצורה או ניהול. Google Cloudההצפנה במנוחה שמוגדרת כברירת מחדל היא הבחירה הטובה ביותר למשתמשים שאין להם דרישות ספציפיות שקשורות לתאימות או למיקום של חומר קריפטוגרפי.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
תוכן בקשת JSON:
{
"displayName": "connection-profile-display-name",
"alloydb": {
"cluster_id": "cluster-id"
"settings": {
"initial_user": {
"user": "user",
"password": "password",
}
"vpc_network": "vpc-network",
"primary_instance_settings": {
"id": "instance-id",
"machine_config": {
"cpu_count": cpu-count
}
}
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T15:25:57.430715421Z",
"target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כדי לראות מידע כללי על השימוש ב-gcloud ליצירת פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.
קבלת מידע על פרופיל חיבור
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
ה-method של ה-HTTP וכתובת ה-URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
gcloud
מידע נוסף על שימוש ב-gcloud כדי לאחזר מידע על פרופיל החיבור זמין כאן.
הצגת רשימה של פרופילי קישור
בדוגמה הבאה מוצגת בקשה לאחזור מידע על כל פרופילי החיבור שלכם.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
orderBy:אפשר להשתמש במסנן הזה כדי לאחזר רשימה של כל פרופילי החיבור לאזור מסוים, לפי סדר אלפביתי. לדוגמה, המסנןorderBy=nameמחזיר את כל פרופילי החיבור, לפי סדר אלפביתי של השם.-
pageSize:משתמשים במסנן הזה כדי לציין את המספר המקסימלי של פרופילי חיבור ש-Database Migration Service מאחזר ומציג בדף. לדוגמה, אם מגדירים את הערךpageSize=10, Database Migration Service יחזיר עד 10 פרופילים של חיבורים לדף.
אם יש יותר מ-10 פרופילים של חיבורים, הם יופיעו בדפים אחרים. בסוף כל דף מופיעים פרמטר nextPageToken ומזהה ייחודי. משתמשים במזהה כדי לאחזר את רשימת פרופילי החיבור בדף הבא.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
gcloud
כאן אפשר לקבל מידע נוסף על השימוש ב-gcloud כדי לאחזר מידע על כל פרופילי החיבור.
עדכון פרופיל קישור
בדוגמה הבאה מוצגת בקשה לעדכון השדות של שם המשתמש והסיסמה בפרופיל חיבור קיים. כשמשתמשים בפרמטר updateMask בבקשה, צריך לכלול בגוף הבקשה רק את השדות האלה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
- username: שם המשתמש במסד הנתונים
- password: הסיסמה של משתמש מסד הנתונים
ה-method של ה-HTTP וכתובת ה-URL:
PATCH
תוכן בקשת JSON:
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כאן אפשר לקרוא מידע נוסף על שימוש ב-gcloud כדי לעדכן את פרופיל החיבור.
מחיקת פרופיל קישור
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud למחיקת פרופיל החיבור זמין כאן.
מחיקה של פרופיל קישור ומופע AlloyDB משויך
בדוגמה הבאה מוצגת בקשה למחיקת פרופיל חיבור ליעד, וגם מחיקה מדורגת של מופע AlloyDB המשויך.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- connection-profile-id: מזהה פרופיל החיבור
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud כדי למחוק את פרופיל החיבור ואת מופע AlloyDB המשויך זמין כאן.