Um Connection
JDBC. Para consultar a documentação dessa classe, consulte
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()
Libere o banco de dados dessa 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 os bloqueios de banco de dados mantidos por essa 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 de matriz. As opções incluem tipos integrados, tipos definidos pelo usuário ou tipos SQL padrão aceitos pelo 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 que o
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 converter 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 de grupo 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 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 |
---|---|---|
result | Integer | Um tipo de conjunto de resultados: 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 que o tipo de conjunto de resultados, a 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 |
---|---|---|
result | Integer | Um tipo de conjunto de resultados: 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 de matriz. As opções incluem tipos integrados, tipos definidos pelo usuário ou tipos SQL padrão aceitos pelo 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
especificados.
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 retenção da conexão, 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 de 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 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 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
is Closed()
Para consultar a documentação desse método, acesse
java.sql.Connection#isClosed()
.
Retornar
Boolean
: true
se a conexão estiver fechada. 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
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. 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
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 de espera para a conclusão da operação de validação. Um valor de 0 indica que não há tempo limite. |
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 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 "?". |
Retornar
String
: o formulário nativo 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
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 "?", normalmente 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 "?", normalmente fornecidos usando a sintaxe de escape de chamada JDBC. |
result | Integer | Um tipo de conjunto de resultados: 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 "?", normalmente fornecidos usando a sintaxe de escape de chamada JDBC. |
result | Integer | Um tipo de conjunto de resultados: 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 fornecido, concorrência.
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 do parâmetro "?". |
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 do parâmetro "?". |
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 do parâmetro "?". |
result | Integer | Um tipo de conjunto de resultados: 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 do parâmetro "?". |
result | Integer | Um tipo de conjunto de resultados: 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 do parâmetro "?". |
indices | Integer[] | Os índices de colunas retornados 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 í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 do parâmetro "?". |
column | String[] | Os nomes das colunas que especificam quais colunas o método precisa retornar 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 o qual o rollback será feito. |
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 é 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 de 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 está 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 da transação a ser definido, que pode ser 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