insertDataIntoDB: Inserir dados em tabela de 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 insere dados passados na tabela escolhida.

Usage

insertDataIntoDB(nomeConexaoODBC, dadosNOVOS, nomeBanco = NULL, nomeTabela,
  verboseInsert = FALSE, showSuccessMessage = TRUE,
  setIdentityInsert = FALSE)

Arguments

nomeConexaoODBC	nome do Data Source configurado para o SGBD desejado.
dadosNOVOS	data frame com dados a serem inseridos. Deve conter colunas com exatamente os mesmos nomes que as colunas da tabela onde dados serão inseridos (case sensitive).
nomeBanco	nome do banco de dados do SGBD onde dados serão inseridos.
nomeTabela	nome da tabela do SGBD onde dados serão inseridos.
verboseInsert	flag que define se deve exibir mensagens de inserção do SGBD.
showSuccessMessage	flag que define se a mensagem de sucesso deverá ser exibida.
setIdentityInsert	flag que define se deve setar Identity_Insert para On antes de inserir dados.

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, insere data frame dadosNOVOS na tabela nomeTabela. O objeto dadosNOVOS deve conter colunas com exatamente os mesmos nomes que as colunas da tabela onde dados serão inseridos (case sensitive). Para flag verboseInsert setada, as mensagens do SGBD para o insert são exibidas. Para flag showSuccessMessage setada, havendo sucesso na consulta, a mensagem de sucesso padrão é exibida. Caso sejam executados vários inserts em sequência, recomenda-se definir showSuccessMessage como FALSE, pois assim somente aparece mensagem em caso de ERRO em algum insert.

Value

mensagem de erro ou sucesso.

Author(s)

Ricardo S. Carvalho

See Also

runSQLonDB, instrucoes.SQLServer, instrucoes.MySQL

Examples

# Inserir data frama df_NatResp usando data source sed-die-bd1-c
# na tabela dbo.natresp localizada no dw_mara_stage
insertDataIntoDB('sed-die-bd1-c', df_NatResp, 'natresp')

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