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.

المعلَمات

الاسمالنوعالوصف
urlStringعنوان URL لقاعدة بيانات على النحو التالي: jdbc:google:mysql://subname.

الإرجاع

JdbcConnection: كائن JdbcConnection

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getCloudSqlConnection(url, info)

تحاول إنشاء اتصال بعنوان URL المحدَّد في Google Cloud SQL.

المعلَمات

الاسمالنوعالوصف
urlStringعنوان URL لقاعدة بيانات على شكل jdbc:google:mysql://subname
infoObjectكائن JavaScript اختياري يحدّد المَعلمات المتقدّمة كما هو محدّد أدناه

المعلمات المتقدمة

الاسمالنوعالوصف
connectTimeoutSecondsIntegerمهلة الاتصال بالثواني
databaseStringقاعدة البيانات المطلوب الربط بها
instanceStringاسم مثيل Google SQL Service
passwordStringكلمة مرور المستخدم
queryTimeoutSecondsIntegerمهلة طلب البحث بالثواني
userStringاسم المستخدم المطلوب تمريره إلى قاعدة البيانات

الإرجاع

JdbcConnection: كائن JdbcConnection

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getCloudSqlConnection(url, userName, password)

تحاول إنشاء اتصال بعنوان URL المحدَّد في Google Cloud SQL.

المعلَمات

الاسمالنوعالوصف
urlStringعنوان URL لقاعدة بيانات على شكل jdbc:google:mysql://subname.
userNameStringاسم المستخدم الذي سيتم تمريره إلى قاعدة البيانات.
passwordStringكلمة مرور المستخدم

الإرجاع

JdbcConnection: كائن JdbcConnection

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getConnection(url)

تحاول إنشاء اتصال بعنوان URL لقاعدة البيانات المحدّد.

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

المعلَمات

الاسمالنوعالوصف
urlStringعنوان URL لقاعدة بيانات على شكل jdbc:subprotocol:subname.

الإرجاع

JdbcConnection: كائن JdbcConnection

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

  • 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'},
);

المعلَمات

الاسمالنوعالوصف
urlStringعنوان URL لقاعدة بيانات على شكل jdbc:subprotocol:subname
infoObjectكائن JavaScript اختياري يحدِّد المَعلمات المتقدّمة كما هو محدّد أدناه

المعلمات المتقدمة

الاسمالنوعالوصف
databaseNameStringقاعدة البيانات المطلوب الربط بها
passwordStringكلمة مرور المستخدم
useJDBCCompliantTimeZoneShiftBooleanما إذا كان يجب أن تمتثل عملية الربط لقواعد JDBC عند تحويل المناطق الزمنية القيمة التلقائية هي false.
userStringاسم المستخدم المطلوب تمريره إلى قاعدة البيانات
_serverSslCertificateStringشهادة طبقة المقابس الآمنة للخادم
_clientSslCertificateStringشهادة طبقة المقابس الآمنة للعميل
_clientSslKeyStringمفتاح بروتوكول SSL الخاص بالعميل

الإرجاع

JdbcConnection: كائن JdbcConnection

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

  • 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',
);

المعلَمات

الاسمالنوعالوصف
urlStringعنوان URL لقاعدة بيانات على شكل jdbc:subprotocol:subname
userNameStringاسم المستخدم الذي سيتم تمريره إلى قاعدة البيانات.
passwordStringكلمة مرور المستخدم

الإرجاع

JdbcConnection: كائن JdbcConnection

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

newDate(milliseconds)

إنشاء تاريخ من المللي ثانية منذ تاريخ بدء حساب الفترة

المعلَمات

الاسمالنوعالوصف
millisecondsIntegerوحدات المللي ثانية منذ بدء حساب الفترة

الإرجاع

JdbcDate: عنصر JdbcDate


newTime(milliseconds)

إنشاء وقت من المللي ثانية منذ تاريخ بدء حساب الفترة

المعلَمات

الاسمالنوعالوصف
millisecondsIntegerوحدات المللي ثانية منذ بدء حساب الفترة

الإرجاع

JdbcTime: عنصر JdbcTime


newTimestamp(milliseconds)

إنشاء طابع زمني من المللي ثانية منذ بدء حساب الوقت

المعلَمات

الاسمالنوعالوصف
millisecondsIntegerوحدات المللي ثانية منذ بدء حساب الفترة

الإرجاع

JdbcTimestamp: عنصر JdbcTimestamp


parseDate(date)

أنشئ تاريخًا من خلال تحليل سلسلة تاريخ SQL.

المعلَمات

الاسمالنوعالوصف
dateStringسلسلة تحتوي على سلسلة تاريخ SQL

الإرجاع

JdbcDate: عنصر JdbcDate


parseTime(time)

أنشئ وقتًا من خلال تحليل سلسلة وقت SQL.

المعلَمات

الاسمالنوعالوصف
timeStringسلسلة تحتوي على سلسلة وقت SQL

الإرجاع

JdbcTime: عنصر JdbcTime


parseTimestamp(timestamp)

أنشئ طابعًا زمنيًا عن طريق تحليل سلسلة الطابع الزمني في SQL.

المعلَمات

الاسمالنوعالوصف
timestampStringسلسلة تحتوي على سلسلة طابع زمني في SQL

الإرجاع

JdbcTimestamp: عنصر JdbcTimestamp