Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a: Azure Logic Apps (Consumo e Standard)
Quando o seu fluxo de trabalho automatizado de integração precisar de trabalhar com recursos na sua base de dados DB2, use um conector DB2 para realizar operações na sua base de dados. Por exemplo, o seu fluxo de trabalho pode listar tabelas ou linhas, adicionar linhas, atualizar linhas, eliminar linhas, executar consultas e executar procedimentos armazenados. Estas ações podem devolver dados da sua base de dados para outras ações do seu fluxo de trabalho a utilizar.
O Azure Logic Apps fornece as seguintes versões do conector DB2:
- Conector gerido: Disponível para fluxos de trabalho Consumption e Standard. Para um servidor DB2 local, este conector requer o gateway de dados local.
- Conector incorporado: Disponível apenas para fluxos de trabalho padrão. Este conector corre em processo com o runtime do Azure Logic Apps e liga-se diretamente ao DB2 via TCP/IP sem o gateway de dados local.
Ambas as versões comunicam com servidores DB2 remotos através de uma rede TCP/IP. Pode usar qualquer uma das versões para aceder a bases de dados na cloud, como o IBM DB2 para Windows a correr em virtualização no Azure.
Importante
Para sistemas críticos que utilizam fluxos de trabalho padrão, utilize o conector incorporado. O conector incorporado evita a dependência extra do gateway e oferece os benefícios de desempenho e rendimento de correr em processo com o runtime do Azure Logic Apps. Utilize o conector gerido quando necessitar das suas operações específicas ou quando utilizar um fluxo de trabalho de Consumo.
Este guia descreve as operações e a configuração da ligação para ambas as versões dos conectores.
Plataformas e versões suportadas
O conector DB2 suporta as seguintes plataformas e versões IBM DB2, juntamente com produtos compatíveis com IBM DB2 que suportam Distributed Relational Database Architecture (DRDA) SQL Access Manager (SQLAM) versões 10 e 11:
| Plataforma | Versão |
|---|---|
| IBM DB2 para z/OS | 12, 11.1, 10.1 |
| IBM DB2 para i | 7.4, 7.3, 7.2, 7.1 |
| IBM DB2 para LUW | 11,5, 11,1, 10,5 |
Referência técnica do conector
O conector DB2 tem diferentes versões, consoante o tipo de aplicação lógica e o ambiente anfitrião.
| Aplicação de Lógica | Meio Ambiente | Versão da conexão |
|---|---|---|
| Consumo | Aplicativos Lógicos Multilocatário do Azure | Conector gerenciado, que aparece na galeria de conectores sob o filtro Compartilhado . Este conector fornece apenas ações, não gatilhos. Para um servidor DB2 local, o conector gerido requer o gateway de dados local. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerido DB2 - Conectores gerenciados em Aplicativos Lógicos do Azure |
| Standard | Workflow Service Plan, Ambiente do Serviço de Aplicações v3 (ASE v3 apenas com planos Windows) e implementação híbrida no Kubernetes com Azure Arc | Conector gerido, que aparece na galeria de conectores sob o filtro Compartilhado, e conector interno, que aparece na galeria de conectores sob o filtro Interno e é baseado no fornecedor de serviços. Ambas as versões fornecem apenas ações, não gatilhos. Para cargas de trabalho críticas, use o conector incorporado, que corre em processo com o runtime do Azure Logic Apps e liga-se diretamente ao DB2 via TCP/IP sem o gateway de dados local. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerido DB2 - Referência do conector incorporado do DB2 - Conectores integrados nas Aplicações Lógicas do Azure |
Operações gerenciadas do conector
O conector gerido DB2 suporta as seguintes operações na base de dados, que correspondem às 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 | Obtenha linhas |
| Adicionar uma linha usando INSERT | Inserir linha |
| Editar uma linha usando UPDATE | Atualizar linha |
| Remover uma linha usando DELETE | Eliminar linha |
Para mais informações sobre o conector gerido e estas ações, consulte referência de conectores geridos DB2.
Operações de ligação incorporadas
O conector incorporado do DB2 suporta as seguintes ações:
| Action | Descrição |
|---|---|
| Tabelas DB2 | Tabelas de retorno num esquema DB2. |
| Excluir linha | Apaga uma ou mais linhas. |
| Executar um procedimento armazenado | Executa um procedimento armazenado e devolve a saída. |
| Executar comando sem consulta | Executa uma instrução SQL que não devolve um conjunto de resultados. |
| Executar consulta | Executa uma consulta SQL e devolve o conjunto de resultados. |
| Inserir linha | Insere uma linha numa tabela DB2. |
| Atualizar linhas | Atualize uma ou mais linhas numa tabela DB2. |
Para mais informações sobre o conector incorporado e estas ações, consulte a referência do conector incorporado DB2.
Pré-requisitos
Uma conta do Azure e uma subscrição. Crie uma conta Azure gratuita.
Uma base de dados IBM DB2, seja baseada na cloud ou on-premises.
O recurso e fluxo de trabalho da aplicação lógica a partir de onde queres aceder à tua base de dados DB2.
O conector DB2 fornece apenas ações. Se tiver um fluxo de trabalho vazio, deve primeiro adicionar um gatilho que funcione melhor para o seu cenário.
Os exemplos deste guia utilizam o gatilho de Recorrência.
Para obter mais informações, consulte:
Os requisitos de ligação dependem da versão do conector:
Conector gerido: Para se ligar a uma base de dados DB2 local, instale e configure primeiro o gateway de dados local. O gateway não é necessário quando o servidor DB2 está disponível publicamente ou acessível no Azure.
Conector incorporado: O gateway de dados local não é obrigatório. O ambiente de alojamento de aplicações Standard Logic necessita de acesso de rede ao servidor e porta DB2.
Adicionar uma ação de conector gerida DB2
O exemplo seguinte utiliza o conector gerido DB2 e mostra como adicionar a ação Obter tabelas. Para usar o conector incorporado com um fluxo de trabalho Standard, selecione Incorporado na galeria de conectores e depois selecione uma ação integrada do DB2, como tabelas DB2.
Observação
Os passos para adicionar qualquer outra ação do DB2 são semelhantes, exceto pelos parâmetros e valores da ação que forneces.
No portal do Azure, abra o recurso e o fluxo de trabalho da aplicação lógica no Designer.
Siga os passos gerais para adicionar a ação do DB2 chamada Get tables.
O painel de informação de ligação abre-se para que possas fornecer detalhes para ligar a tua base de dados DB2.
Siga os passos para criar uma ligação para uma base de dados baseada na cloud ou on-premises e depois volte aqui para continuar.
Depois de criar com sucesso a ligação, o painel de informação de ações Get tables aparece e mostra que não é necessária mais informação:
Continue a testar o seu fluxo de trabalho e a visualizar as tabelas de saída.
Configure uma ligação para o conector gerido do DB2
Siga os passos consoante se tem uma base de dados DB2 na cloud ou local. Depois de fornecer os detalhes necessários da ligação, selecione Criar nova e volte aos passos anteriores.
Antes de criar uma ligação de conector gerido a uma base de dados no local, certifique-se de que o gateway de dados no local está instalado e configurado. Este requisito de porta de ligação não se aplica ao conector integrado.
| Propriedade | Necessário | Descrição |
|---|---|---|
| Ligue-se através de gateway no local | Não | Aplica-se apenas a ligações locais. |
| Nome da Ligação | Sim | O nome da sua ligação, por exemplo, conexão DB2. |
| Servidor | Sim | O endereço ou alias e número de porta do seu servidor DB2, por exemplo, myDB2server.example.com: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 da tua base 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 cadeia de 16 bytes onde a base de dados é conhecida como IBM DB2 para a localização do z/OS . - DB2 para i aceita uma cadeia de 18 bytes onde a base de dados relacional é conhecida como IBM DB2 para i. - O DB2 para LUW aceita uma string de 8 bytes. |
| Nome de utilizador | Sim | Seu nome de usuário para o banco 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. - O DB2 for i aceita uma string de 10 bytes. - O DB2 para Linux ou UNIX aceita uma string de 8 bytes. - O DB2 para Windows aceita uma string de 30 bytes. |
| Palavra-passe | Sim | A sua palavra-passe para a base de dados. |
Por exemplo:
Configurar uma ligação para o conector incorporado do DB2
Para fluxos de trabalho padrão críticos, utilize o conector incorporado. O conector incorporado liga-se diretamente do runtime do Azure Logic Apps ao seu servidor DB2 via TCP/IP e não utiliza o gateway de dados local. Garantir que o ambiente de alojamento de aplicações de lógica Standard tem acesso à rede ao servidor e porta DB2.
No designer de workflow, seleciona Built-in, seleciona a ação do DB2 que queres e cria uma ligação. Forneça as seguintes informações aplicáveis ao seu ambiente DB2:
| Propriedade | Descrição |
|---|---|
| Nome da Ligação | O nome da conexão. |
| Nome do Servidor | O nome do servidor DB2. |
| Número da porta | O número da porta da base de dados no servidor DB2. |
| Base de dados | O nome da base de dados no servidor DB2. |
| Nome de Utilizador | O nome de utilizador para aceder ao servidor DB2. |
| Palavra-passe | A palavra-passe do nome de utilizador do DB2. |
| Coleção de Pacotes | A coleção de pacotes. Se estiver vazio, é predefinido como o nome de utilizador. |
| esquema padrão | O esquema predefinido para chamadas ao esquema; se estiver vazio, é utilizado o nome de utilizador. |
| CCSID anfitrião | O identificador do conjunto de caracteres codificados do anfitrião (CCSID) para a base de dados DB2 assume por predefinição o valor 1208 se estiver em branco. |
| Página de códigos do PC | A página de códigos do PC para a ligação DB2 define por defeito 1208 se estiver vazia. |
| Palavras-chave adicionais da cadeia de ligação | Palavras-chave opcionais da cadeia de ligação, separadas por ponto e vírgula. |
| String de Conexão | A cadeia de ligação do DB2 que, se não estiver vazia, faz com que as restantes propriedades sejam ignoradas. |
Teste o seu fluxo de trabalho e veja as tabelas de saída
O exemplo seguinte mostra o resultado da ação Obter tabelas do conector gerido. Podes testar um fluxo de trabalho que usa uma ação de conector incorporada da mesma forma. Para executar manualmente o seu fluxo de trabalho, na barra de ferramentas designer, a partir da lista Executar , selecione Executar. Depois de terminar o seu fluxo de trabalho, pode ver o resultado da execução.
Se a página de detalhes da corrida não abrir, siga estes passos baseados na sua aplicação lógica:
Consumo: Na barra lateral da app Logic, em Ferramentas de Desenvolvimento, selecione Designer da aplicação Logic.
Padrão: Na barra lateral do fluxo de trabalho, selecione Histórico de Execução.
Na lista de histórico de execuções , selecione a última execução do fluxo de trabalho, por exemplo:
Consumo
Standard
Na página de detalhes da execução, verifique o estado de cada etapa do seu fluxo de trabalho. Para visualizar as entradas e saídas de cada passo, selecione esse passo, por exemplo:
Para visualizar as entradas em JSON, selecione Mostrar entradas brutas.
Para visualizar as saídas em JSON, selecione Mostrar saídas brutas.
Os resultados incluem uma lista de tabelas, por exemplo:
