Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)
Quando seu fluxo de trabalho automatizado de integração precisar funcionar com recursos do seu banco de dados DB2, use um conector DB2 para realizar operações no seu banco de dados. Por exemplo, seu fluxo de trabalho pode listar tabelas ou linhas, adicionar linhas, atualizar linhas, deletar linhas, executar consultas e procedimentos armazenados. Essas ações podem retornar dados do banco de dados para que outras ações em seu fluxo de trabalho sejam usadas.
Aplicativos Lógicos do Azure fornece as seguintes versões do conector DB2:
- Conector gerenciado: Disponível para fluxos de trabalho de Consumo e Standard. Para um servidor DB2 local, esse conector requer o gateway de dados local.
- Conector embutido: Disponível apenas para fluxos de trabalho padrão. Esse conector é executado no mesmo processo que o ambiente de execução do Aplicativos Lógicos do Azure e se conecta diretamente ao DB2 via TCP/IP sem o gateway de dados local.
Ambas as versões se comunicam com servidores DB2 remotos por meio de uma rede TCP/IP. Você pode usar qualquer uma das versões para acessar bancos de dados em nuvem, como o IBM DB2 para Windows rodando virtualização no Azure.
Importante
Para sistemas críticos que utilizam fluxos de trabalho padrão, utilize o conector embutido. O conector integrado evita a dependência adicional do gateway e oferece os benefícios de desempenho e taxa de transferência da execução no mesmo processo que o runtime dos Aplicativos Lógicos do Azure. Use o conector gerenciado quando precisar de suas operações específicas ou quando usar um fluxo de trabalho Consumo.
Este guia descreve as operações e a configuração da conexão para ambas as versões dos conectores.
Plataformas e versões com suporte
O conector DB2 dá suporte às seguintes plataformas e versões do IBM DB2, além de produtos compatíveis com o IBM DB2 que dão suporte às versões 10 e 11 do SQL Access Manager (SQLAM) da Distributed Relational Database Architecture (DRDA):
| 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 |
| DB2 IBM para LUW | 11,5, 11,1, 10,5 |
Referência técnica do conector
O conector DB2 tem diferentes versões, dependendo do tipo de app lógica e do ambiente host.
| Aplicativo de lógica | Ambiente | Versão da conexão |
|---|---|---|
| Consumo | Aplicativos Lógicos do Azure multilocatários | Conector gerenciado, que aparece na galeria de conectores sob o filtro Compartilhado . Esse conector só fornece ações, não gatilhos. Para um servidor DB2 local, o conector gerenciado requer o gateway de dados local. Para saber mais, confira a seguinte documentação: - Referência do conector gerenciado do DB2 - Conectores gerenciados em Aplicativos Lógicos do Azure |
| Standard | Plano de Serviço de Fluxo de Trabalho, Ambiente do Serviço de Aplicativo v3 (ASE v3 somente com planos do Windows) e implantação híbrida no Kubernetes habilitado para Azure Arc | O conector gerenciado, que aparece na galeria de conectores sob o filtro Compartilhado, e o conector embutido, que aparece na galeria de conectores sob o filtro Embutido e é baseado em provedor de serviços. Ambas as versões fornecem apenas ações, não gatilhos. Para cargas de trabalho críticas, use o conector embutido, que roda em processo com o runtime do Aplicativos Lógicos do Azure e se conecta diretamente ao DB2 via TCP/IP sem o gateway de dados local. Para saber mais, confira a seguinte documentação: - Referência do conector gerenciado do DB2 - Referência do conector interno do DB2 - Conectores integrados em Aplicativos Lógicos do Azure |
Operações do conector gerenciado
O conector gerenciado DB2 suporta as seguintes operações de banco de dados, que correspondem às 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 | Excluir linha |
Para mais informações sobre o conector gerenciado e essas ações, veja referência ao conector gerenciado DB2.
Operações internas de conectores
O conector embutido do DB2 suporta as seguintes ações:
| Ação | Descrição |
|---|---|
| Tabelas DB2 | Retorne tabelas em um esquema DB2. |
| Excluir linha | Exclua uma ou mais linhas. |
| Executar um procedimento armazenado | Execute um procedimento armazenado e retorne a saída. |
| Executar comando sem retorno | Execute uma instrução SQL que não retorne um conjunto de resultados. |
| Executar consulta | Execute uma consulta SQL e retorne o conjunto de resultados. |
| Inserir linha | Insira uma linha em uma tabela DB2. |
| Atualizar linhas | Atualize uma ou mais linhas em uma tabela DB2. |
Para mais informações sobre o conector embutido e essas ações, veja referência ao conector embutido do DB2.
Pré-requisitos
Uma conta e uma assinatura do Azure. Obtenha uma conta gratuita do Azure.
Um banco de dados IBM DB2, baseado em nuvem ou local.
O recurso de aplicativo lógico e o fluxo de trabalho de onde você deseja acessar seu banco de dados DB2.
O conector DB2 fornece apenas ações. Se você tiver um fluxo de trabalho vazio, primeiro deverá adicionar um gatilho que funcione melhor para o seu cenário.
Os exemplos neste guia usam o gatilho de recorrência Recurrence.
Para obter mais informações, consulte:
Os requisitos de conexão dependem da versão do conector:
Conector gerenciado: Para conectar a um banco de dados DB2 local, primeiro instale e configure 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 interno: O gateway de dados local não é necessário. O ambiente de hospedagem de aplicativos de lógica padrão precisa de acesso de rede ao servidor e porta DB2.
Adicionar uma ação de conector gerenciado do DB2
O exemplo a seguir usa o conector gerenciado do DB2 e mostra como adicionar a ação Get tables . Para usar o conector embutido com um fluxo de trabalho padrão, selecione Embutido na galeria de conectores e então selecione uma ação embutida do DB2, como tabelas DB2.
Observação
As etapas para adicionar qualquer outra ação DB2 são semelhantes, exceto para os parâmetros e valores da ação que você fornece.
No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.
Siga as etapas gerais para adicionar a ação DB2 chamada Obter tabelas.
O painel de informações de conexão é aberto para que você possa fornecer detalhes para conectar seu banco de dados DB2.
Siga as etapas para criar uma conexão para um banco de dados baseado em nuvem ou banco de dados local e retorne aqui para continuar.
Depois de criar a conexão com êxito, o painel de informações da ação Get tables será exibido e mostrará que nenhuma outra informação é necessária.
Continue a testar o fluxo de trabalho e exibir as tabelas de saída.
Configure uma conexão para o conector gerenciado DB2
Siga as etapas com base em se você tem um banco de dados DB2 local ou de nuvem. Depois de fornecer os detalhes de conexão necessários, selecione Criar novo e retorne às etapas anteriores.
Antes de criar uma conexão conectora gerenciada para um banco de dados local, certifique-se de instalar e configurar o gateway de dados local. Esse requisito de gateway não se aplica ao conector embutido.
| Propriedade | Obrigatório | Descrição |
|---|---|---|
| Conectar-se via gateway local | Não | Aplica-se somente a conexões locais. |
| Nome da Conexão | Sim | O nome da conexão, por exemplo, DB2-connection. |
| Servidor | Sim | O endereço, alias e número de porta do seu servidor DB2, por exemplo, myDB2server.example.com:50000. Observação: esse valor é uma cadeia de caracteres que representa um endereço TCP/IP ou alias, em formato IPv4 ou IPv6, seguido por dois-pontos e um número da porta TCP/IP. |
| Banco de dados | Sim | O nome do 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 em que o banco de dados é conhecido como um local IBM DB2 para z/OS. - DB2 para i aceita uma cadeia de caracteres de 18 bytes em que o banco de dados é conhecido como um banco de dados relacional IBM DB2 para i . – O DB2 para LUW aceita uma cadeia de caracteres de 8 bytes. |
| 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 se baseia no banco de dados específico: – O DB2 para z/OS aceita uma cadeia de caracteres de 8 bytes. – O DB2 para i aceita uma cadeia de caracteres de 10 bytes. – O DB2 para Linux ou UNIX aceita uma cadeia de caracteres de 8 bytes. – O DB2 para Windows aceita uma cadeia de caracteres de 30 bytes. |
| Senha | Sim | Sua senha para o banco de dados. |
Por exemplo:
Configure uma conexão para o conector embutido do DB2
Para fluxos de trabalho padrão críticos, use o conector embutido. O conector embutido se conecta diretamente do runtime do Aplicativos Lógicos do Azure ao seu servidor DB2 via TCP/IP e não usa o gateway de dados local. Certifique-se de que o ambiente de hospedagem de aplicativos de lógica Standard tenha acesso à rede ao servidor e porta do DB2.
No designer de workflow, selecione Built-in, selecione a ação do DB2 que você deseja e crie uma conexão. Forneça as seguintes informações conforme aplicável ao seu ambiente DB2:
| Propriedade | Descrição |
|---|---|
| Nome da Conexão | O nome da conexão. |
| Nome do servidor | O nome do servidor DB2. |
| Número da porta | O número da porta do banco de dados no servidor DB2. |
| Banco de dados | O nome do banco de dados no servidor DB2. |
| Nome de usuário | O nome de usuário para acessar o servidor DB2. |
| Senha | A senha do nome de usuário do DB2. |
| Coleção de Pacotes | A coleção de pacotes. O padrão é o nome de usuário se estiver vazio. |
| Esquema Padrão | O esquema padrão para chamadas de esquema usa o nome de usuário como padrão se estiver em branco. |
| CCSID anfitrião | O identificador de conjunto de caracteres codificado pelo host (CCSID) para o banco de dados DB2 tem como padrão 1208 se estiver vazio. |
| Página de código do PC | A página de código do PC para a conexão com o DB2 assume 1208 como padrão se estiver em branco. |
| Palavras-chave adicionais da cadeia de conexão | Palavras-chave opcionais da cadeia de conexão, separadas por ponto e vírgula. |
| String de Conexão | A cadeia de conexão do DB2 que, se não estiver vazia, as demais propriedades são ignoradas. |
Testar o fluxo de trabalho e exibir tabelas de saída
O exemplo a seguir mostra a saída da ação Get tables do conector gerenciado. Você pode testar um fluxo de trabalho que usa uma ação de conector embutida da mesma forma. Para executar manualmente o fluxo de trabalho, na barra de ferramentas do designer, na lista Executar , selecione Executar. Após a conclusão do fluxo de trabalho, você pode visualizar o resultado da execução.
Se a página de detalhes de execução não for aberta, siga estas etapas com base em seu aplicativo lógico:
Consumo: na barra lateral do Logic App, em Ferramentas de Desenvolvimento, selecione Logic App Designer.
Padrão: na barra lateral do fluxo de trabalho, selecione Histórico de execuções.
Na lista Histórico de Execuções , selecione a execução mais recente do fluxo de trabalho, por exemplo:
Consumo
Standard
A captura de tela mostra o histórico de execução para o fluxo de trabalho standard.
Na página de detalhes da execução, examine o status de cada etapa em seu fluxo de trabalho. Para exibir as entradas e saídas de cada etapa, selecione essa etapa, por exemplo:
Para exibir as entradas no JSON, selecione Mostrar entradas brutas.
Para exibir as saídas no JSON, selecione Mostrar saídas brutas.
As saídas incluem uma lista de tabelas, por exemplo:
