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 لقاعدة البيانات المحدّدة

const 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 لقاعدة البيانات المحدّدة

const 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	شهادة طبقة المقابس الآمنة الخاصة بالخادم
_clientSslCertificate	String	شهادة طبقة المقابس الآمنة الخاصة بالعميل
_clientSslKey	String	مفتاح 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',
);

المعلمات

الاسم	النوع	الوصف
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.