Um Connection
JDBC. Para consultar a documentação dessa classe, consulte
java.sql.Connection
.
Métodos
Documentação detalhada
clearWarnings()
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()
createArrayOf(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.
createBlob()
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.
createClob()
Para consultar a documentação desse método, acesse
java.sql.Connection#createClob()
.
Retornar
Jdbc
: um objeto de grupo vazio.
createNClob()
Para consultar a documentação desse método, acesse
java.sql.Connection#createNClob()
.
Retornar
Jdbc
: um objeto nclob vazio.
createSQLXML()
Para consultar a documentação desse método, acesse
java.sql.Connection#createSQLXML()
.
Retornar
Jdbc
: um objeto SQLXML vazio.
createStatement()
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.
createStatement(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.
createStatement(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.
createStruct(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.
getAutoCommit()
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
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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
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
.
getMetaData()
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
getTransactionIsolation()
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
getWarnings()
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
isClosed()
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
isReadOnly()
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
isValid(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
nativeSQL(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
prepareCall(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.
prepareCall(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.
prepareCall(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.
prepareStatement(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.
prepareStatement(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.
prepareStatement(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.
prepareStatement(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.
prepareStatementByIndex(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.
prepareStatementByName(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.
releaseSavepoint(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
setAutoCommit(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
setCatalog(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
setHoldability(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 . |
setReadOnly(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
setSavepoint()
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
setSavepoint(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
setTransactionIsolation(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