Class JdbcConnection

JdbcConnection

Connection JDBC للاطّلاع على مستندات هذه الفئة، يُرجى الاطّلاع على java.sql.Connection.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
clearWarnings()	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#clearWarnings().
close()	void	عليك إزالة قاعدة بيانات هذا الربط وجميع الموارد المرتبطة به.
commit()	void	تجعل جميع التغييرات المعلّقة دائمة، وتُطلق أقفال قاعدة البيانات التي يحتفظ بها هذا JdbcConnection.
createArrayOf(typeName, elements)	JdbcArray	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createArrayOf(String, Object[]).
createBlob()	JdbcBlob	تُنشئ مثيل JdbcBlob.
createClob()	JdbcClob	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createClob().
createNClob()	JdbcClob	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createNClob().
createSQLXML()	JdbcSQLXML	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createSQLXML().
createStatement()	JdbcStatement	لإنشاء عنصر JdbcStatement لإرسال عبارات SQL إلى قاعدة البيانات.
createStatement(resultSetType, resultSetConcurrency)	JdbcStatement	لإنشاء عنصر JdbcStatement لإرسال عبارات SQL إلى قاعدة البيانات.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)	JdbcStatement	لإنشاء عنصر JdbcStatement لإرسال عبارات SQL إلى قاعدة البيانات.
createStruct(typeName, attributes)	JdbcStruct	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createStruct(String, Object[]).
getAutoCommit()	Boolean	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getAutoCommit().
getCatalog()	String	أو مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getCatalog().
getHoldability()	Integer	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getHoldability().
getMetaData()	JdbcDatabaseMetaData	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getMetaData().
getTransactionIsolation()	Integer	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getTransactionIsolation().
getWarnings()	String[]	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getWarnings().
isClosed()	Boolean	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#isClosed().
isReadOnly()	Boolean	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#isReadOnly().
isValid(timeout)	Boolean	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#isValid(int).
nativeSQL(sql)	String	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#nativeSQL(String).
prepareCall(sql)	JdbcCallableStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareCall(String).
prepareCall(sql, resultSetType, resultSetConcurrency)	JdbcCallableStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareCall(String, int, int).
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)	JdbcCallableStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareCall(String, int, int, int).
prepareStatement(sql)	JdbcPreparedStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String).
prepareStatement(sql, autoGeneratedKeys)	JdbcPreparedStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int).
prepareStatement(sql, resultSetType, resultSetConcurrency)	JdbcPreparedStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int, int).
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)	JdbcPreparedStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int, int, int).
prepareStatementByIndex(sql, indices)	JdbcPreparedStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int[]).
prepareStatementByName(sql, columnNames)	JdbcPreparedStatement	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, String[]).
releaseSavepoint(savepoint)	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#releaseSavepoint(Savepoint).
rollback()	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#rollback().
rollback(savepoint)	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#rollback(Savepoint).
setAutoCommit(autoCommit)	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setAutoCommit(boolean).
setCatalog(catalog)	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setCatalog(String).
setHoldability(holdability)	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setHoldability(int).
setReadOnly(readOnly)	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setReadOnly(boolean).
setSavepoint()	JdbcSavepoint	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setSavepoint().
setSavepoint(name)	JdbcSavepoint	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setSavepoint(String).
setTransactionIsolation(level)	void	للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setTransactionIsolation(int).

مستندات تفصيلية

clearWarnings()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#clearWarnings().

التفويض

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

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

---

close()

عليك إزالة قاعدة بيانات هذا الربط وجميع الموارد المرتبطة به.

const conn = Jdbc.getConnection(
    'jdbc:mysql://<host>:<port>/<instance>',
    'user',
    'password',
);
conn.close();

انظر أيضًا

• Connection.close()

---

commit()

تجعل جميع التغييرات المعلّقة دائمة، وتُطلق أقفال قاعدة البيانات التي يحتفظ بها هذا JdbcConnection.

const conn = Jdbc.getConnection(
    'jdbc:mysql://<host>:<port>/<instance>',
    'user',
    'password',
);
conn.setAutoCommit(false);
const stmt = conn.prepareStatement(
    'insert into person (lname,fname) values (?,?)',
);
const start = new Date();
for (let i = 0; i < 5000; i++) {
  // Objects are accessed using 1-based indexing
  stmt.setObject(1, `firstName${i}`);
  stmt.setObject(2, `lastName${i}`);
  stmt.addBatch();
}
const res = stmt.executeBatch();
conn.commit();  // When this returns, this is when changes are actually
                // committed
conn.close();

التفويض

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

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

انظر أيضًا

• Connection.commit()

---

createArrayOf(typeName, elements)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createArrayOf(String, Object[]).

المعلمات

الاسم	النوع	الوصف
typeName	String	اسم SQL الخاص بقاعدة البيانات لنوع عناصر الصفيف تشمل الخيارات الأنواع المضمّنة أو الأنواع التي يحدّدها المستخدم أو أنواع SQL العادية المتوافقة مع قاعدة البيانات.
elements	Object[]	العناصر المطلوب تعبئتها في العنصر الذي يتم إرجاعه

الإرجاع

JdbcArray: صفيف يتم ربط عناصره بنوع SQL المحدّد.

---

createBlob()

تُنشئ مثيل JdbcBlob. يمكنك أيضًا الاطّلاع على java.sql.Connection#createBlob().

لا يحتوي العنصر الذي تم إرجاعه في البداية على أي بيانات. يمكنك استخدام طرق setBytes في JdbcBlob لضبط البيانات التي يجب أن تحتوي عليها. إنّ العنصر المتعدّد السطوح المستخدَم هنا ليس هو نفسه العنصر المتعدّد السطوح الذي تم إنشاؤه باستخدام Utilities.newBlob(data). للتحويل بين التنسيقَين، استخدِم الطريقتَين getBytes() وsetBytes() المحدّدتَين. بدلاً من ذلك، يقدّم كلّ من JdbcBlob وJdbcClob getAppsScriptBlob() طريقة سهلة للتحويل إلى تنسيق يمكن أن تستخدمه Apps Script.

الإرجاع

‫JdbcBlob: عنصر ملفّ أرشيف ثنائي فارغ

---

createClob()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createClob().

الإرجاع

JdbcClob: عنصر clob فارغ.

---

createNClob()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createNClob().

الإرجاع

JdbcClob: عنصر nclob فارغ.

---

createSQLXML()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createSQLXML().

الإرجاع

JdbcSQLXML: عنصر SQLXML فارغ.

---

createStatement()

لإنشاء عنصر JdbcStatement لإرسال عبارات SQL إلى قاعدة البيانات. يمكنك أيضًا الاطّلاع على java.sql.Connection#createStatement().

// This sample code assumes authentication is off
const conn = Jdbc.getConnection('jdbc:mysql://<host>:3306/<instance>');
const stmt = conn.createStatement();

stmt.setMaxRows(100);
const rs = stmt.execute('select * from person');

while (rs.next()) {
  // Do something
}

rs.close();
stmt.close();
conn.close();

الإرجاع

JdbcStatement: مثيل بيان لتنفيذ طلبات البحث

---

createStatement(resultSetType, resultSetConcurrency)

لإنشاء عنصر JdbcStatement لإرسال عبارات SQL إلى قاعدة البيانات. يمكنك أيضًا الاطّلاع على java.sql.Connection#createStatement(int, int).

يسمح هذا الإصدار بإلغاء نوع مجموعة النتائج والتزامن.

// This sample code assumes authentication is off
// For more information about this method, see documentation here:
//  http://docs.oracle.com/javase/6/docs/api/java/sql/Connection.html#createStatement(int,
//  int)
const conn = Jdbc.getConnection('jdbc:mysql://<host>:3306/<instance>');
const stmt = conn.createStatement(
    Jdbc.ResultSet.TYPE_FORWARD_ONLY,
    Jdbc.ResultSet.CONCUR_READ_ONLY,
);

stmt.setMaxRows(100);
const rs = stmt.execute('select * from person');

while (rs.next()) {
  // Do something
}

rs.close();
stmt.close();
conn.close();

المعلمات

الاسم	النوع	الوصف
resultSetType	Integer	نوع مجموعة النتائج، وهو أحد القيم Jdbc.ResultSet.TYPE_FORWARD_ONLY أو Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE أو Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrency	Integer	نوع التزامن، إما Jdbc.ResultSet.CONCUR_READ_ONLY أو Jdbc.ResultSet.CONCUR_UPDATABLE

الإرجاع

JdbcStatement: مثيل بيان لتنفيذ طلبات البحث

---

createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)

لإنشاء عنصر JdbcStatement لإرسال عبارات SQL إلى قاعدة البيانات. يمكنك أيضًا الاطّلاع على java.sql.Connection#createStatement(int, int, int).

يسمح هذا الإصدار بإلغاء نوع مجموعة النتائج وقابلية الاحتفاظ بها وقابلية التزامن.

// This sample code assumes authentication is off
// For more information about this method, see documentation here:
//  http://docs.oracle.com/javase/6/docs/api/java/sql/Connection.html#createStatement(int,
//  int)
const conn = Jdbc.getConnection('jdbc:mysql://<host>:3306/<instance>');
const stmt = conn.createStatement(
    Jdbc.ResultSet.TYPE_FORWARD_ONLY,
    Jdbc.ResultSet.CONCUR_READ_ONLY,
    Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT,
);

stmt.setMaxRows(100);
const rs = stmt.execute('select * from person');

while (rs.next()) {
  // Do something
}

rs.close();
stmt.close();
conn.close();

المعلمات

الاسم	النوع	الوصف
resultSetType	Integer	نوع مجموعة النتائج، وهو أحد القيم Jdbc.ResultSet.TYPE_FORWARD_ONLY أو Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE أو Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrency	Integer	نوع التزامن، إما Jdbc.ResultSet.CONCUR_READ_ONLY أو Jdbc.ResultSet.CONCUR_UPDATABLE
resultSetHoldability	Integer	إعداد قابلية الاحتفاظ بالبيانات، إما Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT أو Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT

الإرجاع

JdbcStatement: مثيل بيان لتنفيذ طلبات البحث

---

createStruct(typeName, attributes)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#createStruct(String, Object[]).

المعلمات

الاسم	النوع	الوصف
typeName	String	اسم SQL الخاص بقاعدة البيانات لنوع عناصر الصفيف تشمل الخيارات الأنواع المضمّنة أو الأنواع التي يحدّدها المستخدم أو أنواع SQL العادية المتوافقة مع قاعدة البيانات.
attributes	Object[]	السمات التي تملأ العنصر الذي تم إرجاعه

الإرجاع

JdbcStruct: عنصر بنية يتم ربطه بنوع SQL المحدّد ويتم تعبئته بالسمّات المحدّدة.

---

getAutoCommit()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getAutoCommit().

الإرجاع

Boolean — true في حال تفعيل وضع الربط التلقائي، false في حال عدم تفعيله

التفويض

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

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

---

getCatalog()

أو مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getCatalog().

الإرجاع

String: اسم الكتالوج الحالي أو null في حال عدم تحديد اسم.

التفويض

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

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

---

getHoldability()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getHoldability().

الإرجاع

‫Integer: إعداد قابلية الاحتفاظ بالاتصال، إما Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT أو Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT

---

getMetaData()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getMetaData().

الإرجاع

JdbcDatabaseMetaData: البيانات الوصفية لقاعدة البيانات التي يتصل بها هذا الربط

التفويض

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

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

---

getTransactionIsolation()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getTransactionIsolation().

الإرجاع

‫Integer: مستوى المعاملة الحالي، وهو أحد المستويات التالية: Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED أو Jdbc.Connection.TRANSACTION_READ_COMMITTED أو Jdbc.Connection.TRANSACTION_REPEATABLE_READ أو Jdbc.Connection.TRANSACTION_SERIALIZABLE أو Jdbc.Connection.TRANSACTION_NONE.

التفويض

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

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

---

getWarnings()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#getWarnings().

الإرجاع

String[]: صفيف من سلاسل التحذيرات

التفويض

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

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

---

isClosed()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#isClosed().

الإرجاع

Boolean: true إذا كان الاتصال مغلقًا، false في حال أخرى

التفويض

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

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

---

isReadOnly()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#isReadOnly().

الإرجاع

Boolean: true إذا كان الربط للقراءة فقط، false بخلاف ذلك

التفويض

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

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

---

isValid(timeout)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#isValid(int).

المعلمات

الاسم	النوع	الوصف
timeout	Integer	الوقت بالثواني للانتظار إلى أن تكتمل عملية التحقّق. تشير القيمة 0 إلى عدم تطبيق مهلة.

الإرجاع

Boolean: true إذا كان الاتصال صالحًا، وfalse في حال عدم صلاحيته يتم عرض القيمة false أيضًا إذا انتهت فترة المهلة قبل اكتمال العملية.

التفويض

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

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

---

nativeSQL(sql)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#nativeSQL(String).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر من علامة "؟"

الإرجاع

‫String: التنسيق الأصلي للبيان المقدَّم

التفويض

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

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

---

prepareCall(sql)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareCall(String).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر من "؟"، ويتم توفيرها عادةً باستخدام بنية ترميز الهروب لطلب JDBC.

الإرجاع

JdbcCallableStatement: عبارة قابلة للاستدعاء تحتوي على عبارة SQL المجمّعة مسبقًا.

---

prepareCall(sql, resultSetType, resultSetConcurrency)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareCall(String, int, int).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر من "؟"، ويتم توفيرها عادةً باستخدام بنية ترميز الهروب لطلب JDBC.
resultSetType	Integer	نوع مجموعة النتائج، وهو أحد القيم Jdbc.ResultSet.TYPE_FORWARD_ONLY أو Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE أو Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrency	Integer	نوع التزامن، إما Jdbc.ResultSet.CONCUR_READ_ONLY أو Jdbc.ResultSet.CONCUR_UPDATABLE

الإرجاع

JdbcCallableStatement: عبارة قابلة للاستدعاء تحتوي على عبارة SQL المجمّعة مسبقًا التي تُنشئ مجموعات نتيجة بالنوع وعدد عمليات المعالجة المتزامنة المقدَّمين.

---

prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareCall(String, int, int, int).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر من "؟"، ويتم توفيرها عادةً باستخدام بنية ترميز الهروب لطلب JDBC.
resultSetType	Integer	نوع مجموعة النتائج، وهو أحد القيم Jdbc.ResultSet.TYPE_FORWARD_ONLY أو Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE أو Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrency	Integer	نوع التزامن، إما Jdbc.ResultSet.CONCUR_READ_ONLY أو Jdbc.ResultSet.CONCUR_UPDATABLE
resultSetHoldability	Integer	إعداد قابلية الاحتفاظ بالبيانات، إما Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT أو Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT

الإرجاع

JdbcCallableStatement: عبارة قابلة للاستدعاء تحتوي على عبارة SQL المجمّعة مسبقًا التي تُنشئ مجموعات نتيجة بالنوع المقدَّم، وهو "الاستجابة المتزامنة".

---

prepareStatement(sql)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر للمَعلمة IN التي تبدأ بعلامة استفهام "؟"

الإرجاع

JdbcPreparedStatement: عبارة جاهزة تحتوي على عبارة SQL المجمّعة مسبقًا.

---

prepareStatement(sql, autoGeneratedKeys)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر للمَعلمة IN التي تبدأ بعلامة استفهام "؟"
autoGeneratedKeys	Integer	علامة تشير إلى ما إذا كان يتم عرض مفاتيح تم إنشاؤها تلقائيًا، إما Jdbc.Statement.RETURN_GENERATED_KEYS أو Jdbc.Statement.NO_GENERATED_KEYS.

الإرجاع

JdbcPreparedStatement - عبارة تم إعدادها تحتوي على عبارة SQL المجمّعة مسبقًا، والتي قد تكون قادرة على عرض مفاتيح تم إنشاؤها تلقائيًا.

---

prepareStatement(sql, resultSetType, resultSetConcurrency)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int, int).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر للمَعلمة IN التي تبدأ بعلامة استفهام "؟"
resultSetType	Integer	نوع مجموعة النتائج، وهو أحد القيم Jdbc.ResultSet.TYPE_FORWARD_ONLY أو Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE أو Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrency	Integer	نوع التزامن، إما Jdbc.ResultSet.CONCUR_READ_ONLY أو Jdbc.ResultSet.CONCUR_UPDATABLE

الإرجاع

JdbcPreparedStatement: عبارة مُعدّة تحتوي على عبارة SQL مُجمَّعة مسبقًا تُنشئ مجموعات نتيجة بالنوع وعدد عمليات المعالجة المتزامنة المقدَّمين.

---

prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int, int, int).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر للمَعلمة IN التي تبدأ بعلامة استفهام "؟"
resultSetType	Integer	نوع مجموعة النتائج، وهو أحد القيم Jdbc.ResultSet.TYPE_FORWARD_ONLY أو Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE أو Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrency	Integer	نوع التزامن، إما Jdbc.ResultSet.CONCUR_READ_ONLY أو Jdbc.ResultSet.CONCUR_UPDATABLE
resultSetHoldability	Integer	إعداد قابلية الاحتفاظ بالبيانات، إما Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT أو Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT

الإرجاع

JdbcPreparedStatement — عبارة مُعدّة تحتوي على عبارة SQL المُجمَّعة مسبقًا التي تُنشئ مجموعات نتيجة بالنوع وقابلية الاحتفاظ والالتزام المتزامن المقدَّمين.

---

prepareStatementByIndex(sql, indices)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, int[]).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر للمَعلمة IN التي تبدأ بعلامة استفهام "؟"
indices	Integer[]	فهرسات الأعمدة للأعمدة التي يتم عرضها من الصف أو الصفوف المُدرَجة

الإرجاع

JdbcPreparedStatement — عبارة تم إعدادها تحتوي على عبارة SQL المجمّعة مسبقًا، ويمكنها عرض مفاتيح تم إنشاؤها تلقائيًا محدّدة بواسطة فهارس الأعمدة المقدَّمة.

---

prepareStatementByName(sql, columnNames)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#prepareStatement(String, String[]).

المعلمات

الاسم	النوع	الوصف
sql	String	عبارة SQL قد تحتوي على عنصر نائب واحد أو أكثر للمَعلمة IN التي تبدأ بعلامة استفهام "؟"
columnNames	String[]	أسماء الأعمدة التي تحدّد الأعمدة التي يجب أن تعرضها الطريقة من صف أو صفوف تم إدراجها

الإرجاع

JdbcPreparedStatement — عبارة مُعدّة تحتوي على عبارة SQL مُجمَّعة مسبقًا، ويمكنها عرض مفاتيح تم إنشاؤها تلقائيًا وفقًا لأسماء الأعمدة المقدَّمة.

---

releaseSavepoint(savepoint)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#releaseSavepoint(Savepoint).

المعلمات

الاسم	النوع	الوصف
savepoint	JdbcSavepoint	نقطة الحفظ المطلوب إزالتها

التفويض

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

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

---

rollback()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#rollback().

التفويض

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

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

---

rollback(savepoint)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#rollback(Savepoint).

المعلمات

الاسم	النوع	الوصف
savepoint	JdbcSavepoint	نقطة الحفظ التي تريد الرجوع إليها

التفويض

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

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

---

setAutoCommit(autoCommit)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setAutoCommit(boolean).

المعلمات

الاسم	النوع	الوصف
autoCommit	Boolean	إذا كان true، يتم تفعيل وضع الحفظ التلقائي، وfalse لإيقافه.

التفويض

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

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

---

setCatalog(catalog)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setCatalog(String).

المعلمات

الاسم	النوع	الوصف
catalog	String	اسم كتالوج (المساحة الفرعية في قاعدة بيانات الاتصال) التي تريد العمل فيها.

التفويض

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

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

---

setHoldability(holdability)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setHoldability(int).

المعلمات

الاسم	النوع	الوصف
holdability	Integer	إمكانية الاحتفاظ التلقائية بعناصر JdbcResultSet التي تم إنشاؤها باستخدام هذا الربط، إما Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT أو Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.

---

setReadOnly(readOnly)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setReadOnly(boolean).

المعلمات

الاسم	النوع	الوصف
readOnly	Boolean	إذا كان true، يتم تفعيل وضع القراءة فقط، وfalse لإيقافه.

التفويض

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

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

---

setSavepoint()

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setSavepoint().

الإرجاع

JdbcSavepoint - نقطة الحفظ الجديدة بدون اسم

التفويض

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

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

---

setSavepoint(name)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setSavepoint(String).

المعلمات

الاسم	النوع	الوصف
name	String	اسم نقطة الحفظ التي تم إنشاؤها

الإرجاع

JdbcSavepoint - نقطة الحفظ الجديدة المُسمّاة

التفويض

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

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

---

setTransactionIsolation(level)

للاطّلاع على مستندات هذه الطريقة، يُرجى الاطّلاع على java.sql.Connection#setTransactionIsolation(int).

المعلمات

الاسم	النوع	الوصف
level	Integer	مستوى المعاملة المطلوب ضبطه، وهو أحد الخيارات التالية: Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED أو Jdbc.Connection.TRANSACTION_READ_COMMITTED أو Jdbc.Connection.TRANSACTION_REPEATABLE_READ أو Jdbc.Connection.TRANSACTION_SERIALIZABLE أو Jdbc.Connection.TRANSACTION_NONE.

التفويض

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

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