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สร้างวันที่จากมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970
newTime(milliseconds)JdbcTimeสร้างเวลาจากมิลลิวินาทีนับตั้งแต่เริ่มต้น
newTimestamp(milliseconds)JdbcTimestampสร้างการประทับเวลาจากมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970
parseDate(date)JdbcDateสร้างวันที่โดยแยกวิเคราะห์สตริงวันที่ SQL
parseTime(time)JdbcTimeสร้างเวลาโดยแยกวิเคราะห์สตริงเวลา SQL
parseTimestamp(timestamp)JdbcTimestampสร้างการประทับเวลาโดยแยกวิเคราะห์สตริงการประทับเวลา SQL

เอกสารโดยละเอียด

getCloudSqlConnection(url)

พยายามสร้างการเชื่อมต่อกับ URL ของ Google Cloud SQL ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของฐานข้อมูลในรูปแบบ jdbc:google:mysql://subname

รีเทิร์น

JdbcConnection - ออบเจ็กต์ JdbcConnection

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getCloudSqlConnection(url, info)

พยายามสร้างการเชื่อมต่อกับ URL ของ Google Cloud SQL ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของฐานข้อมูลในรูปแบบ jdbc:google:mysql://subname
infoObjectออบเจ็กต์ JavaScript ที่ไม่บังคับซึ่งระบุพารามิเตอร์ขั้นสูงตามที่กำหนดไว้ด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
connectTimeoutSecondsIntegerการเชื่อมต่อหมดเวลาเป็นวินาที
databaseStringฐานข้อมูลที่จะเชื่อมต่อ
instanceStringชื่อของอินสแตนซ์บริการ Google SQL
passwordStringรหัสผ่านของผู้ใช้
queryTimeoutSecondsIntegerการค้นหาหมดเวลาเป็นวินาที
userStringชื่อผู้ใช้ที่จะส่งไปยังฐานข้อมูล

รีเทิร์น

JdbcConnection - ออบเจ็กต์ JdbcConnection

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getCloudSqlConnection(url, userName, password)

พยายามสร้างการเชื่อมต่อกับ URL ของ Google Cloud SQL ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของฐานข้อมูลในรูปแบบ jdbc:google:mysql://subname
userNameStringชื่อผู้ใช้ที่จะส่งไปยังฐานข้อมูล
passwordStringรหัสผ่านของผู้ใช้

รีเทิร์น

JdbcConnection - ออบเจ็กต์ JdbcConnection

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getConnection(url)

พยายามสร้างการเชื่อมต่อไปยัง URL ของฐานข้อมูลที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของฐานข้อมูลในรูปแบบ jdbc:subprotocol:subname

รีเทิร์น

JdbcConnection - ออบเจ็กต์ JdbcConnection

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getConnection(url, info)

พยายามสร้างการเชื่อมต่อไปยัง URL ของฐานข้อมูลที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของฐานข้อมูลในรูปแบบ jdbc:subprotocol:subname
infoObjectออบเจ็กต์ JavaScript ที่ไม่บังคับซึ่งระบุพารามิเตอร์ขั้นสูงตามที่กำหนดไว้ด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
databaseNameStringฐานข้อมูลที่จะเชื่อมต่อ
passwordStringรหัสผ่านของผู้ใช้
useJDBCCompliantTimeZoneShiftBooleanไม่ว่าจะควร เป็นไปตามกฎ JDBC เมื่อแปลงเขตเวลาหรือไม่ โดยมีค่าเริ่มต้นเป็น false
userStringชื่อผู้ใช้ที่จะส่งไปยังฐานข้อมูล
_serverSslCertificateStringใบรับรอง SSL ของเซิร์ฟเวอร์
_clientSslCertificateStringใบรับรอง SSL ของไคลเอ็นต์
_clientSslKeyStringคีย์ SSL ของไคลเอ็นต์

รีเทิร์น

JdbcConnection - ออบเจ็กต์ JdbcConnection

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getConnection(url, userName, password)

พยายามสร้างการเชื่อมต่อกับฐานข้อมูลที่ระบุโดยใช้ชื่อผู้ใช้และรหัสผ่าน 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของฐานข้อมูลในรูปแบบ jdbc:subprotocol:subname
userNameStringชื่อผู้ใช้ที่จะส่งไปยังฐานข้อมูล
passwordStringรหัสผ่านของผู้ใช้

รีเทิร์น

JdbcConnection - ออบเจ็กต์ JdbcConnection

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

newDate(milliseconds)

สร้างวันที่จากมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970

พารามิเตอร์

ชื่อประเภทคำอธิบาย
millisecondsIntegerมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970

รีเทิร์น

JdbcDate — ออบเจ็กต์ JdbcDate

newTime(milliseconds)

สร้างเวลาจากมิลลิวินาทีนับตั้งแต่เริ่มต้น

พารามิเตอร์

ชื่อประเภทคำอธิบาย
millisecondsIntegerมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970

รีเทิร์น

JdbcTime — ออบเจ็กต์ JdbcTime

newTimestamp(milliseconds)

สร้างการประทับเวลาจากมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970

พารามิเตอร์

ชื่อประเภทคำอธิบาย
millisecondsIntegerมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970

รีเทิร์น

JdbcTimestamp — ออบเจ็กต์ JdbcTimestamp

parseDate(date)

สร้างวันที่โดยแยกวิเคราะห์สตริงวันที่ SQL

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateStringสตริงที่มีสตริงวันที่ SQL

รีเทิร์น

JdbcDate — ออบเจ็กต์ JdbcDate

parseTime(time)

สร้างเวลาโดยแยกวิเคราะห์สตริงเวลา SQL

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timeStringสตริงที่มีสตริงเวลา SQL

รีเทิร์น

JdbcTime — ออบเจ็กต์ JdbcTime

parseTimestamp(timestamp)

สร้างการประทับเวลาโดยแยกวิเคราะห์สตริงการประทับเวลา SQL

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timestampStringสตริงที่มีสตริงการประทับเวลา SQL

รีเทิร์น

JdbcTimestamp — ออบเจ็กต์ JdbcTimestamp