Pular para o conteúdo principal
Acessar Studio
Database

MySQL

MySQL

O módulo MySQL é responsável por criar uma conexão e manipular dados de um banco de dados MySQL.

Métodos​

connection​

Ação responsável por criar uma conexão com o banco de dados MySQL.

js
const connection = await Database.MySQL.connection.v1_0_0({
  host: '',
  port: number,
  user: '',
  password: '',
  localAddress?: '',
  socketPath?: '',
  timezone?: '',
  connectTimeout?: number,
  stringifyObjects?: boolean,
  insecureAuth?: boolean,
  typeCast?: boolean,
  supportBigNumbers?: boolean,
  bigNumberStrings?: boolean,
  dateStrings?: boolean,
  debug?: boolean,
  trace?: boolean,
  multipleStatements?: boolean,
  flags?: '',
  ssl?: '',
  database?: '',
})

Parâmetros obrigatórios​

  • host: String - espera o nome do host do banco de dados ao qual você está se conectando.
  • port: Number - espera o número da porta à qual deseja se conectar.
  • user: String - espera o usuário do MySQL.
  • password: String - espera a senha do MySQL.

Parâmetros opcionais​

  • database: String - nome da base de dados.
  • localAddress: String - endereço IP de origem a ser usado para conexão TCP.
  • socketPath: String - caminho para um soquete de domínio unix ao qual deseja se conectar.
  • timezone: Number - fuso horário configurado no servidor MySQL.
  • connectTimeout: Number - milissegundos para o tempo limite de conexão com o servidor MySQL.
  • stringifyObjects: Boolean - se true, objetos são convertidos para string.
  • insecureAuth: Boolean - se true, permite conexão com instâncias que solicitam autenticação antiga (insegura).
  • typeCast: Boolean - se true, valores de coluna são convertidos em tipos JavaScript nativos.
  • supportBigNumbers: Boolean - se true, lida com colunas BIGINT e DECIMAL.
  • bigNumberStrings: Boolean - se true, força BIGINT e DECIMAL a serem retornados como String.
  • dateStrings: Boolean - se true, forçar tipos de data a serem retornados como strings.
  • debug: Boolean - se true, imprime detalhes do protocolo em stdout.
  • trace: Boolean - se true, gera rastreamentos de pilha de Erros.
  • multipleStatements: Boolean - se true, permite várias instruções MySQL por consulta.
  • flags: String - flags a serem inseridas ou removidas das consultas.
  • ssl: String - objeto com parâmetros SSL ou string com o nome do perfil SSL.

Retorno​

Esta ação não possui retorno.

getDataValue​

Ação responsável por obter um determinado dado de uma posição de uma resposta de um comando SQL executado em um banco de dados MySQL.

js
const getDataValue = await Database.MySQL.getDataValue.v1_0_0({
  column: '',
  row: 1,
  query: ''
})

Parâmetros obrigatórios​

  • column: String - nome da coluna do MySQL desejada.
  • row: Number - posição em que o dado desejado se encontra no retorno da query executada.

Parâmetros opcionais​

  • query: String - ID da conexão MySQL criada anteriormente pela ação de conexão.

Retorno​

A constante ou variável criada, como a getDataValue do exemplo mostrado anteriormente, receberá um valor do tipo Object. O objeto retornado terá a seguinte propriedade:

  • getDataValue.values: text - retorna o dado obtido de uma query MySQL.

getReply​

Ação responsável por obter a resposta de um comando SQL executado em um banco de dados MySQL. Pode ser utilizada após um SELECT.

js
const getReply = await Database.MySQL.getReply.v1_0_0({
  query: ''
})

Parâmetros obrigatórios​

Esta ação não possui parâmetros obrigatórios.

Parâmetros opcionais​

  • query: String - ID da conexão MySQL criada anteriormente pela ação de conexão.

Retorno​

A constante ou variável criada, como a getReply do exemplo mostrado anteriormente, receberá um valor do tipo Object. O objeto retornado terá a seguinte propriedade:

  • getReply.values: array - retorna os resultados de um SELECT executado em uma query MySQL.

query​

Ação responsável por executar um comando SQL em um banco de dados MySQL.

js
const query = await Database.MySQL.query.v1_0_0({
  connection: connection,
  query: '',
  timeout: 1
})

Parâmetros obrigatórios​

  • connection: Retorno da ação de conexão - ID da conexão MySQL criada anteriormente.
  • query: String - query a ser executada. Exemplo: SELECT * FROM teste.teste.
  • timeout: Number - tempo de espera em segundos para execução da ação. Padrão: 0.

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.size: number - quantidade de dados retornados pela query.
  • query.query: text - indica se a query foi executada.
  • query.response: array - resultados da query.
  • query.insertedId: number - ID do registro inserido.
  • query.affectedRows: number - quantidade de linhas afetadas.
  • query.changedRows: number - quantidade de linhas alteradas.

close​

Ação responsável por encerrar uma conexão com o banco de dados MySQL.

js
await Database.MySQL.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 retorno.

transactionBegin​

Ação responsável por iniciar uma transação em uma conexão MySQL.

js
await Database.MySQL.transactionBegin["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 retorno.

transactionCommit​

Ação responsável por confirmar (commit) uma transação iniciada em uma conexão MySQL.

js
await Database.MySQL.transactionCommit["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 retorno.

transactionRollback​

Ação responsável por desfazer (rollback) uma transação iniciada em uma conexão MySQL.

js
await Database.MySQL.transactionRollback["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 retorno.