Esta página foi traduzida pela API Cloud Translation.

Class Jdbc

O serviço JDBC permite que scripts se conectem a bancos de dados Google Cloud SQL, MySQL, Microsoft SQL Server e Oracle. Para mais informações, consulte o guia sobre 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 especificado.
`getConnection(url, info)`	`JdbcConnection`	Tenta estabelecer uma conexão com o URL do banco de dados especificado.
`getConnection(url, userName, password)`	`JdbcConnection`	Tenta estabelecer uma conexão com o banco de dados usando um nome de usuário e uma senha.
`newDate(milliseconds)`	`JdbcDate`	Cria uma data a partir de milissegundos desde a época.
`newTime(milliseconds)`	`JdbcTime`	Crie um horário a partir de milissegundos desde a época.
`newTimestamp(milliseconds)`	`JdbcTimestamp`	Crie um carimbo de data/hora a partir de milissegundos desde a época.
`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 do 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 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`	o banco de dados a ser conectado
`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 ao banco de dados

Retornar

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

Retornar

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 especificado.

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 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 especificado.

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`	o banco de dados a ser conectado
`password`	`String`	a senha do usuário
`useJDBCCompliantTimeZoneShift`	`Boolean`	se a conexão precisa 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 transmitido ao 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 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 usando um nome de usuário e uma 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 transmitido ao banco de dados.
`password`	`String`	A senha do usuário.

Retornar

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 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)`

Crie um horário a partir de milissegundos desde a época.

Parâmetros

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

Retornar

JdbcTime: um objeto JdbcTime.

`newTimestamp(milliseconds)`

Crie 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)`

Crie uma data analisando a string de data SQL.

Parâmetros

Nome	Tipo	Descrição
`date`	`String`	Uma string que contém uma string de data SQL.

Retornar

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`	Uma string que contém uma string de tempo SQL.

Retornar

JdbcTime: um objeto JdbcTime.

`parseTimestamp(timestamp)`

Crie um carimbo de data/hora analisando a string de carimbo de data/hora do SQL.

Parâmetros

Nome	Tipo	Descrição
`timestamp`	`String`	Uma string que contém uma string de carimbo de data/hora SQL.

Retornar

JdbcTimestamp: um objeto JdbcTimestamp.