Conectando o software IRI ao Oracle

Visão geral

Conectar-se a um banco de dados como o Oracle pode ser a parte mais frustrante da instalação e configuração do aplicativo. As muitas opções disponíveis com drivers JDBC e ODBC podem ser assustadoras. As siglas por si só são suficientes para causar dor de cabeça.

A pilha de software IRI usa drivers JDBC e ODBC para diferentes propósitos. O IRI Workbench requer conexões JDBC para acesso aos dados e metadados nos bancos de dados. O uso do IRI Workbench é totalmente opcional. No entanto, a integração de metadados do banco de dados, além de vários assistentes e editores, torna muito mais fácil criar e manter os scripts de tarefa e arquivos de configuração usados pelo mecanismo de processamento de dados IRI, SortCL.

O IRI Workbench, com suas conexões JDBC, também é necessário para executar o IRI DarkShield®, para a descoberta e mascaramento de armazenamentos de dados e documentos semiestruturados e não estruturados. Drivers e conexões ODBC são necessários para a execução em tempo de execução de trabalhos IRI Voracity® ETL e ferramentas de componentes como CoSort®, RowGen®, FieldShield® e NextForm® que também originam e direcionam dados em bancos de dados.

As instruções e exemplos neste artigo são baseados no método Oracle Easy Connect (EZCONNECT). Se por algum motivo seus bancos de dados Oracle não puderem usar o EZCONNECT, você terá que contar com a documentação fornecida pela Oracle e outros recursos para configurar suas conexões.

Reunir informações

Existem vários detalhes que você precisa saber sobre seu banco de dados antes de configurar qualquer conexão. Essas informações devem ser disponibilizadas por um administrador de banco de dados. Se você mesmo administra o banco de dados, esta informação pode ser encontrada em listener.ora arquivo de configuração.

Colete os detalhes mostrados na Tabela 1 para o banco de dados que requer uma conexão. Essas informações são necessárias para conexões JDBC e ODBC.

Tabela 1 – Detalhes necessários para criar uma conexão de banco de dados.

Mais sobre as informações necessárias:

O host pode ser um nome de host ou um endereço IP. Os nomes de host podem ser uma palavra, com um domínio implícito, um nome totalmente qualificado, incluindo o domínio.
Porta é um único número inteiro. O padrão é 1521, mas pode ser alterado pelo administrador do banco de dados.
Cada instância de banco de dados tem um SID. O SID deve ser exclusivo se houver mais de uma instância compartilhando o mesmo host e porta. Às vezes, a instância é referenciada por um nome de serviço, em vez do SID. Se o banco de dados ao qual você está se conectando tiver um nome de serviço, você deve usá-lo.
O nome de usuário deve ser o nome de usuário do Oracle associado ao esquema ou esquemas com os quais você trabalhará. É melhor escolher um usuário com um escopo limitado de privilégios de esquema. O uso de uma conta de usuário SYSTEM pode resultar na visibilidade de um número não gerenciável de esquemas e tabelas.
A senha deve corresponder ao nome de usuário especificado.

Depois que as informações corretas forem coletadas, você estará pronto para criar as conexões ODBC e JDBC.

ODBC

O gerenciador ODBC e os drivers vêm em arquiteturas de dois bits, 32 bits e 64 bits. A arquitetura de bits do gerenciador e driver deve corresponder à arquitetura de bits do aplicativo usando a conexão. No Windows®, os mecanismos de tempo de execução IRI geralmente são da variedade de 32 bits, mesmo quando executados em um sistema operacional de 64 bits. No Linux e no Unix, os aplicativos de 64 bits prevalecem.

Antes de escolher a arquitetura de bits de seus drivers ODBC, é importante conhecer a arquitetura de bits do produto de tempo de execução IRI usando SortCL, como CoSort ou FieldShield. Se você não tiver certeza da arquitetura de bits do seu mecanismo IRI, poderá verificá-la usando o comando version. Forme a linha de comando, execute:

sortcl /v

No IRI Workbench, a Ajuda> Informações sobre a versão item de menu exibirá os mesmos resultados. A arquitetura de bits pode ser encontrada na string da versão, conforme mostrado na Tabela 2.

Tabela 2 – Determinando a arquitetura de bits CoSort.

Determine a arquitetura de bits correta. Você precisará dele para identificar o Gerenciador ODBC correto a ser usado e para baixar e instalar os drivers ODBC adequados. O uso de gerenciadores e drivers ODBC no Linux, Unix e Mac é mais complicado e está além do escopo deste artigo.

Os exemplos aqui usarão o ODBC Manager fornecido pela Microsoft com o Windows. Se você usa outro sistema operacional e precisa de ajuda, entre em contato com seu representante IRI.

As conexões ODBC são identificadas com um identificador exclusivo conhecido como Data Source Name (DSN). A Microsoft fornece o Administrador de Fonte de Dados ODBC programa com Windows, para definir e configurar DSNs.

É importante escolher o programa ODBC Administrator com a arquitetura de bits correta para corresponder ao aplicativo que precisa de acesso ao banco de dados e aos drivers. Escolha o programa da Tabela 3. É confuso que o programa de 32 bits esteja na pasta SysWOW64, enquanto o programa de 64 bits esteja na pasta System32.

Tabela 3 – Programas ODBC Data Source Administrator.

Se você tiver um servidor de banco de dados Oracle instalado em sua estação de trabalho, provavelmente já terá um driver ODBC Oracle instalado. Você pode verificar a presença de um driver ODBC Oracle executando o programa ODBC Data Source Administrator.

Procure em Drivers tab para uma entrada semelhante à mostrada na Figura 4, O nome deve comece com a palavra Oráculo . Você não pode use o driver chamado Microsoft ODBC para Oracle , este não trabalhar.

Figura 4 – Driver Oracle no programa ODBC Data Source Administrator.

Os drivers estão listados em ordem alfabética. Se você não vir um driver Oracle presente, será necessário instalar um cliente Oracle. O Oracle tem uma versão diferente do cliente para cada versão do banco de dados. Normalmente, você pode usar um cliente mais recente com um banco de dados mais antigo, mas não necessariamente o contrário.

Suponha que você queira instalar o cliente de 32 bits para Oracle 18c. No momento em que este documento foi escrito, o instalador estava disponível para download na Oracle. Vá para a página de download e procure o texto Oracle Database 18c Client (18.3) for Microsoft Windows x86 (32-bit) , como mostrado na Figura 5.

Faça o download do arquivo vinculado NT_180000_client.zip . Você precisará de uma Conta Oracle online para baixar o instalador do cliente; você pode se registrar gratuitamente se não tiver um login.

Figura 5 – Download do cliente Oracle que inclui drivers ODBC e JDBC.

Descompacte o arquivo zip baixado em uma pasta temporária para instalar o cliente. Vá para a pasta temporária e procure no client32 pasta para setup.exe , você executará este programa para instalar o cliente. Você precisará de privilégios de administrador para instalar o cliente.

Escolha um tipo de instalação conforme mostrado na Figura 6. Apenas para o driver ODBC, driver JDBC e utilitário de linha de comando SQL*Plus, escolha o Instant Client tipo. Se você deseja instalar todas as ferramentas de gerenciamento, escolha o Administrador tipo.

Siga as instruções no assistente do instalador. Você provavelmente pode aceitar os valores padrão para quaisquer opções adicionais. Há um botão de ajuda na parte inferior do assistente do instalador. Para obter mais ajuda sobre este instalador específico, a Oracle tem documentação adicional disponível online.

Figura 6 – Tipo de instalação do Oracle Client.

Depois de instalar os drivers ODBC, você pode configurar um DSN para uma conexão de banco de dados Oracle. Execute o programa ODBC Data Source Administrator especificado na Tabela 3. Selecione a guia para criar um User DSN ou um DSN do sistema . um DSN de usuário só será visível para o usuário que o criou.

Um DSN do sistema é visível para todos os usuários dessa estação de trabalho. É mais comum criar um DSN de usuário, portanto, selecione essa guia. Selecione Adicionar botão para criar um novo DSN de conexão. Selecione o driver Oracle correto, conforme mostrado na Figura 7, e selecione Finish botão.

Figura 7 – Selecionando o driver ODBC Oracle.

Você será presenteado com a Configuração do Driver ODBC Oracle diálogo, como o mostrado na Figura 9. Nomeie sua conexão. Este é o DSN. É melhor evitar espaços em branco e pontuação no DSN, exceto possivelmente sublinhados, hífens e pontos.

Torne o nome descritivo do banco de dados ao qual você está se conectando. O Nome do Serviço TNS pode variar com base no método de conexão Oracle que está sendo usado.

O exemplo na Figura 8 usa EZCONNECT e os detalhes do exemplo que foram reunidos na Tabela 8.

Tabela 8 – Detalhes para um exemplo de conexão de banco de dados.

O formato de uma string de conexão EZCONNECT é:host :porta /Nome do Serviço

Observe que não há um local separado na caixa de diálogo para salvar a senha. Mas o Oracle permite que você salve a senha anexando-a ao nome de usuário, separando-a com uma barra, como mostrado nos detalhes do exemplo na Figura 9.

Embora a senha seja armazenada em texto simples, o DSN é visível apenas para o usuário que está conectado à estação de trabalho no momento e não representa um risco de segurança significativo na maioria dos casos. Se você tiver um departamento de TI com políticas de segurança, talvez não tenha permissão para armazenar sua senha dessa maneira. A senha pode ser digitada sempre que uma conexão for estabelecida.

Também é possível armazenar a senha no IRI Workbench, onde será aplicada aos jobs que acessam os dados por meio deste DSN. No entanto, se permitido, salvar sua senha no DSN conforme mostrado abaixo é o método mais conveniente.

Figura 9 – Caixa de diálogo de configuração do driver com detalhes de exemplo.

Depois de configurar esses detalhes, selecione Test Connection botão. Esperamos que você veja a Conexão bem-sucedida resultado, como mostrado na Figura 10.

Se houver um problema com seus detalhes ou conexão, ou você omitiu o armazenamento da senha, será apresentada a caixa de diálogo Oracle ODBC Driver Connect, conforme mostrado na Figura 11. Isso lhe dará a oportunidade de fornecer detalhes ausentes ou alterar os dados já inseridos.

Se as edições permitirem que a conexão seja bem-sucedida, elas terão que ser aplicadas na caixa de diálogo de configuração mostrada na Figura 9 antes de selecionar OK . Existem quatro guias de opções na parte inferior da caixa de diálogo de configuração. Altere essas opções somente se tiver certeza de que elas são necessárias.

Figura 10 – Um teste de conexão bem-sucedido.

Figura 11 – Uma chance de tentar outros detalhes ou digitar uma senha.

Agora que você espera ter um ODBC DSN funcionando, você pode configurar uma conexão JDBC no IRI Workbench. Você precisa criar uma conexão JDBC no IRI Workbench com os mesmos detalhes exatos que foram usados no ODBC DSN. A conexão ODBC DSN e JDBC será vinculada nas preferências do IRI Workbench posteriormente.

JDBC

A seleção de drivers JDBC é um pouco mais fácil do que ODBC, pois os drivers JDBC não possuem arquitetura de bits. Dependendo de como você instalou o cliente ODBC Oracle, você provavelmente já tem os drivers JDBC instalados. Procure uma pasta chamada jdbc , na pasta de instalação do cliente Oracle. Dentro do jdbc a pasta deve ser uma pasta chamada lib , com os arquivos JDBC java archive (JAR) dentro. O nome do arquivo JAR a ser usado varia de acordo com a versão Oracle e Java, em geral, você usará o arquivo de driver com um nome como odbc8 .jar, onde o número estará relacionado à versão do Java que está sendo usada e pode ser diferente.

Se os arquivos JAR ainda não estiverem instalados, seja pelo servidor de banco de dados ou pela instalação do cliente, você poderá procurar um download apropriado no site da Oracle.

Banco de trabalho IRI

O IRI Workbench é o Ambiente de Desenvolvimento Integrado (IDE) construído no Eclipse™ para criar, manter e executar scripts de trabalho para todos os produtos IRI. Além de trabalhar com trabalhos para produtos IRI como CoSort, RowGen, FieldShield e NextForm, também é a principal interface de usuário para a plataforma Voracity que os inclui.

Uma conexão JDBC no IRI Workbench é usada para muitas finalidades, incluindo:

Examinando valores de dados para design de trabalho, classificação de dados e descoberta de dados.
Tabela de navegação e estrutura de esquema.
Extração, conversão e troca automática e manual de metadados.
Executando comandos e consultas SQL e examinando resultados.
Extração em massa e carregamento de valores de dados de e para arquivos simples.
Geração de diagramas de relacionamento de entidade (ER).

Existem várias maneiras de criar conexões de banco de dados no IRI Workbench. A maneira mais comum é com a exibição Data Source Explorer (DSE). A visualização DSE é um navegador, normalmente encaixado na borda esquerda da janela do IRI Workbench. Se estiver fechado, há duas maneiras fáceis de abri-lo novamente:

No menu principal, selecione Janela> Perspectiva> Redefinir perspectiva .
No menu principal, selecione Janela> Mostrar visualização> Explorador de fonte de dados .

Uma conexão de banco de dados no IRI Workbench é chamada de Perfil de Conexão , às vezes abreviado para apenas Perfil . Para criar um novo perfil na visualização DSE, selecione Novo perfil de conexão botão da mini-barra de ferramentas na exibição, conforme mostrado na Figura 12.

Figura 12 – Botão da barra de ferramentas Novo perfil de conexão no DSE.

Na primeira página do Novo perfil de conexão assistente, escolha Oracle da lista de Tipos de perfil de conexão . Dê um nome ao perfil, semelhante ao DSN. Torne-o descritivo e evite espaços em branco ou pontuação desnecessários. A Figura 13 mostra esta página com o mesmo nome usado para o ODBC DSN.

Figura 13 – Página do assistente do Oracle Connection Profile.

Selecione Próximo> botão para ir para a próxima página do assistente. Você precisará criar uma nova definição de driver usando o botão ícone conforme mostrado na Figura 14.

Figura 14 – Botão de definição de novo driver.

A Nova Definição de Driver assistente tem três guias. Na primeira guia, Nome/Tipo, selecione o Oracle Thin Driver versão do modelo para corresponder à versão do seu banco de dados. A Figura 15 mostra a seleção do template para o banco de dados Oracle 18c.

Figura 15 – guia Nome/tipo da página do assistente de definição de novo driver.

A segunda guia, Lista JAR , é para especificar o arquivo de biblioteca do driver JDBC. Selecione o arquivo JAR existente nos arquivos JAR Lista. Em seguida, selecione o botão Editar JAR/Zip à direita para procurar o local do arquivo JAR.

Encontre a localização da biblioteca do driver Oracle JDBC, discutida na seção JDBC deste documento. A Figura 16 mostra a lista JAR guia após localizar o arquivo do driver JDBC.

Figura 16 – A lista JAR após a localização do arquivo do driver JDBC.

A terceira e última guia é o driver Propriedades guia, mostrada na Figura 17. A única alteração que você pode precisar fazer nessa guia é adicionar uma barra à direita à propriedade URL de conexão, se ela ainda não estiver presente.

Figura 17 – A guia de propriedades do driver com a barra final no URL de conexão.

Selecione o botão OK para concluir a definição do driver. Agora você pode preencher as propriedades de detalhes da conexão com os mesmos valores que foram usados na Tabela 8 na seção de criação de ODBC DSN e selecionar a opção Salvar senha caixa de seleção.

A Figura 18 mostra a página Connection Details, tudo pronto para testar a Test Connection botão. Se você não vir um Sucesso caixa de mensagem, verifique os detalhes na caixa de mensagem de erro para obter informações adicionais. Isso pode indicar um problema com o servidor de banco de dados, a conexão de rede ou os detalhes da conexão.

Figura 18 – A página de detalhes da conexão concluída, pronta para testar a conexão com o banco de dados.

Se o teste for bem-sucedido, você pode selecionar Concluir botão, e ser conectado ao banco de dados. Mesmo que o teste falhe, você ainda pode selecionar a opção Concluir botão, isso preservará o trabalho que você fez até agora, enquanto você pesquisa o erro. Você poderá editar as propriedades do perfil de conexão mais tarde, corrigir quaisquer problemas e tentar novamente.

A Figura 19 mostra a visualização DSE após a conexão bem-sucedida. O Oracle usa um grande número de esquemas internos e, dependendo dos privilégios concedidos ao seu usuário, você poderá ver alguns esquemas além daqueles com os valores de dados de seu interesse.

O perfil de conexão pode ser filtrado no nível do Esquema e até mesmo da tabela. Isso tornará mais fácil localizar e trabalhar com os valores de dados de seu interesse.

Figura 19 – Visualização DSE sem filtragem de esquema.

O tipo mais simples de filtragem de esquema ocultará todos os esquemas, exceto o de propriedade do usuário configurado. Clique com o botão direito do mouse na pasta Schemas para exibir o menu de contexto. Selecione as Propriedades no menu de contexto, conforme mostrado na Figura 20.

Figura 20 – Selecionando as propriedades do esquema no menu de contexto.

Isso exibirá as Propriedades do filtro diálogo, mostrado na Figura 21. Comece desmarcando o Disable filter caixa de seleção perto da parte inferior. Em seguida, preencha o nome do esquema USER no grupo Expressão na parte superior. Selecione o botão Aplicar e Fechar quando terminar.

Isso permitirá uma filtragem simples, mostrando e processando apenas os esquemas que correspondem à expressão. Filtragem muito mais complexa pode ser realizada. Confira o artigo do blog IRI Filtragem de tabela no IRI Workbench para obter mais informações.

Figura 21 – Filtragem de esquema simples.

Atualize a lista de esquemas no mesmo menu de contexto usado anteriormente. O único esquema agora visível é o que pertence ao usuário, conforme mostrado na Figura 22.

Figura 22 – Visualização DSE após filtragem de esquema.

Registro de conexão de dados IRI

Tudo o que resta a ser feito é reconciliar o DSN ODBC e o perfil de conexão JDBC. Ao criar jobs no IRI Workbench utilizando o perfil de conexão JDBC, é necessário saber qual ODBC DSN corresponde ao mesmo banco de dados e usuário.

Abra o Registro de Conexão de Dados nas Preferências selecionando Janela> Preferências do menu principal. Navegue até IRI> Registro de conexão de dados na árvore do lado esquerdo. A página de registro é mostrada na Figura 23.

Figura 23 – A página de preferência do Registro de conexão de dados.

Deve haver uma linha na tabela para cada DSN que foi configurado no Administrador de Fonte de Dados ODBC. Se você não vir o DSN que corresponde ao seu perfil de conexão de dados, tente selecionar a opção Atualizar botão no lado direito da página.

Realce a linha para o DSN que deve ser mapeado para seu perfil de conexão de dados e selecione Editar botão no lado direito da página. Isso exibirá o Registro de conexão de dados diálogo, mostrado na Figura 24.

Figura 24 – A caixa de diálogo Data Connection Registry.

Opcionalmente, você pode aplicar o mesmo filtro de esquema usado no Perfil de Conexão de Dados. Se você não salve o nome de usuário ou a senha no DSN. Você também pode salvá-lo nesta caixa de diálogo. A única necessária informação nesta caixa de diálogo é o Perfil de Conexão no fundo.

Selecione o botão OK quando terminar. Certifique-se de que a caixa de seleção no Ativo coluna é selecionada, conforme mostrado na Figura 25, e então selecione a opção Aplicar e Fechar botão.

Figura 25 – Entrada DSN configurada corretamente no Registro de Conexão de Dados.

Parabéns, agora você está pronto para começar a trabalhar com os dados em seu banco de dados Oracle conectado. Consulte esta página de índice de artigos de blog de instruções sobre como trabalhar com dados Oracle (e outros) do IRI Workbench.