MongoDB no Jitterbit Design Studio

Introdução

Para os fins deste artigo, assume-se que você já obteve, instalou e iniciou uma instância de um servidor MongoDB. Além disso, uma vez que você tenha definido seu modelo de dados e sua estrutura, deve criar uma cópia em JSON da estrutura que pode ser usada para engenharia reversa de um arquivo XSD. Isso será mostrado mais adiante neste documento.

Requisitos do sistema

Você precisará obter um driver JDBC ou ODBC que tenha sido especificamente escrito para MongoDB. Recomenda-se que você obtenha um teste gratuito para o driver e realize testes antes de fazer uma compra final.

Configuração

Como se conectar a uma instância MongoDB usando Jitterbit

Instale o driver no dispositivo que será usado para hospedar seu agente privado. Se você instalou um driver ODBC, esse driver deve ser exibido no Jitterbit Studio como uma possível seleção ao escolher criar uma Fonte ou Destino que utilize um banco de dados. Esta imagem mostra uma nova Fonte que foi criada usando um driver ODBC:

Deve-se mencionar que nem todos os drivers oferecerão a mesma funcionalidade dentro do Jitterbit Studio e, como tal, você é encorajado a realizar seus próprios testes antes de escolher qual driver deseja usar.

Se você instalou um driver JDBC, deve consultar a documentação desse driver para obter a Classe e o Subprotocolo. Você deve anotar onde instalou o driver JDBC, pois precisará copiar o arquivo JAR recém-instalado (e provavelmente um arquivo de licença) para um local que seja conhecido e utilizado pelo servidor Jitterbit Tomcat.

Localize a pasta em seu sistema onde o arquivo JdbcDrivers.conf está localizado. Para Windows, este é C:\Program Files (x86)\Jitterbit Agent. Abra o arquivo JdbcDrivers.conf e siga as instruções dentro do arquivo que descrevem como "Registrar um novo driver JDBC com Jitterbit".

No exemplo de instalação de um driver JDBC em um sistema operacional Windows, esta informação foi adicionada ao arquivo JdbcDrivers.conf:

<Driver>

      <Name>MongoDB</Name>

      <Class>cdata.jdbc.mongodb.MongoDBDriver</Class>

      <Subprotocol>jdbc:mongodb</Subprotocol>

</Driver>

Uma vez instalado, reinicie o Servidor Tomcat, pois isso permitirá que o driver JDBC recém-instalado apareça como uma seleção possível ao configurar uma nova Fonte ou Destino de banco de dados. Aqui está uma imagem de como a string de conexão foi criada manualmente para a instância MongoDB:

Como mencionado anteriormente, nem todos os drivers oferecerão a mesma funcionalidade, portanto, é importante realizar seus próprios testes antes de fazer sua escolha. A documentação restante foi realizada usando um driver JDBC que permite que instruções SQL sejam escritas contra uma instância MongoDB.

O próximo passo é conseguir escrever dados de uma fonte de dados para sua instância MongoDB. No cenário específico mostrado aqui, uma tabela simples usando um banco de dados PostgreSQL foi criada. Ela poderia então preencher várias linhas de dados a serem usadas para escrever a coleção MongoDB que havia sido criada anteriormente.

Dentro do Jitterbit Studio, um novo Projeto foi criado chamado MongoDB para fins de teste. Em seguida, crie uma nova Operação do Tipo Transformação que usará o banco de dados PostgreSQL como Fonte e a instância MongoDB como Destino. A imagem a seguir ilustra o resultado antes de configurar a transformação acompanhante.

Selecione a Transformação e escolha uma nova Transformação no menu. Isso iniciará o Assistente de Transformação. Se a Fonte e o Destino já estiverem criados, você só precisará nomear a nova Transformação.

Em seguida, clique em "Próximo" dentro do Assistente de Transformação.

Para ver uma lista de tabelas que podem ser usadas dentro da sua definição de Fonte, clique no botão "Baixar Lista de Tabelas". Selecione sua tabela de Fonte e clique no nome para mover sua tabela para a visualização de Tabelas Selecionadas. Uma vez que suas tabelas de Fonte tenham sido selecionadas, você pode clicar em Próximo dentro do Assistente de Transformação. Escolha quaisquer valores necessários que sejam apropriados para sua integração e avance pelo Assistente de Transformação até que a tela de DESTINO seja apresentada. Se você já designou o Destino como a instância MongoDB, pode baixar a lista de tabelas (coleções) que foram configuradas. Dentro da instância MongoDB, clique no botão "Baixar Lista de Tabelas". Neste exemplo, existem duas coleções que foram adicionadas anteriormente à minha instância MongoDB chamadas data e test. Selecione a tabela (coleção) que é necessária para seu propósito específico de integração e mova essa seleção para a visualização de Tabelas Selecionadas.

Neste exemplo, Inserir/Atualizar foi selecionado. Isso é possível uma vez que o destino definido tenha uma Chave Primária para a coleção subjacente da instância MongoDB que está sendo usada. Você pode determinar sua Chave Primária clicando no botão "Editar Tabela Selecionada…" e, em seguida, selecionando o campo que deve ser usado como a Chave Primária.

Quando terminar, clique no botão "Concluir" para sair do Assistente de Transformação.

Ao sair do Assistente de Transformação, você verá a estrutura subjacente dos seus dados de Fonte e Destino. Neste caso, é uma tabela PostgreSQL muito simples como Fonte e uma estrutura de coleção MongoDB igualmente simples. No entanto, é importante notar que a estrutura real do MongoDB foi feita para parecer achatada dentro do Destino de Transformação. Como você verá, os dados reais que foram inseridos nesta instância MongoDB contêm dados em uma estrutura mais hierárquica do que se pode perceber apenas olhando para o Destino de Transformação. O próximo passo é simplesmente completar qualquer mapeamento que seja necessário.

Quando você terminar de mapear seus dados da Fonte para o Destino, salve suas alterações e feche a Transformação. Agora você deve ser capaz de executar sua Operação, que irá inserir os dados da sua Fonte no seu Destino. Abaixo está uma imagem que mostra o resultado da execução da Operação e a inserção bem-sucedida dos dados do PostgreSQL nesta coleção do MongoDB.

Este documento tem como objetivo ser um exemplo simples de como usar o Jitterbit para se conectar a uma instância do MongoDB e, em seguida, inserir dados de uma Fonte no seu Destino. Na maioria dos casos, uma Integração pode precisar realizar todos os aspectos de uma operação CRUD e, como tal, você deve continuar configurando novas Operações que permitam realizar todas as operações necessárias para a sua implementação específica.