runSQLonDB: Executar SQL em SGBD

In ricardoscr/MARA: Pacote que reúne diversas funções utilitárias de aplicação geral no projeto MARA da DIE.

Description

Esta função se conecta a um SGBD definido por um Data Source configurado e usa usuário/senha obtidos em arquivo database_logins.txt e executa SQL passado via objeto ou arquivo.

Usage

runSQLonDB(nomeConexaoODBC, nomeArquivoComSQL = NULL, querySQL = NULL,
  nomeBanco = NULL, padCPFeCNPJ = TRUE, showSuccessMessage = TRUE)

Arguments

nomeConexaoODBC	nome do Data Source configurado para o SGBD desejado.
nomeArquivoComSQL	nome do arquivo .sql a ser executado. Só executa caso não haja objeto querySQL definido.
querySQL	objeto de texto/character com comando SQL a ser executado.
nomeBanco	nome do banco de dados do SGBD onde dados serão consultados.
padCPFeCNPJ	flag que define se deve haver padding de colunas de CPF e/ou CNPJ.
showSuccessMessage	flag que define se a mensagem de sucesso deverá ser exibida.

Details

Esta função inicialmente lê o arquivo database_logins.txt que deve estar na mesma pasta do Working Directory (definido com setwd) e obtém usuário e senha para o Data Source indicado como argumento. Em seguida, havendo objeto com SQL em querySQL, o mesmo é executado, caso contrário executa o arquivo .sql em nomeArquivoComSQL. Para flag padCPFeCNPJ setada, o resultado do SQL é tratado para realizar padding de qualquer coluna contendo o texto cpf/CPF/cnpj/CNPJ. Para flag showSuccessMessage setada, havendo sucesso na consulta, a mensagem de sucesso padrão é exibida. Caso sejam executados vários SQLs em sequência, recomenda-se definir showSuccessMessage como FALSE, pois assim somente aparece mensagem em caso de ERRO em algum SQL.

Value

um data frame com resultado do SQL.

Author(s)

Ricardo S. Carvalho

See Also

insertDataIntoDB, instrucoes.SQLServer, instrucoes.MySQL

Examples

# Obter dados do Data Source Esfinge configurado
# SQL encontra-se no arquivo de nome "Query_Esfinge_GABCRG_Punidos.sql"
dadosESFINGE <- runSQLonDB("Esfinge", "Query_Esfinge_GABCRG_Punidos.sql")

ricardoscr/MARA documentation built on May 27, 2019, 7:41 a.m.