Acessar e gerenciar recursos do IBM DB2 usando o Azure Logic Apps
Aplica-se a: Aplicativos Lógicos do Azure (Consumo)
Com os Aplicativos Lógicos do Azure e o conector IBM DB2, é possível criar tarefas e fluxos de trabalho automatizados com base nos recursos armazenados em seu banco de dados DB2. Seus fluxos de trabalho podem se conectar aos recursos em seu banco de dados, ler e listar suas tabelas de banco de dados, adicionar linhas, alterar linhas, excluir linhas e muito mais. Você pode 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 executa várias operações de banco de dados. Se você é novo em aplicativos lógicos, consulte O que são os Aplicativos Lógicos do Azure?
Plataformas e versões suportadas
O conector DB2 inclui um cliente Microsoft que se comunica com servidores DB2 remotos através de uma rede TCP/IP. É possível usar esse conector para acessar bancos de dados em nuvem, como o IBM DB2 for Windows, em execução na virtualização do Azure. Também é possível acessar bancos de dados DB2 locais depois de instalar e configurar o gateway de dados local.
O conector IBM DB2 suporta essas plataformas e versões do IBM DB2 juntamente com produtos compatíveis com IBM DB2 que suportam as versões 10 e 11 do SQL Access Manager (SQLAM) do Distributed Relational Database Architecture (DRDA):
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 suportadas
O conector IBM DB2 suporta essas operações de banco de dados, que mapeiam para as ações correspondentes no conector:
Operação do banco de dados | Ação do conector |
---|---|
Listar tabelas de 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 subscrição do Azure. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.
Um banco de dados IBM DB2, baseado em nuvem ou local
Conhecimento básico sobre como criar aplicativos lógicos. Para obter mais informações, consulte Criar um exemplo de fluxo de trabalho do aplicativo lógico de consumo
O aplicativo lógico onde você deseja acessar seu 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 seu aplicativo lógico no Designer de Aplicativo Lógico, se ainda não estiver aberto.
No gatilho, escolha Nova etapa.
Na caixa de pesquisa, digite "db2" como filtro. Para este exemplo, na lista de ações, selecione esta ação: Obter tabelas (Visualização)
Agora você será solicitado a fornecer detalhes de conexão para seu banco de dados DB2.
Siga as etapas para criar conexões para bancos de dados em nuvem ou bancos de dados locais.
Conectar-se ao DB2 na nuvem
Para configurar sua conexão, forneça estes detalhes de conexão quando solicitado, escolha Criar e salve seu aplicativo lógico:
Property | Necessário | Description |
---|---|---|
Conecte-se via gateway local | Não | Aplica-se apenas a conexões locais. |
Nome da Ligação | Sim | O nome da sua conexão, por exemplo, "MyLogicApp-DB2-connection" |
Servidor | Sim | O endereço ou o número da porta de dois pontos do alias para seu servidor DB2, por exemplo, "myDB2server.cloudapp.net:50000" Nota: Este valor é uma cadeia de caracteres que representa um endereço TCP/IP ou alias, no formato IPv4 ou IPv6, seguido por dois pontos e um número de porta TCP/IP. |
Base de dados | Sim | O nome do seu banco de dados Nota: Este valor é uma cadeia de caracteres que representa um nome de banco de dados relacional DRDA (RDBNAM): - O DB2 para z/OS aceita uma string de 16 bytes onde o banco de dados é conhecido como um local "IBM DB2 for z/OS". |
Nome de utilizador | Sim | O seu nome de utilizador para a base de dados Nota: Este valor é uma cadeia de caracteres cujo comprimento é baseado no banco de dados específico: - O DB2 para z/OS aceita uma string de 8 bytes. |
Palavra-passe | Sim | A sua palavra-passe para a base de dados |
Por exemplo:
Conectar-se ao DB2 local
Antes de criar sua conexão, você já deve ter seu gateway de dados local instalado. Caso contrário, não poderá concluir a configuração da ligação. Se você tiver a instalação do gateway, continue fornecendo esses detalhes de conexão e escolha Criar.
Property | Necessário | Description |
---|---|---|
Conecte-se via gateway local | Sim | Aplica-se quando você deseja uma conexão local e mostra as propriedades de conexão local. |
Nome da Ligação | Sim | O nome da sua conexão, por exemplo, "MyLogicApp-DB2-connection" |
Servidor | Sim | O endereço ou o número da porta de dois pontos do alias para seu servidor DB2, por exemplo, "myDB2server:50000" Nota: Este valor é uma cadeia de caracteres que representa um endereço TCP/IP ou alias, no formato IPv4 ou IPv6, seguido por dois pontos e um número de porta TCP/IP. |
Base de dados | Sim | O nome do seu banco de dados Nota: Este valor é uma cadeia de caracteres que representa um nome de banco de dados relacional DRDA (RDBNAM): - O DB2 para z/OS aceita uma string de 16 bytes onde o banco de dados é conhecido como um local "IBM DB2 for z/OS". |
Autenticação | Sim | O tipo de autenticação para sua conexão, por exemplo, "Básico" Nota: Selecione este valor na lista, que inclui Basic ou Windows (Kerberos). |
Nome de utilizador | Sim | O seu nome de utilizador para a base de dados Nota: Este valor é uma cadeia de caracteres cujo comprimento é baseado no banco de dados específico: - O DB2 para z/OS aceita uma string de 8 bytes. |
Palavra-passe | Sim | A sua palavra-passe para a base de dados |
Gateway | Sim | O nome do gateway de dados local instalado Observação: selecione esse valor na lista, que inclui todos os gateways de dados instalados em sua assinatura do Azure e grupo de recursos. |
Por exemplo:
Ver tabelas de saída
Para executar seu aplicativo lógico manualmente, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico terminar de ser executado, você poderá visualizar a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, na seção Histórico de execuções, selecione a execução mais recente, que é o primeiro item da lista.
Em Execução do aplicativo lógico, agora você pode revisar o status, as entradas e as saídas de cada etapa do seu aplicativo lógico. Expanda a ação Obter tabelas .
Para visualizar as entradas, escolha Mostrar entradas brutas.
Para visualizar as saídas, escolha Mostrar saídas brutas.
As saídas incluem uma lista de tabelas.
Obter linha
Para buscar um registro em uma tabela de banco de dados DB2, use a ação Obter linha em seu aplicativo lógico.
Esta ação executa uma instrução DB2 SELECT WHERE
, por exemplo, SELECT FROM AREA WHERE AREAID = '99999'
.
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, revise as etapas na seção Adicionar ação do DB2 - Obter tabelas , mas adicione a ação Obter linha em vez disso e retorne aqui para continuar.
Depois de adicionar a ação Obter linha , aqui está como seu aplicativo lógico de exemplo aparece:
Especifique valores para todas as propriedades necessárias (*). Depois de selecionar uma tabela, a ação mostra as propriedades relevantes que são específicas para registros nessa tabela.
Property Necessário Description Nome da tabela Sim A tabela que tem o registro desejado, como "AREA" neste exemplo ID da área Sim A ID do registro desejado, como "99999" neste exemplo Quando terminar, na barra de ferramentas do designer, escolha Salvar.
Ver linha de saída
Para executar seu aplicativo lógico manualmente, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico terminar de ser executado, você poderá visualizar a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, na seção Histórico de execuções, selecione a execução mais recente, que é o primeiro item da lista.
Em Execução do aplicativo lógico, agora você pode revisar o status, as entradas e as saídas de cada etapa do seu aplicativo lógico. Expanda a ação Obter linha .
Para visualizar as entradas, escolha Mostrar entradas brutas.
Para visualizar as saídas, escolha Mostrar saídas brutas.
As saídas incluem a linha especificada.
Obter linhas
Para buscar todos os registros em uma tabela de banco de dados DB2, use a ação Obter linhas em seu aplicativo lógico.
Esta ação executa uma instrução DB2 SELECT
, por exemplo, SELECT * FROM AREA
.
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, revise as etapas na seção Adicionar ação do DB2 - Obter tabelas, mas adicione a ação Obter linhas em vez disso e retorne aqui para continuar.
Depois de adicionar a ação Obter linhas , aqui está como seu aplicativo lógico de exemplo aparece:
Abra a lista Nome da tabela e selecione a tabela desejada, que é "ÁREA" neste exemplo:
Para especificar um filtro ou consulta para resultados, escolha Mostrar opções avançadas.
Quando terminar, na barra de ferramentas do designer, escolha Salvar.
Ver linhas de saída
Para executar seu aplicativo lógico manualmente, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico terminar de ser executado, você poderá visualizar a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, na seção Histórico de execuções, selecione a execução mais recente, que é o primeiro item da lista.
Em Execução do aplicativo lógico, agora você pode revisar o status, as entradas e as saídas de cada etapa do seu aplicativo lógico. Expanda a ação Obter linhas .
Para visualizar as entradas, escolha Mostrar entradas brutas.
Para visualizar as saídas, escolha Mostrar saídas brutas.
As saídas incluem todos os registros na tabela especificada.
Inserir linha
Para adicionar um único registro a uma tabela de banco de dados DB2, use a ação Inserir linha em seu aplicativo lógico.
Esta ação executa uma instrução DB2 INSERT
, 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, revise as etapas na seção Adicionar ação do DB2 - Obter tabelas , mas adicione a ação Inserir linha em vez disso e retorne aqui para continuar.
Depois de adicionar a ação Inserir linha , aqui está como seu aplicativo lógico de exemplo aparece:
Especifique valores para todas as propriedades necessárias (*). Depois de selecionar uma tabela, a ação mostra as propriedades relevantes que são específicas para registros nessa tabela.
Para este exemplo, aqui estão as propriedades:
Property Necessário Description Nome da tabela Sim A tabela onde adicionar o registro, como "AREA" ID da área Sim O ID da área a ser adicionada, como "99999" Descrição da área Sim A descrição da área a adicionar, como "Área 99999" ID da região Sim A ID da região a ser adicionada, como "102" Por exemplo:
Quando terminar, na barra de ferramentas do designer, escolha Salvar.
Ver saídas de linha de inserção
Para executar seu aplicativo lógico manualmente, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico terminar de ser executado, você poderá visualizar a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, na seção Histórico de execuções, selecione a execução mais recente, que é o primeiro item da lista.
Em Execução do aplicativo lógico, agora você pode revisar o status, as entradas e as saídas de cada etapa do seu aplicativo lógico. Expanda a ação Inserir linha .
Para visualizar as entradas, escolha Mostrar entradas brutas.
Para visualizar as saídas, escolha Mostrar saídas brutas.
As saídas incluem o registro que você adicionou à tabela especificada.
Atualizar linha
Para atualizar um único registro em uma tabela de banco de dados DB2, use a ação Atualizar linha em seu aplicativo lógico.
Esta ação executa uma instrução DB2 UPDATE
, 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, revise as etapas na seção Adicionar ação do DB2 - Obter tabelas , mas adicione a ação Atualizar linha em vez disso e retorne aqui para continuar.
Depois de adicionar a ação Atualizar linha , aqui está como seu aplicativo lógico de exemplo aparece:
Especifique valores para todas as propriedades necessárias (*). Depois de selecionar uma tabela, a ação mostra as propriedades relevantes que são específicas para registros nessa tabela.
Para este exemplo, aqui estão as propriedades:
Property Necessário Description Nome da tabela Sim A tabela onde atualizar o registro, como "AREA" ID da Linha Sim A ID do registro a ser atualizado, como "99999" ID da área Sim O novo ID de área, como "99999" Descrição da área Sim A nova descrição da área, como "Atualizado 99999" ID da região Sim O novo ID de região, como "102" Por exemplo:
Quando terminar, na barra de ferramentas do designer, escolha Salvar.
Exibir saídas de linha de atualização
Para executar seu aplicativo lógico manualmente, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico terminar de ser executado, você poderá visualizar a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, na seção Histórico de execuções, selecione a execução mais recente, que é o primeiro item da lista.
Em Execução do aplicativo lógico, agora você pode revisar o status, as entradas e as saídas de cada etapa do seu aplicativo lógico. Expanda a ação Atualizar linha .
Para visualizar as entradas, escolha Mostrar entradas brutas.
Para visualizar as saídas, escolha Mostrar saídas brutas.
As saídas incluem o registro que você atualizou na tabela especificada.
Delete row
Para excluir um único registro de uma tabela de banco de dados DB2, use a ação Excluir linha em seu aplicativo lógico.
Esta ação executa uma instrução DB2 DELETE
, por exemplo, DELETE FROM AREA WHERE AREAID = '99999'
.
Se você nunca usou ações do DB2 antes em seu aplicativo lógico, revise as etapas na seção Adicionar ação do DB2 - Obter tabelas , mas adicione a ação Excluir linha em vez disso e retorne aqui para continuar.
Depois de adicionar a ação Excluir linha , veja como seu aplicativo lógico de exemplo aparece:
Especifique valores para todas as propriedades necessárias (*). Depois de selecionar uma tabela, a ação mostra as propriedades relevantes que são específicas para registros nessa tabela.
Para este exemplo, aqui estão as propriedades:
Property Necessário Description Nome da tabela Sim A tabela onde excluir o registro, como "AREA" ID da Linha Sim A ID do registro a ser excluído, como "99999" Por exemplo:
Quando terminar, na barra de ferramentas do designer, escolha Salvar.
Exibir saídas de linha de exclusão
Para executar seu aplicativo lógico manualmente, na barra de ferramentas do designer, escolha Executar. Depois que o aplicativo lógico terminar de ser executado, você poderá visualizar a saída da execução.
No menu do aplicativo lógico, selecione Visão geral.
Em Resumo, na seção Histórico de execuções, selecione a execução mais recente, que é o primeiro item da lista.
Em Execução do aplicativo lógico, agora você pode revisar o status, as entradas e as saídas de cada etapa do seu aplicativo lógico. Expanda a ação Excluir linha .
Para visualizar as entradas, escolha Mostrar entradas brutas.
Para visualizar as saídas, escolha Mostrar saídas brutas.
As saídas não incluem mais o registro excluído da tabela especificada.
Referência do conector
Para obter mais detalhes técnicos sobre esse conector, como gatilhos, ações e limites, conforme descrito pelo arquivo Swagger do conector, consulte a página de referência do conector.