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

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.

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:

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.

Clique em "OK".

Clique em "Test Connection" para certificar que a base está acessível e a conexão está funcionando, como mostrado na imagem abaixo:

Se ao clicar no botão salvar, o erro evidenciado abaixo¹ acontecer, algumas providências terão que ser tomadas para que a consulta possa ser devidamente executada. Essa não conformidade poderá ser apresentada, caso existam configurações incorretas.

Imagem – Não conformidade apresentada, caso existam configurações incorretas.

SOLUÇÃO

Dentro da pasta Config [C:\windows\Microsoft.NET\Framework\v4.0.30319\Config]², abra o arquivo chamado Machine.Config.

Imagem – 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.

Imagem – 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.

Após 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.

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

Imagem – 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.

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

Caso os passos descritos até aqui tenham sido executados corretamente, a consulta SQL será executada com sucesso.