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