Índice:
Objetivo:
O objetivo desse documento é esclarecer o uso de conexão destino usando a Carol. Disponível a partir da versão 12.1.29.
Introdução:
TOTVS Carol é a plataforma de dados e inteligência artificial da TOTVS. Leia mais sobre a Carol.
Nas versões mais recentes do RM é possível enviar dados para a Carol, através da ferramenta de Conceito (ETL).
Os provedores de banco de dados são APIs que promovem conexão direta a uma base de dados, sem necessidade de existir um ERP. O provedor de banco de dados fará conexão direta com um banco específico ou a diversos bancos de forma genérica, sendo assim, é de responsabilidade do usuário escolher o que melhor atenderá sua demanda.
O principal campo para preenchimento dos dados de um provedor é a Connection String. É a partir deste que os outros campos serão preenchidos e, caso alguma alteração ocorra nos outros campos, a mudança será refletida na connection string.
Conexão:
Após inserir a Connection String e pressionar Enter, a tela irá se expandir, contendo novos campos junto das informações preenchidas na string. Os novos campos exibidos na tela poderão ser alterados, refletindo na connection string.
Provedores:
São suportadas todos os tipos de Conexões de Origem disponíveis no Conceito. E Para a conexão de destino é necessário configurar uma conexão Carol.
É importante ter uma conta válida no sistema da Carol.
Conexão:
Veja abaixo um exemplo de como criar uma conexão com a Carol.
Neste exemplo, o objetivo é enviar toda a tabela de Funcionários (PFUNC) para a Carol. Para isso, usamos uma conexão de origem de Banco de Dados, selecionando a tabela PFUNC e todos seus campos. Veja mais sobre esse tipo de conexão: Conexão de Origem/Destino Utilizando Banco de Dados.
Passos para criar a conexão de destino com a Carol:
Informações |
---|
|
Deck of Cards |
---|
| | Odbc Data Provider | Connection String: Driver={SQL SERVER};server=<servername>;database=<dbname> Image Removed Informações |
---|
Nessa conexão, também é possível informar as tags User ID e Password |
|
Card |
---|
| Connection String: Provider=SQLOLEDB;Data Source=<servername>;Password=<password>;User ID=<userid>;Initial Catalog=<dbname> Image Removed Informações |
---|
Para o uso de segurança integrada na conexão, informe a tag Integrated Security=SSPI e remova as tags Password e User ID. |
Para conexão a um Provedor OleDb, estão disponibilizadas as seguintes opções, no campo "Provider": Image Removed |
Card |
---|
label | OracleClient Data Provider |
---|
| Aviso |
---|
Para uso da conexão, é necessário instalar Oracle Client acima da versão 8.1.7. |
Connection String: Data Source="(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<host>)(PORT=<port>))(CONNECT_DATA=(SERVICE_NAME=<servicename>)))";User ID=<userid>;Password=<password> Image Removed Informações |
---|
Apenas é aceito privilégio/atribuição "SYS", que é o padrão Oracle. SYSDBA não é suportado. |
|
Card |
---|
label | SqlClient Data Provider |
---|
| Connection String: Server=<servername>;Database=<dbname>;User Id=<userid>;Password=<password>; Image Removed |
|
Dica |
---|
| As informações a seguir deverão ser recuperadas do ambiente Carol. O Token pode ser obtido conforme link a seguir: Autenticação na Carol. Image Added
No exemplo acima não foi usado o token, mas um usuário e senha para autenticação. Os dados preenchidos foram obtidos diretamente da Carol, no connector: Image Added
|
Card |
---|
label | Conexão Carol - Mensagem |
---|
| Na aba Mensagem será configurado o schema da tabela do connector da Carol, onde os dados serão enviados. Image Added Dica: Deixe a opção Formato gzip habilitada para melhorar o desempenho do processamento do conceito. Quando selecionado, os pacotes serão compactados para serem trafegados.
- Se o a tabela já existir no connector, basta clicar no botão 'Buscar Schema', que o schema da stagging será retornado:
Image Added - Se ele não existir, será retornada uma mensagem ao realizar o passo anterior: "Tabela não encontrada na staging!".
Para criar a tabela na staging, clique em 'Criar Schema'. O sistema listará todos os campos da conexão de Origem: Image Added Selecione a(s) PK(s), remova os campos indesejados e clique em Criar Schema. Nesse momento, aguarde a confirmação que a tabela foi criada corretamente no connector da Carol. |
Card |
---|
| Por último, configure as ligações entre a tabela destino e origem. Arraste primeiro a tabela de destino, depois a de Origem. Em seguida, clique no ícone 3, em destaque na imagem abaixo, para que as associações de campos sejam feitas automaticamente baseando-se no nome. Image Added |
| Utilize o botão "Testar" para testar sua conexão. |