Esta página foi traduzida pela API Cloud Translation.

Class Jdbc

(link em inglês)

O serviço JDBC permite que os scripts se conectem a bancos de dados do Google Cloud SQL, MySQL, Microsoft SQL Server e 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 do banco de dados fornecido.
`getConnection(url, info)`	`JdbcConnection`	Tenta estabelecer uma conexão com o URL do banco de dados fornecido.
`getConnection(url, userName, password)`	`JdbcConnection`	Tenta estabelecer uma conexão com o banco de dados especificado usando um nome de usuário e uma senha.
`newDate(milliseconds)`	`JdbcDate`	Cria uma data de milissegundos desde é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 de milissegundos desde o período.
`parseDate(date)`	`JdbcDate`	Crie uma data analisando a string de data SQL.
`parseTime(time)`	`JdbcTime`	Crie um horário analisando a string de horário 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`.

Retorno

JdbcConnection: um objeto JdbcConnection.

Autorização

Os scripts que usam esse método exigem 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`	ao banco de dados para 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 transmitido para o banco de dados

Retorno

JdbcConnection: um objeto JdbcConnection.

Autorização

Os scripts que usam esse método exigem 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 transmitido para o banco de dados.
`password`	`String`	A senha do usuário.

Retorno

JdbcConnection: um objeto JdbcConnection.

Autorização

Os scripts que usam esse método exigem 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 do banco de dados fornecido.

var 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`.

Retorno

JdbcConnection: um objeto JdbcConnection.

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

`getConnection(url, info)`

Tenta estabelecer uma conexão com o URL do banco de dados fornecido.

var 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`	ao banco de dados para 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 o fuso horário. O padrão é `false`.
`user`	`String`	o nome de usuário a ser transmitido para o banco de dados
`_serverSslCertificate`	`String`	certificado SSL do servidor
`_clientSslCertificate`	`String`	certificado SSL do cliente
`_clientSslKey`	`String`	a chave SSL do cliente

Retorno

JdbcConnection: um objeto JdbcConnection.

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

`getConnection(url, userName, password)`

Tenta estabelecer uma conexão com o banco de dados especificado usando um nome de usuário e uma senha.

var 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 transmitido para o banco de dados.
`password`	`String`	A senha do usuário.

Retorno

JdbcConnection: um objeto JdbcConnection.

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

`newDate(milliseconds)`

Cria uma data de milissegundos desde época.

Parâmetros

Nome	Tipo	Descrição
`milliseconds`	`Integer`	Milissegundos desde a época.

Retorno

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.

Retorno

JdbcTime: um objeto JdbcTime.

`newTimestamp(milliseconds)`

Cria um carimbo de data/hora de milissegundos desde o período.

Parâmetros

Nome	Tipo	Descrição
`milliseconds`	`Integer`	Milissegundos desde a época.

Retorno

JdbcTimestamp: um objeto JdbcTimestamp.

`parseDate(date)`

Crie uma data analisando a string de data SQL.

Parâmetros

Nome	Tipo	Descrição
`date`	`String`	Uma string contendo uma string de data SQL.

Retorno

JdbcDate: um objeto JdbcDate.

`parseTime(time)`

Crie um horário analisando a string de horário SQL.

Parâmetros

Nome	Tipo	Descrição
`time`	`String`	String com uma string de tempo SQL.

Retorno

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.

Retorno

JdbcTimestamp: um objeto JdbcTimestamp.