הגרסאות 1.0 ו-1.1 של פרוטוקול האבטחה TLS מושבתות. כדי ליצור חיבורים, צריך להשתמש ב-TLS 1.2 או בגרסה מאובטחת יותר.
Google Apps Script יכול להתחבר למסדי נתונים חיצוניים באמצעות שירות JDBC, שהוא עטיפה של טכנולוגיית Java Database Connectivity (קישוריות למסדי נתונים ב-Java) הרגילה. שירות JDBC תומך במסדי נתונים של Google Cloud SQL ל-MySQL, MySQL, Microsoft SQL Server, Oracle ו-PostgreSQL.
אם הגיליון האלקטרוני גדל מדי או שאתם נתקלים בבעיות שקשורות לזמן קצוב לתפוגה בחישובים מורכבים, העברת הנתונים למסד נתונים חיצוני יכולה לשפר משמעותית את הביצועים והמהימנות.
כדי לעדכן מסד נתונים חיצוני באמצעות JDBC, הסקריפט צריך לפתוח חיבור למסד הנתונים ואז לבצע שינויים על ידי שליחת משפטי SQL.
מסדי נתונים של Google Cloud SQL
Google Cloud SQL מאפשר ליצור מסדי נתונים רלציוניים שמתארחים בענן של Google. יכול להיות שתחויבו על השימוש ב-Cloud SQL.
יוצרים מכונה של Google Cloud SQL לפי השלבים שמפורטים במדריך למתחילים של Cloud SQL.
יצירת חיבורים ל-Google Cloud SQL
יש שתי דרכים ליצור חיבור למסד נתונים של Google Cloud SQL באמצעות שירות JDBC של Apps Script:
- (מומלץ) חיבור באמצעות Jdbc.getCloudSqlConnection
- חיבור באמצעות Jdbc.getConnection
שתי השיטות תקפות, אבל בשיטה השנייה צריך לאשר קבוצה של טווחי כתובות IP כדי לקבל גישה למסד הנתונים.
שימוש ב-Jdbc.getCloudSqlConnection (מומלץ)
השיטה הזו יוצרת חיבור למכונת MySQL של Google Cloud SQL באמצעות השיטה Jdbc.getCloudSqlConnection. כתובת ה-URL של מסד הנתונים היא מהצורה jdbc:google:mysql://subname, כאשר subname הוא שם החיבור של המופע ב-MySQL שמופיע בדף Overview של מופע Cloud SQL ב-מסוף Google Cloud.
כדי להתחבר ל-Cloud SQL SQL Server, אפשר לעיין במאמר בנושא Jdbc.getConnection.
שימוש ב-Jdbc.getConnection
כדי להשתמש בשיטה הזו, צריך לאשר טווחים מסוימים של כתובות IP בפורמט Classless Inter-Domain Routing (CIDR) כדי שהשרתים של Apps Script יוכלו להתחבר למסד הנתונים שלכם. לפני שמריצים את הסקריפט, צריך לבצע את השלבים הבאים:
במופע Google Cloud SQL, מאשרים את טווחי כתובות ה-IP, כל אחד בנפרד ממקור הנתונים הזה.
מעתיקים את כתובת ה-URL שהוקצתה למסד הנתונים. היא צריכה להיות בפורמט
jdbc:mysql:subname.
אחרי שמאשרים את טווחי כתובות ה-IP האלה, יוצרים חיבורים למופע Google Cloud SQL באמצעות אחת מהשיטות של Jdbc.getConnection וכתובת ה-URL שהעתקתם קודם.
מסדי נתונים אחרים
אם כבר יש לכם מסד נתונים משלכם ב-MySQL, Microsoft SQL Server, Oracle או PostgreSQL, תוכלו להתחבר אליו באמצעות שירות JDBC של Apps Script.
יצירת חיבורים למסדי נתונים אחרים
כדי ליצור חיבור למסד נתונים באמצעות שירות JDBC של Apps Script, צריך לאשר בנתוני מסד הנתונים טווחי כתובות IP ממקור הנתונים הזה.
שירות ה-JDBC יכול להתחבר רק ליציאות 1025 ומעלה. מוודאים שמסד הנתונים לא מוגדר לשימוש ביציאה נמוכה יותר.
אחרי שיוצרים את רשימות ההיתרים האלה, יוצרים חיבור למסד הנתונים באמצעות אחת מהשיטות של Jdbc.getConnection וכתובת ה-URL של מסד הנתונים.
קוד לדוגמה
קוד הדוגמה הבא מניח שאתם מתחברים למסד נתונים של Google Cloud SQL, ויוצר חיבורים למסד נתונים באמצעות השיטה Jdbc.getCloudSqlConnection. במסדי נתונים אחרים צריך להשתמש בשיטה Jdbc.getConnection כדי ליצור חיבורים למסד הנתונים.
למידע נוסף על שיטות JDBC, אפשר לעיין במסמכי התיעוד של Java בנושא JDBC.
יצירת מסד נתונים, משתמש וטבלה
רוב המפתחים משתמשים בכלי שורת פקודה של MySQL כדי ליצור מסדי נתונים, משתמשים וטבלאות. עם זאת, אפשר לעשות את אותו הדבר ב-Apps Script, כמו שמוצג בדוגמה הבאה. צריך ליצור לפחות משתמש אחד נוסף כדי שהסקריפט לא יצטרך להתחבר תמיד למסד הנתונים בתור root.
כתיבה למסד הנתונים
בדוגמאות הבאות מוסבר איך לכתוב רשומה יחידה למסד הנתונים וגם איך לכתוב קבוצה של 500 רשומות. הוספה לאוסף חיונית לביצוע פעולות בכמות גדולה.
נעשה שימוש בהצהרות עם פרמטרים, שבהן המשתנים מסומנים באמצעות ?. כדי למנוע התקפות של הזרקת SQL, צריך להשתמש בהצהרות עם פרמטרים כדי לבצע escape לכל הנתונים שסופקו על ידי המשתמש.
קריאה ממסד הנתונים
בדוגמה הזו אפשר לראות איך קוראים מספר גדול של רשומות ממסד הנתונים, וחוזרים על קבוצת התוצאות לפי הצורך.
סגירת החיבורים
חיבורי JDBC נסגרים אוטומטית כשסקריפט מסיים את ההרצה. (קריאות בודדות של google.script.run נספרות כהפעלה מלאה, גם אם דף שירות ה-HTML שממנו בוצעה הקריאה נשאר פתוח).
עם זאת, אם אתם יודעים שסיימתם להשתמש בחיבור, בהצהרה או בערכת תוצאות לפני סוף הסקריפט, אתם יכולים לסגור אותם באופן ידני על ידי קריאה ל-JdbcConnection.close, ל-JdbcStatement.close או ל-JdbcResultSet.close.
הצגה של תיבת דו-שיח של התראה או בקשה גורמת גם לסגירה של כל חיבורי ה-JDBC הפתוחים. עם זאת, רכיבים אחרים בממשק המשתמש שמוצגים – כמו תפריטים מותאמים אישית, תיבות דו-שיח וסרגלי צד עם תוכן מותאם אישית – לא נכללים בהגדרה הזו.
Google, Google Workspace וסימנים וסמלי לוגו קשורים הם סימנים מסחריים של Google LLC. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.