Um Connection
JDBC. Para consultar a documentação dessa classe, acesse
java.sql.Connection
.
Métodos
Documentação detalhada
clear Warnings()
Para consultar a documentação desse método, acesse
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()
Libera 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 permanentes todas as mudanças pendentes e libera os bloqueios do banco de dados mantidos por este Jdbc
.
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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
Consulte também
-
Connection.commit()
create Array Of(typeName, elements)
Para consultar a documentação desse método, acesse
java.sql.Connection#createArrayOf(String, Object[])
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
type | String | O nome SQL específico do banco de dados do tipo de elementos da matriz. As opções incluem tipos integrados, definidos pelo usuário ou SQL padrão compatíveis com o banco de dados. |
elements | Object[] | Os elementos a serem preenchidos no objeto retornado. |
Retornar
Jdbc
: uma matriz cujos elementos são mapeados para o tipo SQL especificado.
create Blob()
Cria uma instância de Jdbc
. Consulte também
java.sql.Connection#createBlob()
.
O objeto retornado inicialmente não contém dados. É possível usar os métodos set
de
Jdbc
para definir os dados que ele deve conter. O blob usado aqui não é o mesmo criado com Utilities.newBlob(data)
. Para converter
entre os dois formatos, use os métodos get
e set
definidos.
Como alternativa, Jdbc
e Jdbc
oferecem um método de conveniência get
para conversão em um formato que pode ser usado pelo Apps Script.
Retornar
Jdbc
: um objeto blob vazio.
create Clob()
Para consultar a documentação desse método, acesse
java.sql.Connection#createClob()
.
Retornar
Jdbc
: um objeto CLOB vazio.
create NClob()
Para consultar a documentação desse método, acesse
java.sql.Connection#createNClob()
.
Retornar
Jdbc
: um objeto nclob vazio.
create SQLXML()
Para consultar a documentação desse método, acesse
java.sql.Connection#createSQLXML()
.
Retornar
Jdbc
: um objeto SQLXML vazio.
create Statement()
Cria um objeto Jdbc
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
Jdbc
: uma instância de instrução para executar consultas.
create Statement(resultSetType, resultSetConcurrency)
Cria um objeto Jdbc
para enviar instruções SQL ao banco de dados. Consulte também
java.sql.Connection#createStatement(int, int)
.
Essa versão permite substituir o tipo de conjunto de resultados e a simultaneidade.
// 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 |
---|---|---|
result | Integer | Um tipo de conjunto de resultados, um de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Um tipo de simultaneidade: Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
Retornar
Jdbc
: uma instância de instrução para executar consultas.
create Statement(resultSetType, resultSetConcurrency, resultSetHoldability)
Cria um objeto Jdbc
para enviar instruções SQL ao banco de dados. Consulte também
java.sql.Connection#createStatement(int, int, int)
.
Essa versão permite substituir o tipo de conjunto de resultados, a simultaneidade e a capacidade de retenção.
// 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 |
---|---|---|
result | Integer | Um tipo de conjunto de resultados, um de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Um tipo de simultaneidade: Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Uma configuração de capacidade de retenção, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Retornar
Jdbc
: uma instância de instrução para executar consultas.
create Struct(typeName, attributes)
Para consultar a documentação desse método, acesse
java.sql.Connection#createStruct(String, Object[])
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
type | String | O nome SQL específico do banco de dados do tipo de elementos da matriz. As opções incluem tipos integrados, definidos pelo usuário ou SQL padrão compatíveis com o banco de dados. |
attributes | Object[] | Os atributos que preenchem o objeto retornado. |
Retornar
Jdbc
: um objeto de estrutura que é mapeado para o tipo SQL especificado e preenchido com os atributos fornecidos.
get Auto Commit()
Para consultar a documentação desse método, acesse
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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
get Catalog()
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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
get Holdability()
Para consultar a documentação desse método, acesse
java.sql.Connection#getHoldability()
.
Retornar
Integer
: a configuração de capacidade de retenção da conexão, que pode ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
.
get Meta Data()
Para consultar a documentação desse método, acesse
java.sql.Connection#getMetaData()
.
Retornar
Jdbc
: os metadados do banco de dados a que essa 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
get Transaction Isolation()
Para consultar a documentação desse método, acesse
java.sql.Connection#getTransactionIsolation()
.
Retornar
Integer
: o nível atual da transação, que é um dos seguintes: 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
get Warnings()
Para consultar a documentação desse método, acesse
java.sql.Connection#getWarnings()
.
Retornar
String[]
: uma matriz de strings de alerta.
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
is Closed()
Para consultar a documentação desse método, acesse
java.sql.Connection#isClosed()
.
Retornar
Boolean
: true
se a conexão for fechada; false
caso contrário.
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
is Read Only()
Para consultar a documentação desse método, acesse
java.sql.Connection#isReadOnly()
.
Retornar
Boolean
: true
se a conexão for somente leitura; false
caso contrário.
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
is Valid(timeout)
Para consultar a documentação desse método, acesse
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. |
Retornar
Boolean
: true
se a conexão for válida; false
caso contrário. 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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
native SQL(sql)
Para consultar a documentação desse método, acesse
java.sql.Connection#nativeSQL(String)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição "?". |
Retornar
String
: a forma nativa da declaraçã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
prepare Call(sql)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareCall(String)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição "?", geralmente fornecidos usando a sintaxe de escape de chamada JDBC. |
Retornar
Jdbc
: uma instrução invocável que contém a instrução SQL pré-compilada.
prepare Call(sql, resultSetType, resultSetConcurrency)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareCall(String, int, int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição "?", geralmente fornecidos usando a sintaxe de escape de chamada JDBC. |
result | Integer | Um tipo de conjunto de resultados, um de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Um tipo de simultaneidade: Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
Retornar
Jdbc
: uma instrução invocável que contém a instrução SQL pré-compilada que produz conjuntos de resultados com o tipo e a simultaneidade fornecidos.
prepare Call(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareCall(String, int, int, int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição "?", geralmente fornecidos usando a sintaxe de escape de chamada JDBC. |
result | Integer | Um tipo de conjunto de resultados, um de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Um tipo de simultaneidade: Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Uma configuração de capacidade de retenção, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Retornar
Jdbc
: uma instrução invocável que contém a instrução SQL pré-compilada que produz conjuntos de resultados com o tipo e a simultaneidade fornecidos.
prepare Statement(sql)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareStatement(String)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição de parâmetro IN "?". |
Retornar
Jdbc
: uma instrução preparada que contém a instrução SQL pré-compilada.
prepare Statement(sql, autoGeneratedKeys)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareStatement(String, int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição de parâmetro IN "?". |
auto | Integer | Uma flag que indica se as chaves geradas automaticamente são retornadas; Jdbc.Statement.RETURN_GENERATED_KEYS ou Jdbc.Statement.NO_GENERATED_KEYS . |
Retornar
Jdbc
: uma instrução preparada que contém a instrução SQL pré-compilada, possivelmente capaz de
retornar chaves geradas automaticamente.
prepare Statement(sql, resultSetType, resultSetConcurrency)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareStatement(String, int, int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição de parâmetro IN "?". |
result | Integer | Um tipo de conjunto de resultados, um de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Um tipo de simultaneidade: Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
Retornar
Jdbc
: 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.
prepare Statement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareStatement(String, int, int, int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição de parâmetro IN "?". |
result | Integer | Um tipo de conjunto de resultados, um de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Um tipo de simultaneidade: Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Uma configuração de capacidade de retenção, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Retornar
Jdbc
: 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.
prepare Statement By Index(sql, indices)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareStatement(String, int[])
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição de parâmetro IN "?". |
indices | Integer[] | Os índices das colunas retornadas da linha ou linhas inseridas. |
Retornar
Jdbc
: 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.
prepare Statement By Name(sql, columnNames)
Para consultar a documentação desse método, acesse
java.sql.Connection#prepareStatement(String, String[])
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sql | String | Uma instrução SQL que pode conter um ou mais marcadores de posição de parâmetro IN "?". |
column | String[] | Os nomes das colunas que especificam quais colunas o método precisa retornar da linha ou das linhas inseridas. |
Retornar
Jdbc
: 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.
release Savepoint(savepoint)
Para consultar a documentação desse método, acesse
java.sql.Connection#releaseSavepoint(Savepoint)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
savepoint | Jdbc | 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 consultar a documentação desse método, acesse
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 consultar a documentação desse método, acesse
java.sql.Connection#rollback(Savepoint)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
savepoint | Jdbc | O ponto de salvamento para fazer o 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
set Auto Commit(autoCommit)
Para consultar a documentação desse método, acesse
java.sql.Connection#setAutoCommit(boolean)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
auto | Boolean | Se true , o modo de confirmação automática será ativado. false desativa. |
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
set Catalog(catalog)
Para consultar a documentação desse método, acesse
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 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
set Holdability(holdability)
Para consultar a documentação desse método, acesse
java.sql.Connection#setHoldability(int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
holdability | Integer | A capacidade de retenção padrão dos objetos Jdbc criados com essa
conexão: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
set Read Only(readOnly)
Para consultar a documentação desse método, acesse
java.sql.Connection#setReadOnly(boolean)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
read | Boolean | Se true , o modo somente leitura será ativado. false desativa. |
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
set Savepoint()
Para consultar a documentação desse método, acesse
java.sql.Connection#setSavepoint()
.
Retornar
Jdbc
: 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
set Savepoint(name)
Para consultar a documentação desse método, acesse
java.sql.Connection#setSavepoint(String)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
name | String | O nome do ponto de salvamento criado. |
Retornar
Jdbc
: 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
set Transaction Isolation(level)
Para consultar a documentação desse método, acesse
java.sql.Connection#setTransactionIsolation(int)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
level | Integer | O nível de transação a ser definido, que é um dos seguintes: 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