Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPADatabase

Oracle

Oracle

O módulo Oracle é responsável por conectar em um SGBD Oracle, realizar queries e manipular os resultados dentro do robô.

Métodos​

connection​

Método responsável por criar uma conexão com um banco de dados Oracle.

js
const connection = await Database.Oracle.connection["v1_0_0"]({
  user: "userRoberty",
  password: "robertyBD123",
  connectString: "localhost:1521/robertyBD",
  connectTimeout: 10,
  queryTimeout: 60,
})

Parâmetros obrigatórios​

  • user: String - espera o usuário do banco de dados Oracle.
  • password: String - espera a senha do usuário.
  • connectString: String - espera a string de conexão do Oracle (ex.: localhost:1521/robertyBD).

Parâmetros opcionais​

  • connectTimeout: Number - tempo máximo, em segundos, para o servidor aceitar a conexão.
  • queryTimeout: Number - tempo limite padrão, em segundos, de toda query feita com esta conexão. 0 = sem limite.

Retorno​

Retorna a conexão aberta, que deve ser armazenada em uma variável (como connection no exemplo) e informada no parâmetro connection dos demais métodos.

A versão v2_0_0 deste método recebe, no lugar de user, password e connectString, o connectionId de uma conexão configurada no workspace (Workspace → Conexões), além dos mesmos connectTimeout e queryTimeout:

js
const connection = await Database.Oracle.connection["v2_0_0"]({
  connectionId: "id-da-conexao-configurada-no-workspace",
  connectTimeout: 10,
  queryTimeout: 60,
})

close​

Método responsável por fechar uma conexão aberta com um banco de dados Oracle.

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

Parâmetros obrigatórios​

  • connection: Retorno da ação de conexão - espera a conexão obtida através da ação connection.

Parâmetros opcionais​

Esta ação não possui parâmetros opcionais.

Retorno​

Esta ação não possui retornos.

query​

Método responsável por realizar uma query diretamente no banco de dados através da conexão obtida pela ação connection.

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

Parâmetros obrigatórios​

  • connection: Retorno da ação de conexão - espera a conexão obtida através da ação connection.
  • query: String - espera uma string com a query a ser realizada.

Parâmetros opcionais​

  • timeout: Number - tempo limite, em segundos, desta query. Se omitido, vale o queryTimeout da conexão. 0 = sem limite. Ao atingir o limite, a promise é rejeitada com um erro cuja mensagem começa com Timeout. Quando nem timeout nem o queryTimeout da conexão são informados, não há limite.

Retorno​

A constante ou variável criada, como a query do exemplo mostrado anteriormente, receberá um valor do tipo Object. O objeto retornado terá as seguintes propriedades:

  • query.query: String - retorna a query que foi utilizada.
  • query.results: Array - retorna todos os resultados obtidos com a query.
  • query.resultsCount: Number - retorna a quantidade de linhas obtidas no resultado.