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