Um Connection
do JDBC. Para ver a documentação dessa classe, consulte
java.sql.Connection
.
Métodos
Documentação detalhada
clearWarnings()
Para ver a documentação desse método, consulte
java.sql.Connection#clearWarnings()
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
close()
Libere o banco de dados dessa conexão e todos os recursos associados.
var conn = Jdbc.getConnection("jdbc:mysql://<host>:<port>/<instance>", "user", "password"); conn.close();
Veja também
-
Connection.close()
commit()
Torna todas as mudanças pendentes permanentes e libera os bloqueios do banco de dados retidos por este JdbcConnection
.
var conn = Jdbc.getConnection("jdbc:mysql://<host>:<port>/<instance>", "user", "password"); conn.setAutoCommit(false); var stmt = conn.prepareStatement("insert into person (lname,fname) values (?,?)"); var start = new Date(); for (var i = 0; i < 5000; i++) { // Objects are accessed using 1-based indexing stmt.setObject(1, 'firstName' + i); stmt.setObject(2, 'lastName' + i); stmt.addBatch(); } var 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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
Veja também
-
Connection.commit()
createArrayOf(typeName, elements)
Para ver a documentação desse 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 do tipo dos elementos da matriz. As opções incluem tipos integrados, definidos pelo usuário ou tipos SQL padrão compatíveis com o banco de dados. |
elements | Object[] | Os elementos a serem preenchidos no objeto retornado. |
Retorno
JdbcArray
: uma matriz cujos elementos são mapeados para o tipo SQL especificado.
createBlob()
Cria uma instância de JdbcBlob
. Consulte também
java.sql.Connection#createBlob()
.
Inicialmente, o objeto retornado não contém dados. Você pode usar os métodos setBytes
de
JdbcBlob
para definir os dados que ele precisa conter. O blob usado aqui não é o mesmo 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 método prático de getAppsScriptBlob()
para converter em um formato que possa ser usado pelo Apps Script.
Retorno
JdbcBlob
: um objeto blob vazio.
createClob()
Para ver a documentação desse método, consulte
java.sql.Connection#createClob()
.
Retorno
JdbcClob
: um objeto clob vazio.
createNClob()
Para ver a documentação desse método, consulte
java.sql.Connection#createNClob()
.
Retorno
JdbcClob
: um objeto nclob vazio.
createSQLXML()
Para ver a documentação desse método, consulte
java.sql.Connection#createSQLXML()
.
Retorno
JdbcSQLXML
: um objeto SQLXML vazio.
createStatement()
Cria um objeto JdbcStatement
para enviar instruções SQL para o banco de dados. Consulte também
java.sql.Connection#createStatement()
.
// This sample code assumes authentication is off var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(); stmt.setMaxRows(100); var rs = stmt.execute("select * from person"); while(rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
Retorno
JdbcStatement
: uma instância de instrução para executar consultas.
createStatement(resultSetType, resultSetConcurrency)
Cria um objeto JdbcStatement
para enviar instruções SQL para o banco de dados. Consulte também
java.sql.Connection#createStatement(int, int)
.
Esta 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) var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY); stmt.setMaxRows(100); var 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 . |
Retorno
JdbcStatement
: uma instância de instrução para executar consultas.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
Cria um objeto JdbcStatement
para enviar instruções SQL para o 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 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) var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT); stmt.setMaxRows(100); var 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 . |
Retorno
JdbcStatement
: uma instância de instrução para executar consultas.
createStruct(typeName, attributes)
Para ver a documentação desse 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 do tipo dos elementos da matriz. As opções incluem tipos integrados, definidos pelo usuário ou tipos SQL padrão compatíveis com o banco de dados. |
attributes | Object[] | Os atributos que preenchem o objeto retornado. |
Retorno
JdbcStruct
: um objeto de estrutura mapeado para o tipo SQL especificado e preenchido com os atributos fornecidos.
getAutoCommit()
Para ver a documentação desse método, consulte
java.sql.Connection#getAutoCommit()
.
Retorno
Boolean
: true
se o modo de confirmação automática da conexão estiver ativado. Caso contrário, será false
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getCatalog()
ou documentação desse método, consulte
java.sql.Connection#getCatalog()
.
Retorno
String
: o nome do catálogo atual ou null
se nenhum nome tiver sido definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
Para ver a documentação desse método, consulte
java.sql.Connection#getHoldability()
.
Retorno
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 ver a documentação desse método, consulte
java.sql.Connection#getMetaData()
.
Retorno
JdbcDatabaseMetaData
: os metadados do banco de dados ao qual esta conexão se conecta.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getTransactionIsolation()
Para ver a documentação desse método, consulte
java.sql.Connection#getTransactionIsolation()
.
Retorno
Integer
: o nível atual da transação, que é um destes: 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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
Para ver a documentação desse método, consulte
java.sql.Connection#getWarnings()
.
Retorno
String[]
: uma matriz de strings de aviso.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
isClosed()
Para ver a documentação desse método, consulte
java.sql.Connection#isClosed()
.
Retorno
Boolean
: true
se a conexão for encerrada. Caso contrário, false
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
Para ver a documentação desse método, consulte
java.sql.Connection#isReadOnly()
.
Retorno
Boolean
: true
se a conexão for somente leitura. Caso contrário, false
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
Para ver 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 0 indica que nenhum tempo limite foi aplicado. |
Retorno
Boolean
: true
se a conexão for válida. Caso contrário, será false
. Também retorna false
quando o tempo limite expira antes da conclusão da operação.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
Para ver a documentação desse 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 marcador '?'. |
Retorno
String
: a forma nativa da instrução fornecida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
Para ver a documentação desse 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 marcador "?" geralmente fornecido usando a sintaxe de escape de chamada do JDBC. |
Retorno
JdbcCallableStatement
: uma instrução chamável contendo a instrução SQL pré-compilada.
prepareCall(sql, resultSetType, resultSetConcurrency)
Para ver a documentação desse 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 marcador "?" geralmente fornecido 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 . |
Retorno
JdbcCallableStatement
: uma instrução chamável contendo a instrução SQL pré-compilada que produz conjuntos de resultados com o tipo e a simultaneidade fornecidos.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para ver a documentação desse 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 marcador "?" geralmente fornecido 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 . |
Retorno
JdbcCallableStatement
: uma instrução chamável contendo a instrução SQL pré-compilada que produz conjuntos de resultados com o tipo fornecido de simultaneidade.
prepareStatement(sql)
Para ver a documentação desse 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 '?' IN marcadores de parâmetros. |
Retorno
JdbcPreparedStatement
: uma instrução preparada que contém a instrução SQL pré-compilada.
prepareStatement(sql, autoGeneratedKeys)
Para ver a documentação desse 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 '?' IN marcadores de parâmetros. |
autoGeneratedKeys | Integer | Uma sinalização que indica se as chaves geradas automaticamente são retornadas, seja Jdbc.Statement.RETURN_GENERATED_KEYS ou Jdbc.Statement.NO_GENERATED_KEYS . |
Retorno
JdbcPreparedStatement
: uma instrução preparada que contém a instrução SQL pré-compilada, possivelmente capaz de
retornar chaves geradas automaticamente.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Para ver a documentação desse 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 '?' IN marcadores de parâmetros. |
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 . |
Retorno
JdbcPreparedStatement
: uma instrução preparada que contém a instrução SQL pré-compilada que produz conjuntos de resultados com o tipo e a simultaneidade fornecidos.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para ver a documentação desse 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 '?' IN marcadores de parâmetros. |
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 . |
Retorno
JdbcPreparedStatement
: uma instrução preparada que contém a instrução SQL pré-compilada que produz conjuntos de resultados com o tipo, a simultaneidade e a capacidade de retenção fornecidos.
prepareStatementByIndex(sql, indices)
Para ver a documentação desse 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 '?' IN marcadores de parâmetros. |
indices | Integer[] | Os índices de coluna de colunas que são retornadas da linha ou linhas inseridas. |
Retorno
JdbcPreparedStatement
: uma instrução preparada que contém 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 desse 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 '?' IN marcadores de parâmetros. |
columnNames | String[] | Os nomes de coluna que especificam quais colunas o método precisa retornar da linha ou linhas inseridas. |
Retorno
JdbcPreparedStatement
: uma instrução preparada que contém a instrução SQL pré-compilada, capaz de retornar chaves geradas automaticamente especificadas pelos nomes de coluna fornecidos.
releaseSavepoint(savepoint)
Para ver a documentação desse 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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
rollback()
Para ver a documentação desse método, consulte
java.sql.Connection#rollback()
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
Para ver a documentação desse método, consulte
java.sql.Connection#rollback(Savepoint)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
savepoint | JdbcSavepoint | O ponto de salvamento para o qual voltar. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
Para ver a documentação desse método, consulte
java.sql.Connection#setAutoCommit(boolean)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
autoCommit | Boolean | Se for true , o modo de confirmação automática será ativado, e false será desativado. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
Para ver a documentação desse 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 você quer trabalhar. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
Para ver a documentação desse método, consulte
java.sql.Connection#setHoldability(int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
holdability | Integer | A capacidade de retenção padrão de objetos JdbcResultSet criados com essa conexão; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
setReadOnly(readOnly)
Para ver a documentação desse 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 será desativado. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
Para ver a documentação desse método, consulte
java.sql.Connection#setSavepoint()
.
Retorno
JdbcSavepoint
: o novo ponto de salvamento sem nome.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
Para ver a documentação desse método, consulte
java.sql.Connection#setSavepoint(String)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
name | String | Nome do ponto de salvamento criado. |
Retorno
JdbcSavepoint
: o novo ponto de salvamento nomeado.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
setTransactionIsolation(level)
Para ver a documentação desse método, consulte
java.sql.Connection#setTransactionIsolation(int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
level | Integer | O nível da transação a ser definido, que é um destes: 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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request