Class Jdbc

Jdbc

שירות ה-JDBC מאפשר לסקריפטים להתחבר למסדי הנתונים Google Cloud SQL, MySQL, Microsoft SQL Server ו-Oracle. למידע נוסף, ניתן לעיין במדריך ל-JDBC.

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
getCloudSqlConnection(url)	JdbcConnection	ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של Google Cloud SQL.
getCloudSqlConnection(url, info)	JdbcConnection	ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של Google Cloud SQL.
getCloudSqlConnection(url, userName, password)	JdbcConnection	ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של Google Cloud SQL.
getConnection(url)	JdbcConnection	ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של מסד הנתונים.
getConnection(url, info)	JdbcConnection	ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של מסד הנתונים.
getConnection(url, userName, password)	JdbcConnection	ניסיונות ליצור חיבור למסד הנתונים הנתון באמצעות שם משתמש וסיסמה.
newDate(milliseconds)	JdbcDate	יצירת תאריך מאלפיות שנייה מתחילת התקופה.
newTime(milliseconds)	JdbcTime	יצירת זמן מאלפיות שנייה מתחילת התקופה.
newTimestamp(milliseconds)	JdbcTimestamp	יצירת חותמת זמן מאלפיות שנייה מתחילת התקופה.
parseDate(date)	JdbcDate	יוצרים תאריך על ידי ניתוח מחרוזת התאריך של SQL.
parseTime(time)	JdbcTime	יוצרים שעה על ידי ניתוח מחרוזת הזמן של SQL.
parseTimestamp(timestamp)	JdbcTimestamp	אפשר ליצור חותמת זמן על ידי ניתוח המחרוזת של חותמת הזמן של SQL.

תיעוד מפורט

getCloudSqlConnection(url)

ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של Google Cloud SQL.

פרמטרים

שם	תיאור	התיאור
url	String	כתובת URL של מסד נתונים בצורה jdbc:google:mysql://subname.

החזרות

JdbcConnection - אובייקט JdbcConnection.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/sqlservice

---

getCloudSqlConnection(url, info)

ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של Google Cloud SQL.

פרמטרים

שם	תיאור	התיאור
url	String	כתובת URL של מסד נתונים בצורה jdbc:google:mysql://subname.
info	Object	אובייקט JavaScript אופציונלי המציין פרמטרים מתקדמים כפי שמוגדר בהמשך.

פרמטרים מתקדמים

שם	תיאור	התיאור
connectTimeoutSeconds	Integer	הזמן הקצוב לחיבור בשניות
database	String	למסד הנתונים להתחבר אליו
instance	String	שם מופע של Google SQL Service
password	String	סיסמת המשתמש
queryTimeoutSeconds	Integer	הזמן הקצוב לתפוגה של שאילתה בשניות
user	String	שם המשתמש שצריך להעביר למסד הנתונים

החזרות

JdbcConnection - אובייקט JdbcConnection.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/sqlservice

---

getCloudSqlConnection(url, userName, password)

ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של Google Cloud SQL.

פרמטרים

שם	תיאור	התיאור
url	String	כתובת URL של מסד נתונים בצורה jdbc:google:mysql://subname.
userName	String	שם המשתמש שיועבר למסד הנתונים.
password	String	הסיסמה של המשתמש.

החזרות

JdbcConnection - אובייקט JdbcConnection.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/sqlservice

---

getConnection(url)

ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של מסד הנתונים.

var conn = Jdbc.getConnection('jdbc:mysql://yoursqlserver.example.com:3306/database_name');

פרמטרים

שם	תיאור	התיאור
url	String	כתובת URL של מסד נתונים בצורה jdbc:subprotocol:subname.

החזרות

JdbcConnection - אובייקט JdbcConnection.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/script.external_request

---

getConnection(url, info)

ניסיונות ליצור חיבור לכתובת ה-URL הנתונה של מסד הנתונים.

var conn = Jdbc.getConnection('jdbc:mysql://yoursqlserver.example.com:3306/database_name',
                              {user: 'username', password: 'password'});

פרמטרים

שם	תיאור	התיאור
url	String	כתובת URL של מסד נתונים בצורה jdbc:subprotocol:subname.
info	Object	אובייקט JavaScript אופציונלי המציין פרמטרים מתקדמים כפי שמוגדר בהמשך.

פרמטרים מתקדמים

שם	תיאור	התיאור
databaseName	String	למסד הנתונים להתחבר אליו
password	String	סיסמת המשתמש
useJDBCCompliantTimeZoneShift	Boolean	אם החיבור צריך לציית לכללי JDBC בעת המרת אזורי זמן. ברירת המחדל היא false.
user	String	שם המשתמש שצריך להעביר למסד הנתונים
_serverSslCertificate	String	אישור ה-SSL של השרת
_clientSslCertificate	String	אישור ה-SSL של הלקוח
_clientSslKey	String	מפתח ה-SSL של הלקוח

החזרות

JdbcConnection - אובייקט JdbcConnection.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/script.external_request

---

getConnection(url, userName, password)

ניסיונות ליצור חיבור למסד הנתונים הנתון באמצעות שם משתמש וסיסמה.

var conn = Jdbc.getConnection('jdbc:mysql://yoursqlserver.example.com:3306/database_name',
                              'username', 'password');

פרמטרים

שם	תיאור	התיאור
url	String	כתובת URL של מסד נתונים בצורה jdbc:subprotocol:subname.
userName	String	שם המשתמש שיועבר למסד הנתונים.
password	String	הסיסמה של המשתמש.

החזרות

JdbcConnection - אובייקט JdbcConnection.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/script.external_request

---

newDate(milliseconds)

יצירת תאריך מאלפיות שנייה מתחילת התקופה.

פרמטרים

שם	תיאור	התיאור
milliseconds	Integer	אלפיות השנייה מאז תחילת התקופה.

החזרות

JdbcDate - אובייקט JdbcDate.

---

newTime(milliseconds)

יצירת זמן מאלפיות שנייה מתחילת התקופה.

פרמטרים

שם	תיאור	התיאור
milliseconds	Integer	אלפיות השנייה מאז תחילת התקופה.

החזרות

JdbcTime - אובייקט JdbcTime.

---

newTimestamp(milliseconds)

יצירת חותמת זמן מאלפיות שנייה מתחילת התקופה.

פרמטרים

שם	תיאור	התיאור
milliseconds	Integer	אלפיות השנייה מאז תחילת התקופה.

החזרות

JdbcTimestamp - אובייקט JdbcTimestamp.

---

parseDate(date)

יוצרים תאריך על ידי ניתוח מחרוזת התאריך של SQL.

פרמטרים

שם	תיאור	התיאור
date	String	מחרוזת שמכילה מחרוזת של תאריך SQL.

החזרות

JdbcDate - אובייקט JdbcDate.

---

parseTime(time)

יוצרים שעה על ידי ניתוח מחרוזת הזמן של SQL.

פרמטרים

שם	תיאור	התיאור
time	String	מחרוזת שמכילה מחרוזת זמן של SQL.

החזרות

JdbcTime - אובייקט JdbcTime.

---

parseTimestamp(timestamp)

אפשר ליצור חותמת זמן על ידי ניתוח המחרוזת של חותמת הזמן של SQL.

פרמטרים

שם	תיאור	התיאור
timestamp	String	מחרוזת שמכילה מחרוזת של חותמת זמן של SQL.

החזרות

JdbcTimestamp - אובייקט JdbcTimestamp.