O serviço JDBC permite a conexão de scripts com o Google Cloud SQL, MySQL, Microsoft SQL Server e bancos de dados Oracle. Para mais informações, consulte o guia do JDBC.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
getCloudSqlConnection(url) | JdbcConnection | Tenta estabelecer uma conexão com o URL do Google Cloud SQL fornecido. |
getCloudSqlConnection(url, info) | JdbcConnection | Tenta estabelecer uma conexão com o URL do Google Cloud SQL fornecido. |
getCloudSqlConnection(url, userName, password) | JdbcConnection | Tenta estabelecer uma conexão com o URL do Google Cloud SQL fornecido. |
getConnection(url) | JdbcConnection | Tenta estabelecer uma conexão com o URL de banco de dados fornecido. |
getConnection(url, info) | JdbcConnection | Tenta estabelecer uma conexão com o URL de banco de dados fornecido. |
getConnection(url, userName, password) | JdbcConnection | Tenta estabelecer uma conexão com o banco de dados fornecido usando um nome de usuário e senha. |
newDate(milliseconds) | JdbcDate | Cria uma data a partir de milissegundos desde a época. |
newTime(milliseconds) | JdbcTime | Cria um horário a partir de milissegundos desde o período. |
newTimestamp(milliseconds) | JdbcTimestamp | Cria um carimbo de data/hora a partir de milissegundos desde a época. |
parseDate(date) | JdbcDate | Criar uma data analisando a string de data SQL. |
parseTime(time) | JdbcTime | Crie um horário analisando a string de hora do SQL. |
parseTimestamp(timestamp) | JdbcTimestamp | Crie um carimbo de data/hora analisando a string de carimbo de data/hora SQL. |
Documentação detalhada
getCloudSqlConnection(url)
Tenta estabelecer uma conexão com o URL do Google Cloud SQL fornecido.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
url | String | Um URL de banco de dados no formato jdbc:google:mysql://subname. |
Retornar
JdbcConnection: um objeto JdbcConnection.
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/sqlservice
getCloudSqlConnection(url, info)
Tenta estabelecer uma conexão com o URL do Google Cloud SQL fornecido.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
url | String | Um URL de banco de dados no formato jdbc:google:mysql://subname. |
info | Object | Objeto JavaScript opcional que especifica parâmetros avançados conforme definido abaixo. |
Parâmetros avançados
| Nome | Tipo | Descrição |
|---|---|---|
connectTimeoutSeconds | Integer | tempo limite de conexão em segundos |
database | String | no banco de dados ao qual se conectar |
instance | String | o nome de uma instância do Google SQL Service; |
password | String | a senha do usuário |
queryTimeoutSeconds | Integer | tempo limite da consulta em segundos |
user | String | o nome de usuário a ser passado para o banco de dados |
Retornar
JdbcConnection: um objeto JdbcConnection.
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/sqlservice
getCloudSqlConnection(url, userName, password)
Tenta estabelecer uma conexão com o URL do Google Cloud SQL fornecido.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
url | String | Um URL de banco de dados no formato jdbc:google:mysql://subname. |
userName | String | O nome de usuário a ser passado para o banco de dados. |
password | String | A senha do usuário. |
Retornar
JdbcConnection: um objeto JdbcConnection.
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/sqlservice
getConnection(url)
Tenta estabelecer uma conexão com o URL de banco de dados fornecido.
const conn = Jdbc.getConnection( 'jdbc:mysql://yoursqlserver.example.com:3306/database_name', );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
url | String | Um URL de banco de dados no formato jdbc:subprotocol:subname. |
Retornar
JdbcConnection: um objeto JdbcConnection.
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
getConnection(url, info)
Tenta estabelecer uma conexão com o URL de banco de dados fornecido.
const conn = Jdbc.getConnection( 'jdbc:mysql://yoursqlserver.example.com:3306/database_name', {user: 'username', password: 'password'}, );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
url | String | Um URL de banco de dados no formato jdbc:subprotocol:subname. |
info | Object | Objeto JavaScript opcional que especifica parâmetros avançados conforme definido abaixo. |
Parâmetros avançados
| Nome | Tipo | Descrição |
|---|---|---|
databaseName | String | no banco de dados ao qual se conectar |
password | String | a senha do usuário |
useJDBCCompliantTimeZoneShift | Boolean | se a conexão deve ou não
obedecer às regras do JDBC ao converter fusos horários. O padrão é false. |
user | String | o nome de usuário a ser passado para o banco de dados |
_serverSslCertificate | String | o certificado SSL do servidor |
_clientSslCertificate | String | o certificado SSL do cliente |
_clientSslKey | String | a chave SSL do cliente. |
Retornar
JdbcConnection: um objeto JdbcConnection.
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
getConnection(url, userName, password)
Tenta estabelecer uma conexão com o banco de dados fornecido usando um nome de usuário e senha.
const conn = Jdbc.getConnection( 'jdbc:mysql://yoursqlserver.example.com:3306/database_name', 'username', 'password', );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
url | String | Um URL de banco de dados no formato jdbc:subprotocol:subname. |
userName | String | O nome de usuário a ser passado para o banco de dados. |
password | String | A senha do usuário. |
Retornar
JdbcConnection: um objeto JdbcConnection.
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
newDate(milliseconds)
Cria uma data a partir de milissegundos desde a época.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
milliseconds | Integer | Milissegundos desde a época. |
Retornar
JdbcDate: um objeto JdbcDate.
newTime(milliseconds)
Cria um horário a partir de milissegundos desde o período.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
milliseconds | Integer | Milissegundos desde a época. |
Retornar
JdbcTime: um objeto JdbcTime.
newTimestamp(milliseconds)
Cria um carimbo de data/hora a partir de milissegundos desde a época.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
milliseconds | Integer | Milissegundos desde a época. |
Retornar
JdbcTimestamp: um objeto JdbcTimestamp.
parseDate(date)
Criar uma data analisando a string de data SQL.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
date | String | Uma string contendo uma string de data SQL. |
Retornar
JdbcDate: um objeto JdbcDate.
parseTime(time)
Crie um horário analisando a string de hora do SQL.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
time | String | Uma string contendo uma string de hora SQL. |
Retornar
JdbcTime: um objeto JdbcTime.
parseTimestamp(timestamp)
Crie um carimbo de data/hora analisando a string de carimbo de data/hora SQL.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
timestamp | String | Uma string contendo uma string de carimbo de data/hora SQL. |
Retornar
JdbcTimestamp: um objeto JdbcTimestamp.