Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice:


       

Índice
exclude.*ndice:

Objetivo


       O objetivo deste documento é demonstrar como configurar uma conexão em

...

Banco de Dados Externo MySQL

...

Produto:

...

Serviços Globais

...

Versões:

...

11.8x, 12.1.x

...

Ocorrência:

...

Configuração da conexão a um banco de dados externo utilizando o MySQL

...

Ambiente:

...

Biblioteca RM --> Qualquer modulo --> Gestão --> Visão de Dados

...

Passo a passo:

e como utilizá-lo em uma Consulta SQL. 

Introdução


          O RM permite a utilização de Banco de Dados Externo com o MySQL para execução de Consultas SQL. A configuração da Conexão de banco pode ser feita na própria tela de edição da Consulta, em qualquer módulo, menu 'Gestão | Visão de Dados', ou no módulo 'Serviços Globais', menu 'Segurança | Conexões a banco de dados externos'.

          Veja nos passos a seguir como deve ser feito o procedimento para utilização desse recurso.

 

Informações
iconfalse
Deck of Cards
idDesenvolvimento/Procedimento
Card
idPasso 1
labelPasso 1
titlePasso 1

 Crie a sentença SQL desejada, acessando o menu 'Gestão | Visões de Dados' e clique no botão Incluir (Ctrl + Ins).

Image Added

Em seguida, clique em Banco de Dados Externo, para vincular a Consulta ao banco MySQL.

Por essa tela também é possível gerenciar as conexões externas existentes em Consultas SQL, criar novas ou editar.

Image Added

Card
idPasso 2
labelPasso 2
titlePasso 2

Para cadastrar uma nova conexão, após acessar a tela de Conexões a banco de dados externos, clique no botão Incluir (Ctrl + Ins) e preencha os principais campos, como demonstrado no exemplo abaixo:

Image Added

Clique em "String de conexão", selecione o Data Source e Data Provider conforme seu ambiente. No exemplo a seguir, usaremos uma conexão ´MySQL.

Image Added

Clique em "OK".

  

Passo a passo:

ANÁLISE

Criar normalmente uma consulta SQL normalmente, e vincular um banco de dados externo MYSQL.

Image Removed
Imagem 1 – Criação de consulta SQL com banco de dados externo MYSQL.

...

 Testar a conexão com o banco de dados; a mesma deve ter o resultado positivo, como a imagem abaixo.

Image Modified
Imagem 2 – Teste da conexão sucedida.

 

Se ao clicar no botão salvar, o erro evidenciado abaixo¹ aconteça, algumas providências terão que ser tomadas para que a consulta possa ser devidamente executada.

Image Modified
Imagem 3 – Não conformidade que poderá ser apresentada, caso algumas
configurações estiverem incorretas.

 

SOLUÇÃO

Dentro da pasta Config no caminho descrito pela imagem abaixo [C:\windows\Microsoft.NET\Framework\v4.0.30319\Config]² abrir um arquivo chamado de Machine.Config.

Image Modified
Imagem 4 – Arquivo machine.config.

 

Ao abrir o arquivo machine.config, verifique se:

  • A tag <DbProviderFactories> está presente nesse arquivo;
  • A tag <DbProviderFactories> “fecha” corretamente, ou seja, se existe a diretiva </ DbProviderFactories>
  • Alguma entrada filha dessa tag <DbProviderFactories> está vazia;
  • A entrada filha cujo nome é “MySQL Data Provider” está presente.

Image Modified
Imagem 5 – Tag <DbProviderFactories>.


Correções necessárias, caso algum dos casos acima aconteçam:

  •   Caso a tag <DbProviderFactories> não exista adicione-a como filha da tag <System.Data>.
  •   Caso a tag <DbProviderFactories> não feche corretamente, adicione a diretiva </ DbProviderFactories>
  •   Caso alguma entrada da tag <DbProviderFactories> estiver vazia, remova-a.
  •   Caso a entrada “MySQL Data Provider” não estiver presente adicioná-la.
<add name="MySQL Data Provider" invariant="MySql.Data.MySqlClient" description=".Net Framework Data Provider for MySQL" type="MySql.Data.MySqlClient.MySqlClientFactory,
MySql.Data, Version=6.9.8.0, Culture=neutral, PublicKeyToken=c5687fc88969c44d" />

Ao verificar e/ou corrigir as inconsistências indicadas acima, é hora de comparar a versão entre a entrada evidenciada no quadro acima “MySQL Data Provider” e a versão do MySql.Data.dll.

Image Modified
Imagem 6 – Versão da entrada “MySQL Data Provider”.


Image Modified
Imagem 7 – Versão do arquivo MySql.Data.dll.

 

A versão tanto do arquivo MySql.Data.dll, quanto da entrada “MySQL Data Provider” deve ser a mesma.

O arquivo MySql.Data.dll se encontra na pasta RM.Net [C:\windows\totvs\CorporeRM\RM.Net], pasta padrão onde foi instalado a biblioteca RM.

Image Modified
Imagem 8 –
Localização do arquivo MySql.Data.dll.


Caso o passo a passo descrito até aqui tenha seguido corretamente, a consulta SQL será executada corretamente.

 Image Modified

Observações:

1 - A causa da mensagem de não conformidade evidenciada na imagem 3 é porque a versão do arquivo MySql.Data.dll estava diferente da versão da entrada “MySQL Data Provider”.

2 - A pasta v4.0.30319 se refere a versão do .NET framework instalado na máquina, deve-se verificar na pasta do framework instalado na máquina, sendo ele versão 4, 4.5, 4.6, etc....

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 11.82.XX ou 12.01.XX

Informações
iconfalse

Processo: Banco de Dados Externo

Informações
iconfalse

Subprocesso: Conexão a Banco de Dados Externo MySQL

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data: 26/07/2016

Informações
iconfalse

Autores:

Douglas Maxwell de Oliveira

Fábio Augusto Amaral Melo Nunes

Karina Dos Santos Costa

Stella Gleyse Macedo Vilaca

Wesley Avelino De Carvalho