אתם יכולים להשתמש ב-Datastream API כדי ליצור, לאחזר, להציג ולמחוק הגדרות של חיבור מבודד. ההגדרות האלה מאפשרות ל-Datastream לתקשר באופן פרטי עם מקורות נתונים ב- Google Cloud או עם מקורות חיצוניים שמחוברים דרך Cloud VPN או Cloud Interconnect. אתם יכולים ליצור קישוריות פרטית באמצעות קישור בין רשתות VPC או ממשק Private Service Connect.
כדי להשתמש בחיבור פרטי, הסטרימינג, הפרופילים של החיבורים וההגדרות של הקישוריות הפרטית צריכים להיות באותו אזור. כדי להימנע מהוספה ידנית של כללי חומת אש חוצי-אזורים, צריך להריץ את מסד הנתונים של המקור ברשת משנה באותו אזור.
יצירת הגדרת חיבור מבודד באמצעות קישור בין רשתות VPC שכנות (peering)
לפני שיוצרים הגדרה של קישוריות פרטית, חשוב לוודא ש:
- רשת VPC לקישור לרשת הפרטית של Datastream. מידע נוסף על יצירת רשת VPC זמין במאמר שימוש ב-VPC Network Peering.
- טווח כתובות IP זמין (עם בלוק CIDR של /29 לפחות) ברשת ה-VPC. Datastream משתמש בטווח ה-IP הזה כדי ליצור קישור בין רשתות שכנות (peering) של VPC עם ה-VPC שצוין, כך שהטווח לא יכול לחפוף לתת-רשתות בתוך ה-VPC הזה. כתוצאה מכך, Datastream יכול לתקשר עם המקור.
יש שני פרמטרים שמשויכים ליצירת הגדרה של חיבור מבודד:
-
vpcName:מציינים את השם והנתיב של רשת ה-VPC. -
subnet:מציינים טווח כתובות IP זמין ברשת ה-VPC.
הקוד הבא מציג בקשה ליצירת הגדרת קישוריות פרטית, ומציין את שיטת הקישוריות כשימוש ב-VPC Peering (vpcPeeringConfig).
REST
POST https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID { "displayName": "DISPLAY_NAME", "vpcPeeringConfig": { "vpcName": "VPC_NAME", "subnet": "SUBNET" } }
לדוגמה:
POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
"displayName": "my-private-connection",
"vpcPeeringConfig": {
"vpcName": "projects/my-project/global/networks/my-vpc",
"subnet": "10.11.12.13/29"
}
}
אחרי שיוצרים את הגדרת החיבור המבודד, אפשר להציג מידע עליה באמצעות קריאה ל-method privateConnections/get. הפלט שמופיע אמור להיראות כך:
{
"name": "projects/projectId/location/us-central1/privateConnections/myPrivateConnection",
"createTime": "2019-12-22T16:17:37.159786963Z",
"updateTime": "2019-12-22T16:17:37.159786963Z",
"displayName": "my-private-connection",
"state": "CREATED",
"vpcPeeringConfig": {
"vpcName": "projects/my-project/global/networks/my-vpc",
"subnet": "10.11.12.13/29"
}
}
gcloud
gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION--display-name=DISPLAY_NAME --vpc=VPC_NAME --subnet=SUBNET
לדוגמה:
gcloud datastream private-connections create my-privateConnection --location=us-central1--display-name=my-private-connection --vpc=my-vpc --subnet=10.11.12.13/29
יצירת הגדרה של חיבור מבודד באמצעות ממשק Private Service Connect
לפני שיוצרים הגדרה של קישוריות פרטית, חשוב לוודא ש:
רשת VPC כדי להתחבר לרשת הפרטית של Datastream. מידע נוסף על יצירת רשת VPC זמין במאמר יצירה וניהול של רשתות VPC.
יוצרים חיבור לרשת בפרויקט ה-VPC.
מוודאים ש- Google Cloud וחומת האש המקומית מאפשרים תעבורה מטווח כתובות ה-IP של מחבר הרשת למסד הנתונים של המקור שממנו רוצים להעביר נתונים בסטרימינג.
הקוד הבא מראה בקשה ליצירת הגדרת חיבור מבודד באמצעות ממשקי Private Service Connect. קודם צריך להריץ פקודה כדי ליצור הגדרת חיבור מבודד עם הדגל validateOnly (--validate-only ב-Google Cloud CLI):
REST
POST "https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID&validateOnly=true"
gcloud
gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION--display-name=DISPLAY_NAME --network-attachment=NETWORK_ATTACHMENT_NAME --validate-only
בתגובה, תקבלו את השם של פרויקט המפיק שצריך לאשר. צריך להוסיף אותו לרשימת הפרויקטים המותרים של חיבור הרשת:
- משתמשים ב-method
describeכדי לקבל את הערך הנוכחי שלproducer-accept-listשל חיבור הרשת. למידע נוסף, קראו את המסמכים של Google Cloud SDK בנושא Compute Engine. - מוסיפים את הפרויקט של המפיק לרשימה הזו באמצעות השיטה
update. מידע נוסף זמין במאמרי העזרה של Google Cloud SDK בנושא Compute Engine.
אחרי שמוסיפים את הפרויקט של ה-producer לרשימת הפרויקטים המורשים, מריצים שוב את הפקודה ליצירת הגדרת הקישוריות הפרטית, והפעם בלי הדגל validateOnly:
REST
POST https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID { "displayName": "DISPLAY_NAME", "pscInterfaceConfig": { "networkAttachment": "NETWORK_ATTACHMENT_NAME" } }
לדוגמה:
POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
"displayName": "my-private-connection",
"pscInterfaceConfig": {
"networkAttachment": "projects/my-project/regions/us-central1/networkAttachments/my-na"
}
}
gcloud
gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION--display-name=DISPLAY_NAME --network-attachment=NETWORK_ATTACHMENT_NAME
לדוגמה:
gcloud datastream private-connections create my-private-connection --location=us-central1--display-name=my-private-connection --network-attachment=my-network-attachment
קבלת מידע על הגדרת חיבור מבודד
הקוד הבא מציג בקשה לאחזור מידע על הגדרת קישוריות פרטית שנוצרה.
REST
GET https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/privateConnections/PRIVATE_CONNECTIVITY_CONFIGURATION_ID
לדוגמה:
GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
gcloud
מידע נוסף על השימוש ב-gcloud לאחזור מידע על הגדרת הקישוריות הפרטית זמין במסמכי התיעוד של Google Cloud SDK.
הצגת רשימה של הגדרות חיבור מבודד
הקוד הבא מציג בקשה לאחזור מידע על כל ההגדרות של הקישוריות הפרטית.
REST
GET https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/privateConnections
gcloud
מידע נוסף על השימוש ב-gcloud כדי לאחזר מידע על כל הגדרות הקישוריות הפרטית שלכם זמין במסמכי התיעוד של Google Cloud SDK.
מחיקת הגדרה של חיבור מבודד
הקוד הבא מציג בקשה למחיקת הגדרה של חיבור מבודד. אחרי שמוחקים את ההגדרה, פרופילי החיבור שמשתמשים בהגדרה הזו לא יעבדו. בנוסף, כל הסטרימינג שמשתמש בפרופילי החיבור האלה לא יפעל.
כדי לפתור את הבעיה, צריך להקצות הגדרה אחרת של קישוריות פרטית לכל פרופיל חיבור. מידע נוסף זמין במאמר עדכון פרופיל חיבור.
REST
DELETE https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/privateConnections/[private-connectivity-configuration-id] {"force": true}
לדוגמה:
DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}
gcloud
מידע נוסף על השימוש ב-gcloud למחיקת הגדרת החיבור המבודד זמין במסמכי התיעוד של Google Cloud SDK.
המאמרים הבאים
- מידע נוסף על חיבור מבודד
- מידע נוסף על אפשרויות אחרות לקישוריות לרשת שאפשר להשתמש בהן עם Datastream.
- איך משתמשים ב-Datastream API כדי לנהל פרופילי חיבור
- איך משתמשים ב-Datastream API כדי לנהל את הסטרימינג
- למידע נוסף על השימוש ב-Datastream API, קראו את מאמרי העזרה.