Acessar e gerenciar recursos do IBM DB2 usando Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo)
Com os Aplicativos Lógicos do Azure e o conector do IBM DB2, é possível criar tarefas e fluxos de trabalho automatizados com base nos recursos automatizados em seu banco de dados DB2. Seus fluxos de trabalho podem se conectar aos recursos em seu banco de dados, ler e listar as tabelas de banco de dados, adicionar linhas, alterá-las, excluí-las e muito mais. É possível incluir ações em seus aplicativos lógicos que obtêm respostas do seu banco de dados e disponibilizam a saída para outras ações.
Este artigo mostra como você pode criar um aplicativo lógico que realiza várias operações de banco de dados. Se ainda não estiver familiarizado com os aplicativos lógicos, veja O que são os Aplicativos Lógicos do Azure?
Plataformas e versões com suporte
O conector DB2 inclui um cliente Microsoft que se comunica com servidores DB2 remotos em uma rede TCP/IP. É possível usar esse conector para acessar bancos de dados de nuvem como o IBM DB2 para Windows em execução na virtualização do Azure. Também é possível acessar bancos de dados DB2 locais após instalar e configurar o gateway de dados local.
O conector do IBM DB2 é compatível com estas plataformas e versões do IBM DB2, juntamente com os produtos compatíveis com o IBM DB2, que são compatíveis com as versões 10 e 11 do SQLAM (SQL Access Manager) da DRDA (Distributed Relational Database Architecture):
| Plataforma | Versão |
|---|---|
| IBM DB2 para z/OS | 12, 11.1, 10.1 |
| IBM DB2 para i | 7.3, 7.2, 7.1 |
| IBM DB2 para LUW | 11, 10.5 |
Operações de banco de dados com suporte
O conector do IBM DB2 é compatível com estas operações de banco de dados, que mapeiam para as ações correspondentes no conector:
| Operação de banco de dados | Ação do conector |
|---|---|
| Listar tabelas do banco de dados | Obter tabelas |
| Ler uma linha usando SELECT | Obter linha |
| Ler todas as linhas usando SELECT | Obter linhas |
| Adicionar uma linha usando INSERT | Inserir linha |
| Editar uma linha usando UPDATE | Atualizar linha |
| Remover uma linha usando DELETE | Delete row |
Pré-requisitos
Uma conta e uma assinatura do Azure. Se você não tiver uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.
Um banco de dados do IBM DB2, baseado em nuvem ou local
Conhecimento básico sobre como criar aplicativos lógicos. Para obter mais informações, confira Criar um exemplo de fluxo de trabalho de aplicativo lógico de Consumo
O aplicativo lógico em que você deseja acessar o banco de dados DB2. Esse conector fornece apenas ações, portanto, para iniciar seu aplicativo lógico, selecione um gatilho separado, por exemplo, o gatilho Recorrência. Os exemplos neste artigo usam o gatilho Recorrência.
Adicionar ação do DB2 – Obter tabelas
No portal do Azure, abra o aplicativo lógico no Designer de aplicativo lógico, se já não estiver aberto.
No gatilho, escolha Nova etapa.
Na caixa de pesquisa, insira "db2" como seu filtro. Para esse exemplo, na lista de ações, selecione esta ação: Obter tabelas (versão prévia)
Agora você deverá fornecer os detalhes da conexão para seu banco de dados DB2.
Siga as etapas para criar conexões para bancos de dados de nuvem ou bancos de dados locais.
Conectar-se ao DB2 de nuvem
Para configurar sua conexão, forneça estes detalhes de conexão quando solicitados. Escolha Criar e salve seu aplicativo lógico:
| Propriedade | Obrigatório | Descrição |
|---|---|---|
| Conectar-se por meio do gateway local | Não | Aplica-se somente para conexões locais. |
| Nome da conexão | Sim | O nome da sua conexão, por exemplo, "MyLogicApp-DB2-connection" |
| Servidor | Sim | O endereço ou alias dois pontos número da porta para seu servidor DB2, por exemplo, "myDB2server.cloudapp.net:50000" Observação: esse valor é uma cadeia de caracteres que representa um endereço TCP/IP ou alias, em formato IPv4 ou IPv6, seguido de dois pontos e um número da porta TCP/IP. |
| Backup de banco de dados | Sim | O nome do seu banco de dados Observação: esse valor é uma cadeia de caracteres que representa um RDBNAM (Nome do banco de dados relacional DRDA): – O DB2 para z/OS aceita uma cadeia de caracteres de 16 bytes e que o banco de dados é conhecido como um local "IBM DB2 para z/OS". |
| Nome de usuário | Sim | Seu nome de usuário para o banco de dados Observação: esse valor é uma cadeia de caracteres cujo comprimento baseia-se no banco de dados específico: – O DB2 para z/OS aceita uma cadeia de caracteres de 8 bytes. |
| Senha | Sim | Sua senha do banco de dados |
Por exemplo:
Conectar-se ao DB2 local
Antes de criar sua conexão, é necessário já ter o gateway de dados local instalado. Caso contrário, não será possível configurar sua conexão. Se você já tiver sua instalação de gateway, continue fornecendo esses detalhes de conexão e escolha Criar.
| Propriedade | Obrigatório | Descrição |
|---|---|---|
| Conectar-se por meio do gateway local | Sim | Aplica-se quando você desejar uma conexão local e mostra as propriedades da conexão local. |
| Nome da conexão | Sim | O nome da sua conexão, por exemplo, "MyLogicApp-DB2-connection" |
| Servidor | Sim | O endereço ou alias dois pontos número da porta para seu servidor DB2, por exemplo, "myDB2server:50000" Observação: esse valor é uma cadeia de caracteres que representa um endereço TCP/IP ou alias, em formato IPv4 ou IPv6, seguido de dois pontos e um número da porta TCP/IP. |
| Backup de banco de dados | Sim | O nome do seu banco de dados Observação: esse valor é uma cadeia de caracteres que representa um RDBNAM (Nome do banco de dados relacional DRDA): – O DB2 para z/OS aceita uma cadeia de caracteres de 16 bytes e que o banco de dados é conhecido como um local "IBM DB2 para z/OS". |
| Autenticação | Sim | O tipo de autenticação para sua conexão, por exemplo, "Básica" Observação: selecione esse valor na lista, que inclui Básica ou Windows (Kerberos). |
| Nome de usuário | Sim | Seu nome de usuário para o banco de dados Observação: esse valor é uma cadeia de caracteres cujo comprimento baseia-se no banco de dados específico: – O DB2 para z/OS aceita uma cadeia de caracteres de 8 bytes. |
| Senha | Sim | Sua senha do banco de dados |
| Gateway | Sim | O nome do seu gateway de dados local instalado Observação: selecione esse valor na lista, que inclui todos os gateways de dados instalados dentro do grupo de recursos e de assinatura do Azure. |
Por exemplo:
Exibir tabelas de saída
Para testar manualmente o aplicativo lógico, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico concluir a execução, será possível exibir a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, no Histórico de execuções, selecione a execução mais recente, que é o primeiro item na lista.
Em Execução do aplicativo lógico, agora é possível examinar o status, entradas e saídas para cada etapa em seu aplicativo lógico. Expanda a ação Obter tabelas.
Para exibir as entradas, escolha Mostrar entradas brutas.
Para exibir as saídas, escolha Mostrar saídas brutas.
As saídas incluem uma lista de tabelas.
Obter linha
Para efetuar fetch de um registro em uma tabela do banco de dados DB2, use a ação Obter linha em seu aplicativo lógico.
Essa ação executa uma instrução SELECT WHERE do DB2, por exemplo, SELECT FROM AREA WHERE AREAID = '99999'.
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, examine essas etapas na seção Adicionar ação do DB2 – Obter tabelas, mas adicione a ação Obter linha e volte aqui para continuar.
Após adicionar a ação Obter linha, veja como seu aplicativo lógico de exemplo é exibido:
Especifique valores para todas as propriedades obrigatórias (*). Após selecionar uma tabela, a ação mostrará as propriedades relevantes específicas para os registros nessa tabela.
Propriedade Obrigatório Descrição Nome da tabela Sim A tabela que tem o registro desejado, como "AREA" neste exemplo ID de área Sim A ID do registro desejado, como "99999" neste exemplo 
Quando terminar, selecione Salvar na barra de ferramentas do designer.
Exibir linha de saída
Para testar manualmente o aplicativo lógico, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico concluir a execução, será possível exibir a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, no Histórico de execuções, selecione a execução mais recente, que é o primeiro item na lista.
Em Execução do aplicativo lógico, agora é possível examinar o status, entradas e saídas para cada etapa em seu aplicativo lógico. Expanda a ação Obter linha.
Para exibir as entradas, escolha Mostrar entradas brutas.
Para exibir as saídas, escolha Mostrar saídas brutas.
As saídas incluem a linha especificada.
Obter linhas
Para efetuar fetch de todos os registros em uma tabela do banco de dados DB2, use a ação Obter linhas em seu aplicativo lógico.
Essa ação executa uma instrução SELECT do DB2, por exemplo, SELECT * FROM AREA.
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, examine essas etapas na seção Adicionar ação do DB2 – Obter tabelas, mas adicione a ação Obter linhas e volte aqui para continuar.
Após adicionar a ação Obter linhas, veja como seu aplicativo lógico de exemplo é exibido:
Abra a lista Nome da tabela e, em seguida, selecione a tabela desejada, que é "AREA" neste exemplo:
Para especificar um filtro ou uma consulta para resultados, escolha Mostrar opções avançadas.
Quando terminar, selecione Salvar na barra de ferramentas do designer.
Exibir linhas de saída
Para testar manualmente o aplicativo lógico, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico concluir a execução, será possível exibir a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, no Histórico de execuções, selecione a execução mais recente, que é o primeiro item na lista.
Em Execução do aplicativo lógico, agora é possível examinar o status, entradas e saídas para cada etapa em seu aplicativo lógico. Expanda a ação Obter linhas.
Para exibir as entradas, escolha Mostrar entradas brutas.
Para exibir as saídas, escolha Mostrar saídas brutas.
As saídas incluem todos os registros em sua tabela especificada.
Inserir linha
Para adicionar um único registro a uma tabela do banco de dados DB2, use a ação Inserir linha em seu aplicativo lógico.
Essa ação executa uma instrução INSERT do DB2, por exemplo, INSERT INTO AREA (AREAID, AREADESC, REGIONID) VALUES ('99999', 'Area 99999', 102).
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, examine essas etapas na seção Adicionar ação do DB2 – Obter tabelas, mas adicione a ação Inserir linha e volte aqui para continuar.
Após adicionar a ação Inserir linha, veja como seu aplicativo lógico de exemplo é exibido:
Especifique valores para todas as propriedades obrigatórias (*). Após selecionar uma tabela, a ação mostrará as propriedades relevantes específicas para os registros nessa tabela.
Para esse exemplo, estas são as propriedades:
Propriedade Obrigatório Descrição Nome da tabela Sim A tabela na qual adicionar o registro, como "AREA" ID de área Sim A ID da área a ser adicionada, como "99999" Descrição da área Sim A descrição da área a ser adicionada, como "Área 99999" ID da região Sim A ID da região a ser adicionada, como "102" Por exemplo:
Quando terminar, selecione Salvar na barra de ferramentas do designer.
Exibir saídas de linha de inserção
Para testar manualmente o aplicativo lógico, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico concluir a execução, será possível exibir a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, no Histórico de execuções, selecione a execução mais recente, que é o primeiro item na lista.
Em Execução do aplicativo lógico, agora é possível examinar o status, entradas e saídas para cada etapa em seu aplicativo lógico. Expanda a ação Inserir linha.
Para exibir as entradas, escolha Mostrar entradas brutas.
Para exibir as saídas, escolha Mostrar saídas brutas.
As saídas incluem os registros adicionados à sua tabela especificada.
Atualizar linha
Para atualizar um único registro em uma tabela do banco de dados DB2, use a ação Atualizar linha em seu aplicativo lógico.
Essa ação executa uma instrução UPDATE do DB2, por exemplo, UPDATE AREA SET AREAID = '99999', AREADESC = 'Updated 99999', REGIONID = 102).
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, examine essas etapas na seção Adicionar ação do DB2 – Obter tabelas, mas adicione a ação Atualizar linha e volte aqui para continuar.
Após adicionar a ação Atualizar linha, veja como seu aplicativo lógico de exemplo é exibido:
Especifique valores para todas as propriedades obrigatórias (*). Após selecionar uma tabela, a ação mostrará as propriedades relevantes específicas para os registros nessa tabela.
Para esse exemplo, estas são as propriedades:
Propriedade Obrigatório Descrição Nome da tabela Sim A tabela na qual atualizar o registro, como "AREA" ID da Linha Sim A ID do registro a ser atualizado, como "99999" ID de área Sim A nova ID de área, como "99999" Descrição da área Sim A nova descrição de área, como "99999 atualizada" ID da região Sim A nova ID da região, como "102" Por exemplo:
Quando terminar, selecione Salvar na barra de ferramentas do designer.
Exibir saídas de linha de atualização
Para testar manualmente o aplicativo lógico, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico concluir a execução, será possível exibir a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, no Histórico de execuções, selecione a execução mais recente, que é o primeiro item na lista.
Em Execução do aplicativo lógico, agora é possível examinar o status, entradas e saídas para cada etapa em seu aplicativo lógico. Expanda a ação Atualizar linha.
Para exibir as entradas, escolha Mostrar entradas brutas.
Para exibir as saídas, escolha Mostrar saídas brutas.
As saídas incluem o registro atualizado em sua tabela especificada.
Delete row
Para excluir um único registro de uma tabela do banco de dados DB2, use a ação Excluir linha em seu aplicativo lógico.
Essa ação executa uma instrução DELETE do DB2, por exemplo, DELETE FROM AREA WHERE AREAID = '99999'.
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, examine essas etapas na seção Adicionar ação do DB2 – Obter tabelas, mas adicione a ação Excluir linha e volte aqui para continuar.
Após adicionar a ação Excluir linha, veja como seu aplicativo lógico de exemplo é exibido:
Especifique valores para todas as propriedades obrigatórias (*). Após selecionar uma tabela, a ação mostrará as propriedades relevantes específicas para os registros nessa tabela.
Para esse exemplo, estas são as propriedades:
Propriedade Obrigatório Descrição Nome da tabela Sim A tabela na qual excluir o registro, como "AREA" ID da Linha Sim A ID do registro a ser excluído, como "99999" Por exemplo:
Quando terminar, selecione Salvar na barra de ferramentas do designer.
Exibir saídas de linhas de exclusão
Para testar manualmente o aplicativo lógico, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico concluir a execução, será possível exibir a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, no Histórico de execuções, selecione a execução mais recente, que é o primeiro item na lista.
Em Execução do aplicativo lógico, agora é possível examinar o status, entradas e saídas para cada etapa em seu aplicativo lógico. Expanda a ação Excluir linha.
Para exibir as entradas, escolha Mostrar entradas brutas.
Para exibir as saídas, escolha Mostrar saídas brutas.
As saídas não incluem mais o registro excluído de sua tabela especificada.
Referência do conector
Para mais detalhes técnicos sobre esse conector, como gatilhos, ações e limites, conforme descrito no arquivo Swagger do conector, confira a página de referência do conector.