O Carol Connect é a ferramenta para obter dados de qualquer banco de dados.
Atualmente, estes são os bancos de dados suportados:
- SQL Server (incluindo o SQL Server no Azure)
- Oracle
- PostgreSQL
- MySQL
- Progress OpenEdge
- MongoDB
Concessões de usuários do banco de dados
Garanta os seguintes grants para o usuário do banco de dados que será usado no 2c:
- CREATE SEQUENCE
- CREATE TABLE
- CREATE TRIGGER
- CREATE INDEX
Requisitos (servidor)
Para instalar e executar o Carol Connect perfeitamente, os seguintes requisitos devem ser atendidos:
- Ambiente (Windows ou Linux) com pelo menos 100 GB de disco rígido, 4 GB de memória RAM e acesso à Internet sem proxy. Se houver uma tabela com dados grandes de registros como imagens, é altamente recomendável ter 8 GB de memória RAM.
- Um ambiente exclusivo para evitar concorrência com outros sistemas.
- A URL *.carol.ai deve ser liberada no servidor de firewall (se aplicável).
- Um usuário com direitos administrativos no banco de dados (permissão para instalar triggers e criar tabelas). Os direitos administrativos podem ser removidos após a instalação e inicialização do ambiente.
Requisitos de Rede
Carol Connect realiza comunicação com Carol (plataforma). Para permitir a comunicação, alguns requisitos devem ser observados:
- Caso a rede tenha um firewall ou proxy, o URL de Carol deve ser adicionado como uma exceção para o seguro de desempenho.
- Carol connect se comunica com Carol usando o domínio .carol.ai.
Instalando o Carol Connect
Se você está iniciando um projeto com Carol e precisa ter o Carol Connect para integrar seus dados, é possível fazer o download da versão mais recente em nosso repositório do Github: https://github.com/totvslabs/2c/releases .
Desde março de 2021, entregamos uma nova versão 2C.
Carol Connect não tem instalação, basta descompactar o arquivo ZIP e executar o Carol Connect através do arquivo "2c.bat" ou "2c.sh".
Imagem Docker
Se preferir, você pode iniciar o Carol Connect usando a imagem do docker, executando os seguintes comandos:
docker pull totvslabs/2c
docker run totvslabs/2c
Configure a memória 2C
Como limitar o consumo de memória da Carol 2C
Configurando Carol Connector como um Serviço
Como Instalar, Desinstalar ou Renomear o Serviço da Carol 2C no Windows
Como Instalar, Desinstalar ou Renomear o Serviço da Carol 2C no Linux
Como instalar o Carol Connect
Como instalar a Carol Connect (2C)
Criando a conexão com o banco de dados
Como criar uma conexão com um banco de dados
Estratégia de sincronização
Como definir a estratégia de sincronização de dados para Plataforma Carol
Criando uma conexão com o seu Diretório
Como criar uma conexão com uma pasta/diretório
Como sincronizar imagens do Protheus
Carol Connect Monitor
Para verificar o status relacionado a integração dos dados, você deverá acessar o menu "Database Manager" para verificar algumas informações como descrito anteriormente:
Configuração 2C
A configuração do 2C está localizada em app.config.yml arquivo.
- syncThreads: Número de jobs executores rodando paralelamente.
- poolSize: Número máximo de conexões para o banco de dados.
- ignoreTriggers: defina true se o 2C não puder criar triggers no banco de dados.
- enableReSync: defina true para ativar a estratégia ReSync.
- enableLogin: defina true se o 2C precisar solicitar login sempre que sua API for chamada.
- syncByTimestampResendLastDate: definido como true se durante uma sincronização por Timestamp, o 2C precisar reenviar registros do último timestamp. Útil quando o timestamp não tem registro de hora, apenas data.
- resendAllRecordsOnResync: defina true se o 2C precisar reenviar todos os registros sempre que o ReSync for executado.
- imageAxisPixelsLimit: se maior que zero, 2C validará e redimensionará imagens com eixo maior que o limite informado.
- ignoreQueueTable: Este parâmetro desativará o recurso que permite que o 2C crie a tabela "carol_3c_queue" automaticamente.
- oracleUseOwnerAsQueueSchema: Este parâmetro é utilizado para indicar onde será criada a tabela de fila utilizando o banco de dados oracle, informando false, a tabela permanece no usuário que está logado, se informado true será criado no owner do banco.
Configuração Cron 2C
2C tem quatro expressões cron:
- processing: Define com que frequência o 2C verifica a tabela da fila para enviar dados para Carol.
- syncbytimestamp: Define com que frequência o 2C iniciará uma sincronização por data e hora para tabelas sincronizadas dessa maneira.
- initialload: Defina cada vez que 2C verifica e inicia carregamentos iniciais para tabelas ativadas.
Requisitos do SQL Server
Estes são os requisitos que o banco de dados deve atender para funcionar perfeitamente com o Carol Connect:
- SQL Server 2008 ou superior.
- Configure o SQL Server para ouvir uma porta TCP, normalmente 1433. Por favor, siga estas instruções na seguinte URL para maiores detalhes: MSSQL-Porta-Específica
Requisitos do Progress OpenEdge
Estes são os requisitos que o banco de dados deve atender para funcionar perfeitamente com o Carol Connect:
- OpenEdge 10. 3 ou superior.
- O SQL Broker iniciado e aceitando conexões.
- Conceda ao usuário do Carol Connect que tenha privilégios de definição de tabela (privilégios DDL).
- Caso esse banco de dados pertença aos produtos Datasul, a tabela "carol_3c_queue" já existe no dicionário de dados. Não é necessário criá-la (altere a configuração do parâmetro para evitar a criação).
- Caso esse banco de dados não esteja relacionado ao Datasul, o Carol Connect criará a tabela de filas no banco de dados (com base na configuração do Carol Connect) ao iniciá-lo. O OpenEdge somente permite esta operação (DDL) quando nenhum outro usuário está conectado ao banco de dados.
MongoDB
Ao usar o Carol Connect integrado ao MongoDB, os seguintes itens devem ser seguidos:
- Não use o administrador do banco de dados para configurar a conexão.
- Especifique a restrição correta para o usuário que poderá sincronizar os dados.
- Nenhuma operação será executada pela integração - não há tabela de filas para o MongoDB.
- A sincronização ocorre pela estratégia "Sync using a value field".
Próxima Etapa
0 Comentários