Class JdbcConnection

JdbcConnection

Connection של JDBC. למסמכי העזרה של הכיתה הזו, אפשר לעיין ב- java.sql.Connection.

Methods

שיטהסוג הערך המוחזרתיאור קצר
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[]).

פרמטרים

שםסוגתיאור
typeNameStringהשם של סוג הרכיבים במערך ב-SQL, ספציפי למסד הנתונים. האפשרויות כוללות סוגי נתונים מובנים, סוגי נתונים מוגדרים על ידי משתמשים או סוגי נתונים רגילים של SQL שנתמכים במסד הנתונים.
elementsObject[]האלמנטים שרוצים לאכלס באובייקט המוחזר.

חזרה

JdbcArray – מערך שהאלמנטים שלו ממפים לסוג ה-SQL שצוין.


createBlob()

יצירת מכונה של JdbcBlob. למידע נוסף: java.sql.Connection#createBlob()

האובייקט המוחזר בהתחלה לא מכיל נתונים. אפשר להשתמש בשיטות setBytes של JdbcBlob כדי להגדיר את הנתונים שהיא אמורה להכיל. ה-blob שנעשה בו שימוש כאן הוא לא זהה ל-blob שנוצר באמצעות Utilities.newBlob(data). כדי להמיר בין שני הפורמטים, משתמשים בשיטות getBytes() ו-setBytes() שהוגדרו. לחלופין, גם JdbcBlob וגם JdbcClob מספקים שיטה נוחה getAppsScriptBlob() להמרה לפורמט שאפשר להשתמש בו ב-Apps Script.

חזרה

JdbcBlob – אובייקט blob ריק.


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();

פרמטרים

שםסוגתיאור
resultSetTypeIntegerסוג של קבוצת תוצאות. הערכים האפשריים הם Jdbc.ResultSet.TYPE_FORWARD_ONLY,‏ Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE או Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrencyIntegerסוג בו-זמניות: 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();

פרמטרים

שםסוגתיאור
resultSetTypeIntegerסוג של קבוצת תוצאות. הערכים האפשריים הם Jdbc.ResultSet.TYPE_FORWARD_ONLY,‏ Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE או Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrencyIntegerסוג בו-זמניות: Jdbc.ResultSet.CONCUR_READ_ONLY או Jdbc.ResultSet.CONCUR_UPDATABLE.
resultSetHoldabilityIntegerהגדרת היכולת להחזיק את הלחצן. הערכים האפשריים הם Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT או Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.

חזרה

JdbcStatement — מופע של משפט להרצת שאילתות.


createStruct(typeName, attributes)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#createStruct(String, Object[]).

פרמטרים

שםסוגתיאור
typeNameStringהשם של סוג הרכיבים במערך ב-SQL, ספציפי למסד הנתונים. האפשרויות כוללות סוגי נתונים מובנים, סוגי נתונים מוגדרים על ידי משתמשים או סוגי נתונים רגילים של SQL שנתמכים במסד הנתונים.
attributesObject[]המאפיינים שמאכלסים את האובייקט המוחזר.

חזרה

JdbcStruct – אובייקט מבנה שממופה לסוג ה-SQL הנתון ומאוכלס במאפיינים הנתונים.


getAutoCommit()

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#getAutoCommit().

חזרה

Booleantrue אם מצב ההתחייבות האוטומטית של החיבור מופעל, 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().

חזרה

Booleantrue אם החיבור סגור, false אחרת.

אישור

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

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

isReadOnly()

למסמכי התיעוד של השיטה הזו, אפשר לעיין ב- java.sql.Connection#isReadOnly().

חזרה

Booleantrue אם החיבור הוא לקריאה בלבד, false במקרים אחרים.

אישור

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

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

isValid(timeout)

למסמכי התיעוד של השיטה הזו, אפשר לעיין ב- java.sql.Connection#isValid(int).

פרמטרים

שםסוגתיאור
timeoutIntegerמשך הזמן בשניות להמתנה לסיום פעולת האימות. הערך 0 מציין שאין זמן קצוב לתפוגה.

חזרה

Booleantrue אם החיבור תקין, false אחרת. הפונקציה מחזירה את הערך false גם אם זמן הקצאת הזמן יפוג לפני שהפעולה תושלם.

אישור

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

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

nativeSQL(sql)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#nativeSQL(String).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר מסוג '?'.

חזרה

String – הפורמט המקורי של ההצהרה שצוינה.

אישור

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

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

prepareCall(sql)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareCall(String).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של '?', בדרך כלל באמצעות תחביר בריחה של קריאה ל-JDBC.

חזרה

JdbcCallableStatement – משפט שניתן לקריאה שמכיל את הצהרת ה-SQL שעברתה הידור מראש.


prepareCall(sql, resultSetType, resultSetConcurrency)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareCall(String, int, int).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של '?', בדרך כלל באמצעות תחביר בריחה של קריאה ל-JDBC.
resultSetTypeIntegerסוג של קבוצת תוצאות. הערכים האפשריים הם Jdbc.ResultSet.TYPE_FORWARD_ONLY,‏ Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE או Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrencyIntegerסוג בו-זמניות: Jdbc.ResultSet.CONCUR_READ_ONLY או Jdbc.ResultSet.CONCUR_UPDATABLE.

חזרה

JdbcCallableStatement – משפט שניתן לקריאה שמכיל את משפט ה-SQL שעבר הידור מראש, ויוצר קבוצות תוצאות עם הסוג והביצועים בו-זמנית שצוינו.


prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareCall(String, int, int, int).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של '?', בדרך כלל באמצעות תחביר בריחה של קריאה ל-JDBC.
resultSetTypeIntegerסוג של קבוצת תוצאות. הערכים האפשריים הם Jdbc.ResultSet.TYPE_FORWARD_ONLY,‏ Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE או Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrencyIntegerסוג בו-זמניות: Jdbc.ResultSet.CONCUR_READ_ONLY או Jdbc.ResultSet.CONCUR_UPDATABLE.
resultSetHoldabilityIntegerהגדרת היכולת להחזיק את הלחצן. הערכים האפשריים הם Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT או Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.

חזרה

JdbcCallableStatement — משפט שניתן לקריאה שמכיל את משפט ה-SQL שעבר הידור מראש, שמפיק קבוצות תוצאות עם הסוג שצוין, concurrency.


prepareStatement(sql)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareStatement(String).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של הפרמטר '?' IN.

חזרה

JdbcPreparedStatement – הצהרה מוכנה שמכילה את הצהרת ה-SQL שעבר הידור מראש.


prepareStatement(sql, autoGeneratedKeys)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareStatement(String, int).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של הפרמטר '?' IN.
autoGeneratedKeysIntegerדגל שמציין אם מפתחות שנוצרו באופן אוטומטי יחזרו. הערכים האפשריים הם Jdbc.Statement.RETURN_GENERATED_KEYS או Jdbc.Statement.NO_GENERATED_KEYS.

חזרה

JdbcPreparedStatement – הצהרה מוכנה שמכילה את הצהרת ה-SQL שעבר הידור מראש, ויכול להיות שהיא מסוגלת להחזיר מפתחות שנוצרו באופן אוטומטי.


prepareStatement(sql, resultSetType, resultSetConcurrency)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareStatement(String, int, int).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של הפרמטר '?' IN.
resultSetTypeIntegerסוג של קבוצת תוצאות. הערכים האפשריים הם Jdbc.ResultSet.TYPE_FORWARD_ONLY,‏ Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE או Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrencyIntegerסוג בו-זמניות: Jdbc.ResultSet.CONCUR_READ_ONLY או Jdbc.ResultSet.CONCUR_UPDATABLE.

חזרה

JdbcPreparedStatement – הצהרה מוכנה שמכילה את הצהרת ה-SQL שעבר הידור מראש, ויוצרת קבוצות תוצאות עם הסוג והביצועים בו-זמנית שצוינו.


prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareStatement(String, int, int, int).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של הפרמטר '?' IN.
resultSetTypeIntegerסוג של קבוצת תוצאות. הערכים האפשריים הם Jdbc.ResultSet.TYPE_FORWARD_ONLY,‏ Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE או Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE.
resultSetConcurrencyIntegerסוג בו-זמניות: Jdbc.ResultSet.CONCUR_READ_ONLY או Jdbc.ResultSet.CONCUR_UPDATABLE.
resultSetHoldabilityIntegerהגדרת היכולת להחזיק את הלחצן. הערכים האפשריים הם Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT או Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.

חזרה

JdbcPreparedStatement — הצהרה מוכנה שמכילה את הצהרת ה-SQL שעברתה הידור מראש, ויוצרת קבוצות תוצאות עם הסוג, התזמון והיכולת לשמירה שצוינו.


prepareStatementByIndex(sql, indices)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareStatement(String, int[]).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של הפרמטר '?' IN.
indicesInteger[]אינדקסי העמודות של העמודות שמוחזרות מהשורה או מהשורות שהוכנסו.

חזרה

JdbcPreparedStatement – הצהרה מוכנה שמכילה את הצהרת ה-SQL שעבר הידור מראש, ויכולה להחזיר מפתחות שנוצרו באופן אוטומטי לפי אינדקסי העמודות שצוינו.


prepareStatementByName(sql, columnNames)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#prepareStatement(String, String[]).

פרמטרים

שםסוגתיאור
sqlStringמשפט SQL שעשוי להכיל placeholder אחד או יותר של הפרמטר '?' IN.
columnNamesString[]שמות העמודות שמציינים אילו עמודות השיטה צריכה להחזיר מהשורה או מהשורות שהוכנסו.

חזרה

JdbcPreparedStatement – משפט מוכן שמכיל את משפט ה-SQL שעבר הידור מראש, ויכול להחזיר מפתחות שנוצרו באופן אוטומטי לפי שמות העמודות שצוינו.


releaseSavepoint(savepoint)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#releaseSavepoint(Savepoint).

פרמטרים

שםסוגתיאור
savepointJdbcSavepointנקודת השמירה שרוצים להסיר.

אישור

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

  • 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).

פרמטרים

שםסוגתיאור
savepointJdbcSavepointנקודת השמירה שאליה רוצים לחזור אחורה.

אישור

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

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

setAutoCommit(autoCommit)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#setAutoCommit(boolean).

פרמטרים

שםסוגתיאור
autoCommitBooleanאם true, מצב ההתחייבות האוטומטי מופעל. אם false, הוא מושבת.

אישור

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

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

setCatalog(catalog)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#setCatalog(String).

פרמטרים

שםסוגתיאור
catalogStringהשם של קטלוג (המרחב המשני במסד הנתונים של החיבור) שבו רוצים לעבוד.

אישור

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

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

setHoldability(holdability)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#setHoldability(int).

פרמטרים

שםסוגתיאור
holdabilityIntegerברירת המחדל של היכולת להשהות אובייקטים מסוג JdbcResultSet שנוצרו באמצעות החיבור הזה, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT או Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.

setReadOnly(readOnly)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#setReadOnly(boolean).

פרמטרים

שםסוגתיאור
readOnlyBooleanאם 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).

פרמטרים

שםסוגתיאור
nameStringהשם של נקודת השמירה שנוצרה.

חזרה

JdbcSavepoint — נקודת השמירה החדשה עם השם.

אישור

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

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

setTransactionIsolation(level)

למסמכי העזרה של השיטה הזו, ראו java.sql.Connection#setTransactionIsolation(int).

פרמטרים

שםסוגתיאור
levelIntegerרמת העסקה להגדרה, מתוך: 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