Como usar o App Connect com o IBM Db2

IBM Db2 é um banco de dados desenvolvido para viabilizar transações de baixa latência e análises em tempo real em grande escala. Ele fornece um único mecanismo para DBAs, arquitetos corporativos e desenvolvedores para manter aplicativos críticos em execução, armazenar e consultar qualquer coisa, além de acelerar a tomada de decisões e a inovação em toda a organização.

As informações a seguir descrevem como usar o App Connect para conectar o IBM Db2 às suas outras aplicações.

Versões de produto e API suportadas

Para saber quais versões de produtos e APIs este conector suporta, consulte Requisitos detalhados do sistema na página de suporte do IBM.

Conectando-se a IBM Db2

Para conectar o App Connect a uma conta do IBM Db2 que você deseja que o App Connect utilize, você precisa dos seguintes dados de conexão. Se você não for o proprietário ou administrador da sua instância do Db2, pode solicitar essas informações ao administrador do Db2.

Dica: para o Db2 on Cloud, é possível visualizar os detalhes e as credenciais do banco de dados por meio da visualização Credenciais de serviço do serviço Db2 on Cloud em seu painel do IBM Cloud® .

IBM Db2 campos de conexão:

Nome da conta: Forneça um nome significativo para sua conta que o ajude a identificá-la.

Tabela 1. Campos de conexão com autenticação BASIC
Campo de conexão..	Descrição
Tipo de banco de dados	Selecione o tipo de banco de dados ao qual você se conectará As opções disponíveis são: IBM Db2 Linux, UNIX ou Windows (LUW) - gerenciado pelo cliente IBM Db2 Linux, UNIX ou Windows (LUW) - IBM Cloud IBM Db2 for i
Nome de host do banco de dados	O nome de host completo ou o endereço IP do banco de dados IBM Db2 (por exemplo, `myserver.abc.com` ou `192.0.2.24`). Para Db2 on Cloud, você pode encontrar o nome do host e a porta na guia Credenciais do serviço da sua página Db2 on Cloud de serviço e no arquivo JSON dos Serviços VCAP. O exemplo a seguir mostra valores típicos de nome de host e porta: `jdbc:db2://db2server.company.com:50000/FINANCE` (Rede corporativa) `jdbc:db2://db2-instance-01.us-east.cloud.ibm.com:50001/HRDB` (Implantação em nuvem)
Porta do banco de dados	A porta utilizada pelo banco de dados IBM Db2 para escutar conexões de clientes.
Nome do banco de dados	Especifique o nome do banco de dados IBM Db2. Dica: No IBM i, você pode usar a seguinte consulta para recuperar o nome do banco de dados: `select current server from sysibm.sysdummy1`
Nome de usuário	Especifique o nome de usuário para acessar o banco de dados IBM Db2.
Senha	Especifique a senha do usuário da base de dados IBM Db2.
Esquema	Especifique o qualificador de esquema para os objetos de banco de dados a serem acessados Se deixado em branco, o qualificador de esquema será padronizado para o nome do usuário
Tamanho máximo do conjunto	O número máximo de conexões permitidas dentro de um único conjunto de conexões
Parâmetros adicionais	Pares de nome ou valor de parâmetros adicionais no formato `name1=value1;name2=value2`. Alguns tipos de banco de dados exigem parâmetros específicos, que podem ser adicionados à string de conexão usada para estabelecer uma conexão inicial com o servidor IBM Db2.
Conexão de rede privada	'Selecione o nome de um agente de rede privada que App Connect usa para se conectar à sua rede privada. Essa lista é preenchida com os nomes dos agentes de rede privada que são criados na página Redes privadas. Para obter mais informações, consulte ' Conexão a uma rede privada.

Tabela 2. SSL campos de conexão de autenticação (disponíveis apenas no Designer do IBM App Connect Enterprise executado localmente)
Campo de conexão..	Descrição
Tipo de banco de dados	Selecione o tipo de banco de dados ao qual você se conectará As opções disponíveis são: IBM Db2 Linux, UNIX ou Windows (LUW) - gerenciado pelo cliente IBM Db2 for i
Nome de host do banco de dados	O nome de host completo ou o endereço IP do banco de dados IBM Db2 (por exemplo, `myserver.abc.com` ou `192.0.2.24`).
Porta do banco de dados	A porta utilizada pelo banco de dados IBM Db2 para escutar conexões de clientes.
Nome do banco de dados	Especifique o nome do banco de dados IBM Db2. Dica: No IBM i, você pode usar a seguinte consulta para recuperar o nome do banco de dados: `select current server from sysibm.sysdummy1`
Nome de usuário	Especifique o nome de usuário para acessar o banco de dados IBM Db2.
Senha	Especifique a senha do usuário da base de dados IBM Db2.
Esquema	Especifique o qualificador de esquema para os objetos de banco de dados a serem acessados Se deixado em branco, o qualificador de esquema será padronizado para o nome do usuário
Certificado CA do servidor de banco de dados	Especifique o certificado da CA ou do servidor no formato PEM apenas quando o servidor utilizar um certificado autoassinado ou se o certificado ainda não for considerado confiável (CA privada).
Tamanho máximo do conjunto	O número máximo de conexões permitidas dentro de um único conjunto de conexões
Parâmetros adicionais	Pares de nome ou valor de parâmetros adicionais no formato `name1=value1;name2=value2`. Alguns tipos de banco de dados exigem parâmetros específicos, que podem ser adicionados à string de conexão usada para estabelecer uma conexão inicial com o servidor IBM Db2.

Para obter mais informações sobre os campos de conexão do ` IBM Db2 `, consulte a documentação do produto ` IBM Db2 `.

Para se conectar a um endpoint IBM Db2 a partir da página Conectar > Aplicativos e APIs do App Connect Designer ( anteriormente a página Catálogo ) pela primeira vez, expanda IBM Db2 e clique em Conectar. Para obter mais informações, consulte Gerenciamento de contas.

Dica:

Antes de usar a conta criada no App Connect em um fluxo, renomeie a conta para algo significativo que o ajude a identificá-la. Para renomear a conta na página Aplicativos e APIs, selecione a conta, abra o menu de opções (⋮) e clique em Renomear conta.

O que devo considerar primeiro?

Antes de usar o Designer d App Connect com o IBM Db2, observe as seguintes considerações:

Db2 (gerenciado pelo cliente)
Db2 on Cloud (IBM)
Considerações para eventos do Db2 para acionar fluxos
Considerações gerais

Considerações do Db2 (gerenciado pelo cliente)

App Connect suporta o banco de dados do IBM Db2 nas edições para Linux®, UNIX e Windows (LUW) ou na versão IBM i executada localmente, para uso em fluxos orientados a eventos e fluxos de API. Para obter mais informações sobre essas ofertas da Db2, acesse https://www.ibm.com/analytics/us/en/db2/#prod-db2-editions.
Se você não tiver uma conta paga/empresarial ou se houver restrições em sua conta empresarial, você pode criar uma conta gratuita no IBM Db2 para testar como o Db2 se integra ao App Connect. Você pode escolher uma destas edições gratuitas para usar em seu ambiente de teste ou de prova de conceito: IBM Db2 database (período de avaliação limitado a 90 dias), IBM Db2 Developer Community Edition ou IBM Db2 Express-C Edition. Você precisará de uma conta no IBM, com um endereço de e-mail IBMid e uma senha, para baixar o produto.
Assegure-se de que seu servidor Db2 esteja em execução e que exista uma conexão com o banco de dados para o banco de dados que você deseja usar com o App Connect.
O App Connect suporta operações com relação aos objetos de banco de dados a seguir apenas: tabelas e visualizações As contas do usuário que o App Connect usará para se conectar ao banco de dados Db2 devem ter privilégios GRANT para criar, recuperar e atualizar ou criar (INSERT, SELECT, MERGE) linhas / registros em tabelas e visualizações.
Por exemplo, a conexão App Connect com o Db2 mostrado na figura a seguir fornece operações para as tabelas CONTACTS e CLIENTS e para as visualizações CUSTOMERS_VIEW e V1. Para a visualização V1 , a operação Retrieve V1 records é suportada.

Figura 1. Exemplo de tabelas e visualizações do Db2 no App Connect
'Selecione o nome de um agente de rede privada que App Connect usa para se conectar à sua rede privada. Essa lista é preenchida com os nomes dos agentes de rede privada que são criados na página Redes privadas. Para obter mais informações, consulte ' Conexão a uma rede privada.

Db2 on Cloud (serviço gerenciado pelaIBM)

Se você ainda não conhece o IBM Db2 on Cloud e deseja saber mais sobre ele, pode ler as informações, fazer um tour pelo produto ou começar a usá-lo gratuitamente na página do produto Db2 on Cloud.

O App Connect suporta operações com relação aos objetos de banco de dados a seguir apenas: tabelas e visualizações Por exemplo, a conta de conexão do App Connect para Db2 on Cloud mostrada na figura a seguir mostra as operações de eventos disponíveis para a tabela SALES e a operação de ação de Recuperação disponível para a visualização SALES_JAN_VIEW.
Figura 2 Exemplo de tabelas e visualizações do Db2 on Cloud no App Connect.
Ao criar pela primeira vez uma conta no App Connect para se conectar ao Db2 on Cloud, há um atraso enquanto o Db2 on Cloud conclui a conexão com o banco de dados. Se não for possível mostrar os eventos ou ações para o banco de dados imediatamente, assegure-se de que a instância do Db2 possa ser acessada e aguarde aproximadamente 30 minutos antes de tentar novamente mostrar os eventos ou ações.
Quando a conexão com o Db2 on Cloud estiver concluída, você poderá ver os eventos e ações configuráveis na página Aplicativos e APIs do App Connect Designer ou selecionar entre essas opções ao adicionar um evento ou ação Db2 on Cloud a um fluxo, por exemplo, como mostrado na figura acima.

Considerações para eventos do Db2 para acionar fluxos

Para usar o ` IBM Db2 ` como aplicativo de origem em um fluxo, você precisará configurar o evento de sondagem ` Db2 `, que deve acionar o fluxo. Você pode consultar o endereço Db2 em intervalos de tempo específicos para verificar se há registros novos ou atualizados em suas tabelas ou visualizações e, em seguida, configurar os aplicativos de destino para executar ações sempre que forem detectadas alterações nos registros d Db2. O mecanismo de sondagem só pode ser configurado para tabelas e visualizações d Db2 s que incluam colunas de data e hora (com o tipo de dados TIMESTAMP) que armazenem os carimbos de data e hora de criação e atualização de um registro. Em resumo:

Uma coluna criada em e uma coluna atualizada em devem existir nas tabelas e visualizações do Db2 . Essas colunas Db2 devem ser definidas como TIMESTAMP. Ao configurar o evento pesquisado no App Connect, você seleciona a coluna Db2 para o Campo de registro de data e hora criado e o Campo de registro de data e hora atualizado.
Se você usar o formato de registro de data e hora padrão no Db2 (YYYY-MM-DD HH:MM:SS), será possível usar o Formato dos registros de data e hora padrão no App Connect (YYYY-MM-DDTHH:MM:SS).

Para obter mais informações sobre como configurar eventos pesquisados, consulte Configurando eventos pesquisados para acionar fluxos

Figura 3. Exemplo dos campos para configurar o App Connect para detectar um evento do Db2 pesquisando

Considerações gerais

Para usar o IBM Db2 como aplicativo de destino em um fluxo, você pode escolher entre um conjunto de ações detectadas que permitem criar, recuperar ou atualizar registros dos objetos do seu banco de dados.
A inserção de dados em massa de aplicativos com transferência de dados de alta velocidade não é suportada atualmente. Se você iniciar um fluxo usando um conector de origem com um conjunto de dados grande (por exemplo, Salesforce) para migração de dados para o DB2, o conector DB2 não poderá manipular as solicitações simultâneas e os resultados em falhas de inserção de dados.
(Consideração geral) Você pode ver listas dos eventos e ações de acionamento disponíveis na página Aplicativos e APIs do App Connect Designer.
Para alguns aplicativos, os eventos e as ações dependem do ambiente e do fato de o conector oferecer suporte a eventos configuráveis e descoberta dinâmica de ações. Se o aplicativo suportar eventos configuráveis, você verá um link Mostrar mais eventos configuráveis sob a lista de eventos Se o aplicativo suportar descoberta dinâmica de ações, você verá um link Mostrar mais na lista de ações.
(Consideração geral) Se você estiver usando várias contas para um aplicativo, o conjunto de campos que é exibido ao selecionar uma ação para esse aplicativo poderá variar para diferentes contas. No editor de fluxo, alguns aplicativos sempre fornecem um conjunto curado de campos estáticos para uma ação.. Outros aplicativos usam a descoberta dinâmica para recuperar o conjunto de campos configurados na instância à qual você está conectado. Por exemplo, se você tiver duas contas para duas instâncias de um aplicativo, a primeira conta poderá usar configurações prontas para uso imediato. Entretanto, a segunda conta pode ser configurada com campos customizados extras.

IBM Db2 para os requisitos de privilégios d z/OS

Ao se conectar ao IBM Db2 para o z/OS, o App Connect requer privilégios específicos de IBM Db2 para acessar os dados da aplicação e identificar os metadados do banco de dados. Esses privilégios são concedidos ao ID de usuário IBM Db2 ou à conta de serviço utilizada pelo aplicativo.

Conceda apenas os privilégios mínimos necessários para o seu caso de uso.

Privilégios necessários por operação

A tabela a seguir lista os privilégios mínimos necessários para operações SQL comuns em tabelas de aplicativos.

Operação	Tipo de SQL	Privilégio necessário	Âmbito do objeto
Criar	`INSERT`	`INSERT`	Tabelas de usuário
Criar (em massa)	`INSERT`	`INSERT`	Tabelas de usuário
Ler ou recuperar	`SELECT`	`SELECT`	Tabelas de usuário
Atualizar	`UPDATE`	`UPDATE`	Tabelas de usuário
Atualização (em massa)	`UPDATE`	`UPDATE`	Tabelas de usuário
Fazer upsert	`MERGE`	`INSERT`, `UPDATE`	Tabelas de usuário
Excluir	`DELETE`	`DELETE`	Tabelas de usuário
Ler (com TABELA ANTIGA)	`SELECT`	`SELECT`	Tabelas de usuário
Leia (com a TABELA FINAL)	`SELECT`	`SELECT`	Tabelas de usuário

Db2 privilégios do catálogo do sistema

Para listar esquemas, tabelas, colunas e relações, o ` App Connect ` requer acesso às tabelas do catálogo do sistema ` IBM Db2 `.

Operação	Tabela de sistema	Privilégio necessário	Justificativa
Listar tabelas e visualizações	`SYSIBM.SYSTABLES`	`SELECT`	Necessário para identificar tabelas e visualizações disponíveis, juntamente com informações sobre privilégios.
Recuperar privilégios da tabela	`SYSIBM.SYSTABAUTH`	`SELECT`	Permite a recuperação de informações de autorização no nível da tabela (SELECT/INSERT/UPDATE/DELETE).
Recuperar metadados da coluna	`SYSIBM.SYSCOLUMNS`	`SELECT`	Recuperar definições de colunas, tipos de dados, permissão de valores nulos e colunas de identidade.
Recuperar comentários das colunas	`SYSIBM.SYSCOLUMNS`	`SELECT`	Recuperar observações ou descrições das colunas.
Descubra as chaves primárias	`SYSIBM.SYSINDEXES, SYSIBM.SYSKEYS`	`SELECT`	Descubra as colunas de chave primária por meio dos metadados do índice (UNIQUERULE='P').
Descubra as chaves estrangeiras	`SYSIBM.SYSFOREIGNKEYS, SYSIBM.SYSRELS, SYSIBM.SYSKEYCOLUSE`	`SELECT`	Descubra as relações de chave estrangeira e as tabelas referenciadas.

Resumo dos privilégios mínimos necessários

Escopo	Privilégios necessários	Justificativa
Tabelas de usuários (Tabelas de aplicativos)	`SELECT`	Para todas as tabelas ou visualizações a serem acessadas.
	`INSERT`	Para tabelas que exigem operações de criação.
	`UPDATE`	Para tabelas que exigem operações de atualização.
	`DELETE`	Para tabelas que exigem operações de exclusão.
Tabelas do catálogo do sistema ( IBM Db2 para z/OS )	`SELECT on SYSIBM.SYSTABLES`	Permite a descoberta de metadados sem conceder acesso desnecessário aos dados.
	`SELECT on SYSIBM.SYSTABAUTH`
	`SELECT on SYSIBM.SYSCOLUMNS`
	`SELECT on SYSIBM.SYSINDEXES`
	`SELECT on SYSIBM.SYSKEYS`
	`SELECT on SYSIBM.SYSFOREIGNKEYS`
	`SELECT on SYSIBM.SYSRELS`
	`SELECT on SYSIBM.SYSKEYCOLUSE`

Para obter instruções passo a passo sobre como conceder esses privilégios, consulte “Configuração de privilégios do IBM Db2 for z/OS ”.

Notas adicionais

OLD TABLE: Em IBM Db2 para z/OS, OLD TABLE é uma construção especial de SQL que retorna a imagem anterior das linhas afetadas por uma instrução de alteração de dados.
FINAL TABLE: Em IBM Db2 para z/OS, FINAL TABLE é uma construção especial de SQL que retorna a imagem posterior das linhas geradas por uma instrução de alteração de dados.
FINAL TABLE e OLD TABLE cláusulas: As FINAL TABLE e OLD TABLE cláusulas são cláusulas do tipo Db2-specific, que podem ser INSERTespecificadas com as instruções DELETE , UPDATE, ou para retornar as linhas afetadas pela operação. A autorização para usar essas cláusulas requer os mesmos privilégios básicos (INSERT, UPDATE, ou DELETE) que a instrução subjacente.

Eventos e ações

IBM Db2 eventos

Esses eventos são para mudanças neste aplicativo que acionam um fluxo para iniciar a conclusão das ações no fluxo.

Mostrar eventos configuráveis

Eventos que são mostrados por padrão são pré-configurados usando conectividade otimizada. Mais itens estão disponíveis após você configurar eventos que podem acionar um fluxo pesquisando esse aplicativo para objetos novos ou atualizados.

IBM Db2 ações

O seu fluxo conclui essas ações neste aplicativo

Objeto	Ação	Descrição
SQL Customizado	Executar SQL personalizado	Executa o SQL personalizado

Mais itens estarão disponíveis depois que você conectar App Connect a IBM Db2.

Exemplos

Bloco do painel para um modelo que utiliza o ` IBM Db2 `

Use modelos para criar fluxos rapidamente no IBM Db2

Saiba como usar os modelos do App Connect para criar rapidamente fluxos que executam ações no IBM Db2. Por exemplo, acesse a página Descobrir e pesquise por IBM Db2.

Saiba mais

Use o App Connect para criar fluxos que se integram ao IBM Db2 for i.

Leia o blog da Comunidade do IBM para saber como armazenar os dados da issue no IBM Db2 sempre que uma nova issue for criada no Jira. Clique em Ler o blog para acessar o blog.

Leia o blog