Saltar al contenido principal
Ir al Studio
Database

SQL Server

SQL Server

El módulo SQL Server es responsable de conectarse a un SGBD SQL Server, realizar consultas y manipular los resultados dentro del robot.

Métodos​

connection​

Método responsable de crear una conexión con una base de datos SQL Server.

js
const connection = await Database.SQLServer.connection["v1_0_0"]({
  connectionString: `Server=localhost;1433;Database=master;User Id=admin;password=123;TrustServerCertificate=True;`,
})

Parámetros obligatorios​

  • connectionString: String - espera un string con los parámetros de la conexión. Se debe seguir el estándar conforme al ejemplo mostrado anteriormente.

Parámetros opcionales​

Esta acción no tiene parámetros opcionales.

Retorno​

Esta acción no tiene retornos.

close​

Método responsable de cerrar una conexión abierta con una base de datos SQL Server.

js
await Database.SQLServer.close["v1_0_0"]({
  connection: connection,
})

Parámetros obligatorios​

  • connection: Retorno de la acción de conexión - espera la conexión obtenida a través de la acción connection.

Parámetros opcionales​

Esta acción no tiene parámetros opcionales.

Retorno​

Esta acción no tiene retornos.

transactionBegin​

Método responsable de crear una transacción con el SGBD SQL Server.

js
const transaction = await Database.SQLServer.transactionBegin["v1_0_0"]({
  connection: connection,
})

Parámetros obligatorios​

  • connection: Retorno de la acción de conexión - espera la conexión obtenida a través de la acción connection.

Parámetros opcionales​

Esta acción no tiene parámetros opcionales.

Retorno​

Esta acción no tiene retornos.

transactionCommit​

Método responsable de aplicar (confirmar) una transacción abierta por la acción transactionBegin.

js
await Database.SQLServer.transactionCommit["v1_0_0"]({
  transaction: transaction,
})

Parámetros obligatorios​

  • transaction: Retorno de la acción de iniciar una transacción - espera la transacción obtenida a través de la acción transactionBegin.

Parámetros opcionales​

Esta acción no tiene parámetros opcionales.

Retorno​

Esta acción no tiene retornos.

transactionRollBack​

Método responsable de deshacer una transacción (rollback) abierta por la acción transactionBegin.

js
await Database.SQLServer.transactionRollBack["v1_0_0"]({
  transaction: transaction,
})

Parámetros obligatorios​

  • transaction: Retorno de la acción de iniciar una transacción - espera la transacción obtenida a través de la acción transactionBegin.

Parámetros opcionales​

Esta acción no tiene parámetros opcionales.

Retorno​

Esta acción no tiene retornos.

query​

Método responsable de realizar una consulta directamente en la base de datos a través de la conexión obtenida por la acción connection.

js
const query = await Database.SQLServer.query["v1_0_0"]({
  query: `SELECT * FROM tabela;`,
  connection: connection,
  transaction: transaction
})

Parámetros obligatorios​

  • connection: Retorno de la acción de conexión - espera la conexión obtenida a través de la acción connection.
  • query: String - espera un string con la consulta que será realizada.

Parámetros opcionales​

  • transaction: Retorno de la acción transactionBegin - espera la transacción obtenida a través de la acción transactionBegin.

Retorno​

La constante o variable creada, como la query del ejemplo mostrado anteriormente, recibirá un valor del tipo Object. El objeto devuelto tendrá las siguientes propiedades:

  • query.query: String - devuelve la consulta que fue utilizada.
  • query.results: Array - devuelve todos los resultados obtenidos con la consulta.
  • query.resultsCount: Number - devuelve la cantidad de filas obtenidas en el resultado.