Módulo 1: Banco de Dados para Texto¶

Introdução¶

Módulo 1 na Introdução ao Harmony Cloud Studio demonstra a consulta de dados de uma única tabela em um banco de dados PostgreSQL e a gravação deles em um servidor SFTP como um arquivo de texto simples.

Pré-requisitos¶

Estes módulos pressupõem que você se registrou no Jitterbit Learning Sandbox fornecido como parte da Introdução ao Harmony Cloud Studio curso de treinamento. O registro no Jitterbit Learning Sandbox fornece acesso à organização de treinamento Harmony, completa com dois ambientes, bem como contas no servidor SFTP de treinamento da Jitterbit e no banco de dados PostgreSQL.

Se você não tiver esse acesso, consulte Obtendo treinamento para se registrar na Jitterbit University e, em seguida, inscreva-se no Introdução ao Harmony Cloud Studio curso. O registro do Learning Sandbox é abordado no Capítulo 4 – Registro do Learning Sandbox.

Resumo¶

Neste módulo você se conectará ao customer tabela do banco de dados PostgreSQL de treinamento, crie um arquivo CSV com campos semelhantes e grave esses dados no servidor SFTP de treinamento.

A operação concluída ficará assim:

Esta operação usa este mapeamento de transformação:

1. Crie um Novo Projeto¶

Todos os módulos abordados neste curso são criados em um único projeto. Antes de iniciar o primeiro módulo, crie um projeto:

1. Faça login no Portal Harmony em https://login.jitterbit.com e mude para a organização Jitterbit Learning Sandbox no canto superior direito do cabeçalho.

2. Clique no cartão do aplicativo Cloud Studio.

3. No índice do projeto, clique em Novo Projeto. Dê um nome ao projeto, como "Exemplos da Jitterbit University" e selecione o ambiente.

4. Uma vez dentro do projeto, renomeie o workflow para “Módulo 1”.

   Dica

   Aderir a uma convenção de nomenclatura aceita em sua organização para seus workflows, operações e componentes é uma prática recomendada.

2. Configure uma Conexão de Banco de Dados¶

Para este módulo, primeiro você estabelece uma conexão com o banco de dados de treinamento PostgreSQL:

1. Na paleta de componentes de design Na aba Conexões no filtro Conectores, clique no conector do banco de dados:

   

2. Configure a Conexão de banco de dados:

   • Nome do Endpoint: "Banco de dados Postgres"

   • Driver: "PostgreSQL"

   • Nome do servidor: "learningsandbox.jitterbit.com"

   • Nome do banco de dados, Login, Senha: Essas credenciais são provenientes das informações que você forneceu ao preencher o formulário de registro do Learning Sandbox. Essas informações podem ser encontradas no e-mail de confirmação do Learning Sandbox.

   • Porta: Nenhuma alteração dos padrões é necessária.

   Dica

   Os Agentes em Nuvem podem usar apenas drivers JDBC, enquanto os Agentes Privados podem usar drivers JDBC ou ODBC.

3. Clique em Test na parte inferior da configuração para verificar a conectividade.

4. Uma vez conectado, clique em Salvar alterações. Isso o leva de volta à quadro de design.

A conexão "Banco de dados Postgres" deve ter uma configuração semelhante a esta:

3. Configure uma Atividade de Banco de Dados¶

A seguir, você configura uma atividade para consultar dados do banco de dados PostgreSQL:

1. Na aba Conexões da paleta de componentes no filtro Endpoints, clique na conexão "Banco de dados Postgres" que você acabou de criar para mostrar os tipos de atividade da conexão:

   

2. Arraste um tipo de atividade de consulta de banco de dados para a área de inserção de componentes na quadro de design para criar uma instância de uma atividade de consulta de banco de dados em uma nova operação.

3. Renomeie a operação para “DB to Text”.

4. Clique duas vezes na atividade Consulta dentro da operação para abrir sua configuração.

5. Configure a atividade de consulta de banco de dados:

   • Nome: "Consultar Tabela Cliente"
   • Selecione Tabela(s): Atualize as tabelas e selecione a(s) customer mesa. Clique em Próximo.
   • Selecionar Campos: Selecione o id (Chave), company, address, city, state, zip, country, phone, e fax Campos. Clique em Próximo.
   • Esquema de dados: Revise o esquema de dados e clique em Concluído para retornar à quadro de design.

A tela final de configuração da atividade deverá ser semelhante a esta:

4. Configure uma Conexão FTP¶

A seguir, você configura uma conexão com o servidor SFTP de treinamento:

1. Na aba Conexões da paleta de componentes, no filtro Conectores, clique no conector FTP:

   

2. Configure a conexão FTP:

   • Nome do Endpoint: "SFTP"
   • Anfitrião: "learningsandbox.jitterbit.com"
   • Nome de usuário e Senha: Essas credenciais são provenientes das informações que você forneceu ao preencher o formulário de registro do Learning Sandbox. Essas informações podem ser encontradas no e-mail de confirmação do Learning Sandbox.

3. Clique em Testar para verificar a conectividade e clique em Salvar alterações quando terminar.

A conexão FTP deve ter uma configuração semelhante a esta:

5. Configure uma Atividade FTP¶

Depois que a conexão FTP estiver configurada, você configura uma atividade FTP Write associada a essa conexão:

1. Na aba Conexões da paleta de componentes no filtro Endpoints, clique na conexão "SFTP" que você acabou de criar para mostrar os tipos de atividade da conexão:

   

2. Arraste uma atividade FTP Write para uma área de inserção de componentes à direita da atividade Database Query dentro da operação na quadro de design.

3. Clique duas vezes na atividade FTP Write dentro da operação para abrir sua configuração.

4. Configure a atividade FTP Write:

   • Nome: "Escrever registros do cliente"
   • Caminho: "/" (barra)
   • Nome(s) do(s) arquivo(s): "resultado_[data]_[hora].csv". Clique em Próximo.
   • Esquema de dados: Como você não forneceu um esquema, não há nada para revisar na segunda tela. Clique em Concluído.

6. Configure uma Transformação¶

Em seguida, você cria uma transformação para transformar os dados da origem do banco de dados no destino do FTP:

1. Na quadro de design, passe o mouse sobre a área entre a atividade Consulta de banco de dados e a atividade Gravação de FTP até que uma área de inserção de componentes apareça.
2. Clique na área de inserção e selecione Nova Transformação. Uma nova transformação será aberta para você configurar:
   • Nome da Transformação: "DB para Texto"
   • Fonte: O esquema de origem já foi fornecido (à esquerda).
   • Alvo: Você precisa definir o esquema de destino (à direita). Clique em Definir esquema e selecione Criar plano. Configure o esquema simples personalizado:
     • Nome do esquema: "CSV do cliente"
     • Adicionar campo: Use este botão para adicionar estes campos: id, Customer, Address, City, State, ZipCode, Country, Phone, e Fax. Depois que os campos forem adicionados, clique em Salvar alterações.
3. No canto superior direito do esquema de destino, clique em Mapear automaticamente correspondências exatas.
4. Mapeie manualmente (arraste e solte) os campos que não eram correspondências exatas: map company para Customer, e zip para ZipCode.
5. Na parte superior do cabeçalho da transformação, clique no botão cinza Visualizar para iniciar o processo de visualização para testar e validar os mapeamentos. Clique em Avançar para implantar os componentes listados e clique em Concluído.
6. A tela de visualização exibe dados preenchidos da origem e mapeados para o destino. Clique nas setas direita e esquerda para percorrer os dados importados.
7. Após revisar os dados, clique em Retornar ao Workflow. Clicar neste botão salva o trabalho realizado na transformação.

A configuração do esquema simples personalizado deve ser semelhante a esta:

A visualização da transformação deve ser semelhante a esta:

7. Implante e Execute a Operação¶

Finalmente, com todas as etapas da operação configuradas, você implantar e executa a operação:

1. No canto superior direito da operação, clique no ícone do menu de ações e no menu clique em Implantar e Executar. O status da operação é exibido no canto inferior esquerdo da operação.
2. Assim que a operação for bem-sucedida, faça login no servidor SFTP de treinamento da Jitterbit e visualize o arquivo que você gerou.