Um Connection do JDBC. Para conferir a documentação dessa classe, consulte
java.sql.Connection.
Métodos
Documentação detalhada
clearWarnings()
Para ver a documentação deste método, consulte
java.sql.Connection#clearWarnings().
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
close()
Libere o banco de dados desta conexão e todos os recursos associados.
const conn = Jdbc.getConnection( 'jdbc:mysql://<host>:<port>/<instance>', 'user', 'password', ); conn.close();
Consulte também
-
Connection.close()
commit()
Torna todas as mudanças pendentes permanentes e libera bloqueios do banco de dados mantidos por esse 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();
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
Consulte também
-
Connection.commit()
createArrayOf(typeName, elements)
Para ver a documentação deste método, consulte
java.sql.Connection#createArrayOf(String, Object[]).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
typeName | String | O nome SQL específico do banco de dados dos elementos da matriz não é válido. As opções incluem integrados, definidos pelo usuário ou SQL padrão com suporte no banco de dados. |
elements | Object[] | Os elementos a serem preenchidos no objeto retornado. |
Retornar
JdbcArray: uma matriz com elementos que são mapeados para o tipo SQL especificado.
createBlob()
Cria uma instância de JdbcBlob. Consulte também
java.sql.Connection#createBlob().
O objeto retornado inicialmente não contém dados. Use os métodos setBytes
JdbcBlob para definir os dados que ela deve conter. O blob usado aqui não é o mesmo que o
blob criado com Utilities.newBlob(data). Para converter
entre os dois formatos, use os métodos getBytes() e setBytes() definidos.
Como alternativa, JdbcBlob e JdbcClob fornecem um getAppsScriptBlob()
de conversão para um formato que pode ser usado pelo Apps Script.
Retornar
JdbcBlob: um objeto blob vazio.
createClob()
Para conferir a documentação desse método, consulte
java.sql.Connection#createClob().
Retornar
JdbcClob: um objeto clob vazio.
createNClob()
Para conferir a documentação desse método, consulte
java.sql.Connection#createNClob().
Retornar
JdbcClob: um objeto nclob vazio.
createSQLXML()
Para conferir a documentação desse método, consulte
java.sql.Connection#createSQLXML().
Retornar
JdbcSQLXML: um objeto SQLXML vazio.
createStatement()
Cria um objeto JdbcStatement para enviar instruções SQL ao banco de dados. Consulte também
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();
Retornar
JdbcStatement: uma instância de instrução para executar consultas.
createStatement(resultSetType, resultSetConcurrency)
Cria um objeto JdbcStatement para enviar instruções SQL ao banco de dados. Consulte também
java.sql.Connection#createStatement(int, int).
Essa versão permite que o tipo de conjunto de resultados e a simultaneidade sejam substituídos.
// 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();
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
resultSetType | Integer | Um tipo de conjunto de resultados Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Um tipo de simultaneidade Jdbc.ResultSet.CONCUR_READ_ONLY
ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
Retornar
JdbcStatement: uma instância de instrução para executar consultas.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
Cria um objeto JdbcStatement para enviar instruções SQL ao banco de dados. Consulte também
java.sql.Connection#createStatement(int, int, int).
Essa versão permite que o tipo de conjunto de resultados, simultaneidade e a capacidade de retenção sejam substituídos.
// 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();
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
resultSetType | Integer | Um tipo de conjunto de resultados Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Um tipo de simultaneidade Jdbc.ResultSet.CONCUR_READ_ONLY
ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
resultSetHoldability | Integer | Uma configuração de retenção; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
Retornar
JdbcStatement: uma instância de instrução para executar consultas.
createStruct(typeName, attributes)
Para ver a documentação deste método, consulte
java.sql.Connection#createStruct(String, Object[]).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
typeName | String | O nome SQL específico do banco de dados dos elementos da matriz não é válido. As opções incluem integrados, definidos pelo usuário ou SQL padrão com suporte no banco de dados. |
attributes | Object[] | Os atributos que preenchem o objeto retornado. |
Retornar
JdbcStruct: um objeto de estrutura que é mapeado para o tipo SQL especificado e é preenchido com a
atributos.
getAutoCommit()
Para ver a documentação deste método, consulte
java.sql.Connection#getAutoCommit().
Retornar
Boolean: true se o modo de confirmação automática da conexão estiver ativado. Caso contrário, false.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getCatalog()
ou a documentação desse método, consulte
java.sql.Connection#getCatalog().
Retornar
String: o nome do catálogo atual ou null se nenhum nome tiver sido definido.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
Para ver a documentação deste método, consulte
java.sql.Connection#getHoldability().
Retornar
Integer: a configuração de retenção da conexão. Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.
getMetaData()
Para conferir a documentação desse método, consulte
java.sql.Connection#getMetaData().
Retornar
JdbcDatabaseMetaData: os metadados do banco de dados a que a conexão se conecta.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getTransactionIsolation()
Para ver a documentação deste método, consulte
java.sql.Connection#getTransactionIsolation().
Retornar
Integer: o nível da transação atual, que pode ser Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED, Jdbc.Connection.TRANSACTION_READ_COMMITTED, Jdbc.Connection.TRANSACTION_REPEATABLE_READ, Jdbc.Connection.TRANSACTION_SERIALIZABLE ou Jdbc.Connection.TRANSACTION_NONE.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
Para conferir a documentação desse método, consulte
java.sql.Connection#getWarnings().
Retornar
String[]: uma matriz de strings de aviso.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
isClosed()
Para conferir a documentação desse método, consulte
java.sql.Connection#isClosed().
Retornar
Boolean: true se a conexão for encerrada. Caso contrário, false.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
Para conferir a documentação desse método, consulte
java.sql.Connection#isReadOnly().
Retornar
Boolean: true se a conexão for somente leitura. Caso contrário, false.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
Para conferir a documentação desse método, consulte
java.sql.Connection#isValid(int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
timeout | Integer | O tempo em segundos para aguardar a conclusão da operação de validação. Um valor de O valor "0" indica que o tempo limite não foi aplicado. |
Retornar
Boolean: true se a conexão for válida. Caso contrário, false. Também retorna false se o período de tempo limite expirar antes da conclusão da operação.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
Para ver a documentação deste método, consulte
java.sql.Connection#nativeSQL(String).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" espaços reservados. |
Retornar
String: a forma nativa da instrução fornecida.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareCall(String).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" espaços reservados, normalmente fornecidos usando a sintaxe de escape de chamada do JDBC. |
Retornar
JdbcCallableStatement: uma instrução chamável contendo a instrução SQL pré-compilada.
prepareCall(sql, resultSetType, resultSetConcurrency)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareCall(String, int, int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" espaços reservados, normalmente fornecidos usando a sintaxe de escape de chamada do JDBC. |
resultSetType | Integer | Um tipo de conjunto de resultados Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Um tipo de simultaneidade Jdbc.ResultSet.CONCUR_READ_ONLY
ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
Retornar
JdbcCallableStatement: uma instrução chamável contendo a instrução SQL pré-compilada que produz o resultado
com o tipo e a simultaneidade fornecidos.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareCall(String, int, int, int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" espaços reservados, normalmente fornecidos usando a sintaxe de escape de chamada do JDBC. |
resultSetType | Integer | Um tipo de conjunto de resultados Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Um tipo de simultaneidade Jdbc.ResultSet.CONCUR_READ_ONLY
ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
resultSetHoldability | Integer | Uma configuração de retenção; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
Retornar
JdbcCallableStatement: uma instrução chamável contendo a instrução SQL pré-compilada que produz o resultado
com o tipo fornecido, simultaneidade.
prepareStatement(sql)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareStatement(String).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" Marcadores de posição do parâmetro IN. |
Retornar
JdbcPreparedStatement: uma instrução preparada contendo a instrução SQL pré-compilada.
prepareStatement(sql, autoGeneratedKeys)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareStatement(String, int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" Marcadores de posição do parâmetro IN. |
autoGeneratedKeys | Integer | Uma sinalização que indica se as chaves geradas automaticamente são retornadas. de cada
Jdbc.Statement.RETURN_GENERATED_KEYS ou Jdbc.Statement.NO_GENERATED_KEYS. |
Retornar
JdbcPreparedStatement: uma instrução preparada contendo a instrução SQL pré-compilada, possivelmente capaz de
retornando chaves geradas automaticamente.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareStatement(String, int, int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" Marcadores de posição do parâmetro IN. |
resultSetType | Integer | Um tipo de conjunto de resultados Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Um tipo de simultaneidade Jdbc.ResultSet.CONCUR_READ_ONLY
ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
Retornar
JdbcPreparedStatement: uma instrução preparada contendo a instrução SQL pré-compilada que produz o resultado
com o tipo e a simultaneidade fornecidos.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareStatement(String, int, int, int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" Marcadores de posição do parâmetro IN. |
resultSetType | Integer | Um tipo de conjunto de resultados Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Um tipo de simultaneidade Jdbc.ResultSet.CONCUR_READ_ONLY
ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
resultSetHoldability | Integer | Uma configuração de retenção; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
Retornar
JdbcPreparedStatement: uma instrução preparada contendo a instrução SQL pré-compilada que produz o resultado
definidos com o tipo, simultaneidade e capacidade de retenção fornecidos.
prepareStatementByIndex(sql, indices)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareStatement(String, int[]).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" Marcadores de posição do parâmetro IN. |
indices | Integer[] | Os índices das colunas retornados a partir das linhas inseridas. |
Retornar
JdbcPreparedStatement: uma instrução preparada contendo a instrução SQL pré-compilada, capaz de retornar
chaves geradas automaticamente especificadas pelos índices de coluna fornecidos.
prepareStatementByName(sql, columnNames)
Para ver a documentação deste método, consulte
java.sql.Connection#prepareStatement(String, String[]).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sql | String | Uma instrução SQL que pode conter mais um "?" Marcadores de posição do parâmetro IN. |
columnNames | String[] | Os nomes das colunas que especificam de quais colunas o método deve retornar. as linhas inseridas. |
Retornar
JdbcPreparedStatement: uma instrução preparada contendo a instrução SQL pré-compilada, capaz de retornar
geradas automaticamente, especificadas pelos nomes das colunas fornecidas.
releaseSavepoint(savepoint)
Para ver a documentação deste método, consulte
java.sql.Connection#releaseSavepoint(Savepoint).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
savepoint | JdbcSavepoint | O ponto de salvamento a ser removido. |
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
rollback()
Para conferir a documentação desse método, consulte
java.sql.Connection#rollback().
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
Para ver a documentação deste método, consulte
java.sql.Connection#rollback(Savepoint).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
savepoint | JdbcSavepoint | O ponto de salvamento para a reversão. |
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
Para ver a documentação deste método, consulte
java.sql.Connection#setAutoCommit(boolean).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
autoCommit | Boolean | Se true, o modo de confirmação automática será ativado. false é desativado. |
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
Para ver a documentação deste método, consulte
java.sql.Connection#setCatalog(String).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
catalog | String | O nome de um catálogo (o subespaço no banco de dados da conexão) em que funcionam. |
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
Para ver a documentação deste método, consulte
java.sql.Connection#setHoldability(int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
holdability | Integer | A retenção padrão dos objetos JdbcResultSet criados com esse
conexão Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
setReadOnly(readOnly)
Para ver a documentação deste método, consulte
java.sql.Connection#setReadOnly(boolean).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
readOnly | Boolean | Se true, o modo somente leitura será ativado. false é desativado. |
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
Para conferir a documentação desse método, consulte
java.sql.Connection#setSavepoint().
Retornar
JdbcSavepoint: o novo ponto de salvamento sem nome.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
Para ver a documentação deste método, consulte
java.sql.Connection#setSavepoint(String).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
name | String | O nome do ponto de salvamento criado. |
Retornar
JdbcSavepoint: o novo ponto de salvamento nomeado.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setTransactionIsolation(level)
Para ver a documentação deste método, consulte
java.sql.Connection#setTransactionIsolation(int).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
level | Integer | O nível de transação a ser definido, que é Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED, Jdbc.Connection.TRANSACTION_READ_COMMITTED, Jdbc.Connection.TRANSACTION_REPEATABLE_READ, Jdbc.Connection.TRANSACTION_SERIALIZABLE ou Jdbc.Connection.TRANSACTION_NONE. |
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request