SingleStore
מחבר SingleStore מאפשר לבצע פעולות של הוספה, מחיקה, עדכון וקריאה במסד נתונים של SingleStore.
לפני שמתחילים
לפני שמשתמשים במחבר SingleStore, צריך לבצע את המשימות הבאות:
- בפרויקט Google Cloud:
- מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
- נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM roles/connectors.admin.
- מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
roles/secretmanager.viewerroles/secretmanager.secretAccessor
חשבון שירות הוא סוג מיוחד של חשבון Google שמייצג משתמש לא אנושי, שצריך לאמת ולאשר כדי לתת לו גישה לנתונים ב-Google APIs. אם אין לכם חשבון שירות, אתם צריכים ליצור חשבון שירות. המחבר וחשבון השירות צריכים להיות שייכים לאותו פרויקט. מידע נוסף זמין במאמר בנושא יצירת חשבון שירות.
- מפעילים את השירותים הבאים:
-
secretmanager.googleapis.com(Secret Manager API) -
connectors.googleapis.com(Connectors API)
במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.
-
אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.
הגדרת המחבר
החיבור הוא ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:
- במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
- לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
- בקטע מיקום, בוחרים את המיקום של החיבור.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
- לוחצים על הבא.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
- בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
- מחבר: בוחרים באפשרות SingleStore מהרשימה הנפתחת של המחברים הזמינים.
- גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
- בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.
השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:
- שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
- האותיות צריכות להיות קטנות.
- שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
- שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
- אופציונלי: מזינים תיאור למופע החיבור.
- אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-
Error. - חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
- אופציונלי: מגדירים את ההגדרות של צומת החיבור:
- מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
- מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
- Database: השם של מסד הנתונים של SingleStore.
- התרת משתני משתמש: אם ההגדרה היא True, אפשר להשתמש במשתני משתמש (עם הקידומת @) בשאילתות SQL.
- Characterset: ערכת התווים של הלקוח שספק החיפוש משתמש בה כברירת מחדל. לדוגמה, 'utf8'.
- Zero Dates To Null: האם להחזיר ערכים של Date ו-DateTime שמורכבים מאפסים כ-NULL.
- BrowsableSchemas: המאפיין הזה מגביל את הסכימות שמדווחות לקבוצת משנה של הסכימות הזמינות. לדוגמה, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
- אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
- לוחצים על הבא.
- בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
- סוג היעד: בוחרים סוג יעד.
- כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
- כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.
אם רוצים ליצור חיבור ציבורי למערכות העורפיות עם אבטחה נוספת, אפשר להגדיר כתובות IP סטטיות יוצאות לחיבורים, ואז להגדיר את כללי חומת האש כך שרק כתובות ה-IP הסטטיות הספציפיות יופיעו ברשימת ההיתרים.
כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.
- לוחצים על הבא.
- סוג היעד: בוחרים סוג יעד.
-
בקטע אימות, מזינים את פרטי האימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
החיבור ל-SingleStore תומך בסוגי האימות הבאים:
- שם משתמש וסיסמה
- לוחצים על הבא.
כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
- בדיקה: בודקים את פרטי החיבור והאימות.
- לוחצים על יצירה.
הגדרת אימות
מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.
-
שם משתמש וסיסמה
- שם משתמש: שם המשתמש של המחבר
- סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.
הגדרות של SingleStore
כדי להגדיר אימות ל-SingleStore, מבצעים את הפעולות הבאות:
- הגדרת חשבון SingleStore
- הגדרת מסד נתונים של SingleStore ופרטי יעד
- הגדרת אימות באמצעות שם משתמש וסיסמה
הגדרת חשבון SingleStore
- נרשמים לחשבון ניסיון בחינם ב-SingleStore.
- נכנסים ל חשבון SingleStore.
אפשר להשתמש בכתובת Gmail, בכתובת של מיקרוסופט או בכתובת האימייל של החברה כדי להתחבר.
הגדרת מסד נתונים של SingleStore ופרטי היעד
- אחרי שמתחברים, עוברים אל Instances (מופעים) או אל Databases (מסדי נתונים).
- לוחצים על מופע מסד הנתונים כדי לראות את הפרטים שלו. מוצאים את שם מסד הנתונים שמשויך למופע SingleStore.
- בתפריט הניווט, עוברים אל Cloud (ענן) ולוחצים על סביבת עבודה קיימת.
- בכרטיסייה סקירה כללית, רואים את סביבת העבודה ואת מסד הנתונים בסביבת העבודה.
- בפרטי המופע, מחפשים את שם המארח או את כתובת ה-IP של השרת ואת מספר היציאה שמשויכים למופע של מסד הנתונים SingleStore.
כדי לגשת לנתונים, צריך להתחבר למסד הנתונים הזה.
מוצגות אפשרויות ליצירת סביבת עבודה או מסד נתונים חדשים.
בדרך כלל המידע הזה מסופק יחד עם פרטי החיבור.
מידע על יצירת מסד נתונים ב-SingleStore זמין במאמר יצירת מסד נתונים.
הגדרת אימות באמצעות שם משתמש וסיסמה
- מזינים את שם המשתמש או את מזהה האימייל שמשמשים לכניסה למופע SingleStore.
- מזינים את הסיסמה שמשמשת לכניסה למופע SingleStore.
מידע על סביבת עבודה ב-SingleStore ועל יצירת מסד נתונים זמין ב תיעוד של SingleStore.
דוגמאות להגדרת חיבור
בקטע הזה מפורטים ערכים לדוגמה לשדות השונים שאתם מגדירים כשאתם יוצרים את החיבור ל-SingleStore.
סוג החיבור של שם המשתמש והסיסמה ב-SingleStore
| שם השדה | פרטים |
|---|---|
| מיקום | europe-west1 |
| מחבר | Singlestore |
| גרסת המחבר | 1 |
| שם החיבור | google-cloud-singlestore-conn |
| הפעלת Cloud Logging | כן |
| חשבון השירות | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| רמת הפירוט | 5 |
| מספר הצמתים המינימלי | 2 |
| מספר הצמתים המקסימלי | 50 |
| הגדרת SSL | לא |
| יעדים | אם היעד נמצא ברשת פרטית, צריך ליצור קובץ מצורף של נקודת קצה כדי לגשת אליו. |
| כתובת המארח | HOST_ADDRESS |
| יציאה | PORT |
| שם משתמש | שם משתמש |
| סיסמה | PASSWORD |
| גרסה של סוד | 1 |
סוג החיבור SingleStore SSL
| שם השדה | פרטים |
|---|---|
| מיקום | Europe-West1 |
| מחבר | Singlestore |
| גרסת המחבר | 1 |
| שם החיבור | google-cloud-singlestore-ssl-conn |
| הפעלת Cloud Logging | כן |
| חשבון השירות | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| רמת הפירוט | 5 |
| מספר הצמתים המינימלי | 2 |
| מספר הצמתים המקסימלי | 50 |
| הגדרת SSL | הפעל SSL |
| חיבור לא מאובטח | קבלת המהימנות של כל האישורים |
| אישור לקוח | CLIENT_CERTIFICATE. |
| Secret Version | 1 |
| מפתח פרטי של לקוח | בוחרים סוד שמכיל את המפתח הפרטי של הלקוח בפורמט PEM. |
| Secret Version | 1 |
| ביטוי סיסמה למפתח פרטי של לקוח | CLIENT_PRIVATE_KEY_PASSPHRASE |
| Secret Version | 1 |
| יעדים | אם היעד נמצא ברשת פרטית, צריך ליצור קובץ מצורף של נקודת קצה כדי לגשת אליו. |
| כתובת המארח | HOST_ADDRESS |
| יציאה | PORT |
| שם משתמש | שם משתמש |
| סיסמה | PASSWORD |
| גרסה של סוד | 1 |
ישויות, פעולות ופעולות
כל Integration Connectors מספקים שכבת הפשטה לאובייקטים של האפליקציה המחוברת. אפשר לגשת לאובייקטים של אפליקציה רק דרך ההפשטה הזו. ההפשטה מוצגת לכם כישויות, פעולות ופעולות.
- ישות: ישות היא אובייקט או אוסף של מאפיינים באפליקציה או בשירות המקושרים. ההגדרה של ישות משתנה ממחבר למחבר. לדוגמה, במחבר של מסד נתונים, הטבלאות הן הישויות, במחבר של שרת קבצים, התיקיות הן הישויות, ובמחבר של מערכת הודעות, התורים הם הישויות.
עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה
Entitiesתהיה ריקה. - פעולה: פעולה היא הפעילות שאפשר לבצע בישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:
בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה
Operations. - פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה
Actionsתהיה ריקה.
מגבלות המערכת
מחבר SingleStore יכול לעבד 10 טרנזקציות בשנייה, לכל צומת, ומגביל טרנזקציות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.
מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.
דוגמאות לפעולות על ישויות
דוגמה – רשימת רשומות של ישות
בדוגמה הזו מוצגת רשימת הרשומות של הישות Users.
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
UsersמהרשימהEntity. - בוחרים את הפעולה
Listולוחצים על סיום. - בקטע Task Input (קלט למשימה) של המשימה Connectors (מחברים), אפשר להגדיר את filterClause (סעיף מסנן) בהתאם לדרישות.
לדוגמה, אם מגדירים את סעיף המסנן ל-
employeeCode='5100' and startDate='2010-01-01 00:00:00', מוצגים רק הרשומות שבהן employeeCode הוא 5100 ו-startDate הוא 2010-01-01 00:00:00.
דוגמה – שליפת רשומה אחת מישות
בדוגמה הזו מאחזרים רשומה מהישות Users.
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
UserמהרשימהEntity. - בוחרים את הפעולה
Getולוחצים על סיום. - בקטע Task Input (קלט של משימה) במשימה Connectors (מחברים), לוחצים על entityId ואז מזינים
103032בשדה Default Value (ערך ברירת מחדל).כאן,
103032הוא ערך המפתח הראשי של הישותUsers.
דוגמה – מחיקת רשומה מישות
בדוגמה הזו נמחקת רשומה מהישות Users.
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
UsersמהרשימהEntity. - בוחרים את הפעולה
Deleteולוחצים על סיום. - בקטע Task Input (קלט של משימה) במשימה Connectors (מחברים), לוחצים על entityId ואז מזינים
113132בשדה Default Value (ערך ברירת מחדל).לחלופין, אם לישות יש מפתחות ראשיים מורכבים, במקום לציין את entityId, אפשר להגדיר את filterClause. לדוגמה,
employeeCode='5100' and startDate='2010-01-01 00:00:00'.
דוגמה – יצירת רשומה בישות
בדוגמה הזו נוצרת רשומה בישות Users.
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
UsersמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadומזינים ערך דומה לערך הבא בשדהDefault Value:{ "employeeCode": "5100", "startDate": "2010-01-01 00:00:00.0", "country": "US" }
אם השילוב יצליח, השדה connectorOutputPayload של משימת המחבר יכיל את התגובה של פעולת היצירה.
דוגמה – עדכון רשומה בישות
בדוגמה הזו מעדכנים רשומה בישות Users.
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
UsersמהרשימהEntity. - בוחרים את הפעולה
Updateולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadומזינים ערך דומה לערך הבא בשדהDefault Value:{ "country": "IN" }
- בקטע Task Input (קלט של משימה) במשימה Connectors (מחברים), לוחצים על entityId ואז מזינים
113132בשדה Default Value (ערך ברירת מחדל).לחלופין, אם לישות יש מפתחות ראשיים מורכבים, במקום לציין את entityId, אפשר להגדיר את filterClause. לדוגמה,
employeeCode='5100' and startDate='2010-01-01 00:00:00'.
אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר תופיע התגובה של פעולת העדכון.
פעולות
בקטע הזה מפורטות הפעולות שהמחבר תומך בהן. כדי להבין איך להגדיר את הפעולות, אפשר לעיין בדוגמאות לפעולות.
פעולת ExecuteCustomQuery
הפעולה הזו מאפשרת להריץ שאילתה בהתאמה אישית.
כדי ליצור שאילתה בהתאמה אישית, פועלים לפי השלבים הבאים:
- פועלים לפי ההוראות המפורטות ל הוספת משימה של מחברים.
- כשמגדירים את משימת המחבר, בוחרים באפשרות פעולות בסוג הפעולה שרוצים לבצע.
- ברשימה Action, בוחרים באפשרות Execute custom query ולוחצים על Done.
- מרחיבים את הקטע Task input (קלט למשימה) ומבצעים את הפעולות הבאות:
- בשדה Timeout after, מזינים את מספר השניות להמתנה עד להפעלת השאילתה.
ערך ברירת המחדל:
180שניות. - בשדה Maximum number of rows (מספר השורות המקסימלי), מזינים את מספר השורות המקסימלי שיוחזר ממסד הנתונים.
ערך ברירת המחדל:
25. - כדי לעדכן את השאילתה המותאמת אישית, לוחצים על עריכת סקריפט בהתאמה אישית. תיפתח תיבת הדו-שיח עורך הסקריפטים.
- בתיבת הדו-שיח הכלי לעריכת סקריפטים, מזינים את שאילתת ה-SQL ולוחצים על שמירה.
אפשר להשתמש בסימן שאלה (?) בהצהרת SQL כדי לייצג פרמטר יחיד שצריך לציין ברשימת פרמטרים של שאילתה. לדוגמה, שאילתת ה-SQL הבאה בוחרת את כל השורות מהטבלה
Employeesשתואמות לערכים שצוינו בעמודהLastName:SELECT * FROM Employees where LastName=?
- אם השתמשתם בסימני שאלה בשאילתת ה-SQL, צריך להוסיף את הפרמטר על ידי לחיצה על + הוספת שם פרמטר לכל סימן שאלה. במהלך ההפעלה של השילוב, הפרמטרים האלה מחליפים את סימני השאלה (?) בשאילתת ה-SQL באופן עקבי. לדוגמה, אם הוספתם שלושה סימני שאלה (?), אתם צריכים להוסיף שלושה פרמטרים לפי הסדר.
כדי להוסיף פרמטרים של שאילתה:
- מהרשימה סוג בוחרים את סוג הנתונים של הפרמטר.
- בשדה ערך, מזינים את הערך של הפרמטר.
- כדי להוסיף כמה פרמטרים, לוחצים על + הוספת פרמטר של שאילתה.
הפעולה Execute custom query לא תומכת במשתני מערך.
- בשדה Timeout after, מזינים את מספר השניות להמתנה עד להפעלת השאילתה.
אם הפעולה בוצעה ללא שגיאות, היא מחזירה את הסטטוס 200 (OK) עם גוף תגובה שכולל את תוצאות השאילתה.
בעיות מוכרות
פעולות יצירה, קריאה, עדכון ומחיקה ייכשלו בישויות שיש להן שדות מסוג Bit ו-Blob.
דוגמאות לפעולות
דוגמה – חיפוש הערך הגדול יותר
בדוגמה הזו מוסבר איך להפעיל פונקציה בהגדרת המשתמש. הפונקציה find_greater
בדוגמה הזו משווה בין שני מספרים שלמים ומחזירה את המספר השלם הגדול יותר.
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
find_greaterולוחצים על סיום. - בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על
connectorInputPayloadואז מזינים ערך דומה לערך הבא בשדהDefault Value:{ "$1": 1.0, "$2": 5.0 }
אם הפעלת הפעולה תסתיים בהצלחה, הערך של השדה connectorOutputPayload במשימת המחבר יהיה דומה לערך הבא:
[{ "bignum": 5.0 }]
יצירת חיבורים באמצעות Terraform
אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
כדי לראות תבנית לדוגמה של Terraform ליצירת חיבור, אפשר לעיין בתבנית לדוגמה.
כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:
| שם הפרמטר | סוג נתונים | חובה | תיאור |
|---|---|---|---|
| מסד נתונים | מחרוזת | נכון | השם של מסד הנתונים של SingleStore. |
| allow_user_variables | בוליאני | לא נכון | אם המדיניות מוגדרת כ-True, אפשר להשתמש במשתני משתמש (עם הקידומת @) בשאילתות SQL. |
| characterset | מחרוזת | לא נכון | ערכת התווים של הלקוח שמשמשת כברירת מחדל אצל הספק. לדוגמה, 'utf8'. |
| zero_dates_to_null | בוליאני | לא נכון | האם להחזיר ערכים של תאריך ותאריך/שעה שמורכבים מאפסים בלבד כ-NULL. |
| browsable_schemas | מחרוזת | לא נכון | המאפיין הזה מגביל את הסכימות שמדווחות לקבוצת משנה של הסכימות הזמינות. לדוגמה, BrowsableSchemas=SchemaA,SchemaB,SchemaC. |
שימוש בחיבור SingleStore בשילוב
אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.
- כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
- מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.