Módulo 2: Banco de Dados para XML Complexo¶
Introdução¶
Módulo 2 no Introdução ao Harmony Cloud Studio demonstra como consultar dados de várias tabelas em um banco de dados PostgreSQL e gravá-los em um servidor SFTP em um formato XML hierárquico.
Pré-requisitos¶
Esta página pressupõe que você concluiu o Módulo 1 - Banco de dados para texto, onde você configurou conexões com o banco de dados PostgreSQL de treinamento do Jitterbit e o servidor SFTP.
Resumo¶
Neste módulo, você usará o banco de dados PostgreSQL para se conectar ao OrderDetail
e OrderHeader
tabelas. Depois de conectado, você mesclará esses dados e os gravará em um formato hierárquico no servidor SFTP de treinamento.
A operação concluída ficará assim:
Esta operação usa este mapeamento de transformação:
1. Configurar uma Atividade de Banco de Dados¶
Para este módulo, você continua trabalhando no mesmo projeto e reutiliza a mesma conexão "Postgres Database" como no Módulo 1, mas configura uma atividade de consulta separada para recuperar dados diferentes do banco de dados:
-
No mesmo projeto do Módulo 1, crie um novo workflow e nomeie-o "Módulo 2".
-
Na aba Connections da paleta de componentes sob o filtro Endpoints, clique na conexão "Postgres Database" que você criou no Módulo 1 para mostrar os tipos de atividade da conexão:
-
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.
-
Renomeie a operação para "DB para XML".
-
Clique duas vezes na atividade Consulta dentro da operação para abrir sua configuração.
-
Configure a Atividade de consulta ao banco de dados:
- Nome: "Cabeçalho do pedido de consulta e tabelas de detalhes do pedido"
- Selecionar Tabela(s): Atualize as tabelas e selecione o
OrderDetail
eOrderHeader
tabelas. Então dentro doOrderDetail
linha:- Pai: Use o menu suspenso para selecionar
OrderHeader
. - Chaves de link: Clique em Atribuir. No pop-up, arraste
OrderID
na tabela pai paraOrderID
na tabela filho. Clique em Concluído. - Tipo de associação: Este campo fica disponível após a atribuição de chaves de link. Use o menu suspenso para selecionar Zero ou mais. Clique em Avançar.
- Pai: Use o menu suspenso para selecionar
- Fonte: PostgreSQL: Marque a caixa de seleção ao lado de
OrderHeader
para incluir todos os campos na consultar. - 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 deve ser semelhante a esta:
2. Configurar uma Atividade de FTP¶
Além de reutilizar a conexão do banco de dados, você também pode reutilizar a conexão FTP do Módulo 1. Nesta etapa, você usa a mesma conexão com o servidor de treinamento SFTP, mas configura uma atividade de gravação separada:
-
Na aba Connections da paleta de componentes sob o filtro Endpoints, clique na conexão "SFTP" que você criou no Módulo 1 para mostrar os tipos de atividade da conexão:
-
Arraste um tipo de atividade FTP Write para uma área de inserção de componentes à direita da atividade Database Query dentro da operação na quadro de design.
-
Clique duas vezes na atividade FTP Write dentro da operação para abrir sua configuração.
-
Configure a Atividade de gravação de FTP:
- Nome: "XML SFTP"
- Caminho: "/" (barra)
- Nome(s) do(s) arquivo(s): "resultado_[data]_[hora].xml". Clique em Avançar.
- Esquema de dados: Como você não forneceu um esquema, não há nada para revisar na segunda tela. Clique em Concluído.
3. Configurar uma Transformação¶
Em seguida, você cria uma transformação para transformar dados da origem do banco de dados para o destino do FTP:
-
Na quadro de design, passe o mouse sobre a área entre a atividade de consulta do banco de dados e a atividade de gravação de FTP até que uma área de inserção de componentes apareça.
-
Clique na área de inserção e selecione Nova Transformação. Uma nova transformação se abrirá para você configurar:
- Nome da Transformação: "DB para XML"
- Fonte: O esquema fonte já está fornecido (à esquerda).
- Destino: Você precisa definir o esquema de destino (à direita). Clique em Mirror Source Schema para replicar a estrutura do banco de dados em XML.
-
Arraste o
OrderHeader
nó de origem para orow
nó de destino e selecione Automap.Dica
As linhas pretas sólidas que são exibidas entre os nós de origem e destino são chamadas de linhas do iterador. Essas linhas indicam que o mapeamento suporta vários registros (instâncias).
-
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.
-
A tela de visualização exibe os dados preenchidos da origem e mapeados para o destino. Clique nas setas para a direita e para a esquerda para percorrer os dados importados.
-
Após revisar os dados, clique em Return to Workflow. Clicar neste botão salva o trabalho que você fez na transformação.
A visualização da transformação deve ser semelhante a esta:
4. Implantar e Executar a Operação¶
Por fim, com todas as etapas da operação configuradas, você implantar e executa a operação:
- No canto superior direito da operação, clique no ícone do menu de ações e no menu clique em Deploy and Run. O status da operação é exibido no canto inferior esquerdo da operação.
- Depois que a operação for bem-sucedida, faça login no servidor SFTP de treinamento do Jitterbit e visualize o arquivo que você gerou.