Informatica PowerExchange for Teradata Parallel Transporter API (Versão 9.0.1) Guia do Usuário

Transcrição

1 Informatica PowerExchange for Teradata Parallel Transporter API (Versão 9.0.1) Guia do Usuário

2 Informatica PowerExchange for Teradata Parallel Transporter API Guia do Usuário Versão Setembro 2010 Copyright (c) Informatica. Todos os direitos reservados. Este software e a respectiva documentação contêm informações de propriedade da Informatica Corporation. Eles são fornecidos sob um contrato de licença que contém restrições quanto ao seu uso e divulgação e são protegidas por leis de direitos autorais. A engenharia reversa do software é proibida. Não está permitida de forma alguma a reprodução ou a transmissão de qualquer parte deste documento (seja por meio eletrônico, fotocópia, gravação ou quaisquer outros) sem o consentimento prévio da Informatica Corporation. Este Software pode estar protegido por patentes dos EUA e/ou internacionais e outras patentes pendentes. O uso, duplicação ou divulgação do Software pelo Governo dos Estados Unidos estão sujeitos às restrições estipuladas no contrato de licença de software aplicável e como estabelecido em DFARS (a) e (a) (1995), DFARS (1)(ii) (OCT 1988), FAR (a) (1995), FAR ou FAR (ALT III), conforme aplicável. As informações contidas neste produto ou documentação estão sujeitas a alteração sem aviso prévio. Caso você encontre algum problema neste produto ou documentação, informe-nos por escrito. Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange e Informatica On Demand são marcas comerciais ou registradas da Informatica Corporation nos Estados Unidos e jurisdições de todo o mundo. Todos os outros nomes de outras companhias e produtos podem ser nomes ou marcas comerciais de seus respectivos proprietários. Partes desta documentação e/ou software estão sujeitas a direitos autorais de terceiros, incluindo sem limitação: Copyright DataDirect Technologies. Todos os direitos reservados. Copyright Sun Microsystems. Todos os direitos reservados. Copyright RSA Security Inc. Todos os direitos reservados. Copyright Ordinal Technology Corp. Todos os direitos reservados. Copyright Aandacht c.v. Todos os direitos reservados. Copyright Genivia, Inc. Todos os direitos reservados. Copyright 2007 Isomorphic Software. Todos os direitos reservados. Copyright Meta Integration Technology, Inc. Todos os direitos reservados. Todos os direitos reservados. Copyright Oracle. Todos os direitos reservados. Copyright Adobe Systems Incorporated. Todos os direitos reservados. Copyright DataArt, Inc. Todos os direitos reservados. Copyright ComponentSource. Todos os direitos reservados. Copyright Microsoft Corporation. Todos os direitos reservados. Copyright Rouge Wave Software, Inc. Todos os direitos reservados. Copyright Teradata Corporation. Todos os direitos reservados. Copyright Yahoo! Inc. Todos os direitos reservados. Copyright Glyph & Cog, LLC. Todos os direitos reservados. Este produto inclui software desenvolvido pela Apache Software Foundation ( e outros softwares licenciados pela Apache License, Versão 2.0 (a "Licença"). Você pode obter uma cópia da Licença em A menos que exigido pela legislação aplicável ou concordado por escrito, o software distribuído sob a Licença é fornecido em uma base "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA OU CONDIÇÃO DE QUALQUER TIPO, seja expressa ou implícita. Consulte a Licença para conhecer as limitações e as permissões que regulam o idioma específico de acordo com a Licença. Este produto inclui software desenvolvido pela Mozilla ( direitos autorais de software de The JBoss Group, LLC; todos os direitos reservados; direitos autorais de software de Bruno Lowagie e Paulo Soares e outros produtos de software licenciados sob a Licença Pública GNU LGPL (Lesser General Public License), que pode ser encontrada em Os materiais são fornecidos gratuitamente pela Informatica, "no estado em que se encontram", sem garantia de qualquer tipo, explícita nem implícita, incluindo, mas não de forma restritiva, as garantias implicadas de comerciabilidade e adequação a um determinado propósito. O produto inclui software ACE(TM) e TAO(TM) com copyright de Douglas C. Schmidt e seu grupo de pesquisa na Washington University, University of California, Irvine e Vanderbilt University, Copyright ( ) , todos os direitos reservados. Este produto inclui o software desenvolvido pelo OpenSSL Project para ser usado no kit de ferramentas OpenSSL (copyright The OpenSSL Project. Todos os direitos reservados) e a redistribuição deste software está sujeita aos termos disponíveis no site Este produto inclui o software Curl com o Copyright , Daniel Stenberg, <daniel@haxx.se>. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em A permissão para usar, copiar, modificar e distribuir este software com qualquer objetivo, com ou sem taxa, é concedida por este documento, desde que a nota de copyright acima e esta nota de permissão apareçam em todas as cópias. O produto inclui o copyright de software ( ) MetaStuff, Ltd. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em O produto inclui o copyright de software , The Dojo Foundation. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui o software ICU com o copyright International Business Machines Corporation e outros. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui o copyright de software Per Bothner. Todos os direitos reservados. O seu direito de usar tais materiais é estabelecido na licença que pode ser encontrada em kawa/software-license.html. Este produto inclui o software OSSP UUID com Copyright 2002 Ralf S. Engelschall, Copyright 2002 e OSSP Project Copyright 2002 Cable & Wireless Deutschland. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui software desenvolvido pela Boost ( ou sob a licença de software Boost. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em / Este produto inclui o copyright de software University of Cambridge. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui o copyright de software 2007 The Eclipse Foundation. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui software licenciado de acordo com os termos disponíveis nos endereços overlib/?license, hsqllicense.html, e fusesource.com/downloads/license-agreements/fuse-message-broker-v-5-3-license-agreement. Este produto inclui o software licenciado conforme a Academic Free License ( a Common Development and Distribution License ( a Common Public License ( e a BSD License ( Este produto inclui copyright do software Joe WaInes, XStream Committers. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui software desenvolvido pelo Indiana University Extreme! Lab. Para obter mais informações, visite Este software é protegido pelos números de patentes dos EUA 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775; 6,640,226; 6,789,096; 6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,254,590; 7,281,001; 7,421,458 e 7,584,422, patentes internacionais e outras patentes pendentes. ISENÇÃO DE RESPONSABILIDADE: a Informatica Corporation fornece esta documentação "no estado em que se encontra" sem garantia de qualquer tipo, expressa ou implícita, incluindo, mas não de forma restritiva, as garantias implícitas de não infração, comercialização ou uso para um determinado propósito. A Informatica Corporation não garante que este software ou documentação esteja sem erros. As informações fornecidas neste software ou documentação podem incluir imprecisões técnicas ou erros tipográficos. As informações deste software e documentação estão sujeitas a alterações a qualquer momento sem aviso prévio.

3 AVISOS Este produto da Informatica (o "Software") traz determinados drivers (os "drivers da DataDirect"), da DataDirect Technologies, uma empresa em funcionamento da Progress Software Corporation ("DataDirect") e que estão sujeitos aos seguintes termos e condições: 1. OS DRIVERS DA DATADIRECT SÃO FORNECIDOS "NO ESTADO EM QUE SE ENCONTRAM" SEM GARANTIA DE QUALQUER TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO DE FORMA RESTRITIVA, AS GARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA E SEM VIOLAÇÃO. 2. EM NENHUM CASO, A DATADIRECT OU SEUS FORNECEDORES TERCEIRIZADOS SERÃO RESPONSÁVEIS, EM RELAÇÃO AO CLIENTE FINAL, POR QUAISQUER DANOS DIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS, CONSEQUENCIAIS OU DEMAIS QUE POSSAM ADVIR DO USO DE DRIVERS ODBC, SENDO OU NÃO ANTERIORMENTE INFORMADOS DAS POSSIBILIDADES DE DANOS. ESTAS LIMITAÇÕES SE APLICAM A TODAS AS CAUSAS DE AÇÃO, O QUE INCLUI, SEM LIMITAÇÕES, QUEBRA DE CONTRATO, QUEBRA DE GARANTIA, NEGLIGÊNCIA, RESPONSABILIDADE RIGOROSA, DETURPAÇÃO E OUTROS ATOS ILÍCITOS. Parte Número: PWX-TPU

4 Conteúdo Prefácio.... iii Recursos da Informatica.... iii Portal de Clientes da Informatica.... iii Documentação da Informatica.... iii Site da Informatica.... iii Biblioteca de Recursos da Informatica.... iii Base de Dados de Conhecimento da Informatica.... iv Base de Dados de Conhecimento Multimídia da Informatica.... iv Suporte Global a Clientes da Informatica.... iv Capítulo 1: Noções Básicas do PowerExchange for Teradata Parallel Transporter API Noções Básicas do PowerExchange for Teradata Parallel Transporter API - visão geral Capítulo 2: Instalação e configuração Visão geral de instalação e configuração Pré-requisitos Instalando e configurando o PowerExchange for Teradata Parallel Transporter API Configurando as variáveis de ambiente Instalando o PowerExchange for Teradata Parallel Transporter API Instalando o componente Cliente Instalando o componente Serviço Registrando o plug-in Informações da versão Novos Recursos e Aprimoramentos na Versão Trabalhando com objetos de conexão obsoletos Capítulo 3: Sessões e fluxos de trabalho Teradata PT API Configurando uma conexão Teradata Parallel Transporter API Criando um objeto de conexão Teradata PT API Trabalhando com sessões Teradata PT API Configurando a recuperação Trabalhando com tabelas de log, erro e trabalho Particionamento de pipeline Suporte para Diversas Instâncias Carregamento Preparado Configurando uma sessão para uma origem Teradata PT API Configurando uma sessão para um destino Teradata PT API Apêndice A: Mensagens de erro Mensagens de TPTRD Mensagens de TPTWR Sumário i

5 Índice ii Sumário

6 Prefácio O PowerExchange for Teradata Parallel Transporter API - Guia do Usuário fornece informações sobre como extrair e carregar dados no Teradata usando o Teradata Parallel Transporter API (Teradata PT API). Ele foi elaborado para administradores e desenvolvedores de bancos de dados, que são responsáveis por extrair dados e carregá-los no Teradata. Este guia presume que você conhece o Teradata PT, os bancos de dados do Teradata PT e o PowerCenter. Recursos da Informatica Portal de Clientes da Informatica Na qualidade de cliente da Informatica, você pode acessar o site Portal de Clientes da Informatica no endereço O site contém informações de produtos e de grupo de usuários, boletins informativos, acesso ao sistema de gerenciamento de casos de suporte a clientes da Informatica (ATLAS), à Biblioteca de Recursos da Informatica, à Base de Dados de Conhecimento da Informatica, à Base de Dados de Conhecimento Multimídia da Informatica, à Documentação de Produtos da Informatica e acesso à comunidade de usuários da Informatica. Documentação da Informatica A equipe de Documentação da Informatica se esforça ao máximo para criar documentações precisas e utilizáveis. Se você tiver dúvidas, comentários ou ideias sobre esta documentação, entre em contato com a equipe de Documentação da Informatica pelo infa_documentation@informatica.com. Nós usaremos seu feedback para melhorar a documentação. Por favor, avise-nos se pudermos entrar em contato com você em relação aos comentários. A equipe de Documentação atualiza a documentação conforme o necessário. Para obter a documentação mais recente do seu produto, navegue para Documentação do Produto no endereço Site da Informatica Você pode acessar o site corporativo da Informatica no endereçohttp:// O site contém informações sobre a Informatica, seu histórico, eventos futuros e escritórios de vendas. Você também vai encontrar informações sobre parceiros e produtos. A área de serviços do site inclui informações importantes sobre suporte técnico, treinamento e educação, bem como serviços de implementação. Biblioteca de Recursos da Informatica Na qualidade de cliente da Informatica, você pode acessar a Biblioteca de Recursos da Informatica no endereço A Biblioteca de Recursos é uma coletânea de recursos que o ajuda a aprender mais sobre os produtos e recursos da Informatica. Ela inclui artigos e demonstrações interativas que apresentam soluções a problemas comuns, comparam recursos e comportamentos e o orienta na execução de tarefas específicas no mundo real. iii

7 Base de Dados de Conhecimento da Informatica Na qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento da Informatica no endereço Use a Base de Dados de Conhecimento para pesquisar soluções documentadas a problemas técnicos conhecidos sobre produtos da Informatica. Você também pode encontrar respostas a perguntas frequentes, white papers e dicas técnicas. Se você tiver dúvidas, comentários ou ideias sobre a Base de Dados de Conhecimento, entre em contato com a equipe da Base de Dados de Conhecimento da Informatica pelo KB_Feedback@informatica.com. Base de Dados de Conhecimento Multimídia da Informatica Na qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento Multimídia da Informatica no endereço A Base de Dados de Conhecimento Multimídia é uma coleção de arquivos multimídia de instrução que o ajuda a aprender os conceitos comuns e o orienta na execução de tarefas específicas. Se você tiver dúvidas, comentários ou ideias sobre a Base de Dados de Conhecimento Multimídia, entre em contato com a equipe da Base de Dados de Conhecimento da Informatica pelo KB_Feedback@informatica.com. Suporte Global a Clientes da Informatica Você pode entrar em contato com o Centro de Suporte a Clientes por telefone ou pelo Suporte Online. O Suporte Online requer um nome de usuário e uma senha. Você pode solicitar um nome de usuário e uma senha no endereço Use os números de telefone a seguir para entrar em contato com o Suporte Global a Clientes da Informatica: América do Norte / América do Sul Europa / Oriente Médio / África Ásia / Austrália Ligação Gratuita Brasil: México: América do Norte: Tarifa Padrão América do Norte: Ligação Gratuita França: Alemanha: Israel: Itália: Holanda: Portugal: Espanha: Suíça: ou Reino Unido: ou Ligação Gratuita Austrália: Nova Zelândia: Cingapura: Tarifa Padrão Índia: Tarifa Padrão Bélgica: França: Alemanha: Holanda: iv Prefácio

8 C A P Í T U L O 1 Noções Básicas do PowerExchange for Teradata Parallel Transporter API Este capítulo inclui os seguintes tópico: Noções Básicas do PowerExchange for Teradata Parallel Transporter API - visão geral, 1 Noções Básicas do PowerExchange for Teradata Parallel Transporter API - visão geral O PowerExchange for Teradata Parallel Transporter integra o PowerCenter e o Teradata Parallel Transporter API (Teradata PT API) para a extração e o carregamento dos dados. O Teradata PT é um utilitário de carga e descarga que extrai, transforma e carrega dados de múltiplas origens em paralelo. Você pode criar uma sessão do PowerCenter que utilize o Teradata PT API para extrair de origens Teradata e carregar nos destinos Teradata. Para usar o PowerExchange for Teradata Parallel Transporter API, crie um mapeamento com uma origem ou destino Teradata. Use uma conexão Teradata PT com as tabelas Teradata que deseja exportar ou carregar em uma sessão. O Serviço de Integração utiliza a infraestrutura do Teradata PT API para a conexão ao Teradata. Ele extrai ou carrega os dados usando um dos seguintes operadores de sistema: Exportar. Extrai dados do Teradata. Carregar. Carrega volumes de dados em uma tabela vazia de banco de dados Teradata. Atualizar. Executa operações de atualização, inserção, upsert e exclusão contra as tabelas de banco de dados Teradata. Stream. Executa operações de atualização, inserção, upsert e exclusão contra as tabelas de banco de dados Teradata no modo de tempo quase real. Você não pode acessar os seguintes objetos Teradata: Macro Gatilho Índice associado Procedimentos armazenados Índice de Hash Diário permanente 1

9 C A P Í T U L O 2 Instalação e configuração Este capítulo inclui os seguintes tópicos: Visão geral de instalação e configuração, 2 Configurando as variáveis de ambiente, 3 Instalando o PowerExchange for Teradata Parallel Transporter API, 4 Registrando o plug-in, 6 Informações da versão, 7 Visão geral de instalação e configuração Este capítulo fornece informações sobre instalação e configuração do PowerExchange for Teradata Parallel Transporter API. Pré-requisitos Antes de instalar o PowerExchange for Teradata Parallel Transporter API, conclua as seguintes tarefas: Instale ou atualize o PowerCenter. Instale o Teradata. Instale o Teradata Parallel Transporter. Instale os seguintes utilitários nas máquinas onde o Serviço de Repositório e o Serviço de Integração do PowerCenter são executados: Utilitários do Teradata Parallel Transporter - Teradata Parallel Transporter API - Infraestrutura do Teradata Parallel Transporter - Operador Carregar do Teradata Parallel Transporter - Operador Atualizar do Teradata Parallel Transporter - Operador Stream do Teradata Parallel Transporter - Operador Exportar do Teradata Parallel Transporter - Biblioteca de suporte ao operador do Teradata Parallel Transporter - Teradata CLIv2 - Teradata ODBC - Serviços de segurança genérica do Teradata - Operador Conector de dados do Teradata Parallel Transporter - Bibliotecas de ICU compartilhadas para Teradata Nota: Se você instalar o PowerExchange for Teradata Parallel Transporter API usando a versão 12 do Teradata Parallel Transporter e depois fazer upgrade para a versão 13 do Teradata Parallel Transporter, reinstale o PowerExchange for Teradata Parallel Transporter API. 2

10 Verifique se você tem permissões de leitura e gravação nos seguintes diretórios: <PowerCenter Installation Directory>\server\bin <PowerCenter Installation Directory>\server\bin\native <PowerCenter Installation Directory>\server\bin\RecoverySQL <PowerCenter Installation Directory>\client\bin O instalador deve poder adicionar e substituir arquivos nesses diretórios. No Windows EMT de 64 bits, você deve instalar o Microsoft Visual C Redistributable Package (x64) se a máquina não estiver com o Visual C instalado. Você pode baixar o Microsoft Visual C Redistributable Package (x64) no centro de download da Microsoft. Instalando e configurando o PowerExchange for Teradata Parallel Transporter API Para instalar e configurar o PowerExchange for Teradata Parallel Transporter API, execute as seguintes etapas: 1. Defina as variáveis de ambiente do sistema. 2. Instale os componentes. 3. Registre o plug-in. Após instalar e configurar o PowerExchange for Teradata Parallel Transporter API, você pode criar conexões para acessar o Teradata PT API. Crie objetos de conexão no Workflow Manager para que o Serviço de Integração possa se conectar ao Teradata PT API. Configurando as variáveis de ambiente Antes de instalar o componente Serviço do PowerExchange for Teradata Parallel Transporter API, configure as seguintes variáveis de ambiente: Variável de ambiente JAVA_HOME JRE_HOME PATH Valor <diretório de instalação do PowerCenter>/java ${JAVA_HOME}/jre ${JAVA_HOME}/bin:${JRE_HOME}/bin:${PATH} No UNIX, defina também as seguintes variáveis de ambiente: Variável de ambiente COPERR TD_ICU_DATA Valor Configure o local do arquivo errmsg.cat, por exemplo, /usr/lib. Configure o local das bibliotecas de ICU do Teradata, por exemplo, /opt/tdicu/lib. Além disso, configure a variável de ambiente da biblioteca compartilhada com base no sistema operacional. A tabela a seguir descreve as variáveis de biblioteca compartilhada para cada sistema operacional: Sistema operacional Windows Solaris Valor PATH LD_LIBRARY_PATH Configurando as variáveis de ambiente 3

11 Sistema operacional Linux AIX HP-UX Valor LD_LIBRARY_PATH LIBPATH SHLIB_PATH Por exemplo, use a seguinte sintaxe para o Solaris: Usando um shell Bourne: $ LD_LIBRARY_PATH=${JAVA_HOME}/lib: ${JRE_HOME}/lib; export LD_LIBRARY_PATH Usando um shell C: $ setenv LD_LIBRARY_PATH ${JAVA_HOME}/lib: ${JRE_HOME}/lib Para HP-UX: Usando um shell Bourne: $ SHLIB_PATH=${SHLIB_PATH}:${JAVA_HOME}/lib: ${JRE_HOME}/lib; export SHLIB_PATH Usando um shell C: $ setenv SHLIB_PATH ${SHLIB_PATH}:${JAVA_HOME}/lib: ${JRE_HOME}/lib Para AIX: Usando um shell Bourne: $ LIBPATH=${LIBPATH}:${JAVA_HOME}/lib: ${JRE_HOME}/lib; export LIBPATH Usando um shell C: $ setenv LIBPATH ${LIBPATH}:${JAVA_HOME}/lib: ${JRE_HOME}/lib Instalando o PowerExchange for Teradata Parallel Transporter API Quando você instala o PowerExchange for Teradata Parallel Transporter API, são instalados componentes que permitem que o PowerCenter acesse o Teradata PT API. Instale os seguintes componentes: Componente Cliente. Permite acessar a ajuda online do PowerExchange for Teradata Parallel Transporter. Componente Serviço. Permite que o Serviço de Repositório acesse os metadados do Teradata PT API no repositório. Também permite que o Serviço de Integração execute sessões Teradata PT API. Instalando o componente Cliente O componente Cliente contém os arquivos da ajuda online do PowerExchange for Teradata Parallel Transporter API. Instale o componente Cliente em cada máquina com o Cliente do PowerCenter onde você deseja criar ou acessar os metadados do Teradata PT API. Quando você descompacta o arquivo de instalação, os seguintes arquivos da ajuda online são extraídos: powercenterhelp.chm. O arquivo de ajuda mestre do PowerCenter que contêm links para a ajuda do PowerExchange for Teradata Parallel Transporter API. teradata.chm. O arquivo de ajuda online do PowerExchange for Teradata Parallel Transporter API. Esses arquivos são extraídos para o seguinte local: <Download Location>\help\en 4 Capítulo 2: Instalação e configuração

12 Para instalar o componente cliente: 1. Na máquina cliente do PowerCenter, faça um backup do arquivo powercenterhelp.chm no diretório de ajuda, no seguinte local: <PowerCenter Installation Directory>\client\bin\help\en Para fazer o backup do arquivo, renomeie para Original_powercenterhelp.chm. 2. Copie powercenterhelp.chm e teradata.chm para o diretório de ajuda na máquina cliente do PowerCenter. Instalando o componente Serviço Instale o componente Serviço em qualquer nó configurado para executar o Serviço de Integração ou o Serviço de Repositório. Se os serviços estiverem configurados para executar nos nós primários e de backup, instale o componente Serviço em cada nó configurado para executar o processo do serviço. Se o Serviço de Integração estiver configurado para ser executado em uma grade, instale o componente Serviço em cada nó configurado na grade. Se você não puder instalar o componente Serviço em cada nó na grade, crie um recurso no domínio e o atribua a cada nó onde você instalou o componente Serviço. Ao criar uma sessão, configure-a para usar o recurso. Por exemplo, crie um recurso personalizado com o nome "Teradata PT" e torne-o disponível para um ou mais nós. Ao configurar a sessão, atribua o recurso como um recurso necessário. O balanceador de carga despacha a tarefa de Sessão para um nó que tenha o recurso. Instalando o componente Serviço no Windows Instale o componente Serviço no Windows, quando o Serviço de Integração e o Serviço de Repositório do PowerCenter forem executados no Windows. Para instalar o componente Serviço no Windows: 1. Feche todos os outros aplicativos antes de executar a instalação. 2. Interrompa os Serviços Informatica se estiverem executando na máquina. 3. Execute o instalador a partir do seguinte local: <Download Location>\<Operating System Directory>\install.exe 4. Selecione o idioma para usar durante a instalação e clique em OK. A janela Bem-vindo introduz a instalação do PowerExchange for Teradata Parallel Transporter API. 5. Clique em Avançar. O programa de instalação exibe um aviso para interromper os Serviços Informatica. 6. Clique em OK. A janela Diretório de Instalação aparece. 7. Digite o caminho absoluto para o diretório de instalação do PowerCenter. Clique em Procurar para encontrar o diretório, ou use o diretório padrão. O diretório padrão é C: \Informatica\ Clique em Avançar. A janela Versão do Teradata PT solicita que você escolha a versão do Teradata PT API. 9. Escolha a versão correta do Teradata PT API e clique em Avançar. A janela Resumo de Pré-instalação resume as informações de instalação. 10. Revise as informações de instalação e clique em Instalar para continuar. O instalador mostra o progresso da instalação. Quando a instalação é concluída, a janela Resumo da Instalação exibe o status da instalação. 11. Clique em Feito. Instalando o PowerExchange for Teradata Parallel Transporter API 5

13 Você pode ver os arquivos de log gerados pelo instalador, para obter mais informações sobre as tarefas de instalação executadas. 12. Reinicie os Serviços Informatica na máquina. Instalando o componente Serviço no UNIX Instale o componente Serviço no Windows, quando o Serviço de Integração e o Serviço de Repositório do PowerCenter forem executados no UNIX. Para instalar o componente Serviço no UNIX: 1. Feche todos os outros aplicativos. 2. Em uma linha de comando shell, execute install.bin localizado no diretório raiz no local onde você baixou os arquivos de instalação do componente Serviço do PowerExchange for Teradata Parallel Transporter API. 3. Selecione o idioma para usar durante a instalação e pressione Enter. O painel Bem-vindo introduz a instalação do componente Serviço do PowerExchange for Teradata Parallel Transporter API. 4. Pressione Enter. 5. Pressione Entre para usar o diretório padrão, ou digite o caminho absoluto do diretório de instalação do PowerCenter. O nome do diretório de instalação não pode conter espaços. Por padrão, o PowerCenter é instalado no seguinte diretório: $HOME/Informatica/9.0.1 HOME é o diretório inicial do usuário. 6. Escolha a versão correta do Teradata PT API no painel Versão do Teradata PT Version e pressione Enter. 7. Revise as informações no painel Resumo de Pré-instalação e pressione Enter para continuar. Ou, digite back para voltar e modificar as opções. 8. Depois que você pressiona Enter, o instalador copia os arquivos do componente Serviço para o diretório de instalação. <PowerCenter Installation Directory>/server/bin/ Registrando o plug-in Depois de instalar o PowerExchange for Teradata Parallel Transporter API, registre o plug-in com o repositório. Um plug-in é um arquivo XML que define a funcionalidade do PowerExchange for Teradata Parallel Transporter API. Se você estiver atualizando de uma versão anterior, atualize o registro do plug-in ao registrar novamente o plug-in. Para registrar o plug-in, o repositório deve ser executado em modo exclusivo. Use o Informatica Administrator ou o comando pmrep RegisterPlugin para registrar o plug-in. O arquivo de plug-in do PowerExchange for Teradata Parallel Transporter API é TeradataPT.xml. Quando você instala o componente Serviço, o instalador copia o TeradataPT.xml para o seguinte diretório: <PowerCenter Installation Directory>\server\bin\native Depois de registrar o plug-in, dois novos tipos de objeto de conexão estão disponíveis: Conexão do Teradata PT e Conexão de Carga Dupla do Teradata. O PowerExchange for Teradata PT API usa a Conexão do Teradata PT. A Conexão de Carga Dupla do Teradata será aplicável se você instalar a Opção Carga Dupla do PowerCenter para Teradata. 6 Capítulo 2: Instalação e configuração

14 Nota: Se você não tiver os privilégios corretos para registrar o plug-in, entre em contato com o usuário que gerencia o Serviço de Repositório do PowerCenter. Informações da versão O PowerExchange for Teradata Parallel Transporter API inclui novos recursos e alterações no comportamento. Novos Recursos e Aprimoramentos na Versão Suporte para expressão de banda de consulta. Você pode informar a expressão de banda de consulta que deseja transmitir ao Teradata Parallel Transporter API como propriedade de sessão. Expressão de banda de consulta é um conjunto de pares de nome/valor que identifica a origem de uma consulta Nova versão do Teradata Parallel Transporter. O PowerExchange for Teradata Parallel Transporter API suporta o Teradata Parallel Transporter versão 13. Suporte para diversas instâncias. Você pode carregar dados em paralelo por meio de várias instâncias, de uma origem para um destino do Teradata PT API. Informe o número de instâncias nas propriedades de sessão. Carregamento Preparado. Você pode pausar o carregamento ativo para um destino do Teradata PT API em uma sessão. Você pode adquirir dados de diversas origens com execuções subsequentes da sessão. Execute a sessão sem o carregamento preparado a fim de carregar dados de todas as origens de uma vez no Teradata PT API. Suporte ao Windows 2008 R2. Você pode extrair os dados de uma origem do Teradata ou carregá-los em um destino do Teradata quando o Serviço de Integração do PowerCenter é executado no Windows 2008 R2. Trabalhando com objetos de conexão obsoletos Atualizar impacto: Alteração de comportamento, Atualizar tarefa Versão implementada: 8.6 Versões afetadas: A partir da versão 8.6, PowerExchange for Teradata Parallel Transporter API usa o tipo de objeto de conexão Conexão Teradata PT". Em uma versão prévia, o PowerExchange for Teradata Parallel Transporter API usava os objetos de conexão Teradata PT API do tipo "Conexão Teradata Parallel Transporter". Esses objetos de conexão que foram substituídos pelos objetos do tipo "Conexão Obsoleta Teradata PT". Os seguintes atributos de conexão são movidos da definição do objeto de conexão para as propriedades da sessão: Banco de dados de log Nome da tabela de log Banco de dados de erros Nome da tabela de erro 1 Nome da tabela de erro 2 Descartar tabela de erro Quando você atualizar, as propriedades de sessão contêm os valores padrão para estas propriedades. O objeto de conexão obsoleto retém os valores que você especificou. Se você executar uma sessão que usa um objeto de conexão obsoleto, o Serviço de Integração usa os valores nas propriedades da sessão. Se você não inserir valores nas propriedades da sessão, ele usa os atributos de conexão no objeto de conexão obsoleto. Informações da versão 7

15 A Informatica recomenda que você substitua objetos de conexão obsoletos por novos objetos de conexão. Os objetos de conexão obsoletos podem não ser suportados em futuras versões do PowerExchange for Teradata Parallel Transporter API. 8 Capítulo 2: Instalação e configuração

16 C A P Í T U L O 3 Sessões e fluxos de trabalho Teradata PT API Este capítulo inclui os seguintes tópicos: Configurando uma conexão Teradata Parallel Transporter API, 9 Trabalhando com sessões Teradata PT API, 11 Configurando uma sessão para uma origem Teradata PT API, 15 Configurando uma sessão para um destino Teradata PT API, 16 Configurando uma conexão Teradata Parallel Transporter API Crie objetos de conexão Teradata PT API para definir conexões para o Teradata PT API no repositório. O Serviço de Integração utiliza objetos de conexão Teradata PT API para extrair ou carregar do Teradata. Além disso, você pode criar uma conexão de ODBC do destino Teradata. O Serviço de Integração usa a conexão de ODBC de destino para descartar tabelas de log, erro e trabalho, truncar tabelas de destino e criar tabelas de recuperação no banco de dados de destino. O Serviço de Integração não usa a conexão de ODBC para extrair ou carregar do Teradata. Se você ativar a recuperação em uma sessão que carrega no Teradata, crie uma conexão de ODBC do destino Teradata ou crie a tabela de recuperação manualmente. Criando um objeto de conexão Teradata PT API Você configura as propriedades do Teradata Parallel Transporter API quando cria uma conexão Teradata PT API. Você pode anular o operador de sistema nas propriedades de sessão. Para obter mais informações sobre as configurações do Teradata PT API, consulte a documentação do Teradata Parallel Transporter. Para criar uma conexão Teradata Parallel Transporter: 1. Clique em Conexões > Relacional no Workflow Manager. A caixa de diálogo Navegador de Conexão Relacional é exibida. 2. Clique em Novo. A caixa de diálogo Selecionar Subtipo é exibida. 3. Selecione uma conexão Teradata PT e clique em OK. A caixa de diálogo Editor de Conexão Relacional é exibida. 9

17 4. Insira as propriedades da conexão: Propriedade Nome Nome do usuário Usar Parâmetro na Senha Senha Página de código Descrição Nome da conexão usada pelo Workflow Manager. O nome da conexão não pode conter espaços ou outros caracteres especiais, exceto sublinhado. Nome do usuário do banco de dados com as permissões adequadas de banco de dados de leitura e gravação para acessar o banco de dados. Para definir o nome de usuário no arquivo de parâmetros, insira o parâmetro de sessão $ParamNome como nome de usuário e defina o valor no arquivo de parâmetros da sessão ou do fluxo de trabalho. O Serviço de Integração interpreta os nomes de usuário que começam com $Param como parâmetros da sessão. Indica que a senha para o nome de usuário do banco de dados é um parâmetro de sessão, $ParamNome. Se você ativar esta opção, defina a senha no arquivo de parâmetro do fluxo de trabalho ou da sessão e criptografe-a usando a opção pmpasswd CRYPT_DATA. O padrão é desabilitado. Senha para o nome de usuário do banco de dados. Página de código associada ao banco de dados. Quando você executa uma sessão que extrai de uma origem Teradata, a página de código da conexão Teradata PT API deve ser igual à página de código da origem Teradata. 5. Insira os atributos da conexão: Atributo TDPID Nome do banco de dados Tenacidade Sessões máximas Sessões mínimas Suspender Criptografia de dados Descrição O nome da máquina do banco de dados Teradata. Nome do banco de dados Teradata. Se você não inserir um nome de banco de dados, o Teradata PT API usará o nome do banco de dados de logon padrão. Quantidade de tempo, em horas, que o Teradata PT API continua tentando efetuar logon quando o número máximo de operações executa no banco de dados Teradata. Deve ser um inteiro positivo que não seja zero. O padrão é 4. Número máximo de sessões que o Teradata PT API estabelece com o banco de dados Teradata. Deve ser um inteiro positivo que não seja zero. O padrão é 4. Número mínimo de sessões Teradata PT API exigidas para que o trabalho do Teradata PT API continue. Deve ser um inteiro positivo entre 1 e o valor Sessões máximas. O padrão é 1. Quantidade de tempo, em minutos, que o Teradata PT API fica em pausa antes de tentar efetuar logon quando o número máximo de operações executa no banco de dados Teradata. Deve ser um inteiro positivo que não seja zero. O padrão é 6. Ativa a criptografia de segurança total das solicitações, respostas e dados SQL. O padrão é desabilitado. 10 Capítulo 3: Sessões e fluxos de trabalho Teradata PT API

18 Atributo Tamanho do bloco Operador de sistema Descrição Tamanho máximo do bloco, em bytes, que o Teradata PT API usa ao retornar os dados ao Serviço de Integração. O mínimo é 256. O máximo é O padrão é 64,000. Tipo de operador do Teradata PT API: - Exportar Extrai dados do Teradata. Selecione Exportar se a sessão usa um Leitor do Teradata Parallel Transporter. - Carregar. Carrega volumes de dados em uma tabela vazia de banco de dados Teradata. - Atualizar. Executa operações de atualização, inserção, upsert e exclusão contra as tabelas de banco de dados Teradata. - Stream. Executa operações de atualização, inserção, upsert e exclusão contra as tabelas de banco de dados Teradata no modo de tempo quase real. Selecione Stream se deseja ativar a recuperação de sessões que carregam dados no Teradata. O padrão é Stream. 6. Clique em OK. Trabalhando com sessões Teradata PT API Ao configurar uma sessão Teradata PT API, são definidas as propriedades que determinam como o Serviço de Integração extrai ou carrega os dados em origens e destinos Teradata. É possível configurar as seguintes propriedades de sessão Teradata PT API: Recuperação Tabelas de erros e log Particionamento de pipeline Configurando a recuperação Você pode recuperar as sessões Teradata PT API que cumprem os seguintes requisitos: A sessão deve estar ativada para a recuperação. A sessão deve conter uma origem PowerExchange for CDC. A sessão deve ser configurada para usar o operador de sistema Stream a fim de carregar os dados no Teradata. Configure a propriedade personalizada TPTRecoveryModel como "sim" para a sessão ou o Serviço de Integração. Se o Serviço de Integração executa no UNIX, configure a variável de ambiente THREADONOFF como 1. Uma tabela de recuperação deve existir no banco de dados de destino antes que o Serviço de Integração possa recuperar uma sessão ou fluxo de trabalho. Você pode criar a tabela de recuperação manualmente ou configurar uma conexão de ODBC de destino além do objeto de conexão de destino Teradata PT API. Configure uma conexão de ODBC de destino quando deseja descartar as tabelas de log, erro e trabalho, ou truncar tabelas de destino. Do contrário, você pode criar a tabela de recuperação manualmente. Criando a tabela de recuperação usando uma conexão de ODBC de destino Quando você configura uma conexão de destino Teradata PT API e uma conexão de ODBC de destino em uma sessão, o Serviço de Integração cria a tabela de recuperação no banco de dados de destino. Trabalhando com sessões Teradata PT API 11

19 Você também pode configurar as seguintes propriedades de sessão: Descartar tabelas de log, erro e trabalho. As tabelas de log podem conter dados inconsistentes quando uma sessão falha. Se você configurar a sessão para usar uma conexão de destino Teradata PT API e uma conexão de ODBC de destino, o Serviço de Integração pode descartar as tabelas existentes de log, erro e trabalho para uma sessão quando esta inicia. Truncar as tabelas de destino. O Teradata PT API pode truncar as tabelas de destino quando o operador de sistema é configurado como Atualizar ou Stream nas propriedades do objeto de conexão. Se você configurar a sessão para usar uma conexão de destino Teradata PT API e uma conexão de ODBC de destino, o Teradata PT API pode truncar as tabelas de destino quando o operador de sistema é Atualização, Stream ou Carga. Criando a tabela de recuperação manualmente Se você ativar a recuperação para uma sessão que carrega no Teradata, e não precisar descartar as tabelas de log, erro e trabalho ou truncar as tabelas de destino, pode criar a tabela de recuperação manualmente. Crie a tabela de recuperação no banco de dados de destino Teradata. Para criar a tabela de recuperação, execute o script create_schema_tpt.sql contra o banco de dados de destino Teradata. O script está instalado no seguinte diretório: <PowerCenter Installation Directory>\server\bin\RecoverySQL O script contém a seguinte consulta: CREATE TABLE INFARecoveryTable ( TPTCPData integer, Counter integer, RecInfo varchar(256), CheckpointNum integer, FrameworkInfo varbyte(2000) ); Trabalhando com tabelas de log, erro e trabalho Quando você executa uma sessão que extrai ou carrega dados no Teradata usando o Teradata PT API, ele cria as seguintes tabelas: Tabelas de log. Armazenam informações de reinicialização e log do Teradata PT API. O Teradata PT API cria uma tabela de log para cada partição. Tabelas de erro. Registram os erros e dados rejeitados do Teradata quando uma sessão executa. O Teradata PT API cria duas tabelas de erro para cada partição. Tabelas de trabalho. Armazenam os dados quando você executa uma sessão que utiliza o operador de sistema Atualizar. O Teradata PT API cria uma tabela de trabalho para cada partição. Tabelas de log Insira um nome de tabela de log ao configurar uma sessão para carregar no Teradata. Você também pode optar por criar a tabela de log em um banco de dados de log, de trabalho ou padrão. Escolha onde deseja criar a tabela de log ao configurar a sessão para carregar no Teradata. As seguintes propriedades de sessão permitem especificar as informações da tabela de log: Propriedade Banco de dados de log Nome da tabela de log Descrição Nome do banco de dados que armazena as tabelas de log. Se você não inserir um nome para banco de dados de log nas propriedades da sessão, ou um nome do banco de dados no objeto de conexão, o Teradata PT API armazena as tabelas de log abaixo do usuário. Nome da tabela de log. Se você não especificar um nome para a tabela de log, o Serviço de Integração usa o nome <log_database>.infa_lt_<number>. O nome exato da tabela aparece no log da sessão. 12 Capítulo 3: Sessões e fluxos de trabalho Teradata PT API

20 Quando uma sessão falhar, consulte mais informações na tabela de log. Antes de executar a sessão novamente, descarte a tabela de log ou insira um nome de tabela diferente nas propriedades da sessão. Tabelas de erro O Teradata grava os erros rejeitados nas tabelas de erro ErrorTable1 e ErrorTable2. A ErrorTable1 contém dados rejeitados pelos seguintes motivos: Erros de conversão de dados Violações de restrição Alterações na configuração do Processador do módulo de acesso A ErrorTable2 contém dados rejeitados pelos seguintes motivos: Violações de restrição do índice primário exclusivo. Erros na fase de aquisição do trabalho do driver de carregamento. Você pode inserir um nome para cada tabela de erro ao configurar uma sessão para carregar no Teradata. Você também pode optar por criar as tabelas de erro em um banco de dados de erro, de trabalho ou padrão. Escolha onde deseja criar as tabelas de erro ao configurar a sessão para carregar no Teradata. As seguintes propriedades de sessão permitem especificar os nomes da tabela de erro: Propriedade Banco de dados de erros Name1 da tabela de erro Name2 da tabela de erro Descrição Nome do banco de dados que armazena as tabelas de erro. Se você não inserir um nome para banco de dados de erro nas propriedades da sessão, ou um nome do banco de dados no objeto de conexão, o Teradata PT API armazena as tabelas de erro abaixo do usuário. Nome da primeira tabela de erro. Se você não especificar um nome para a primeira tabela de erro, o Serviço de Integração usa o nome <error_database>.infa_et1_<number>. O nome exato da tabela aparece no log da sessão. Nome da segunda tabela de erro. Se você não especificar um nome para a segunda tabela de erro, o Serviço de Integração usa o nome <error_database>.infa_et2_<number>. O nome exato da tabela aparece no log da sessão. Quando uma sessão falhar, consulte mais informações sobre os erros nas tabelas de erro. Antes de executar a sessão novamente, descarte as tabelas de erro ou insira nomes de tabela diferentes nas propriedades da sessão. Tabelas de trabalho O operador de sistema Atualizar utiliza instruções DML para preparar os dados. Ele cria as tabelas de trabalho antes que o Teradata PT API comece a carregar os dados e as remove do banco de dados antes que o Teradata PT API carregue todas as linhas no destino. Insira um nome de tabela de trabalho ao configurar uma sessão para carregar no Teradata. Você também pode optar por criar a tabela de trabalho no banco de dados de destino. Escolha onde deseja criar a tabela de trabalho ao configurar a sessão para carregar no Teradata. Trabalhando com sessões Teradata PT API 13

21 As seguintes propriedades de sessão permitem especificar as informações da tabela de trabalho: Propriedade Banco de dados da tabela de trabalho Nome da tabela de trabalho Descrição Nome do banco de dados que armazena as tabelas de trabalho criadas pelo Teradata PT API quando você seleciona o operador de sistema Atualizar. Se você não especificar um banco de dados da tabela de trabalho, o Teradata PT API armazena as tabelas de trabalho no banco de dados de destino. Nome das tabelas de trabalho quando você seleciona o operador de sistema Atualizar. O banco de dados Teradata cria uma tabela de trabalho para cada tabela de destino. Se você não especificar um nome para a tabela de trabalho, o Serviço de Integração usa o nome <work_table_database>.infa<number>_wt. O nome exato da tabela aparece no log da sessão. Particionamento de pipeline É possível aumentar a quantidade de partições em um pipeline com o objetivo de melhorar o desempenho da sessão. O aumento da quantidade de partições permite que o Serviço de Integração crie várias conexões com origens e destinos e processe partições de origens e destinos de forma simultânea. Você pode configurar o particionamento para uma sessão que extrai ou carrega no Teradata. Se a sessão carregar no Teradata, configure o operador de sistema como Stream nas propriedades do objeto de conexão. Atualize as informações do particionamento usando a exibição Partições da guia Mapeamento das propriedades de sessão. A seguinte tabela descreve os tipos de partição para pontos de partição nas sessões Teradata PT API: Ponto de partição Qualificador de Origem Destino Teradata PT API Tipo de partição Passagem Passagem Suporte para Diversas Instâncias Você pode carregar dados em paralelo por meio de várias instâncias, de uma origem para um destino do Teradata PT API, a fim de melhorar o desempenho da sessão. Você pode especificar o número de instâncias paralelas para carregar dados no destino do Teradata PT API como propriedade de sessão. Se você tiver diversos destinos em uma sessão, poderá especificar um número diferente de instâncias para destinos diferentes. As propriedades de nível de sessão são aplicáveis para todas as instâncias. Para alcançar um desempenho de sessão ideal, é possível configurar o número de partições e o número de instâncias com base em fatores como latência de rede, tipo de origem e frequência de atualização de dados. Sugestão: Você poderá usar diversas partições com menor número de instâncias se a origem for mais lenta que o destino. Recuperação com Diversas Instâncias Você não pode recuperar sessões com diversas instâncias. A sessão falhará se você habilitar a recuperação e executar a sessão. Carregamento Preparado Carregamento preparado é a capacidade de pausar uma operação de carregamento ativo até que dados adicionais estejam disponíveis. Habilite a aquisição de pausa de parâmetro de sessão para permitir o carregamento preparado. Quando você executa uma sessão com a aquisição de pausa ativada, a sessão extrai os dados da origem e pausa antes do carregamento no destino. Você pode executar a sessão várias vezes para adquirir dados de diferentes origens, ou diferentes dados da mesma origem. Desabilite a aquisição de pausa e execute a sessão para carregar os dados adquiridos no destino imediatamente. 14 Capítulo 3: Sessões e fluxos de trabalho Teradata PT API