Class Jdbc

Jdbc

El servicio de JDBC permite que las secuencias de comandos se conecten a bases de datos de Google Cloud SQL, MySQL, Microsoft SQL Server y Oracle. Para obtener más información, consulta la guía de JDBC.

Métodos

MétodoTipo de datos que se muestraDescripción breve
getCloudSqlConnection(url)JdbcConnectionIntenta establecer una conexión con la URL de Google Cloud SQL proporcionada.
getCloudSqlConnection(url, info)JdbcConnectionIntenta establecer una conexión con la URL de Google Cloud SQL proporcionada.
getCloudSqlConnection(url, userName, password)JdbcConnectionIntenta establecer una conexión con la URL de Google Cloud SQL proporcionada.
getConnection(url)JdbcConnectionIntenta establecer una conexión con la URL de la base de datos proporcionada.
getConnection(url, info)JdbcConnectionIntenta establecer una conexión con la URL de la base de datos proporcionada.
getConnection(url, userName, password)JdbcConnectionIntenta establecer una conexión con la base de datos especificada usando un nombre de usuario y una contraseña.
newDate(milliseconds)JdbcDateCrea una fecha a partir de milisegundos desde la época.
newTime(milliseconds)JdbcTimeCrea un tiempo a partir de milisegundos desde la época.
newTimestamp(milliseconds)JdbcTimestampCrea una marca de tiempo a partir de milisegundos desde la época.
parseDate(date)JdbcDateCrea una fecha analizando la cadena de fecha de SQL.
parseTime(time)JdbcTimeCrea una hora analizando la cadena de hora de SQL.
parseTimestamp(timestamp)JdbcTimestampCrea una marca de tiempo analizando la cadena de marca de tiempo de SQL.

Documentación detallada

getCloudSqlConnection(url)

Intenta establecer una conexión con la URL de Google Cloud SQL proporcionada.

Parámetros

NombreTipoDescripción
urlStringEs una URL de base de datos con el formato jdbc:google:mysql://subname.

Volver

JdbcConnection: Es un objeto JdbcConnection.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/sqlservice

getCloudSqlConnection(url, info)

Intenta establecer una conexión con la URL de Google Cloud SQL proporcionada.

Parámetros

NombreTipoDescripción
urlStringEs una URL de base de datos con el formato jdbc:google:mysql://subname.
infoObjectObjeto JavaScript opcional que especifica parámetros avanzados, como se define a continuación.

Parámetros avanzados

NombreTipoDescripción
connectTimeoutSecondsIntegerTiempo de espera de conexión en segundos
databaseStringLa base de datos a la que se conectará
instanceStringEl nombre de una instancia de Google SQL Service
passwordStringLa contraseña del usuario
queryTimeoutSecondsIntegerTiempo de espera de la consulta en segundos
userStringEl nombre de usuario que se pasará a la base de datos

Volver

JdbcConnection: Es un objeto JdbcConnection.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/sqlservice

getCloudSqlConnection(url, userName, password)

Intenta establecer una conexión con la URL de Google Cloud SQL proporcionada.

Parámetros

NombreTipoDescripción
urlStringEs una URL de base de datos con el formato jdbc:google:mysql://subname.
userNameStringNombre de usuario que se pasará a la base de datos.
passwordStringContraseña del usuario.

Volver

JdbcConnection: Es un objeto JdbcConnection.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/sqlservice

getConnection(url)

Intenta establecer una conexión con la URL de la base de datos proporcionada. 

const conn = Jdbc.getConnection(
    'jdbc:mysql://yoursqlserver.example.com:3306/database_name',
);

Parámetros

NombreTipoDescripción
urlStringEs una URL de base de datos con el formato jdbc:subprotocol:subname.

Volver

JdbcConnection: Es un objeto JdbcConnection.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.external_request

getConnection(url, info)

Intenta establecer una conexión con la URL de la base de datos proporcionada. 

const conn = Jdbc.getConnection(
    'jdbc:mysql://yoursqlserver.example.com:3306/database_name',
    {user: 'username', password: 'password'},
);

Parámetros

NombreTipoDescripción
urlStringEs una URL de base de datos con el formato jdbc:subprotocol:subname.
infoObjectObjeto JavaScript opcional que especifica parámetros avanzados, como se define a continuación.

Parámetros avanzados

NombreTipoDescripción
databaseNameStringLa base de datos a la que se conectará
passwordStringLa contraseña del usuario
useJDBCCompliantTimeZoneShiftBooleanIndica si la conexión debe cumplir con las reglas de JDBC cuando se convierten las zonas horarias. El valor predeterminado es false.
userStringEl nombre de usuario que se pasará a la base de datos
_serverSslCertificateStringEl certificado SSL del servidor
_clientSslCertificateStringEl certificado SSL del cliente
_clientSslKeyStringLa clave SSL del cliente

Volver

JdbcConnection: Es un objeto JdbcConnection.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.external_request

getConnection(url, userName, password)

Intenta establecer una conexión con la base de datos especificada usando un nombre de usuario y una contraseña. 

const conn = Jdbc.getConnection(
    'jdbc:mysql://yoursqlserver.example.com:3306/database_name',
    'username',
    'password',
);

Parámetros

NombreTipoDescripción
urlStringEs una URL de base de datos con el formato jdbc:subprotocol:subname.
userNameStringNombre de usuario que se pasará a la base de datos.
passwordStringContraseña del usuario.

Volver

JdbcConnection: Es un objeto JdbcConnection.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/script.external_request

newDate(milliseconds)

Crea una fecha a partir de milisegundos desde la época.

Parámetros

NombreTipoDescripción
millisecondsIntegerMilisegundos desde el ciclo.

Volver

JdbcDate: Es un objeto JdbcDate.

newTime(milliseconds)

Crea un tiempo a partir de milisegundos desde la época.

Parámetros

NombreTipoDescripción
millisecondsIntegerMilisegundos desde el ciclo.

Volver

JdbcTime: Es un objeto JdbcTime.

newTimestamp(milliseconds)

Crea una marca de tiempo a partir de milisegundos desde la época.

Parámetros

NombreTipoDescripción
millisecondsIntegerMilisegundos desde el ciclo.

Volver

JdbcTimestamp: Es un objeto JdbcTimestamp.

parseDate(date)

Crea una fecha analizando la cadena de fecha de SQL.

Parámetros

NombreTipoDescripción
dateStringEs una cadena que contiene una cadena de fecha de SQL.

Volver

JdbcDate: Es un objeto JdbcDate.

parseTime(time)

Crea una hora analizando la cadena de hora de SQL.

Parámetros

NombreTipoDescripción
timeStringEs una cadena que contiene una cadena de tiempo de SQL.

Volver

JdbcTime: Es un objeto JdbcTime.

parseTimestamp(timestamp)

Crea una marca de tiempo analizando la cadena de marca de tiempo de SQL.

Parámetros

NombreTipoDescripción
timestampStringEs una cadena que contiene una cadena de marca de tiempo de SQL.

Volver

JdbcTimestamp: Es un objeto JdbcTimestamp.