Vous êtes sur la page 1sur 307

Informatica PowerCenter (Verso 9.6.

0)

Guia do Designer

Informatica PowerCenter Guia do Designer


Verso 9.6.0
Janeiro 2014
Copyright (c) 1998-2014 Informatica Corporation. Todos os direitos reservados.
Este software e a respectiva documentao contm informaes de propriedade da Informatica Corporation. Eles so fornecidos sob um contrato de licena que
contm restries quanto a seu uso e divulgao, e so protegidos por leis de copyright. A engenharia reversa do software proibida. No est permitida de forma
alguma a reproduo ou a transmisso de qualquer parte deste documento (seja por meio eletrnico, fotocpia, gravao ou quaisquer outros) sem o consentimento
prvio da Informatica Corporation. Este Software pode estar protegido por patentes dos EUA e/ou internacionais e outras patentes pendentes.
O uso, duplicao ou divulgao do Software pelo Governo dos Estados Unidos esto sujeitos s restries estipuladas no contrato de licena de software aplicvel e
como estabelecido em DFARS 227.7202-1(a) e 227.7702-3(a) (1995), DFARS 252.227-7013(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19 ou FAR
52.227-14 (ALT III), conforme aplicvel.
As informaes contidas neste produto ou documentao esto sujeitas a alterao sem aviso prvio. Informe-nos por escrito caso encontre quaisquer problemas
neste produto ou documentao.
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 Informatica
On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging and
Informatica Master Data Management so marcas comerciais ou marcas registradas da Informatica Corporation nos Estados Unidos e em jurisdisdies pelo mundo.
Todos os outros nomes de outras companhias e produtos podem ser nomes ou marcas comerciais de seus respectivos proprietrios.
Partes desta documentao e/ou software esto sujeitas a direitos autorais de terceiros, incluindo sem limitao: 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
Isomorphic Software. Todos os direitos reservados. Copyright Meta Integration Technology, Inc. Todos os direitos reservados. Copyright Intalio. 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 Rogue 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. Copyright Thinkmap, Inc. Todos os direitos reservados. Copyright Clearpace
Software Limited. Todos os direitos reservados. Copyright Information Builders, Inc. Todos os direitos reservados. Copyright OSS Nokalva, Inc. Todos os direitos
reservados. Copyright Edifecs, Inc. Todos os direitos reservados. Copyright Cleo Communications, Inc. Todos os direitos reservados. Copyright International
Organization for Standardization 1986. Todos os direitos reservados. Copyright ej-technologies GmbH. Todos os direitos reservados. Copyright Jaspersoft
Corporation. Todos os direitos reservados. Copyright International Business Machines Corporation. Todos os direitos reservados. Copyright yWorks GmbH.
Todos os direitos reservados. Copyright Lucent Technologies. Todos os direitos reservados. Copyright (C) University of Toronto. Todos os direitos reservados.
Copyright Daniel Veillard. Todos os direitos reservados. Copyright Unicode, Inc. Copyright IBM Corp. Todos os direitos reservados. Copyright MicroQuill
Software Publishing, Inc. Todos os direitos reservados. Copyright PassMark Software Pty Ltd. Todos os direitos reservados. Copyright LogiXML, Inc. Todos os
direitos reservados. Copyright 2003-2010 Lorenzi Davide, todos os direitos reservados. Copyright Red Hat, Inc. Todos os direitos reservados. Copyright The
Board of Trustees of the Leland Stanford Junior University. Todos os direitos reservados. Copyright EMC Corporation. Todos os direitos reservados. Copyright
Flexera Software. Todos os direitos reservados. Copyright Jinfonet Software. Todos os direitos reservados. Copyright Apple Inc. Todos os direitos reservados.
Copyright Telerik Inc. Todos os direitos reservados. Copyright BEA Systems. Todos os direitos reservados. Copyright PDFlib GmbH. Todos os direitos
reservados. Copyright Orientation in Objects GmbH. Todos os direitos reservados. Copyright Tanuki Software, Ltd. All rights reserved. Copyright Ricebridge.
Todos os direitos reservados. Copyright Sencha, Inc. All rights reserved.
Este produto inclui software desenvolvido pela Apache Software Foundation (http://www.apache.org/) e/ou outros softwares licenciados nas vrias verses da Licena
Apache (a "Licena"). Voc pode obter uma cpia dessas Licenas em http://www.apache.org/licenses/. A menos que exigido pela legislao aplicvel ou concordado
por escrito, o software distribudo em conformidade com estas Licenas fornecido "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA OU CONDIO DE
QUALQUER TIPO, seja expressa ou implcita. Consulte as Licenas para conhecer as limitaes e as permisses que regulam o idioma especfico de acordo com as
Licenas.
Este produto inclui software desenvolvido pela Mozilla (http://www.mozilla.org/), direitos autorais de software de The JBoss Group, LLC; todos os direitos reservados;
direitos autorais de software 1999-2006 de Bruno Lowagie e Paulo Soares e outros produtos de software licenciados sob a Licena Pblica GNU Lesser General
Public License Agreement, que pode ser encontrada em http://www.gnu.org/licenses/lgpl.html. Os materiais so fornecidos gratuitamente pela Informatica, no estado
em que se encontram, sem garantia de qualquer tipo, explcita nem implcita, incluindo, mas no limitando-se, as garantias implicadas de comerciabilidade e
adequao a um determinado propsito.
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 () 1993-2006, 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 redistribuio deste software est sujeita aos termos disponveis em http://www.openssl.org e http://www.openssl.org/source/license.html.
Este produto inclui o software Curl com o Copyright 1996-2013, Daniel Stenberg, <daniel@haxx.se>. Todos os direitos reservados. Permisses e limitaes relativas a
este software esto sujeitas aos termos disponveis em http://curl.haxx.se/docs/copyright.html. permitido usar, copiar, modificar e distribuir este software com
qualquer objetivo, com ou sem taxa, desde que a nota de direitos autorais acima e esta nota de permisso apaream em todas as cpias.
O produto inclui direitos autorais de software 2001-2005 () MetaStuff, Ltd. Todos os direitos reservados. Permisses e limitaes relativas a este software esto
sujeitas aos termos disponveis em http://www.dom4j.org/license.html.
O produto inclui o copyright de software 2004-2007, The Dojo Foundation. Todos os direitos reservados. Permisses e limitaes relativas a este software esto
sujeitas aos termos disponveis em http://dojotoolkit.org/license.
Este produto inclui o software ICU com o copyright International Business Machines Corporation e outros. Todos os direitos reservados. Permisses e limitaes
relativas a este software esto sujeitas aos termos disponveis em http://source.icu-project.org/repos/icu/icu/trunk/license.html.
Este produto inclui o copyright de software 1996-2006 Per Bothner. Todos os direitos reservados. O direito de usar tais materiais estabelecido na licena que pode
ser encontrada em http://www.gnu.org/software/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. Permisses e limitaes relativas a este software esto sujeitas aos termos disponveis em http://www.opensource.org/licenses/mit-license.php.
Este produto inclui software desenvolvido pela Boost (http://www.boost.org/) ou sob a licena de software Boost. Permisses e limitaes relativas a este software
esto sujeitas aos termos disponveis em http://www.boost.org/LICENSE_1_0.txt.
Este produto inclui direitos autorais de software 1997-2007 University of Cambridge. Permisses e limitaes relativas a este software esto sujeitas aos termos
disponveis em http://www.pcre.org/license.txt.

Este produto inclui o copyright de software 2007 The Eclipse Foundation. Todos os direitos reservados. As permisses e limitaes relativas a este software esto
sujeitas aos termos disponveis em http://www.eclipse.org/org/documents/epl-v10.php e em http://www.eclipse.org/org/documents/edl-v10.php.
Este produto inclui softwares licenciados de acordo com os termos disponveis em http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?
License, http://www.stlport.org/doc/ license.html, http:// asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://
httpunit.sourceforge.net/doc/ license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/
license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/licenseagreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/licence.html;
http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/LICENSE.txt; http://jotm.objectweb.org/bsd_license.html; . http://www.w3.org/Consortium/Legal/
2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/license.html; http://
forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/software/tcltk/license.html, http://
www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/iodbc/wiki/iODBC/License; http://
www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/index.html; http://www.net-snmp.org/about/
license.html; http://www.openmdx.org/#FAQ; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt; http://www.schneier.com/blowfish.html; http://
www.jmock.org/license.html; http://xsom.java.net; http://benalman.com/about/license/; https://github.com/CreateJS/EaselJS/blob/master/src/easeljs/display/Bitmap.js;
http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/LICENSE; http://jdbc.postgresql.org/license.html; http://
protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; https://github.com/rantav/hector/blob/master/LICENSE; http://web.mit.edu/Kerberos/krb5current/doc/mitK5license.html. e http://jibx.sourceforge.net/jibx-license.html.
Este produto inclui software licenciado de acordo com a Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), a Common Development and
Distribution License (http://www.opensource.org/licenses/cddl1.php), a Common Public License (http://www.opensource.org/licenses/cpl1.0.php), a Sun Binary Code
License Agreement Supplemental License Terms, a BSD License (http://www.opensource.org/licenses/bsd-license.php), a nova BSD License (http://opensource.org/
licenses/BSD-3-Clause), a MIT License (http://www.opensource.org/licenses/mit-license.php), a Artistic License (http://www.opensource.org/licenses/artisticlicense-1.0) e a Initial Developers Public License Version 1.0 (http://www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/).
Este produto inclui copyright do software 2003-2006 Joe WaInes, 2006-2007 XStream Committers. Todos os direitos reservados. Permisses e limitaes relativas a
este software esto sujeitas aos termos disponveis em http://xstream.codehaus.org/license.html. Este produto inclui software desenvolvido pelo Indiana University
Extreme! Lab. Para obter mais informaes, visite http://www.extreme.indiana.edu/.
Este produto inclui software Copyright 2013 Frank Balluffi e Markus Moeller. Todos os direitos reservados. As permisses e limitaes relativas a este software esto
sujeitas aos termos da licena MIT.
Este Software protegido pelos Nmeros 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,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110; 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121;
7,584,422; 7,676,516; 7,720,842; 7,721,270; 7,774,791; 8,065,266; 8,150,803; 8,166,048; 8,166,071; 8,200,622; 8,224,873; 8,271,477; 8,327,419; 8,386,435;
8,392,460; 8,453,159; 8,458,230; e RE44,478, Patentes internacionais e outras Patentes Pendentes.
ISENO DE RESPONSABILIDADE: a Informatica Corporation fornece esta documentao no estado em que se encontra, sem garantia de qualquer tipo, expressa
ou implcita, incluindo, mas no limitando-se, as garantias implcitas de no infrao, comercializao ou uso para um determinado propsito. A Informatica
Corporation no garante que este software ou documentao esteja sem erros. As informaes fornecidas neste software ou documentao podem incluir imprecises
tcnicas ou erros tipogrficos. As informaes deste software e documentao esto sujeitas a alteraes a qualquer momento sem aviso prvio.
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"), que esto sujeitos aos seguintes termos e condies:
1. OS DRIVERS DA DATADIRECT SO FORNECIDOS NO ESTADO EM QUE SE ENCONTRAM, SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU
IMPLCITA, INCLUINDO, MAS NO LIMITANDO-SE, AS GARANTIAS IMPLCITAS DE COMERCIALIZAO, ADEQUAO A UMA FINALIDADE
ESPECFICA E NO INFRAO.
2. EM NENHUM CASO, A DATADIRECT OU SEUS FORNECEDORES TERCEIRIZADOS SERO RESPONSVEIS, EM RELAO AO CLIENTE FINAL, POR
QUAISQUER DANOS DIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS, CONSEQUENCIAIS OU DEMAIS QUE POSSAM ADVIR DO USO DE DRIVERS
ODBC, SENDO OU NO ANTERIORMENTE INFORMADOS DAS POSSIBILIDADES DE TAIS DANOS. ESTAS LIMITAES SE APLICAM A TODAS AS
CAUSAS DE AO, INCLUINDO, SEM LIMITAES, QUEBRA DE CONTRATO, QUEBRA DE GARANTIA, NEGLIGNCIA, RESPONSABILIDADE
RIGOROSA, DETURPAO E OUTROS ATOS ILCITOS.
Parte Nmero: PC-DEG-96000-0001

Contedo
Prefcio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Recursos da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Portal My Support da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Documentao da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Site da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Biblioteca de Recursos da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Base de Dados de Conhecimento da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Canal de Suporte da Informatica no YouTube. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Informatica Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Informatica Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Suporte Global a Clientes da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Captulo 1: Usando o Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1


Viso Geral do Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Ferramentas do Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Janelas do Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Configurao das Opes do Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configurando Opes Gerais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configurao de Opes de Tabelas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Configurao de Opes de Formato. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Configurando as Opes de Depurao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Configurao de Opes de Servio da Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Configurao de Opes Diversas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Usando Barras de Ferramentas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Barras de Ferramentas do Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Barras de Ferramentas do Workflow Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Barras de ferramentas do Workflow Monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Barras de Ferramentas do Repository Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Exibio de uma Barra de Ferramentas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Criao de uma Barra de Ferramentas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Configurando uma Barra de Ferramentas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Adicionando Ferramentas Personalizadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Navegando no Espao de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Ferramentas de Pesquisa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Criando cones e Restaurando Objetos do Espao de Trabalho . . . . . . . . . . . . . . . . . . . . 16
Organizando Objetos do Espao de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Zoom no Espao de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Exibindo o Espao de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Tarefas do Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Adio de um Repositrio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Sumrio

Impresso do Espao de Trabalho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18


Exibindo a Data/Hora do ltimo Salvamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Abrindo e Fechando uma Pasta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Criao de Atalhos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Fazendo Check-out e Check-in de Objetos com Verso. . . . . . . . . . . . . . . . . . . . . . . . . . 19
Pesquisa de Objetos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Inserindo Descries para Objetos de Repositrio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Exibindo e Comparando Objetos de Repositrio com Controle de Verso . . . . . . . . . . . . . . 20
Reverso para uma Verso de Objeto Prvia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Copiando Objetos do Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Exportando e Importando Objetos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Trabalhando com Vrias Portas ou Colunas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Renomeando Portas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Uso das Teclas de Atalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Visualizao dos Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Visualizao de Dados Relacionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Visualizao de Dados de Arquivos Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Visualizao dos Dados XML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Trabalhando com Extenses de Metadados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Criao de Extenses de Metadados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Edio de Extenses de Metadados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Excluso das Extenses de Metadados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Usando Nomes Comerciais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Adicionando Nomes Comerciais a Origens ou Destinos. . . . . . . . . . . . . . . . . . . . . . . . . . 28
Exibindo Nomes Comerciais no Navegador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Exibindo Nomes Comerciais como Nomes de Coluna. . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Usando Nomes Comerciais como Nomes de Portas em Qualificadores de Origem. . . . . . . . . 29
Usando a Documentao Comercial. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Especificao do Caminho da Documentao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Criao de Links para Arquivos de Documentao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Exibindo a Documentao Comercial. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Exibindo Relatrios de Mapeamento e do Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Exibindo um Relatrio de Composio do Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Exibindo um Relatrio de Composio de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . 32

Captulo 2: Trabalhando com Origens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33


Viso Geral do Trabalho com Origens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Tratamento de Caracteres Especiais em Definies de Origem. . . . . . . . . . . . . . . . . . . . . 34
Atualizando Definies de Origem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Criando Sesses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Trabalhando com origens relacionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Definies de Origens Relacionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Conectividade para Origens Relacionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

ii

Sumrio

Configurando uma Fonte de Dados ODBC de Terceiros. . . . . . . . . . . . . . . . . . . . . . . . . . 38


Importando Definies de Origens Relacionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Modificando uma Definio de Origem Relacional. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Trabalhando com Origens COBOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Importando Origens COBOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Trabalhando com Copybooks COBOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Etapas para Importar uma Estrutura de Origem COBOL. . . . . . . . . . . . . . . . . . . . . . . . . . 43
Componentes de um Arquivo de Origem COBOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Seo FD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Campos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
OCCURS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
REDEFINES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Configurando Definies de Origem COBOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Configurando a Guia Tabela. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Configurando Propriedades Avanadas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Configurando a Guia Colunas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Importando uma Definio de Origem do Microsoft Excel. . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Definindo Intervalos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Formatando Colunas de Dados Numricos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Etapas para Importar uma Definio de Origem do Microsoft Excel. . . . . . . . . . . . . . . . . . 49
Criando Manualmente uma Definio de Origem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Solucionando Problemas de Origens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Captulo 3: Trabalhando com Arquivos Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51


Viso Geral do Trabalho com Arquivos Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Criao de Sesses com Origens e Destinos de Arquivos Simples. . . . . . . . . . . . . . . . . . . 51
Importao de Arquivos Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Tratamento de Caracteres Especiais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Seleo de Pginas de Cdigo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Alterao de Origens de Exibio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Importao de Arquivos Simples de Largura Fixa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Importando Arquivos Simples Delimitados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Editando Definies de Arquivos Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Editando Opes de Tabela. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Editando Colunas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Atualizando Propriedades de Arquivo de Largura Fixa. . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Atualizando Propriedades de Arquivo Delimitado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Formatando Colunas de Arquivos Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Formatando Colunas Numricas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Formatando Colunas de Data e Hora. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Definio de Formatos de Data e Hora e Numricos Padro. . . . . . . . . . . . . . . . . . . . . . . 72
Trabalhando com Listas de Arquivos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Trabalhando com Arquivos Simples que Diferenciam Deslocamentos. . . . . . . . . . . . . . . . . . . . 73

Sumrio

iii

Importao de Arquivos Simples com Teclas Shift. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74


Importando Arquivos Simples sem Teclas Shift. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Trabalhando com Dados Multibyte em Destinos de Largura Fixa. . . . . . . . . . . . . . . . . . . . . . . 75
Soluo de Problemas de Arquivos Simples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Captulo 4: Trabalhando com Destinos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77


Viso Geral do Trabalho com Destinos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Criando Definies de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Mantendo Destinos e Definies de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Pginas de Cdigo de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Tratamento de Caracteres Especiais em Definies de Destino. . . . . . . . . . . . . . . . . . . . . 78
Importando uma Definio de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Definies de Destino Relacional. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Conectividade para Destinos Relacionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Configurando uma Fonte de Dados ODBC de Terceiros. . . . . . . . . . . . . . . . . . . . . . . . . . 81
Importando Definies de Destino Relacional. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Criando uma Definio de Destino a Partir de uma Definio de Origem. . . . . . . . . . . . . . . . . . 82
Criando uma Definio de Destino a Partir de uma Origem Relacional. . . . . . . . . . . . . . . . 82
Criando uma Definio de Destino em uma Origem de Arquivo Simples. . . . . . . . . . . . . . . 83
Criando um Destino Normalizado em uma Origem COBOL. . . . . . . . . . . . . . . . . . . . . . . . 83
Etapas Para Criar uma Definio de Destino a Partir de uma Definio de Origem. . . . . . . . . 83
Criando uma Definio de Destino a Partir de uma Transformao. . . . . . . . . . . . . . . . . . . . . . 84
Criando um Destino a Partir de uma Transformao com um Grupo de Sada. . . . . . . . . . . . 84
Criando um Destino a Partir de uma Transformao com Vrios Grupos de Sada. . . . . . . . . 85
Criando um Destino a Partir de uma Transformao de Normalizador. . . . . . . . . . . . . . . . . 86
Criando um Destino a Partir de um Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Tipos de Dados de Destino e Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Etapas para Criar um Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Criando Manualmente uma Definio de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Mantendo Definies de Destino Relacional. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Reimportando uma Definio de Destino Relacional. . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Criando uma Relao de Chave Primria-Chave Externa. . . . . . . . . . . . . . . . . . . . . . . . . 91
Editando Opes de Tabela. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Editando Colunas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Definindo ndices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Criando uma Tabela de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Comandos DDL do SQL no Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Descartando e Recriando ndices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Recriando Destinos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Solucionando Problemas de Destinos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Captulo 5: Origem e Destino da Transformao de Dados. . . . . . . . . . . . . . . . . . . . . 97


Viso Geral de Origens e Destinos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

iv

Sumrio

Transformao de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Definindo um nome de servio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Transformao de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Transformao de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Configurar Transformao de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Grupo Hierrquico de Portas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Vrios Arquivos de Origem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Processamento da Sesso de Origem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Transformao de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Transformao de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Transformao de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Processamento da Sesso de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Criando uma Origem ou um Destino da Transformao de Dados. . . . . . . . . . . . . . . . . . . . . . 105
Criando Portas a Partir de um Servio da Transformao de Dados. . . . . . . . . . . . . . . . . . . . 106

Captulo 6: Mapeamentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107


Viso Geral de Mapeamentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Dependncia do Objeto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Desenvolvimento de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Trabalhando com Mapeamentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Criao de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Abertura de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Cpia de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Copiando Segmentos de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Copiando Objetos de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Exportao e Importao de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Edio de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Depurao de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Excluso de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Exibindo Caminhos de Link Para uma Porta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Exibindo Dependncias da Coluna de Origem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Conectando Objetos de Mapeamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Opes para Vinculao de Portas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Regras e Diretrizes para Conexo de Objetos de Mapeamento. . . . . . . . . . . . . . . . . . . . 115
Vinculando Portas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Vinculando Portas Manualmente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Vinculando Portas por Posio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Vinculando Portas por Nome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Propagando Atributos de Porta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Noes Bsicas de Tipos de Dependncia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Propagao de Dependncias em um Caminho de Link. . . . . . . . . . . . . . . . . . . . . . . . . 119
Propagao de Dependncias Implcitas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Atributos Propagados por Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Sumrio

Regras e Diretrizes para Propagao de Portas e Atributos. . . . . . . . . . . . . . . . . . . . . . . 123


Etapas para Propagar Atributos de Porta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Trabalhando com Origens em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Trabalhando com Origens Relacionais em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . 125
Trabalhando com Transformaes em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Trabalhando com Mapplets em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Trabalhando com Destinos em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Configurando Destinos Relacionais em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . 127
Configurando Destinos de Arquivo Simples em um Mapeamento. . . . . . . . . . . . . . . . . . . 127
Configurando Destinos XML em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Configurando a Ordem de Carregamento de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Criando Arquivos de Destino por Transao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Configurao do Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Configurando o Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Execuo da Sesso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Regras e Diretrizes para Criao de Arquivos de Destino por Transao. . . . . . . . . . . . . . 130
Exemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Trabalhando com Destinos Relacionais em um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . 131
Rejeitando Dados Truncados e Excedentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Configurando a Substituio da Atualizao de Destino. . . . . . . . . . . . . . . . . . . . . . . . . 131
Configurando o Prefixo de Nome de Tabela. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Adicionando Comandos SQL Pr e Ps-Sesso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Substituindo o Nome da Tabela de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Validao de um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Validao de Conexo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Validao de Expresso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Validao de Objeto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Validao de Fluxo de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Etapas para Validar um Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Usando o Assistente de Gerao de Fluxo de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Etapas do Assistente de Gerao de Fluxo de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . 139
Soluo de Problemas de Mapeamentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Captulo 7: Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141


Viso Geral de Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Noes Bsicas de Entrada e Sada do Mapplet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Entrada de Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Sada de Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Exibindo a Entrada e a Sada do Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Uso do Mapplet Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Criao de um Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Validao de Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Edio de Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

vi

Sumrio

Mapplets e Mapeamentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146


Usando Mapplets em Mapeamentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Criao e Configurao de Portas de Mapplet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Conexo s Portas de Entrada do Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Conexo aos Grupos de Sada de Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Exibindo o Mapplet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Configurando o Plano de Carregamento de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Particionamento de Pipeline. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Regras e Diretrizes para Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Dicas para Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Captulo 8: Parmetros e Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . 151


Viso geral de Parmetros e Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Parmetros de mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Uso de Parmetros e Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Valores Iniciais e Padro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Usando Parmetros e Variveis de String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Usando Parmetros e Variveis de Data e Hora. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Amenizao da Pgina de Cdigo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Parmetros de mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Etapa 1. Criar um Parmetro de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Etapa 2. Usar um Parmetro de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Etapa 3. Definir um Valor de Parmetro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Valores de Variveis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Tipo de Dados de Varivel e Tipo de Agregao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Funes Variveis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Mapeando Variveis em Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Uso de Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Definindo Strings de Expresses em Arquivos de Parmetros. . . . . . . . . . . . . . . . . . . . . . . . 163
Dicas para Parmetros e Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Soluo de Problemas de Parmetros e Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . 165

Captulo 9: Trabalhando com Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . 166


Viso Geral do Trabalho com Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . 166
Exemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Criao de Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Configurao do Tipo de Funo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Configurao de Funes Pblicas que Contm Funes Privadas. . . . . . . . . . . . . . . . . . 168
Etapas para Criar uma Funo Definida pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . 168
Gerenciamento de Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Edio de Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

Sumrio

vii

Excluso de Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169


Exportao de Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Validao de Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Cpia e Implantao de Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . 170
Criando Expresses com Funes Definidas pelo Usurio. . . . . . . . . . . . . . . . . . . . . . . . . . 170

Captulo 10: Uso do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172


Viso Geral do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Tipos de Sesso do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Processo de Depurao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Criao de Pontos de Interrupo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Seleo do Nome da Instncia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Criao de Pontos de Interrupo de Erro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Criao de Pontos de Interrupo de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Inserindo a Condio de Ponto de Interrupo de Dados. . . . . . . . . . . . . . . . . . . . . . . . 177
Etapas para Inserir Pontos de Interrupo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Edio de um Ponto de Interrupo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Configurao do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Etapa 1. Introduo ao Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Etapa 2. Selecionar o Servio de Integrao e o Tipo de Sesso. . . . . . . . . . . . . . . . . . . 181
Etapa 3. Selecionar Informaes da Sesso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Etapa 4. Definir Configurao da Sesso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Etapa 5. Configurar Opes de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Execuo do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Estado de Inicializao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Estado de Execuo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Estado Pausado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Tarefas do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Trabalhando com Valores Persistentes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Comportamento do Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Monitorao do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Monitorao de Indicadores de Depurao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Monitorao dos Dados da Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Continuao do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Monitorao dos Dados de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Monitorando o Log de Depurao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Usando o Workflow Monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Modificao de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Restries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Avaliao de Expresses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Avaliando Expresses que usam Variveis de Mapeamento. . . . . . . . . . . . . . . . . . . . . . 193
Etapas para Avaliar Expresses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Cpia de Informaes e da Configurao do Ponto de Interrupo. . . . . . . . . . . . . . . . . . . . . 194

viii

Sumrio

Transferncia e Configurao dos Pontos de Interrupo. . . . . . . . . . . . . . . . . . . . . . . . 194


Soluo de Problemas do Depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Captulo 11: Exibindo Linhagem de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196


Exibindo Linhagem de Dados - Viso Geral. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Configurando o Acesso Linhagem de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Executando Linhagem de Dados do Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Captulo 12: Comparando Objetos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198


Comparando Objetos - Viso Geral. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Comparando Origens, Destinos e Transformaes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Comparando Mapeamentos e Mapplets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Captulo 13: Gerenciando Componentes Comerciais. . . . . . . . . . . . . . . . . . . . . . . . . 202


Gerenciando Componentes Comerciais - Viso Geral. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Bloqueio do Componente Comercial. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Criao de Links para Documentao de Componentes Comerciais. . . . . . . . . . . . . . . . . 203
Gerenciando Componentes Comerciais e Diretrios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Criando e Editando um Diretrio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Criando um Componente Comercial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Excluso de um Diretrio ou Componente Comercial. . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Copiando um Diretrio ou Componente Comercial. . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Captulo 14: Criando Cubos e Dimenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206


Viso Geral da Criao de Cubos e Dimenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Noes Bsicas de Metadados Multidimensionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Elementos-chave de Metadados Multidimensionais . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Criao de uma Dimenso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Etapa 1. Criar uma Dimenso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Etapa 2. Adicionar Nveis Dimenso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Etapa 3. Adicionar Hierarquias Dimenso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Etapa 4. Adicionar Nveis Hierarquia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Criao de um Cubo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Edio de um Cubo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Edio de uma Dimenso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Excluso de Cubo ou Dimenso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Abrindo e Fechando um Cubo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Exibindo Metadados para Cubos e Dimenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Dicas para Cubos e Dimenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Captulo 15: Usando os Assistentes de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . 213


Mantendo Esquemas em Estrela. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Noes Bsicas de Assistentes de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Sumrio

ix

Usando o Assistente do Guia de Introduo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215


Usando o Assistente de Dimenses de Alterao Lenta. . . . . . . . . . . . . . . . . . . . . . . . . 215
Escolha de Origens para os Mapeamentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Criando um Mapeamento de Passagem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Noes Bsicas de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Etapas para Criar um Mapeamento de Passagem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Personalizao do Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Configurando uma Sesso de Passagem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Criao de um Mapeamento de Destino de Crescimento Lento. . . . . . . . . . . . . . . . . . . . . . . 218
Manipulao de Chaves. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Noes Bsicas de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Etapas para Criar um Mapeamento de Destino de Crescimento Lento. . . . . . . . . . . . . . . . 220
Configurando uma Sesso de Destino de Crescimento Lento. . . . . . . . . . . . . . . . . . . . . 221
Criao de um Mapeamento de Dimenso de Tipo 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Manipulao de Chaves. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Noes Bsicas de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Etapas para Criar um Mapeamento de Dimenso Tipo 1. . . . . . . . . . . . . . . . . . . . . . . . . 224
Configurando uma Sesso Dimenso de Tipo 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Criando um Mapeamento de Dimenso Tipo 2/Dados de Verso. . . . . . . . . . . . . . . . . . . . . . 225
Manipulao de Chaves. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Numerao das Verses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Noes Bsicas de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Etapas para Criar um Mapeamento de Dimenso Tipo 2/Dados de Verso. . . . . . . . . . . . . 230
Personalizao do Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Configurando uma Sesso Dimenso Tipo 2/Dados de Verso. . . . . . . . . . . . . . . . . . . . 231
Criando um Mapeamento de Dimenso Tipo 2/Sinalizar Atual. . . . . . . . . . . . . . . . . . . . . . . . 231
Sinalizao do Valor Atual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Manipulao de Chaves. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Noes Bsicas de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Etapas para Criar um Mapeamento de Dimenso Tipo 2/Sinalizar Atual. . . . . . . . . . . . . . . 236
Configurando uma Sesso Dimenso Tipo 2/Sinalizar Atual. . . . . . . . . . . . . . . . . . . . . . 237
Criando um Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo. . . . . . . . . . . . . . . . . 237
Manuteno do Intervalo de Data Efetiva. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Manipulao de Chaves. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Noes Bsicas de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Etapas para Criar um Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo. . . . . . . 242
Configurando uma Sesso Dimenso Tipo 2/Intervalo de Datas Efetivo. . . . . . . . . . . . . . . 243
Criao de um Mapeamento de Dimenso de Tipo 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Salvamento de Valores Prvios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Manipulao de Chaves. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Marcao da Data Efetiva. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Noes Bsicas de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Sumrio

Etapas para Criar um Mapeamento de Dimenso Tipo 3. . . . . . . . . . . . . . . . . . . . . . . . . 248


Configurando uma Sesso Dimenso de Tipo 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Criao de Destinos no Banco de Dados de Destino. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Agendando Sesses e Fluxos de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Criao de um Mapeamento a partir dos Modelos de Mapeamento Informatica. . . . . . . . . . . . . 251
Etapa 1. Selecionar o Modelo de Mapeamento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Etapa 2. Especificar Detalhes e Valores de Parmetro do Mapeamento. . . . . . . . . . . . . . . 252
Etapa 3. Criar Mapeamentos e Salvar Valores de Parmetro. . . . . . . . . . . . . . . . . . . . . . 252
Etapa 4. Importar Mapeamentos para o Repositrio. . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Apndice A: Referncia do Tipo de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254


Viso Geral de Referncia de Tipo de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Tipos de Dados Inteiro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Tipo de Dados Binrio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Tipo de Dados de Data/Hora. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Tipos de Dados Decimais e Duplos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Tipo de Dados de String. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
IBM DB2 e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Informix e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Sinnimos de Tipos de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Microsoft SQL Server e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . 263
Sinnimos de Tipos de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Tipo de Dados Uniqueidentifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Oracle e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Tipo de Dados Nmero(P,S). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Tipos de Dados Char, Varchar, Clob. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Tipos de Dados SAP HANA e de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Sybase e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Sinnimos de Tipos de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Tipo de Dados Binrios e Varbinary para Sybase IQ. . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Teradata e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Sinnimos de Tipos de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
ODBC e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
COBOL e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Arquivo Simples e Tipos de Dados de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Tipo de Dados Nmero. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Tipos de dados XML e de Transformao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Converso de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Converso de Dados Porta a Porta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Convertendo Strings em Datas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Convertendo Strings em Nmeros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Sumrio

xi

ndice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

xii

Sumrio

Prefcio
O Guia do Designer do PowerCenter foi escrito para desenvolvedores e engenheiros de software
responsveis pela implementao de data warehouse. O Guia do Designer do PowerCenter presume que
voc tenha uma compreenso slida de seus sistemas operacionais, conceitos de banco de dados relacional
e mecanismos de banco de dados, arquivos simples ou sistema de mainframe em seu ambiente. Este guia
tambm considera que voc esteja familiarizado com os requisitos de interface dos seus aplicativos de
suporte.

Recursos da Informatica
Portal My Support da Informatica
Como cliente da Informatica, voc pode acessar o Portal My Support da Informatica em
http://mysupport.informatica.com.
O site contm informaes sobre produtos, informaes sobre grupos de usurios, 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, Documentao de Produtos
da Informatica e comunidade de usurios da Informatica.

Documentao da Informatica
A equipe de Documentao da Informatica se esfora ao mximo para criar documentaes precisas e
utilizveis. Se voc tiver dvidas, comentrios ou ideias sobre esta documentao, entre em contato com a
equipe de Documentao da Informatica pelo e-mail infa_documentation@informatica.com. Ns usaremos
seu feedback para melhorar a documentao. Por favor, avise-nos se pudermos entrar em contato com voc
em relao aos comentrios.
A equipe de Documentao atualiza a documentao conforme o necessrio. Para obter a documentao
mais recente do seu produto, navegue para Documentao do Produto no endereo
http://mysupport.informatica.com.

Site da Informatica
Voc pode acessar o site corporativo da Informatica no endereohttp://www.informatica.com. O site contm
informaes sobre a Informatica, seu histrico, eventos futuros e escritrios de vendas. Voc tambm vai
encontrar informaes sobre parceiros e produtos. A rea de servios do site inclui informaes importantes
sobre suporte tcnico, treinamento e educao, bem como servios de implementao.

xiii

Biblioteca de Recursos da Informatica


Na qualidade de cliente da Informatica, voc pode acessar a Biblioteca de Recursos da Informatica no
endereo http://mysupport.informatica.com. A Biblioteca de Recursos uma coletnea de recursos que o
ajuda a aprender mais sobre os produtos e recursos da Informatica. Ela inclui artigos e demonstraes
interativas que apresentam solues a problemas comuns, comparam recursos e comportamentos e o
orienta na execuo de tarefas especficas no mundo real.

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 endereo http://mysupport.informatica.com. Use a Base de Dados de Conhecimento para
pesquisar solues documentadas a problemas tcnicos conhecidos sobre produtos da Informatica. Voc
tambm pode encontrar respostas a perguntas frequentes, white papers e dicas tcnicas. Se voc tiver
dvidas, comentrios ou ideias sobre a Base de Dados de Conhecimento, entre em contato com a equipe da
Base de Dados de Conhecimento da Informatica pelo e-mail KB_Feedback@informatica.com.

Canal de Suporte da Informatica no YouTube


Voc pode acessar o canal de Suporte da Informatica no YouTube
http://www.youtube.com/user/INFASupport. O canal de Suporte da Informatica no YouTube inclui vdeos
sobre solues que orientam voc na execuo de tarefas especficas. Em caso de dvidas, comentrios ou
ideias sobre o canal de Suporte da Informatica no YouTube, entre em contato com a equipe de Suporte do
YouTube por email em supportvideos@informatica.com ou envie um tweet para @INFASupport.

Informatica Marketplace
O Informatica Marketplace um frum em que desenvolvedores e parceiros podem compartilhar solues
para aumentar, ampliar ou aprimorar implementaes da integrao de dados. Ao tirar proveito de qualquer
uma das centenas de solues disponveis no Marketplace, voc pode melhorar sua produtividade e agilizar
o tempo de implementao em seu projeto. Voc pode acessar o Informatica Marketplace atravs do link
http://www.informaticamarketplace.com.

Informatica Velocity
Voc pode acessar o Informatica Velocity em http://mysupport.informatica.com. Desenvolvido a partir da
experincias reais em centenas de projetos de gerenciamento de dados, o Informatica Velocity representa o
conhecimento coletivo de nossos consultores que trabalharam com organizaes no mundo inteiro para
planejar, desenvolver, implantar e manter solues bem-sucedidas de Gerenciamento de Dados. Se voc
tiver dvidas, comentrios ou ideias sobre o Informatica Velocity, entre em contato com o Informatica
Professional Services em ips@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 usurio e uma senha. Voc pode solicitar um nome de usurio e uma
senha no endereo http://mysupport.informatica.com.
Os nmeros de telefone para o Suporte Global a Clientes da Informatica esto disponveis no site da
Informatica em http://www.informatica.com/us/services-and-training/support-services/global-support-centers/.

xiv

Prefcio

CAPTULO 1

Usando o Designer
Este captulo inclui os seguintes tpicos:

Viso Geral do Designer, 1

Configurao das Opes do Designer, 3

Usando Barras de Ferramentas, 10

Adicionando Ferramentas Personalizadas , 13

Navegando no Espao de Trabalho, 14

Tarefas do Designer , 18

Visualizao dos Dados, 24

Trabalhando com Extenses de Metadados, 26

Usando Nomes Comerciais, 28

Usando a Documentao Comercial, 29

Exibindo Relatrios de Mapeamento e do Mapplet, 31

Viso Geral do Designer


O Designer possui ferramentas para ajud-lo a criar mapeamentos e mapplets, fazendo com que voc
especifique como mover e transformar dados entre origens e destinos. O Designer o ajuda a criar definies
de origens, definies de destino e transformaes para criar os mapeamentos.
O Designer inclui janelas para voc exibir pastas, objetos de repositrio e tarefas. Voc pode trabalhar em
vrias pastas e repositrios ao mesmo tempo.
possvel ajustar as configuraes gerais do Designer, como origem e cor do plano de fundo. Voc tambm
pode ajustar as configuraes especficas de cada ferramenta do Designer.

Ferramentas do Designer
O Designer oferece as seguintes ferramentas:

Source Analyzer. Importar ou criar definies de origem de arquivo simples, XML, COBOL, Aplicativo e
origens relacionais.

Target Designer. Importar ou criar definies de destino.

Transformation Developer. Criar transformaes reutilizveis.

Mapplet Designer. Criar mapplets.

Mapping Designer. Criar mapeamentos.

Janelas do Designer
O Designer consiste nas seguintes janelas:

Navegador. Conectar a vrios repositrios e pastas. Voc tambm pode copiar e excluir objetos e criar
atalhos usando o Navegador.

Espao de trabalho. Exibir ou editar origens, destinos, mapplets, transformaes e mapeamentos. Voc
trabalha com uma nica ferramenta de cada vez no espao de trabalho, a qual possui dois formatos:
padro e espao de trabalho. Voc pode exibir vrias verses de um objeto no espao de trabalho.

Barra de status. Exibe o status da operao que voc desempenha.

Sada. Fornece detalhes quando voc realiza certas tarefas, como salvar o trabalho ou validar um
mapeamento. Clique com o boto direito do mouse na janela Sada para acessar suas opes, como
imprimir texto de sada, salvar texto em arquivo e alterar o tamanho da origem.

Viso geral. Exibir pastas de trabalho que contm grandes mapeamentos ou muitos objetos. A janela
Viso Geral descreve a rea visvel no espao de trabalho e reala os objetos selecionados em cores.
Para abrir a janela Viso geral, clique em Exibir > Janela Viso geral.

Dados de Instncia. Exibir dados de transformao ao mesmo que executa o depurador para depurar
um mapeamento.

Dados de Destino. Exibir dados de destino enquanto executa o Depurador para depurar um
mapeamento.

Voc pode exibir uma lista de janelas abertas, e pode alternar de uma janela para outra no Designer. Para
exibir a lista de janelas abertas, clique em Janela > Janelas.
A figura a seguir mostra as janelas do Designer:

1. Barra de Status
2. Navegador
3. Sada
4. Espao de Trabalho

Captulo 1: Usando o Designer

A figura a seguir mostra a janela Viso geral:

Os objetos dentro da estrutura de tpicos so exibidos no espao de trabalho. Os objetos preenchidos com
cor so selecionados no espao de trabalho.

Configurao das Opes do Designer


Voc pode configurar como o Designer exibir as informaes gerais, tabelas e ferramentas. O Designer
permite especificar as opes de exibio, incluindo a cor do plano de fundo das ferramentas, a organizao
das janelas do navegador e a origem usada nas diversas ferramentas. Voc tambm pode especificar as
outras opes, como a importao das chaves primrias pelo Source Analyzer. Algumas alteraes exigem a
reinicializao do Designer para que as alteraes sejam aplicadas. O Designer o avisa se precisar reiniciar
o programa.
Voc pode configurar as seguintes opes no Designer:

Geral. Opes de exibio geral, importao de XML import, diretrios de arquivo e a organizao da
janela Navegador.

Tabelas. Voc pode configurar as colunas, o tamanho e o comportamento de definies de tabela.

Formato. Cor, origem e outras opes de formato das ferramentas do Designer.

Depurao. Opes de exibio e de TCP/IP do Depurador.

Servios da Web. Opes de compatibilidade com a verso anterior e a criao de WSDL para Hub de
Servios da Web.

Diversos. Funes disponveis do Assistente de cpia e check-outs.

Configurando Opes Gerais


possvel configurar opes gerais das janelas Navegador e Exibir, alm de diretrios.
Para configurar opes gerais:
1.

Clique em Ferramentas >Opes.

2.

Clique na guia Geral.

Configurao das Opes do Designer

3.

Voc pode configurar as seguintes opes gerais:


Opo geral

Descrio

Recarregar Tabelas/
Mapeamentos ao Abrir
uma Pasta

Recarrega a ltima exibio de uma ferramenta quando voc a abre. Por


exemplo, se voc estiver com um mapeamento aberto ao se desconectar de
um repositrio, o mapeamento ser exibido na prxima vez que voc abrir a
pasta e o Mapping Designer.

Perguntar Antes de
Recarregar Tabelas/
Mapeamentos

Aparece somente quando voc seleciona Reload Tables/Mappings when


Opening a Folder (Recarregar Tabelas/Mapeamentos ao Abrir uma Pasta).
Selecione para que o Designer solicite que voc recarregue objetos sempre
que abrir uma pasta.

Exibir Nomes de
Ferramentas nas
Visualizaes

Exibe o nome da ferramenta no canto superior esquerdo do espao de


trabalho ou pasta de trabalho.

Atrasar Panoramas da
Janela de Viso Geral

Por padro, quando voc arrasta o foco da janela Viso Geral, o foco da
pasta de trabalho se move simultaneamente. Quando voc seleciona essa
opo, o foco do espao de trabalho no alterado at que voc solte o
boto do mouse.

Receber Notificaes do
Servio de Repositrio

possvel receber mensagens de notificao no Designer e exibi-las na


janela Sada. As mensagens de notificao incluem informaes sobre
objetos que outro usurio cria, modifica ou exclui. Voc recebe notificaes
sobre mapeamentos, mapplets, atalhos, definies de origem, definies de
destino e transformaes. O Servio de Repositrio envia notificaes sobre
alteraes para que voc saiba que os objetos com os quais est trabalhando
podem estar desatualizados. Para que o Designer receba uma notificao, a
pasta que contm o objeto deve estar aberta no Navegador. Para que o
Designer receba uma notificao de um objeto excludo ou modificado, o
objeto deve estar aberto no espao de trabalho. Voc tambm recebe
notificaes criadas pelo usurio publicadas pelo usurio que gerencia o
Servio de Repositrio. Por padro, essa opo fica habilitada.

Salvar Todos os Dados


MX

Salva todos os dados MX quando voc salva mapeamentos no Designer.


Selecione essa opo para usar exibies MX de ferramentas de repositrio
de terceiros.
Quando voc salva dados MX para mapeamentos, o PowerCenter cria uma
expresso de campo para cada campo de destino nos mapeamentos. Essas
expresses so diferentes das expresses de transformao que voc cria no
Editor de Expresso.
O padro desabilitado.
Nota: O salvamento de dados MX pode influenciar o desempenho do
repositrio. Use essa opo somente quando desejar usar exibies MX.

Salvar Somente
Dependncias de Origem/
Destino

Captulo 1: Usando o Designer

Salva apenas os dados MX relacionados dependncia quando voc salva


mapeamentos no Designer. Selecione essa opo se voc no precisar exibir
expresses de campos em exibies MX, mas se voc usa o Repository
Manager para exibir dependncias de origem/destino. O padro
desabilitado.

Opo geral

Descrio

Group Source by
Database (Agrupar
Origem por Banco de
Dados)

Exibe origens agrupadas por banco de dados no Navegador. Caso contrrio,


as origens aparecem em ordem alfabtica por nome de origem, com o nome
do banco de dados em parnteses.

Exibir Origens Usando


Nomes Comerciais

Exibe origens por nomes comerciais no Navegador. Se voc habilitar a opo


para exibir origens por nomes comerciais, o Navegador exibir primeiramente
os nomes comerciais e, em seguida, o nome do tipo de origem e o nome da
tabela em parnteses.

Exibir Destinos Usando


Nomes Comerciais

Exibe destinos por nomes comerciais no Navegador. Se voc habilitar a


opo para exibir destinos por nomes comerciais, o Navegador exibir
primeiramente os nomes comerciais e, em seguida, o nome do tipo de destino
e o nome da tabela em parnteses.

Arquivo de Espao de
Trabalho

O diretrio de arquivos de espao de trabalho criados pelo Designer. Os


arquivos de espao de trabalho mantm a origem ou destino aberto mais
recentemente ou o ltimo mapeamento salvo. Esse diretrio deve ser local
para evitar corromper ou substituir arquivos por vrios usurios. Por padro, o
Designer cria arquivos no diretrio de instalao.

Caminho de
Documentao HTML ou
URL

O caminho de HTML ou URL para inserir links para a documentao


comercial.

Configurao de Opes de Tabelas


Voc pode configurar as colunas, o tamanho e o comportamento de definies de tabela.
Para configurar opes de definio de tabela:
1.

Clique em Ferramentas >Opes.

2.

Clique na guia Tabelas.

3.

Na lista Tabelas, selecione o objeto de repositrio que deseja configurar.


A seo Colunas lista os parmetros de exibio disponveis para cada objeto de repositrio. Use as
setas para cima e para baixo para alterar a ordem de exibio das colunas.

4.

Voc pode configurar as seguintes opes para o tipo de objeto selecionado:


Opo de tabelas

Disponibilidade de
ferramenta

Descrio

Largura padro das


colunas

Todas as
ferramentas

Largura padro das colunas da tabela em bytes.

Colunas disponveis

Todas as
ferramentas

As colunas disponveis para exibio quando o objeto de


repositrio estiver no tamanho mximo.

Configurao das Opes do Designer

Opo de tabelas

Disponibilidade de
ferramenta

Descrio

Colunas
selecionadas

Todas as
ferramentas

As colunas que aparecem no Designer quando o objeto de


repositrio est no tamanho mximo. Para exibir uma
coluna, selecione-a na lista Colunas Disponveis e clique
no boto de seta dupla para mover a coluna na lista
Colunas Selecionadas. Voc tambm pode excluir colunas
e alterar a ordem em que so exibidas.

Ferramentas

Todas as
ferramentas

Selecione a ferramenta do Designer que deseja configurar.

Importar Chaves
Primrias

Source Analyzer e
Target Designer

O Designer importa chaves primrias para definies de


destino ou de origem relacional.

Importar chaves
estrangeiras

Source Analyzer e
Target Designer

O Designer importa chaves estrangeiras para definies de


destino ou de origem relacional.

Criar Qualificador de
origem ao abrir
origens

Mapping Designer e
Mapplet Designer

O Designer cria um Qualificador de origem ou uma


transformao Normalizador para cada origem que voc
adiciona ao mapeamento. Limpe a opo para criar
manualmente todos os Qualificadores de origem e
Normalizadores. Talvez voc queira criar um Qualificador
de origem manualmente quando us-lo para associar
tabelas relacionais.

Use Nomes
Comerciais como
Nomes de Coluna
para o Qualificador
de origem

Mapping Designer e
Mapplet Designer

O Qualificador de Origem usa nomes comerciais como


nomes de colunas.

Largura Padro
Geral

Todas as
ferramentas

Largura padro de todos os objetos do repositrio.

Altura Padro Geral

Todas as
ferramentas

Altura padro de todos os objetos do repositrio.

Mostrar dicas de
ferramentas

Todas as
ferramentas

Mostra o nome do objeto de repositrio ou da coluna


quando voc move o ponteiro sobre uma coluna ou barra
de ttulos de um objeto. Quando selecionada, essa opo
tambm exibe nomes comerciais quando voc move o
ponteiro do mouse sobre o cone na barra de ttulos de um
objeto. Esta opo se aplica a todos os objetos de
repositrio.

Algumas opes na guia Tabelas estaro desabilitadas dependendo da ferramenta que voc selecionar
para editar. Clique em Redefinir Tudo para reverter as opes dessa guia para as configuraes padro.
5.

Repita as etapas 3 a 4 para cada tipo de objeto de repositrio que voc deseja configurar.

Configurao de Opes de Formato


Voc pode configurar a cor, origem e outras opes de formato em cada ferramenta no Designer.
Para configurar as opes de formato:
1.

Clique em Ferramentas >Opes.

Captulo 1: Usando o Designer

2.

Clique na guia Formato.

3.

Para aplicar um tema de cor, clique em Selecionar tema.

4.

Na seo Cores do espao de trabalho, selecione uma ferramenta do Designer no menu Ferramentas,
para configurar as cores do espao de trabalho.

5.

Selecione um elemento do espao de trabalho e clique em Cor para alterar a cor do elemento.
Os elementos na seo Cores do espao de trabalho dependem da ferramenta que voc selecionar
para configurar. Voc pode configurar a cor dos seguintes elementos:

6.

Elemento

Disponibilidade de
ferramenta

Descrio

Segundo plano

Todas as ferramentas

Plano de fundo do espao de trabalho.

Texto em primeiro
plano

Todas as ferramentas

Texto exibido no espao de trabalho.

Seleo de link

Source Analyzer,
Target Designer,
Mapplet Designer,
Mapping Designer

Link selecionado entre objetos de repositrio no


espao de trabalho.

Link de relacionamento

Source Analyzer,
Target Designer,
Mapplet Designer,
Mapping Designer

Link que mostra o relacionamento da chave primria/


externa entre duas tabelas.

Link de propagao

Mapplet Designer,
Mapping Designer

Link afetado pela propagao de atributo de porta.

Link de fluxo de dados

Mapplet Designer,
Mapping Designer

Link entre portas de objetos de repositrio em um


mapplet ou mapeamento no espao de trabalho.

Link de fluxo de
metadados

Mapplet Designer,
Mapping Designer

Link entre uma transformao Qualificador de origem


MQ e a origem associada.

Na seo Cores da barra de ttulo, selecione um tipo de objeto no menu Tabelas para configurar as
cores da barra de ttulo e do plano de fundo.
Voc pode configurar as seguintes cores:
Opo

Descrio

Primeiro plano

Cor do texto da barra de ttulo da tabela.

Segundo plano

Cor do plano de fundo da barra de ttulo da tabela.

Segundo plano(2)

Cor do segundo plano de fundo da barra de ttulo da tabela. Voc pode combinar
duas cores de plano de fundo para criar um gradiente de cor na barra de ttulo
do objeto de repositrio. Escolha a mesma cor para Segundo plano e Segundo
plano(2), se voc no quiser um gradiente de cor.

Configurao das Opes do Designer

7.

Na seo Origens, selecione um componente do Designer no menu Categorias para exibir ou alterar
suas origens.
O campo Origem atual mostra a origem do componente Designer selecionado no momento. Clique em
Alterar para alterar a exibio da origem e do script de idioma do componente Designer selecionado no
menu Categorias. Se a pgina de cdigo do cliente PowerCenter for diferente da pgina de cdigo do
arquivo de origem, talvez voc queira fazer alteraes.

Uso de Temas de Cores


Use temas de cor para selecionar rapidamente as cores dos elementos do espao de trabalho nas
ferramentas do Designer. Ao aplicar um tema de cor, voc atualiza coletivamente as cores dos elementos do
espao de trabalho em todas as ferramentas Designer. possvel escolher entre os seguintes temas de
cores padro:

Clssico da Informatica. Esse o esquema de cores padro de elementos do espao de trabalho. O


plano de fundo do espao de trabalho cinza, o texto do espao de trabalho branco e as cores dos
links so azul, vermelho, azul acinzentado, verde escuro e preto.

Preto em alto contraste. Cores de link brilhantes se destacam do plano de fundo preto. O plano de
fundo do espao de trabalho preto, o texto do espao de trabalho branco e as cores dos links so
prpura, vermelho, azul claro, verde brilhante e branco.

Planos de fundo coloridos. Cada ferramenta Designer tem um plano com fundo de espao de trabalho
em cor pastel distinto. O texto do espao de trabalho preto e as cores dos links so as mesmas do
tema de cor Clssico da Informtica.

Aps selecionar um tema de cor para as ferramentas do Designer, ser possvel modificar a cor de
elementos individuais do espao de trabalho. Alteraes feitas em elementos individuais no aparecem na
seo Visualizar da caixa de dilogo Theme Selector (Seletor de Temas).
Para selecionar um tema de cor para ferramentas Designer:
1.

No Designer, clique em Ferramentas > Opes.

2.

Clique na guia Formato.

3.

Na seo Temas de Cores da guia Formato, clique em Selecionar Tema.

4.

Selecione um tema no menu Tema.

5.

Clique nas guias na seo Visualizar para ver como os elementos do espao de trabalho so exibidos
em cada uma das ferramentas do Designer.

6.

Clique em OK para aplicar o tema de cor.

Configurando as Opes de Depurao


Voc pode configurar as opes de exibio e TCP/IP do Depurador na guia Depurar.
Para configurar as opes de Depurao:

1.

Clique em Ferramentas >Opes.

2.

Clique na guia Depurar.

Captulo 1: Usando o Designer

3.

Voc pode configurar as seguintes opes para o Depurador:


Opo

Descrio

Exibio dos
dados

Selecione as informaes para exibir nas janelas Dados do Destino e Dados da


Instncia.

TCP/IP

Selecione uma porta TCP/IP especfica, ou um intervalo de portas para a conexo do


Designer ao Servio de Integrao.

Configurao de Opes de Servio da Web


Voc pode configurar opes de servio da web na guia WebService.
Para configurar opes do servio da web:
1.

Clique em Ferramentas >Opes.

2.

Clique na guia WebService.

3.

Voc pode configurar as seguintes opes para os servios da web.


Opo

Descrio

Criar grupos separados para


portas de cabealho e
mensagem

Indica se ir ou no criar exibies XML separadas para as portas de


mensagem e cabealho quando voc adiciona portas de mensagem s
definies de origem e destino do servio da web. Se voc criar grupos
separados para as portas de mensagem e cabealho, o Designer cria
uma exibio para a ID da mensagem e outra para as portas de
cabealho.
As definies de origem e destino do servio da web, que incluem portas
de mensagem e cabealho em exibies separadas, correspondem ao
formato das verses prvias dessas definies. Esta opo fornecida
para a compatibilidade com verses anteriores ao PowerCenter verso
8.1.x.

Criar destinos separados para


falhas

Indica se ir ou no criar definies de destino separadas para respostas


de falha. Se voc criar definies de destino separadas para respostas de
falha, o Designer cria uma definio de destino para cada falha na
mensagem de sada. Os destinos do servio da web que incluem uma
definio separada para cada falha na mensagem de sada correspondem
ao formato de verses prvias das definies de destino do servio da
web. Esta opo fornecida para a compatibilidade com verses
anteriores ao PowerCenter verso 8.1.x.

Criar WSDL

Indica se ir ou no gerar o WSDL para mapeamentos gerados a partir de


origens ou destinos relacionais ou de arquivo simples, transformaes ou
mapplets. Se voc gerar um mapeamento do servio da web sem um
WSDL, o Designer pode gerar o WSDL depois que voc cria o
mapeamento. Clique no boto procurar para selecionar o diretrio no qual
o Designer cria os arquivos WSDL. O nome do arquivo WSDL o nome
do mapeamento com uma extenso .wsdl.

Configurao de Opes Diversas


Voc pode configurar as opes Copiar Assistente e controle de verso na guia Diversos.

Configurao das Opes do Designer

Para configurar as opes Diversas:


1.

Clique em Ferramentas >Opes.

2.

Clique na guia Diversos.

3.

Voc pode configurar as seguintes opes:


Opo

Descrio

Gerar Nome Exclusivo


Quando Resolvido para
"Renomear"

Gera nomes exclusivos para objetos copiados se voc selecionar o opo


Renomear na janela Assistente de Cpia Por exemplo, se o objeto de
origem s_customers tiver o mesmo nome de uma origem na pasta de
destino, a opo Renomear gera o nome exclusivo s_customers1.

Mostrar Imagem de Checkout


no Navegador

Exibe o cone Check Out quando voc faz o check-out de um objeto.

Permitir Excluso sem Checkout

possvel excluir objetos de repositrio com verso sem primeiro fazer o


seu check-out. Porm, voc no pode excluir um objeto cujo check-out
tenha sido feito por outro usurio. Se voc selecionar essa opo, o
Servio de Repositrio far check-out de um objeto quando voc o
excluir.

Fazer Check-In de Objetos


Excludos Automaticamente
Depois de Salvos

Faz o check-in de objetos excludos depois que voc salva as alteraes


no repositrio. Quando voc desmarca essa opo, o objeto excludo
permanece em check-out e voc deve fazer check-in dele a partir da
exibio de resultados.

Redefinir Tudo

Redefine todas as opes Diversos com os valores padro.

Usando Barras de Ferramentas


As barras de ferramentas permitem selecionar ferramentas e tarefas rapidamente. Voc pode configurar as
barras de ferramentas que deseja exibir ou ocultar. Tambm possvel criar uma nova barra de ferramentas
e adicionar ou remover os botes.

Barras de Ferramentas do Designer


O Designer pode ser configurado para exibir as seguintes barras de ferramentas:

10

Padro. Contm botes para conectar e desconectar de repositrios e pastas e alternar exibies e
colunas.

Repositrio. Contm botes para conexo e desconexo de repositrios e pastas, exportao e


importao de objetos, salvamento de alteraes e impresso do espao de trabalho.

Exibir. Contm botes para configurar barras de ferramentas, alternar janelas, alternar para o modo de
tela cheia, alterar o modo de exibio da rea de trabalho e exibir propriedades.

Esquema. Contm botes para gerar cones e organizar objetos do repositrio, copiar, vincular e mover
colunas e aplicar mais ou menos zoom na rea de trabalho.

Mapeamentos/Mapplets. Contm botes para criar, editar e analisar mapeamentos e mapplets.

Transformaes. Contm botes para criar transformaes.

Transformaes avanadas. Contm botes para criar transformaes avanadas.

Captulo 1: Usando o Designer

Criao de verses. Contm botes para fazer check-in em objetos, desfazer check-outs, localizar
check-outs, exibir o histrico, desfazer rtulos e gerenciar consultas.

Depurador. Contm botes para iniciar, parar e continuar o Depurador.

Ferramentas. Contm botes para conectar aos outros aplicativos do Cliente PowerCenter. Quando voc
usa o boto Ferramentas para abrir outro aplicativo do Cliente PowerCenter, o PowerCenter usa a
mesma conexo de repositrio para se conectar ao repositrio e abre as mesmas pastas.

Se voc no visualizar todos os botes da barra de ferramentas, poder configur-la.

Barras de Ferramentas do Workflow Manager


O Workflow Manager pode exibir as seguintes barras de ferramentas para ajudar voc a selecionar
ferramentas e executar operaes rapidamente:

Padro. Contm botes para conectar e desconectar de repositrios e pastas, alternar janelas, aplicar
mais e menos zoom, usar a exibio panormica no espao de trabalho e localizar objetos.

Conexes. Contm botes para criar e editar conexes, servios e grades de servidor.

Repositrio. Contm botes para conectar, desconectar de e adicionar repositrios, abrir pastas, fechar
ferramentas, salvar alteraes em repositrios e imprimir o espao de trabalho.

Exibio. Voc pode personalizar barras de ferramentas, alternar a barra de status e as janelas, alternar
a exibio de tela inteira criar uma nova pasta de trabalho e exibir as propriedades de objetos.

Esquema. Contm botes para organizar objetos no espao de trabalho, localizar objetos, aplicar mais e
menos zoom e usar a exibio panormica no espao de trabalho.

Tarefas. Contm botes para criar tarefas.

Fluxo de trabalho. Contm botes para editar as propriedades do fluxo de trabalho.

Executar. Contm botes para programar o fluxo de trabalho, iniciar o fluxo de trabalho ou iniciar uma
tarefa.

Criao de verses. Contm botes para fazer check-in de objetos, desfazer check-outs, comparar
verses, listar objetos com check-out realizado e listar consultas de repositrio.

Ferramentas. Contm botes para conectar aos outros aplicativos do Cliente PowerCenter. Quando voc
usa o boto Ferramentas para abrir outro aplicativo do Cliente PowerCenter, o PowerCenter usa a
mesma conexo de repositrio para se conectar ao repositrio e abre as mesmas pastas. Por padro, o
PowerCenter exibe a barra de ferramentas Ferramentas.

Barras de ferramentas do Workflow Monitor


O Workflow Monitor pode exibir as seguintes barras de ferramentas para ajudar voc a executar operaes
rapidamente:

Padro. Contm botes para conectar e desconectar de repositrios, imprimir, exibir visualizaes de
impresso, pesquisar o espao de trabalho, mostrar ou ocultar o navegador na exibio de tarefas e
mostrar ou ocultar a janela de sada.

Servio de Integrao. Contm botes para conectar e desconectar dos Servios de Integrao, fazer
ping para o Servio de Integrao e executar operaes de fluxo de trabalho.

Exibio. Contm botes para configurar incrementos de tempo e mostrar propriedades, registros de
fluxo de trabalho ou registros de sesso.

Filtros. Contm botes para exibir as execues mais recentes e para filtrar tarefas, Servios de
Integrao e pastas.

Usando Barras de Ferramentas

11

Barras de Ferramentas do Repository Manager


Por padro, o Repository Manager exibe as barras de ferramentas a seguir:

Padro. Contm botes para se conectar e desconectar dos repositrios, exibir dependncias dos
objetos selecionados, pesquisar por palavra-chave, exibir as propriedades dos objetos, fechar a janela
Dependncia e alternar entre as janelas Navegador e Sada.

Ferramentas. Contm botes para conectar aos outros aplicativos do Cliente PowerCenter. Quando voc
usa o boto Ferramentas para abrir outro aplicativo do Cliente PowerCenter, o PowerCenter usa a
mesma conexo de repositrio para se conectar ao repositrio e abre as mesmas pastas.

Exibio de uma Barra de Ferramentas


Voc pode configurar uma barra de ferramentas para exibir todas as vezes. Voc pode configurar as barras
de ferramentas para que elas sejam exibidas no Designer, no Workflow Manager e no Workflow Monitor.
Para exibir uma barra de ferramentas:
1.

Clique em Ferramentas > Personalizar.

2.

Na guia Barra de ferramentas, selecione as barras de ferramentas que voc deseja exibir.

3.

Para mostrar as dicas de ferramentas enquanto mantm o ponteiro sobre um boto da barra de
ferramentas, selecione Mostrar dicas de ferramentas.

4.

Clique em OK.

Criao de uma Barra de Ferramentas


Voc pode criar uma nova barra de ferramentas e escolher os botes. Voc pode criar barras de ferramentas
no Designer, no Workflow Manager e no Workflow Monitor.
Para criar uma nova barra de ferramenta:
1.

Clique em Ferramentas > Personalizar.

2.

Na guia Barra de ferramentas, clique em Nova.

3.

Insira um nome para a nova barra de ferramentas e clique em OK.


Uma nova barra de ferramentas flutuante exibida, e o nome dela aparece na lista.

4.

Clique na guia Comandos.

5.

Selecione uma barra de ferramentas na lista Categorias para exibir os botes disponveis.

6.

Arraste qualquer boto da rea Botes para a barra de ferramentas flutuante.

7.

Clique em OK quando terminar de criar a barra de ferramentas.

Configurando uma Barra de Ferramentas


Para configurar uma barra de ferramentas, adicione ou remova botes da barra. Voc pode configurar barras
de ferramentas para que elas sejam exibidas no Designer, no Workflow Manager e no Workflow Monitor.
Para configurar uma barra de ferramentas:
1.

Clique em Ferramentas > Personalizar.

2.

Certifique-se de ter selecionado a barra de ferramentas que deseja configurar.


A barra de ferramentas exibida.

3.

12

Para remover um boto da barra de ferramentas, arraste-o para a caixa de dilogo Personalizar.

Captulo 1: Usando o Designer

4.

Para adicionar um boto, clique na guia Comandos.

5.

Selecione uma barra de ferramentas na lista Categorias para exibir os botes disponveis.

6.

Arraste qualquer boto da rea Botes para a barra de ferramentas personalizada.

7.

Clique em OK quando terminar de personalizar a barra de ferramentas.

Adicionando Ferramentas Personalizadas


O Designer permite adicionar ferramentas personalizadas ao menu Ferramentas. Voc pode iniciar
programas que usa com frequncia de dentro do Designer. Por exemplo, voc pode iniciar o Business
Objects Designer (Designer de Objetos de Negcios) ou um navegador da Web de dentro do Designer.
Ao adicionar ferramentas personalizadas, o Designer acrescenta os nomes das ferramentas parte inferior
do menu Ferramentas. Para iniciar uma ferramenta, clique no menu Ferramentas e selecione a ferramenta
personalizada.
Voc pode adicionar, excluir e reorganizar a ordem das ferramentas personalizadas. Clique em Ferramentas
> Personalizar e clique na guia Ferramentas.
A lista Contedo do Menu exibe as ferramentas personalizadas. O Designer coloca os nomes das
ferramentas na parte inferior do menu Ferramentas na ordem em que aparecem nessa lista.
Para adicionar uma ferramenta personalizada:
1.

Clique no boto Adicionar Ferramenta Personalizada.


Voc pode adicionar at nove ferramentas ao menu Ferramentas.

2.

No campo Contedo do Menu, insira um nome exclusivo para a ferramenta personalizada. O Designer
exibe esse nome no menu Ferramentas.
Sugesto: Digite um E comercial (&) antes de um caractere do nome da ferramenta para usar esse
caractere como tecla de acesso rpido.

3.

Use os botes de seta para colocar a nova ferramenta na posio adequada no menu Ferramentas.

4.

Insira as seguintes informaes da ferramenta:


Opo

Descrio

Comando

Nome e caminho do arquivo executvel da ferramenta. Clique no boto Procurar para


selecionar o arquivo executvel.

Argumentos

Argumentos que o Designer passa para a ferramenta personalizada. Os argumentos


so opcionais ou obrigatrios, dependendo da ferramenta.
Se voc deseja que o Designer solicite argumentos ao iniciar a ferramenta
personalizada, selecione Solicitar Argumentos.

Diretrio Inicial.

5.

Diretrio em que a ferramenta personalizada deve iniciar. Se voc no inserir um


diretrio inicial, o Designer usar o diretrio executvel do programa da ferramenta
personalizada.

Clique em OK.

Adicionando Ferramentas Personalizadas

13

Navegando no Espao de Trabalho


Ao exibir ou editar objetos de repositrio no espao de trabalho, conclua as seguintes tarefas para navegar
com facilidade no espao de trabalho:

Pesquise colunas ou portas.

Redimensione objetos de repositrio.

Aplique mais ou menos zoom fora do espao de trabalho.

Ferramentas de Pesquisa
O Designer inclui as ferramentas Localizar Prximo e Localizar na rea de Trabalho para ajud-lo a localizar
colunas ou portas nos objetos de repositrio ou strings na janela de sada.

Localizar Prximo
Use a ferramenta Localizar prximo para pesquisar uma coluna ou nome de porta em:

Transformaes

Mapplets

Definies de origem

Definies de destino

Com a ferramenta Localizar prximo, voc pode pesquisar um objeto de cada vez. No possvel pesquisar
vrios objetos ao mesmo tempo. Use Localizar prximo em cada ferramenta do Designer. Selecione uma
transformao simples ou clique na janela Sada antes de fazer a pesquisa.
O Designer salva as 10 ltimas strings pesquisadas na caixa Localizar prximo na barra de ferramentas
Padro.
Para localizar um nome de coluna ou de porta:
1.

Selecione a transformao, mapplet, origem ou destino, ou clique na janela Sada.

2.

Digite o texto que voc deseja pesquisar na caixa Localizar na barra de ferramentas Padro. Por
exemplo, voc poderia digitar end para localizar a coluna de endereo.
Sugesto: A pesquisa no diferencia maisculas e minsculas.

3.

Clique em Editar > Localizar prximo, clique no boto Localizar prximo ou pressione Enter para
pesquisar a string.
O Designer localiza a primeira ocorrncia da pesquisa de string.
Sugesto: Voc tambm pode pressionar a tecla F3 para procurar pela string.

4.

Pressione Enter novamente para procurar pela prxima ocorrncia da pesquisa de string. O Designer
pesquisa cada nome de porta ou coluna na transformao e a encapsula na parte superior da
transformao at localizar uma correspondncia.

Localizar no Espao de Trabalho


possvel pesquisar uma string nas guias Salvar, Gerar ou Validar na janela Sada. A ferramenta Localizar
no Espao de Trabalho pesquisa um nome de campo ou de transformao em todas as transformaes no
espao de trabalho.
A ferramenta Localizar no Espao de Trabalho permite pesquisar nomes de porta ou de transformao em
todas as transformaes no espao de trabalho. possvel pesquisar por coluna ou nomes de portas ou de

14

Captulo 1: Usando o Designer

tabelas que correspondam sequncia de pesquisa. Voc pode especificar se a pesquisa deve ser realizada
em todos os nomes no espao de trabalho ou no nome comercial de uma tabela, coluna ou porta. Tambm
possvel optar por pesquisar correspondncias de palavras inteiras ou de maisculas e minsculas na
sequncia de pesquisa.
Para localizar um nome de coluna, porta ou transformao no espao de trabalho:
1.

Em uma ferramenta do Designer, clique no boto Localizar no Espao de Trabalho ou clique em Editar >
Localizar no Espao de Trabalho.
A caixa de dilogo Localizar no Espao de Trabalho aberta.

2.

3.

Escolha pesquisar em nomes de campo ou de tabela que correspondam ao texto de pesquisa.


Opo Pesquisar
em

Descrio

Campos

O Designer pesquisa nomes de coluna ou porta que correspondam ao texto de


pesquisa.

Tabelas

O Designer pesquisa nomes de tabela que correspondam ao texto de pesquisa.

Especifique a sequncia de pesquisa no campo de entrada Localizar ou selecione uma sequncia de


pesquisa na lista.
O Designer salva as ltimas 10 strings de pesquisa na lista.

4.

5.

6.

Especifique se deseja pesquisar por correspondncias com o texto de pesquisa entre todos os nomes
ou nomes comerciais.
Opo Localizar em

Descrio

Nomes

O Designer pesquisa em todos os nomes de tabelas, colunas ou portas no


espao de trabalho.

Nomes Comerciais

O Designer pesquisa em todos os nomes comerciais de tabelas, colunas ou


portas no espao de trabalho.

Especifique os critrios de pesquisa.


Opo Pesquisar

Descrio

Pesquisar em todas as
Tabelas

Selecione essa opo para pesquisar em todas as tabelas no espao de trabalho.


Se voc no selecionar essa opo, o Designer pesquisa em todas as tabelas
selecionadas atualmente no espao de trabalho. Essa opo fica selecionada
quando voc pesquisa por nomes de tabelas que correspondam sequncia de
pesquisa.

Coincidir Somente
Palavra Inteira

Selecione essa opo para localizar nomes ou nomes comerciais que


correspondam string especificada.

Diferenciar Maisculas
de Minsculas

Selecione essa opo se desejar pesquisar por strings que correspondam


maisculas e minsculas da sequncia de pesquisa especificada.

Clique em Localizar Agora.


Todas as correspondncias aparecem na tabela na parte inferior da caixa de dilogo Localizar no
Espao de Trabalho.

Navegando no Espao de Trabalho

15

7.

Clique em Fechar.

Criando cones e Restaurando Objetos do Espao de Trabalho


Cada ferramenta do Designer exibe objetos diferentes no espao de trabalho. possvel exibir definies de
origem, definies de destino, transformaes, mapplets ou mapeamentos inteiros, dependendo de qual
ferramenta est aberta. O Designer pode exibir objetos de repositrio nas seguintes formas:

Normal. O Designer exibe as informaes de cada objeto nas colunas. O Designer exibe objetos
normalmente por padro.

Iconizada. O Designer reduz objetos para um cone nomeado. possvel criar cone de objetos ao
trabalhar com grandes mapeamentos. Voc pode exibir as descries associadas aos objetos iconizados,
mantendo o ponteiro sobre o cone.

Zoom. O Designer altera o nvel de ampliao dos objetos normais e iconizados no espao de trabalho,
quando voc usa o recurso de zoom. Voc pode aplicar nveis de ampliao de 30 a 100% em
incrementos de 10%.

Criando cone de Objetos do Espao de Trabalho


Voc pode criar um cone de objetos no espao de trabalho.
Para gerar cones de objetos do espao de trabalho:
1.

Selecione o objeto no espao de trabalho.


Para selecionar mais de um objeto, clique com a tecla Shift ou com a tecla Ctrl pressionada em vrios
objetos. Tambm possvel selecionar vrios objetos, clicando em Editar > Selecionar Tudo ou
arrastando um retngulo em torno desses objetos.

2.

Clique em Layout > Organizar todos os Icnicos.


Sugesto: Voc tambm pode clicar com o boto direito do mouse e selecionar Organizar todos os
Icnicos.

Restaurando Objetos do Espao de Trabalho


Voc pode restaurar objetos em forma de cone ao tamanho normal.
Para restaurar objetos em forma de cone do espao de trabalho ao tamanho normal:
1.

Selecione o objeto.
Para selecionar mais de um objeto, clique com a tecla Shift ou com a tecla Ctrl pressionada em vrios
objetos.
Tambm possvel selecionar vrios objetos, clicando em Editar > Selecionar Tudo ou arrastando um
retngulo em torno desses objetos.

2.

Clique em Layout > Organizar.


Sugesto: Tambm possvel restaurar um objeto, clicando duas vezes no objeto em forma de cone,
ou clicando com o boto direito do mouse no objeto e selecionando Organizar.

Organizando Objetos do Espao de Trabalho


possvel exibir pipelines especficos no Mapping Designer.
possvel exibir pipelines especficos no Mapping Designer:
1.

16

Clique em Layout > Organizar.

Captulo 1: Usando o Designer

2.

Selecione pipelines por destino.


Voc pode selecionar a opo Icnico para exibir pipelines organizados em forma de cone.

3.

Clique em OK.

Zoom no Espao de Trabalho


Voc pode aumentar e diminuir o zoom do espao de trabalho. Use as opes da barra de ferramentas ou
do menu Layout para definir os nveis de zoom. A barra de ferramentas possui as seguintes opes de
zoom:

Boto Mais 10% de zoom. Usa um ponto que voc selecionou como o ponto central a partir do qual voc
deseja aumentar a ampliao atual em incrementos de 10 por cento.

Boto Menos 10% de zoom. Usa um ponto que voc selecionou como o ponto central a partir do qual
voc deseja diminuir a ampliao atual em incrementos de 10 por cento.

Mais zoom com base em retngulo. Aumenta a ampliao atual da rea retangular selecionada. O grau
de ampliao depende do tamanho da rea selecionada, do tamanho da rea de trabalho e da ampliao
atual.

Lista suspensa. Mantm o ponto central do espao de trabalho e define o nvel de zoom para o
percentual que voc selecionou na lista.

Dimensionar para ajustar. Dimensiona todos os objetos do espao de trabalho para ajust-los ao
espao de trabalho.

O menu Layout possui as seguintes opes de zoom:

Centro do zoom. Mantm o ponto central do espao de trabalho e aplica mais ou menos zoom em
incrementos de 10 por cento.

Ponto do zoom. Usa um ponto que voc selecionou como o ponto central a partir do qual ser aplicado
mais ou menos zoom em incrementos de 10 por cento.

Retngulo de zoom. Aumenta a ampliao atual da rea retangular selecionada. O grau de ampliao
depende do tamanho da rea selecionada, do tamanho da rea de trabalho e da ampliao atual.

Zoom normal. Define o nvel de zoom para 100 por cento.

Dimensionar Para Ajustar. Dimensiona todos os objetos do espao de trabalho para ajust-los ao
espao de trabalho.

Percentual de zoom. Mantm o ponto central do espao de trabalho e define o nvel de zoom para o
percentual que voc escolher.

Quando voc adiciona objetos a um espao de trabalho, o Designer usa o nvel de ampliao dos outros
objetos. O Designer salva o nvel de zoom de cada ferramenta do Designer em uma pasta quando voc sai.

Exibindo o Espao de Trabalho


Voc pode maximizar a janela do espao de trabalho, clicando em Exibir > Tela Inteira. Voc pode ver a
barra de ferramentas Padro e a barra de ferramentas Transformao quando estiver no modo de exibio
em tela inteira. O modo de exibio de tela inteira oculta o menu, as janelas de sada e do navegador e a
barra de ttulo. Para usar o menu quando estiver no modo de tela inteira, aponte para qualquer lugar na
parte superior da tela para exibir o menu.
Para retornar para a exibio normal, clique no boto Fechar Tela Inteira ou pressione Esc.

Navegando no Espao de Trabalho

17

Tarefas do Designer
Voc pode concluir as tarefas a seguir em cada ferramenta Designer:

Adicionar um repositrio.

Imprimir o espao de trabalho.

Exibir a data e hora que um objeto foi salvo pela ltima vez.

Abrir ou fechar uma pasta.

Criar atalhos.

Fazer check-out de objetos de repositrio.

Pesquisar objetos de repositrio.

Inserir descries de objetos de repositrio.

Exibir verses antigas de objetos no espao de trabalho.

Reverter para uma verso do objeto salva anteriormente.

Copiar objetos.

Exportar e importar objetos de repositrio.

Trabalhar com vrios objetos, portas ou colunas.

Renomear portas.

Usar teclas de atalho.

Tambm possvel exibir as dependncias de objeto no Designer.

Adio de um Repositrio
Para editar um objeto de repositrio, adicione primeiro um repositrio no Navegador para poder acessar o
objeto. Para adicionar um repositrio no Navegador, clique em Repositrio > Adicionar. Use a caixa de
dilogo Adicionar Repositrios para adicionar o repositrio.

Impresso do Espao de Trabalho


Para imprimir o espao de trabalho:
u

Clique em Repositrio > Imprimir.

Voc tambm pode clicar com o boto direito do mouse no espao de trabalho e escolher Imprimir.

Configurao da Impresso do Espao de Trabalho


Para especificar um cabealho e um rodap para a sada de impresso do espao de trabalho:
u

Clique em Repositrio > Configurao de Pgina.

Visualizao da Impresso do Espao de Trabalho


Para visualizar o espao de trabalho antes de imprimir:
u

18

Clique em Repositrio > Visualizao de Impresso.

Captulo 1: Usando o Designer

Exibindo a Data/Hora do ltimo Salvamento


Voc pode exibir a data e a hora em que um objeto foi salvo pela ltima vez no repositrio. Para exibir a data
e a hora do "ltimo Salvamento", selecione o objeto no navegador e clique em Exibir > Propriedades.
Nota: As origens no tm a data e a hora do "ltimo Salvamento".
No Windows, use as Configuraes Regionais no Painel Controle para configurar o formato da data e da
hora do "ltimo Salvamento".

Abrindo e Fechando uma Pasta


Clique duas vezes em uma pasta para abrir uma pasta e ferramenta ao mesmo tempo. Ao clicar duas vezes
na pasta, o Designer abre a pasta no Navegador e exibe a ltima ferramenta ativa na pasta.
Tambem possvel selecionar uma pasta e, em seguida, escolher uma ferramenta para abrir um espao de
trabalho. Se voc selecionar a opo Recarregar Tabelas/Mapeamentos ao Abrir uma Pasta, o Designer
tambm exibe os ltimos objetos abertos quando essa ferramenta foi usada.
Por exemplo, se voc fechar uma pasta com o Source Analyzer ativo, na prxima vez em que abrir a pasta
usando o boto Abrir Pasta, o Designer exibe o Source Analyzer.
Para fechar uma pasta:
u

Selecione a pasta no Navegador e clique no boto Desconectar. Para fechar todas as pastas e
ferramentas abertas, clique em Repositrio > Fechar Todas as Ferramentas.

Criao de Atalhos
Para criar um atalho para um objeto em uma pasta compartilhada, arraste o objeto para a pasta de destino
ou o mapeamento. Por exemplo, para criar um atalho para uma origem, arraste a origem da pasta
compartilhada para o mapeamento que voc tem aberto no espao de trabalho. Tambm possvel criar um
atalho soltando a origem na pasta de destino. Para usar o novo atalho, arraste-o para o espao de trabalho.
Voc pode criar um atalho para uma pasta compartilhada no mesmo repositrio. Tambm possvel criar um
atalho em um repositrio local que aponte para a pasta compartilhada no repositrio global, contanto que
ambos os repositrios estejam no mesmo domnio.
A pasta de destino deve estar aberta, como na cpia de objetos.
Nota: No possvel criar atalhos para objetos em pastas no compartilhadas.

Fazendo Check-out e Check-in de Objetos com Verso


Quando voc trabalha com objetos com verso, necessrio fazer check-out do objeto para modific-lo e
salv-lo para confirmar as alteraes no repositrio. Fazer check-in de um objeto adicionar uma nova
verso ao histrico do objeto. Voc deve fazer check-in do objeto para permitir que outros usurios possam
alter-lo.

Tarefas do Designer

19

Pesquisa de Objetos
Use uma consulta de objeto para pesquisar objetos no repositrio que atendam s condies especificadas.
Quando voc executa uma consulta, o repositrio retorna resultados com base nessas condies.
conveniente criar uma consulta de objeto para executar as tarefas a seguir:

Rastrear objetos de repositrio durante o desenvolvimento. Voc pode adicionar os parmetros


Rtulo, Usurio, Salvo pela ltima Vez ou Comentrios s consultas para controlar objetos durante o
desenvolvimento.

Associar uma consulta a um grupo de implantao. Quando voc cria um grupo de implantao
dinmica, voc pode associar uma consulta de objeto a ele.

Para criar uma consulta de objeto, clique em Ferramentas > Consulta para abrir o Navegador de Consulta.
No Navegador de Consulta, voc pode criar, editar e excluir consultas. Tambm possvel configurar
permisses para cada consulta no Navegador de Consultas. Voc pode executar qualquer consulta para a
qual voc tenha permisses de leitura no Navegador de Consulta.

Inserindo Descries para Objetos de Repositrio


Voc pode inserir descries e comentrios de cada objeto de repositrio. possvel inserir uma quantidade
mxima de caracteres igual a 2.000 bytes/K. K o nmero mximo de bytes de um caractere da pgina de
cdigo de repositrio selecionada. Por exemplo, se a pgina de cdigo do repositrio estiver em japons, em
que K = 2, cada campo de descrio e comentrio permitir a insero de at 1.000 caracteres.

Exibindo e Comparando Objetos de Repositrio com Controle de


Verso
possvel exibir e comparar verses de objetos. Se um objeto possuir vrias verses, voc pode localizar as
verses do objeto na janela Exibir Histrico. Alm de comparar verses de um objeto em uma janela, voc
pode exibir as vrias verses de um objeto no espao de trabalho para compar-las graficamente.

Regras e Diretrizes para Exibir e Comparar Objetos de Repositrio com


Verso
Use as regras e diretrizes quando exibir verses mais antigas de objetos no espao de trabalho:

20

Voc no pode exibir simultaneamente vrias verses de objetos de composio, como mapeamentos e
mapplets.

Verses mais antigas de objetos de composio podem no incluir os objetos filhos que foram usados
quando foi feito o check-in do objeto de composio. Se voc abrir um objeto de composio que inclui
uma verso de objeto filho que analisada a partir do repositrio, a verso anterior do objeto filho ser
aberta no espao de trabalho como parte do objeto de composio. Por exemplo, voc deseja exibir a
verso 5 de um mapeamento que originalmente inclua a verso 3 de uma definio de origem, mas tal
verso 3 foi depurada do repositrio. Quando voc exibe a verso 5 do mapeamento, a verso 2 da
definio de origem aparece como parte do mapeamento.

Os objetos de atalho no so atualizados quando voc modifica os objetos que eles referenciam. Quando
voc abre um objeto de atalho, exibe a mesma verso do objeto que o atalho referenciava originalmente,
mesmo que existam verses subsequentes.

Captulo 1: Usando o Designer

Exibio de uma Verso mais Antiga de um Objeto de Repositrio


Para abrir uma verso mais antiga de um objeto no espao de trabalho:
1.

No espao de trabalho ou no Navegador, selecione o objeto e clique em Verso > Exibir Histrico.

2.

Selecione a verso que voc deseja exibir no espao de trabalho e clique em Ferramentas > Abrir no
Espao de Trabalho.
Nota: A verso mais antiga de um objeto somente leitura e o nmero da verso aparece como prefixo
antes do nome do objeto. Voc pode exibir simultaneamente vrias verses de um objeto que no seja
de composio no espao de trabalho.

Comparando Verses de um Objeto de Repositrio


Para comparar duas verses de um objeto:
1.

No espao de trabalho ou no Navegador, selecione um objeto e clique em Verso > Exibir Histrico.

2.

Selecione as verses que deseja comparar e clique em Comparar > Verses Selecionadas.
Para comparar uma verso do objeto com a verso prvia, selecione uma verso e clique em Comparar
> Verso Prvia.
Uma janela aparece, onde voc pode exibir informaes detalhadas sobre as duas verses do objeto.
Nota: Voc tambm pode acessar a janela Histrico da Exibio na janela Resultados da Consulta,
quando executar uma consulta.

Reverso para uma Verso de Objeto Prvia


Quando um objeto editado no Designer, voc pode revert-lo para uma verso salva anteriormente,
desfazendo mudanas inseridas desde a ltima vez que voc salvou. Voc pode reverter para verses de
vrios objetos salvas anteriormente, ao mesmo tempo.
Para reverter para uma verso de um objeto salva anteriormente:
1.

Abra um objeto no espao de trabalho.

2.

Selecione o objeto e clique em Editar > Reverter para Salvo.

3.

Clique em Sim. Se mais de um objeto for selecionado, clique em Sim para Todos.
O Designer remove todas as mudanas inseridas desde a ltima vez que o objeto foi salvo.

Copiando Objetos do Designer


possvel copiar objetos do Designer dentro da mesma pasta, para uma pasta diferente ou para outro
repositrio. Voc pode copiar qualquer objeto do Designer como origens, destinos, mapeamentos, mapplets,
transformaes e dimenses. preciso abrir a pasta de destino antes de poder copiar objetos para ela.
Use o Assistente de Cpia no Designer para copiar objetos. O Assistente de Cpia verifica os conflitos na
pasta de destino e fornece opes para resolv-los. Por exemplo, se um item j estiver presente na pasta de
destino, uma descrio do problema ser exibida na tela. O Assistente de Cpia exibe as resolues
possveis. Para um objeto duplicado voc pode renomear, reutilizar, substituir ou ignorar a cpia do objeto.
Para configurar definies e funes de exibio do Assistente de Cpia, clique em Ferramentas > Opes
no Designer.
possvel importar objetos de um arquivo XML atravs do Assistente de Importao no Designer.
O Assistente de Importao fornece as mesmas opes que o Assistente de Cpia para resolver conflitos.

Tarefas do Designer

21

Copiando Segmentos de Mapeamento


Voc pode copiar segmentos de mapeamentos e mapplets quando quiser reutilizar uma parte da lgica do
mapeamento. Um segmento consiste em um ou mais objetos em um mapeamento ou mapplet. Os objetos
podem ser origens, destinos, atalhos, transformaes e mapplets. Para copiar os segmentos do
mapeamento, selecione e copie os segmentos de um mapeamento e cole-os em um mapeamento de
destino. Voc pode colar os segmentos de mapeamentos ou mapplets em um mapeamento vazio ou no
espao de trabalho do mapplet. Tambm possvel copiar segmentos entre pastas ou repositrios.
Para copiar um segmento de um mapeamento ou mapplet:
1.

Abra em um mapeamento ou mapplet.

2.

Selecione um segmento realando cada objeto a ser copiado.


Voc pode selecionar vrios objetos. Tambm pode selecionar segmentos ao arrastar o ponteiro em um
retngulo ao redor dos objetos no espao de trabalho.

3.

Copie o segmento para a rea de transferncia.

4.

Abra em um mapeamento ou mapplet de destino.


Como opo, voc pode abrir um mapeamento vazio ou o espao de trabalho do mapplet.

5.

Clique em Editar > Colar ou pressione Ctrl+V.


O Assistente de Cpia ser aberto em caso de conflitos de cpia.

Copiando Objetos como uma Imagem


No espao de trabalho do Designer, possvel copiar imagens de objetos, como mapeamentos ou
transformaes, para a rea de transferncia. Em seguida, voc poder colar o arquivo de imagem no
espao de trabalho de qualquer aplicativo que use grficos.
Para copiar objetos como imagens no espao de trabalho do Designer:
1.

No Designer, abra a ferramenta associada ao objeto a ser copiado.


Por exemplo, abra o Mapping Designer, caso deseje copiar um mapeamento como imagem.

2.

Selecione o objeto que deseja copiar.


Se voc escolher mapeamentos em cone, a imagem copiada no mostrar links de mapeamentos.
Voc pode copiar os links de mapeamento selecionando-os manualmente.

3.

Arraste o cursor para criar um retngulo ao redor dos objetos que deseja selecionar.
Voc tambm pode usar a tecla Ctrl para selecionar objetos individuais. No entanto, se voc utilizar
esse mtodo para selecionar objetos, a imagem copiada no mostrar os links de mapeamento.

4.

Pressione Shift+Alt+C ou clique em Editar > Copiar como Imagem.


Voc pode copiar uma imagem de cada vez para a rea de Transferncia .

5.

Cole a imagem no espao de trabalho de algum aplicativo que use arquivos grficos.
Por exemplo, voc pode colar a imagem em um documento do Microsoft Word.

Exportando e Importando Objetos


Para exportar um objeto para um arquivo XML, clique com o boto direito do mouse no objeto e selecione
Exportar objetos no Designer. O Designer salva todas as informaes necessrias para importar esse objeto
de volta ao repositrio.
Para importar um objeto de um arquivo XML no Designer, clique em Repositrio > Importar objetos.

22

Captulo 1: Usando o Designer

Trabalhando com Vrias Portas ou Colunas


Em todas as ferramentas do Designer, voc pode mover ou excluir vrias portas ou colunas ao mesmo
tempo.
Nota: No possvel selecionar vrias portas ou colunas ao editar origens COBOL no Source Analyzer.
Para selecionar portas ou colunas consecutivas:
1.

Clique duas vezes na origem, no destino ou na transformao.

2.

Na caixa de dilogo Editar Tabelas, selecione a guia Portas ou Colunas.

3.

Selecione a primeira porta ou coluna com o nmero do cabealho da linha na transformao.

4.

Para selecionar um intervalo para mover ou excluir, mantenha a tecla Shift pressionada e clique na
ltima porta ou coluna do intervalo. Para selecionar portas ou colunas individuais, mantenha a tecla Ctrl
pressionada e clique em cada uma das portas ou colunas com o nmero do cabealho da linha que
voc deseja mover ou excluir.
Nota: Quando voc seleciona vrias portas ou colunas, o Designer desabilita as funes adicionar,
copiar e colar.

5.

Clique em Excluir.

Renomeando Portas
Voc pode renomear as portas nas origens, destinos e transformaes. Para renomear uma porta em uma
origem, destino ou transformao, clique duas vezes na porta e digite o novo nome. O Designer propaga o
novo nome para os mapeamentos e mapplets que usam essa origem, destino ou transformao. Voc pode
renomear as portas nas seguintes ferramentas do Designer:

Source Analyzer. Para renomear uma porta em uma origem.

Target Designer. Para renomear uma porta em uma destino.

Transformation Developer. Para renomear uma porta em uma transformao reutilizvel.

Mapplet Designer e Mapping Designer. Para renomear uma porta em uma transformao noreutilizvel. Voc pode propagar o novo nome para outras transformaes no reutilizveis que acessam
esta porta atravs do Designer.

Uso das Teclas de Atalho


Ao editar um objeto de repositrio, use atalhos na guia Portas ou Colunas.
A tabela a seguir lista os atalhos do Designer:
Tarefa.

Atalho

Adicionar um novo campo ou porta.

Alt+F

Cancelar edio em uma clula.

Esc

Selecionar ou desmarcar uma caixa de seleo de tipo de


porta.

Barra de espao

Copiar uma linha.

Alt+O

Copiar o texto em uma clula.

Ctrl+C

Tarefas do Designer

23

Tarefa.

Atalho

Recortar uma linha.

Alt+C

Editar o texto de uma clula.

F2 e, em seguida, mova o cursor para o local dentro


da clula.

Localizar todas as caixas de listagem e de combinao.

Digite a primeira letra na lista.

Localizar tabelas ou campos no espao de trabalho.

Ctrl+F

Mover a linha atual para baixo.

Alt+W

Mover a linha atual para cima.

Alt+U

Abrir o Editor de Expresso no campo de expresses.

F2 e, em seguida, pressione F3

Colar uma linha.

Alt+P

Colar o texto copiado em uma clula.

Ctrl+V

Selecionar o texto de uma clula.

F2

Validar o valor padro em uma transformao.

Alt+V

Visualizao dos Dados


Voc pode visualizar dados de origem e destino no Designer. Visualize dados de origem ou de destino antes
de criar um mapeamento ou enquanto trabalha em um mapeamento.
Voc pode visualizar os seguintes tipos de dados:

Tabelas e exibies relacionais. Visualizar origens e destinos relacionais. possvel visualizar os


dados de uma definio de origem relacional vlida, ou de destino, no Designer. Uma definio de origem
ou o atalho para uma definio de origem vlida se coincidir com a tabela de origem. Uma definio de
destino valida se ela coincidir com a tabela de destino. necessrio estar conectado ao banco de
dados de origem ou de destino para visualizar os dados relacionais.

Arquivos simples de largura fixa e delimitados. Visualize as origens e os destinos de arquivo simples
que no contm dados binrios. possvel visualizar os dados de uma definio de origem ou de destino
de arquivo simples vlida, no Designer. Uma definio de origem ou de destino vlida se ela coincidir
com o arquivo de origem.

Arquivos XML. Visualize os dados do arquivo XML no Editor de XML. Voc pode visualizar dados XML
usando uma definio XML e um arquivo XML externo. Para visualizar os dados, voc deve ter uma
definio XML vlida no repositrio e dados em um arquivo XML externo que vlido para a definio.
Voc pode visualizar os dados de uma exibio XML de cada vez.
Sugesto: Visualize os dados de origem para verificar se voc extrai dados da origem certa. Tambm
possvel visualizar os dados de origem para determinar as colunas a serem usadas em um mapeamento.
Voc pode visualizar os dados de destino antes de truncar as tabelas de destino ou quando implementar
uma estratgia de atualizao.

24

Captulo 1: Usando o Designer

Visualizao de Dados Relacionais


Para visualizar dados relacionais de origem ou de destino:
1.

Selecione uma origem relacional ou definio de destino no espao de trabalho.

2.

Clique com o boto direito do mouse na definio de origem ou de destino no espao de trabalho e
escolha Visualizar Dados.

3.

Selecione um nome de origem de dados.

4.

Insira um nome e um senha de usurio do banco de dados.


O nome do usurio deve ter permisses de banco de dados para exibir o objeto.

5.

Insira o nome do proprietrio da tabela do banco de dados.

6.

Insira o nmero de linhas que deseja visualizar.


A caixa de dilogo Visualizar Dados pode exibir at 500 linhas e at 65.000 colunas.

7.

Clique em Conectar.

8.

Para alterar o nmero de linhas que deseja visualizar, insira um novo nmero e clique em Atualizar.

9.

Clique em Fechar.

Visualizao de Dados de Arquivos Simples


Para visualizar dados de origem e de destino de arquivo simples:
1.

Selecione uma origem de arquivo simples ou definio de destino no espao de trabalho.

2.

Clique com o boto direito do mouse na definio de origem ou de destino no espao de trabalho e
escolha Visualizar Dados.

3.

Clique no boto Procurar para selecionar o arquivo simples.

4.

Localize e selecione o arquivo que voc deseja visualizar e clique em Abrir.

5.

Selecione a pgina de cdigo a partir da caixa de dilogo Visualizar dados.


A pgina de cdigo deve corresponder pgina de cdigo da origem. Se a pgina de cdigo no
corresponder pgina de cdigo da origem, os dados podero ser exibidos incorretamente.
O Designer lista as cinco pginas de cdigo que voc selecionou mais recentemente. Em seguida, ele
lista todas as pginas de cdigo restantes em ordem alfabtica.

6.

Digite o nmero da linha inicial e o nmero de linhas que voc deseja visualizar.
A caixa de dilogo Visualizar Dados pode exibir at 500 linhas e at 65.000 colunas.

7.

Clique em Abrir.
Nota: A caixa de dilogo Visualizar dados exibe caracteres de deslocamento exibidos como pontos (.).
em arquivos simples diferenciados pela tecla Shift.

8.

Para alterar o nmero da linhas inicial ou o nmero de linhas que voc deseja visualizar, insira um novo
nmero e clique em Atualizar.

9.

Clique em Fechar.

Visualizao dos Dados XML


Para visualizar os dados XML:
1.

Clique duas vezes na definio XML no espao de trabalho.


O editor de XML ser exibido.

Visualizao dos Dados

25

2.

Selecione uma exibio no espao de trabalho do Editor de XML.

3.

Clique em Exibies XML > Visualizar Dados.

4.

Procure o arquivo XML que contm dados para exibio.


A caixa de dilogo Visualizar dados XML exibe os dados do arquivo XML usando a exibio escolhida.

5.

Se desejar usar um arquivo XML diferente, clique no cone Selecionar arquivo na caixa de dilogo.

6.

Clique em OK.

Trabalhando com Extenses de Metadados


Voc pode estender os metadados armazenados no repositrio, associando as informaes a objetos de
repositrio individuais. Por exemplo, se voc quiser armazenar informaes de contato com as origens que
criou. Se criar uma transformao de Agregador, voc poder armazenar um endereo de e-mail com essa
transformao. Para associar informaes aos objetos do repositrio, use extenses de metadados.
Os objetos do repositrio podem conter extenses de metadados definidas pelo usurio e pelo fornecedor.
Voc pode exibir e alterar os valores das extenses de metadados definidas pelo fornecedor, mas no pode
cri-las, exclu-las ou redefini-las. Voc pode criar, editar, excluir e exibir extenses de metadados definidas
pelo usurio e alterar seus valores.
Voc pode criar extenses de metadados para os seguintes objetos no Designer:

Definies de origem

Definies de destino

Transformaes

Mapeamentos

Mapplets

Voc pode criar extenses de metadados reutilizveis ou no. Voc pode associar extenses de metadados
reutilizveis a todos os objetos do repositrio de um determinado tipo, como todas as definies de origem
ou todas as transformaes de expresso. Voc pode associar extenses de metadados no reutilizveis a
um nico objeto do repositrio, como uma definio de destino ou um mapeamento.

Criao de Extenses de Metadados


possvel criar extenses de metadados definidas pelo usurio, reutilizveis e no reutilizveis para objetos
de repositrio usando o Designer. Para criar uma extenso de metadados, voc edita o objeto para o qual
deseja criar a extenso de metadados e, em seguida, adiciona a extenso de metadados guia Extenso de
Metadados.
Se voc tiver vrias extenses de metadados reutilizveis para criar, a maneira mais fcil de cri-las usar
o Repository Manager.
Para criar uma extenso de metadados:

26

1.

Abra a ferramenta apropriada do Designer.

2.

Arraste o objeto apropriado para o espao de trabalho.

3.

Clique duas vezes na barra de ttulo do objeto para edit-lo. Se o objeto for um mapeamento ou um
mapplet, clique em Mapeamentos > Extenses de Metadados ou Mapplets > Extenses de Metadados.

4.

Clique na guia Extenses de Metadados.

Captulo 1: Usando o Designer

Essa guia lista as extenses de metadados existentes, definidas pelo usurio e pelo fornecedor. As
extenses definidas pelo usurio aparecem no Domnio de Metadados Definidos pelo Usurio. Se elas
existirem, as extenses de metadados definidas pelo fornecedor aparecero em seus prprios domnios.
5.

Clique no boto Adicionar.


Uma nova linha exibida no domnio da Extenso de Metadados definida pelo usurio.

6.

Digite as seguintes informaes:


Campo

Descrio

Nome da Extenso

Nome da extenso de metadados. Esses nomes devem ser exclusivos para cada
tipo de objeto de um domnio.
Os nomes de extenso de metadados no podem conter caracteres especiais,
exceto sublinhados, e no podem comear com nmeros.

Tipo de dados

Selecione numrico (inteiro), string ou booleano.

Preciso

Comprimento mximo das extenses de metadados string.

Valor

Para uma extenso de metadados numricos, o valor deve ser um inteiro entre
-2.147.483.647 e 2.147.483.647.
Para uma extenso de metadados booleana, escolha true ou false.
Para uma extenso de metadados de string, clique no boto Abrir no campo Valor
para inserir um valor de mais de uma linha, de at 2.147.483.647 bytes.

Reutilizvel

Torna a extenso de metadados reutilizvel ou no reutilizvel. Marque para aplicar


a extenso de metadados a todos os objetos desse tipo (reutilizvel). Desmarque
para fazer com que a extenso de metadados se aplique a esse objeto somente (no
reutilizvel).
Se voc criar uma extenso de metadados reutilizvel para uma transformao, a
extenso de metadados se aplicar a todas as transformaes desse tipo (por
exemplo, todas as transformaes Agregador ou todas as transformaes Roteador)
e no a todas as transformaes.
Nota: Se desejar tornar uma extenso de metadados reutilizvel, voc no poder
alter-la de volta para no reutilizvel. O Designer torna a extenso reutilizvel
assim que voc confirma a ao.

7.

No Sobrescrever

Restaura o valor padro da extenso de metadados quando voc clica em Reverter.


Esta coluna aparece somente se o valor de uma das extenses de metadados foi
alterado.

Descrio

Descrio da extenso de metadados.

Clique em OK.

Edio de Extenses de Metadados


possvel editar extenses de metadados definidas pelo usurio, reutilizveis e no reutilizveis, para
objetos de repositrio usando o Designer. Para editar uma extenso de metadados, voc edita o objeto de
repositrio e faz alteraes na guia Extenso de Metadados.
O que voc pode editar depende de se a extenso de metadados reutilizvel ou no reutilizvel. Voc
pode promover uma extenso de metadados no reutilizvel para reutilizvel, mas no pode alterar uma
extenso reutilizvel para no reutilizvel.

Trabalhando com Extenses de Metadados

27

Editando Extenses de Metadados Reutilizveis


Se a extenso de metadados que voc deseja editar for reutilizvel e editvel, voc poder alterar o valor da
extenso de metadados, mas no suas propriedades. Porm, se o fornecedor ou usurio que criou a
extenso de metadados no a tornou editvel, voc no poder editar a extenso de metadados ou seu
valor.
Para editar o valor de uma extenso de metadados reutilizvel, clique na guia Extenses de Metadados e
modifique o campo Valor. Para restaurar o valor padro de uma extenso de metadados, clique em Reverter
na coluna No Sobrescrever.

Editando Extenses de Metadados No Reutilizveis


Se a extenso de metadados que voc deseja editar for no reutilizvel, voc poder alterar o valor da
extenso de metadados e de suas propriedades. Voc tambm pode promover a extenso de metadados a
uma extenso de metadados reutilizvel.
Para editar uma extenso de metadados no reutilizvel, clique na guia Extenses de Metadados. Voc
pode atualizar os campos Data e Hora, Valor, Preciso e Descrio.
Para tornar a extenso de metadados reutilizvel, selecione Reutilizvel. Se desejar tornar uma extenso de
metadados reutilizvel, voc no poder alter-la de volta para no reutilizvel. O Designer torna a extenso
reutilizvel assim que voc confirma a ao.
Para restaurar o valor padro de uma extenso de metadados, clique em Reverter na coluna No
Sobrescrever.

Excluso das Extenses de Metadados


Extenses de metadados reutilizveis so excludas no Repository Manager.
Voc pode excluir extenses de metadados no reutilizveis no Designer. Para excluir extenses de
metadados, edite o objeto de repositrio e exclua a extenso de metadados da guia Extenso de
metadados.

Usando Nomes Comerciais


Voc pode adicionar nomes comerciais s origens, destinos e colunas. Nomes comerciais so nomes
descritivos que voc d a uma origem, destino ou coluna. Eles aparecem no n de origem dos Componentes
comerciais e nos ns de origem e destino exibidos no Navegador. Os nomes comerciais tambm podem
aparecer como nomes de coluna da definio de origem e destino no espao de trabalho. Voc tambm
pode criar qualificadores de origem para exibir nomes comerciais como nomes de coluna no Mapping
Designer e no Mapplet Designer.

Adicionando Nomes Comerciais a Origens ou Destinos


Voc pode adicionar nomes comerciais a definies de origem e de destino. Ao importar definies de
origem de PeopleSoft e SAP, o Designer importa nomes comerciais.
Para adicionar um nome comercial a uma origem ou destino.

28

1.

No Source Analyzer ou no Target Designer, abra a definio de origem ou de destino.

2.

Na caixa de dilogo Editar Tabelas, clique em Renomear.

Captulo 1: Usando o Designer

3.

Insira o nome comercial no campo Nome Comercial.

4.

Clique em OK.

Para exibir nomes comerciais no Navegador, habilite a opo Exibir Tabela como Nome Comercial. O nome
comercial exibido no Navegador com o nome da tabela em parnteses.

Exibindo Nomes Comerciais no Navegador


Voc pode configurar o Designer para exibir os nomes comerciais no Navegador, se eles existirem nas
definies de origem e de destino. Ao habilitar os nomes comerciais para exibio no Navegador, os nomes
das tabelas aparecem entre parnteses.
Por exemplo, se voc criar uma definio de origem com o nome de tabela FUNCIONRIOS e o nome
comercial Dados do Funcionrio, o Navegador exibe o nome comercial com o nome de tabela entre
parnteses.
Se voc criar um atalho para a origem ou o destino, ao habilitar os nomes comerciais para exibir no
Navegador, o Designer nomeia o atalho Shortcut_To_BusinessName.

Exibindo Nomes Comerciais como Nomes de Coluna


Voc pode exibir os nomes comerciais da coluna nas definies de origem e destino. Configure o Designer
para selecionar os nomes comerciais como nomes de coluna no espao de trabalho. Voc pode ter os
nomes comerciais da coluna duplicados nas definies de origem e destino.

Usando Nomes Comerciais como Nomes de Portas em


Qualificadores de Origem
Use nomes comerciais de colunas de origem como nomes de porta nas transformaes Qualificador de
Origem.
Para adicionar nomes comerciais aos Qualificadores de Origem existente em um mapeamento, voc deve
habilitar a opo que exibe os nomes comerciais. Em seguida, exclua a origem existente e reimporte-a com
o Qualificador de Origem.
Se a origem no tiver nomes comerciais, o Qualificador de Origem contm os nomes de porta. Se o nome
comercial contm caracteres que no so permitidos, como nome de porta, o Designer substitui cada um
dos caracteres por sublinhado (_). Nomes comerciais normalmente contm espaos entre palavras, o que
no permitido em um nome de porta. Por exemplo, o nome comercial Dados do Funcionrio se torna
Dados_do_Funcionrio.
Sugesto: Evite usar palavras reservadas do PowerCenter, como DD_INSERT, para nomes comerciais e
porta.

Usando a Documentao Comercial


A documentao comercial oferece detalhes sobre objeto de repositrio ou expresso de transformao.
Voc pode criar e editar links para a documentao comercial que voc desenvolveu para os objetos de
repositrio atravs do Designer. A documentao deve residir em uma mquina local, um servidor de rede
ou no site corporativo intranet ou da internet em um ambiente Windows.

Usando a Documentao Comercial

29

Voc pode desenvolver uma documentao comercial em HTML, PDF ou qualquer formato de texto para os
objetos de repositrio a seguir:

Tabelas de origem e de destino e instncias de tabela

Todas as transformaes e instncias de transformao

Mapplets

Mapeamentos

diretrios de componente comercial

Para acessar a documentao comercial, necessrio concluir as tarefas a seguir:

Especificar o caminho da documentao no Designer.

Criar um link no objeto de repositrio.

Clique no link para exibir a documentao.

Especificao do Caminho da Documentao


Especifique um caminho ou raiz de documentao onde voc armazena os arquivos de documentao.
Consulte este caminho nos links que voc adiciona em cada objeto de repositrio.
Se voc armazenar os arquivos em uma mquina local ou servidor de rede, use um caminho de arquivo. Se
voc colocar os arquivos na intranet ou site da internet da empresa, use uma URL.
Os formatos a seguir so caminhos ou razes de documentao vlidos:

Caminho de arquivo para uma unidade local, como c:\doc\informatica\

Caminho de arquivo para um servidor de rede, como \\server5\doc\informatica\

URL, como http://www.internal.company.com/doc/

TPICOS RELACIONADOS:

Configurando Opes Gerais na pgina 3

Criao de Links para Arquivos de Documentao


Voc pode criar links em objetos de repositrio para arquivos de documentao. Clique nesses links na
caixa de dilogo Propriedades ou Editar de cada objeto para exibir a documentao comercial.
Os links devem ser uma URL ou caminho de arquivo vlido para fazer referncia a um documento comercial.
Use um dos seguintes formatos:

Varivel de raiz. Use a string file://$docroot para se referir raiz de documentao especificada no
campo de caminho da documentao.
Por exemplo, se a raiz de um documento for http://internal.company.com/doc, o Designer apontar para
http://internal.company.com/doc/finance/vendors_help.html, mas exibir file://$docroot como parte do link.

Caminho de arquivo ou link completo. Precede o caminho de arquivo com ://, como em file://c:\doc
\help\ ou http://internal.company.com/doc/help/. O caminho de arquivo deve ser precedido de file:// para
ser vlido.

Para criar um link, edite as propriedades do objeto. A maneira como voc faz isso depende do tipo de objeto
que deseja documentar.

30

Captulo 1: Usando o Designer

A tabela a seguir resume como criar um link para objetos de repositrio:


Objetos de Repositrio

Como Criar Links de Documentao

Tabela/Transformao

- Clique duas vezes na tabela/transformao no espao de trabalho para abrilo.


- Insira o link de documentao na janela Descrio.

Mapeamento/Mapplet

- Abra um mapeamento/mapplet no espao de trabalho.


- Clique em Mapeamentos > Editar ou Mapplets > Editar.
- Insira o link de documentao no campo de comentrios.

Diretrio Componente Comercial

- Selecione o diretrio do componente comercial no Navegador.


- Clique em Repositrio > Componente Comercial > Editar Propriedades.
- Insira o link de documentao no campo de comentrios.

Sugesto: Para adicionar comentrios a componentes comerciais individuais, edite as propriedades do


objeto original referenciado.

Exibindo a Documentao Comercial


Quando voc clica em um link para uma documentao comercial, o Windows inicia o aplicativo
correspondente para exibir o arquivo.

Exibindo Relatrios de Mapeamento e do Mapplet


Voc pode exibir Relatrios do Repositrio do PowerCenter para mapeamentos e mapplets no Designer.
Exiba relatrios para obter mais informaes sobre as origens, os destinos, as portas e as transformaes
em mapeamentos e mapplets. Ao exibir um relatrio, o Designer inicia o JasperReports Server em uma
janela do navegador e exibe o relatrio.
Voc pode exibir os seguintes relatrios:

Relatrio de Composio do Mapplet

Relatrio de Composio de Mapeamento

Um administrador usa a ferramenta Administrador para criar um Servio de Relatrios e Painis e adiciona
uma fonte de relatrios para o servio. A fonte de relatrios deve ser o repositrio do PowerCenter que
contm os mapeamentos e os mapplets que voc deseja relatar.

Exibindo um Relatrio de Composio do Mapplet


O Relatrio de Composio do Mapplet inclui informaes sobre um mapplet:

Todos os objetos. Informaes sobre todos os objetos no mapplet.

Transformaes. Transformaes usadas no mapplet.

Para exibir um Relatrio de Composio de Mapplet:


1.

No Designer, abra um mapplet.

2.

Clique com o boto direito do mouse no espao de trabalho e selecione Exibir Relatrio de Mapplet.

Exibindo Relatrios de Mapeamento e do Mapplet

31

O Designer inicia o JasperReports Server no navegador padro da mquina cliente e executa o Relatrio de
Composio de Mapplet.

Exibindo um Relatrio de Composio de Mapeamento


Exiba um relatrio de mapeamento para obter mais informaes sobre os objetos em um mapeamento do
PowerCenter. O Relatrio de Composio de Mapeamento inclui informaes sobre os seguintes
componentes no mapplet:

Campos de origem e de destino. Campos usados em origens de mapeamento.

Conexes de porta. Conexes de nvel de porta entre objetos.

Portas de transformao. Portas de transformao para cada transformao no mapeamento.

Conexes de nvel de objeto. Conexes entre todos os objetos no mapeamento.

Para exibir um Relatrio de Composio de Mapeamento:


1.

No Designer, abra um mapplet.

2.

Clique com o boto direito do mouse no espao de trabalho e selecione Exibir Relatrio de
Mapeamento.
O Designer inicia o JasperReports Server no navegador padro da mquina cliente e executa o
Relatrio de Composio de Mapeamento.

32

Captulo 1: Usando o Designer

CAPTULO 2

Trabalhando com Origens


Este captulo inclui os seguintes tpicos:

Viso Geral do Trabalho com Origens , 33

Trabalhando com origens relacionais, 36

Trabalhando com Origens COBOL, 41

Componentes de um Arquivo de Origem COBOL, 43

Configurando Definies de Origem COBOL, 44

Importando uma Definio de Origem do Microsoft Excel, 48

Criando Manualmente uma Definio de Origem, 50

Solucionando Problemas de Origens, 50

Viso Geral do Trabalho com Origens


Para extrair dados de uma origem, primeiro defina as origens no repositrio. Voc pode importar ou criar os
seguintes tipos de definies de origem no Source Analyzer:

Tabelas relacionais, exibies e sinnimos

Arquivos delimitados e com largura fixa que no contm dados binrios.

Arquivos COBOL

Arquivos XML

WSDL (Linguagem de Descrio de Servios da Web)

Modelos de dados que usam determinadas ferramentas de modelagem por meio do Metadata Exchange
para Modelos de Dados (e produto suplementar)

Voc pode importar origens que usam conjuntos de caracteres multibyte. As pginas de cdigo de origem
devem ser um superconjunto de pginas de cdigo de destino.
As definies de origem podem ser de um grupo ou de vrios grupos. Uma origem de um grupo possui
apenas um grupo em sua definio. As origens relacionais usam uma definio de origem de um grupo. Uma
origem de vrios grupos possui mais de um grupo em sua definio. As origens no relacionais como as
origens XML usam definies de origem de vrios grupos.
Nota: Como as definies de origem devem corresponder origem, voc deve importar as definies em
vez de cri-las manualmente.

33

Tratamento de Caracteres Especiais em Definies de Origem


Voc pode usar o Designer para importar, criar ou editar definies de origens com nomes de tabelas e
colunas que contenham caracteres especiais, como a barra (/). Quando voc usa o Source Analyzer para
importar uma definio de origem, o Designer retm caracteres especiais em nomes de campo e de tabela.
Entretanto, quando voc adiciona uma definio de origem com caracteres especiais a um mapeamento, o
Designer retm ou substitui o caractere especial. Alm disso, ao gerar a instruo SQL padro em uma
transformao Qualificador de origem para uma origem relacional, o Designer usa aspas ao redor de alguns
caracteres especiais. O Designer manipula caracteres especiais de modo diferente para origens relacionais
e no relacionais.
A tabela a seguir descreve como o Designer manipula caracteres especiais em origens relacionais:
Caracteres Especiais

Comportamento do Source
Analyzer

Comportamento do Mapping Designer

@#$_

- Retm o caractere no nome da


tabela de definio de origem.
- Retm o caractere nos nomes da
coluna de definio de origem.

- Retm o caractere no nome da tabela de


instncia de origem.
- Retm o caractere nos nomes da coluna de
instncia de origem.
- Retm o caractere no nome da transformao
Qualificador de Origem.
- Retm o caractere nos nomes de porta da
transformao Qualificador de Origem.
- No usa aspas ao redor de nomes de colunas
ou tabelas na consulta SQL.

/+-=~`!%^&*()[]
{}';?,<>\|
<space>

- Retm o caractere no nome da


tabela de definio de origem.
- Retm o caractere nos nomes da
coluna de definio de origem.

- Substitui o caractere na tabela de instncia de


origem pelo caractere sublinhado.
- Retm o caractere nos nomes da coluna de
instncia de origem.
- Substitui o caractere no nome da
transformao Qualificador de Origem pelo
caractere sublinhado.
- Substitui o caractere nos nomes de porta da
transformao Qualificador de Origem pelo
caractere sublinhado.
- Delimita nomes de tabelas e colunas incluindo
caracteres especiais com aspas na consulta
SQL.

.":\t\r\n

- O Designer no reconhece esses


caracteres em nomes de tabela e
coluna de origem relacional.

- O Designer no reconhece esses caracteres


em nomes de tabela e coluna de origem
relacional.

- O Designer reconhece o perodo


em origens ODBC.

- O Designer reconhece o perodo nas instncias


de origem ODBC.

Nota: Apesar de o Designer substituir caracteres de barra por caracteres sublinhados em nomes de tabela
de origem, ele retm caracteres de barra em nomes de portas de definio de origem.

34

Captulo 2: Trabalhando com Origens

A tabela a seguir descreve como o Designer manipula caracteres especiais em origens no-relacionais:
Caracteres Especiais

Comportamento do Source
Analyzer

Comportamento do Mapping Designer

@#$_

- Retm o caractere no nome da


tabela de definio de origem.

- Retm o caractere no nome da tabela de


instncia de origem.

- Retm o caractere nos nomes da


coluna de definio de origem.

- Retm o caractere nos nomes da coluna de


instncia de origem.

Nota: No possvel usar o


caractere @ como o primeiro
caractere em um nome de coluna
ou tabela.

- Retm o caractere no nome da


transformao Qualificador de Origem.
- Retm o caractere nos nomes de porta da
transformao Qualificador de Origem.
Nota: No possvel usar o caractere @
como o primeiro caractere em um nome de
coluna ou tabela.

- Retm o caractere no nome da


tabela de definio de origem.
- Retm o caractere nos nomes da
coluna de definio de origem.

- Substitui o caractere na tabela de instncia


de origem pelo caractere sublinhado.
- Retm o caractere nos nomes da coluna de
instncia de origem.
- Substitui o caractere no nome da
transformao Qualificador de Origem pelo
caractere sublinhado.
- Substitui o caractere nos nomes de porta da
transformao Qualificador de Origem pelo
caractere sublinhado.

.+-=~`!%^&*()[]
{}'"
;:?,<>\|\t\r\n
<space>

- O Designer no reconhece esses


caracteres em nomes de tabela e
coluna de origem no-relacional.

- O Designer no reconhece esses caracteres


em nomes de tabela e coluna de origem
no-relacional.

Alguns bancos de dados requerem configurao ou comandos especiais para permitir nomes de campos e
tabelas que contenham barras. Para obter mais informaes, consulte a documentao do banco de dados.

Atualizando Definies de Origem


Ao atualizar uma definio de origem, o Designer propaga as alteraes para todos os mapeamentos que
usam essa origem. Algumas alteraes nas definies de origem podem invalidar mapeamentos.
A tabela a seguir descreve como voc pode impactar mapeamentos ao editar definies de origem:
Modificao

Resultado

Adicione uma coluna.

Os mapeamentos no so invalidados.

Altere o tipo de dados da


coluna.

Os mapeamentos podem ser invalidados. Se a coluna estiver conectada a uma


porta de entrada que usa um tipo de dados incompatvel com o novo, o
mapeamento invalidado.

Viso Geral do Trabalho com Origens

35

Modificao

Resultado

Altere o nome de coluna.

Os mapeamentos podem ser invalidados. Se voc alterar o nome de uma coluna


que acabou de adicionar, o mapeamento permanecer vlido. Se voc alterar o
nome de uma coluna existente, o mapeamento invalidado.

Exclua a coluna.

Mapeamentos podem ser invalidados se o mapeamento usar valores da coluna


excluda.

Ao adicionar uma nova coluna a uma origem no Source Analyzer, todos os mapeamentos que usam a
definio de origem permanecero vlidos. No entanto, ao adicionar uma nova coluna e alterar algumas de
suas propriedades, o Designer invalida mapeamentos usando a definio de origem.
possvel alterar as seguintes propriedades de uma coluna de origem recm-adicionada sem invalidar o
mapeamento:

Nome

Tipo de dados

Formatar

Utilizao

Redefinies

Occurs

Tipo de chave

Se as alteraes invalidarem o mapeamento, voc dever abrir e editar o mapeamento. Em seguida, clique
em Repositrio > Salvar para salvar as alteraes no repositrio. Se o mapeamento invalidado for usado em
uma sesso, voc dever validar a sesso.

Criando Sesses
Ao criar uma sesso, voc pode especificar uma localizao de origem diferente da usada ao importar a
definio de origem. Se a origem um arquivo, voc pode substituir algumas das propriedades de arquivo
quando criar uma sesso.

Trabalhando com origens relacionais


Voc pode adicionar e manter definies de origem relacional das seguintes maneiras:

Importar definies de origem. Importa definies de origem para o Source Analyzer.

Atualizar definies de origem. Atualiza definies de origem manualmente ou reimportando a


definio.

Para importar uma definio de origem relacional, necessrio configurar a conectividade entre o banco de
dados de origem e o Cliente PowerCenter.

36

Captulo 2: Trabalhando com Origens

Definies de Origens Relacionais


Voc pode importar definies de origens relacionais de tabelas de bancos de dados, exibies e sinnimos.
Ao importar uma definio de origem, voc importa os seguintes metadados de origem:

Nome da origem

Local do banco de dados

Nomes de coluna

Tipos de dados

Restries de chave

Nota: Ao importar uma definio de origem de um sinnimo, voc pode precisar definir manualmente as
restries na definio.
Aps importar uma definio de origem relacional, voc pode, opcionalmente, inserir nomes comerciais nas
tabelas e colunas. Voc tambm pode definir manualmente relacionamentos de chave, que podem ser
relacionamentos lgicos criadas no repositrio, que no existem no banco de dados.

Conectividade para Origens Relacionais


Para importar uma definio de origem, voc deve ser capaz de se conectar ao banco de dados de origem
da mquina do cliente usando uma origem de dados ODBC ou gateway configurado adequadamente. Voc
tambm pode precisar de permisso de leitura no objeto de banco de dados.
Ao criar uma origem de dados ODBC, voc tambm deve especificar o driver para o qual o gerenciador de
driver ODBC envia chamadas de banco de dados. A tabela a seguir mostra os drivers ODBC recomendados
para usar com cada banco de dados:
Banco de Dados

Driver ODBC

Exige Banco de Dados


Software Cliente

IBM DB2

Driver ODBC IBM

Sim

Informix

Driver ODBC DataDirect de 32 bits fechado

No

Microsoft Access

Driver do Microsoft Access

Sim

Microsoft Excel

Driver do Microsoft Excel

Sim

Microsoft SQL Server

Driver ODBC Microsoft SQL Server

No

Oracle

Driver ODBC DataDirect de 32 bits fechado

No

Sybase ASE

Driver ODBC DataDirect de 32 bits fechado

No

SAP HANA

Driver SAP HANA ODBC

Sim

Teradata

Driver ODBC Teradata

n/d

Ao usar uma origem de dados ODBC de terceiros para importar uma definio de origem, o Designer exibe
uma mensagem indicando que o driver de terceiros no est listado em powermart.ini. O Designer tenta
importar metadados da definio de origem usando o driver fornecido com o PowerCenter. Se a empresa
terceirizada fornece um driver para importar metadados, configure powrmart.ini.

Trabalhando com origens relacionais

37

Configurando uma Fonte de Dados ODBC de Terceiros


Para importar uma definio de origem com um driver ODBC que no esteja includo no powrmart.ini,
configure o powrmart.ini.
Para configurar o powrmart.ini para uma origem de dados ODBC de terceiros:
1.

Copie o driver para o diretrio a seguir:

2.

Localize e abra o powrmart.ini no diretrio a seguir:

<PowerCenter Installation Directory>\client\bin


<PowerCenter Installation Directory>\client\bin
3.

Adicione uma entrada ao arquivo na seo ODBCDLL que inclui o nome da origem de dados ODBC e o
driver.
Por exemplo, se o Fornecedor A forneceu um driver chamado vendoraodbc.dll, insira o seguinte abaixo
do cabealho ODBCDLL:
Vendor A=vendoraodbc.dll

4.

Salve e feche o powrmart.ini.

5.

Reinicie o Cliente do PowerCenter e importe a definio da origem.

Importando Definies de Origens Relacionais


Para criar uma definio de origem relacional, use o Source Analyzer para importar metadados de origem.
Para importar uma definio de origem relacional:
1.

No Source Analyzer, clique em Origens > Importar do Banco de Dados.

2.

Selecione a fonte de dados ODBC a ser conectada ao banco de dados de origem.


Se quiser criar ou modificar uma origem de dados ODBC, clique em Procurar para abrir o Administrador
ODBC. Crie a origem de dados e clique em OK. Selecione a nova origem de dados ODBC.

3.

Insira um nome de usurio e uma senha do banco de dados para se conectar ao banco de dados.
Nota: Voc deve ter as permisses de banco de dados apropriadas para exibir o objeto.
Talvez voc precise especificar o nome do proprietrio para os objetos de banco de dados que deseja
usar como origens.

4.

Tambm possvel usar o campo de pesquisa para limitar o nmero de tabelas exibidas.
Nota: Para permitir que a distino entre maisculas e minsculas em uma pesquisa de tabela, coloque
a string de pesquisa entre aspas.

5.

Clique em Conectar.
Se nenhum nome de tabela for exibido ou se a tabela que voc quer importar no for exibida, clique em
Todas.

6.

Percorra a lista de origens para encontrar a origem que deseja importar. Selecione um ou mais objetos
relacionais a serem importados.
Voc pode manter a tecla Shift pressionada para selecionar um bloco de origens ou manter a tecla Ctrl
pressionada para fazer selees no consecutivas em uma pasta. Voc tambm pode selecionar uma
pasta e clicar em Selecionar Tudo para selecionar todas as tabelas na pasta. Use o boto No
Selecionar para limpar todas as selees realadas.

7.

Clique em OK.
A definio de origem exibida no Source Analyzer. No Navegador, a nova definio de origem
exibida no n Origens do repositrio ativo, embaixo do nome do banco de dados de origem.

38

Captulo 2: Trabalhando com Origens

Modificando uma Definio de Origem Relacional


possvel atualizar uma definio de origem para adicionar nomes comerciais ou refletir novos nomes de
coluna, tipos de dados ou outras alteraes. possvel atualizar uma definio de origem das seguintes
maneiras:

Edite a definio. Edite manualmente a definio de origem se precisar configurar as propriedades que
voc no pode importar ou se desejar fazer pequenas alteraes na definio de origem.

Reimporte a definio. Se as alteraes da origem forem significativas, talvez seja necessrio


reimportar a definio de origem. Isso substitui ou renomeia a definio de origem existente. possvel
reter relacionamentos e descries de chave primria e chave estrangeira existentes na definio de
origem que est sendo substituda.

Ao atualizar uma definio de origem, o Designer propaga as alteraes para todos os mapeamentos que
usam essa origem. Algumas alteraes nas definies de origem podem invalidar mapeamentos.
Se as alteraes invalidarem o mapeamento, voc dever abrir e editar o mapeamento. Em seguida, clique
em Repositrio > Salvar para salvar as alteraes no repositrio. Se o mapeamento invalidado for usado em
uma sesso, voc dever validar a sesso.

Editando Definies de Origens Relacionais


Talvez voc queira editar manualmente uma definio de origem para registrar propriedades que no podem
ser importadas da origem. Voc pode criar uma definio de origem relacional para criar relacionamentos de
chave e colunas de chave. Esses relacionamentos podem ser relacionamentos lgicos. Ees no precisam
existir no banco de dados.
Voc pode adicionar descries ou especificar links de documentao comercial para definies de origem a
qualquer momento. Adicionar descries ou links de documentao comercial para definies de origem
uma maneira fcil de documentar a finalidade de uma definio de origem. Voc pode adicionar ou modificar
descries de qualquer definio de origem existente.
Para editar uma definio de origem relacional:
1.

No Source Analyzer, clique duas vezes na barra de ttulos da definio de origem.

2.

Edite as seguintes configuraes:

3.

Configuraes da
Tabela

Descrio

Selecionar tabela

Exibe a definio de origem que voc est editando. Para escolher outra definio
de cdigo-fonte aberto para editar, selecione-a na lista.

Boto Renomear

Abre uma caixa de dilogo para editar o nome da definio de origem e inserir um
nome comercial.

Nome do
Proprietrio

Proprietrio da tabela no banco de dados.

Descrio

Descrio opcional da tabela de origem. O limite de caractere 2.000 bytes/K, em


que K o nmero mximo de bytes para cada caractere na pgina de cdigo do
repositrio. Insira links para a documentao comercial.

Tipo de banco de
dados

Indica o tipo de origem ou banco de dados. Se necessrio, selecione um novo tipo


de banco de dados.

Clique na guia Colunas.

Trabalhando com origens relacionais

39

4.

Edite as seguintes configuraes:


Configuraes de
coluna

Descrio

Nome da Coluna

Os nomes de coluna na origem. Quando editar uma definio de origem relacional,


edite o nome da coluna apenas se o nome da coluna da origem real tiver sido
alterado.

Tipo de dados

Os tipos de dados exibidos na definio de origem variam de acordo com o tipo de


origem da definio de origem.

Preciso e escala

Preciso o nmero mximo de dgitos significativos de tipos de dados numricos


ou o nmero mximo de caracteres de tipos de dados de string. A preciso inclui a
escala. Escala o nmero mximo de dgitos aps a vrgula decimal de valores
numricos. Portanto, o valor 11,47 tem uma preciso de 4 e uma escala de 2. A
string Informatica tem uma preciso (ou tamanho) igual a 11.
Todos os tipos de dados de origens relacionais tm uma preciso mxima. Por
exemplo, o tipo de dados Inteiro tem uma preciso de 10 dgitos. Alguns tipos de
dados numricos tm um limite semelhante na escala ou no permitem que voc
defina uma escala maior que 0. Os inteiros, por exemplo, tm uma escala igual a 0,
pois, por definio, eles nunca possuem valores decimais.
Voc pode alterar a preciso e a escala de alguns tipos de dados para valores
diferentes dos valores definidos no banco de dados. Contudo, alterar a preciso ou
a escala pode causar excesso de nmeros em colunas numricas, truncamento em
colunas de caracteres ou a incluso de zeros em colunas de data e hora quando o
Servio de Integrao fizer a leitura na coluna de origem.

5.

No Nulo

Escolha se deseja permitir dados nulos na origem.

Tipo de Chave

Selecione Primria, Estrangeira, Primria/Estrangeira ou No uma chave.


Aplicvel somente em origens relacionais.

Nome Comercial

Voc tambm pode adicionar nomes comerciais para cada coluna.

Clique em OK.

Reimportando uma Definio de Origem


Conclua as etapas a seguir para reimportar uma definio de origem. Voc pode manter as informaes a
seguir na definio de origem a ser substituda:

Relaes de chave primria-chave estrangeira

Descrio da definio de origem

Descrio de coluna ou porta

Para reimportar uma definio de origem relacional:


1.

No Designer, conecte-se ao repositrio que contm a definio da origem que voc deseja atualizar.

2.

Abra o Source Analyzer e importe a definio de origem outra vez.

3.

O Designer solicita que voc renomeie ou substitua as tabelas de origem existentes.

4.

Para exibir as diferenas entre a tabela que voc est importando e a tabela existente, clique em
Comparar.
A caixa de dilogo exibe os atributos de cada origem lado a lado.

40

Captulo 2: Trabalhando com Origens

5.

Especifique se voc deseja manter as informaes de chave primria-chave externa ou as descries


da origem na definio de origem existente.
A tabela seguinte descreve as opes na caixa de dilogo Table Exists (Tabela Existe):

6.

7.

Opo

Descrio

Aplicar a Todas as Tabelas

Aplicar renomear, substituir ou ignorar todas as tabelas na


pasta.

Reter Relacionamentos Pk-Fk Definidos


pelo Usurio

Mantenha os relacionamentos de chave primria-chave


externa na definio de origem a ser substituda.

Reter Descries Definidas pelo Usurio

Mantenha a descrio de origem e as descries da coluna e


porta da definio de origem a ser substituda.

Clique em Substituir, Renomear ou Ignorar:


Opo

Descrio

Substituir

Substitua a definio de origem por uma nova.

Renomear

Digite um nome exclusivo para a nova definio de origem.

Pular

No importe a nova definio de origem.

Se voc clicar em Renomear, insira o nome da definio de origem e clique em OK.

Trabalhando com Origens COBOL


Para fornecer suporte a dados de origem de mainframe, voc pode importar um arquivo COBOL como uma
definio de origem no Designer. Os arquivos COBOL possuem largura fixa e podem conter texto e dados
binrios. O PowerCenter oferece suporte s seguintes pginas de cdigo de arquivos COBOL:

ASCII de 7 bits

EBCDIC-US

ASCII de 8 bits

EBCDIC de 8 bits

MBCS com base em ASCII

MBCS com base em EBCDIC

Voc pode importar arquivos COBOL que diferenciam deslocamentos que no contm chaves de
deslocamento. Defina os estados de shift para cada coluna na definio de origem COBOL.
As origens COBOL geralmente desnormalizam dados e compactam os registros de tabela separados
equivalentes em um nico registro. Use a transformao do Normalizador para normalizar esses registros no
mapeamento.
Depois de importar uma definio de origem COBOL, revise e configure o arquivo COBOL para criar grupos
de registros. Os arquivos COBOL geralmente representam o equivalente funcional de vrias tabelas de

Trabalhando com Origens COBOL

41

origem no mesmo conjunto de registros. Ao revisar a estrutura do arquivo COBOL, voc pode ajustar a
descrio para identificar os grupos de campos que constituem uma nica pseudo-tabela.

Importando Origens COBOL


O Designer usa as estruturas de dados armazenadas na Diviso de Dados de um programa COBOL para
criar uma definio de origem. Quando voc importa um arquivo COBOL, o Designer procura um formato de
arquivo COBOL especfico, que diferente do formato ANSI padro.
O Designer procura um formato de arquivo COBOL similar ao seguinte exemplo:
identification division.
program-id. mead.
environment division.
select file-one assign to "fname".
data division.
file section.
fd FILE-ONE.
01 SCHOOL-REC.
02 SCHOOL-ID
PIC 9(15).
02 SCHOOL-NM
PIC X(25).
02 CLASS-REC
OCCURS 2 TIMES.
03 CLASS-ID
PIC 9(5).
03 CLASS-NM
PIC X(25).
03 STUDENT-REC
OCCURS 5 TIMES.
04 STUDENT-ID
PIC 9(15).
04 STUDENT-NM
PIC X(25).
04 PARENT-REC
OCCURS 2 TIMES.
05 PARENT-ID
PIC 9(15).
05 PARENT-NM
PIC X(25).
03 TEACHER-REC
OCCURS 3 TIMES.
04 TEACHER-ID
PIC 9(15).
04 TEACHER-NM
PIC X(25).
02 SPORT-REC
OCCURS 2 TIMES.
03 SPORT-TEAM
PIC X(30).
working-storage section.
procedure division.
stop run.

Trabalhando com Copybooks COBOL


O Designer no pode reconhecer um copybook COBOL (arquivo .cpy) como um arquivo COBOL
(arquivo .cbl) porque ele no possui o formato adequado. Para importar um copybook COBOL para o
Designer, voc pode inseri-lo em um modelo de arquivo COBOL usando a instruo COBOL "copy". Aps
inserir um arquivo copybook no modelo de arquivo COBOL, voc poder salvar o arquivo como .cbl e
import-lo para o Designer.
Se os arquivos .cbl e .cpy no estiverem no mesmo diretrio local, o Designer solicitar o local do
arquivo .cpy.
Quando o arquivo copybook COBOL contiver tabulaes, o Designer expandir as tabulaes em espaos.
Por padro, o Designer expande um caractere de tabulao em oito espaos. Voc pode alterar esta
configurao padro em powrmart.ini. O arquivo powrmart.ini pode ser encontrado no diretrio raiz da
instalao do Cliente do PowerCenter.
Para alterar a configurao padro, adicione o seguinte texto ao arquivo powrmart.ini:
[AnalyzerOptions]
TabSize=n
onde n o nmero de espaos que o Designer l para cada caractere de tabulao. Para aplicar as
alteraes, reinicie o Designer.

42

Captulo 2: Trabalhando com Origens

Por exemplo, o arquivo copybook COBOL denominado sample.cpy. O arquivo COBOL abaixo mostra como
usar a instruo copy para inserir o copybook de exemplo em um modelo de arquivo COBOL:
identification division.
program-id. mead.
environment division.
select file-one assign to "fname".
data division.
file section.
fd FILE-ONE.
copy sample.cpy.
working-storage section.
procedure division.
stop run.

Etapas para Importar uma Estrutura de Origem COBOL


Para importar uma estrutura de origem COBOL, conclua as etapas a seguir.
Para importar uma estrutura de origem COBOL:
1.

Abra o Source Analyzer e clique em Origens > Importar de arquivo COBOL.

2.

Selecione o arquivo COBOL que voc deseja analisar.

3.

Selecione a pgina de cdigo do arquivo COBOL.


Esta a pgina de cdigo do arquivo COBOL (.cbl), no o arquivo de dados. A pgina de cdigo deve
ser compatvel com a pgina de cdigo do cliente PowerCenter.
O arquivo de dados usa esta pgina de cdigo por padro, depois que voc a seleciona. Aps importar
o arquivo COBOL, voc pode configurar a pgina de cdigo dos dados de origem, ao ajustar a definio
da origem ou ao executar o fluxo de trabalho.
O Designer lista as cinco pginas de cdigo que voc selecionou mais recentemente. Em seguida, ele
lista todas as pginas de cdigo restantes em ordem alfabtica.

4.

Clique em OK.

A definio de origem COBOL aparece no Designer. Talvez aparea mais de uma definio, se o arquivo
COBOL tiver mais de uma entrada FD.

Componentes de um Arquivo de Origem COBOL


Quando voc importa uma origem COBOL, o Designer varre o arquivo procura dos seguintes
componentes:

Seo FD

Campos

OCCURS

REDEFINES

Seo FD
O Designer considera que cada entrada FD define o equivalente de uma tabela de origem e uma origem
relacional e cria uma definio de origem COBOL diferente para cada uma dessas entradas. Por exemplo,
se o arquivo COBOL tiver duas entradas FD, CUSTOMERS e ORDERS, o Designer cria uma definio de
origem COBOL que contm os campos atribudos a CUSTOMERS e outra com os campos que pertencem a
ORDERS.
Componentes de um Arquivo de Origem COBOL

43

Campos
O Designer identifica cada definio de campo, l o tipo de dados e o atribui definio de origem
apropriada.

OCCURS
Os arquivos COBOL geralmente contm vrias instncias do mesmo tipo de dados no mesmo registro. Por
exemplo, um arquivo COBOL pode incluir dados sobre quatro trimestres financeiros diferentes, cada um
armazenado no mesmo registro. Quando o Designer analisa o arquivo, ele cria uma coluna diferente para
cada instruo OCCURS no arquivo COBOL. Essas instrues OCCURS definem informaes repetidas no
mesmo registro. Use a transformao Normalizador para normalizar essas informaes.
Para cada instruo OCCURS, o Designer cria os seguintes itens:

Uma tabela de destino, quando voc arrasta a definio de origem COBOL para o Target Designer.

Um relacionamento de chave primria-estrangeira

Um ID da coluna gerada (GCID)

REDEFINES
COBOL usa instrues REDEFINES para compilar a descrio de um registro com base na definio de um
outro registro. Quando voc importa a origem COBOL, o Designer cria uma nica origem que inclui
REDEFINES.
A instruo REDEFINES permite especificar vrias clusulas PICTURE para a localizao de dados fsicos
de exemplo. Assim, preciso usar as transformaes Filtro para separar os dados nas tabelas criadas por
REDEFINES.
Para cada REDEFINES:

O Designer cria uma tabela de destino quando voc arrasta a definio de origem COBOL para o Target
Designer.

O Designer cria um relacionamento entre chaves primria e externa.

O Designer cria uma chave gerada (GK).

Voc precisa separar a transformao Filtro no mapeamento.

Configurando Definies de Origem COBOL


Aps importar uma definio de origem COBOL, talvez seja necessrio configurar algumas das propriedades
de origem. A definio de origem COBOL semelhante definio de um arquivo simples de largura fixa.
No entanto, o arquivo COBOL tem algumas propriedades exclusivas que devem ser consideradas quando
voc configurar a definio:

44

OCCURS

Definio de campo

Armazenamento de palavra ou byte

Atributos de campo

Captulo 2: Trabalhando com Origens

Revise as seguintes guias e caixas de dilogo quando voc configurar uma definio de origem COBOL:

Guia Tabela. Review storage (Revisar armazenamento).

Propriedades avanadas. Revisar propriedades de arquivos de dados de largura fixa.

Guia Colunas. Revisar atributos OCCURS, seo FD e de campo.

Configurando a Guia Tabela


Configure a guia Tabela de uma definio de origem COBOL da mesma maneira que voc configura uma
definio de arquivo simples. No entanto, com uma definio COBOL, voc tambm precisa levar em
considerao o tipo de armazenamento.
O Servio de Integrao oferece suporte ao armazenamento de palavra COMP-1 em ordem de byte de rede
e com o ponto flutuante no formato de byte IEEE 754 4. Alm disso, o Servio de Integrao oferece suporte
ao armazenamento de palavra COMP-2 em ordem de byte de rede e com o ponto flutuante no formato de
byte IEEE 754 8.
necessrio alternar para o armazenamento de byte dos arquivos de dados referentes a IBM VS COBOL e
MicroFocus COBOL, selecionando a opo IBM COMP na definio de origem. Por padro, o Servio de
Integrao oferece armazenamento de palavra COMP. Colunas COMP so 2, 4 e 8 bytes em mainframes
IBM. Colunas COMP podem ser 1, 2, 3, 4, 5, 6, 7 e 8 bytes em qualquer outro lugar quando derivado atravs
do MicroFocus COBOL. Limpe a opo IBM COMP para usar o armazenamento de byte.
A tabela a seguir descreve as Propriedades do arquivo COBOL que voc pode definir na guia Tabela:
Opo de
tabela

Descrio

Boto Renomear

Use o boto Renomear para renomear a definio de origem e digitar um nome comercial
para a definio de origem.

Nome do
Proprietrio

No aplicvel a arquivos COBOL.

Descrio

Comentrios adicionais sobre a definio de origem.

Tipo de banco de
dados

Localizao ou tipo da origem. Este deve ser definido como VSAM.

IBM COMP

Indica o tipo de armazenamento. Se selecionado, o Servio de Integrao usa o


armazenamento de palavra. Do contrrio, ele usa o armazenamento de byte.

Tipo de Arquivo
Simples

Selecione Largura fixa.

Boto Avanado

Use o boto Avanado para abrir a caixa de dilogo com as opes de largura fixa.

Configurando Propriedades Avanadas


Clique em Avanado na guia Tabela para configurar as propriedades dos arquivos de largura fixa.
Ao importar um arquivo COBOL, escolha a pgina de cdigo do arquivo COBOL para que o Designer possa
ler o arquivo corretamente. Depois de importar o arquivo COBOL, voc pode alterar a pgina de cdigo para
a dos dados de origem, para que o Servio de Integrao possa ler os dados ao executar um fluxo de
trabalho. Voc pode selecionar a pgina de cdigo do arquivo de dados em Propriedades Avanadas.

Configurando Definies de Origem COBOL

45

TPICOS RELACIONADOS:

Atualizando Propriedades de Arquivo de Largura Fixa na pgina 60

Configurando a Guia Colunas


Quando revisar a guia Colunas de uma definio de origem COBOL, voc ver alguns nveis de coluna e
vrios atributos dessas colunas. Pode ser conveniente revisar e configurar as seguintes propriedades:

OCCURS
Quando se analisa o contedo da guia Colunas em uma origem COBOL, possvel ver vrios nveis de
colunas. Esses nveis representam os conjuntos de registros separados contidos em uma nica origem
COBOL.
Por exemplo, a origem COBOL a seguir contm um conjunto de registros aninhados, o HST_MTH. Cada
conjunto de registros comea com um cabealho de nvel 5, indicando o comeo do registro. As colunas
dentro de cada conjunto de registro devem estar todas no mesmo nvel abaixo do cabealho da coluna. Por
exemplo, o conjunto de registros HST_MTH contm vrias colunas iniciadas com HST_ACCR_REM. Uma
configurao OCCURS de 24 indica que, quando voc analisa os dados nesta origem COBOL, cada registro
contm 24 registros aninhados para HST_MTH.
A figura a seguir uma amostra de definio de origem COBOL com uma configurao OCCURS de 4:

Todas as colunas em HST_MTH esto no mesmo nvel 7 nesta origem COBOL. O cabealho do registro
HST_MTH est no nvel 5, dois nveis acima das colunas daquela origem.

Seo FD
Talvez seja necessria a configurao da definio de origem para agrupar os campos. Embora o Designer
crie uma definio de origem separada de cada entrada FD no arquivo COBOL, cada entrada pode
representar o equivalente funcional s tabelas mltiplas de dados. Ao configurar a definio de origem, crie
nveis diferentes de campos dentro da origem, para agrupar os dados em pseudo-tabelas distintas.

Atributos do Campo
Quando voc revisa uma origem COBOL, visualiza vrios atributos em cada campo (o equivalente do
COBOL a uma coluna) que representa como voc pode configurar um campo em um arquivo COBOL.
Entre estes atributos, a clusula de imagem (PICTURE) a mais fundamental, porque mostra como o
arquivo COBOL representa os dados. O COBOL usa seu prprio conjunto de convenes para configurar
como os dados so formatados dentro da coluna. Por exemplo, a imagem X(32) indica que os dados de texto
no campo tm 32 bytes de comprimento. A clusula de imagem 9(7) indica que o campo contm dados
numricos com no mximo 7 dgitos de comprimento. A imagem N(8), um tipo de dados Nstring que contm
caracteres de bytes duplos, indica que os dados de texto no campo tm 16 bytes de comprimento.

46

Captulo 2: Trabalhando com Origens

Voc pode precisar ajustar a definio de um campo no Source Analyzer, modificando a imagem no
processo. Uma vez que o Servio de Integrao usa a definio de origem como um mapa para encontrar
dados no arquivo de origem, seja cauteloso ao fazer tais ajustes.
A tabela a seguir descreve os atributos que voc pode configurar na guia Colunas de uma definio de
origem COBOL:
Atributo

Descrio

Compensaes fsicas
(POffs)

Deslocamento do campo no arquivo. O Designer calcula esta configurao somente


de leitura usando o comprimento fsico, a imagem, o uso e as configuraes
REDEFINES para o campo.

Comprimento fsico
(PLen)

Nmero de bytes neste campo.

Nome da coluna

Nome do campo.

Nvel

Um indicador usado para identificar todos os campos que fornecem dados para o
mesmo registro. Se voc deseja agrupar os campos, deve configurar todas as suas
colunas para o mesmo nvel. Usando este recurso, possvel criar mltiplos tipos de
registro, que so os equivalentes s tabelas de dados separadas da mesma origem
COBOL.

Occurs

Uma instruo COBOL que indica que instncias mltiplas deste campo aparecem no
mesmo registro.

Tipo de dados

Tipo de dados de campo: String, Nstring ou Numrico.

Preciso (Prec)

Preciso dos valores numricos no campo.

Escala

Escala dos valores numricos no campo.

Foto

Como o arquivo representa os dados.

Utilizao

Formato de armazenamento para os dados no campo. Existem diferentes convenes


COBOL, como COMP-1 e COMP-X. Todas as convenes disponveis aparecem na
lista de utilizaes para cada campo.

Tipo de Chave

Tipo de restries de chaves para aplicar ao campo. Quando voc configura um


campo como uma chave primria, o Servio de Integrao gera IDs numricas
exclusivas para este campo, ao executar um fluxo de trabalho usando o arquivo
COBOL como uma origem.

Assinado (S)

Indica se os valores numricos no campo so assinados.

Sinal direita (T)

Se selecionado, indica que existe o sinal (+ ou -) no ltimo dgito do campo. Se no


estiver selecionado, o sinal aparecer como primeiro caractere do campo.

Sinal includo (I)

Indica se o sinal foi includo em algum valor que aparece no campo.

Vrgula decimal real (R)

Em valores numricos, indica se os decimais so separados por um ponto(.) ou um


caractere V.

Redefinies

Indica que o campo usa uma instruo REDEFINES no COBOL para basear sua
prpria definio de campo, neste ou em outro campo.

Configurando Definies de Origem COBOL

47

Atributo

Descrio

Tecla Shift

Voc pode definir o estado do Shift para os arquivos COBOL sensveis ao Shift, que
no contenham teclas Shift.
Este atributo aparece quando voc seleciona o Estado de Shift Definido pelo Usurio
na caixa de dilogo Editar Informaes do Arquivo Simples, para os arquivos de
largura fixa.
Escolha Shift-In se a coluna contiver caracteres de byte nico. Escolha Shift-Out se a
coluna contiver caracteres multibyte.

Nome Comercial

Comentrios adicionais sobre o campo.

TPICOS RELACIONADOS:

Trabalhando com Arquivos Simples que Diferenciam Deslocamentos na pgina 73

Importando uma Definio de Origem do Microsoft


Excel
PowerCenter trata uma origem do Microsoft Excel como um banco de dados relacional, no um arquivo
simples. Assim como as origens relacionais, o Designer usa ODBC para importar uma origem Microsoft
Excel. Voc no precisa de permisses de banco de dados para importar origens do Microsoft Excel.
Conclua as tarefas a seguir antes de importar uma definio de origem Excel:
1.

Instale o driver Microsoft Excel ODBC no sistema.

2.

Crie uma origem de dados Microsoft Excel ODBC de cada arquivo de origem no Administrador de
Origem de Dados ODBC.

3.

Prepare planilhas do Microsoft Excel definindo intervalos e formatando colunas de dados numricos.

Definindo Intervalos
O Designer cria definies de origem com base em intervalos definidos no Microsoft Excel. Voc pode definir
um ou mais intervalos em uma planilha do Microsoft Excel. Se voc tiver vrias planilhas, defina pelo menos
um intervalo para cada planilha. Quando voc importa as origens no Designer, cada intervalo exibido como
uma origem relacional.
Voc deve definir um intervalo no Designer para importar a definio de origem do Excel.
Para definir um intervalo:

48

1.

Abra o arquivo do Microsoft Excel.

2.

Realce a coluna ou grupo de colunas de dados para importar.

3.

Clique em Inserir > Nome > Definir.

4.

Insira um nome para o intervalo selecionado e clique em OK.

5.

Se voc tiver vrias planilhas, selecione cada planilha e repita as etapas 2 para 4 definir os intervalos
para cada conjunto de dados.

6.

Clique em Arquivo > Salvar.

Captulo 2: Trabalhando com Origens

Formatando Colunas de Dados Numricos


No Microsoft Excel, voc pode atribuir tipos de dados a colunas de dados. Os tipos de dados do Microsoft
Excel so tipos de dados ODBC. O PowerCenter oferece suporte a tipos de dados ODBC e os converte em
tipos de dados de transformao. Se voc no atribuir tipos de dados no Microsoft Excel, o Designer importa
cada coluna como VARCHAR. Se desejar executar clculos numricos ou de agregao em um
mapeamento, atribua tipos de dados numricos no Microsoft Excel antes de importar a planilha.
Para formatar colunas no Microsoft Excel:
1.

Abra o arquivo do Microsoft Excel.

2.

Selecione as colunas de dados que consistem em dados numricos.

3.

Clique em Formatar > Clulas.

4.

Na guia Nmero, selecione Nmero.

5.

Especifique o nmero de casas decimais.

6.

Clique em OK.

7.

Clique em Arquivo > Salvar.

Etapas para Importar uma Definio de Origem do Microsoft Excel


Aps definir intervalos e formatar clulas, voc pode importar os intervalos no Designer. Os intervalos so
exibidos como definies de origem quando voc importa a origem.
Para importar uma definio de origem do Microsoft Excel:
1.

No Designer, conecte-se ao repositrio e abra a pasta da definio de origem.

2.

Abra o Source Analyzer e clique em Origens > Importar do Banco de Dados.

3.

Selecione Arquivos do Excel (Driver do Microsoft Excel (*. xls)) da origem de dados.

4.

Clique no boto Procurar para abrir o Administrador ODBC.

5.

Nas guias Usurio ou Sistema DSN, dependendo onde voc criou a origem de dados, clique duas vezes
no driver do Microsoft Excel.

6.

Clique em Selecionar Pasta de Trabalho e procure o arquivo do Microsoft Excel, que considerado um
banco de dados relacional.

7.

Clique em OK trs vezes para voltar caixa de dilogo Importar Tabelas.

8.

Clique em Conectar na caixa de dilogo Importar Tabelas.


Voc no precisa inserir o nome de usurio e a senha de um banco de dados. Os intervalos que voc
definiu no arquivo do Microsoft Excel aparecem como nomes de tabela. O proprietrio do banco de
dados No Owner (Sem Proprietrio), pois voc no obrigado inserir nenhum nome de usurio do
banco de dados.

9.

Selecione a tabela que deseja importar.


Para selecionar mais de uma tabela, mantenha pressionada a tecla Ctrl ou Shift para realar vrias
tabelas.

10.

Clique em OK.
No Navegador, a definio de origem aparece no n Origens, sob o nome do banco de dados.

Importando uma Definio de Origem do Microsoft Excel

49

Criando Manualmente uma Definio de Origem


possvel criar uma definio de origem manualmente.
Para criar uma definio de origem:
1.

No Source Analyzer, clique em Origens > Criar.

2.

Insira o nome da origem e o nome e o tipo de banco de dados.

3.

Clique em Criar.
Uma estrutura de tabela vazia exibida no espao de trabalho. (Ela pode estar atrs da caixa de
dilogo.) A nova tabela de origem tambm exibida na janela Navegador.

4.

Clique em Concludo quando terminar de criar definies de origem.

5.

Configure a definio de origem.

A definio de origem salva no repositrio. Agora possvel usar a definio de origem em um


mapeamento. Voc tambm pode criar uma tabela de origem com base nessa definio no banco de dados
de origem.

Solucionando Problemas de Origens


Eu importei uma origem de um banco de dados DB2 e recebi uma mensagem de erro SQL0954C do
sistema operacional DB2.
Se o valor da varivel de sistema do DB2, APPLHEAPSZ, for muito pequena quando voc usar o Designer
para importar origens de um banco de dados DB2, o Designer informar um erro ao acessar o repositrio. A
barra de status do Designer exibe a mensagem a seguir:
SQL Error:[IBM][CLI Driver][DB2]SQL0954C: Not enough storage is available in the
application heap to process the statement.
Se voc receber essa mensagem de erro, aumente o valor da varivel APPLHEAPSZ para o sistema
operacional DB2. APPLHEAPSZ o tamanho da pilha do aplicativo em pginas de 4 KB para cada processo
que use o banco de dados.

50

Captulo 2: Trabalhando com Origens

CAPTULO 3

Trabalhando com Arquivos


Simples
Este captulo inclui os seguintes tpicos:

Viso Geral do Trabalho com Arquivos Simples, 51

Importao de Arquivos Simples, 52

Editando Definies de Arquivos Simples, 58

Formatando Colunas de Arquivos Simples, 67

Trabalhando com Listas de Arquivos, 73

Trabalhando com Arquivos Simples que Diferenciam Deslocamentos, 73

Trabalhando com Dados Multibyte em Destinos de Largura Fixa, 75

Soluo de Problemas de Arquivos Simples, 75

Viso Geral do Trabalho com Arquivos Simples


Para usar arquivos simples como origens, destinos e pesquisas em um mapeamento, voc deve importar ou
criar as definies no repositrio. Voc pode importar ou criar definies de origem de arquivo simples para
o Source Analyzer. Voc pode importar ou criar definies de destino de arquivo simples para o Target
Designer. Voc pode importar pesquisas de arquivo simples ou usar definies de arquivo existentes em
uma transformao de pesquisa.
Nota: Como as definies de origem devem corresponder origem, voc deve importar as definies de
origem de arquivo em vez de cri-las manualmente.

Criao de Sesses com Origens e Destinos de Arquivos Simples


Ao criar sesses usando origens e destinos de arquivo, voc pode substituir algumas propriedades definidas
no Designer. Ao criar uma sesso com uma origem de arquivo, voc poder especificar um local de arquivo
de origem diferente do local usado ao importar a definio de origem de arquivo.

51

Importao de Arquivos Simples


Voc pode importar definies de arquivos simples delimitados e com largura fixa que no contm dados
binrios. Ao importar a definio, o arquivo deve estar em um diretrio local na mquina do cliente. Alm
disso, o Servio de Integrao do PowerCenter deve ser capaz de acessar todos os arquivos de origem
durante a sesso.
Ao criar uma definio de arquivo de origem, destino e pesquisa, voc deve definir as propriedades do
arquivo. O Assistente para Arquivo Simples avisa-o sobre as propriedades de arquivo a seguir:

Nome de arquivo e localizao

Arquivo de pgina de cdigo

Tipo de arquivo

Nomes de coluna e tipos de dados

Nmero de linhas de cabealho no arquivo

Tamanho de coluna e caracteres nulos de arquivos com largura fixa

Tipos de delimitadores, caractere de aspas e caractere de escape para arquivos delimitados

Tratamento de Caracteres Especiais


Ao importar um arquivo simples para o Designer, por padro, o Assistente de Arquivo Simples usa o nome
do arquivo como o nome da definio de arquivo simples. Voc pode importar um arquivo simples com
qualquer nome de arquivo vlido atravs do Assistente de Arquivo Simples. No entanto, o Designer no
reconhece alguns caracteres especiais nos nomes de origem e de destino do arquivo simples.
Ao importar um arquivo simples, o Assistente de Arquivo Simples altera caracteres e espaos invlidos para
sublinhados (_). Por exemplo, voc tem o arquivo de origem sample prices+items.dat. Ao importar esse
arquivo simples para o Designer, por padro, o Assistente de Arquivo Simples nomeia a definio de arquivo
sample_prices_items.

TPICOS RELACIONADOS:

Tratamento de Caracteres Especiais em Definies de Origem na pgina 34

Tratamento de Caracteres Especiais em Definies de Destino na pgina 78

Seleo de Pginas de Cdigo


Ao importar um arquivo simples no Designer, voc pode selecionar a pgina de cdigos do arquivo. O
Designer lista as cinco pginas de cdigo que voc selecionou mais recentemente. Em seguida, ele lista
todas as pginas de cdigo restantes em ordem alfabtica.
A pgina de cdigo representa a pgina de cdigos de dados contidos no arquivo. Ao configurar a definio
do arquivo, especifique delimitadores, caracteres nulos e caracteres de escape a que a pgina de cdigo
oferece suporte.
Para arquivos delimitados, especifique delimitadores, aspas opcionais e caracteres de escape contidos na
pgina de cdigo do arquivo de origem. Para arquivos de largura fixa, especifique caracteres nulos como
valor binrio de 0 a 255 ou um caractere da pgina de cdigo selecionada.

52

Captulo 3: Trabalhando com Arquivos Simples

Ao configurar a definio de arquivo simples, use delimitadores, caracteres de escape e caracteres nulos
que sejam vlidos na pgina de cdigo necessria para executar o fluxo de trabalho.

Modo de movimentao de dados ASCII. Use caracteres da pgina de cdigo definida para o arquivo
simples. Todos os caracteres de 8 bits especificados em verses anteriores do PowerCenter ainda so
vlidos.

Modo de movimentao de dados Unicode. Use caracteres da pgina de cdigo definida para o
arquivo simples.

Alterao de Origens de Exibio


Voc pode usar o Assistente para Arquivo Simples para visualizar os dados contidos em um arquivo simples.
Por padro, o Assistente para Arquivo Simples exibe fontes com base na localidade do sistema. Por
exemplo, o cliente PowerCenter est instalado em uma mquina Windows que usa a localidade do sistema
Latin-1. Por padro, a fonte do Assistente para Arquivo Simples est definida como Courier. A janela de
visualizao exibe os caracteres de Latin-1 na fonte Courier.
Para exibir uma fonte que no seja compatvel com a localidade Latin-1, voc deve alterar a fonte do
Assistente para Arquivo Simples. Por exemplo, se voc deseja ver as fontes japonesas na janela de
visualizao do Assistente para Arquivo Simples na mquina Latin-1, necessrio alterar a fonte para Fonte
japonesa, como a MS Gothic.
Voc pode configurar a fonte do Assistente para Arquivo Simples no Designer.
Se voc configurar a fonte e ainda encontrar problemas de exibio do texto na janela de visualizao,
execute as seguintes tarefas:
1.

Redefina os formatos do Designer.

2.

Verifique se a linguagem dos dados est instalada na mquina. Se necessrio, instale-a.

Redefinio de Formatos do Designer


Voc pode restabelecer as configuraes padro dos formatos do Designer.
Para alterar os formatos do Designer de volta s configuraes padro:
1.

No Designer, clique em Ferramentas > Formato.

2.

Clique em Redefinir todos para redefinir para padro.

Instalao de um Idioma
Para instalar um idioma em uma mquina Windows:
u

Clique em Painel de Controle > Opes Regionais.

Importao de Arquivos Simples de Largura Fixa


Arquivos simples de largura fixa so orientados por byte, o que significa que os tamanhos de campos so
medidos em bytes. Eles tambm podem ser sequenciais em linha, o que significa que cada linha termina
com um caractere de nova linha. possvel importar um arquivo de largura fixa que no contm dados
binrios ou dados de caractere multibyte com mais de dois bytes por caractere.
Quando voc importa um arquivo de largura fixa, possvel criar, mover ou excluir quebras de coluna
usando o Assistente de Arquivo Simples. O posicionamento incorreto de quebras de coluna pode criar erros
de desalinhamento durante a execuo de uma sesso com um arquivo de origem que contm caracteres de

Importao de Arquivos Simples

53

um byte e caracteres multibyte. O desalinhamento de dados multibyte em um arquivo causa erros de fluxo
de trabalho.
Para importar uma definio de arquivo simples de largura fixa:
1.

Para importar uma definio de origem, abra o Source Analyzer e clique em Origens > Importar um
Arquivo. Para importar uma definio de destino, abra o Target Designer e clique em Destinos >
Importar um arquivo.
A caixa de dilogo Abrir Arquivo Simples exibida.

2.

Selecione o arquivo que deseja usar.

3.

Selecione uma pgina de cdigo.


Quando voc importar uma definio de origem de arquivo simples, selecione uma pgina de cdigo
dos dados no arquivo.

4.

Clique em OK.
O contedo do arquivo exibido na janela da parte inferior do Assistente de Arquivo Simples.

5.

Edite as seguintes configuraes:


Assistente de Arquivo
Simples de Largura
Fixa, etapa 1 de 3

Descrio

Tipo de Arquivo Simples

Tipo de arquivo. Selecione Largura Fixa para um arquivo de largura fixa.

Digite um nome para


essa origem

Nome da origem. Esse o nome da origem no repositrio. Voc pode usar o


nome do arquivo ou qualquer outro nome lgico.

Iniciar Importao na
Linha

Indica o nmero da linha em que o Assistente de Arquivo Simples comea a ler


quando importa o arquivo.
Por exemplo, se voc especificar o incio na linha 2, o Assistente de Arquivo
Simples ignorar a linha 1 antes da leitura.

Importar Nomes de
Campo da Primeira Linha

6.

Se essa opo estiver selecionada, o Designer usar dados da primeira linha


como nomes de coluna. Selecione-a se os nomes de coluna aparecerem na
primeira linha. Nomes de campo invlidos so iniciados por "FIELD_".

Clique em Avanar.
Siga as instrues no assistente para manipular as quebras de coluna na janela de visualizao de
arquivo. Mova quebras de coluna existentes arrastando-as. Clique duas vezes em uma quebra de
coluna para exclu-la.
Para arquivos que diferenciam deslocamentos, o Assistente de Arquivo Simples exibe caracteres de
deslocamento de um byte como . na janela. Caracteres de deslocamento de bytes duplos aparecem
como .. na janela, para voc configurar as quebras de coluna com preciso.

7.

Clique em Avanar.
Insira as informaes de coluna para cada coluna no arquivo.

54

Captulo 3: Trabalhando com Arquivos Simples

Para alternar entre colunas, selecione uma nova coluna no grupo Definio de Origem ou Definio
de Destino ou clique no cabealho da coluna na janela de visualizao do arquivo.
Assistente de Arquivo
Simples de Largura
Fixa, etapa 3 de 3

Descrio

Nome

O nome da porta que voc quer exibir para cada coluna. Se voc selecionar
Importar Nomes de Campo da Primeira Linha, o assistente ler os nomes de
coluna fornecidos no arquivo.

Tipo de Dados

Tipo de dados de coluna. Selecione Texto, Numrico ou Datahora e insira


Tamanho/Preciso, Escala e Largura apropriados.
Em colunas numricas, Preciso o nmero de dgitos significativos e
Largura o nmero de bytes para ler arquivos de origem ou gravar em
arquivos de destino.
Em colunas de texto, a Preciso medida em bytes para arquivos de largura
fixa e em caracteres para arquivos delimitados.
Por padro, o Assistente de Arquivo Simples insere o mesmo valor para
Preciso e Largura. Voc pode alterar o valor da preciso e inserir o nmero
de dgitos significativos, mas a largura deve ser maior ou igual preciso.
Nota: Somente os caracteres 0 a 9 so considerados numricos. As colunas
que contm nmeros de conjunto de caracteres multibyte, como no idioma
japons, so consideradas de texto.

8.

Clique em Concluir.
Nota: Se o tamanho do arquivo exceder 256 KB ou contiver mais de 16 KB de dados para cada linha,
verifique se o Assistente de Arquivo Simples importar o arquivo com a preciso e largura de campo
correta. Se no, ajuste a preciso e largura do campo no Assistente de Arquivo Simples ou na definio
importada.

Importando Arquivos Simples Delimitados


Os arquivos simples delimitados sempre so orientados por caractere e possuem linhas sequenciais. A
coluna de preciso sempre medida em caracteres para colunas de string e em dgitos significativos para
colunas numricas. Cada linha termina com uma caractere de nova linha. Voc pode importar um arquivo
delimitado que no contm dados binrios ou dados de caractere multibyte com mais de dois bytes por
caractere.
Conclua as seguintes etapas para importar um arquivo delimitado para uma definio de origem ou de
destino.
1.

Para importar uma definio de origem, abra o Source Analyzer e clique em Origens > Importar um
Arquivo. Para importar uma definio de destino, abra o Target Designer e clique em Destinos >
Importar um Arquivo.
A caixa de dilogo Abrir Arquivo Simples exibida.

2.

Selecione o arquivo que deseja usar.

3.

Selecione uma pgina de cdigo.


Quando voc importar uma definio de origem de arquivo simples, selecione uma pgina de cdigo
dos dados no arquivo.

4.

Clique em OK.

Importao de Arquivos Simples

55

O contedo do arquivo exibido na janela de visualizao, na parte inferior do Assistente de Arquivo


Simples.
5.

6.

Edite as seguintes configuraes:


Assistente de Arquivo
Simples Delimitado,
etapa 1 de 3

Descrio

Tipo de Arquivo Simples

Tipo de arquivo. Selecione Delimitado para um arquivo delimitado.

Digite um nome para essa


origem

Nome da origem. Esse o nome da definio de origem no repositrio. Voc


pode usar o nome do arquivo ou qualquer outro nome lgico.

Iniciar Importao na
Linha

Indica o nmero da linha que o Assistente de Arquivo Simples comea a ler


quando importa o arquivo. Por exemplo, se voc especificar o incio na linha
2, o Assistente de Arquivo Simples ignorar a linha 1 antes da leitura.

Importar Nomes de
Campo da Primeira Linha

Se essa opo estiver selecionada, o Designer usar dados da primeira linha


como nomes de coluna. Selecione-a se os nomes de coluna aparecerem na
primeira linha. Nomes de campo invlidos so iniciados por "FIELD_".

Clique em Avanar.
O texto de qualquer campo analisado incorretamente exibido em vermelho na janela de visualizao
de arquivo, na parte inferior desta tela.

7.

56

Insira as seguintes configuraes:


Assistente de Arquivo
Simples Delimitado,
etapa 2 de 3

Descrio

Delimitadores

Caractere usado para separar colunas de dados. Use o campo Outro para
inserir um delimitador diferente. Os delimitadores devero ser caracteres
imprimveis diferentes do caractere de escape e de aspas, se estiverem
selecionados. No possvel selecionar caracteres multibyte no imprimveis
como delimitadores.

Tratar Delimitadores
Consecutivos como Um

Se essa opo estiver selecionada, o Assistente de Arquivo Simples ler um


ou mais delimitadores de coluna consecutivos como um s. Caso contrrio, o
Assistente de Arquivo Simples ler dois delimitadores consecutivos como um
valor nulo.

Tratar Vrios
Delimitadores como AND

Se essa opo estiver selecionada, o Assistente de Arquivo Simples ler um


conjunto especificado de delimitadores como um.

Caractere de escape

O caractere que precede imediatamente um caractere delimitador de coluna


inserido em uma cadeia sem aspas ou que precede imediatamente o
caractere de aspas em uma cadeia com aspas. Quando voc especifica um
caractere de escape, o Servio de Integrao l o caractere delimitador como
um caractere comum. Isso se chama escape do caractere delimitador ou de
aspas.

Remover Caracteres de
Escape dos Dados

Essa opo selecionada por padro. Desmarque-a para incluir o caractere


de escape na cadeia de sada.

Captulo 3: Trabalhando com Arquivos Simples

Assistente de Arquivo
Simples Delimitado,
etapa 2 de 3

Descrio

Usar Tamanho de Texto


Padro

Se essa opo estiver selecionada, o Assistente de Arquivo Simples usar o


tamanho de texto padro inserido para todos os tipos de dados.

Qualificador de Texto

O caractere de aspas que define os limites de cadeias de texto. Selecione


Sem Aspas, Aspas Simples ou Aspas Duplas. Se voc selecionar um
caractere de aspas, o Assistente de Arquivo Simples ignorar os
delimitadores entre as aspas.

8.

Clique em Avanar.

9.

Insira as informaes de coluna para cada coluna no arquivo.


Para alternar entre colunas, selecione uma nova coluna no painel Definio de Origem ou no painel
Definio de Destino ou clique no cabealho da coluna na visualizao do arquivo.
Assistente de
Arquivo
Simples
Delimitado,
etapas 3 de 3

Descrio

Nome

O nome da porta que voc quer exibir para cada coluna. Se voc selecionar Importar
Nomes de Campo da Primeira Linha, o assistente ler os nomes de coluna fornecidos
no arquivo.

Tipo de Dados

Tipo de dados de coluna. Selecione Texto, Numrico ou Datahora e insira Tamanho/


Preciso, Escala e Largura apropriados.
Em colunas numricas, Preciso o nmero de dgitos significativos. O Assistente de
Arquivo Simples ignora a largura de colunas numricas em arquivos delimitados.
Para colunas de texto, Preciso o nmero mximo de caracteres contidos no campo
de origem ou no campo de destino. O Assistente de Arquivo Simples ignora a preciso
quando l ou grava colunas de texto em arquivos delimitados.
Por padro, o Assistente de Arquivo Simples insere o mesmo valor para Preciso e
Largura. Voc pode alterar o valor da preciso ou da largura, mas o Assistente de
Arquivo Simples s permite que a preciso seja maior ou igual largura.
Nota: Somente os caracteres 0 a 9 so considerados numricos. As colunas que
contm nmeros de conjunto de caracteres multibyte, como no idioma japons, so
consideradas de texto.

10.

Clique em Concluir.
Nota: Se o tamanho do arquivo exceder 256 KB ou contiver mais de 16 KB de dados para cada linha,
verifique se o Assistente de Arquivo Simples importa o arquivo com a preciso de campo correta. Se
no, ajuste a preciso do campo no Assistente de Arquivo Simples ou na definio importada.

TPICOS RELACIONADOS:

Regras e Diretrizes para Configuraes do Arquivo Delimitado na pgina 66

Formatando Colunas de Arquivos Simples na pgina 67

Importao de Arquivos Simples

57

Editando Definies de Arquivos Simples


Depois de importar uma definio de origem de arquivo simples ou de destino, talvez voc precise adicionar
nomes comerciais e configurar as propriedades de arquivo. Alm disso, se a definio de arquivo alterar,
necessrio editar manualmente a definio.
Voc pode editar as definies de arquivo simples de origem ou de destino usando as guias de definio a
seguir:

Guia Tabela. Edite as propriedades, como o nome de tabela, o nome comercial e as propriedades de
arquivo simples.

Guia Colunas. Edite as informaes de coluna, como os nomes de coluna, os tipos de dados, a preciso
e os formatos.

Guia Propriedades. Exiba as propriedades padro de formato numrico e de data e hora no Source
Analyzer e no Target Designer. Voc pode editar essas propriedades em cada instncia de origem e
destino em um mapeamento no Mapping Designer.

Guia Extenses de Metadados. Estende os metadados armazenados no repositrio associando as


informaes a objetos do repositrio, como definies de arquivo simples.

Nota: Se a estrutura de arquivo de uma definio de origem altera significativamente, talvez voc precise
reimportar a definio de origem de arquivo.
Quando voc atualiza uma definio de origem ou de destino, o Designer propaga as alteraes para
qualquer mapeamento usando essa origem ou destino. Algumas alteraes nas definies de origem e de
destino podem invalidar mapeamentos. Se as alteraes invalidarem o mapeamento, voc dever valid-lo.
Voc pode validar os mapeamentos a partir da janela Resultados da consulta ou Exibio de dependncias
ou do Navegador do repositrio. Tambm possvel a validao de vrios objetos sem abri-los no espao de
trabalho. Se voc no puder validar o mapeamento a partir desses locais, abra e edite o mapeamento.
Ao criar sesses usando origem e destino de arquivos ou pesquisas, voc pode substituir algumas
propriedades definidas no Designer. Por exemplo, ao criar uma sesso com uma origem de arquivo, voc
pode especificar um local de arquivo de origem diferente do local usado ao importar a definio de origem de
arquivo.

Editando Opes de Tabela


possvel editar as seguintes opes na guia Tabelas de uma definio de origem ou destino do arquivo
simples:

Nome comercial. Adicione um nome mais descritivo definio de origem ou de destino.

Descrio. Adicione um comentrio ou link documentao comercial. Eles sero exibidos no


Repository Manager da definio de origem ou de destino. Adicionar comentrios ou links de
documentao comercial a uma origem ou destino uma maneira fcil de documentar sua finalidade.
possvel adicionar ou modificar comentrios a qualquer origem ou destino existente.
possvel inserir at (2.000 bytes)/K caracteres na descrio, onde K o nmero mximo de bytes de
um caractere da pgina de cdigo de repositrio selecionada. Por exemplo, se a pgina de cdigo do
repositrio for em japons, em que K = 2, cada campo de descrio e comentrio pode conter at 1.000
caracteres.

58

Palavras-Chave. Controlar destinos de arquivo simples com palavras-chave. Conforme o trabalho de


desenvolvimento e manuteno prosseguir, o nmero de destinos aumentar. Embora todos esses
destinos possam aparecer na mesma pasta, todos eles podem atender a fins diversos. As palavras-chave

Captulo 3: Trabalhando com Arquivos Simples

podem ajud-lo a localizar destinos relacionados. Palavras-chave podem incluir nomes de


desenvolvedores, mapeamentos ou o esquema associado.
Use as palavras-chave para executar pesquisas no Repository Manager.

Tipo de banco de dados. Defina o tipo de origem ou destino. Escolha Arquivo Simples para origens e
destinos de arquivo simples.

Informaes de arquivo simples. Quando o tipo de banco de dados for de arquivo simples, defina as
propriedades de arquivo simples clicando no boto Avanado.

Para adicionar opes a uma definio de origem ou destino de arquivo simples:


1.

Para adicionar opes a uma definio de origem, clique duas vezes na barra de ttulo da definio de
origem, no Source Analyzer. Para adicionar opes a uma definio de destino, clique duas vezes com
o boto do mouse na barra de ttulo da definio de destino, no Target Designer.
A caixa de dilogo Editar Tabelas aparecer.

2.

Clique no boto Renomear para editar o nome de origem ou destino e o nome comercial.

3.

Escolha Arquivo Simples no campo Tipo de Banco de Dados.

4.

Clique no boto Avanado para editar as propriedades do arquivo simples.


Outra caixa de dilogo aparece para arquivos de largura fixa e delimitados.

5.

Para adicionar uma descrio, digite a descrio no campo Descrio.

6.

Para adicionar palavras-chave s definies de destino, clique em Editar Palavras-Chave.


A caixa de dilogo Editar Palavras-Chave aparecer. Use os botes para criar e mover palavras-chave.

TPICOS RELACIONADOS:

Importao de Arquivos Simples de Largura Fixa na pgina 53

Importando Arquivos Simples Delimitados na pgina 55

Editando Colunas
Voc pode editar as seguintes informaes na guia Colunas de uma definio de origem ou destino do
arquivo simples:

Nome da coluna. Os nomes de colunas na origem ou destino do arquivo simples.

Colunas de nome de arquivo. Voc pode adicionar uma coluna de nome de arquivo a uma origem ou
destino do arquivo simples. Para as origens, use a coluna CurrentlyProcessedFileName para retornar os
nomes dos arquivos de origem a partir dos quais as linhas de dados foram lidas. Use esta coluna se voc
configurar a sesso para ler os dados de uma lista de arquivos. Para os destinos, use a coluna FileName
para nomear dinamicamente os destinos de arquivo simples.

Tipo de dados. O tipo de dados da coluna. Para os arquivos simples, voc pode escolher bigint,
datetime, double, int, nstring, number ou string.

Preciso, escala e formato. Ao importar definies de arquivo, frequentemente voc precisa considerar
a preciso, escala, largura do campo e formato dos valores em cada coluna. Voc pode editar a largura e
o formato do campo clicando na coluna Formato. Insira a preciso, a escala e o formato.

Not Null. Escolha se voc deseja permitir dados nulos na origem ou destino.

Tipo de chave. Escolha NOT A KEY para as definies de origem e destino do arquivo simples.

Tecla Shift. Voc pode definir o estado da mudana para as origens de arquivo simples de largura fixa e
sensveis ao Shift, que no contm teclas Shift. Este atributo aparece quando voc seleciona o Estado de

Editando Definies de Arquivos Simples

59

Shift Definido pelo Usurio na caixa de dilogo Editar Informaes do Arquivo Simples, para os arquivos
de largura fixa.
Escolha Shift-In se a coluna contiver caracteres de byte nico. Escolha Shift-Out se a coluna contiver
caracteres multibyte.

Nome comercial. Se preferir, voc pode adicionar nomes comerciais a cada campo de origem ou
destino.

Nota: Se as colunas do arquivo para uma definio de origem ou pesquisa mudarem significativamente,
poder ser necessrio importar o arquivo novamente.
Para editar as colunas de definies da origem ou destino do arquivo simples:
1.

Para editar uma definio de origem, no Source Analyzer, clique duas vezes na barra de ttulo da
definio da origem do arquivo simples. Para editar uma definio de origem do arquivo simples, no
Target Designer, clique duas vezes na barra de ttulo da definio de destino do arquivo simples.

2.

Clique na guia Colunas.

3.

Configure as opes da definio de origem ou destino conforme descrito acima.

4.

Se voc deseja adicionar colunas, selecione uma coluna e clique em Adicionar.

5.

Insira o nome, tipo de dados e outras caractersticas da coluna.


Repita essas etapas para cada coluna que voc deseja adicionar definio de origem ou destino.

6.

Se voc deseja mover uma coluna, use os botes Para Cima e Para Baixo ou arraste-a dentro da lista
de rolagem.

Atualizando Propriedades de Arquivo de Largura Fixa


Aps importar um arquivo de largura fixa, voc pode atualizar as propriedades do arquivo. Clique duas vezes
na barra de ttulo da definio de origem ou destino. Edite a tabela e as informaes da coluna.
Para editar propriedades do arquivo, clique no boto Avanado na guia Tabela. A caixa de dilogo Editar
Informaes de Arquivo Simples - Arquivos de Largura Fixa exibida. A caixa de dilogo Editar Informaes
de Arquivo Simples - Arquivos de Largura Fixa contm mais opes de origens de arquivos do que de
destinos de arquivos. Por exemplo, ela contm informaes de que o Servio de Integrao precisa para ler
o arquivo, como o nmero de linhas iniciais a ignorar ou o nmero de bytes entre linhas.

60

Captulo 3: Trabalhando com Arquivos Simples

A tabela a seguir descreve as propriedades do arquivo de largura fixa que voc pode configurar para
definies de origem, destino e pesquisa:
Configurao
Avanada de
Largura Fixa

Descrio de Origens e Pesquisas

Descrio de Destinos

Caractere Nulo

Caractere usado no arquivo de origem para


representar valor nulo. Esse caractere pode
ser qualquer um vlido na pgina de cdigo
do arquivo ou qualquer valor binrio de 0 a
255.

Caractere que o Servio de Integrao


utiliza no arquivo de destino para
representar um valor nulo. Pode ser
qualquer caractere vlido na pgina de
cdigo do arquivo.

Repetir Caractere
Nulo

Se selecionada, o Servio de Integrao ler


caracteres nulos repetidos em um nico
campo como um nico valor nulo. Ao
especificar um caractere nulo multibyte e
selecionar Repetir Caractere Nulo, o campo
pode conter bytes extras direita se o
tamanho do campo no for divisvel
uniformemente pelo nmero de bytes no
caractere nulo. Nesse caso, o campo no
nulo. Voc deve sempre especificar um
caractere nulo de um byte.

Se selecionado, o Servio de Integrao


grava quantos caracteres nulos forem
possveis no campo de destino. Se voc
no selecionar essa opo, o Servio de
Integrao inserir um um nico
caractere nulo no comeo do campo para
representar um valor nulo.

Pgina de Cdigo

Pgina de cdigo da definio do arquivo.


Em definies de origem, use uma pgina de
cdigo de origem que seja um subconjunto da
pgina de cdigo de destino.
Em definies do arquivo de pesquisa, use
uma pgina de cdigo que seja um
superconjunto da pgina de cdigo de origem
e um subconjunto da pgina de cdigo de
destino.

Se voc especificar um caractere nulo de


vrios bytes e houver bytes extra
restantes aps gravar caracteres nulos, o
Servio de Integrao [preenche] a
coluna com espaos de byte nico. Se
uma coluna no for grande o suficiente
para conter um caractere nulo por ser
menor do que o caractere multibyte
especificado como o caractere nulo,
haver falha na inicializao da sesso.
Pgina de cdigo da definio do
arquivo.
Use uma pgina de cdigo que seja
superconjunto da pgina de cdigo de
origem.

Sequencial em
Linha

Se selecionado, o Servio de Integrao l o


caractere de avano de linha ou de retorno de
carro na ltima coluna como sendo o final da
coluna. Use essa opo se o arquivo usar
avanos de linha ou retornos de carro para
encurtar a ltima coluna de cada linha.

n/d

Nmero de Linhas
Iniciais a Ignorar

Indica o nmero de linhas que o Servio de


Integrao ignora quando l o arquivo. Use
essa configurao para ignorar linhas em
branco ou de cabealho. Uma linha pode
conter vrios registros.

n/d

Insira qualquer nmero inteiro de 0 a


2.147.483.647.

Editando Definies de Arquivos Simples

61

Configurao
Avanada de
Largura Fixa

Descrio de Origens e Pesquisas

Descrio de Destinos

Nmero de Bytes a
Ignorar entre
Registros

Nmero de bytes entre a ltima coluna de


uma linha e a primeira coluna da prxima. O
Servio de Integrao ignora o nmero de
bytes inseridos no final de cada linha para
impedir a leitura de caracteres de retorno de
carro ou avano de linha. Insira 1 para
arquivos UNIX e 2 para arquivos DOS.

n/d

Remover Espaos
em Branco de
Trilha

Se selecionada, o Servio de Integrao


remover os espaos em branco de trilha dos
valores da cadeia.

n/d

Estado de
Deslocamento
Definido pelo
Usurio

Se selecionado, voc pode definir o estado de


deslocamento de colunas de origem na guia
Colunas.

n/d

Selecione Estado de Deslocamento Definido


pelo Usurio quando o arquivo de origem
contiver dados multibytes e de um byte, mas
no contiver chaves de deslocamento para
dentro e para fora. Se uma origem de arquivo
multibyte no contiver chaves de
deslocamento, voc dever definir os estados
da chave de deslocamento para cada coluna
na definio de origem do arquivo simples
para que o Servio de Integrao possa ler
cada caractere corretamente.

Tratamento de Caracteres Nulos


Voc pode especificar caracteres nulos de um byte ou multibyte para origens de arquivo de largura fixa. Ao
ler um arquivo de origem de largura fixa, o Servio de Integrao usa esses caracteres para determinar se a
coluna nula. Ao gravar em um arquivo de destino de largura fixa, o Servio de integrao usa esses
caracteres para representar valores nulos.

62

Captulo 3: Trabalhando com Arquivos Simples

A tabela a seguir descreve como o Servio de Integrao usa as propriedades Caractere Nulo e Repetir
Caractere Nulo para determinar se uma coluna nula:
Caractere
Nulo

Repetir
Caractere
Nulo

Comportamento do Servio de
Integrao ao Ler de Origens e
Pesquisas

Comportamento do Servio de
Integrao ao Gravar em Destinos

Binrio

Desabilitad
o

Uma coluna nula se o primeiro byte


na coluna o caractere nulo binrio. O
Servio de Integrao l o restante da
coluna como dados de texto para
determinar o alinhamento de coluna e
rastrear o estado de mudana de
pginas de cdigo sensveis ao Shift.
Se os dados na coluna estiverem
desalinhados, o Servio de Integrao
ignora a linha e grava a linha ignorada
e uma mensagem de erro
correspondente em um log de sesso.

O Servio de Integrao insere um


caractere nulo binrio nico no incio
do campo para representar o valor
nulo.

No binrio

Desabilitad
o

Uma coluna ser nula se o primeiro


caractere na coluna for o caractere
nulo. O Servio de Integrao l o
restante da coluna para determinar o
alinhamento de coluna e rastrear o
estado de mudana para pginas de
cdigo sensveis tecla shift. Se os
dados na coluna estiverem
desalinhados, o Servio de Integrao
ignora a linha e grava a linha ignorada
e uma mensagem de erro
correspondente em um log de sesso.

Se houver bytes excedentes aps


gravar o caractere nulo, o Servio de
Integrao encher a coluna com
espaos de um byte.

O Servio de Integrao insere um


caractere nulo nico no incio do
campo para representar o valor nulo.
Se voc especificar um caractere nulo
multibyte e houver bytes extras
restantes aps gravar o caractere nulo,
o Servio de Integrao preencher a
coluna com espaos de byte nico. Se
uma coluna no for grande o suficiente
para conter um caractere nulo por ser
menor do que o caractere multibyte
especificado como o caractere nulo,
haver falha na inicializao da
sesso.

Binrio

Habilitado

Uma coluna nula se contm apenas o


caractere nulo binrio especificado. A
prxima coluna herda o estado de
mudana inicial da pgina de cdigo.

O Servio de Integrao grava quantos


caracteres nulos binrios forem
possveis no campo de destino.

No binrio

Habilitado

Uma coluna nula se o caractere nulo


repetido se ajusta na coluna
exatamente, sem nenhum byte
restante. Por exemplo, uma coluna de
cinco bytes no nula se voc
especificar um caractere nulo repetido
de dois bytes.

O Servio de Integrao grava quantos


caracteres nulos binrios forem
possveis no campo de destino.

Em pginas de cdigo sensveis tecla


shift, os bytes de shift no afetam o
valor nulo de uma coluna. Se uma
coluna contm um byte de
deslocamento no incio ou no final da
coluna e o caractere nulo repetitivo se
ajusta coluna sem nenhum byte
restante, a coluna nula.

Se voc especificar um caractere nulo


multibyte e houver bytes extras
restantes aps gravar os caracteres
nulos, o Servio de Integrao
preencher a coluna com espaos de
byte nico.
Se uma coluna no for grande o
suficiente para conter um caractere
nulo por ser menor do que o caractere
multibyte especificado como o
caractere nulo, haver falha na
inicializao da sesso.

Especifique um caractere nulo de byte


nico ao usar caracteres nulos no
binrios repetidos. Isso garantir que
caracteres nulos repetidos caibam
exatamente na coluna.

Editando Definies de Arquivos Simples

63

Atualizando Propriedades de Arquivo Delimitado


Depois de importar um arquivo delimitado, voc pode atualizar as propriedades do arquivo. Clique duas
vezes na barra de ttulo da definio de origem ou destino. Edite a tabela e as informaes da coluna.
Para editar propriedades do arquivo, clique no boto Avanado na guia Tabela. A caixa de dilogo Editar
Informaes de Arquivo Simples - Arquivos Delimitados exibida. A caixa de dilogo Editar Informaes de
Arquivo Simples - Arquivos Delimitados contm mais opes de origens de arquivos do que de destinos de
arquivos. Por exemplo, ele contm informaes sobre a necessidade que o Servio de Integrao tem de ler
o arquivo, como o nmero de linhas iniciais para ignorar ou o caractere de escape.
A tabela a seguir descreve as propriedades de arquivo delimitado que voc pode configurar:

64

Configuraes
Avanadas de
Arquivo Delimitado

Descrio de Origens e Pesquisas

Descrio de Destinos

Delimitadores de
Coluna

Caractere usado para colunas separadas


de dados. Delimitadores podem ser
caracteres imprimveis ou no imprimveis
de um nico byte e devem ser diferentes
do caractere de escape e do caractere de
aspas, se selecionado. Para inserir um
caractere no imprimvel de um nico
byte, clique no boto Procurar direita
desse campo. Na caixa de dilogo
Delimitadores, selecione um caractere
no imprimvel na lista Inserir Delimitador
e clique em Adicionar. Voc no pode
selecionar caracteres de vrios bytes no
imprimveis como delimitadores.

Caractere usado para colunas separadas


de dados. Os delimitadores podem ser
caracteres imprimveis ou no imprimveis
de um byte, e devem ser diferentes do
caractere de aspas, se selecionado. Para
inserir um caractere no imprimvel de um
nico byte, clique no boto Procurar
direita desse campo. Na caixa de dilogo
Delimitadores, selecione um caractere
no imprimvel na lista Inserir Delimitador
e clique em Adicionar. Voc no pode
selecionar caracteres de vrios bytes no
imprimveis como delimitadores. Se voc
inserir mais de um delimitador, o Servio
de Integrao usa o primeiro
especificado.

Tratar Delimitadores
Consecutivos como
Um

Se estiverem selecionados, o Servio de


Integrao considerar um ou mais
delimitadores de coluna consecutivos
como apenas um. Caso contrrio, o
Servio de Integrao ler dois
delimitadores consecutivos como um
valor nulo.

n/d

Tratar Vrios
Delimitadores como
AND

Se selecionado, o Servio de Integrao


trata um conjunto especificado de
delimitadores como um. Por exemplo, um
arquivo de origem contendo o seguintes
registro: abc~def|ghi~|~|jkl|~mno. Por
padro, o Servio de Integrao l o
registro como nove colunas separadas
por oito delimitadores: abc, def, ghi,
NULL, NULL, NULL, jkl, NULL, mno. Se
voc selecionar essa opo e especifica
o delimitador como ( ~ | ), o Servio de
Integrao l o registro como trs colunas
separadas por dois delimitadores:
abc~def|ghi, NULL, jkl|~mno.

n/d

Captulo 3: Trabalhando com Arquivos Simples

Configuraes
Avanadas de
Arquivo Delimitado

Descrio de Origens e Pesquisas

Descrio de Destinos

Aspas opcionais

Selecione Sem Aspas, Aspas Simples ou


Aspas Duplas. O caractere de aspas que
define os limites de strings de texto.
Aspas duplas o padro.

Selecione Sem Aspas, Aspas Simples ou


Aspas Duplas. O caractere de aspas que
define os limites de strings de texto.
Aspas duplas o padro.

Se selecionado, o Servio de Integrao


ignora os delimitadores de coluna dentro
do caractere de aspas.

Se voc selecionar um caractere de


aspas, o Servio de Integrao no
tratar caracteres delimitadores de coluna
dentro do caractere de aspas como um
delimitador.

Por exemplo, um arquivo de origem usa


uma vrgula como delimitador e o Servio
de Integrao l a seguinte linha do
arquivo de origem: 342-3849, Smith,
Jenna, Rockville, MD, 6.
Se voc selecionar o caractere de aspas
simples opcional, o Servio de Integrao
ignorar as vrgulas dentro das aspas e
ler a linha como quatro campos.

Pgina de Cdigo

Delimitador de Linha

Por exemplo, um arquivo de destino usa


uma vrgula como delimitador e o Servio
de Integrao grava a seguinte linha no
arquivo de origem: 342-3849, Smith,
Jenna, Rockville, MD, 6.
Se voc selecionar o caractere de aspas
simples opcional, o Servio de Integrao
ignorar as vrgulas dentro das aspas e
gravar a linha como quatro campos.

Se voc no selecionar as aspas simples


opcionais, o Servio de Integrao ler
seis campos separados.
Nota: Voc pode aprimorar o
desempenho da sesso se o arquivo de
origem no contiver aspas ou caracteres
de escape.

Se voc no selecionar as aspas simples


opcionais, o Servio de Integrao
gravar seis campos separados.

Pgina de cdigo da definio do arquivo.

Pgina de cdigo da definio do arquivo.

Em definies de origem, use uma pgina


de cdigo de origem que seja um
subconjunto da pgina de cdigo de
destino. Em definies do arquivo de
pesquisa, use uma pgina de cdigo que
seja um superconjunto da pgina de
cdigo de origem e um subconjunto da
pgina de cdigo de destino.

Use uma pgina de cdigo que seja


superconjunto da pgina de cdigo de
origem.

Especifique um caractere de quebra de


linha. Selecione na lista ou insira um
caractere. Inicie um cdigo octal com uma
barra invertida (\). Para usar um caractere
nico, digite o caractere.

n/d

O Servio de Integrao usa somente o


primeiro caractere quando a entrada no
precedida por uma barra invertida. O
caractere deve ser um caractere de byte
nico, e nenhum outro caractere na
pgina de cdigo pode conter esse byte.
O padro alimentao de linha, \012 LF
(\n).

Editando Definies de Arquivos Simples

65

Configuraes
Avanadas de
Arquivo Delimitado

Descrio de Origens e Pesquisas

Descrio de Destinos

Caractere de Escape

Caractere usado para escapar de um


caractere delimitador em uma string sem
aspas se o delimitador o prximo
caractere depois do caractere de escape.
Se selecionado, o Servio de Integrao
l o caractere delimitador como um
caractere comum embutido em uma
string, chamado escape do caractere
delimitador.
Nota: Voc pode aprimorar o
desempenho da sesso se o arquivo de
origem no contiver aspas ou caracteres
de escape.

n/d

Remover Caracteres
de Escape nos Dados

Essa opo selecionada por padro.


Desmarque essa opo para incluir o
caractere de escape na string de sada.

n/d

Nmero de Linhas
Iniciais a Ignorar

Indica o nmero de linhas que o Servio


de Integrao ignora quando l o arquivo.
Use essa configurao para ignorar
linhas em branco ou de cabealho.

n/d

Regras e Diretrizes para Configuraes do Arquivo Delimitado


Arquivos delimitados so orientados por caracteres e sequenciais para linhas. Use as seguintes regras e
diretrizes ao configurar arquivos delimitados:

O caractere delimitador de coluna e linha, o de aspas e o de escape devem ser diferentes para uma
definio de origem. Estas propriedades tambm devem estar contidas na pgina de cdigo do arquivo
de origem ou destino.

O caractere de escape e os delimitadores devem ser vlidos na pgina de cdigo do arquivo de origem
ou destino.

Use as seguintes regras e diretrizes ao configurar origens de arquivos delimitados:

Em uma cadeia de caracteres com aspas, use o caractere de escape para fechar o caractere de aspas.
Se o caractere de escape no preceder um caractere de aspas imediatamente, o Servio de Integrao l
o caractere de escape como um caractere ordinrio.

Use um caractere de escape para fechar o delimitador de coluna. No entanto, em uma cadeia de
caracteres com aspas, voc no precisa usar um caractere de escape para fechar o delimitador, uma vez
que as aspas cumprem este objetivo. Se o caractere de escape no preceder um caractere delimitador
imediatamente, o Servio de Integrao ler o caractere de escape como um caractere ordinrio.

Quando dois caracteres de aspas sucessivos aparecem dentro de uma cadeia de caracteres com aspas,
o Servio de Integrao os l como um caractere de aspas. Por exemplo, o Servio de Integrao l a
string com aspas a seguir como Irei amanh:
2353,Im going tomorrowMD

66

O Servio de Integrao l uma cadeia de caracteres como tendo aspas somente se o caractere de
aspas que voc selecionar for o primeiro do campo.

Se o comprimento do campo excede o tamanho da coluna definido na transformao Qualificador de


Origem, o Servio de Integrao trunca o campo.

Captulo 3: Trabalhando com Arquivos Simples

Se a linha de dados excede o maior entre os comprimentos de buffer sequencial da linha, ou o tamanho
total da linha definido na transformao Qualificador de Origem, o Servio de Integrao descarta a linha
e a escreve no arquivo de log da sesso. Para determinar o tamanho da linha definido na transformao
Qualificador de Origem, adicione a preciso da coluna e os delimitadores e ento multiplique o total pelos
bytes mximos por caractere.

Formatando Colunas de Arquivos Simples


Ao importar ou editar definies de arquivo simples, voc precisa definir as seguintes opes de coluna:

Preciso. A preciso definida de formas diferentes para tipos de dados distintos.

Escala. Escala o nmero mximo de dgitos aps a vrgula decimal de valores numricos.

Largura de campo. A largura do campo o nmero de bytes que o Servio de Integrao l ou grava em
um arquivo. Aplica-se apenas s definies de arquivo com largura fixa. A largura do campo deve ser
maior ou igual preciso.
A tabela a seguir descreve a preciso e a largura do campo para definies de arquivo simples:
Tipo de
dados
Nmero

Arquivos simples com largura fixa

Arquivos simples
delimitados

A preciso o nmero de dgitos significativos.

A preciso o nmero de
dgitos significativos.

A largura do campo o nmero de bytes que o Servio de


Integrao l ou grava em um arquivo. Por padro, a largura
do campo igual preciso.
Use a coluna Formato para definir a largura do campo.
Quando voc configurar a largura do campo, acomode os
caracteres como separadores de milhar, decimais e sinais
negativos. Por exemplo, 123,456 possui uma largura igual
a 8.
Datetime

No insira um valor de preciso.

O Servio de Integrao
ignora qualquer
formatao de largura de
campo.

No insira um valor de
preciso.

A largura do campo o nmero de bytes que o Servio de


Integrao l ou grava em um arquivo.
O formato de data e hora especificado para a coluna
determina a largura do campo. Por exemplo, o formato de
data e hora padro de MM/DD/AAAA HH24:MI:SS possui uma
largura de campo igual a 19.

O Servio de Integrao
ignora qualquer
formatao de largura de
campo.

Use a coluna Formato para definir o formato e a largura do


campo.
String

A preciso do campo o nmero de bytes que o Servio de


Integrao l ou grava em um arquivo.

A preciso do campo o
nmero mximo de
caracteres que o Servio
de Integrao l ou grava
em um arquivo.

No insira uma largura de campo para valores de string. A


preciso o tamanho total do campo de origem ou de
destino.
Nota: Se voc planeja carregar dados multibyte em um
destino de arquivo de largura fixa, configure a preciso para
acomodar os dados multibyte.

No insira uma largura de


campo.

Formato. O formato define a aparncia dos valores numricos e de data e hora.

Formatando Colunas de Arquivos Simples

67

Para os valores de data e hora, voc pode escolher exibir apenas a data ou partes da hora dos dados.
Por exemplo, voc pode configurar a definio de arquivo para os dados de data e hora com o seguinte
formato:
03/2002
Para valores numricos, voc pode escolher separadores decimais e de milhar. Por exemplo, possvel
configurar a definio de arquivo para dados numricos com o seguinte formato:
1.000.000,95
Nota: Se a estrutura do arquivo de origem mudar significativamente, talvez seja necessrio importar
novamente a definio da origem de arquivo simples.
Voc pode definir a aparncia das colunas numricas e de data e hora nos seguintes locais:
- No campo de origem ou de destino. Voc pode definir o formato de colunas individuais na guia

Colunas para a origem no Source Analyzer ou para o destino no Target Designer.


- A instncia de origem ou de destino em um mapeamento. Voc pode definir os formatos numricos

e de data e hora padro para uma instncia de origem ou de destino em um mapeamento no Mapping
Designer. O Servio de Integrao usa os formatos padro que voc definiu quando no houver um
formato definido para uma coluna individual.

Formatando Colunas Numricas


Ao editar definies de arquivos simples, possvel definir formatos de valores numricos com o tipo de
dados Nmero. Tipos de dados bigint, duplo e inteiro tm um padro de preciso, de escala e de formato.
Voc pode mudar a preciso de uma coluna que um tipo de dados inteiro ou duplo.
Use Formatar coluna na guia Colunas da definio de origem ou de destino de um arquivo simples para
definir o formato de valores numricos.
Voc pode definir as seguintes opes de formatao de valores numricos na caixa de dilogo
Configuraes de Formato de Coluna:

Dados numricos

Largura de campo

Quando voc define opes de formatao na caixa de dilogo Configuraes de Formato de Coluna, o
Designer mostra as opes que foram definidas na coluna Formatar da guia Colunas.

Dados Numricos
Voc pode definir os separadores decimais e de milhar na rea de dados numricos da caixa de dilogo
Configuraes de formato de coluna. possvel selecionar uma vrgula ou um ponto para o separador
decimal. O padro o ponto. possvel selecionar nenhum separador, uma vrgula ou um ponto para o
separador de milhares. O padro sem separador.
Para especificar os separadores numricos, clique em Substituir separadores e escolha um separador a
partir dos campos Separador Decimal e Separador de Milhar. Voc pode substituir um ou ambos os
separadores. Quando voc substitui os separadores, necessrio escolher opes diferentes para cada um.
Por exemplo, os dados de origem contm um campo numrico com os seguintes dados:
9.999.999,00
5.000.000,00
Escolha o ponto como o separador de milhar, e a vrgula como o separador decimal na definio de origem
de arquivo simples.

68

Captulo 3: Trabalhando com Arquivos Simples

Por exemplo, se desejar transmitir os dados acima para um destino de arquivo com o seguinte formato:
9,999,999.00
Escolha a vrgula como o separador de milhares, e o ponto como o separador decimal na definio de
destino de arquivo simples.

Largura do Campo
Voc pode alterar a largura do campo na caixa de dilogo Configuraes de Formato de Coluna,
preenchendo a largura ou definindo um valor para largura fixa em bytes. Por padro, a largura do campo
igual preciso.
Para carregar dados multibytes no destino de um arquivo simples com largura fixa, configure a preciso para
acomodar os dados multibytes. Se os dados de um campo de destino forem muito longos para a largura do
campo, o Servio de Integrao rejeita a linha e grava uma mensagem no registro da sesso. Ao configurar
a largura do campo para definies de destino de arquivo simples, voc deve acomodar os caracteres que o
Servio de Integrao grava no arquivo de destino, como casas decimais e sinais negativos.
Para ajustar a largura do campo, selecione Ajustar Largura e insira o nmero de bytes no campo
Preenchimento. Quando voc ajusta a largura do campo, o Servio de Integrao define a largura do campo
como a preciso do campo mais o preenchimento que voc inseriu. Por exemplo, quando a preciso de um
campo for 10 e voc inserir 5 no campo Preenchimento, o Servio de Integrao l 15 bytes de uma origem
de arquivo e grava 15 bytes em um destino de arquivo.
Para fixar a largura do campo, selecione Largura Fixa e insira o nmero de bytes no campo Largura do
Campo. O Designer permite que voc insira uma largura de campo maior ou igual preciso. Quando voc
digita 20 no campo Largura do Campo, o Servio de Integrao l 20 bytes de uma origem de arquivo e
grava 20 bytes em um destino de arquivo.
Por exemplo, voc tem um campo de destino com uma preciso igual a quatro e escala igual a zero. Voc
deseja adicionar dois espaos em branco ao campo de destino para facilitar a visualizao do arquivo de
destino. Selecione Ajustar Largura e insira 2 no campo Preenchimento. Ou, selecione Largura Fixa e insira 6
no campo Largura do Campo.
Quando preenche dados numricos em destinos de arquivo simples, o Servio de Integrao adiciona
espaos em branco esquerda da coluna de destino.
Nota: Talvez voc queira ajustar a largura do campo para um campo de destino se achar que outro usurio
pode alterar a preciso do campo. Quando a preciso alterada, a largura do campo ajustada de acordo.

Coluna de Formato
Ao substituir os separadores numricos ou definir a largura do campo, o Designer mostra as opes
definidas na coluna Formato na guia Colunas. Por exemplo, voc tem uma coluna numrica com preciso de
cinco. Clique na coluna Formato e defina as opes na caixa de dilogo Configuraes de Formato da
Coluna.

Formatando Colunas de Arquivos Simples

69

A figura a seguir mostra as opes de formato que o Designer exibe na coluna Formato:

O Designer exibe N.NNN(F 6.5).NN na coluna Formato da coluna PRICE (PREO). N,NNN exibe o
separador de milhares especificado. F indica uma largura de campo fixa. E exibe "A" quando voc ajusta a
largura de campo. 6,5 a largura de campo e a preciso em bytes. O primeiro nmero a largura de
campo, o segundo a preciso. .NN exibe o separador decimal especificado.
Nota: Se voc no definir separadores de decimais e de milhares para um campo de origem ou de destino
especfico, o Servio de Integrao usar os separadores especificados na instncia de origem ou de
destino no Mapping Designer.

TPICOS RELACIONADOS:

Definio de Formatos de Data e Hora e Numricos Padro na pgina 72

Formatando Colunas de Data e Hora


Ao editar as definies de arquivo simples, voc pode definir os formatos dos valores de data e hora. Use
Formatar coluna na guia Colunas da definio de origem ou de destino de um arquivo simples para definir o
formato de valores de data e hora.
Voc pode definir as seguintes opes de formatao de valores de data e hora na caixa de dilogo
Configuraes de Formato de Coluna:

String de formato

Largura de campo

Quando voc define opes de formatao na caixa de dilogo Configuraes de Formato de Coluna, o
Designer mostra as opes que foram definidas na coluna Formatar da guia Colunas.

String de Formato
Voc pode inserir qualquer formato de data e hora no campo String de Formato na caixa de dilogo
Configuraes de Formato da Coluna. Por exemplo, voc pode especificar o formato de data e hora como
MM/AAAA. Ou pode especificar somente a hora, por exemplo, HH24:MI.

70

Captulo 3: Trabalhando com Arquivos Simples

Para especificar o formato de data e hora, escolha Format String e insira o formato no campo de mesmo
nome. possvel escolher um formato da lista ou inserir um formato usando o teclado. O formato padro
DD/MM/AAAA HH24:MI:SS, com largura de campo de 19.
Por exemplo, os dados de origem contm um campo de data e hora com os seguintes dados:
11/28/2002
10/15/2003
Insira o seguinte formato na definio de origem do arquivo simples: MM/DD/AAAA.
Por exemplo, se desejar transmitir os dados acima para um destino de arquivo com o seguinte formato:
28-11-2002
15-10-2003
Insira o seguinte formato na definio de destino do arquivo simples: DD-MM-AAAA.
Voc pode inserir qualquer literal de string de um byte ou multibyte no campo Format String. Para inserir
uma literal de string, coloque-a entre aspas duplas (""). Quando voc insere literais de string na sequncia
de formato, o Servio de Integrao grava as strings no destino de arquivo quando ele executa a sesso.
Voc pode desejar adicionar literais de string para descrever partes de data distintas.
Por exemplo, voc insere o seguinte texto no campo Format String:
MonthMM/DayDD/YearYYYY
Ao executar a sesso e o Servio de Integrao transmitir a data 21 de outubro de 2002, ele grava o
seguinte no arquivo de destino:
Month10/Day21/Year2002

Largura do Campo
Voc pode definir a largura de campo depois que definir a cadeia de caracteres de formato. possvel
alterar a largura de campo preenchendo a largura ou definindo um valor de largura fixa em bytes. Por
padro, a largura do campo igual preciso.
Para ajustar a largura de campo depois de digitar uma cadeia de caracteres de formato, selecione Ajustar
largura e digite o nmero de bytes no campo Preenchimento. Quando voc ajusta a largura de campo, o
Servio de Integrao define a largura de campo para o nmero de bytes exigidos pelo formato data e hora e
o preenchimento digitado. Por exemplo, quando o formato data e hora MM/AAAA e voc digita 5 no campo
Preenchimento de uma origem de arquivo simples, o Servio de Integrao l 12 bytes do arquivo. Quando o
formato data e hora MM/AAAA e voc digita 5 no campo Preenchimento de um destino de arquivo simples,
o Servio de Integrao l 12 bytes para o arquivo.
Quando voc usa Ajustar largura, o Servio de Integrao ajusta a largura de campo com base na cadeia de
caracteres de formato. possvel alterar a cadeia de caracteres de formato sem ajustar manualmente a
largura de campo.
Para corrigir a largura de campo depois de digitar uma cadeia de caracteres de formato, selecione Largura
fixa e digite o nmero de bytes no campo Largura fixa. Voc deve especificar um valor de largura fixa maior
que ou igual ao nmero de bytes exigidos pelo formato data e hora ou o Servio de Integrao trunca os
dados. Por exemplo, quando o formato data e hora MM/DD/AAAA HH24:MI:SS.NS, especifique um valor
de largura fixa maior ou igual a 29. Quando voc digita 21 no campo Largura do Campo, o Servio de
Integrao l 21 bytes de uma origem de arquivo e grava 20 bytes em um destino de arquivo.
Por exemplo, voc tem um campo de destino com formato de data e hora MM/DD/AAAA, que exige 10 bytes.
Voc deseja adicionar dois espaos em branco ao campo de destino para facilitar a visualizao do arquivo
de destino. Selecione Ajustar Largura e insira 2 no campo Preenchimento. Ou, selecione Largura Fixa e
insira 12 no campo Largura do Campo.
Nota: Quando preenche dados de data e hora em destinos de arquivo simples, o Servio de Integrao
adiciona espaos em branco direita da coluna de destino.
Formatando Colunas de Arquivos Simples

71

Coluna de Formato
Quando voc seleciona um formato de data e hora ou define a largura de campo, o Designer mostra as
opes definidas na coluna Formato na guia Colunas. Por exemplo, voc define as opes na caixa de
dilogo Configuraes de Formato de Coluna.
A figura a seguir mostra as opes que o Designer exibe na coluna Formato:

O Designer exibe A 30 MM/DD/AAAA HH24:MI:SS.US na coluna Formato para a porta DATE. O "A" indica que
a largura de campo foi ajustada. 30 a largura de campo em bytes: 26 bytes para preciso em
microssegundos, mais 4 bytes para o preenchimento.
Nota: Se voc no definir um formato de data e hora para um campo de origem ou de destino, o Servio de
Integrao usa o formato especificado na instncia de origem ou de destino no mapeamento.

Definio de Formatos de Data e Hora e Numricos Padro


Quando voc usar uma definio de origem ou de destino de um arquivo simples em um mapeamento,
poder definir o formato padro de colunas numricas e de data e hora no arquivo. O Servio de Integrao
usa os formatos padro que voc define quando no houver um formato definido para uma coluna individual.
Se voc no definir os formatos padro, o Servio de Integrao usar os seguintes formatos:
Formato

Descrio

Formato de Data e
Hora

Formato data e hora. O padro MM/DD/YYYY HH24:MI:SS.

Separador de
milhares

Separador de milhares. Escolha nenhum separador, uma vrgula ou um ponto. O


padro nenhum separador.

Separador decimal

Separador decimal. Escolha uma vrgula ou um ponto. Ponto o padro.

Nota: Voc pode exibir os formatos padro de cada instncia de origem ou de destino na guia Mapeamentos
nas propriedades da sesso.

72

Captulo 3: Trabalhando com Arquivos Simples

Trabalhando com Listas de Arquivos


Voc pode criar uma sesso para ler vrios arquivos de origem para uma instncia de origem em um
mapeamento. Por exemplo, se a sua organizao coleta dados de vrios locais que voc deseja processar
por meio do mesmo mapeamento, voc pode criar uma lista de arquivos. Uma lista de arquivos consiste em
um arquivo que contm os nomes e os diretrios de cada arquivo de origem que voc deseja que o Servio
de Integrao use.
Voc configura a sesso para ler a lista de arquivos. Depois que voc configurar a sesso para ler a lista de
arquivos, o Servio de Integrao l as linhas de dados de diferentes arquivos de origem na lista de
arquivos. Para configurar o mapeamento para gravar o nome do arquivo de origem para cada linha de
destino, adicione a porta CurrentlyProcessedFileName definio da origem de arquivo simples. O Servio
de Integrao usa essa porta para retornar o nome do arquivo de origem.
Adicione a porta CurrentlyProcessedFileName definio da origem de arquivo simples no Source Analyzer.
Para adicionar a porta CurrentlyProcessedFileName:
1.

Abra a definio de origem do arquivo simples no Source Analyzer.

2.

Clique na guia Propriedades.

3.

Selecione Adicionar Porta CurrentlyProcessedFlatFileName.


O Designer adiciona a porta CurrentlyProcessedFileName como a ltima coluna na guia Colunas. A
porta CurrentlyProcessedFileName uma porta de string com preciso padro de 256 caracteres.

4.

Clique na guia Colunas para ver as suas alteraes.


Voc pode alterar a preciso da porta CurrentlyProcessedFileName, se desejar.

5.

Para remover a porta CurrentlyProcessedFileName, clique na guia Propriedades e desmarque a caixa


de seleo Adicionar Porta de Nome de Arquivo Simples Processado Atualmente.

Trabalhando com Arquivos Simples que Diferenciam


Deslocamentos
Voc pode importar arquivos simples que diferenciam deslocamentos no Assistente de Arquivo Simples nos
modos de largura fixa e delimitado.
Um arquivo que diferencia deslocamentos pode conter caracteres de um byte e multibyte. Um arquivo pode
conter ou no uma chave de deslocamento para dentro e para fora para separar caracteres multibyte de
caracteres de um byte.
As chaves de deslocamento para dentro e para fora separam caracteres multibyte para que o Assistente de
Arquivo Simples e o Servio de Integrao possam ler cada caractere corretamente. Uma chave de
deslocamento para fora indica o incio de uma sequncia de caracteres multibyte. Uma chave de
deslocamento para dentro indica o fim dessa sequncia. Se a origem do arquivo no contiver chaves de
deslocamento, ser necessrio definir estados de deslocamento para cada coluna no arquivo para que o
Servio de Integrao possa ler cada caractere corretamente.
Nota: Use chaves de deslocamento de um byte e de dois bytes.

Trabalhando com Listas de Arquivos

73

Importao de Arquivos Simples com Teclas Shift


Use o Assistente de Arquivo Simples para importar uma origem de arquivo que contenha teclas shift. Voc
pode importar arquivos de largura fixa e delimitada que contenham teclas shift. O Assistente de Arquivo
Simples e o Servio de Integrao usam as teclas shift no arquivo para determinar o estado de alternao de
cada coluna na origem.
O Assistente de Arquivo Simples e o Servio de Integrao podem manipular caracteres de alternao
consecutiva.
O exemplo a seguir uma linha vlida de um arquivo simples que diferencia maisculas de minsculas:
aaa-oAAA-i-oAAA-iaaaaa
A tabela a seguir descreve a notao usada nesse exemplo:
Notao

Descrio

um

Caractere de um byte

Caractere de vrios bytes

-o

Caracteres movidos para fora

-i

Caracteres movidos para dentro

O Assistente de Arquivo Simples exibe caracteres shift de byte nico como . na janela. Caracteres shift de
bytes duplos aparecem como .. na janela. Exibio de caracteres maisculos em um fundo verde. Exibio
de caracteres minsculos em um fundo azul.

Requisitos para Arquivos Simples Sensveis ao Shift


O Designer retorna um erro se voc analisar um arquivo simples que diferencia a tecla Shift e que contm
caracteres encontrados ao pressionar/soltar a tecla Shift, mas no cumpre com os requisitos a seguir:

Um caractere encontrado ao pressionar/soltar a tecla Shift deve incluir todos os caracteres multibye. Os
caracteres de um byte no precisam ser includos juntos com os caracteres de deslocamento.

O primeiro caractere de deslocamento em uma linha deve ser um caractere encontrado ao soltar a tecla
Shift.

Um arquivo no pode conter caracteres de deslocamento aninhados. Por exemplo, voc tem a seguinte
sequncia:
-oAA-oAA-iaaa

Um caractere encontrado ao pressionar a tecla Shift deve encerrar um caractere encontrado ao soltar a
tecla Shift na mesma linha.

O Assistente para Arquivo Simples desabilita a opo de largura fixa se o arquivo tiver um caractere
multibyte que contm mais de dois bytes por caractere. Cada linha em um arquivo no deve exceder 16 KB.
O Assistente para Arquivo Simples valida at 500 linhas ou 256 KB de dados, o que vier primeiro. Se o
arquivo no cumprir com os requisitos acima, o Servio de Integrao grava os erros no log da sesso.

Importando Arquivos Simples sem Teclas Shift


Use o Assistente de Arquivo Simples para importar uma origem de arquivo com largura fixa que no contm
chaves de deslocamento. Entretanto, depois de importar uma definio de origem, voc deve definir estados

74

Captulo 3: Trabalhando com Arquivos Simples

de chaves de deslocamento para cada coluna na definio de arquivo de origem, para que o Servio de
Integrao possa ler cada caractere corretamente.
Tambm possvel importar arquivos COBOL que sensveis ao Shift que no teclas Shift. Quando voc fizer
isso, tambm dever definir os estados de deslocamento para cada coluna na definio de origem de
COBOL.
Nota: Ao criar uma sesso usando uma origem de arquivo simples que contenha estados de deslocamento
definidos pelo usurio, verifique se a pgina de cdigo no Workflow Manager a mesma pgina de cdigo
que voc selecionou no Designer. Se voc selecionar uma pgina de cdigo-fonte diferente no Workflow
Manager, o Servio de Integrao no usar as chaves de deslocamento que voc definiu no Designer.
Para definir estados de deslocamento para arquivos com largura fixa que diferenciam deslocamentos:
1.

No Designer, importe a origem de arquivo simples ou arquivo COBOL.

2.

No Source Analyzer, clique duas vezes na barra de ttulos da definio de origem do arquivo.

3.

Selecione Largura Fixa na seo Informaes do Arquivo Simples e clique em Avanadas.


A caixa de dilogo Editar Informaes de Arquivo Simples - Arquivos de Largura Fixa exibida.

4.

Selecione Estado de Deslocamento Definido pelo Usurio e clique em OK.

5.

Clique na guia Colunas.


A coluna Chave de Deslocamento exibida.

6.

Selecione uma chave de deslocamento para cada coluna.


Escolha Shift-In se a coluna contiver caracteres de byte nico. Escolha Shift-Out se a coluna contiver
caracteres multibyte.

7.

Clique em OK.

Trabalhando com Dados Multibyte em Destinos de


Largura Fixa
Para carregar dados multibyte em um destino de arquivo simples de largura fixa, configure a preciso para
acomodar os dados multibyte. Os arquivos com largura fixa so orientados por byte, no por caractere. Ao
configurar a preciso de um destino de largura fixa, voc precisa considerar o nmero de bytes que carregou
no destino, em vez do nmero de caracteres. O Servio de Integrao gravar a linha no arquivo rejeitado se
a preciso no for grande o suficiente para acomodar os dados multibyte. Quando o Servio de Integrao
grava a linha no arquivo rejeitado, ele grava a mensagem no registro da sesso.
Nota: Os arquivos delimitados so orientados por caracteres, e voc no precisa permitir uma preciso
adicional para dados multibyte.

Soluo de Problemas de Arquivos Simples


Eu executei uma sesso para um destino de arquivo simples que contm dados multibyte. Os dados no
destino de arquivo simples no incluem alguns caracteres multibyte.
Se a pgina de cdigo que voc selecionou ao importar o destino de arquivo simples, usando o Assistente
de Arquivo Simples, no for um superconjunto da pgina de cdigo de origem, os caracteres que no so
Trabalhando com Dados Multibyte em Destinos de Largura Fixa

75

codificados na pgina de cdigo de destino podem ser perdidos. Selecione uma pgina de cdigo que seja
um superconjunto da pgina de cdigo de origem, quando voc importar um destino de arquivo simples
usando o Assistente de Arquivo Simples.

76

Captulo 3: Trabalhando com Arquivos Simples

CAPTULO 4

Trabalhando com Destinos


Este captulo inclui os seguintes tpicos:

Viso Geral do Trabalho com Destinos, 77

Importando uma Definio de Destino, 80

Criando uma Definio de Destino a Partir de uma Definio de Origem, 82

Criando uma Definio de Destino a Partir de uma Transformao, 84

Criando Manualmente uma Definio de Destino, 88

Mantendo Definies de Destino Relacional, 89

Criando uma Tabela de Destino, 94

Solucionando Problemas de Destinos, 95

Viso Geral do Trabalho com Destinos


Antes de criar um mapeamento, necessrio definir os destinos no repositrio. Use o Target Designer para
importar e criar definies de destino ou para criar e manter definies de destino. As definies de destino
incluem propriedades como nomes de coluna e tipos de dados.

Criando Definies de Destino


possvel criar os seguintes tipos de definies de destino no Target Designer:

Relacional. Crie um destino relacional para uma plataforma de banco de dados especfica. Crie uma
definio de destino relacional quando desejar usar um carregador externo para o banco de dados de
destino.

Arquivo simples. Crie definies de destino de arquivo simples de largura fixa e delimitado.

Arquivo XML. Crie uma definio de destino XML para transmitir dados para um arquivo XML.

possvel criar definies de destino dos seguintes modos:

Importe a definio de um destino existente. Importe a definio de destino de um destino relacional


ou de um arquivo simples. O Target Designer usa o Assistente de Arquivo Simples para importar arquivos
simples.

Crie uma definio de destino baseada em uma definio de origem. Arraste a definio de origem
para o Target Designer para criar uma definio de destino.

Crie uma definio de destino baseada em uma transformao ou mapplet. Arraste a transformao
para o Target Designer para criar uma definio de destino.

77

Crie uma definio de destino manualmente. Crie uma definio de destino no Target Designer.

Crie diversas definies de destino relacionadas. Crie diversas definies de destino relacionadas ao
mesmo tempo. possvel criar um relacionamento geral chamado de esquema e as definies de destino
atravs de assistentes no Designer. Os Assistentes de Cubos e Dimenses seguem os princpios comuns
de design de data warehouse para simplificar o processo de criao de destinos relacionados.

Mantendo Destinos e Definies de Destino


Alm de criar a definies de destino, voc pode concluir as seguintes tarefas no Target Designer:

Reimportar definies de destino. Quando a estrutura do destino muda significativamente, voc pode
reimportar a definio de destino para se certificar de que est correta.

Editar definies de destino. Edite as definies de destino para adicionar comentrios ou


relacionamentos de chaves, ou atualize-as para refletir definies alteradas.

Criar tabelas relacionais no banco de dados de destino. Se as tabelas de destino no existirem no


banco de dados de destino, voc pode gerar e executar o cdigo SQL necessrio para criar a tabela
correspondente definio do destino.

Visualizar dados relacionais e de destino do arquivo simples. Voc pode visualizar as definies de
dados relacionais e de destino do arquivo simples no Designer.

Comparar definies de destino. Voc pode comparar duas definies de destino para identificar as
diferenas entre elas.

Pginas de Cdigo de Destino


possvel criar destinos com conjuntos de caracteres multibyte. As pginas de cdigo de destino devem ser
um superconjunto de pginas de cdigo-fonte quando voc executa uma sesso.

Tratamento de Caracteres Especiais em Definies de Destino


Voc pode usar o Designer para importar, criar e editar definies de destino com nomes de tabela e campo
que contenham caracteres especiais, como a barra (/). Quando voc importa, cria ou edita uma definio de
destino usando o Target Designer, o Designer mantm os caracteres especiais nos nomes de tabela e
campo ao salvar a definio de destino no repositrio.
Entretanto, quando voc adiciona uma definio de destino com caracteres especiais a um mapeamento, o
Designer retm ou substitui o caractere. Alm disso, quando voc gera a substituio da atualizao do
destino na instncia de destino no Target Designer, o Designer usa aspas entre os nomes de tabela e coluna
com alguns caracteres especiais. O Designer manipula caracteres especiais de modo diferente para destinos
relacionais e no relacionais.

78

Captulo 4: Trabalhando com Destinos

A tabela a seguir descreve como o Designer manipula caracteres especiais em destinos relacionais:
Caracteres Especiais

Comportamento do Target
Designer

Comportamento do Mapping
Designer

@#$_

Retm o caractere no nome da tabela


de definio de destino.

Retm o caractere no nome da tabela


de instncia de destino.

Retm o caractere nos nomes da


coluna de definio de destino.

Retm o caractere nos nomes da


coluna de instncia de destino.
No usa aspas para delimitar nomes
de colunas ou tabelas na substituio
de atualizao de destino.

/+-=~`!%^&*()[]{}';
?,<>\| <space>

Retm o caractere no nome da tabela


de definio de destino.
Retm o caractere nos nomes da
coluna de definio de destino.

Substitui o caractere na tabela de


instncia de destino pelo caractere
sublinhado.
Retm o caractere nos nomes da
coluna de instncia de destino.
Delimita nomes de tabelas e colunas
incluindo caracteres especiais com
aspas na substituio de atualizao
de destino.

.":\t\r\n

O Designer no reconhece esses


caracteres em nomes de tabela e
coluna de destino relacional.

O Designer no reconhece esses


caracteres em nomes de tabela e
coluna de destino relacional.

A tabela a seguir descreve como o Designer manipula caracteres especiais em destinos no relacionais:
Caracteres Especiais

Comportamento do Target
Designer

Comportamento do Mapping
Designer

@#$_

Retm o caractere no nome da tabela


de definio de destino.

Retm o caractere no nome da tabela


de instncia de destino.

Retm o caractere nos nomes da


coluna de definio de destino.
Nota: No possvel usar o caractere
@ como o primeiro caractere em um
nome de coluna ou tabela.

Retm o caractere nos nomes da


coluna de instncia de destino.
Nota: No possvel usar o caractere
@ como o primeiro caractere em um
nome de coluna ou tabela.

Retm o caractere no nome da tabela


de definio de destino.

Substitui o caractere na tabela de


instncia de destino pelo caractere
sublinhado.

Retm o caractere nos nomes da


coluna de definio de destino.

.+-=~`!%^&*()[]{}'"
;:?,<>\|
\t\r\n <space>

O Designer no reconhece esses


caracteres em nomes de tabela e
coluna de destino no relacional.

Retm o caractere nos nomes da


coluna de instncia de destino.
O Designer no reconhece esses
caracteres em nomes de tabela e
coluna de destino no relacional.

Alguns bancos de dados requerem configurao ou comandos especiais para permitir nomes de campos e
tabelas que contenham caracteres especiais. Para obter mais informaes, consulte a documentao do
banco de dados.

Viso Geral do Trabalho com Destinos

79

Importando uma Definio de Destino


Voc pode importar as definies de destino a seguir:

Arquivo simples. O Target Designer usa o Assistente para Arquivo Simples para importar uma definio
de destino de um arquivo simples que corresponde sua estrutura.

Tabela relacional. Voc pode importar uma tabela relacional para criar uma definio de destino que
corresponda estrutura da tabela.

Arquivo XML. Voc pode importar uma definio de destino XML como um arquivo XML, DTD ou de
esquema XML.

Para importar uma definio de destino relacional, necessrio configurar a conectividade entre o banco de
dados de destino e o Cliente do PowerCenter.
Use uma definio de destino em um mapeamento, depois de t-la adicionado ao repositrio.

Definies de Destino Relacional


Quando voc importa uma definio de origem de uma tabela relacional, o Designer importa os seguintes
detalhes do destino:

Nome do destino. O nome do destino.

O local do banco de dados. Voc especifica o local do banco de dados quando importa uma origem
relacional. Voc pode especificar um local diferente quando editar a definio de destino no Target
Designer e quando configurar uma sesso.

Nomes de coluna. Os nomes das colunas.

Tipos de dados O Designer importa o tipo de dados nativo para cada coluna.

Restries de chave. As restries na definio de destino podem ser crticas porque podem impedir
que voc mova dados para o destino se o Servio de Integrao violar uma restrio durante um fluxo de
trabalho. Por exemplo, se uma coluna contm a restrio NOT NULL e voc no mapear dados para essa
coluna, o Servio de Integrao no poder inserir novos registros na tabela de destino.

Relacionamentos de chave. Voc pode personalizar o Target Designer para criar relacionamentos de
chave primria/chave estrangeira. Clique em Ferramentas > Opes e selecione a guia Ferramentas.
Selecione Importar Chaves Primria e Estrangeira.
Tambm possvel criar relacionamentos lgicos no repositrio. Relaes de chave no precisam existir
no banco de dados.

Quando voc importa definies de destino, o Designer no importa os ndices de destino. Voc pode alterar
esta configurao padro em powrmart.ini. O arquivo powrmart.ini pode ser encontrado no diretrio raiz da
instalao do Cliente do PowerCenter.
Para importar ndices de destino, adicione o seguinte texto seo do arquivo powrmart.ini [Main]:
ImportIndexes=Yes
Nota: Como as exibies podem incluir colunas de mais de uma tabela, o Servio de Integrao pode
encontrar erros de banco de dados quando tentar inserir, atualizar ou excluir dados. Se importar uma
exibio de destino, certifique-se de que ela seja a exibio de uma nica tabela.

Conectividade para Destinos Relacionais


Para importar uma definio de destino relacional, voc deve ser capaz de se conectar ao banco de dados
da mquina do cliente usando uma fonte de dados ODBC ou gateway configurado adequadamente. Voc
tambm pode precisar de permisso de leitura no objeto de banco de dados.

80

Captulo 4: Trabalhando com Destinos

Ao criar uma origem de dados ODBC, voc tambm deve especificar o driver para o qual o gerenciador de
driver ODBC envia chamadas de banco de dados. A tabela a seguir mostra os drivers ODBC recomendados
para usar com cada banco de dados:
Banco de Dados

Driver ODBC

Exige Banco de Dados


Software Cliente

IBM DB2

Driver ODBC IBM

Sim

Informix

Driver ODBC DataDirect de 32 bits fechado

No

Microsoft Access

Driver do Microsoft Access

Sim

Microsoft Excel

Driver do Microsoft Excel

Sim

Microsoft SQL Server

Driver ODBC Microsoft SQL Server

No

Oracle

Driver ODBC DataDirect de 32 bits fechado

No

Sybase ASE

Driver ODBC DataDirect de 32 bits fechado

No

Teradata

Driver ODBC Teradata

n/d

Ao usar uma fonte de dados ODBC de terceiros para importar uma definio de destino, o Designer exibir
uma mensagem indicando que o driver de terceiros no est listado em powermart.ini. O Designer tenta
importar metadados da definio de destino usando o driver fornecido com o PowerCenter. Se a empresa
terceirizada fornece um driver para importar metadados, configure powrmart.ini.

Configurando uma Fonte de Dados ODBC de Terceiros


Para importar uma definio de destino com um driver ODBC que no esteja includo no powrmart.ini,
configure o powrmart.ini.
Para configurar o powrmart.ini para uma origem de dados ODBC de terceiros:
1.

Copie o driver para o diretrio a seguir:

2.

Localize e abra o powrmart.ini no diretrio a seguir:

<PowerCenter Installation Directory>\client\bin


<PowerCenter Installation Directory>\client\bin
3.

Adicione uma entrada ao arquivo na seo ODBCDLL que inclui o nome da origem de dados ODBC e o
driver.
Por exemplo, se o Fornecedor A forneceu um driver chamado vendoraodbc.dll, insira o seguinte abaixo
do cabealho ODBCDLL:
Vendor A=vendoraodbc.dll

4.

Salve e feche o powrmart.ini.

5.

Reinicie o Cliente do PowerCenter e importe a definio de destino.

Importando Definies de Destino Relacional


Para criar uma definio de destino relacional, use o Target Designer para importar metadados de destino.

Importando uma Definio de Destino

81

Para importar uma definio de destino relacional:


1.

No Target Designer, clique Destinos > Importar do Banco de Dados.

2.

Selecione a fonte de dados ODBC para conectar ao banco de dados de destino.


Se precisar criar ou modificar uma fonte de dados ODBC primeiramente, clique no boto Procurar para
abrir o Administrador de ODBC. Aps criar ou modificar a origem ODBC, continue com as etapas
seguintes.

3.

Insira o nome de usurio e a senha necessrios para abrir uma conexo com o banco de dados e clique
em Conectar.
Se voc no for o proprietrio da tabela que deseja utilizar como destino, especifique o nome do
proprietrio.

4.

Faa uma busca detalhada na lista de objetos de banco de dados para exibir as tabelas disponveis
como destinos.

5.

Selecione a tabela ou tabelas relacionais para importar as definies para o repositrio.


possvel manter pressionada a tecla Shift para selecionar um bloco de tabelas, ou manter pressionada
a tecla CTRL para fazer selees no contguas. Tambm possvel usar os botes Selecionar Tudo e
Selecionar Nenhum para selecionar ou desmarcar todos os destinos disponveis.

6.

Clique em OK.
As definies de destino selecionadas aparecem agora no Navegador sob o cone Destinos.

Criando uma Definio de Destino a Partir de uma


Definio de Origem
Quando voc precisa criar uma definio de destino que corresponda rigorosamente a uma definio de
origem, a definio de origem pode ser usada para criar a definio de destino. Um atalho para a definio
de origem tambm pode ser usado para criar a definio de destino. Voc pode arrastar as seguintes
definies de origem para o Target Designer criar as definies de destino:

Origens relacionais

Origens de arquivo simples

Origens COBOL

Origens XML

Depois de criar a definio de destino correspondente, voc pode adicionar ou editar as propriedades de
destino e alterar o tipo. Ao criar uma definio de destino relacional, voc pode gerar a tabela de destino no
banco de dados de destino.

Criando uma Definio de Destino a Partir de uma Origem


Relacional
Quando voc arrasta uma definio de origem relacional para o espao de trabalho do Target Designer, ele
cria uma definio de destino relacional que corresponde definio de origem.
Voc pode editar a definio para alterar as informaes, como a descrio, as colunas, os tipos de dados e
o tipo de destino.

82

Captulo 4: Trabalhando com Destinos

Criando uma Definio de Destino em uma Origem de Arquivo


Simples
Quando voc arrasta uma definio de origem de arquivo simples para o espao de trabalho do Target
Designer, ele cria uma definio de origem de arquivo simples, por padro, que corresponde definio de
origem.
Quando voc cria uma definio de destino a partir de uma definio de origem de arquivo simples, o
Designer usa a pgina de cdigo dessa definio.
Voc pode editar a definio para alterar as informaes, como a descrio, colunas, tipos de dados e tipo
de destino.

Criando um Destino Normalizado em uma Origem COBOL


Para criar um destino com base em origens COBOL normalizadas, voc precisa primeiro analisar a estrutura
COBOL usando o Source Analyzer.
Quando voc arrasta uma definio de origem COBOL normalizada para o espao de trabalho do Target
Designer, ele cria definies de destino relacional com base nas seguintes regras:

O nmero de tabelas que aparece maior que o nmero de instrues OCCURS no arquivo COBOL.

O nome da tabela de destino no aparece para o nome do registro.

O nome de chave gerado para cada tabela GK_target_table_name.

O nmero de nomes chave gerados o nmero de instrues OCCURS menos o nmero de chaves
primrias.

A figura a seguir mostra um exemplo de definio de origem COBOL com cinco instrues OCCURS:

Quando voc arrasta a origem para o espao de trabalho do Target Designer, o Designer cria seis definies
de destino.

Etapas Para Criar uma Definio de Destino a Partir de uma


Definio de Origem
Use o procedimento a seguir para criar uma definio de destino de uma definio de origem.

Criando uma Definio de Destino a Partir de uma Definio de Origem

83

Para criar uma definio de destino baseada em uma definio de origem:


1.

Com a ferramenta do Target Designer ativa, arraste a definio da origem que voc deseja usar para o
espao de trabalho. Para origens XML, selecione a opo para criar destinos relacionais ou destinos
XML e clique em OK.
A definio de destino exibida.

2.

Para editar a definio de destino, clique duas vezes na barra de ttulo.

3.

Digite um nome de destino e selecione o tipo de destino. Adicione ou edite colunas ou propriedades de
destino, e clique em OK.

Agora voc pode usar a definio de destino em um mapeamento. Voc tambm pode criar tabelas de
destino no banco de dados de destino com base nas definies de destino relacional.

Criando uma Definio de Destino a Partir de uma


Transformao
Para criar uma definio de destino relacional que corresponda a uma transformao no repositrio, voc
pode criar o destino a partir da transformao. Arraste uma transformao do Navegador para o Target
Designer ou crie um destino a partir de uma transformao no espao de trabalho do Mapping Designer.
Crie definies de destino a partir dos seguintes tipos de transformaes:

Transformaes de um grupo. Crie uma definio de destino nico a partir de uma transformao com
um grupo de sada.

Transformaes de vrios grupos. Crie definies de destino mltiplo a partir de uma transformao
com vrios grupos de sada.

Transformaes Normalizador. Crie uma definio de destino a partir de um qualificador ou


transformao pipeline Normalizador.

Mapplets. Crie uma ou mais definies de destino a partir de uma instncia de mapplet em um
mapeamento.

Ao criar uma definio de destino a partir de uma transformao, o tipo de banco de dados de destino o
mesmo do banco de dados de repositrio, por padro. Depois que voc criar a definio de destino no
repositrio, ser possvel edit-la. Por exemplo, voc pode querer alterar o tipo de destino.
Se precisar criar uma definio de destino que contenha colunas de mais de uma transformao, copie as
portas de cada transformao em uma transformao como uma Expresso ou Ligao. Voc pode criar a
definio de destino a partir dessa transformao.
Ao criar uma definio de destino relacional, voc dever gerar e executar o SQL para criar a tabela no
banco de dados de destino.

Criando um Destino a Partir de uma Transformao com um


Grupo de Sada
Ao criar um destino de uma transformao com um grupo de sada, o Designer cria um destino. Todas as
portas de sada se tornam portas de entrada no destino. O nome do destino o mesmo nome da
transformao.

84

Captulo 4: Trabalhando com Destinos

Criando um Destino a Partir de uma Transformao com Vrios


Grupos de Sada
Quando voc cria destinos de uma transformao com mais de um grupo de sada, o Designer cria um
destino para cada grupo de sada na transformao. No caso da transformao Personalizada ou de plug-in,
o Designer retm os relacionamentos de chave primria/chave externa entre os grupos nas definies do
destino.
A figura a seguir mostra uma transformao com vrios grupos de sada:

A transformao Analisador XML dos Funcionrios tem cinco grupos de sada, de X_emp_EMPLOYEES at
X_emp_PHONE. Cada grupo de sada representa tipos diferentes de informaes do funcionrio. DataInput
est no grupo de entrada.
Quando voc cria um destino a partir desta transformao, o Designer cria um destino separado para cada
grupo de sada. Cada destino tem o nome do grupo de transformao correspondente, conforme mostrado
na figura a seguir:

Criando uma Definio de Destino a Partir de uma Transformao

85

Criando um Destino a Partir de uma Transformao de


Normalizador
Voc pode criar um destino a partir de um qualificador de origem ou de uma transformao Normalizador de
pipeline. Quando voc cria um destino a partir de uma transformao Normalizador, o Designer cria um
destino e inclui todas as colunas do Normalizador. Ele no cria destinos diferentes para representar as
hierarquias de registro ou os campos recorrentes na transformao Normalizador.
A figura a seguir mostra uma transformao Normalizador em um mapeamento com uma definio de origem
COBOL:

A transformao Normalizador, Norm_Company_Sales, representa a estrutura de dados hierrquicos da


definio de origem COBOL, Company_Sales COBOL. Quando voc cria um destino a partir da
transformao Norm_Company_Sales, o Designer mescla as hierarquias na transformao em um nico
destino. O destino inclui chaves geradas a partir da transformao Normalizador e o ID (GCID) da coluna
gerada para os registros recorrentes, DETAIL_DATA e SUPPLIER_INFO.

Criando um Destino a Partir de um Mapplet


Voc pode criar um destino a partir de um mapplet que esteja em um n de Instncias de Transformao de
mapeamento. Quando voc arrasta a instncia de mapplet para o Target Designer, o Designer cria um
destino para cada grupo de sada no mapplet.
Nota: No possvel criar um destino quando voc arrasta uma instncia de transformao de um mapplet
para o Target Designer.

Tipos de Dados de Destino e Transformao


O Designer cria os tipos de dados de destino com base na melhor correspondncia entre os tipos de dados
de transformao e os tipos de dados do banco de dados do repositrio.

86

Captulo 4: Trabalhando com Destinos

A tabela a seguir descreve os tipos de dados de transformao e seus correspondentes para cada banco de
dados:
Tipo de dados
de
transformao

IBM DB2

Microsoft
SQL
Server

Oracle

Sybase
ASE

Teradata

Informix

bigint

bigint

bigint

nmero (19,
0)

bigint

bigint

int8

binrio

char para
dados bit

binrio

bruto

binrio

byte/varbyte

byte

data/hora

carimbo de
data/hora

datetime

carimbo de
data/hora

datetime

carimbo de
data/hora

data e hora do
ano para
frao

decimal

decimal

decimal

nmero(p,s)

decimal

decimal

decimal(p,s)

duplo

flutuante

flutuante

nmero

flutuante

flutuante

float(p)

nmero inteiro

nmero
inteiro

int

nmero(p,s)

int

nmero
inteiro

nmero inteiro

nstring

vargraphic

nvarchar

nvarchar2

nvarchar

n/d

nvarchar

ntext

vargraphic
longo

ntext

nclob

nvarchar

n/d

n/d

real

flutuante

real

nmero

real

n/d

smallfloat

nmero inteiro
curto

smallint

smallint

smallint

smallint

smallint

smallint

string

varchar

varchar

varchar2

varchar

varchar

varchar(m,r)

texto

varchar
longo

texto

longo

texto

n/d

texto

Etapas para Criar um Destino


Voc pode criar um destino, arrastando uma ou mais transformaes do Navegador para o Target Designer,
ou pode criar um destino a partir de uma instncia de transformao no Mapping Designer.

Etapas Para Criar um Destino no Target Designer


Voc pode criar um ou mais destinos no Target Designer, selecionando as transformaes no Navegador e
arrastando-as para o espao de trabalho do Target Designer.
Quando voc cria um destino a partir de uma transformao em uma pasta diferente, o Designer copia a
transformao para a pasta de destino e cria o destino a partir da transformao. Quando voc cria um
destino a partir de uma transformao em uma pasta compartilhada, o Designer cria um atalho para a
transformao na pasta de destino antes de criar a transformao.

Criando uma Definio de Destino a Partir de uma Transformao

87

A tabela seguinte descreve os objetos que voc pode usar para criar um destino no Target Designer:
Objeto

Local do Navegador

Transformao

n Transformaes

Instncia de Transformao

N Mapeamentos

Mapplet

N Instncias de Transformao para um mapeamento

Para criar uma definio de destino no Target Designer.


1.

Abra o Target Designer.

2.

Arraste uma transformao do n Transformaes ou do n Instncias de Transformao no Navegador


para o espao de trabalho.
A definio de destino exibida.

O Designer adiciona o novo destino ao Navegador e ao espao de trabalho do Target Designer. Quando
voc usa o controle de verso no repositrio, o novo destino submetido a check-out por padro.
Se o nome do destino entrar em conflito com um nome de destino existente, o Designer solicita que voc
renomeie o novo destino ou substitua a definio de destino existente.

Etapas Para Criar um Destino no Mapping Designer


Voc pode criar um destino de uma instncia de transformao no Mapping Designer. Ao criar um destino no
Mapping Designer, voc cria uma instncia de destino no mapeamento. O Target Designer exibe a definio
de destino.
Para criar uma definio de destino no Mapping Designer.
1.

Abra um mapeamento no Mapping Designer.

2.

Clique com o boto direito do mouse em uma instncia de transformao no mapeamento.

3.

Clique em Criar e Adicionar destino.

Se o repositrio contm uma definio de destino com o mesmo nome, voc deve criar o destino no Target
Designer em vez de no Mapping Designer.
Se no houver conflitos de nome, o Designer adiciona o novo destino ao espao de trabalho do Navegador e
do Mapping Designer. Voc pode vincular as portas de transformao ao destino.

Criando Manualmente uma Definio de Destino


Voc pode criar manualmente uma definio de destino em vez de import-la ou cri-la a partir de uma
definio de origem.
Para criar manualmente uma definio de destino:
1.

No Target Designer, clique Destinos > Criar.

2.

Digite um nome para o destino e selecione o tipo de destino.


Se voc criar uma definio relacional, siga as convenes de nomenclatura especficas para banco de
dados.

88

Captulo 4: Trabalhando com Destinos

3.

Clique em Criar.
Uma definio vazia exibida no espao de trabalho. Ela pode estar atrs da caixa de dilogo. A nova
tabela de destino tambm exibida na janela Navegador.

4.

Se voc quiser criar uma outra definio de destino, digite um novo nome e tipo de destino e clique em
Criar. Repita esta etapa para cada grupo que voc queira criar.

5.

Clique em Concluir, ao terminar a criao de definies de destino.

6.

Configure a definio de destino.


A nova definio de destino salva no repositrio. Agora voc pode usar a definio de destino em um
mapeamento.

Voc tambm pode criar uma tabela de destino no banco de dados de destino com base nas definies de
destino relacional.
Nota: No possvel criar manualmente uma definio de destino para arquivos XML.

Mantendo Definies de Destino Relacional


possvel manter definies de destino relacional +dos seguintes modos:

Reimporte a definio de destino. Reimporte uma definio de destino, em vez de edit-la, se o destino
mudar significativamente.

Defina as relaes de chave primria-chave estrangeira. Definir os relacionamentos de chave


primria-chave estrangeira entre tabelas de destino relacional.

Editar a definio de destino. Editar as definies de destino para adicionar comentrios ou


relacionamentos de chaves, ou atualiz-las para refletir um destino alterado.

Depois de criar uma definio de destino relacional, voc pode edit-la usando as guias de definio de
destino a seguir:

Guia Tabela. Editar propriedades como as restries para os destinos relacionais e as propriedades do
arquivo simples para os destinos de arquivos simples.

Guia Colunas. Editar as informaes de coluna como tipo de dados e preciso.

Guia ndices. Adicionar informaes de ndice para as definies de destino relacional.

Guia Extenses de Metadados. Estende os metadados armazenados no repositrio associando as


informaes a objetos do repositrio, como definies de destino.

Quando voc altera uma definio de destino, o Designer propaga as alteraes para qualquer mapeamento
usando esse destino. Algumas alteraes nas definies de destino podem invalidar mapeamentos.
A tabela a seguir descreve como voc pode impactar mapeamentos ao editar definies de destino:
Modificao

Resultado

Adicione uma coluna.

Mapeamento no invalidado.

Altere o tipo de dados da coluna.

Os mapeamentos podem ser invalidados. Se a coluna estiver conectada a


uma porta de entrada que usa um tipo de dados incompatvel com a nova
(por exemplo, Decimal to Date), o mapeamento invlido.

Mantendo Definies de Destino Relacional

89

Modificao

Resultado

Altere o nome de coluna.

Os mapeamentos podem ser invalidados. Se voc alterar o nome de uma


coluna que acabou de adicionar, o mapeamento permanecer vlido. Se
voc alterar o nome de uma coluna existente, o mapeamento invalidado.

Exclua a coluna.

O mapeamento pode ser invalidado se ele utilizar valores da coluna


excluda.

Altere o tipo de definio de


destino.

Mapeamento no invalidado.

Quando voc adiciona uma nova coluna a um destino no Target Designer, todos os mapeamentos que usam
a definio de destino permanecem vlidos. No entanto, ao adicionar uma nova coluna e alterar algumas de
suas propriedades, o Designer invalida mapeamentos usando a definio de destino.
possvel alterar as seguintes propriedades de uma coluna de destino recm-adicionada sem invalidar o
mapeamento:

Nome

Tipos de dados

Formatar

Se as alteraes invalidarem o mapeamento, valide o mapeamento e qualquer sesso usando o


mapeamento. Voc pode validar objetos na janela Resultados da Consulta ou Exibir Dependncias ou no
Navegador de Repositrio. Voc pode validar vrios objetos a partir dessas localizaes sem abri-los no
espao de trabalho. Se voc no puder validar o mapeamento ou sesso de uma dessas localizaes, abra
o objeto no espao de trabalho e edite-o.

Reimportando uma Definio de Destino Relacional


Se uma tabela de destino mudar, por exemplo, quando voc altera um tipo de dados da coluna, voc pode
editar a definio ou reimportar a definio do destino. Quando voc reimporta o destino, pode substituir a
definio de destino existente ou renomear a nova para evitar um conflito de nomes com a definio
existente.
Para reimportar uma definio de destino:
1.

No Target Designer, siga as mesmas etapas para importar a definio de destino e selecione o destino
para importar.
O Designer avisa que j existe uma definio de destino com esse nome no repositrio. Se voc tiver
vrias tabelas para importar e substituir, selecione Aplicar a Todas as Tabelas.

90

2.

Clique em Renomear, Substituir, Ignorar ou Comparar.

3.

Se voc clicar em Renomear, insira o nome da definio de destino e clique em OK.

4.

Se voc tem uma definio de destino relacional e clica em Substituir, especifique se deseja reter as
informaes da chave primria/chave externa e as descries do destino.

Captulo 4: Trabalhando com Destinos

A tabela a seguir descreve as opes disponveis na caixa de dilogo Tabela Existe, ao reimportar e
substituir uma definio de destino relacional:
Opo

Descrio

Aplicar a Todas as
Tabelas

Selecione esta opo para aplicar renomear, substituir ou ignorar a todas as


tabelas da pasta.

Reter
Relacionamentos PKFK Definidos pelo
Usurio

Selecione esta opo para manter os relacionamentos de chave primria/chave


externa na definio de destino que est sendo substituda. Esta opo
desativada quando a definio do destino no relacional.

Reter Descries
Definidas pelo Usurio

Selecione esta opo para reter a descrio do destino, da coluna e da porta


dentro da definio de destino que est sendo substituda.

Criando uma Relao de Chave Primria-Chave Externa


Para criar um relacionamento entre duas tabelas relacionais, escolha o modo Vincular Coluna no menu
Layout. Arraste da coluna Chave Estrangeira de uma tabela para a coluna Chave Primria de outra tabela. O
Designer pode solicitar que voc remova o link existente para a tabela de chave primria padro.

Editando Opes de Tabela


possvel editar as seguintes opes na guia Tabela da definio de destino:

Nomes comerciais. Adicione um nome mais descritivo para a tabela, usando o boto Renomear.

Restries. Instrues SQL para restries de integridade referencial em nvel de tabela. Aplicvel
somente a destinos relacionais.

Opes de criao. Instrues SQL para opes de armazenamento de tabela. Aplicvel somente a
destinos relacionais.

Descrio: Adicione um comentrio ou link documentao comercial. Elas so exibidas no Repository


Manager da tabela de destino. Adicionar links de comentrios ou de documentao corporativa aos
destinos uma maneira fcil de documentar o objetivo de um destino. possvel adicionar ou modificar
comentrios em qualquer destino existente.
possvel inserir at 2.000 bytes/K caracteres na descrio, onde K o nmero mximo de bytes de um
caractere da pgina de cdigo de repositrio selecionada. Por exemplo, se a pgina de cdigo do
repositrio for em japons, em que K = 2, cada campo de descrio e comentrio pode conter at 1.000
caracteres.

Palavras-Chave. Rastreie as definies de destino com palavras-chave. Conforme o trabalho de


desenvolvimento e manuteno prosseguir, o nmero de destinos aumentar. Embora todos esses
destinos possam aparecer na mesma pasta, todos eles podem atender a fins diversos. As palavras-chave
podem ajud-lo a localizar destinos relacionados. Palavras-chave podem incluir nomes de
desenvolvedores, mapeamentos ou o esquema associado.
Use as palavras-chave para executar pesquisas no Repository Manager.

Tipo de banco de dados. Defina o tipo de destino: um banco de dados relacional ou um arquivo simples.
Voc pode alterar uma definio de destino relacional para uma definio de destino de arquivo simples e
vice-versa. Ao alterar o tipo de definio de destino e salvar as alteraes no repositrio, voc perde
alguns metadados.

Mantendo Definies de Destino Relacional

91

Ao alterar o tipo de definio de destino de relacional para arquivo simples, voc perde as informaes
dos ndices, das restries e das opes de criao. O Workflow Manager invalida todas as sesses que
usam o destino.
Ao alterar o tipo de definio de destino de arquivo simples para relacional, voc perde todas as
informaes de propriedade do arquivo simples. Se voc alterar a definio de destino novamente para
um arquivo simples, o Designer usa os valores padro das propriedades de arquivo simples. O Workflow
Manager invalida todas as sesses que usam o destino.
Nota: Se voc alterar o tipo de destino de arquivo simples para relacional, o Workflow Manager invalida
todas as sesses que usam o destino. No entanto, voc pode alterar um tipo de destino de relacional
para arquivo simples sem invalidar as sesses que usam o destino.

Informaes de arquivo simples. Quando o tipo de banco de dados for de arquivo simples, possvel
definir as propriedades de arquivo simples clicando no boto Avanado.

Para adicionar opes a uma definio de destino relacional:


1.

No Target Designer, clique duas vezes na barra de ttulo da definio de destino.


A caixa de dilogo Editar Tabelas aparecer.

2.

Clique no boto Renomear para editar o nome de destino e o nome comercial.

3.

Para alterar o tipo de destino, selecione um outro banco de dados no campo Tipo de banco de dados.
Para alterar o tipo de destino para um destino de arquivo simples, selecione arquivo simples.

4.

Edite as propriedades a seguir das definies de destino relacional:

Para adicionar uma restrio, digite a instruo SQL no campo Restries.

Para adicionar uma opo de criao, digite a instruo SQL no campo Opes de criao.

5.

Para adicionar uma descrio, digite a descrio no campo Descrio.

6.

Para adicionar palavras-chave, clique em Editar Palavra-chave.


A caixa de dilogo Editar Palavras-Chave aparecer.

7.

Use os botes para criar e mover palavras-chave.

8.

Clique em OK.

Editando Colunas
possvel editar as seguintes informaes na guia Colunas da definio de destino:

Nome da coluna. Os nomes de colunas no destino. Ao editar uma definio de destino relacional, edite o
nome da coluna se estiver criando manualmente a definio de destino relacional ou se o nome da
coluna de destino real foi alterado.

Tipo de dados. Os tipos de dados exibidos na definio de destino dependem do respectivo tipo de
destino.

Preciso e escala. Ao projetar ou importar destinos relacionais, considere a preciso e a escala de


valores em cada coluna. Preciso o nmero mximo de dgitos significativos de tipos de dados
numricos ou o nmero mximo de caracteres de tipos de dados de string. A preciso inclui a escala.
Escala o nmero mximo de dgitos aps a vrgula decimal de valores numricos. Portanto, o valor
11,47 tem uma preciso de 4 e uma escala de 2. A string Informatica tem uma preciso (ou tamanho)
igual a 11.
Todos os tipos de dados de destinos relacionais tm uma preciso mxima. Por exemplo, o tipo de dados
Inteiro tem uma preciso de 10 dgitos. Alguns tipos de dados numricos tm um limite semelhante na

92

Captulo 4: Trabalhando com Destinos

escala ou no permitem que voc defina uma escala maior que 0. Os inteiros, por exemplo, tm uma
escala igual a 0, pois, por definio, eles nunca possuem valores decimais.
Voc pode alterar a preciso e a escala de alguns tipos de dados para valores diferentes dos valores
definidos no banco de dados. Contudo, alterar a preciso ou a escala pode causar sobrecarga numrica
em colunas numricas, truncamento em colunas de caracteres ou a incluso de zeros em colunas de
data e hora quando o Servio de Integrao gravar na coluna de origem.

No Nulo. Escolha se deseja permitir dados nulos no destino.

Tipo de chave. Selecione Primria, Estrangeira, Primria-Estrangeira ou No uma Chave. Aplicvel


somente a destinos relacionais.

Nome comercial. Voc tambm pode adicionar nomes comerciais a cada coluna de destino.

Para editar as colunas de uma definio de destino relacional:


1.

No Target Designer, clique duas vezes na barra de ttulo de uma definio de destino.

2.

Selecione a guia Colunas.

3.

Configure as opes da definio de destino conforme descrito acima.

4.

Se voc estiver criando uma definio de destino e desejar adicionar colunas, selecione uma coluna e
clique em Adicionar.

5.

Insira o nome, tipo de dados e outras caractersticas da coluna.


Repita essas etapas para cada coluna que deseja adicionar tabela.

6.

Se voc deseja mover uma coluna, use os botes Para Cima e Para Baixo ou arraste-a dentro da lista
de rolagem.

7.

Clique em OK.

Definindo ndices
Como os ndices agilizam as consultas em relao s tabelas, adicionar ndices ao banco de dados de
destino uma parte importante da criao de tabela de destino. Voc pode adicionar as informaes do
ndice s definies de destino relacional. As consultas ao data warehouse determinam as colunas que voc
deve indexar. Se voc definir os ndices, selecione a opo para criar ndices ao criar tabelas de destino.
Para criar ndices para uma tabela de destino:
1.

No Target Designer, clique duas vezes na barra de ttulo de uma definio de destino relacional.

2.

Selecione a guia ndices.

3.

Para adicionar um ndice, clique no boto Adicionar na seo ndices.

4.

Digite um nome para o ndice e pressione Enter.

5.

Para adicionar uma coluna ao ndice, clique no boto Adicionar na seo Colunas. Selecione um nome
de coluna e clique em OK.

6.

Repita as etapas 3 para 5 para cada coluna que voc deseja atribuir.

7.

Clique em OK.

Importante: Ao gerar e executar a DDL para criar a tabela de destino, escolha criar um ndice.

Mantendo Definies de Destino Relacional

93

Criando uma Tabela de Destino


Depois que voc adiciona uma definio de destino relacional no repositrio, instrua o designer a gerar e
executar o cdigo SQL para criar o destino em um banco de dados relacional. No possvel criar uma
tabela em um banco de dados relacional de uma definio de destino XML ou um arquivo simples de
definio de destino.
O Designer gera o script SQL usando os caracteres no UCS-2.
Se o destino j existir nesse banco de dados, voc pode solt-lo e recri-lo. O Designer grava o cdigo SQL
em um arquivo de texto .SQL, para que voc possa rever e editar os comandos DDL abrindo este arquivo.
Para gerar e executar o cdigo SQL:
1.

No Target Designer, selecione a definio de destino relacional que voc deseja criar no banco de
dados. Se voc deseja criar vrias tabelas, selecione todas as definies referentes tabela.

2.

Clique em Destinos > Gerar/Executar SQL.


Clique em Conectar e selecione o banco de dados onde a tabela de destino dever ser criada. Clique
em OK para fazer a conexo.
Digite um nome de arquivo e local para o script SQL que voc est prestes a gerar, e todas as opes
que deseja incluir no cdigo SQL DDL. Este arquivo de texto existe no sistema de arquivo local, no no
repositrio.
Dependendo das opes de Gerao que voc selecionar, o script SQL conter todos os comandos
CREATE e DROP que correspondem s selees. Por exemplo, se voc criou uma definio de destino
com chaves primrias, escolha gerar o SQL com as chaves primrias.

3.

Clique em Gerar arquivo SQL, se voc deseja criar o script SQL, ou Gerar e Executar, se voc deseja
criar o arquivo e execut-lo imediatamente.
Quando voc clica em Gerar arquivo SQL, o SQL gerado para as definies de tabela selecionadas
armazenado no arquivo selecionado. Se o arquivo j existir, uma caixa de dilogo exibida, avisando-o
para substituir o arquivo existente. O progresso da cpia do arquivo SQL gerado aparece na janela
Sada no Designer.
Depois que o arquivo for gerado, clique em Editar arquivo SQL que abrir um editor de texto para
modificar as instrues SQL. Quando o Designer gera o arquivo SQL para o banco de dados de destino,
ele inclui todos os nomes de tabelas e campos que contm o caractere de barra entre aspas duplas.
Voc pode clicar em Executar arquivo SQL para criar as tabelas. Quando voc clica em Gerar e
Executar, o SQL gerado para as definies de tabela selecionadas armazenado no arquivo
selecionado e executado imediatamente.
Nota: Desde que o Designer esteja aberto, ele bloqueia o arquivo SQL que voc abriu e modificou
anteriormente. Se voc quiser desbloquear o arquivo para poder exibi-lo em um aplicativo diferente,
abra um outro arquivo SQL no Designer ou saia desse aplicativo.

4.

Clique em Fechar.
Quando voc fecha a caixa de dilogo, o Designer mantm uma conexo aberta para o banco de dados
de destino. Se voc reabrir a caixa de dilogo, no precisar se reconectar ao banco de dados de
destino.

Comandos DDL do SQL no Designer


Quando o Designer gera o cdigo SQL, ele usa SQL genrico, no a verso especfica da plataforma do
cdigo DDL. O Designer transmite essas instrues para o Gerenciador de Driver ODBC, que converte a
verso padro do SQL em comandos especficos da plataforma. No tente executar esses arquivos SQL
atravs de outro utilitrio ou usar a sintaxe como exemplo da sintaxe DDL nativa.

94

Captulo 4: Trabalhando com Destinos

Descartando e Recriando ndices


Depois de inserir quantidades de dados significativas em um destino, voc normalmente precisa descartar e
criar ndices novamente nessa tabela para otimizar a velocidade de consulta. possvel cancelar e recriar
ndices seguindo ambos os mtodos a seguir:

Usando comandos SQL de pr- e ps-sesso. O mtodo preferencial para descartar e criar ndices
novamente definir uma instruo SQL pr-sesso na propriedade Pre SQL que descarta ndices antes
de carregar dados para o destino. Use a propriedade Post SQL para criar novamente os ndices aps
carregar dados para o destino. Definir a pr e ps-sesso SQL para destinos relacionais nas
propriedades do destino do mapeamento ou na guia Mapeamento nas propriedades da sesso.

Usando o Designer. A mesma caixa de dilogo que voc usa para gerar e executar o cdigo DDL para
que a criao de tabela possa descartar e criar ndices novamente. Sempre que um fluxo de trabalho que
modifica a tabela de destino executado, inicie o Designer e use este recurso ao usar esse mtodo.

Procedimentos armazenados. Voc tambm pode usar procedimentos armazenados para descartar e
recriar ndices.

Recriando Destinos
Se voc modificar uma definio de destino relacional, use o Designer para descartar e recriar a tabela de
destino correspondente.
Nota: Quando voc descarta uma tabela de destino, o Designer exclui a tabela do banco de dados. Se voc
deseja manter os dados de destino, faa um backup antes de descartar a tabela.
Para recriar a tabela de destino:
1.

No Target Designer, modifique a definio de destino relacional e selecione-a.

2.

Clique em Destinos > Gerar/Executar SQL.


Na caixa de dilogo, conecte-se ao banco de dados de destino adequado. Selecione as opes DROP
marcadas para a tabela e quaisquer ndices na tabela.

3.

Clique em Gerar e Executar.


O Designer descarta e recria a tabela, incluindo quaisquer ndices atribudos a ela.

Solucionando Problemas de Destinos


Quando eu modifiquei uma definio de destino e usei o Designer para executar o cdigo SQL DDL,
perdi todos os dados da tabela de destino.
Quando voc modifica uma definio de destino, o Designer pode descartar e recriar a tabela. Ele no
consegue emitir um comando ALTER TABLE para alterar ou adicionar colunas. Se voc precisa modificar a
tabela, faa o backup dos dados em uma tabela temporria antes de descartar e recriar a tabela. Por outro
lado, voc pode emitir o comando ALTER TABLE, mas tenha cuidado para coincidir com a definio de
destino armazenada agora no repositrio.

Quando eu me conecto a um banco de dados para importar as definies de destino, no vejo as


tabelas, as exibies ou os sinnimos que desejo importar.
Ao se conectar ao banco de dados, verifique se digitou o nome do proprietrio corretamente. Por padro, o
nome do proprietrio que o Designer usa para identificar a importao de origens e destinos o mesmo

Solucionando Problemas de Destinos

95

nome de usurio usado para se conectar ao banco de dados. necessrio digitar um nome de proprietrio
diferente para ver os destinos que voc deseja importar.

Em vez de me mostrar um destino quando eu o arrasto para o espao de trabalho, o Designer solicita
que eu o copie ou crie um atalho.
Cada espao de trabalho representa metadados de uma nica pasta. Para editar os metadados de uma
pasta diferente, mova o foco na janela Navegador para a segunda pasta e clique em Abrir. O Designer abrir
uma outro espao de trabalho, representando os metadados da segunda pasta.

Ao abrir uma definio de destino que aparece em um mapeamento, eu no consigo edit-la.


Crie mapeamentos no Mapping Designer. Crie e modifique as definies de origem e destino no Source
Analyzer e no Target Designer. O Designer divide o processo de adio de definies de origem, definies
de destino e mapeamentos em modos separados do Designer, para ajud-lo a manter esses processos
independentes. Para modificar uma definio de destino, alterne para o Target Designer.

Quando eu tento executar um fluxo de trabalho que inclui destinos criados por mim, o log da sesso me
diz que uma ou mais tabelas no existem.
Ao criar um destino, voc est adicionando uma definio de destino ao repositrio. Para criar realmente a
tabela de destino, execute o cdigo SQL DDL necessrio no banco de dados onde voc deseja que o
destino aparea.

Eu importei um destino de um banco de dados DB2 e recebi uma mensagem de erro SQL0954C do
sistema operacional DB2.
Se o valor da varivel de sistema do DB2, APPLHEAPSZ, muito pequena quando voc usa o Designer
para importar destinos de um banco de dados DB2, o Designer informa um erro ao acessar o repositrio. A
barra de status do Designer exibe a seguinte mensagem:
SQL Error:[IBM][CLI Driver][DB2]SQL0954C: Not enough storage is available in the
application heap to process the statement.
Se voc receber essa mensagem de erro, aumente o valor da varivel APPLHEAPSZ para o sistema
operacional DB2. APPLHEAPSZ o tamanho do heap do aplicativo em pginas de 4 KB, para cada
processo usando o banco de dados.

96

Captulo 4: Trabalhando com Destinos

CAPTULO 5

Origem e Destino da
Transformao de Dados
Este captulo inclui os seguintes tpicos:

Viso Geral de Origens e Destinos, 97

Transformao de Dados , 98

Transformao de Dados , 99

Transformao de Dados , 103

Criando uma Origem ou um Destino da Transformao de Dados, 105

Criando Portas a Partir de um Servio da Transformao de Dados, 106

Viso Geral de Origens e Destinos


Use uma origem ou um destino da Transformao de Dados para processar dados em qualquer formato de
arquivo, como planilhas do Excel ou documentos em PDF. Voc tambm pode transformar dados em
formatos como HL7, EDI-X12, EDIFACT, SWIFT e DTCC.
Uma origem ou destino da Transformao de Dados chama um servio da Transformao de Dados a partir
de uma sesso do PowerCenter. Transformao de Dados o aplicativo que transforma os formatos de
arquivo. O servio da Transformao de Dados est localizado no repositrio da Transformao de Dados e
est pronto para ser executado.
Transformao de Dados
Transformao de Dados
Um editor visual para criar e configurar projetos de transformao.
Transformao de Dados
Um projeto de Transformao de Dados implantado no repositrio da Transformao de Dados e pronto
para execuo.
Transformao de Dados
Um diretrio que armazena servios executveis criados no Transformao de Dados. Voc pode
implantar projetos em repositrios diferentes, como repositrios para teste e servios de produo. O
PowerCenter localiza a instalao da Transformao de Dados a partir da varivel de ambiente
IFCONTENTMASTER_HOME. O arquivo CMConfig.xmlcontm a localizao do repositrio da
Transformao de Dados para a instalao.

97

Transformao de Dados
Um processador que executa os servios implantados no repositrio de Transformao de Dados.
Transformao de Dados
Uma biblioteca que contm transformaes internas que voc pode usar para transformar formatos de
arquivo padro.
Quando executa um servio, o Mecanismo da Transformao de Dados grava os dados de sada ou retorna
os dados transformados para o Servio de Integrao do PowerCenter. Voc pode configurar a origem ou o
destino para retornar os dados em uma porta de sada ou pode configurar grupos de sada para retornar
dados de linha.
Voc pode passar dados da origem da Transformao de Dados para um servio da Transformao de
Dados, transformar os dados e retornar os dados transformados para o pipeline.

Transformao de Dados
Quando voc criar um projeto no Transformao de Dados, defina um componente como o componente de
inicializao para o projeto. Transformao de Dados
Analisador
Converte os documentos de origem em XML. A entrada pode ter qualquer formato. A sada de um
analisador sempre XML.
Serializador
Converte um arquivo XML em outro documento. A sada pode ser de qualquer formato.
Mapeador
Converte um documento de origem XML em outra estrutura ou esquema XML.
Transformador
Modifica dados em qualquer formato. Adiciona, remove, converte ou altera o texto. Use transformadores
com um analisador, mapeador ou serializador. Voc tambm pode executar um transformador como
componente independente.
Streamer
Divide documentos de entrada grandes, como fluxos de dados de multigigabytes, em segmentos. O
Streamer divide os documentos com vrias mensagens ou vrios registros.

Definindo um nome de servio


Voc deve definir um servio da Transformao de Dados para processar dados para uma origem ou um
destino da Transformao de Dados.
Quando voc cria uma origem ou um destino da Transformao de Dados, o Designer exibe uma lista dos
servios que esto no repositrio local da Transformao de Dados. O repositrio deve estar na mesma
mquina do PowerCenter Designer. Escolha o nome de um servio da Transformao de Dados que voc
queira chamar da origem ou do destino. Voc pode alterar o nome do servio depois de criar a
transformao. O nome do servio aparece na guia Configuraes.
Para executar um servio da Transformao de Dados diferente para cada sesso, ative o atributo Nome do
Servio Dinmico. O Designer cria a porta de entrada ServiceName quando voc ativa os nomes de servio
dinmicos. Voc pode definir o nome do servio com uma varivel de mapeamento ou expresso na porta

98

Captulo 5: Origem e Destino da Transformao de Dados

ServiceName. Tambm possvel passar um nome de servio para a porta no destino da Transformao de
Dados e executar servios diferentes em uma sesso.
Quando voc ativa os nomes do servio dinmico, no pode criar portas a partir de um servio da
Transformao de Dados.

Transformao de Dados
Uma origem da Transformao de Dados representa um arquivo de qualquer formato que um servio da
Transformao de Dados possa transformar.
A origem da Transformao de Dados representa qualquer arquivo de origem. A origem da Transformao
de Dados chama um servio da Transformao de Dados em uma sesso do PowerCenter. A origem da
Transformao de Dados transmite dados ao servio da Transformao de Dados. O servio da
Transformao de Dados transforma os dados em uma estrutura que pode ser processada pela
transformao do PowerCenter. O servio da Transformao de Dados retorna os dados para a origem.
A origem da Transformao de Dados tem as seguintes guias:

Configuraes. Digite o nome do servio, o nvel de rastreamento de status e o tamanho de bloco do


streamer.

Portas. Configure as portas e os atributos da Transformao de Dados.

Hierarquia de Sada. Defina uma hierarquia de portas e grupos de sada, para permitir que a origem da
Transformao de Dados grave linhas em destinos relacionais.

Transformao de Dados
Configure os atributos da Transformao de Dados na guia Configuraes.
A tabela a seguir descreve os atributos na guia Transformao de Dados da origem da Transformao de
Dados:
Atributo

Descrio

ServiceName

Nome do servio da Transformao de Dados para executar no Repositrio local da


Transformao de Dados.

Tamanho da parte
do streamer

O tamanho do buffer dos dados que a origem da Transformao de Dados passa para o
servio da Transformao de Dadosquando esse servio Transformao de Dados
executa um streamer. Os valores vlidos so de 1 a 1.000.000 KB. O padro 256 KB.

Nvel de
Rastreamento do
Status

O nvel de status para mensagens do Mecanismo da Transformao de Dados. Somente


Descrio, Status Completo ou Nenhum.
Quando voc escolhe Status Completo, o Mecanismo da Transformao de Dados
retorna um cdigo de status e a mensagem de erro. A mensagem estar em formato
XML.
Se voc escolher Somente Descrio, o servio da Transformao de Dados retornar
um cdigo de status e uma destas mensagens de status:
-

1. Sucesso
2. Aviso
3. Falha
4. Erro
5. Erro Fatal

Transformao de Dados

99

Configurar Transformao de Dados


A Transformao de Dados representa qualquer arquivo de origem. Configure o nome do arquivo de origem
e o caminho nas propriedades da sesso. Se um servio da Transformao de Dados exigir mais arquivos
de entrada ou parmetros de servio, configure portas variveis na origem da Transformao de Dados. Use
variveis de mapeamento ou expresses para definir os arquivos ou os parmetros de servio.
Quando voc cria uma origem da Transformao de Dados, o Designer cria uma porta de sada padro. A
porta de sada retorna dados do servio de Transformao de Dados. O Designer tambm cria uma porta
InputFileName para retornar o nome do arquivo de origem atual. Quando voc configura a origem da
Transformao de Dados para receber um nome de servio dinmico, o Designer cria uma porta varivel
para o nome do servio.
possvel configurar uma hierarquia relacional de portas de sada para representar um destino relacional.
Quando voc configura uma hierarquia relacional, a origem da Transformao de Dados retorna linhas de
dados ao pipeline do PowerCenter.
Voc poder configurar portas de sada adicionais se um servio da Transformao de Dados retornar mais
de um arquivo de sada. Quando cria portas manualmente, voc pode configur-las como portas de arquivo
ou de buffer. Uma porta de arquivo contm um nome de arquivo. Uma porta de buffer contm dados.

Transformao de Dados
A tabela a seguir descreve as portas padro da origem da Transformao de Dados:
Porta

Descrio

InputFileName

Recebe o nome do arquivo de entrada.

OutputData

Retorna dados transformados.


No retorna dados quando voc configura grupos de portas de sada hierrquicos.

ServiceName

Contm o nome de servio da Transformao de Dados.

Status_Code

Retorna um cdigo de status do Mecanismo da Transformao de Dados quando o nvel de


rastreamento de status Somente Descrio ou Status Completo.

Status_ Message

Retorna uma mensagem de status do Mecanismo da Transformao de Dados quando o


nvel de rastreamento de status Somente Descrio ou Status Completo.

Se voc precisar passar os arquivos adicionais ou o nome do arquivo entre a origem e o servio da
Transformao de Dados, adicione portas. Voc pode adicionar portas manualmente ou ao selecion-las por
meio de uma lista associada com o servio de Transformaes de Dados.
A tabela a seguir descreve as portas adicionais que podem ser criadas na guia Portas:

100

Tipo de Porta

Descrio

Entrada Adicional (buffer)

Recebe dados de entrada a serem passados ao servio de Transformao de


Dados.

Entrada adicional
(arquivo)

Recebe o caminho e o nome do arquivo que sero abertos pela Transformao de


Dados.

Parmetro de Servio

Recebe um parmetro de entrada para um servio da Transformao de Dados.

Captulo 5: Origem e Destino da Transformao de Dados

Tipo de Porta

Descrio

Sada adicional (buffer)

Retorna dados por meio do servio da Transformao de Dados.

Sada Adicional (arquivo)

Retorna um nome do arquivo de sada de um servio da Transformao de Dados.


O servio da Transformao de Dados cria o arquivo.

Nota: Ao configurar grupos de portas na guia Hierarquia de Sada, uma mensagem exibida na guia
Portas dizendo que grupos hierrquicos de portas so definidos em outra guia.

Grupo Hierrquico de Portas


Voc pode configurar a origem da Transformao de Dados para passar dados de linha ao pipeline. Voc
pode configurar grupos de portas na guia Hierarquia de Sada.
Voc pode definir grupos de portas de sada e definir uma estrutura relacional para eles. Quando voc
configura grupos de sada, eles podem representar as tabelas relacionais para as quais voc deseja passar
os dados de sada. A origem da Transformao de Dados retorna linhas para as portas de grupo, em vez de
gravar um arquivo XML na porta OutputData.
Crie uma hierarquia de grupos no painel esquerdo da guia Hierarquia de Sada. O grupo PC_XSD_ROOT
o grupo raiz na parte superior da hierarquia. Cada grupo pode conter portas e outros grupos. A estrutura do
grupo representa o relacionamento entre as tabelas de destino. Quando define um grupo dentro de outro,
voc define um relacionamento pai-filho entre eles. O Designer define relacionamentos-chave entre os
grupos com uma chave gerada.
Selecione um grupo para exibir as portas dele. Quando adiciona uma porta, voc pode alterar o nome da
porta, o tipo de dados e a preciso. Se a porta precisar conter dados, selecione No Nulo. Caso contrrio,
os dados de sada so opcionais.
Ao excluir um grupo, voc exclui as portas do grupo e os grupos filho.

Exportando o Esquema de Hierarquia


Ao definir grupos de sada hierrquicos na origem da Transformao de Dados, voc deve definir a mesma
estrutura no projeto da Transformao de Dados criado para transformar os dados. Exporte a estrutura
hierrquica da origem da Transformao de Dados como um arquivo de esquema. Importar o esquema para
projeto da Transformao de Dados. Em seguida, mapeie o contedo de um documento de origem aos
elementos de XML e atributos no projeto da Transformao de Dados.
Para exportar a hierarquia de grupo na guia Hierarquia Relacional, clique em Exportar para Esquema
XML. Escolha um nome e uma localizao para o arquivo XSD. Escolha uma localizao que possa ser
acessada ao importar o esquema com o Transformao de Dados.
O Designer cria um arquivo XSD com o seguinte namespace:
"www.informatica.com/UDT/XSD/<mappingName_<Transformation_Name>>"
O esquema inclui o seguinte comentrio:
<!-- ===== AUTO-GENERATED FILE - DO NOT EDIT ===== -->
<!-- ===== This file has been generated by Informatica PowerCenter ===== -->
Se voc alterar o arquivo XSD, o servio da Transformao de Dados poder retornar dados que no tm o
mesmo formato das portas de sada na transformao de Dados No Estruturados.
Nota: Se voc criar um esquema a partir de uma hierarquia de sada de uma transformao de Dados No
Estruturados e depois excluir a hierarquia de sada, a Transformao de Dados ir causar um erro fatal.

Transformao de Dados

101

Alm disso, voc no poder usar o esquema em outra transformao Dados No Estruturados que no
tenha uma hierarquia de sada idntica.
Os elementos de XML no esquema representam as portas de sada na hierarquia. As colunas que podem
conter valores nulos tm um atributo de XML minOccurs=0 e maxOccurs=1.

Vrios Arquivos de Origem


possvel processar mais de um arquivo de origem em uma sesso configurando caracteres curinga no
nome do arquivo de origem das propriedades da sesso.
Talvez haja vrios arquivos do Excel ou PDFs que voc queira processar em uma sesso. Para processar
mais de um arquivo, configure o nome do arquivo de origem com caracteres curinga.
Nota: No possvel usar caracteres curinga nos nomes de diretrio.
Use os seguintes caracteres curinga:
* (asterisco)
Corresponde qualquer combinao de caracteres. Por exemplo, *.doc corresponde a todos os arquivos
com a extenso doc. Ou ab*.txt corresponde a todos os arquivos iniciados com ab e que tm a extenso
txt.
? (ponto de interrogao)
Corresponde um caractere. Por exemplo, ab?.txt corresponde a qualquer arquivo que tenha ab como os
dois primeiros caracteres e qualquer terceiro caractere. A extenso deve ser txt.

Processamento da Sesso de Origem


O Servio de Integrao do PowerCenter cria uma solicitao e invoca o servio da Transformao de
Dados. O Servio de Integrao do PowerCenter passa o nome do arquivo de origem, cada parmetro de
servio e o nome do arquivo de entrada para o servio da Transformao de Dados. O servio da
Transformao de Dados abre o arquivo de origem quando o tipo de entrada arquivo. Se o tipo de entrada
for buffer, o Servio de Integrao passar cada linha dos dados de origem para o servio da Transformao
de Dados. O servio da Transformao de Dados abre os arquivos de entrada adicionais.
Quando o servio da Transformao de Dados contm um servio de Streamer, o Servio de Integrao do
PowerCenter transmite um segmento dos dados de origem para o Servio da Transformao de Dados. O
Servio da Transformao de Dados processa a solicitao. Quando a solicitao concluda, o Servio de
Integrao do PowerCenter envia outro segmento de dados.
O servio da Transformao de Dados retorna dados transformados para o Servio de Integrao do
PowerCenter. A origem da Transformao de Dados retorna os dados na porta OutputBuffer, ou retorna
grupos de dados de linha. Quando o servio da Transformao de Dados retorna mais de um arquivo de
sada, ele grava o arquivo de sada e retorna o nome desse arquivo para o Servio de Integrao do
PowerCenter. A origem da Transformao de Dados retorna o nome do arquivo de sada em uma porta de
sada.
No possvel configurar particionamento com a origem da Transformao de Dados. No possvel
configurar transaes com base na origem.

102

Captulo 5: Origem e Destino da Transformao de Dados

Transformao de Dados
O destino da Transformao de Dados representa um arquivo de qualquer formato. O destino da
Transformao de Dados passa um nome de arquivo ou uma linha a um servio da Transformao de
Dados. O servio da Transformao de Dados transforma os dados e grava os arquivos de sada.
Defina a estrutura de arquivo de sada no servio da Transformao de Dados. No defina a estrutura do
arquivo de destino no destino da Transformao de Dados.
O Destino da Transformao de Dados tem as seguintes guias:

Configuraes. Insira o tipo de entrada, o nome do servio e o nvel de rastreamento de status. Escolha
aceitar um nome de servio dinmico ou criar nomes de arquivo de sada dinmicos.

Portas. Configure as portas e os atributos da Transformao de Dados.

Transformao de Dados
Configure os atributos do destino da Transformao de Dados na guia Configuraes.
A tabela a seguir descreve os atributos da guia Configuraes:
Atributo

Descrio

InputType

O tipo de dados de entrada que o destino da Transformao de Dados passa para um


servio da Transformao de Dados. Escolha um dos seguintes tipos de entrada:
- Buffer. O destino da Transformao de Dados recebe dados de origem na porta InputBuffer e
passa dados da porta para o servio da Transformao de Dados.
- Arquivo. O destino da Transformao de Dados recebe um caminho do arquivo de origem na
porta InputBuffer e passa esse caminho para o servio da Transformao de Dados. O servio
da Transformao de Dados abre o arquivo de origem.

ServiceName

Nome de um servio da Transformao de Dados no Repositrio local da Transformao de


Dados.

Nome de Sada
Dinmico

Cria um arquivo de sada diferente para cada linha de entrada. Quando o Nome de Sada
Dinmico est ativado, o destino da Transformao de Dados recebe o nome de arquivo na
porta OutputFileName.
Quando o Nome de Sada Dinmico est desativado, o servio da Transformao de Dados
cria um arquivo de sada. O padro desativado.

Nome do
Servio
Dinmico

Executa um servio da Transformao de Dados diferente, com base no valor da porta Nome
do Servio. Quando o Nome do Servio Dinmico est ativado, a porta de entrada
ServiceName deve conter o nome do servio a ser executado. Voc pode configurar o valor
da porta com uma varivel de mapeamento ou expresso. Tambm possvel passar um
valor nos dados de entrada.
Quando o nome do Servio Dinmico est desativado, o destino da Transformao de Dados
executa o mesmo servio para cada linha de entrada. O atributo Nome do Servio deve
conter um nome de servio. O padro desativado.

Transformao de Dados
O destino da Transformao de Dados usa um servio da Transformao de Dados para gravar arquivos de
destino. Se um servio da Transformao de Dados exigir mais arquivos de entrada ou parmetros de
servio, configure portas de entrada na origem da Transformao de Dados. Voc pode passar os nomes de
arquivo ou os parmetros dos dados de entrada ou pode configurar uma expresso ou varivel de
mapeamento para uma porta e passar o valor para o servio da Transformao de Dados.

Transformao de Dados

103

Quando voc cria um destino da Transformao de Dados, o Designer cria uma porta de entrada padro. A
porta de entrada recebe dados de origem ou um caminho para o arquivo de origem. Quando os dados de
entrada contm um caminho, o servio da Transformao de Dados abre o arquivo de origem.
Quando voc configura a origem da Transformao de Dados para retornar um nome de arquivo de sada
dinmico, o Designer cria a porta de entrada OutputFileName. A porta contm o nome do arquivo de sada.

Transformao de Dados
Quando voc cria um destino da Transformao de Dados, o Designer cria portas padro com base no modo
como a transformao foi configurada.
Quando voc cria um destino da Transformao de Dados, o Designer cria portas padro. Ele cria outras
portas com base no modo como voc configura a transformao. O tipo de entrada do destino da
Transformao de Dados determina como esse destino Transformao de Dadospassa dados a um servio
da Transformao de Dados.
Quando cria portas manualmente, voc pode configur-las como portas de arquivo ou de buffer. Uma porta
de arquivo contm um nome de arquivo. Uma porta de buffer contm dados.
A tabela a seguir descreve as portas padro da transformao de dados no estruturados:
Porta

Descrio

InputBuffer

Receber dados de origem se o tipo de entrada for buffer.


Receber o nome e o caminho de um arquivo de origem se o tipo de entrada for
arquivo.

OutputFileName

Retorna o nome do arquivo de sada quando voc ativa os nomes de arquivo de


sada dinmicos

ServiceName

Recebe o nome de um servio da Transformao de Dados.

Nome do servio de
Transformao de Dados
que voc deseja usar.

Retorna um cdigo de status do Mecanismo da Transformao de Dados quando o


nvel de rastreamento de status Somente Descrio ou Status Completo.

Mensagem de Status

Retorna uma mensagem de status do Mecanismo da Transformao de Dados


quando o nvel de rastreamento de status Somente Descrio ou Status
Completo.

A tabela a seguir descreve as portas adicionais que podem ser criadas na guia Portas:

104

Tipo de Porta

Descrio

Entrada Adicional
(buffer)

Recebe dados de entrada a serem passados ao servio da Transformao de Dados.

Entrada adicional
(arquivo)

Recebe o nome do arquivo e o caminho para que o servio da Transformao de


Dados o abra.

Parmetro de Servio

Recebe um parmetro de entrada para um servio da Transformao de Dados.

Sada Adicional (arquivo)

Retorna um nome de arquivo de sada de um servio da Transformao de Dados. O


servio da Transformao de Dados grava o arquivo de sada.

Captulo 5: Origem e Destino da Transformao de Dados

Processamento da Sesso de Destino


O Servio de Integrao do PowerCenter cria uma solicitao e invoca o servio da Transformao de
Dados. O Servio de Integrao do PowerCenter passa o nome do arquivo de entrada ou os dados desse
arquivo para o servio da Transformao de Dados. O servio da Transformao de Dados abre o arquivo
de origem quando o tipo de entrada arquivo. Se o tipo de entrada for buffer, o Servio de Integrao
passar cada linha dos dados de origem para o servio da Transformao de Dados. O servio da
Transformao de Dados abre os arquivos de entrada adicionais. O Servio de Integrao do PowerCenter
passa todos os parmetros de servio e o nome do arquivo de entrada para o servio da Transformao de
Dados.
Quando o servio da Transformao de Dados se baseia em um Streamer, o Servio de Integrao
transmite um segmento dos dados de origem para o Servio da Transformao de Dados. O servio da
Transformao de Dados processa a solicitao. Quando a solicitao concluda, o Servio de Integrao
envia outro segmento de dados.
O servio da Transformao de Dados grava o arquivo de sada e retorna o nome desse arquivo para o
Servio de Integrao. O destino da Transformao de Dados retorna o nome do arquivo de sada em uma
porta de sada.
Quando voc habilita um nome de arquivo de sada dinmico, o Servio de Integrao do PowerCenter cria
um arquivo de sada com base no valor da porta OutputFileName. Quando o valor da porta
OutputFileName no contm o caminho, o Servio de Integrao grava o arquivo no diretrio de arquivo de
destino nas propriedades da sesso.
No possvel configurar o particionamento com o destino da Transformao de Dados. No possvel
configurar transaes com base no destino.

Criando uma Origem ou um Destino da


Transformao de Dados
Crie uma origem ou um destino da Transformao de Dados no PowerCenter Source Analyzer ou Target
Designer.
1.

Use o menu para criar uma origem ou um destino.

Para criar uma origem da Transformao de Dados, clique em Origens > Criar.

Para criar um destino da Transformao de Dados, clique em Destinos > Criar.

2.

Selecione Transformao de Dados como o tipo de banco de dados.

3.

Digite um nome para o objeto.

4.

Clique em Criar.
A caixa de dilogo Transformao de Dados exibida.

Criando uma Origem ou um Destino da Transformao de Dados

105

5.

Configure as seguintes propriedades:


Propriedade

Descrio

Nome do Servio

Nome do servio da Transformao de Dados que voc deseja usar. O Designer exibe
os servios da Transformao de Dados na pasta de repositrio Transformao de
Dados. No escolha um nome se voc estiver planejando habilitar nomes de servios
dinmicos. Use a guia Configuraes para adicionar um nome de servio aps criar a
origem ou o destino.

Tipo de Entrada

Descreve como o servio da Transformao de Dados recebe os dados. Buffer o


padro.

Tipo de Sada

Descreve como o Mecanismo da Transformao de Dados retorna os dados de sada.


Buffer o padro.

6.

Clique em OK.

7.

Voc pode alterar o nome do servio, a entrada e o tipo de sada na guia Configuraes.

8.

Se o servio da Transformao de Dados tiver mais de um arquivo de entrada ou sada, ou se ele


precisar de parmetros de entrada, voc poder adicionar portas na guia Portas.

9.

Se voc quiser retornar dados de linha, crie grupos de portas de sada na guia Hierarquia de Sada.

10.

Para criar grupos de portas, exporte o esquema que os descreve a partir da guia Hierarquia de Sada.

11.

Importe o esquema de arquivo .xsd para o projeto da Transformao de Dados para definir a entrada ou
a sada de servio.

Criando Portas a Partir de um Servio da


Transformao de Dados
O servio da Transformao de Dados pode exigir parmetros de entrada, arquivos de entrada adicionais ou
variveis definidas pelo usurio. O servio pode retornar mais de um arquivo de sada para a origem da
Transformao de Dados. Voc pode adicionar portas que transferem parmetros e arquivos de entrada e
sada adicionais. O Designer cria portas que correspondem s portas no servio da Transformao de
Dados.
Nota: Voc deve configurar um nome de servio para preencher as portas a partir de um servio.
1.

Clique na guia Portas.

2.

Clique em Preencher a partir do servio.


O Designer exibe uma lista dos parmetros de servio disponveis, bem como portas adicionais de
entrada e sada para o servio da Transformao de Dados. O servio parmetros so variveis do
sistema e variveis definidas pelo usurio da Transformao de Dados.

106

3.

Selecione as portas para criar e configurar cada uma delas como uma porta de buffer ou de arquivo.

4.

Clique em Preencher para criar as portas que voc selecionar. Voc pode selecionar todas as portas
exibidas.

Captulo 5: Origem e Destino da Transformao de Dados

CAPTULO 6

Mapeamentos
Este captulo inclui os seguintes tpicos:

Viso Geral de Mapeamentos, 107

Trabalhando com Mapeamentos, 109

Conectando Objetos de Mapeamento , 114

Vinculando Portas, 116

Propagando Atributos de Porta, 118

Trabalhando com Origens em um Mapeamento, 124

Trabalhando com Origens Relacionais em um Mapeamento, 125

Trabalhando com Transformaes em um Mapeamento, 126

Trabalhando com Mapplets em um Mapeamento, 126

Trabalhando com Destinos em um Mapeamento, 127

Criando Arquivos de Destino por Transao, 129

Trabalhando com Destinos Relacionais em um Mapeamento, 131

Validao de um Mapeamento, 135

Usando o Assistente de Gerao de Fluxo de Trabalho, 138

Soluo de Problemas de Mapeamentos, 139

Viso Geral de Mapeamentos


Um mapeamento um conjunto de definies de origem e destino vinculadas por objetos de transformao
que definem as regras de transformao de dados. Os mapeamentos representam o fluxo de dados entre
origens e destinos. Quando o Servio de Integrao executa uma sesso, ele usa as instrues configuradas
no mapeamento para ler, transformar e gravar dados.
Cada mapeamento contm os seguintes componentes:

Definio da origem. Descreve as caractersticas de um arquivo ou de uma tabela de origem.

Transformao. Modifica os dados antes de grav-los nos destinos. Use objetos de transformao
diferentes para executar funes distintas.

Definio de destino. Define o arquivo ou a tabela de destino.

Links. Conectam origens, destinos e transformaes para que o Servio de Integrao possa mover os
dados medida que os transforma.

107

Um mapeamento tambm pode conter um ou mais mapplets. Um mapplet um conjunto de transformaes


que voc cria no Mapplet Designer e que pode usar em vrios mapeamentos.
Ao adicionar um objeto a um mapeamento, voc configura as propriedades de acordo com a forma que
deseja que o Servio de Integrao transforme os dados. Voc tambm conecta os objetos de mapeamento
de acordo com a forma que deseja que o Servio de Integrao mova os dados. Voc conecta os objetos por
meio de portas.
O Mapping Designer mostra objetos em trs exibies diferentes:

Iconizada. Mostra um cone do objeto com o seu respectivo nome.

Normal. Mostra as colunas na guia Portas e os indicadores de porta de entrada e de sada. Voc pode
conectar objetos na exibio normal.

Editar. Mostra as propriedades do objeto. Voc pode alternar entre as guias e configurar o objeto nesta
exibio.

Dependncia do Objeto
Alguns objetos em um mapeamento tambm so armazenados como objetos independentes no repositrio:

Origens

Destinos

Transformaes reutilizveis

Mapplets

O mapeamento depende desses objetos. Quando esses metadados so alterados, o Designer e outros
aplicativos do Cliente do PowerCenter controlam os efeitos dessas alteraes nos mapeamentos. Nesses
casos, voc poder perceber que esses mapeamentos se tornaram invlidos, embora no tenha editado o
mapeamento. Quando um mapeamento se torna invlido, o Servio de Integrao no pode execut-lo
corretamente e o Workflow Manager invalida a sesso.
Os nicos objetos em um mapeamento que no so armazenados como objetos de repositrio
independentes so as transformaes no reutilizveis que voc cria no mapeamento. Essas
transformaes no reutilizveis so armazenadas somente no mapeamento.

Desenvolvimento de um Mapeamento
Use as seguintes etapas como diretrizes ao desenvolver um mapeamento:

108

1.

Verificar se todas as origens, destinos e objetos reutilizveis foram criados. Crie as definies de
origem e destino. Se desejar usar mapplets, tambm ser necessrio cri-los. Voc pode criar
transformaes reutilizveis no Transformation Developer, ou pode cri-las enquanto desenvolve um
mapeamento.

2.

Criar o mapeamento. Crie um mapeamento arrastando uma origem, destino, mapplet ou transformao
reutilizvel para o espao de trabalho do Mapping Designer ou clique em Mapeamentos > Criar no
menu.

3.

Adicionar origens e destinos. Adicione origens e destinos ao mapeamento.

4.

Adicionar transformaes e lgica da transformao. Adicione transformaes ao mapeamento e


crie a lgica de transformao nas propriedades de transformao.

5.

Conectar o mapeamento. Conecte os objetos de mapeamento para criar um fluxo de dados das
origens para os destinos, atravs de mapplets e transformaes que adicionam, removem ou modificam
os dados ao longo deste fluxo.

6.

Validar o mapeamento. Valide o mapeamento para identificar erros de conexo ou transformao.

Captulo 6: Mapeamentos

7.

Salvar o mapeamento. Quando voc salva o mapeamento, o Designer o valida e identifica qualquer
erro. O Designer exibe mensagens de validao na janela Sada. Um mapeamento com erros invlido
e no possvel executar uma sesso nesse mapeamento at a sua validao.

O PowerCenter tambm fornece uma ferramenta com a qual voc pode criar um modelo para um
mapeamento do PowerCenter e gerar mltiplos mapeamentos a partir do modelo. O Mapping Architect for
Visio fornece um estncil Informatica para software Microsoft Office Visio, que contm formas que
representam os objetos de mapeamento do PowerCenter. Voc pode usar os formatos do objeto de
mapeamento para desenhar o modelo de mapeamento na janela de desenho do Visio.

Trabalhando com Mapeamentos


Voc pode realizar as seguintes tarefas com mapeamentos:

Criar um mapeamento. Ao criar um mapeamento, voc salva o nome do mapeamento no repositrio.


Ento, voc poder desenvolver e salvar o mapeamento.

Abrir um mapeamento. Voc pode abrir um mapeamento por vez em uma pasta.

Copiar um mapeamento. Voc pode copiar um mapeamento na mesma pasta ou para outra pasta.

Copiar um segmento de mapeamento. Voc pode copiar segmentos de mapeamentos e mapplets


quando quiser reutilizar uma parte da lgica do mapeamento.

Copiar objetos em um mapeamento. Voc pode copiar um ou mais objetos de um mapeamento e collos em outro mapeamento ou mapplet na mesma pasta.

Exportar um mapeamento. Voc pode exportar um mapeamento para um arquivo XML.

Importar um mapeamento. Voc pode importar um mapeamento em um arquivo XML exportado para o
Designer.

Editar um mapeamento. Voc pode adicionar, modificar ou excluir objetos em um mapeamento.

Salvar um mapeamento. Quando voc salva um mapeamento no repositrio, o Designer executa uma
validao de mapeamento.

Depurar um mapeamento. Execute o Depurador no Mapping Designer para Testar a Lgica do


Mapeamento.

Excluir um mapeamento. Exclua um mapeamento do repositrio se no quiser us-lo novamente.

Exibir caminhos de link para uma porta. Voc pode exibir caminhos de link para uma porta em um
mapeamento. possvel exibir o caminho progressivo, o caminho regressivo ou ambos.

Exibir dependncias de colunas de origem. Voc pode exibir as colunas de origem das quais uma
coluna de destino recebe dados.

Conectar objetos em um mapeamento. Voc pode conectar objetos em um mapeamento para definir o
fluxo de dados das origens para os destinos.

Vincular portas. Voc pode conectar objetos de mapeamento vinculando portas de forma manual ou
automtica por nome ou posio.

Propagar atributos de porta. Voc pode propagar atributos de porta em um mapeamento. Voc pode
propagar atributos progressivos, regressivos ou ambos.

Criao de um Mapeamento
A primeira etapa no processo de movimentao de dados entre origens e destinos criar um mapeamento
no Mapping Designer.

Trabalhando com Mapeamentos

109

Para criar um mapeamento:


1.

Abra o Mapping Designer.

2.

Clique em Mapeamentos > Criar ou arraste um objeto de repositrio para o espao de trabalho.

3.

Insira um nome para o novo mapeamento e clique em OK.


A conveno de nomenclatura de mapeamentos m_NomedoMapeamento, como
m_ProjetosdePesquisa.

Abertura de um Mapeamento
Para abrir um mapeamento, arraste-o do Navegador para o espao de trabalho do Mapping Designer. Se
voc tiver um mapeamento j aberto na mesma pasta, o Designer solicita que voc o feche antes de
continuar. Clique em OK para fechar o mapeamento atual e abrir um outro.
Voc pode abrir um mapeamento por vez em uma pasta. Se voc abrir mais de uma pasta ao mesmo tempo,
poder abrir um mapeamento em cada pasta.
Sugesto: Para abrir um mapeamento, voc tambm pode clicar com o boto direito em um mapeamento no
Navegador e selecionar Abrir.

Cpia de um Mapeamento
Voc pode copiar mapeamentos com o Designer:

Dentro de uma pasta

Para uma pasta no mesmo repositrio

Para outro repositrio

O Designer fornece o Assistente de Cpia que permite que voc copie objetos no repositrio. Quando voc
copia um mapeamento, o Assistente de Cpia cria uma cpia de cada componente do mapeamento, se o
componente ainda no existir. Se um ou mais dos componentes do mapeamento j existir, o Assistente de
Cpia solicita que voc renomeie, substitua ou reutilize esses componentes. Contudo, se o objeto for um
atalho, ou se a pasta de destino j contiver um atalho com o mesmo nome, voc no poder substituir o
objeto. Voc pode renomear ou reutilizar o objeto. Se um mapeamento contiver origens com
relacionamentos de chave primria/chave estrangeira com origens no utilizadas no mapeamento, o
Assistente de Cpia solicita que voc copie a origem relacionada.

Copiando Segmentos de Mapeamento


Voc pode copiar segmentos de mapeamentos e mapplets quando quiser reutilizar uma parte da lgica do
mapeamento. Um segmento consiste em um ou mais objetos em um mapeamento ou mapplet. Um segmento
pode incluir uma origem, um destino, uma transformao, um mapplet ou um atalho. Para copiar segmentos
de mapeamento, selecione e copie os segmentos do Mapping Designer e cole-os em um mapeamento de
destino ou em um espao de trabalho de mapeamento ou de mapplet vazio. Voc poder copiar segmentos
entre pastas ou repositrios.
Para copiar um segmento de um mapeamento ou mapplet:
1.

Abra em um mapeamento ou mapplet.

2.

Selecione um segmento realando cada objeto a ser copiado.


Voc pode selecionar vrios objetos. Tambm pode selecionar segmentos ao arrastar o ponteiro em um
retngulo ao redor dos objetos no espao de trabalho.

3.

110

Clique em Editar > Copiar ou pressione Ctrl+C para copiar o segmento para a rea de transferncia.

Captulo 6: Mapeamentos

4.

Abra em um mapeamento ou mapplet de destino. Voc tambm pode colar o segmento em um espao
de trabalho vazio.

5.

Clique em Editar > Colar ou pressione Ctrl+V.

O Designer solicita que voc renomeie, reutilize ou substitua os objetos em conflitos.

Uso do Comando Copiar Como


Para fazer alteraes em um mapeamento sem substituir o original, voc pode fazer uma cpia do
mapeamento alterado, clicando em Copiar como. Quando voc usa o comando Copiar Como, a cpia do
mapeamento salva com as alteraes e o mapeamento original permanece inalterado.
O comando Copiar Como pode ser usado apenas em itens da mesma pasta. Ao usar esse comando, voc
deve abrir o mapeamento no espao de trabalho.
Para usar o comando Copiar Como em um mapeamento:
1.

Abra um mapeamento no espao de trabalho do Mapping Designer.

2.

Clique em Mapeamentos > Copiar Como.

3.

Digite o novo nome do mapeamento.

4.

Clique em OK.
No possvel usar o comando Copiar Como para copiar atalhos.

Copiando Objetos de Mapeamento


O Designer permite que voc copie um ou mais objetos em um mapeamento. possvel colar os objetos
copiados em qualquer outro mapeamento ou mapplet na mesma pasta. Talvez voc queira copiar objetos de
um mapeamento e col-los em um outro mapeamento ou mapplet para reutilizar a lgica de transformao
criada.

Exportao e Importao de um Mapeamento


Voc exporta um mapeamento para um arquivo XML e o importa de um arquivo XML atravs do Designer.
Voc pode usar o recurso de exportao e importao para copiar um mapeamento para o mesmo
repositrio, um repositrio conectado ou um repositrio ao qual voc no consegue se conectar.

Edio de um Mapeamento
Aps criar um mapeamento, voc poder edit-lo adicionando, modificando ou excluindo objetos. Objetos
incluem definies de origem, definies de destino, mapplets e transformaes. Antes de excluir objetos no
mapeamento, o Designer exibe a lista dos objetos a serem excludos. O Designer exibe uma mensagem de
validao na janela Sada quando um mapeamento salvo.
Para ver que sesses ou atalhos podem ser afetados por alteraes feitas em um mapeamento, selecione o
mapeamento no Navegador, clique com o boto direito do mouse e selecione Exibir Dependncias. Ou
clique em Mapeamentos > Exibir Dependncias.

Reverso a um Mapeamento Previamente Salvo


Durante a edio de um mapeamento, voc pode revert-lo para um previamente salvo, desfazendo as
alteraes inseridas desde a ltima gravao. Para isso, clique em Editar > Reverter a Salvo. Ao clicar em
Sim, o Designer remove todas as alteraes inseridas desde a ltima vez que voc salvou o mapeamento.

Trabalhando com Mapeamentos

111

Renomeando e Adicionando Comentrios a um Mapeamento


possvel renomear, adicionar comentrios ou especificar links para documentao comercial de um
mapeamento a qualquer momento. Adicionar comentrios ou links de documentao comercial uma
maneira fcil de documentar a finalidade de um mapeamento. O Repository Manager e exibies MX
incluem esses comentrios para ajud-lo a analisar os metadados.
Para renomear ou adicionar comentrios a um mapeamento:
1.

Abra o mapeamento no Mapping Designer e clique em Mapeamentos > Editar.

2.

Na caixa de dilogo Editar Mapeamento, insira um novo nome para o mapeamento.

3.

Adicione uma descrio do mapeamento na caixa de comentrios.


Voc pode inserir at 2.000 caracteres.

4.

Clique em OK.

Invalidao de Sesses
Quando voc edita e salva um mapeamento, algumas alteraes invalidam a sesso, mesmo que o
mapeamento permanea vlido. O Servio de Integrao no executa sesses invlidas. Se voc editar um
mapeamento, o Designer invalida as sesses ao executar as seguintes aes:

Adicionar ou remover origens ou destinos.

Remova mapplets ou transformaes.

Substitua uma origem, destino, mapplet ou transformao ao importar ou copiar objetos.

Adicione ou remova Qualificadores de origem ou Normalizadores COBOL, ou altere a lista de origens


associadas a essas transformaes.

Adicione ou remova uma transformao Joiner ou Estratgia de atualizao.

Adicione ou remova as transformaes de um mapplet no mapeamento.

Altere o tipo de banco de dados de uma origem ou destino.

Depurao de um Mapeamento
Voc pode depurar um mapeamento vlido para obter informaes de soluo de problemas sobre
condies de dados e erros. Para depurar um mapeamento, configure e execute o Depurador no Mapping
Designer. Quando o Depurador executado, ele faz pausas em pontos de interrupo e voc pode exibir e
editar os dados de sada da transformao.

Excluso de um Mapeamento
possvel excluir mapeamentos que voc no usa mais. Ao excluir um mapeamento, no exclua quaisquer
origens, destinos, mapplets nem transformaes reutilizveis definidas fora do mapeamento.
Nota: Se voc habilitar o controle de verso, o mapeamento excludo permanecer com check-out at que
voc faa check-in nele. Para dar entrada em um mapeamento excludo, clique em Versioning (Controle de
Verso) > Find Checkouts (Localizar Check-outs). Selecione o mapeamento excludo e clique em
Ferramentas > Check In.
Voc pode excluir um mapeamento na janela Navegador ou excluir o mapeamento exibido atualmente no
espao de trabalho do Mapping Designer.

112

Para excluir um mapeamento da janela Navegador, selecione-o e pressione a tecla Excluir ou clique em
Editar > Excluir.

Captulo 6: Mapeamentos

Para excluir um mapeamento exibido atualmente no espao de trabalho do Mapping Designer, clique em
Mapeamentos > Excluir.

Exibindo Caminhos de Link Para uma Porta


Ao editar um mapeamento, voc pode exibir os caminhos de link progressivos e regressivos para uma
determinada porta. Os caminhos de link permitem que voc veja o fluxo de dados de uma coluna em uma
origem, por meio de portas em transformaes, para uma porta no destino.
Para exibir caminhos de link, realce uma porta e clique com o boto direito do mouse nela. Marque a opo
Selecionar Caminho de Link. Voc pode optar por exibir o caminho progressivo, o caminho regressivo ou
ambos. O Designer exibe todos os conectores no caminho de link que voc selecionou.
Ao exibir os dois caminhos de link, o Designer traa o fluxo de dados de uma coluna na origem, dentro e fora
de cada transformao, e em uma nica porta no destino. Para transformaes desconectadas, o Designer
no exibe um caminho de link. Quando voc usa o mapplet em um mapeamento, o objeto do mapplet exibe
apenas as portas das transformaes de entrada e de sada. Para transformaes personalizadas, o
Designer mostra que uma porta de sada depende de todas as portas de entrada por padro. Contudo, se
voc definir as relaes de porta em uma transformao personalizada, o Designer mostra as portas
dependentes que voc definiu.
Nota: Voc pode configurar a cor que o Designer usa para exibir conectores em um caminho de link.
Quando configurar as opes de formato, escolha a opo Seleo de Link.

Exibindo Dependncias da Coluna de Origem


Ao editar um mapeamento, voc pode exibir as dependncias da coluna de origem para uma coluna de
destino. Exibir as dependncias da coluna de origem permite que voc veja de quais colunas de origem uma
coluna de destino recebe dados.
Para exibir dependncias de coluna, clique com o boto direito do mouse em uma coluna de destino em um
mapeamento e selecione Mostrar Dependncias de Campo. O Designer exibe a caixa de dilogo
Dependncias de Campo, que lista todas as colunas de origem conectadas coluna de destino.
Quando voc define uma expresso de porta que executa um clculo usando vrias colunas de origem e, em
seguida, conecta essa porta a uma coluna de destino, a caixa de dilogo Dependncias de Campo lista
todas as colunas de origem usadas na expresso.
Por exemplo, voc tem o seguinte mapeamento:

Defina a seguinte expresso na porta Q3_sales na transformao do Agregador:


LAST(sales, quarter = 3)
Clique com o boto direito do mouse na coluna de destino Q3_sales e selecione Mostrar Dependncias.

Trabalhando com Mapeamentos

113

A figura seguinte mostra a caixa de dilogo Dependncias de Campo exibida:

Conectando Objetos de Mapeamento


Depois de adicionar e configurar os objetos de origem, destino e transformao em um mapeamento,
conclua o mapeamento conectando os objetos de mapeamento. Conecte objetos de mapeamento usando as
portas. Os dados so passados para dentro e para fora de uma transformao usando as portas a seguir:

Portas de entrada. Recebem dados.

Portas de sada. Transferem dados.

Portas de entrada/sada. Recebem dados e os transferem inalterados.

Cada instncia de origem, destino, mapplet e transformao contm um conjunto de portas. Cada porta
representa uma coluna de dados:

As origens fornecem dados para que eles contenham apenas as portas de sada.

Os destinos recebem dados para que eles contenham apenas portas de entrada.

Mapplets contm apenas portas de entrada e sada.

As transformaes contm uma mistura de portas de entrada, sada e entrada/sada, dependendo da


transformao e sua aplicao.

Para conectar portas, arraste entre as portas nos diferentes objetos de mapeamento. O Designer valida e
cria a conexo apenas quando ela cumpre os requisitos de validao de link e concatenao.
Voc pode deixar as portas desconectadas. O Servio de Integrao ignora as portas desconectadas.

Opes para Vinculao de Portas


Ao vincular transformaes, voc pode usar uma das seguintes opes:

Um para um. Vincule uma transformao ou grupo de sada a somente uma transformao, grupo de
entrada ou destino.

Um para muitos.
- Vincule uma porta a diversas transformaes, grupos de entrada ou destinos.
- Vincule vrias portas em uma transformao ou grupo de sada a diversas transformaes, grupos de

entrada ou destinos.

114

Muitos para um. Vincule muitas transformaes a uma transformao, grupo de entrada ou destino.

Captulo 6: Mapeamentos

Vinculando Um para Muitos


Quando desejar usar os mesmos dados para fins diferentes, voc poder vincular a porta que fornece esses
dados a vrias portas no mapeamento. Por exemplo, informaes salariais podem ser usadas para calcular
a mdia salarial de um departamento utilizando a transformao Agregador e as mesmas informaes
podem ser exibidas em uma transformao Expresso, configurada para calcular o pagamento mensal de
cada funcionrio.

Vinculando Muitos para Um


Frequentemente, h necessidade de combinar dados de vrias transformaes em uma nica transformao
ou destino. Por exemplo, pode ser que voc precise combinar dados das transformaes Agregador e
Expresso em uma nica tabela de fato.

Regras e Diretrizes para Conexo de Objetos de Mapeamento


Use as seguintes regras e diretrizes quando conectar objetos de mapeamento:

Se o Designer detecta um erro quando voc tenta vincular portas entre dois objetos de mapeamento, ele
exibe um smbolo indicando que voc no pode vincular as portas.

Siga a lgica do fluxo de dados no mapeamento. Voc pode vincular os seguintes tipos de portas:
- A porta de recepo deve ser uma porta de entrada ou de entrada/sada.
- A porta de origem deve ser uma porta de sada ou de entrada/sada.
- Voc no pode vincular portas de entrada a portas de entrada ou portas de sada a portas de sada.

Voc deve vincular pelo menos uma porta de um grupo de entrada a uma transformao upstream.

Voc deve vincular pelo menos uma porta de um grupo de sada a uma transformao downstream.

Voc pode vincular portas de uma transformao ativa ou um grupo de sada de uma transformao ativa
a um grupo de entrada de outra transformao.

Voc no pode conectar uma transformao ativa e uma transformao passiva mesma transformao
downstream ou grupo de entrada de transformao.

Voc no pode conectar mais de uma transformao ativa mesma transformao downstream ou grupo
de entrada de transformao.

Voc pode conectar qualquer nmero de transformaes passivas mesma transformao downstream,
grupo de entrada de transformao ou destino.

Voc pode vincular portas de dois grupos de sada na mesma transformao a uma transformao
Ligao configurada para dados classificados, se os dados de ambos os grupos de sada forem
classificados.

Voc s pode vincular portas a tipos de dados compatveis. O Designer verifica se pode mapear entre os
dois tipos de dados antes de vincul-los. O Servio de Integrao no pode transformar dados entre
portas com tipos de dados incompatveis. Embora os tipos de dados no precisem ser idnticos, eles tm
que ser compatveis, como Char e Varchar.

Voc deve conectar uma definio de origem somente a um qualificador de origem. Em seguida, vincule
o qualificador de origem a destinos ou outras transformaes .

Voc pode vincular colunas a uma definio de destino em um mapeamento, mas no pode copiar
colunas em uma definio de destino em um mapeamento. Use o Target Designer para adicionar colunas
a uma definio de destino.

O Designer marca alguns mapeamentos invlidos se o mapeamento violar a validao do fluxo de dados.

Conectando Objetos de Mapeamento

115

Vinculando Portas
Voc pode vincular manualmente as portas, ou vincular automaticamente as portas entre as transformaes.
Quando voc vincula as portas automaticamente, pode vincular pela posio ou pelo nome. Quando voc
vincula as portas automaticamente pelo nome, pode especificar um prefixo ou sufixo atravs da qual vincula
as portas. Use os prefixos e sufixos para indicar onde as portas ocorrem em um mapeamento. Por exemplo,
um mapeamento inclui uma porta no Qualificador de Origem chamado Name e uma porta correspondente
em uma transformao Filtro chamado FilName. Fil o prefixo que voc especifica ao vincular
automaticamente as portas entre o Qualificador de Origem e a transformao Filtro.

Vinculando Portas Manualmente


Para vincular portas manualmente, clique em Layout > Vincular Colunas. Quando voc arrasta uma porta
para outra, o Designer cria uma conexo. Quando voc arrasta uma porta para outra vazia, o Designer copia
a porta e cria uma conexo.
Voc tambm pode vincular vrias portas ao mesmo tempo. Use a tecla Ctrl ou Shift para selecionar uma
variedade de portas para vincular a uma outra transformao. O Designer vincula as portas, comeando pelo
par da parte superior. Ele vincula todas as portas que cumprem os requisitos de validao.

Vinculando Portas por Posio


Quando voc vincula por posio, o Designer vincula a primeira porta de sada primeira porta de entrada, a
segunda porta de sada segunda porta de entrada e assim por diante. Use essa opo quando criar
transformaes com portas relacionadas na mesma ordem. Utilize as seguintes opes para vincular por
posio:

Caixa de dilogo Vincular Automaticamente. Para vincular portas automaticamente usando a caixa de
dilogo Vincular Automaticamente, clique em Layout > Vincular Automaticamente.

Comando Vincular Automaticamente. Para vincular portas selecionando as portas no espao de


trabalho, clique em Layout > Vincular Automaticamente por Posio.

Vinculando Portas usando a Caixa de Dilogo Vincular Automaticamente


Para vincular portas por nome usando a caixa de dilogo Vincular Automaticamente:
1.

Clique em Layout > Vincular automaticamente.

2.

Selecione as transformaes e destinos.


Voc pode selecionar mltiplas transformaes na lista Para Transformaes, a fim de vincular uma
transformao com vrias outras. Para os objetos que contm mltiplos grupos de entrada como
transformaes Personalizadas ou destinos XML, selecione o nome do grupo na lista Para
Transformao.
Voc tambm pode selecionar as transformaes na rea de trabalho na ordem em que deseja vincullas. Em seguida, na caixa de dilogo Vinculao Automtica, selecione cada item Da Transformao e o
Designer seleciona Para Transformao, com base na ordem selecionada no espao de trabalho. Clique
em Aplicar e, em seguida, selecione o prximo Da Transformao e clique em Aplicar.

3.

Selecione a Posio.

4.

Clique em OK.
O Designer vincula a primeira porta de sada primeira porta de entrada, a segunda porta de sada
segunda porta de entrada e assim por diante.

116

Captulo 6: Mapeamentos

Vinculando Portas usando o Comando Vincular Automaticamente por Posio


Para vincular portas por posio usando o comando Vincular Automaticamente por Posio:
1.

Clique em Layout > Vincular Automaticamente por Posio

2.

Selecione o objeto de mapeamento que deseja vincular por posio e arraste as portas selecionadas
para outro objeto de mapeamento.
O Designer seleciona todas as portas de um objeto. Para selecionar portas especficas, use a caixa de
dilogo Vincular Automaticamente.

3.

O Designer vincula a primeira porta de sada primeira porta de entrada, a segunda porta de sada
segunda porta de entrada e assim por diante.

4.

Quando terminar de vincular as portas, clique em Layout > Vincular Colunas.

Vinculando Portas por Nome


possvel vincular portas por nome no Designer. O Designer adiciona links entre portas de entrada e de
sada que tm o mesmo nome. A vinculao por nome no diferencia maisculas de minsculas. Vincule por
nome quando usar os mesmos nomes de portas em transformaes. O Designer pode vincular portas
baseado nos prefixos e sufixos que voc definir. Vincule por nome e prefixo ou sufixo quando usar prefixos
ou sufixos em nomes de porta para distinguir quando eles ocorrem no mapeamento ou no mapplet. Use as
seguintes opes para vincular por nome:

Caixa de dilogo Vincular Automaticamente. Para vincular automaticamente portas por nome, vincular
portas por nome e prefixo e vincular portas por nome e sufixo usando a caixa de dilogo Vinculao
Automtica clique em Layout > Vincular Automaticamente.

Comando Vincular Automaticamente. Para vincular objetos selecionando as portas no espao de


trabalho, clique em Layout > Vincular Automaticamente por Nome.

Vinculando Portas por Nome usando a Caixa de Dilogo Vincular


Automaticamente
Para vincular portas por nome usando a caixa de dilogo Vincular Automaticamente:
1.

Clique em Layout > Vincular automaticamente.

2.

Selecione as transformaes e destinos.


Voc pode selecionar mltiplas transformaes na lista Para Transformaes, a fim de vincular uma
transformao com vrias outras. Para os objetos que contm mltiplos grupos de entrada como
transformaes Personalizadas ou destinos XML, selecione o nome do grupo na lista Para
Transformao.

3.

Selecione Nome.

4.

Clique em OK.

Vinculando Portas por Nome e Sufixo/Prefixo usando a Caixa de Dilogo


Vincular Automaticamente
Para vincular portas por nome e prefixo ou sufixo usando a caixa de dilogo Vincular automaticamente:
1.

Clique em Layout > Vincular automaticamente.

2.

Selecione as transformaes e destinos.

Vinculando Portas

117

Voc pode selecionar mltiplas transformaes na lista Para Transformaes, a fim de vincular uma
transformao com vrias outras. Para objetos que contm grupos de entrada como transformaes
Personalizadas ou destinos XML, selecione o nome do grupo na lista Para Transformao.
3.

Selecione Nome.

4.

Clique em Mais para exibir as opes de insero de prefixos e sufixos.

5.

Em Da Transformao, digite o prefixo ou sufixo usado nas portas de onde voc est vinculando.

6.

Em Para Transformao, digite o prefixo ou sufixo usado nas portas s quais voc est vinculando.
Neste exemplo, o Designer vincula portas em SQ_CUSTOMERS s portas em FIL_STATE onde o nome
da porta em FIL_STATE o mesmo que SQ_CUSTOMERS, ou o mesmo e precedido do prefixo F_.

7.

Clique em OK.

Vinculando Portas por Nome usando o Comando Vincular Automaticamente


por Nome
Para vincular portas por nome usando a caixa de dilogo Vincular Automaticamente:
1.

Clique em Layout > Vincular Automaticamente por Nome.

2.

Selecione o objeto de mapeamento que deseja vincular pelo nome e arraste as portas selecionadas
para outro objeto de mapeamento.
O Designer seleciona todas as portas de um objeto. Para selecionar portas especficas, use a caixa de
dilogo Vincular Automaticamente.

3.

O Designer adiciona links entre as portas de entrada e de sada que possuem o mesmo nome, sem
diferenciar maisculas e minsculas.

4.

Quando terminar de vincular as portas, clique em Layout > Vincular Colunas.

Propagando Atributos de Porta


Ao editar o nome de uma porta em uma transformao, o Designer propaga, por padro, nas expresses,
condies e em outras portas nessa transformao as referncias a essa porta. Tambm possvel
propagar atributos alterados em todo o mapeamento.
O Designer propaga as portas, expresses e condies com base nos seguintes fatores:

A direo que voc propaga. Voc pode propagar alteraes progressivas, regressivas ou ambas.

Os atributos que voc escolhe propagar. Voc pode propagar nome de porta, tipo de dados, preciso,
escala e descrio.

Os tipos de dependncias. Voc pode propagar as alteraes nas dependncias ao longo de um


caminho de link ou tornar implcitas as dependncias dentro de uma transformao.

Noes Bsicas de Tipos de Dependncia


Quando voc propaga os atributos de porta, o Designer pode atualizar as seguintes dependncias:

118

Dependncias de caminho do link. A dependncia de um caminho de link uma dependncia entre


uma porta propagada e as portas no seu caminho de link. Quando voc propaga as dependncias do
caminho de link, o Designer tambm realiza as atualizaes padro das referncias nas expresses, que
dependem das portas no caminho de link.

Captulo 6: Mapeamentos

Dependncias implcitas. Uma dependncia implcita uma dependncia dentro de uma transformao
entre duas portas, com base em uma expresso ou condio.
Por exemplo, quando voc altera o tipo de dados de uma porta, que usado em uma condio de
pesquisa, o Designer propaga a alterao do tipo de dados para outra porta que depende da condio.

Propagao de Dependncias em um Caminho de Link


Quando voc propaga dependncias em um caminho de link, o Designer atualiza todas as portas de entrada
e entrada/sada em seu caminho de link para frente e todas as portas de sada e entrada/sada em seu
caminho de link para trs. O Designer realiza as seguintes atualizaes:

Atualiza o nome da porta, o tipo de dados, a preciso, a escala e a descrio de todas as portas no
caminho do link da porta propagada.

Atualiza todas as expresses ou condies que se referem porta propagada com o nome de porta
alterado.

Atualiza a propriedade da porta associada em uma transformao Pesquisa dinmica, se o nome da


porta associada for alterado.

Atualiza o nome da porta das dependncias de porta de transformao Personalizada.

Nota: Ao propagar um nome de porta, o Designer adiciona 1 ao nome da porta, se existir uma porta com o
mesmo nome na transformao.

Exemplo
No mapeamento a seguir, a porta QTY na transformao Joiner vincula-se porta QTY na transformao
Agregador. A transformao Agregador consulta a porta QTY nas expresses para TOTAL_QUANTITY e
TOTAL_REVENUE:

Faa as seguintes alteraes na porta QTY na transformao Joiner:

Altere o nome da porta QTY para QUANTITY.

Altere o tipo de dados de Decimal para Inteiro.

Quando voc propaga os atributos para a frente, o Designer atualiza as seguintes dependncia na
transformao Agregador:

O Designer atualiza o nome da porta QTY para QUANTITY.

Propagando Atributos de Porta

119

O Designer atualiza a referncia ao nome da porta QTY nas expresses das portas TOTAL_QUANTITY e
TOTAL_REVENUE altera para QUANTITY.

O Designer atualiza o tipo de dados do nome da porta QTY para Inteiro.

Propagao de Dependncias Implcitas


possvel propagar tipos de dados, preciso, escala e descrio para portas com dependncias implcitas.
Ao clicar em Opes na caixa de dilogo Propagar Portas, voc pode optar por analisar condies e
expresses para identificar as dependncias implcitas da porta propagada. Todas as portas com
dependncias implcitas so portas de sada ou de entrada/sada.
Ao incluir condies, o Designer atualiza as seguintes dependncias:

Dependncias de caminho do link

Portas de sada usadas na mesma condio de pesquisa como a porta propagada

Portas associadas nas transformaes Pesquisa dinmica associadas porta propagada

Portas de sada usadas por uma transformao Personalizada para definir um relacionamento de porta
com uma ou mais portas de entrada ou portas de entrada/sada.

Portas mestres usadas na mesma condio de juno como a porta de detalhes.

Ao incluir expresses, o Designer atualiza as seguintes dependncias:

Dependncias de caminho do link

Portas de sada que contm uma expresso que usa a porta propagada

O Designer no propaga para dependncias implcitas na mesma transformao. Voc deve propagar os
atributos alterados de outra transformao. Por exemplo, quando voc altera o tipo de dados de uma porta
usada em uma condio de pesquisa e propaga essa alterao da transformao Pesquisa, o Designer no
propaga a alterao para a outra porta que depende da condio na mesma transformao Pesquisa.

Exemplo
Crie o seguinte mapeamento:

A porta MANUFACTURER_ID nos links de transformao Agregador para a porta IN_MANUFACTURER_ID


na transformao Pesquisa. A transformao Pesquisa usa a seguinte condio de pesquisa:
MANUFACTURER_ID = IN_MANUFACTURER_ID

120

Captulo 6: Mapeamentos

Altere o tipo de dados da porta MANUFACTURER_ID a partir do nmero inteiro decimal na transformao
Agregador. Escolha analisar as condies para inferir dependncias e propagar a alterao do tipo de
dados. O Designer executa as seguintes tarefas:

Atualiza dependncias do caminho do link. O Designer atualiza as portas no caminho de link,


alterando o tipo de dados da porta IN_MANUFACTURER_ID na transformao Pesquisa para decimal.

Identifica as portas dependentes. O Designer analisa a condio de pesquisa e identifica a porta


MANUFACTURER_ID na transformao Pesquisa como uma porta dependente.

Atualiza as dependncias implcitas. O Designer altera o tipo de dados da porta MANUFACTURER_ID


na transformao Pesquisa para decimal.

Atributos Propagados por Transformao


A tabela a seguir descreve as dependncias e os atributos que o Designer propaga para cada
transformao:
Transformao

Dependncia

Atributo Propagado

Agregador

- Portas no caminho de link


- Expresso

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

- Dependncias implcitas

- Tipo de dados, preciso, escala

Qualificador de
Origem de Aplicativo

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Personalizar

- Portas no caminho de link


- Dependncia de porta

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

- Dependncias implcitas

- Tipo de dados, preciso, escala

Expresso

- Portas no caminho de link


- Expresso
- Dependncias implcitas

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta
- Tipo de dados, preciso, escala, descrio

Procedimento externo

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Filtro

- Portas no caminho de link


- Condio

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

Entrada

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Juno

- Portas no caminho de link


- Condio

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

- Dependncias implcitas

- Tipo de dados, preciso, escala, descrio

Propagando Atributos de Porta

121

Transformao

Dependncia

Atributo Propagado

Pesquisa

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

- Condio
- Portas associadas (Pesquisa
dinmica)

- Nome da porta

- Dependncias implcitas

- Tipo de dados, preciso, escala, descrio

Normalizador no
Pipeline

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Qualificador de
Origem do
Normalizador

- n/d

- nenhum

Sada

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Classificao

- Portas no caminho de link


- Expresso

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

- Dependncias implcitas

- Nome da porta

- Tipo de dados, preciso, escala, descrio

122

Roteador

- Portas no caminho de link


- Condio

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

Qualificador de
Origem SDK

- n/d

- nenhum

Gerador de
Sequncia

- n/d

- nenhum

Ordenao

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Qualificador de
Origem

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

SQL

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Procedimento
armazenado

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Controle de
transao

- Portas no caminho de link


- Condio

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

Unio

- Portas no caminho de link


- Dependncias implcitas

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Tipo de dados, preciso e escala, descrio

Captulo 6: Mapeamentos

Transformao

Dependncia

Atributo Propagado

Estratgia de
Atualizao

- Portas no caminho de link


- Expresso

- Nome de porta, tipo de dados, preciso, escala,


descrio
- Nome da porta

- Dependncias implcitas

- Tipo de dados, preciso, escala, descrio

Gerador XML

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Analisador XML

- Portas no caminho de link

- Nome de porta, tipo de dados, preciso, escala,


descrio

Qualificador de
Origem XML

- n/d

- nenhum

O Designer no propaga alteraes para os seguintes objetos de mapeamento:

Transformaes desconectadas

Transformaes reutilizveis

Mapplets

Instncias de origem e de destino

Qualificador de Origem SDK

Regras e Diretrizes para Propagao de Portas e Atributos


Use as seguintes regras e diretrizes ao propagar atributos de porta:

O Designer no propaga para dependncias implcitas na mesma transformao.

Ao propagar uma descrio de porta, o Designer substitui a descrio da porta nas outras transformaes
no mapeamento.

Ao propagar em verses anteriores ao longo do caminho de link, verifique se a alterao no provocar


falha de sesso do Servio de Integrao. Por exemplo, se voc propagar alteraes para um
qualificador de origem, o Servio de Integrao pode gerar um SQL invlido ao executar a sesso. Se
voc alterar o nome da porta CUST_ID para CUSTOMER_ID, o Servio de Integrao poder gerar
um SQL para selecionar o nome de coluna incorreto se a tabela de origem usar CUST_ID.

Ao propagar atributos de porta, verifique se a alterao no faz com que o Designer invalide o
mapeamento. Por exemplo, quando voc altera o tipo de dados de uma porta de nmero inteiro para
string e propaga o tipo de dados para outras transformaes, o Designer invalida o mapeamento se um
dos clculos usar uma das portas alteradas. Valide o mapeamento aps propagar portas. Se o Designer
invalidar o mapeamento, clique em Editar > Reverter para Salvo para reverter para a ltima verso salva
do mapeamento.

Ao propagar vrias portas e uma expresso ou condio depender de mais de uma porta propagada, o
Designer no propaga atributos para dependncias implcitas se os atributos no corresponderem.
Por exemplo, voc tem a seguinte expresso em uma transformao Expresso:
Item_desc_out = Substr(ITEM_NAME, 0, 6) || Substr(ITEM_DESC, 0, 6)
A preciso de Item_desc_out 12, a de ITEM_NAME 10 e a de ITEM_DESC 10. Altere a preciso de
ITEM_DESC para 15. Selecione analisar expresses para inferir dependncias e propagar os atributos de
porta de ITEM_NAME e ITEM_DESC O Designer no atualiza a preciso da porta Item_desc_out na
transformao Expresso, pois as portas ITEM_NAME e ITEM_DESC tm precises diferentes.

Propagando Atributos de Porta

123

Etapas para Propagar Atributos de Porta


Conclua as etapas a seguir para propagar os atributos da porta.
Para propagar atributos de porta:
1.

Abra um mapeamento no Mapping Designer e selecione uma ou mais portas para propagar.

2.

Clique em Mapeamentos > Propagar atributos e selecione Propagar atributos. Tambm possvel clicar
com o boto direito do mouse e selecionar Propagar atributos.
O Designer exibir a caixa de dilogo Propagar Atributos de Porta.
Depois de abrir a caixa de dilogo Propagar Atributos de Porta, possvel selecionar qualquer porta e
propagar seus atributos.

3.

Selecione a direo e os atributos que voc deseja propagar.

4.

Como alternativa, para inferir dependncias, clique em Opes.


A seguinte tabela descreve as opes na caixa de dilogo Propagar Atributos de Porta:

5.

Opo

Descrio

Visualizar

Exibe os links para as portas afetadas em verde e as portas no afetadas em


vermelho.

Propagar

Propaga os atributos de porta de acordo com as opes especificadas na caixa


de dilogo.

Direo

Instrui o Designer a propagar atributos progressivos, regressivos ou ambos.

Atributos para propagar

Especifica os atributos que voc deseja propagar. Os atributos incluem nome,


tipo de dados, preciso, escala e descrio.

Opes

Selecione para ler as condies ou expresses e propagar atributos para


dependncias implcitas. O Designer desabilita essas opes quando voc
propaga o nome da porta. Essas opes ficam desmarcadas por padro.
Quando voc seleciona uma dessas opes e clica em Visualizar, o Designer
reala os caminhos do link para as portas dependentes.

Clique em Visualizar para exibir as portas afetadas.


O Designer exibe os links para as portas afetadas em verde e as portas no afetadas em vermelho.

6.

Clique em Propagar.
Quando voc propaga os atributos da porta, a janela Sada exibe os atributos propagados e as portas
afetadas.

7.

Clique em Fechar.

Trabalhando com Origens em um Mapeamento


Ao criar um mapeamento, voc deve adicionar uma ou mais definies de origem a ele. Ao arrastar uma
origem para o espao de trabalho do Mapping Designer, voc adiciona uma instncia da definio de origem
ao mapeamento.
Para origens relacionais, voc pode editar a definio da origem e substituir o nome da tabela de origem
padro.

124

Captulo 6: Mapeamentos

Todos os mapeamentos exigem pelo menos um dos seguintes qualificadores de origem que determina como
o Servio de Integrao l os dados da origem:

Transformao de Qualificador de Origem. Representa os dados lidos de origens de dados simples e


relacional.

Transformao de Normalizador. Representa os dados lidos nas origens COBOL.

Transformao de Qualificador de Origem de Aplicativo. Representa os dados lidos nas origens de


aplicativos.

Transformao de Qualificador de Origem de Aplicativo de Vrios Grupos. Representa os dados


lidos nas origens de aplicativo de vrios grupos.

Transformao de Qualificador de Origem XML. Representa os dados lidos de origens XML.

Voc pode permitir que o Designer crie o qualificador da origem por padro. Sempre que voc arrasta uma
instncia da origem para um mapeamento, o Designer adiciona um qualificador de origem e conecta-o
origem. Use a criao de qualificador de origem automtica para criar um qualificador de origem para cada
origem no mapeamento. Voc pode desabilitar a criao automtica para coletar dados de origens
relacionais diferentes. Em seguida, voc poder cri-los e conect-los origem.
Quando voc edita a origem no Source Analyzer, todas as instncias das origens em mapeamentos herdam
as alteraes. Algumas alteraes podem invalidar os mapeamentos que esto usando a origem.
Contudo, voc pode especificar algumas propriedades para cada instncia de origem em um mapeamento.
Clique duas vezes na instncia da origem no Mapping Designer e clique na guia Propriedades. Para origens
relacionais, voc pode especificar o nome do proprietrio da tabela. Para origens de arquivos simples, voc
pode especificar o formato de data e hora padro, o separador de milhar e o separador decimal.
Nota: Quando voc adiciona a um mapeamento uma definio de origem com algum caractere especial no
nome da tabela, o Designer substitui o caractere por um sublinhado no nome da instncia da origem do
mapeamento.

Trabalhando com Origens Relacionais em um


Mapeamento
Ao adicionar uma origem relacional a um mapeamento, voc pode exibir o nome do proprietrio da tabela e
substituir o nome da tabela de origem. Voc pode exibir essas informaes na guia Propriedades de uma
instncia de origem relacional no Mapping Designer.
O nome do proprietrio da tabela exibe o nome do proprietrio da tabela de origem no banco de dados. Para
alguns bancos de dados como DB2, as tabelas podem ter proprietrios diferentes: Voc pode substituir o
nome do proprietrio da tabela para cada instncia de origem nas propriedades da sesso.
Voc pode substituir o nome da tabela de origem para instncias de origem relacionais na guia Propriedades
da instncia de origem. Substitua o nome da tabela de origem quando usar um nico mapeamento para ler
dados de tabelas de origem diferentes. Digite um nome de tabela no nome da tabela de origem. Voc
tambm pode inserir um parmetro ou uma varivel. Voc pode usar parmetros de mapeamento, variveis
de mapeamento, parmetros de sesso, variveis de fluxo de trabalho ou variveis de worklet no nome da
tabela de origem. Por exemplo, voc pode usar um parmetro de sesso, $ParamSrcTable, como o nome da
tabela de origem e definir $ParamSrcTable como o nome da tabela de origem no arquivo do parmetro.
Nota: Se voc substituir o nome da tabela de origem na guia Propriedades da instncia de origem e
substituir o nome da tabela de origem usando uma consulta SQL, o Servio de Integrao usar o nome da
tabela de origem definido na consulta SQL.

Trabalhando com Origens Relacionais em um Mapeamento

125

Para substituir um nome de tabela de origem:


1.

No Designer, abra a ferramenta Mapping Designer.

2.

Clique duas vezes na barra de ttulo de uma instncia de origem relacional no mapeamento.

3.

Na guia Propriedades, digite o nome da tabela de origem. Tambm possvel digitar um parmetro ou
uma varivel no campo Nome da Tabela de Origem.
Se voc usar um parmetro de mapeamento definido pelo usurio, uma varivel de mapeamento, uma
varivel de fluxo de trabalho ou uma varivel de worklet, ser necessrio informar o parmetro ou a
varivel.

4.

Clique em OK.

5.

Se voc usar um parmetro ou uma varivel para o nome da tabela de origem, defina o parmetro ou a
varivel na seo apropriada do arquivo do parmetro.

Trabalhando com Transformaes em um


Mapeamento
Uma transformao um objeto de repositrio que gera, modifica ou passa dados. Voc configura uma
lgica em uma transformao que o Servio de Integrao usa para transformar dados. O Designer
proporciona um conjunto de transformaes que realizam funes especficas. Por exemplo, uma
transformao Agregador realiza clculos em grupos de dados.
Voc pode criar transformaes para usar uma vez em um mapeamento ou pode criar transformaes
reutilizveis para usar em vrios mapeamentos. Ao adicionar uma transformao reutilizvel a um
mapeamento, voc adiciona uma instncia da transformao. Quando voc edita a transformao reutilizvel
no Transformation Developer, todas as instncias da transformao em mapeamentos herdam as alteraes.
Algumas alteraes podem invalidar os mapeamentos que usam a transformao reutilizvel.

Trabalhando com Mapplets em um Mapeamento


Voc pode construir mapplets no Mapplet Designer quando quiser usar um conjunto padronizado de lgica
de transformao em vrios mapeamentos. Quando voc usa um mapplet em um mapeamento, o Designer
cria uma instncia do mapplet. Essa instncia exibe apenas as portas das transformaes de entrada e
sada. Essas transformaes so exibidas como grupos. Voc pode inserir comentrios para a instncia de
um mapplet em um mapeamento, mas no pode editar outras propriedades do mapplet.
Voc pode expandir o mapplet no Mapping Designer selecionando-o e clicando em Mapeamentos > Expandir
no menu. Essa operao expande o mapplet no mapeamento para visualiz-lo. Voc pode abrir ou gerar
cones para todas as transformaes no mapplet e no mapeamento, mas no pode editar nenhuma
propriedade.
Quando voc edita o mapplet no Mapplet Designer, todas as instncias do mapplet em mapeamentos
herdam as alteraes. Algumas alteraes podem invalidar os mapeamentos que esto usando o mapplet.

126

Captulo 6: Mapeamentos

Trabalhando com Destinos em um Mapeamento


Ao criar um mapeamento, voc deve adicionar uma ou mais definies de destino a ele. Ao arrastar uma
definio de destino para o espao de trabalho do Mapping Designer, voc adiciona uma instncia da
definio de destino.
Ao adicionar destinos a um mapeamento, voc pode incluir tipos diferentes de destinos. Voc pode incluir
destinos do mesmo tipo de banco de dados, mas conexes de banco de dados diferentes. Tambm
possvel incluir destinos de arquivo simples e relacional no mesmo mapeamento.
Quando voc edita o destino no Target Designer, todas as instncias do destino em mapeamentos herdam
as alteraes. Algumas alteraes podem invalidar os mapeamentos que esto usando o destino.
Nota: Quando voc adiciona a um mapeamento uma definio de destino com alguns caracteres especiais
no nome da tabela, o Designer substitui o caractere por um sublinhado no nome da instncia de destino do
mapeamento.
Voc pode configurar as propriedades de destinos XML, relacionais e de arquivo em um mapeamento.

Configurando Destinos Relacionais em um Mapeamento


Para destinos relacionais, possvel configurar as seguintes propriedades em um mapeamento:

Rejeitar dados truncados e excedentes. Selecione essa opo na guia Propriedades da instncia de
destino quando desejar que o Servio de Integrao grave dados truncados no arquivo rejeitado.

Substituio de atualizao. Substitua a instruo UPDATE padro usando o Editor SQL na guia
Propriedades da instncia de destino.

Prefixo do nome da tabela. Especifique o proprietrio das tabelas de destino na guia Propriedades da
instncia de destino.

SQL pr e ps-sesso. Insira comandos SQL pr-sesso para que uma instncia de destino de um
mapeamento execute os comandos no banco de dados de destino antes que o Servio de Integrao leia
a origem. Insira comandos SQL ps-sesso para executar comandos no banco de dados de destino
depois que o Servio de Integrao gravar no destino.

Nome da tabela de destino. Voc pode substituir o nome padro da tabela de destino.

TPICOS RELACIONADOS:

Trabalhando com Destinos Relacionais em um Mapeamento na pgina 131

Configurando Destinos de Arquivo Simples em um Mapeamento


Para destinos de arquivos simples, voc pode configurar as seguintes propriedades dentro de um
mapeamento:

Formato data e hora. Defina o formato data e hora padro para usar em valores de data e hora.

Separador de milhares. Defina o separador de milhar padro para usar em valores numricos.

Separador decimal. Defina o separador de decimal padro para usar em valores numricos.

Trabalhando com Destinos em um Mapeamento

127

TPICOS RELACIONADOS:

Definio de Formatos de Data e Hora e Numricos Padro na pgina 72

Configurando Destinos XML em um Mapeamento


Para destinos XML, voc pode alterar o elemento raiz. No entanto, se voc alterar a raiz, afeta a estrutura
XML de destino e pode invalidar o mapeamento.

Configurando a Ordem de Carregamento de Destino


possvel configurar a ordem de carregamento de destino de um mapeamento que contm qualquer tipo de
definio de destino. No Designer, voc pode definir a ordem em que o Servio de Integrao envia linhas
para destinos em grupos de ordem de carregamento de destino distintos em um mapeamento. Um grupo de
ordem de carregamento de destino uma coleo de qualificadores de origem, transformaes e destinos
vinculados em um mapeamento. possvel definir a ordem de carregamento de destino se voc desejar
manter a integridade referencial ao inserir, excluir ou atualizar tabelas que tm com restries de chave
primria e chave estrangeira.
O Servio de Integrao l origens em um grupo de ordem de carregamento de destino simultaneamente, e
processa grupos de ordem de carregamento de destino sequencialmente.
Para especificar a ordem em que o Servio de Integrao envia dados para destinos, crie um qualificador de
origem para cada destino em um mapeamento. Para definir a ordem de carregamento de destino, determine
em que ordem o Servio de Integrao l cada origem no mapeamento.
A figura a seguir mostra dois grupos de ordem de carregamento de destino em um mapeamento:

Neste mapeamento, o primeiro grupo de ordem de carregamento de destino inclui ITEMS, SQ_ITEMS e
T_ITEMS. O segundo grupo de ordem de carregamento de destino inclui todos os outros objetos no
mapeamento, incluindo o destino TOTAL_ORDERS. O Servio de Integrao processa o primeiro grupo de
ordem de carregamento de destino e, em seguida, o segundo grupo de ordem de carregamento de destino.
Ao processar o segundo grupo de ordem de carregamento de destino, ele l os dados de ambas as origens
ao mesmo tempo.
Para definir a ordem de carregamento de destino:
1.

Crie um mapeamento que contm vrios grupos de ordem de carregamento de destino.

2.

Clique em Mapeamentos > Plano de Carregamento de Destino.


A caixa de dilogo Plano de Carregamento de Destino lista todas as transformaes do Qualificador de
origem no mapeamento e os destinos que recebem dados de cada qualificador de origem.

3.

128

Selecione um qualificador de origem na lista.

Captulo 6: Mapeamentos

4.

Clique nos botes Para cima e Para baixo para mover o qualificador de origem na ordem de
carregamento.

5.

Repita as etapas 3 a4 para outros qualificadores de origem que desejar reorganizar.

6.

Clique em OK.

Criando Arquivos de Destino por Transao


Voc pode gerar um arquivo de sada separado sempre que o Servio de Integrao iniciar uma nova
transao. Voc pode nomear dinamicamente cada arquivo simples de destino.
Para gerar um arquivo de sada separado para cada transao, adicione uma porta FileName definio de
destino do arquivo simples. Quando voc conecta a porta FileName no mapeamento, o Servio de
Integrao cria um arquivo de destino separado em cada confirmao. O Servio de Integrao nomeia o
arquivo de sada com base no valor de porta de FileName a partir da primeira linha de cada transao. Por
padro, o Servio de Integrao grava arquivos de sada em $PMTargetFileDir.

Configurao do Destino
Adicione a coluna FilenName em uma definio de destino de arquivo simples no Target Designer.
Para adicionar uma coluna FileName:
1.

Abra a definio de destino do arquivo simples no Target Designer.

2.

Clique na guia Colunas.

3.

Clique em Adicionar coluna FileName.

O Designer cria uma porta de string chamada FileName. Voc pode alterar a preciso da porta.

Configurando o Mapeamento
Voc pode gerar arquivos de sada de confirmaes com base na origem ou definidas pelo usurio.
possvel usar uma confirmao com base na origem para confirmar dados em relao ao arquivo de destino
com base no nmero de linhas de uma origem. Por exemplo, talvez voc queira criar um arquivo de sada
separado para cada 1.000 linhas de dados. possvel configurar uma confirmao definida pelo usurio
quando o mapeamento contm um gerador de transao efetiva. Por exemplo, talvez voc queira criar um
arquivo de sada separado para cada cidade.
Em um mapeamento, conecte a porta FileName de destino a uma porta de transformao que conter um
valor exclusivo no incio de cada transao. Voc pode criar uma expresso na transformao para gerar
nomes de arquivo exclusivos e pass-los pela porta FileName.

Execuo da Sesso
Ao configurar uma porta FileName, o Servio de Integrao substitui o atributo da sesso Nome de Arquivo
de Sada pelo valor na coluna FileName. Se o valor da coluna FileName for NULL em uma linha, a linha est
com erro e o Servio de Integrao no a processa. Se a coluna FileName for NULL aps um limite de
transao, o Servio de Integrao nomeia o arquivo de sada com o nome de arquivo de sada padro.
A coluna FileName deve conter um valor exclusivo para cada transao. Se o valor da coluna FileName no
for alterado entre as transaes, o Servio de Integrao substitui o destino de arquivo simples.

Criando Arquivos de Destino por Transao

129

Se voc no conectar a porta FileName no mapeamento, o Servio de Integrao gera um arquivo de


destino e usa o nome do arquivo de sada configurado na sesso.

Regras e Diretrizes para Criao de Arquivos de Destino por


Transao
Use as seguintes regras e diretrizes ao criar colunas FileName:

possvel usar uma coluna FileName com destinos de arquivo simples.

Voc pode adicionar uma coluna FileName definio de destino de arquivo simples.

possvel usar uma coluna FileName com dados de origem em tempo real.

Se voc usar uma coluna FileName com arquivos mesclados, listas de arquivo ou destinos FTP, a sesso
falha.

Se voc passar o mesmo nome de arquivo para os destinos em vrias parties, pode obter resultados
inesperados.

Quando uma transformao descarta os limites da transao de entrada e no gera confirmaes, o


Servio de Integrao grava todas as linhas em um mesmo arquivo de sada. O nome do arquivo de
sada o valor inicial da porta FileName.

Exemplo
Uma origem contm pedidos de vrias cidades. Voc deseja usar gravar os pedidos para separar os
arquivos de sada com base na cidade.
A figura seguinte mostra um mapeamento para processar as ordens:

Alm disso, para uma origem e o qualificador de origem, o mapeamento contm os seguintes objetos:

Transformao do classificador. Classifica os dados da origem por cidade.

Transformao de expresso. Determina quando uma nova cidade exibida em uma linha e transmite
um inteiro para a porta Nova Cidade da transformao Controle de Transao. Transmite 0 por padro e
1 quando a linha contm uma nova cidade.

Transformao Controle de Transao. Avalia o valor Nova Cidade na transformao Expresso.


Quando Nova Cidade for igual a 1, a transformao Controle de Transao confirma todos os pedidos na
transao para o destino. A transformao Controle de Transao transmite a cidade e o nmero do
pedido para o destino do arquivo simples. Ela tambm transmite a cidade para a coluna FileName no
destino.

Destino do arquivo simples. Grava um novo arquivo simples para cada transao. O Servio de
Integrao atribui um nome para cada destino com o valor de FileName.

O Servio de Integrao transmite uma transao de cada cidade para o destino. Para esse exemplo, os
dados contm as seguintes cidades e nmeros de pedido:
Brisbane, 100
San Francisco, 101

130

Captulo 6: Mapeamentos

San Francisco, 104


San Francisco, 105
San Francisco,107
Tiburon, 102
Tiburon, 106
Tiburon, 102
O Servio de Integrao gera os seguintes arquivos de sada:
Brisbane
San Francisco
Tiburon

Trabalhando com Destinos Relacionais em um


Mapeamento
Ao adicionar um destino relacional a um mapeamento, voc pode configurar as seguintes propriedades:

Rejeitar dados truncados e excedentes. Selecione essa opo na guia Propriedades da instncia de
destino quando desejar que o Servio de Integrao grave dados truncados no arquivo rejeitado.

Substituio de atualizao. Substitua a instruo UPDATE padro usando o Editor SQL na guia
Propriedades da instncia de destino.

Prefixo do nome da tabela. Especifique o proprietrio das tabelas de destino na guia Propriedades da
instncia de destino.

SQL pr e ps-sesso. Voc pode inserir comandos SQL pr-sesso para que uma instncia de destino
de um mapeamento execute os comandos no banco de dados antes que o Servio de Integrao leia a
origem. Insira comandos SQL ps-sesso para executar comandos no banco de dados de destino depois
que o Servio de Integrao gravar no destino.

Nome da tabela de destino. Voc pode substituir o nome padro da tabela de destino.

Nota: Essas propriedades no podem ser configuradas no Target Designer.

Rejeitando Dados Truncados e Excedentes


O Designer permite converter dados passando-os de porta para porta. s vezes, uma converso causa um
estouro numrico (dados numricos) ou truncamento (em colunas de caracteres). Por exemplo, passar
dados de um Decimal (28, 2) para uma porta Decimal (19, 2) causa um estouro numrico. Da mesma forma,
se voc passar dados de uma String(28) para uma ponta String(10), o Servio de Integrao trunca as
strings em 10 caracteres. Quando uma converso causa um estouro, o Servio de Integrao, por padro,
ignora a linha. O Servio de Integrao no grava a linha no arquivo rejeitado. Em strings, o Servio de
Integrao trunca a string e a passa para a prxima transformao.
O Designer oferece uma opo que permite incluir todos os dados truncados e de estouro entre a ltima
transformao e o destino no arquivo rejeitado da sesso. Se voc selecionar Rejeitar Linhas Truncadas/De
estouro, o Servio de Integrao envia todas as linhas truncadas e qualquer linha de estouro para o arquivo
rejeitado da sesso ou para os logs de erros da linha, dependendo de como a sesso configurada.

Configurando a Substituio da Atualizao de Destino


Por padro, o Servio de Integrao atualiza as tabelas de destino com base nos valores das chaves. No
entanto, voc pode substituir a instruo UPDATE padro de cada destino em um mapeamento. Talvez voc
queira atualizar o destino com base em colunas no-chave.

Trabalhando com Destinos Relacionais em um Mapeamento

131

Quando o Servio de Integrao executa SQL em relao a um banco de dados de origem, destino ou
pesquisa, ele pesquisa o arquivo de palavras reservadas armazenado no diretrio de instalao do Servio
de Integrao. Coloca palavras correspondentes entre aspas. Se voc usa a substituio da atualizao de
destino, todas as palavras reservadas devem ser colocadas entre aspas manualmente.
Para um mapeamento sem uma transformao de Estratgia de atualizao ou uma transformao
Personalizada com a propriedade de estratgia de atualizao habilitada, configure a sesso para marcar as
linhas de origem como atualizar. A opo Atualizao de destino s afeta as linhas de origem marcadas
como atualizar. O Servio de Integrao processa normalmente todas as linhas marcadas como inserir,
excluir ou rejeitar. Ao configurar a sesso, marque as linhas de origem como controladas por dados. A
substituio da atualizao de destino s afeta as linhas de origem marcadas como atualizar pela
transformao Estratgia de atualizao ou Transformao Personalizada.
Por exemplo, um mapeamento passa o total das vendas de cada vendedor para a tabela T_SALES.
O Designer gera a seguinte instruo UPDATE padro para o destino T_SALES:
UPDATE T_SALES SET EMP_NAME = :TU.EMP_NAME, DATE_SHIPPED = :TU.DATE_SHIPPED,
TOTAL_SALES = :TU.TOTAL_SALES WHERE EMP_ID = :TU.EMP_ID
Como as portas de destino devem coincidir com os nomes das colunas de destino, a instruo de
atualizao inclui a palavra-chave:TU para especificar as portas na transformao de destino. Se voc
modificar a parte UPDATE da instruo, use :TU para especificar as portas.

Substituio da Clusula WHERE


Voc pode substituir a clusula WHERE para incluir colunas sem chave. Por exemplo, voc pode atualizar
somente os registros de funcionrios de nome Mike Smith. Para isso, edite a clusula WHERE conforme
abaixo:
UPDATE T_SALES SET DATE_SHIPPED = :TU.DATE_SHIPPED,
TOTAL_SALES = :TU.TOTAL_SALES WHERE :TU.EMP_NAME = EMP_NAME and
EMP_NAME = 'MIKE SMITH'

Regras e Diretrizes para Configurar a Substituio da Atualizao do Destino


Use as regras e diretrizes a seguir ao inserir as consultas de atualizao de destino:

Se voc usa a substituio da atualizao de destino, todas as palavras reservadas devem ser colocadas
entre aspas manualmente.

No ser possvel substituir a instruo padro UPDATE se o nome da coluna de destino contiver um dos
caracteres a seguir.
' , ( ) < > = + - * / \ t \ n \ 0 <space>

132

Voc pode usar parmetros e variveis na consulta de atualizao de destino. Use qualquer tipo de
parmetro ou de varivel que possa ser definido no arquivo de parmetros. possvel inserir um
parmetro ou varivel na instruo UPDATE ou usar um parmetro ou varivel como a consulta de
atualizao. Por exemplo, possvel usar um parmetro de sesso, $ParamMyOverride, como a consulta
de atualizao, e definir $ParamMyOverride como a instruo UPDATE em um arquivo de parmetro.

Quando um mapeamento for salvo, o Designer verificar se voc fez referncia a nomes de porta vlidos.
Ele no valida o SQL.

Se voc atualizar uma linha individual na tabela de destino mais de uma vez, o banco de dados s possui
dados a partir da ltima atualizao. Se o mapeamento no definir uma ordem para os dados dos
resultados, as diferentes execues do mapeamento nos dados de entrada idnticos podem resultar em
dados diferentes na tabela de destino.

Captulo 6: Mapeamentos

Uma clusula WHERE no contm nenhuma referncia de coluna que atualiza todas as linhas na tabela
de destino, ou nenhuma linha na tabela de destino, dependendo da clusula WHERE e dos dados do
mapeamento. Por exemplo, a consulta a seguir define EMP_NAME para MIKE SMITH em todas as
linhas na tabela, se alguma linha da transformao tiver EMP_ID > 100:
UPDATE T_SALES set EMP_NAME = 'MIKE SMITH' WHERE :TU.EMP_ID > 100

Se a clusula WHERE no contm nenhuma referncia de porta, o mapeamento atualiza o mesmo


conjunto de linhas para cada linha do mapeamento. Por exemplo, a consulta a seguir atualiza todos os
funcionrios com EMP_ID > 100 para ter EMP_NAME a partir da primeira linha no mapeamento:
UPDATE T_SALES set EMP_NAME = :TU.EMP_NAME WHERE EMP_ID > 100

Se o mapeamento incluir uma transformao Estratgia da Atualizao ou Transformao Personalizada,


a instruo de atualizao de destino s afeta os registros marcados para atualizar.

Se voc usar a opo Atualizao de Destino, configure a sesso para marcar todas as origens de
registros como atualizadas.

Etapas para Inserir uma Instruo de Atualizao de Destino


Use o seguinte procedimento para criar uma instruo de atualizao.
Para inserir uma instruo de atualizar destino:
1.

Clique duas vezes na barra de ttulo de uma instncia de destino.

2.

Clique em Propriedades.

3.

Clique no boto Abrir no campo Atualizar Substituio.


O Editor SQL exibido.

4.

Selecione Gerar SQL.


A instruo UPDATE padro aparece.

5.

Modifique a instruo de atualizao.


Voc pode substituir a clusula WHERE para incluir colunas sem chave.
Coloque todas as palavras reservadas entre aspas.

6.

Clique em OK.
O Designer valida a SQL quando os mapeamentos so salvos.

Configurando o Prefixo de Nome de Tabela


O prefixo de nome de tabela o proprietrio da tabela de destino. Para alguns bancos de dados como DB2,
as tabelas de destino em uma sesso podem ter proprietrios diferentes: Se o usurio do banco de dados
especificado na conexo de banco de dados no for o proprietrio das tabelas de destino de uma sesso,
especifique o proprietrio da tabela para cada instncia de destino. Uma sesso poder apresentar falhas se
o usurio do banco de dados no for o proprietrio, e voc no especificar o nome do proprietrio da tabela.
Voc pode especificar o nome do proprietrio da tabela na instncia de destino ou nas propriedades de
sesso. Quando o nome do proprietrio da tabela inserido nas propriedades de sesso, as propriedades
de transformao so substitudas.
Nota: Quando voc especificar o nome do proprietrio da tabela e definir o sqlid para um banco de dados
DB2 no ambiente SQL de conexo, o Servio de Integrao usar o nome do proprietrio da tabela na
instncia de destino. Para usar o nome do proprietrio de tabela especificado na instruo SET sqlid, no
insira um nome no prefixo de nome de destino.

Trabalhando com Destinos Relacionais em um Mapeamento

133

Para especificar um nome do proprietrio de destino no nvel da instncia de destino:


1.

No Designer, abra a ferramenta Mapping Designer.

2.

Clique duas vezes na barra de ttulo de uma instncia de destino relacional no mapeamento.

3.

Na guia Propriedades, insira o nome ou o prefixo do proprietrio da tabela no campo Valor do Prefixo do
Nome da Tabela.

4.

Clique em OK.

Adicionando Comandos SQL Pr e Ps-Sesso


possvel inserir comandos SQL pr- e ps-sesso na guia Propriedades da instncia de destino em um
mapeamento. Voc pode desejar executar SQL de pr e ps-sesso no destino para descartar ndices antes
que a sesso seja executada e recri-los quando a sesso for concluda.
O Servio de Integrao executa comandos SQL pr-sesso no banco de dados de destino antes de ler a
origem. Ele executa comandos SQL ps-sesso no banco de dados de destino depois de gravar no destino.
possvel substituir os comandos SQL na guia Mapeamentos das propriedades da sesso. Tambm
possvel configurar o Servio de Integrao para interromper ou continuar quando encontrar erros ao
executar comandos SQL pr ou ps-sesso.

Regras e Diretrizes para Adicionar Comandos SQL Pr- ou Ps-sesso


Use as regras e diretrizes a seguir ao digitar comandos SQL antes e depois da sesso na instncia de
destino:

Use qualquer comando que seja vlido para o tipo de banco de dados. No entanto, o Servio de
Integrao no permite comentrios aninhados, embora o banco de dados possa permitir.

possvel usar parmetros e variveis nos comandos SQL antes e depois da sesso. Por exemplo, voc
pode digitar um parmetro ou varivel dentro do comando. Ou voc pode usar um parmetro de sesso
$ParamMyCommand como comando SQL, e definir $ParamMyCommand para a instruo SQL no
arquivo de parmetro.

Use um ponto-e-vrgula (;) para separar mltiplas instrues. O Servio de Integrao emite uma
confirmao depois de cada instruo.

O Servio de Integrao ignora o ponto-e-vrgula dentro de /*...*/.

Se voc precisa usar um ponto-e-vrgula fora dos comentrios, pode usar o escape da barra invertida (\).

O Designer no valida o SQL.

Nota: Tambm possvel adicionar comandos SQL pr- e ps-sesso na guia Propriedades da
transformao Qualificador de Origem.

Substituindo o Nome da Tabela de Destino


possvel substituir o nome da tabela de destino na instncia de destino de um mapeamento. Substitua o
nome de tabela de destino quando usar um mapeamento nico para carregar dados para diferentes tabelas
de destino. Digite um nome de tabela no nome da tabela de destino. Voc tambm pode inserir um
parmetro ou uma varivel. Voc pode usar parmetros de mapeamento, variveis de mapeamento,
parmetros de sesso, variveis de fluxo de trabalho ou variveis de worklet no nome da tabela de destino.
Por exemplo, voc pode usar um parmetro de sesso, $ParamTgtTable, como o nome da tabela de origem
e definir $ParamTgtTable como nome da tabela de origem no arquivo de parmetros.

134

Captulo 6: Mapeamentos

Para substituir um nome da tabela de destino:


1.

No Designer, abra o Mapping Designer.

2.

Clique duas vezes na barra de ttulo de uma instncia de destino relacional no mapeamento.

3.

Na guia Propriedades, digite o nome da tabela de destino. Ou insira um nome de parmetro ou de


varivel no campo Nome da Tabela de Destino.
Se voc usar um parmetro de mapeamento definido pelo usurio, uma varivel de mapeamento, uma
varivel de fluxo de trabalho ou uma varivel de worklet, ser necessrio informar o parmetro ou a
varivel.

4.

Clique em OK.

5.

Se voc usar um parmetro ou uma varivel para o nome da tabela de destino, defina o parmetro ou a
varivel na seo apropriada do arquivo de parmetro.

Validao de um Mapeamento
Ao desenvolver um mapeamento, voc deve configur-lo para que o Servio de Integrao possa ler e
processar todo o mapeamento. O Designer marca um mapeamento invlido quando detecta erros que
impediro que o Servio de Integrao execute sesses associadas ao mapeamento.
O Designer marca um mapeamento vlido para os seguintes motivos:

Validao de conexo. As portas requeridas esto conectadas e todas as conexes so vlidas.

Validao de expresso. Todas as expresses so vlidas.

Validao de objeto. A definio de objeto independente corresponde instncia no mapeamento.

Validao de fluxo de dados. Os dados devem ser capazes de fluir das origens para os destinos sem
travar nas transformaes de bloqueio.

Validao de Conexo
O Designer executa a validao de conexo toda vez que voc conecta portas em um mapeamento e valida
ou salva um mapeamento. Ao conectar portas, o Designer verifica se voc realiza conexes vlidas. Quando
voc salva ou valida um mapeamento, o Designer verifica se as conexes so vlidas e se todas as portas
exigidas esto conectadas. Quando voc salva ou valida um mapeamento, o Designer faz as seguintes
validaes de conexo.

Pelo menos uma origem e um destino devem estar conectados.

Os qualificadores de origem devem ser mapeados para um destino.

Mapplets devem estar conectados. Pelo menos uma porta de entrada ou uma porta de sada do
mapplet est conectada ao mapeamento. Se o mapplet inclui um qualificador de origem que usa uma
substituio SQL, o Designer solicita que voc conecte todas as portas de sada do mapplet ao
mapeamento.

Os tipos de dados entre portas devem ser compatveis. Se voc alterar um tipo de dados de porta
que seja incompatvel com a porta qual est conectada, o Designer gera um erro e invalida o
mapeamento. Por exemplo, voc tem duas portas Data/Hora conectadas e altera uma delas para
Decimal. O Designer invalida o mapeamento. No entanto, voc pode alterar o tipo de dados, se ele
permanecer compatvel com as portas conectadas, como Char e Varchar.

Validao de um Mapeamento

135

TPICOS RELACIONADOS:

Conectando Objetos de Mapeamento na pgina 114

Validao de Expresso
Voc pode validar uma expresso em uma transformao enquanto est desenvolvendo um mapeamento.
Se voc no corrigiu os erros, o Designer grava as mensagens de erro na janela Sada, ao salvar ou validar
o mapeamento.
Se voc excluir as portas de entrada usadas em uma expresso, o Designer marca o mapeamento como
invlido.

Validao de Objeto
Quando um mapeamento validado ou salvo, o Designer verifica se as definies dos objetos
independentes, como origens ou mapplets, correspondem instncia no mapeamento. Se algum objeto for
alterado durante a configurao do mapeamento, o mapeamento poder conter erros.
Se algum objeto mudar enquanto voc no estiver configurando o mapeamento, o Designer e outros
aplicativos do Cliente do PowerCenter controlaro os efeitos dessas alteraes nos mapeamentos. O
Repository Manager exibe o status dos mapeamentos, de modo que voc pode ver se um mapeamento
vlido ou no. Se voc observar que um mapeamento invlido, poder abri-lo e valid-lo para ver as
mensagens de erro na janela Sada.

Validao de Fluxo de Dados


Ao validar ou salvar um mapeamento, o Designer verifica se os dados podem fluir de todas as origens em
um grupo de ordem de carregamento de destino para os destinos sem que o Servio de Integrao bloqueie
todas as origens.
Mapeamentos que incluem transformaes de bloqueio podem travar no tempo de execuo com qualquer
uma das seguintes configuraes de mapeamento:

Voc conecta um pipeline de origem a vrios grupos de entrada da transformao de bloqueio.

Voc conecta as origens e as transformaes em um grupo de ordem de carregamento de destino, de


maneira que vrias transformaes de bloqueio possam bloquear todos os pipelines de origem.
Dependendo da origem de dados usada em uma sesso, a transformao de bloqueio pode bloquear
dados de uma origem enquanto aguarda uma linha de uma outra origem.

Ao salvar ou validar um mapeamento com uma dessas configuraes, o Designer marca o mapeamento
invlido. Quando o Designer marca um mapeamento invlido porque ele viola a validao de fluxo de dados,
voc deve configurar o mapeamento de maneira diferente ou usar uma transformao sem bloqueio quando
possvel.
A figura a seguir mostra mapeamentos invlidos devido a uma origem fornecer dados para vrios grupos de
entrada de uma transformao de bloqueio:

136

Captulo 6: Mapeamentos

Para validar os mapeamentos use uma transformao sem bloqueio para MGT1 ou crie duas instncias da
mesma origem e conecte-as transformao de bloqueio.
A figura a seguir mostra dois mapeamentos semelhantes, um vlido e outro invlido:

O mapeamento A contm duas transformaes de vrios grupos que bloqueiam dados, MGT1 e MGT2. Se
foi possvel executar esta sesso, o MGT1 pode bloquear dados de S1 enquanto aguarda por uma linha de
S2. E MGT2 pode bloquear dados de S2 enquanto aguarda por uma linha de S1. As transformaes de
bloqueio bloqueariam os pipelines de origem e a sesso travaria. Portanto, o Designer marca o mapeamento
invlido.
O mapeamento B contm uma transformao de vrios grupos que bloqueia dados, MGT1. As
transformaes de bloqueio nunca podem bloquear todos os grupos de entrada, portanto, MGT1 pode
bloquear S1 ou S2, mas nunca os dois. MGT2 no uma transformao de bloqueio, portanto nunca
bloquear dados. Essa sesso, portanto, no travar no tempo de execuo devido a bloqueio. O Designer
marca o mapeamento vlido.

Etapas para Validar um Mapeamento


Voc pode validar um mapeamento enquanto trabalha no Designer. Alm disso, ao clicar em Repositrio >
Salvar, o Designer valida todos os mapeamentos desde a ltima vez que voc os salvou. Ao validar ou
salvar um mapeamento, os resultados da validao aparecem na janela Sada: O Repository Manager
tambm exibe um mapeamento vlido.
Para validar um mapeamento, localize e abra o mapeamento e clique em Mapeamentos > Validar.
Se a janela Sada no abrir, clique em Exibir > Janela Sada. Reveja os erros para determinar a correo do
mapeamento.

Validao de um Mapeamento

137

Validao de Mltiplos Mapeamentos


possvel validar vrios mapeamentos sem busc-los no espao de trabalho. Para validar vrios
mapeamentos voc deve selecion-los e valid-los na exibio de resultados da consulta ou na lista de
dependncias do objeto de exibio.
Nota: Se voc usar o Repository Manager, poder selecionar e validar vrios mapeamentos do Navegador.
possvel salvar e, como opo, fazer o check-in dos mapeamentos que mudam do status invlido para
vlido como resultado da validao.
Para validar vrios mapeamentos:
1.

Selecione mapeamentos de uma consulta ou de uma lista de dependncias de exibio.

2.

Clique com o boto direito do mouse em um dos mapeamentos selecionados e selecione Validar.
A caixa de dilogo Validar Objetos exibida.

3.

Escolher se deseja salvar objetos e fazer check-in dos objetos validados.

Usando o Assistente de Gerao de Fluxo de


Trabalho
Use o Assistente de Gerao de Fluxo de Trabalho para gerar sesses e fluxos de trabalho em um
mapeamento. O mapeamento pode usar origens e destinos relacionais e de arquivos simples.
Inicie o Assistente de Gerao de Fluxo de Trabalho de um dos seguintes locais com base no que desejar
gerar:

Opes de menu. Use o Assistente de Gerao de Fluxo de Trabalho para criar um fluxo de trabalho e
sesso para um mapeamento.

Assistente de Importao de Modelo de Mapeamento. Use o Assistente de Gerao de Fluxo de


Trabalho para criar fluxos de trabalho e sesses para vrios mapeamentos.

Antes de usar o Assistente de Gerao de Fluxo de Trabalho, verifique se o mapeamento vlido e se o


Servio de integrao e os objetos de conexo foram criados. Verifique se o mapeamento usa origens e
destinos relacionais e de arquivos simples.
O Assistente de Gerao de Fluxo de Trabalho permite executar as seguintes etapas:
1.

Especifique o tipo de sesso ou fluxo de trabalho que deseja gerar.

2.

Especifique o Servio de Integrao, as configuraes de conexo e os prefixos do nome do fluxo de


trabalho e da sesso. Os valores especificados na segunda etapa so aplicados a todas sesses e
fluxos de trabalho que voc configurar.

3.

Altere o nome do fluxo de trabalho, o nome da sesso e o Servio de Integrao. Tambm possvel
definir as configuraes de conexo. Os valores especificados na terceira etapa so aplicados ao fluxo
de trabalho e sesso que voc configurar.

A ltima pgina do assistente exibe uma lista de fluxos de trabalho ou sesses que foram geradas e o status
dos fluxos de trabalho e das sesses.
Nota: Use variveis de conexo em uma sesso que o Assistente de Gerao de Fluxo de Trabalho cria,
edite as propriedades da sesso no Workflow Manager aps o Assistente de Gerao de Fluxo de Trabalho
criar a sesso no repositrio.

138

Captulo 6: Mapeamentos

Etapas do Assistente de Gerao de Fluxo de Trabalho


As opes exibidas no assistente dependem do tipo de fluxo de trabalho ou de sesso gerado e do mtodo
usado para iniciar o Assistente de Gerao de Fluxo de Trabalho.
Para usar o Assistente de Gerao de Fluxo de Trabalho:
1.

Abra um mapeamento no espao de trabalho do Mapping Designer e selecione-o. Em seguida,


selecione Mapeamentos > Gerar Fluxos de Trabalho.
Tambm possvel iniciar o Assistente de Gerao de Fluxo de Trabalho pelo Assistente de Modelo de
Mapeamento de Importao.

2.

Selecione o tipo de fluxo de trabalho ou sesso que deseja gerar:

Sesso Reutilizvel

Fluxo de Trabalho com Sesso Reutilizvel

Fluxo de Trabalho com Sesso No Reutilizvel

3.

Clique em Avanar.

4.

Especifique o Servio de Integrao, as configuraes de conexo e o prefixo do nome da sesso e do


fluxo de trabalho.

5.

Para alterar um objeto de conexo, clique no campo do objeto da conexo. Clique no boto abrir para
abrir o Navegador de Conexo e especificar um objeto de conexo.
Para alterar o nome de um arquivo simples, edite o nome do arquivo no campo do objeto da conexo.

6.

Clique em Avanar.

7.

Altere o nome do fluxo de trabalho, da sesso ou o Servio de Integrao.

8.

Clique no boto configurar para definir as configuraes de conexo.


A caixa de dilogo Configuraes de Fluxo de Trabalho exibe as seguintes guias:

9.
10.

Guias

Descrio

Conexes

Configura origem, o destino e as informaes da conexo de transformao.

Propriedades

Configura as propriedades da sesso de origem e de destino.

Leitor/Gravador

Configura leitores e gravadores para as instncias de origem e de destino no


mapeamento.

Clique em Avanar.
Revise o status e clique em Concluir.

Soluo de Problemas de Mapeamentos


Quando salvo um mapeamento, o Designer indica que ele contm erros.
Quando voc salva um mapeamento, o Designer verifica se ele apresenta erros, como se os destinos no
recebem dados de nenhuma origem. Embora seja possvel salvar um mapeamento invlido, no possvel
us-lo para executar uma sesso.

Soluo de Problemas de Mapeamentos

139

O Designer no permite que eu me conecte a duas portas em um mapeamento.


O Designer executa uma validao quando voc conecta portas. No possvel conectar uma porta de
entrada a outra porta de entrada ou duas portas com tipos de dados incompatveis. Verifique a mensagem
de erro exibida quando o Designer impediu que voc fizesse a conexo.

No consigo conectar vrias origens a um destino.


Isso no permitido. Estas so as solues possveis:
1.

Todos os destinos so reutilizveis. Voc pode adicionar o mesmo destino ao mapeamento vrias
vezes. Em seguida, conecte cada qualificador de origem a cada destino.

2.

Una as origens em uma transformao de Qualificador de Origem. Em seguida, remova a clusula


WHERE da consulta SQL.

3.

Junte as origens em uma transformao Joiner.

Quando eu clico e arrasto para criar uma conexo entre portas, o Designer copia a porta em vez de criar
a conexo.
Altere o modo em que est trabalhando clicando em Layout > Vincular Colunas. Agora, quando voc arrasta
itens entre colunas, o Designer tenta vincul-los em vez de copiar a porta selecionada.

Quando valido um mapeamento, no consigo ver os resultados do teste.


Certifique-se de que a janela Sada esteja aberta quando validar o mapeamento. Clique em Exibir > janela
Sada para ver os resultados da validao.

Eu inseri uma consulta personalizada, mas ela no funciona quando executo o fluxo de trabalho.
No deixe de testar essa configurao para a transformao de qualificador de origem antes de executar o
fluxo de trabalho. Retorne ao qualificador de origem e abra novamente a caixa de dilogo em que voc
inseriu a consulta personalizada. Voc pode se conectar a um banco de dados e clicar no boto Validar para
testar o SQL. O Designer mostra os erros existentes no SQL que voc inseriu. Analise os registros da
sesso se precisar de mais informaes.

140

Captulo 6: Mapeamentos

CAPTULO 7

Mapplets
Este captulo inclui os seguintes tpicos:

Viso Geral de Mapplets, 141

Noes Bsicas de Entrada e Sada do Mapplet , 142

Uso do Mapplet Designer, 144

Usando Mapplets em Mapeamentos, 147

Regras e Diretrizes para Mapplets, 149

Dicas para Mapplets, 150

Viso Geral de Mapplets


Um mapplet um objeto reutilizvel que voc cria no Mapplet Designer. Ele contm um conjunto de
transformaes e lhe permite reutilizar a lgica de transformao nos mapeamentos.
Por exemplo, se voc tiver vrias tabelas fato que exigem uma srie de chaves de dimenso, possvel criar
um mapplet que contm uma srie de transformaes Lookup para localizar cada chave de dimenso. Voc
pode usar o mapplet em cada mapeamento de tabela fato, em vez de recriar a mesma lgica de pesquisa
em cada mapeamento.
Quando voc usar um mapplet em um mapeamento, use uma instncia do mapplet. exemplo de uma
transformao reutilizvel, qualquer alterao feita no mapplet herdada por todas as instncias dele.
Os mapplets ajudam a simplificar os mapeamentos da seguinte maneira:

Incluir definies de origem. Usar vrias definies de origem e qualificadores de origem para fornecer
dados de origem a um mapeamento.

Aceitar dados das origens em um mapeamento. Se voc quiser que o mapplet receba os dados do
mapeamento, use uma transformao Entrada para receber os dados de origem.

Incluir vrias transformaes. Um mapplet pode conter tantas transformaes quantas forem
necessrias.

Passar dados para vrias transformaes. Voc pode criar um mapplet para alimentar dados para
vrias transformaes. Cada transformao Sada em um mapplet representa um grupo de sada em um
mapplet.

Contm portas no usadas. No necessrio conectar todas as portas de entrada e sada do mapplet
em um mapeamento.

141

Noes Bsicas de Entrada e Sada do Mapplet


Para usar um mapplet em um mapeamento, voc deve configur-lo para entrada e sada. Alm da lgica de
transformao que voc configura, o mapplet tem os seguintes componentes:

Entrada de mapplet. possvel transmitir dados para um mapplet usando definies de origem ou
transformaes de Entrada, ou ambas. Ao usar uma transformao de Entrada, voc a conecta ao
pipeline de origem no mapeamento.

Sada do mapplet. Cada mapplet deve conter uma ou mais transformaes de Sada para transmitir
dados do mapplet para o mapeamento.

Portas de mapplet. Portas de Mapplet so exibidas somente no Mapping Designer. As Portas de


mapplet consistem em portas de entrada das transformaes de Entrada e portas de sada das
transformaes de Sada. Se um mapplet usa definies de origem em vez de transformaes de Entrada
para entrada, ele no tem nenhuma porta de entrada no mapeamento.

Entrada de Mapplet
A entrada do mapplet pode ser criada a partir de uma definio de origem e/ou de uma transformao
Entrada no mapplet. possvel criar vrios pipelines em um mapplet. Use vrios qualificadores de origem,
definies de origem ou transformaes Entrada. Voc tambm pode usar uma combinao de definies de
origem e transformaes Entrada.

Usando Definies de Origem para Entrada de Mapplet


Use uma ou mais definies de origem em um mapplet para fornecer os dados de origem. Quando voc usa
o mapplet em um mapeamento, ele o primeiro objeto no pipeline do mapeamento e no contm portas de
entrada.

Uso de Transformaes Entrada para a Entrada de Mapplet


Use uma transformao Entrada em um mapplet quando quiser que ele receba a entrada de uma origem em
um mapeamento. Quando voc usa o mapplet em um mapeamento, a transformao Entrada fornece portas
de entrada, fazendo com que voc passe os dados atravs do mapplet. Cada porta na transformao
Entrada conectada a uma outra transformao no mapplet se torna uma porta de entrada de mapplet.
Transformaes de entrada podem receber dados de uma nica fonte ativa. Portas no conectadas no so
exibidas no Mapping Designer.
Voc pode conectar uma transformao Entrada para vrias transformaes em um mapplet. Mas no pode
conectar uma porta nica na transformao Entrada para vrias transformaes em um mapplet.

Sada de Mapplet
Use uma transformao de Sada em um mapplet para transmitir dados atravs do mapplet para um
mapeamento. O mapplet deve conter pelo menos uma transformao de Sada com pelo menos uma porta
conectada ao mapplet. Cada porta conectada em uma transformao de Sada exibida como porta de
sada de mapplet no mapeamento. Cada transformao de Sada em um mapplet exibida como um grupo
de sadas no mapeamento. Um grupo de sadas pode transmitir dados para vrios pipelines em um
mapeamento.

142

Captulo 7: Mapplets

Exibindo a Entrada e a Sada do Mapplet


Os mapplets e as portas de mapplet so exibidos de forma diferente no Mapplet Designer e no Mapping
Designer.
A figura seguinte mostra um mapplet com uma transformao de entrada e de sada:

Quando voc usa o mapplet em um mapeamento, o objeto do mapplet exibe apenas as portas das
transformaes de entrada e de sada. Elas so referidas como as portas de entrada e de sada do mapplet.
A figura seguinte mostra o mesmo mapplet no Mapping Designer:

O mapplet exibe as portas de entrada na transformao de entrada. As portas de sada na transformao de


sada CODES_MAP0 so exibidas abaixo das portas de entrada.
Voc pode expandir o mapplet no Mapping Designer, selecionando-o e clicando em Mapeamentos >
Expandir. Essa operao expande o mapplet no mapeamento para visualiz-lo. Os cones da transformao
em um mapplet expandido so exibidos em cinza.
Voc pode abrir ou gerar cones para todas as transformaes no mapplet e no mapeamento. Voc no
pode editar nenhuma propriedade, navegar para outras pastas ou salvar o repositrio enquanto o mapplet
est expandido.

Noes Bsicas de Entrada e Sada do Mapplet

143

A figura a seguir mostra um mapplet expandido no Mapping Designer:

Em um mapeamento expandido, no possvel ver as transformaes de entrada e de sada.

Uso do Mapplet Designer


Depois de criar um mapplet, voc pode valid-lo ou edit-lo no Mapplet Designer. Voc tambm pode usar o
Designer para copiar, exportar e importar mapplets, exibir os links entre as portas de um mapplet, criar
atalhos e excluir mapplets a partir do repositrio.
Para criar e configurar um mapplet no Mapplet Designer, execute as tarefas a seguir:
1.

Criar um mapplet. Clique em Mapplets > Criar do menu no Mapplet Designer. A conveno de
nomenclatura recomendada para mapplets mplt_MappletName.

2.

Criar a lgica de transformao de mapplet. Criar e vincular as transformaes da mesma maneira que
em um mapeamento.

3.

Criar portas de mapplet.

Criao de um Mapplet
Um mapplet pode ser ativo ou passivo, dependendo das transformaes presentes. Mapplets ativos contm
uma ou mais transformaes ativas. Mapplets passivos contm somente transformaes passivas. Quando
voc usa um mapplet em um mapeamento, todas as regras de transformao se aplicam ao mapplet,
dependendo do tipo. Por exemplo, em uma transformao ativa, voc no pode concatenar os dados de um
mapplet ativo com um pipeline diferente.
Utilize as seguintes regras e diretrizes ao adicionar transformaes a um mapplet:

Se voc usar uma transformao Gerador de Sequncia, ela deve ser reutilizvel.

Se voc usar uma transformao Procedimento Armazenado, deve configurar o Tipo de Procedimento
Armazenado como Normal.

Voc no pode incluir funes LOOKUP no estilo PowerMart 3.5 em um mapplet.

Voc no pode incluir os seguintes objetos em um mapplet:


- Transformaes de normalizadores
- Origens COBOL

144

Captulo 7: Mapplets

- Transformaes de Qualificador de Origem XML


- Origens XML
- Definies de destino
- Outros mapplets

Embora as transformaes reutilizveis e atalhos em um mapplet possam ser usados, use uma cpia de
uma transformao para proteger a validade do mapplet. Transformaes reutilizveis e atalhos herdam as
alteraes em suas transformaes originais. Isto pode invalidar o mapplet e os mapeamentos que o
utilizam.

Validao de Mapplets
O Designer valida um mapplet quando ele salvo. Um mapplet tambm pode ser validado usando o
comando de menu Mapplets > Validar. Quando um mapplet validado, o Designer grava todas as
mensagens relevantes sobre o mapplet na janela Sada.
O Designer valida o pipeline do mapplet da mesma forma que valida um mapeamento. O Designer tambm
executa as seguintes verificaes especficas para mapplets:

O mapplet pode conter transformaes de Entrada e definies de origem com pelo menos uma porta
conectada a uma transformao no mapplet.

O mapplet contm pelo menos uma transformao de Sada com pelo menos uma porta conectada a uma
transformao no mapplet.

Edio de Mapplets
Voc pode editar um mapplet no Mapplet Designer. O Designer valida as alteraes quando voc salva o
mapplet. Ao salvar as alteraes em um mapplet, todas as instncias do mapplet e todos os respectivos
atalhos herdam as alteraes. Essas alteraes podem invalidar mapeamentos que usam o mapplet.
Para ver que mapeamentos ou atalhos podem ser afetados pelas alteraes que voc faz em um mapplet,
selecione o mapplet no Navegador, clique com o boto direito do mouse e selecione Dependncias. Ou
clique em Mapplets > Dependncias no menu.
possvel realizar as seguintes alteraes no mapplet sem afetar a validade de mapeamentos e sesses
existentes:

Adicionar portas de entrada ou de sada.

Alterar nomes de portas ou comentrios.

Alterar nomes de transformaes de Entrada ou de Sada ou comentrios.

Alterar nomes de transformaes, comentrios ou propriedades.

Alterar valores padro de porta de transformaes no mapplet.

Adicionar ou remover transformaes no mapplet, desde que no se altere o tipo de mapplet de ativo
para passivo ou de passivo para ativo.

Use as seguintes regras e diretrizes quando editar um mapplet usado por mapeamentos:

No exclua uma porta do mapplet. O Designer exclui portas de mapplet no mapeamento quando voc
exclui links para uma transformao de Entrada ou de Sada ou ao excluir portas conectadas a uma
transformao de Entrada ou de Sada.

No altere tipo de dados, preciso ou escala de uma porta de mapplet. O tipo de dados, a preciso e
a escala de uma porta de mapplet so definidos pela porta de transformao qual esses itens esto
conectados no mapplet. Portanto, se voc editar um mapplet para alterar o tipo de dados, a preciso ou a

Uso do Mapplet Designer

145

escala de uma portaconectada a uma porta em uma transformao de Entrada ou de sada, voc alterar
a porta de mapplet.

No altere o tipo de mapplet. Se voc remover todas as transformaes ativas de um mapplet ativo, o
mapplet se torna passivo. Se voc adicionar uma transformao ativa a um mapplet passivo, o mapplet
se torna ativo.

Mapplets e Mapeamentos
As tarefas de mapeamentos a seguir tambm podem ser realizadas nos mapplets:

Definir nvel de rastreamento. Voc pode definir o nvel de rastreamento nas transformaes individuais
dentro de um mapplet da mesma maneira que em um mapeamento.

Copiar mapplet. Voc pode copiar um mapplet de uma pasta para outra como voc faria com qualquer
outro objeto de repositrio. Depois de copiar o mapplet, ele aparece no n dos Mapplets da nova pasta.
Se voc fizer alteraes em um mapplet sem substituir o mapplet original, poder fazer uma cpia do
mapplet alterado, clicando em Mapplets > Copiar como.

146

Exportar e importar mapplets. Voc pode exportar um mapplet para um arquivo XML ou import-lo de
um arquivo XML atravs do Designer. Talvez voc queira usar o recurso exportar e importar para copiar
um mapplet para outro repositrio.

Excluir mapplets. Ao excluir um mapplet, voc exclui todas as instncias do mapplet. Isso invalida cada
mapeamento que contm uma instncia do mapplet ou um atalho para o mapplet.

Comparar mapplets. Voc pode comparar dois mapplets para identificar as diferenas entre eles. Por
exemplo, se voc tem mapplets com o mesmo nome em pastas diferentes, possvel compar-los para
ver se so diferentes.

Comparar instncias em um mapplet. Voc pode comparar instncias em um mapplet para ver se elas
contm atributos semelhantes. Por exemplo, possvel comparar uma instncia de origem ou uma
transformao com outra transformao. Voc pode comparar instncias dentro de um mapplet da
mesma forma que compara instncias dentro de um mapeamento.

Criar atalhos para mapplets. possvel criar um atalho para o mapplet se ele estiver em uma pasta
compartilhada. Quando voc usa um atalho para um mapplet em um mapeamento, ele herda todas as
alteraes feitas no mapplet. No entanto, essas alteraes talvez no apaream at que o Servio de
Integrao execute o fluxo de trabalho usando o atalho. Portanto, use um atalho para um mapplet
somente se voc no pretender edit-lo.

Adicionar uma descrio. Voc pode adicionar uma descrio para o mapplet no Mapplet Designer da
mesma maneira que em um mapeamento. Tambm possvel adicionar uma descrio para a instncia
de mapplet em um mapeamento. Ao adicionar uma descrio, voc tambm pode criar links para
arquivos de documentao. Os links devem ser uma URL ou caminho de arquivo vlido para fazer
referncia documentao comercial.

Exibir link para uma porta. Voc pode exibir links para uma porta em um mapplet da mesma forma que
os exibiria em um mapeamento. possvel exibir o caminho progressivo, o caminho regressivo ou
ambos.

Propagar atributos de porta. possvel propagar atributos de porta em um mapplet da mesma forma
que os propagaria em um mapeamento. Voc pode propagar atributos progressivos, regressivos ou
ambos.

Captulo 7: Mapplets

Usando Mapplets em Mapeamentos


Em um mapeamento, um mapplet tem portas de entrada e sada que voc pode conectar a outras
transformaes. Voc no precisa conectar todas as portas do mapplet em um mapeamento. No entanto, se
o mapplet contm uma substituio SQL, voc deve conectar todas as portas de sada do mapplet no
mapeamento.
Como ocorre em uma transformao reutilizvel, quando voc arrasta um mapplet em um mapeamento, o
Designer cria uma instncia do mapplet. Voc pode inserir comentrios para a instncia do mapplet no
mapeamento. Voc no pode editar o mapplet de outras maneiras no Mapping Designer.
Se voc editar o mapplet no Mapplet Designer, cada instncia do mapplet herda as alteraes.
Os Relatrios do Repositrio do PowerCenter tm um relatrio de lista de Mapplets que voc usa para exibir
todos os mapeamentos que usam um mapplet especfico.
Para usar um mapplet, execute as etapas a seguir:
1.

Arraste o mapplet para o mapeamento.

2.

Se o mapplet contm portas de entrada, conecte pelo menos uma delas a uma transformao no
mapeamento.

3.

Conecte pelo menos uma porta de sada do mapplet a uma transformao no mapeamento.

Criao e Configurao de Portas de Mapplet


Aps criar a lgica de transformao de um mapplet, voc pode criar portas de mapplet. Use uma
transformao de Entrada para definir portas de entrada do mapplet se o mapplet no contiver definies de
origem. Use uma transformao de Sada para criar um grupo de portas de sada. Apenas portas conectadas
em uma transformao de Entrada ou Sada se tornam portas de entrada ou sada de mapplet em um
mapeamento. As portas no conectadas no so exibidas quando voc usa o mapplet em um mapeamento.
possvel criar uma porta de mapplet das seguintes maneiras:

Crie manualmente portas na transformao de Entrada/Sada. possvel criar nomes de porta em


transformaes de Entrada e Sada. possvel tambm inserir uma descrio de cada nome de porta. A
porta no tem nenhum tipo de dados, preciso ou escala definidos at que voc a conecte a uma
transformao no mapplet.

Arraste uma porta de outra transformao. possvel criar uma porta de entrada ou sada arrastando
uma porta de uma outra transformao para a transformao de Entrada ou Sada. A nova porta herda o
nome da porta, a descrio, o tipo de dados e a escala da porta original. possvel editar o nome da
nova porta e a descrio na transformao. Se voc alterar uma conexo de porta, o Designer atualiza a
porta da transformao de Entrada ou Sada para corresponder aos atributos da nova conexo.

possvel exibir o tipo de dados, a preciso e a escala das portas de mapplet disponveis quando voc usa
o mapplet em um mapeamento.

Conexo s Portas de Entrada do Mapplet


Ao usar um mapplet com portas de entrada em um mapeamento, voc conecta as portas de entrada ao
pipeline de mapeamento. Voc s pode passar dados para um mapplet quando ele originrio de uma nica
transformao ativa.

Usando Mapplets em Mapeamentos

147

Por exemplo, na figura a seguir, o mapplet mpltLookupAndCompare aceita dados de duas transformaes
Expresso, porque os dados de ambas as transformaes se originam de um nico qualificador de origem. O
Qualificador de origem SQ_CUSTOMERS a transformao ativa que fornece dados de origem mapplet:

Conexo aos Grupos de Sada de Mapplet


Quando voc usa um mapplet em um mapeamento, a exibio de cada transformao Sada igual a de um
grupo de sada. Conecte as portas de sada do mapplet ao pipeline do mapeamento. Use a Vinculao
Automtica para conectar as portas.
Use as regras e diretrizes a seguir ao conectar as portas de sada do mapplet no mapeamento:

Se um mapplet contiver um qualificador de origem que tenha uma substituio para consulta SQL padro,
voc deve conectar todas as portas do qualificador de origem prxima transformao dentro do
mapplet.

Se o mapplet contm mais de um qualificador de origem, use uma transformao Joiner para a juno da
sada a um pipeline.

Se o mapplet contm somente um qualificador de origem, voc deve conectar as portas de sada a
pipelines separados. Voc no pode usar uma transformao Joiner para a juno da sada.
Se voc precisa fazer a juno dos pipelines, crie dois mapeamentos para realizar essa tarefa:
- Use o mapplet no primeiro mapeamento e grave os dados de cada pipeline em destinos diferentes.
- Use os destinos como origens no segundo mapeamento para fazer a juno dos dados, e execute

quaisquer transformaes adicionais necessrias.

Exibindo o Mapplet
Quando voc usa um mapplet em um mapeamento, o Designer exibe o objeto do mapplet que contm
apenas as portas de entrada e de sada do mapplet. Contudo, voc pode expandir o mapplet, clicando em
Mapeamentos > Expandir no menu.
Quando o Designer expande o mapplet, ele exibe o mapplet inteiro com as transformaes do mapplet. Ele
no exibe as transformaes de Entrada e de Sada. Voc pode exibir o mapeamento na forma expandida,
mas no pode edit-lo. Para continuar criando o mapeamento, clique em Mapeamentos > Recolher.

148

Captulo 7: Mapplets

Configurando o Plano de Carregamento de Destino


Ao usar um mapplet em um mapeamento, o Mapping Designer permite definir o plano de carregamento de
destino de origens no mapplet.

Particionamento de Pipeline
Se a opo de particionamento estiver disponvel, ser possvel aumentar o nmero de parties em um
pipeline para melhorar o desempenho da sesso. Aumentar o nmero de parties permite que o Servio de
Integrao crie vrias conexes com origens e processe parties de dados de origem simultaneamente.
Quando voc cria uma sesso, o Workflow Manager valida cada pipeline do mapeamento para
particionamento. Voc poder especificar vrias parties em um pipeline se o Servio de Integrao puder
manter consistncia de dados ao processar os dados particionados.
Algumas restries de particionamento se aplicam aos mapplets.

Regras e Diretrizes para Mapplets


A lista a seguir resume as regras e diretrizes que aparecem em todo o captulo:

Voc pode conectar uma transformao Entrada para vrias transformaes em um mapplet. Mas no
pode conectar uma porta nica na transformao Entrada para vrias transformaes em um mapplet.

Uma transformao de entrada deve receber dados de uma nica fonte ativa.

Um mapplet deve conter pelo menos uma transformao Entrada ou definio de origem com pelo menos
uma porta conectada a uma transformao no mapplet.

Um mapplet deve conter pelo menos uma transformao Sada com pelo menos uma porta conectada a
uma outra transformao no mapeamento.

Se um mapplet contiver um qualificador de origem que tenha uma substituio para consulta SQL padro,
voc deve conectar todas as portas do qualificador de origem prxima transformao dentro do
mapplet.

Se o mapplet contm mais de um qualificador de origem, use uma transformao Joiner para a juno da
sada a um pipeline. Se o mapplet contm somente um qualificador de origem, voc deve conectar as
portas de sada a pipelines separados. Voc no pode usar uma transformao Joiner para a juno da
sada.

Ao editar um mapplet, voc pode invalidar mapeamentos se alterar o tipo de mapplet de passivo para
ativo.

Se voc excluir portas no mapplet quando ele for usado em um mapeamento, voc pode invalidar o
mapeamento.

No altere o tipo de dados, a preciso ou a escala de uma porta de mapplet quando este for usado por
um mapeamento.

Se voc usar uma transformao Gerador de Sequncia, ela deve ser reutilizvel.

Se voc usar uma transformao Procedimento Armazenado, deve configurar o Tipo de Procedimento
Armazenado como Normal.

Voc no pode incluir funes LOOKUP no estilo PowerMart 3.5 em um mapplet.

Voc no pode incluir os seguintes objetos em um mapplet:


- Transformaes de normalizadores

Regras e Diretrizes para Mapplets

149

- Origens COBOL
- Transformaes de Qualificador de Origem XML
- Origens XML
- Definies de destino
- Procedimentos armazenados antes e depois da sesso.
- Outros mapplets

Dicas para Mapplets


Insira comentrios para as transformaes Entrada e Sada.
Em mapeamento, possvel exibir os comentrios associados transformao Entrada ou Sada, mantendo
o ponteiro em cima do nome da transformao no mapplet. Voc pode explicar o uso de um mapplet e suas
portas, criando comentrios descritivos ou instrues no campo Descrio das transformaes Entrada e
Sada. E at mesmo incluir links para a documentao da empresa.

Crie uma transformao Sada para cada grupo de sada que voc deseja.
Voc pode passar dados de cada grupo de sada do mapplet para um pipeline de mapeamento diferente.
Crie uma transformao Sada para cada grupo de sada que voc deseja.

Para criar mapplets a partir dos mapeamentos existentes, copie os objetos do mapeamento para o
Mapplet Designer.
Configurar o Gerador de Sequncia para armazenar corretamente em cache.
Voc pode incluir uma transformao Gerador de Sequncia reutilizvel em um mapplet. Se voc usar o
mapplet em vrios mapeamentos e cada um deles despender uma grande quantidade de valores em uma
sesso, talvez seja necessrio configurar o tamanho do cache para o Gerador de Sequncia reutilizvel
limitar a quantidade de valores no usados.

Para manter os mapeamentos vlidos existentes ao editar um mapplet usado em um mapeamento:

150

No exclua as portas conectadas em uma transformao Entrada ou Sada.

No altere os tipos de dados, preciso ou escala das portas conectadas em uma transformao Entrada
ou Sada.

No altere um mapplet passivo para um ativo ou um mapplet ativo para um passivo.

Captulo 7: Mapplets

CAPTULO 8

Parmetros e Variveis de
Mapeamento
Este captulo inclui os seguintes tpicos:

Viso geral de Parmetros e Variveis de Mapeamento, 151

Parmetros de mapeamento, 155

Variveis de Mapeamento, 158

Definindo Strings de Expresses em Arquivos de Parmetros, 163

Dicas para Parmetros e Variveis de Mapeamento, 164

Soluo de Problemas de Parmetros e Variveis de Mapeamento, 165

Viso geral de Parmetros e Variveis de


Mapeamento
No Designer, use parmetros e variveis de mapeamento para tornar os mapeamentos mais flexveis.
Parmetros e variveis de mapeamento representam valores em mapeamentos e mapplets. Se voc
declarar os parmetros e variveis em um mapeamento, pode reutilizar um mapeamento alterando o
parmetro e valores variveis do mapeamento na sesso. Isto pode reduzir a sobrecarga da criao de
mltiplos mapeamentos quando somente certos atributos precisam ser alterados.
Quando voc usa um parmetro ou varivel em um mapeamento, primeiro deve declar-lo para o uso em
cada mapplet ou mapeamento. Em seguida, voc define um valor para o parmetro ou varivel de
mapeamento antes de executar a sesso.
Use parmetros e variveis em um mapeamento para extrair os dados de maneira incremental. Use
parmetros ou variveis de mapeamento no filtro de origem de uma transformao Qualificador de Origem
para determinar o carimbo de data e hora inicial e final, a fim de extrair os dados de maneira incremental.
Por exemplo, voc pode criar uma varivel de mapeamento definida pelo usurio $$LastUpdateDateTime
que salva o carimbo de data e hora da ltima linha que o Servio de Integrao leu na sesso prvia. Use $
$LastUpdateDateTime para o carimbo de data e hora inicial e a varivel incorporada $$$SessStartTime para
o carimbo final no filtro de origem. Use o seguinte filtro para extrair os dados de maneira incremental, com
base na coluna SALES.sales_datetime na origem:
SALES.sales_datetime > TO_DATE ($$LastUpdateDateTime) AND SALES.sales_datetime <
TO_DATE ($$$SessStartTime)

151

Parmetros de mapeamento
Um parmetro de mapeamento representa um valor constante que voc pode definir antes de executar uma
sesso. Um parmetro de mapeamento retm o mesmo valor durante toda a sesso.
Ao usar um parmetro de mapeamento, voc declara e usa o parmetro em um mapeamento ou mapplet.
Ento defina o valor do parmetro em um arquivo de parmetro. O Servio de Integrao avalia todas as
referncias ao parmetro para aquele valor.
Por exemplo, voc deseja usar a mesma sesso para extrair os registros de transao de cada cliente,
individualmente. Em vez de criar um mapeamento separado de cada conta de cliente, voc pode criar um
parmetro de mapeamento para representar uma nica conta de cliente. Use ento o parmetro em um filtro
de origem para extrair somente os dados dessa conta de cliente. Antes de executar a sesso, digite o valor
do parmetro no arquivo de parmetro.
Para reutilizar o mesmo mapeamento, a fim de extrair os registros de outras contas de clientes, voc pode
digitar um novo valor para o arquivo de parmetro e executar a sesso. Ou, voc pode excluir um arquivo de
parmetro para cada conta de cliente e iniciar a sesso com um arquivo de parmetro diferente toda vez que
usar pmcmd. Usando um arquivo de parmetro, voc reduz a sobrecarga de criar vrios mapeamentos e
sesses para extrair registros de transaes em diferentes contas de clientes.
Quando voc quiser usar o mesmo valor de um parmetro de mapeamento toda vez que executar a sesso,
use o mesmo arquivo de parmetro em cada execuo de sesso. Quando voc quiser alterar o valor de um
parmetro de mapeamento entre sesses, execute uma das tarefas a seguir:

Atualize o arquivo de parmetro entre as sesses.

Crie um arquivo de parmetro diferente e configure a sesso para usar o novo arquivo.

Remova o arquivo de parmetro das propriedades da sesso. O Servio de Integrao usa o valor de
parmetro na atribuio de varivel antes da sesso. Se no houver nenhuma atribuio de varivel
antes da sesso, o Servio de Integrao usa o valor inicial configurado do parmetro no mapeamento.

Variveis de Mapeamento
Ao contrrio de um parmetro de mapeamento, uma varivel de mapeamento representa um valor que pode
se alterar durante a sesso. O Servio de Integrao salva o valor de uma varivel de mapeamento no
repositrio ao final de cada execuo de sesso com xito e usa o valor na prxima vez que voc executar a
sesso.
Ao usar uma varivel de mapeamento, voc declara a varivel no mapeamento ou mapplet, e usa uma
funo de varivel no mapeamento para alterar o valor da varivel. No incio de uma sesso, o Servio de
Integrao avalia as referncias em uma varivel para determinar o valor inicial. No final de uma sesso
bem-sucedida, o Servio de Integrao salva o valor final da varivel no repositrio. Da prxima vez que
voc executar a sesso, o Servio de Integrao avalia as referncias varivel para o valor salvo. Para
substituir o valor salvo, defina o valor inicial da varivel em um arquivo de parmetro ou atribua um valor na
atribuio de varivel antes da sesso nas propriedades da sesso.
Use variveis de mapeamento para realizar leituras incrementais de uma origem. Por exemplo, as contas de
clientes no exemplo de parmetro de mapeamento acima esto numeradas de 001 a 065, incrementadas em
uma unidade. Em vez de criar um parmetro de mapeamento, voc pode criar uma varivel de mapeamento
com um valor inicial de 001. No mapeamento, use uma funo de varivel para aumentar o valor de varivel
em uma unidade. A primeira vez que o Servio de Integrao executa a sesso, ele extrai os registros da
conta de cliente 001. Ao trmino da sesso, ele incrementa a varivel em uma unidade e salva esse valor no
repositrio. A primeira vez que o Servio de Integrao executa a sesso, ele extrai os dados da prxima
conta de cliente 002. Ele tambm incrementa o valor de varivel para que na prxima sesso extraia e
pesquise os dados da conta de cliente 003.

152

Captulo 8: Parmetros e Variveis de Mapeamento

Uso de Parmetros e Variveis de Mapeamento


Voc pode criar parmetros e variveis de mapeamento no Mapping Designer ou Mapplet Designer. Uma
vez criados, os parmetros e variveis de mapeamento aparecem na guia de Variveis do Editor de
Expresso. Use-os em qualquer expresso no mapplet ou mapeamento. O Designer valida parmetros e
variveis de mapeamento no Editor de Expresso de mapplets e mapeamento.
Use parmetros e variveis de mapeamento em um qualificador de origem em um mapplet ou mapeamento.
Quando voc usa parmetros e variveis de mapeamento em uma transformao Qualificador de Origem, o
Designer os expande antes de transferir a consulta para o banco de dados de origem para validao. Isto
permite que o banco de dados de origem valide a consulta.
Quando voc criar uma transformao reutilizvel no Transformation Developer, use qualquer parmetro ou
varivel de mapeamento. Uma vez que uma transformao reutilizvel no est contida dentro de qualquer
mapplet ou mapeamento, o Designer valida o uso de qualquer parmetro ou varivel de mapeamento nas
expresses de transformao reutilizvel. Quando voc usa a transformao reutilizvel em um mapplet ou
mapeamento, o Designer valida a expresso novamente. Se o parmetro ou varivel no for definido no
mapplet ou mapeamento, ou for usado incorretamente na transformao reutilizvel, o Designer registra um
erro quando voc valida o mapplet ou mapeamento.
Quando o Designer valida uma varivel de mapeamento em uma transformao reutilizvel, ele trata a
varivel como um tipo de dados Inteiro.
Voc no pode usar parmetros e variveis de mapeamento de maneira intercambivel entre um mapplet e
um mapeamento. Parmetros e variveis de mapeamento declarados para um mapeamento no podem ser
usados dentro de um mapplet. Da mesma forma, voc no pode usar um parmetro ou varivel de
mapeamento declarado para um mapplet em um mapeamento.

Valores Iniciais e Padro


Ao declarar um parmetro de mapeamento ou varivel em um mapeamento ou mapplet, possvel digitar
um valor inicial. O Servio de Integrao usa o valor inicial configurado para um parmetro de mapeamento,
quando o parmetro no estiver definido no arquivo de parmetro. Semelhantemente, o Servio de
Integrao usa o valor inicial configurado de uma varivel de mapeamento quando o valor de varivel no
estiver definido no arquivo de parmetro, e no houver nenhum valor de varivel salvo no repositrio.
Quando o Servio de Integrao precisa de um valor inicial, e voc no o declarou para o parmetro ou
varivel, o Servio de Integrao usa um valor padro com base no tipo de dados do parmetro ou da
varivel.
A tabela a seguir lista os valores padro que o Servio de Integrao usa para os diferentes tipos de dados:
Dados

Valor Padro

String

String vazia.

Numrico

Datetime

1/1/1753 d.C. ou 1/1/1 quando o Servio de Integrao configurado para compatibilidade com a
verso 4.0.

Por exemplo, voc cria um novo mapeamento usando uma varivel de mapeamento de Nmero inteiro, $
$MiscellaneousExpenses. No configura um valor inicial para a varivel nem define-o em um arquivo de
parmetro. A primeira vez que voc executa uma sesso com o mapeamento, o Servio de Integrao usa o
valor padro para tipos de dados numricos, 0.

Viso geral de Parmetros e Variveis de Mapeamento

153

Ou, se voc criar um parmetro de mapeamento $$MiscellaneousCosts para representar despesas


adicionais que poderiam se tornar importantes no futuro, mas que no existem atualmente nos dados de
origem. Configure o parmetro de um tipo de dados Decimal. Como voc deseja que $$MiscellaneousCosts
avalie como 0 quando voc no tiver despesas adicionais, defina o valor inicial para 0.
Enquanto voc no definir o valor de parmetro no arquivo de parmetro, o Servio de Integrao substitui $
$MiscellaneousCosts por 0. Quando voc desejar incluir despesas diversas nos clculos do mapeamento,
defina $$MiscellaneousCosts para esse valor no arquivo de parmetro.

Usando Parmetros e Variveis de String


Quando inserir variveis e parmetros de mapeamento do tipo de dados de uma string em uma
transformao Qualificador de Origem, use um identificador de string apropriado para o banco de dados de
origem. Quando o Servio de Integrao expande um parmetro ou uma varivel em uma transformao
Qualificador de Origem, o Servio de Integrao substitui esse elemento pelo seu valor inicial e, em seguida,
transmite a consulta expandida para o banco de dados de origem. A maioria dos bancos de dados exige que
os valores de cada string estejam entre aspas simples (').
Quando voc inserir variveis ou parmetros de string usando a linguagem de transformao do
PowerCenter, no use aspas adicionais. O Servio de Integrao reconhece uma sintaxe de nomenclatura
de varivel e de parmetro de mapeamento na linguagem de transformao do PowerCenter. Por exemplo,
voc pode usar o parmetro $$State no filtro para que a transformao Qualificador de Origem extraia linhas
para um estado especfico:
STATE = $$State
Durante a sesso, o Servio de Integrao substitui o parmetro pela string. Se $$State estiver definido
como MD no arquivo do parmetro, o Servio de Integrao substituir o parmetro da seguinte forma:
STATE = MD
Voc pode executar um filtro semelhante na transformao Filtro usando a linguagem de transformao do
PowerCenter da seguinte forma:
STATE = $$State
Se o parmetro estiver entre aspas simples na transformao Filtro, ele ser lido pelo Servio de Integrao
como a string literal "$$State" em vez de substituir o parmetro por "MD".

Usando Parmetros e Variveis de Data e Hora


Quando voc inclui um parmetro ou varivel data e hora na transformao Qualificador de origem,
necessrio alterar o formato da data para o formato usado na origem.

154

Captulo 8: Parmetros e Variveis de Mapeamento

Amenizao da Pgina de Cdigo


Voc pode configurar o Servio de Integrao para liberar a validao da pgina de cdigo ao executar o
Servio de Integrao no modo de movimento de dados Unicode. Mas voc poderia obter resultados
inesperados nas seguintes situaes:

O valor da varivel de mapeamento que o Servio de Integrao salva no repositrio no compatvel


com a pgina de cdigo do repositrio.
Por exemplo, o repositrio usa a pgina de cdigo Latin-1 ISO 8859-1 e voc configura o Servio de
Integrao para liberar a validao da pgina de cdigo. Se o valor da varivel de mapeamento contm
dados de caractere japons, como JapanEUC, o valor da varivel de mapeamento salvo no repositrio
poderia estar incorreto. Poderia haver perda de dados na converso da pgina de cdigo JapanEUC para
a pgina de cdigo Latin-1. Verifique se o valor da varivel de mapeamento bidirecionalmente
compatvel com a pgina de cdigo do repositrio.
Para garantir que o Servio de Integrao possa gravar todos os metadados no repositrio, use
caracteres ASCII de 7 bits em todos os metadados do repositrio ou use UTF-16LE para o repositrio.

O arquivo de parmetros contm caracteres que no so compatveis com a pgina de cdigo do Servio
de Integrao.
O Servio de Integrao interpreta os dados no arquivo de parmetro usando a pgina de cdigo do
Servio de Integrao. Por exemplo, o Servio de Integrao usa a pgina de cdigo Latin1 ISO 8859-1 e
voc configura o Servio de Integrao para liberar a validao da pgina de cdigo. Se voc criar um
arquivo de parmetro e usar dados de caractere Grego, como o ISO 8859-7, o valor que o Servio de
Integrao l no arquivo poderia estar incorreto. Pode haver perda de dados na converso da pgina de
cdigo ISO 8859-7 para a pgina de cdigo Latin1. Verifique se os caracteres no arquivo de parmetro
so um subconjunto da pgina de cdigo do Servio de Integrao.

Parmetros de mapeamento
No Designer, voc pode criar um parmetro de mapeamento em um mapplet ou mapeamento. Depois de
criar uma varivel de mapeamento, ela exibida no Editor de Expresso. Voc pode usar o parmetro em
qualquer expresso no mapplet ou mapeamento. Tambm possvel usar parmetros em um filtro
qualificador de origem, em uma juno definida pelo usurio ou uma substituio de extrao e no Editor de
Expresso de transformaes reutilizveis.
Antes de executar uma sesso, defina o valor do parmetro de mapeamento em um arquivo de parmetro
para a sesso. Use qualquer valor constante. Durante a sesso, o Servio de Integrao avalia todas as
referncias ao parmetro para o valor especificado. Se o parmetro no for definido no arquivo de
parmetros, o Servio de Integrao usa o valor inicial definido pelo usurio para o parmetro. Se o valor
inicial no for definido, o Servio de Integrao usa um valor padro com base no tipo de dados do
parmetro de mapeamento.
Voc pode alterar o valor de um parmetro de mapeamento entre sesses, editando o arquivo de parmetro
ou alterando o arquivo de parmetro usado pela sesso.
Voc pode usar um parmetro de mapeamento em vez de uma pesquisa de banco de dados. Por exemplo,
voc deseja realizar clculos usando a receita bruta mensal. Em vez de usar uma transformao Pesquisa
para se conectar tabela de banco de dados daquela informao, voc pode criar um parmetro de
mapeamento de receita bruta e atualizar seu valor no arquivo de parmetros de cada ms para refletir a
receita atual.
Voc tambm pode usar um parmetro de mapeamento em conjunto com um parmetro de sesso para
reutilizar um mapeamento e sesso. Por exemplo, voc possui dados transacionais de estados diferentes

Parmetros de mapeamento

155

armazenados na mesma tabela em bancos de dados distintos, e deseja realizar os mesmos clculos em
todos os dados, ao mesmo tempo que altera o imposto sobre as vendas estaduais pelo mesmo critrio. Em
vez de criar um mapeamento e sesso distintos para cada estado, voc cria um mapeamento com um
parmetro de mapeamento de imposto sobre venda e uma sesso usando um parmetro de sesso de
conexo de banco de dados de origem. Voc pode ento criar um arquivo de parmetro diferente para cada
estado. Antes de executar a sesso, voc pode alterar o arquivo de parmetro que o Servio de Integrao
usa, digitando um nome de arquivo de parmetro diferente de pmcmd ou editando a sesso no Workflow
Manager.
Para usar um parmetro de mapeamento, execute as etapas a seguir:
1.

Crie um parmetro de mapeamento.

2.

Use o parmetro de mapeamento.

3.

Defina o valor de parmetro.

Etapa 1. Criar um Parmetro de Mapeamento


possvel criar parmetros de mapeamento para qualquer mapeamento ou mapplet. Voc pode declarar
tantos parmetros de mapeamento quantos precisar. Uma vez declarado, use o parmetro no mapeamento
ou mapplet.
Para criar um parmetro de mapeamento:
1.

No Mapping Designer, clique em Mapeamento > Parmetros e Variveis. Ou, no Mapplet Designer,
clique em Mapplet > Parmetros e Variveis.

2.

Clique no boto Adicionar.

3.

Insira as seguintes informaes e clique em OK:


Campo

Descrio

Nome

Nome do parmetro. Parmetros de nome $$ParameterName. A sintaxe do nome


do parmetro deve ser $$ seguida por qualquer caractere alfanumrico ou
sublinhado.

Tipo

Varivel ou parmetro. Selecione Parmetro.

Tipo de dados

Tipo de dados do parmetro. Selecione um tipo de dados de transformao vlido.


Use qualquer tipo de dados, exceto Binrio ou Bruto.

Preciso ou escala

Preciso e escala do parmetro.

Agregao

Use para variveis.

IsExprVar

Determina como o Servio de Integrao expande o parmetro em uma string de


expresso. Se for verdadeiro, o Servio de Integrao expande o parmetro antes
de analisar a expresso. Se for falso, o Servio de Integrao expande o parmetro
depois de analisar a expresso. O padro FALSE.
Nota: Se voc configurar esse campo como verdadeiro, dever configurar o tipo de
dados do parmetro para String ou o Servio de Integrao provocar a falha da
sesso.

156

Captulo 8: Parmetros e Variveis de Mapeamento

Campo

Descrio

Valor inicial

Valor inicial do parmetro. Se voc no configurar um valor para o parmetro no


respectivo arquivo, o Servio de Integrao usa este valor para o parmetro durante
sesses. Se este valor tambm for indefinido, o Servio de Integrao usa um valor
padro com base no tipo de dados da varivel de mapeamento.
Use um dos seguintes formatos para os valores iniciais dos parmetros de Data e
Hora:
- MM/DD/RR
- MM/DD/RR HH24:MI:SS
- MM/DD/AAAA
- MM/DD/YYYY HH24:MI:SS.US

Descrio

Descrio associada ao parmetro.

Etapa 2. Usar um Parmetro de Mapeamento


Depois de criar um parmetro, use-o no Editor de Expresso de qualquer transformao em um
mapeamento ou mapplet. Voc tambm pode us-lo nas transformaes Qualificador de origem e nas
transformaes reutilizveis.
Em uma transformao Qualificador de origem, os parmetros de mapeamento so exibidos na guia
Variveis no Editor de SQL. Ao usar os parmetros de mapeamento em uma transformao Qualificador de
origem, use as regras e diretrizes a seguir:

Insira os parmetros de string nos identificadores de string adequados ao sistema de origem.

Se necessrio, altere o formato do parmetro data e hora para corresponder ao formato na origem.

Voc tambm pode usar os parmetros de mapeamento no Editor de Expresso. Ao usar os parmetros de
mapeamento no Editor de Expresso, no insira os parmetros de string nos identificadores de string. O
Servio de Integrao manipula os parmetros como qualquer outro identificador de porta.
Use os parmetros de mapeamento em transformaes reutilizveis.
Voc tambm pode usar parmetros de mapeamento nas substituies de transformao nas propriedades
da sesso do Workflow Manager. possvel substituir as propriedades, como um filtro ou juno definida
pelo usurio, em uma transformao Qualificador de origem.

Etapa 3. Definir um Valor de Parmetro


Antes de executar uma sesso, defina os valores dos parmetros de mapeamento no arquivo de parmetro.
Quando voc no define um parmetro no arquivo de parmetro, o Servio de Integrao obtm o valor de
parmetro de um outro lugar. O Servio de Integrao procura pelo valor na seguinte ordem:
1.

Valor em arquivo de parmetro

2.

Valor na atribuio de variveis da sesso anterior

3.

Valor inicial salvo no repositrio

4.

Valor padro do tipo de dados

Parmetros de mapeamento

157

Variveis de Mapeamento
No Designer, voc pode criar variveis de mapeamento em um mapeamento ou mapplet. Depois de criar
uma varivel de mapeamento, ela exibida no Editor de Expresso. Voc pode us-la em qualquer
expresso no mapeamento ou mapplet. As variveis de mapeamento tambm podem ser usadas em um
filtro qualificador de origem, em uma juno definida pelo usurio ou substituio de extrao e no Editor de
Expresso de transformaes reutilizveis.
Ao contrrio dos parmetros de mapeamento, as variveis de mapeamento so valores que podem alterar
entre sesses. O Servio de Integrao salva o ltimo valor de uma varivel de mapeamento no repositrio
ao trmino de cada sesso bem-sucedida. Durante a execuo da prxima sesso, ele avalia todas as
referncias ao valor salvo em relao varivel de mapeamento. Voc pode substituir um valor salvo por um
arquivo de parmetro. E tambm limpar todos os valores salvos da sesso no Workflow Manager.
Voc poderia usar uma varivel de mapeamento para executar uma leitura incremental da origem. Por
exemplo, voc tem uma tabela de origem que contm transaes com carimbo de data/hora e deseja avaliar
as transaes dirias. Em vez de digitar manualmente uma substituio de sesso para filtrar os dados de
origem toda vez que for executar a sesso, voc pode criar uma varivel de mapeamento $
$IncludeDateTime. No qualificador de origem, crie um filtro para ler apenas as linhas cuja data de transao
seja igual a $$IncludeDateTime, como:
TIMESTAMP = $$IncludeDateTime
No mapeamento, use uma funo de varivel para definir o valor de varivel para incrementar um dia, toda
vez que executar a sesso. Se voc definir o valor inicial de $$IncludeDateTime para 8/1/2004, a primeira
vez que o Servio de Integrao executar a sesso ele ler apenas as linhas com data de 8/1/2004. Durante
a sesso, o Servio de Integrao define $$IncludeDateTime para 8/2/2004. Ao trmino da sesso, ele salva
8/2/2004. Da prxima vez que ele executar a sesso, ler apenas as linhas a partir de 2 de agosto de 2004.

Valores de Variveis
O Servio de Integrao possui dois valores diferentes para uma varivel de mapeamento durante a
execuo de uma sesso:

Valor inicial de uma varivel de mapeamento

Valor atual de uma varivel de mapeamento

O valor atual de uma varivel de mapeamento altera de acordo com o avano da sesso. Para usar o valor
atual de uma varivel de mapeamento no mapeamento ou em outra transformao, crie a seguinte
expresso com a funo SETVARIABLE:
SETVARIABLE($$MAPVAR,NULL)
No final de uma sesso bem-sucedida, o Servio de Integrao salva o valor final da varivel no repositrio.

Valor Inicial
O valor inicial o valor da varivel no incio da sesso. O valor de incio pode ser um valor definido no
arquivo de parmetro da varivel, um valor atribudo na atribuio de varivel da pr-sesso, um valor salvo
no repositrio da sesso executada anteriormente, um valor inicial definido pelo usurio para a varivel ou o
valor padro baseado no tipo de dados da varivel. O Servio de Integrao procura pelo valor inicial na
seguinte ordem:

158

1.

Valor em arquivo de parmetro

2.

Valor na atribuio de variveis da sesso anterior

3.

Valor salvo no repositrio

Captulo 8: Parmetros e Variveis de Mapeamento

4.

Valor inicial

5.

Valor padro do tipo de dados

Por exemplo, voc cria uma varivel de mapeamento em um mapeamento ou mapplet e insere um valor
inicial, mas no define um valor para a varivel em um arquivo de parmetro. A primeira vez que o Servio
de Integrao executar a sesso, ele avalia o valor inicial da varivel para o valor inicial configurado. Na
prxima vez que a sesso for executada, o Servio de Integrao avaliar o valor inicial da varivel como o
valor salvo no repositrio. Se voc quiser substituir o valor salvo no repositrio antes de executar uma
sesso, precisar definir um valor para a varivel em um arquivo de parmetro. Quando voc define uma
varivel de mapeamento no arquivo de parmetro, o Servio de Integrao usa esse valor em vez do valor
salvo no repositrio ou o valor inicial configurado para a varivel. Quando voc usa uma varivel de
mapeamento ('$$MAPVAR') em uma expresso, a expresso sempre retorna o valor inicial da varivel de
mapeamento. Se o valor inicial de MAPVAR for 0, $$MAPVAR retornar 0.

Valor Atual
O valor atual o valor da varivel medida que a sesso avana. Quando uma sesso inicia, o valor atual
de uma varivel o mesmo que o inicial. medida que a sesso se desenvolve, o Servio de Integrao
calcula o valor atual usando uma funo de varivel que voc define para a varivel. Ao contrrio do valor
inicial de uma varivel de mapeamento, o valor atual pode alterar, medida que o Servio de Integrao
avalia o valor atual de uma varivel conforme cada linha passa pelo mapeamento. O ltimo valor atual de
uma varivel salvo no repositrio ao final de uma sesso bem-sucedida. Se a sesso falhar ao concluir, o
Servio de Integrao no atualizar o valor da varivel no repositrio. O Servio de Integrao informa o
valor salvo no repositrio para cada varivel de fluxo de mapeamento no log da sesso.

Tipo de Dados de Varivel e Tipo de Agregao


Quando voc declara uma varivel de mapeamento, preciso configurar o tipo de dados e o tipo de
agregao para a varivel.
O tipo de dados que voc escolher para uma varivel de mapeamento permite que o Servio de Integrao
selecione o valor padro adequado para a varivel de mapeamento. O padro usado como valor inicial de
uma varivel de mapeamento, quando no houver valor definido para uma varivel no arquivo de parmetro,
no repositrio, e se o valor inicial no tiver sido definido pelo usurio.
O Servio de Integrao usa o tipo agregado de uma varivel de mapeamento para determinar o valor final
da varivel atual de mapeamento. Quando voc tem um pipeline com vrias parties, o Servio de
Integrao associa o valor de varivel de cada partio e salva o valor final da varivel atual no repositrio.
Voc pode criar uma varivel com os tipos de agregao a seguir:

Contagem

Mx

Mn

Voc pode configurar uma varivel de mapeamento de um tipo de agregao Contagem quando ela for um
Nmero inteiro ou um Nmero inteiro curto. possvel configurar as variveis de mapeamento de cada tipo
de dados para tipos de agregao Mx ou Mn.
Para manter o valor da varivel consistente em toda a execuo de sesso, o Designer limita as funes de
variveis usadas em uma varivel com base no tipo de agregao. Por exemplo, use a funo
SetMaxVariable para uma varivel com tipo de agregao Mx, mas no em uma varivel com um tipo de
agregao Mn.

Variveis de Mapeamento

159

A tabela a seguir descreve as funes de varivel disponveis e os tipos de agregao e tipos de dados
usados em cada funo:
Funo de Varivel

Tipos de Agregao
Vlidos

Tipo de Dados Vlido

SetVariable

Mx ou Mn

Todas as transformaes de tipos de dados, exceto o tipo


de dados binrio.

SetMaxVariable

Somente Mx

Todas as transformaes de tipos de dados, exceto o tipo


de dados binrio.

SetMinVariable

Somente Mn

Todas as transformaes de tipos de dados, exceto o tipo


de dados binrio.

SetCountVariable

Somente Contagem

Somente tipos de dados de nmero inteiro e nmero inteiro


curto.

Para vrios grupos de ordem de carregamento de destino, o valor da varivel de mapeamento em um grupo
de ordem de carregamento de destino depende do tipo de agregao da varivel e do valor da varivel no
grupo de ordem de carregamento de destino anterior. Aps a execuo de cada grupo de ordem de
carregamento de destino, o Servio de Integrao calcular os valores da varivel de mapeamento a serem
usados no prximo grupo de ordem de carregamento de destino com base no tipo de agregao da varivel.
Por exemplo, uma sesso contm dois grupos de ordem de carregamento de destino. Voc definiu Mx
como o tipo de agregao da varivel de mapeamento.
Quando o primeiro grupo de ordem de carregamento de destino for executado, voc ter definido os
seguintes valores diferentes usando a funo SetVariable para a varivel de mapeamento $$MAPVAR:
1.

SetVariable($$MAPVAR,20)

2.

SetVariable($$MAPVAR,10)

3.

SetVariable($$MAPVAR,60)

4.

SetVariable($$MAPVAR,30)

No fim da primeira execuo do grupo de ordem de carregamento de destino, o Servio de Integrao


calcular o nmero Mx de todos os quatro valores de $$MAPVAR. Como o Mx de quatro valores 60, o
Servio de Integrao usar 60 como o valor inicial da varivel de mapeamento $$MAPVAR no prximo
grupo de ordem de carregamento de destino.

Funes Variveis
Funes variveis determinam como o Servio de Integrao calcula o valor atual de uma varivel de
mapeamento em um pipeline. Use funes variveis em uma expresso para definir o valor de uma varivel
de mapeamento para a prxima sesso executar. A linguagem de transformao oferece as seguintes
funes variveis para usar em um mapeamento:

160

SetMaxVariable. Define a varivel no valor mximo de um grupo de valores. Ignora linhas marcadas para
atualizar, excluir ou rejeitar. Para usar SetMaxVariable com uma varivel de mapeamento, o tipo de
agregao da varivel de mapeamento deve ser definido como Max.

SetMinVariable. Define a varivel no valor mnimo de um grupo de valores. Ignora linhas marcadas para
atualizar, excluir ou rejeitar. Para usar SetMinVariable com uma varivel de mapeamento, o tipo de
agregao da varivel de mapeamento deve ser definido como Mn.

Captulo 8: Parmetros e Variveis de Mapeamento

SetCountVariable. Aumenta o valor da varivel em um. Em outras palavras, adiciona um ao valor da


varivel quando uma linha estiver marcada para insero, e subtrai um quando a linha estiver marcada
para excluso. Ignora linhas marcadas para atualizar ou rejeitar. Para usar SetCountVariable com uma
varivel de mapeamento, o tipo de agregao da varivel de mapeamento deve ser definido como Count.

SetVariable. Define a varivel para o valor configurado. No final de uma sesso, ele compara o valor
atual final da varivel com o valor inicial da varivel. Baseado no tipo de agregao da varivel, ele salva
um valor final no repositrio. Para usar a funo SetVariable com uma varivel de mapeamento, o tipo de
agregao da varivel de mapeamento deve ser definido como Max ou Min. A funo SetVariable ignora
linhas marcadas para excluir ou rejeitar.

Use funes de varivel somente uma vez para cada varivel de mapeamento em uma pipeline. O Servio
de Integrao processa funes variveis medida que as encontra no mapeamento. A ordem em que o
Servio de Integrao encontra funes variveis no mapeamento pode no ser a mesma para cada
execuo de sesso. Isso pode causar resultados inconsistentes quando voc usa a mesma funo varivel
vrias vezes em um mapeamento.
O Servio de Integrao no salvar o valor atual final de uma varivel de mapeamento no repositrio
quando alguma uma das seguintes condies for verdadeira:

A sesso no concluda.

A sesso configurada para uma carga de teste.

A sesso uma sesso de depurao.

A sesso executada em modo de depurao e configurada para descartar a sada da sesso.

Mapeando Variveis em Mapplets


Ao declarar uma varivel de mapeamento de um mapplet e usar o mapplet vrias vezes no mesmo
mapeamento, o mesmo valor de varivel de mapeamento compartilhado por todas as instncias de
mapplet.

Uso de Variveis de Mapeamento


Para usar variveis de mapeamento, execute as etapas a seguir:
1.

Crie uma varivel de mapeamento.

2.

Use a varivel e defina o seu valor.

3.

Substitua ou remova o valor da varivel.

Etapa 1. Criar uma varivel de mapeamento


Voc pode criar uma varivel de mapeamento para qualquer mapeamento ou mapplet. Voc pode criar
tantas variveis quantas precisar. Depois de cri-la, use a varivel no mapeamento ou mapplet.
Para criar uma varivel de mapeamento:
1.

No Mapping Designer, clique em Mapeamento > Parmetros e Variveis. Ou, no Mapplet Designer,
clique em Mapplet > Parmetros e Variveis.

2.

Clique no boto Adicionar.

3.

Especifique as informaes da varivel.

Variveis de Mapeamento

161

A tabela a seguir descreve as opes na caixa de dilogo Declarar Parmetros e Variveis:


Campo

Requerido

Descrio

Opcional
Nome

Obrigatrio

Nome da varivel. Variveis de nome $$VariableName. A sintaxe


do nome da varivel deve ser $$ seguido por qualquer caractere
alfanumrico ou sublinhado.

Tipo

Obrigatrio

Varivel ou parmetro. Selecionar varivel.

Tipo de dados

Obrigatrio

Tipo de dados da varivel. Selecione um tipo de dados de


transformao vlido. Use qualquer tipo de dados, exceto Binrio.
O tipo de dados selecionado pode afetar o tipo de Agregao que
voc pode selecionar. Por exemplo, quando voc cria uma
varivel de String, no pode configur-la com um tipo de
agregao de Contagem.

Preciso ou escala

Obrigatrio

Preciso e escala da varivel.

Agregao

Obrigatrio

Tipo de agregao da varivel. Determina o tipo de clculo que


voc pode executar com a varivel.
- Configure a agregao de Contagem se voc deseja usar a
varivel de mapeamento para contar o nmero de linhas lidas na
origem.
- Configure a agregao para Mx se deseja usar a varivel de
mapeamento para determinar um valor mximo de um grupo de
valores.
- Configure a agregao para Mn se deseja usar a varivel de
mapeamento para determinar um valor mnimo de um grupo de
valores.

IsExprVar

Obrigatrio

Determina como o Servio de Integrao expande a varivel em


uma string de expresso. Se for verdadeiro, o Servio de
Integrao expande a varivel antes de analisar a expresso. Se
for falso, o Servio de Integrao expande a varivel depois de
analisar a expresso. O padro FALSE.
Nota: Se voc configurar este campo como verdadeiro, deve
configurar o tipo de dados da varivel para String ou o Servio de
Integrao provoca a falha da sesso.

Valor inicial

Opcional

Valor inicial da varivel. O Servio de Integrao usa este valor


para a varivel quando o valor da mesma no salvo no
repositrio ou definido no arquivo de parmetro. Se este valor
tambm for indefinido, o Servio de Integrao usa um valor
padro com base no tipo de dados da varivel de mapeamento.
Use um dos seguintes formatos para os valores iniciais nas
variveis de data e hora:
- MM/DD/RR
- MM/DD/RR HH24:MI:SS
- MM/DD/AAAA
- MM/DD/YYYY HH24:MI:SS.US

Descrio
4.

162

Opcional

Clique em OK.

Captulo 8: Parmetros e Variveis de Mapeamento

Descrio associada varivel.

Etapa 2. Configurar o Valor da Varivel do Mapeamento


Depois de declarar uma varivel, voc pode us-la em qualquer expresso no mapeamento ou mapplet.
Tambm possvel usar uma varivel de mapeamento em uma transformao Qualificador de origem ou
transformao reutilizvel.
Em uma transformao de Qualificador de origem, as variveis de mapeamento so exibidas na guia
Variveis no Editor de SQL. Ao usar as variveis de mapeamento em uma transformao Qualificador de
origem, siga as regras abaixo:

Inclua as variveis de string em identificadores de string, como as aspas simples, para indicar que a
varivel uma string.

Se necessrio, altere o formato da varivel data e hora para corresponder ao formato na origem. O
Servio de Integrao converte as datas a partir do formato de data padro do PowerCenter para o
formato de data padro do sistema de origem.

Em outras transformaes em um mapplet ou mapeamento, as variveis de mapeamento so exibidas no


Editor de Expresso. Ao escrever expresses que usam variveis de mapeamento, no h necessidade de
identificadores de string para as variveis de string.
Use as variveis de mapeamento nas transformaes reutilizveis. Ao validar a expresso, o Designer trata
a varivel como um tipo de dados de Nmero inteiro.
Voc tambm pode usar variveis de mapeamento nas substituies de transformao nas propriedades da
sesso. possvel substituir as propriedades, como um filtro ou juno definida pelo usurio, em uma
transformao Qualificador de origem.
Ao usar uma varivel de mapeamento, necessrio determinar como definir o valor da varivel de
mapeamento. Use uma funo varivel para definir um valor varivel. Use uma funo de varivel em
qualquer uma das transformaes a seguir:

Expresso

Filtro

Roteador

Estratgia de Atualizao

Etapa 3. Substituir ou Limpar Valores Salvos


Aps a sesso ser concluda com xito, o Servio de Integrao salva o valor final de cada varivel no
repositrio. Quando no desejar usar esse valor na prxima vez que executar a sesso, voc poder
substituir o valor no arquivo de parmetro ou a atribuio de varivel de pr-sesso nas propriedades da
sesso.
Quando no desejar usar nenhum dos valores de varivel salvos de uma sesso, voc poder remover
todos os valores salvos. possvel remover os valores de variveis de uma sesso usando o Workflow
Manager. Aps remover os valores de variveis do repositrio, o Servio de Integrao executa a sesso
como se fosse a primeira vez.

Definindo Strings de Expresses em Arquivos de


Parmetros
O Servio de Integrao expande os parmetros e variveis de mapeamento ao executar a sesso. Se voc
usar um parmetro ou varivel de mapeamento em uma expresso, o Servio de Integrao expande o

Definindo Strings de Expresses em Arquivos de Parmetros

163

parmetro ou varivel aps analisar a expresso. Voc pode querer que o Servio de Integrao expanda
um parmetro ou varivel antes de ele analisar a expresso quando voc criar expresses para representar
regras comerciais que mudam com frequncia. Defina as expresses em um arquivo de parmetro para que
no seja necessrio alterar os mapeamentos sempre que as regras comerciais forem alteradas.
Por exemplo, voc cria uma expresso que gera um nome de cor baseado em uma string de ID, conforme
segue:
IIF(color=A0587,white)
No ms seguinte, voc modifica a expresso, conforme segue:
IIF(color=A0587,white,IIF(color=A0588,off white))
Em vez de atualizar os mapeamentos que usam essa expresso sempre que a regra comercial alterada,
voc pode definir a expresso em um arquivo de parmetro e atualizar o arquivo quando a expresso for
alterada.
Para definir uma expresso em um arquivo de parmetro, configure o mapeamento e fluxo de trabalho, da
seguinte maneira:
1.

Criar um parmetro ou varivel de mapeamento para armazenar a expresso de nome de cor. Por
exemplo, crie um parmetro de mapeamento, $$ExpColor.

2.

Para o parmetro de mapeamento $$ExpColor, defina a propriedade IsExprVar como verdadeira. Voc
tambm deve definir o tipo de dados do parmetro como String, ou o Servio de Integrao
interromper a sesso.

3.

Na transformao Expresso, defina a porta de sada para a seguinte expresso:

4.

Configure a sesso ou fluxo de trabalho para usar um arquivo de parmetro.

5.

No arquivo de parmetro, defina $$ExpColor como a expresso correta. Por exemplo:

$$ExpColor

$$ExpColor=IIF(color=A0587,white)
Como IsExprVar do parmetro de mapeamento $$ExpColor est definido como verdadeiro, o Servio de
Integrao expande o parmetro antes de analisar a expresso. Linhas com ID de cor A0587 retornam a
string white. Se IsExprVar estiver definido como falso, o Servio de Integrao expande o parmetro aps
analisar a expresso. Portanto, todas as linhas retornam a string "IIF (cor = 'A0587', 'white')."
Quando a expresso de nome de cor for alterada, voc poder atualizar o valor do parmetro de
mapeamento no arquivo de parmetro. Voc no precisa modificar o mapeamento.

Dicas para Parmetros e Variveis de Mapeamento


Insira valores iniciais de parmetros e variveis de mapeamento.
Quando voc conhece o valor padro lgico de um parmetro ou varivel de mapeamento, use-o como o
valor inicial ao criar o parmetro ou a varivel. Isso permite que o Servio de Integrao use o valor padro
em vez de um valor padro baseado no tipo de dados.

Insira parmetros e variveis de string e data e hora entre aspas no Editor SQL.
Quando voc usar um parmetro ou varivel de string em uma transformao Qualificador de Origem, insirao em identificadores de string reconhecidos pelo sistema de origem, como aspas simples.

164

Captulo 8: Parmetros e Variveis de Mapeamento

Salve todos os arquivos de parmetros em um dos diretrios de variveis do processo.


Se voc mantiver todos os arquivos de parmetros em um dos diretrios de variveis do processo, como
$SourceFileDir, use a varivel do processo na folha de propriedades da sesso. Se precisar mover os
arquivos de origem e parmetro em uma data posterior, voc poder atualizar todas as sesses alterando a
varivel do processo para apontar para o novo diretrio.

Crie arquivos de parmetros distintos para conjuntos de parmetros reutilizveis.


Quando planejar alternar entre conjuntos de parmetros de uma sesso, crie um arquivo de parmetro para
cada conjunto de parmetros. Use pmcmd para iniciar a sesso e especificar o nome do arquivo de
parmetro que deseja usar ou edite a sesso para usar outro arquivo de parmetro.

Soluo de Problemas de Parmetros e Variveis de


Mapeamento
Criei uma varivel de mapeamento para um mapeamento, mas toda vez que eu executo a sesso, o
valor da varivel permanece o mesmo.
Talvez voc no tenha includo uma funo de varivel no mapeamento. Para alterar o valor de uma varivel
de sesso em sesso, use uma funo de varivel.
Ou, talvez voc tenha configurado um valor para a varivel no arquivo de parmetro. Quando voc define um
valor para uma varivel de mapeamento no arquivo de parmetro, o Servio de Integrao usa esse valor
para a varivel. Consulte o log de sesso para determinar o valor inicial que o Servio de Integrao usa
para cada varivel.

No arquivo de parmetro, eu configurei valores para os parmetros em um mapplet, mas eles no esto
sendo usados na sesso.
Os valores do parmetro de mapeamento e da varivel em mapplets devem ser precedidos do nome do
mapplet no arquivo de parmetro, a saber:
mappletname.parameter=value
mappletname.variable=value

Eu no consigo encontrar as funes de varivel no Editor de Expresso da transformao Classificao


ou Agregador.
Voc no pode usar funes de varivel na transformao Classificao ou Agregador. Use uma
transformao diferente para funes variveis.

Soluo de Problemas de Parmetros e Variveis de Mapeamento

165

CAPTULO 9

Trabalhando com Funes


Definidas pelo Usurio
Este captulo inclui os seguintes tpicos:

Viso Geral do Trabalho com Funes Definidas pelo Usurio, 166

Criao de Funes Definidas pelo Usurio, 167

Gerenciamento de Funes Definidas pelo Usurio, 168

Criando Expresses com Funes Definidas pelo Usurio, 170

Viso Geral do Trabalho com Funes Definidas


pelo Usurio
As funes definidas pelo usurio estendem a linguagem de transformao do PowerCenter. Voc pode criar
e gerenciar funes definidas pelo usurio com a linguagem de transformao do PowerCenter no Designer.
Elas podem ser adicionadas a expresses no Designer ou no Workflow Manager para reutilizar a lgica da
expresso e criar expresses complexas. As funes definidas pelo usurio esto disponveis para outros
usurios no repositrio.

Exemplo
Voc quer remover espaos esquerda e direita de sobrenomes. Voc pode criar uma funo definida
pelo usurio chamada RemoveSpaces para executar as funes LTRIM e RTRIM. Ao inserir a funo
definida pelo usurio, voc insere a seguinte expresso:
LTRIM( RTRIM( name))
Aps criar a funo, voc pode criar a seguinte expresso em uma transformao Expresso para remover
espaos esquerda e direita de sobrenomes:
:UDF.REMOVESPACES(LAST_NAME)
O nome da funo definida pelo usurio precedida por :UDF. O nome da porta LAST_NAME. o
argumento da expresso.

166

Criao de Funes Definidas pelo Usurio


Voc cria funes definidas pelo usurio no Designer.
A tabela a seguir mostra as propriedades que voc configura ao criar uma funo definida pelo usurio:
Propriedade

Descrio

Nome

Nome da funo. O nome deve comear com uma letra e pode conter letras, nmeros e os
seguintes caracteres especiais:
_@$#
O nome no pode exceder 80 caracteres e no pode conter espaos.

Tipo

Pblica se a funo puder ser chamada de qualquer expresso. Particular se a funo s puder
ser chamada de outra funo definida pelo usurio.

Descrio

Descrio da funo.

Tipo de
Retorno

Tipo de dados dos valores que a funo retorna. O Designer determina o tipo de dados quando
voc cria uma funo vlida.

Argumentos

Argumentos que voc deseja incluir na funo. Especifique nome do argumento, tipo de dados
da transformao, preciso e escala para determinar tipo de dados, preciso e escala dos
valores de entrada da funo.

Expresso

Expresso que define a funo. Configure a sintaxe no Editor de Expresso. Usar os


argumentos que voc configurou para a funo. Tambm possvel usar funes de linguagem
da transformao, funes personalizadas ou outras funes definidas pelo usurio. Seguir as
regras e diretrizes de linguagem de transformao PowerCenter.
Nota: Se voc inserir a sintaxe na janela Expresso, valide a funo a partir do menu
Ferramentas.

Configurao do Tipo de Funo


Voc pode colocar as funes definidas pelo usurio em outras funes definidas pelo usurio. Tambm
possvel configurar uma funo definida pelo usurio para ser chamada (callable) a partir das expresses.
Callable significa que voc pode colocar funes definidas pelo usurio em uma expresso.
Selecione uma das opes a seguir ao configurar uma funo definida pelo usurio:

Pblica. Chamada (callable) de qualquer funo definida pelo usurio, expresso de transformao,
expresso de condio de vnculo ou expresso de tarefa.

Privada. Chamada de uma outra funo definida pelo usurio. Crie uma funo privada quando quiser
que a funo faa parte de uma funo mais complexa. Pode ser que a funo simples no seja
utilizvel, independentemente da funo complexa.

Depois de criar uma funo pblica definida pelo usurio, voc no pode alterar o tipo de funo para
privada.
Embora a funo definida pelo usurio possa ser colocada em uma outra funo definida pelo usurio, uma
funo no pode se referir a ela mesma. Por exemplo, a funo definida pelo usurio RemoveSpaces inclui
uma funo definida pelo usurio TrimLeadingandTrailingSpaces. TrimLeadingandTrailingSpaces no pode
incluir RemoveSpaces. Do contrrio, RemoveSpaces invlida.

Criao de Funes Definidas pelo Usurio

167

Configurao de Funes Pblicas que Contm Funes Privadas


Quando voc inclui portas como argumentos em uma funo privada definida pelo usurio, tambm deve
incluir as portas como argumentos em qualquer funo pblica que contenha a funo privada. Use o
mesmo tipo de dados e preciso para os argumentos na funo privada e na pblica.
Por exemplo, voc define uma funo para modificar as IDs de pedido, a fim de incluir 'INFA' e a ID do
cliente. Voc cria primeiro a seguinte funo privada chamada ConcatCust que concatena 'INFA' com a porta
CUST_ID:
CONCAT (INFA, CUST_ID)
Depois de criar a funo privada, voc cria uma funo pblica chamada ConcatOrder que contm
ConcatCust:
CONCAT (:UDF.CONCATCUST( CUST_ID), ORDER_ID)
Quando voc adiciona ConcatCust a ConcatOrder, adiciona o argumento CUST_ID com o mesmo tipo de
dados e preciso funo pblica.
Nota: Se voc inserir uma funo definida pelo usurio quando definir manualmente a sintaxe da funo
pblica, deve usar :UDF como prefixo da funo.

Etapas para Criar uma Funo Definida pelo Usurio


Use o procedimento a seguir para criar uma funo definida pelo usurio.
Para criar uma funo definida pelo usurio:
1.

Clique em Ferramentas > Funes Definidas pelo Usurio > Novo.


A caixa de dilogo Editar Funo Definida pelo Usurio aparece.

2.

Digite um nome de funo.

3.

Selecionar um tipo de funo.

4.

Ou ento, insira uma descrio da funo definida pelo usurio.


Voc pode inserir at 2.000 caracteres.

5.

Crie argumentos para a funo definida pelo usurio.


Quando voc cria argumentos, configure o nome do argumento, o tipo de dados da transformao, a
preciso e a escala.

6.

Clique em Inicializar Editor para criar uma expresso que contm os argumentos voc definiu na etapa
5.

7.

Clique em OK.
O Designer atribui o tipo de dados que a expresso retorna.

8.

Clique em OK.

Gerenciamento de Funes Definidas pelo Usurio


Voc pode executar as tarefas a seguir para gerenciar funes definidas pelo usurio:

168

Edite uma funo definida pelo usurio.

Valide uma funo definida pelo usurio.

Exiba as propriedades de uma funo definida pelo usurio.

Captulo 9: Trabalhando com Funes Definidas pelo Usurio

Exiba as dependncias das funes definidas pelo usurio.

Exporte uma funo definida pelo usurio.

Gerencie uma nova verso de uma funo definida pelo usurio.

A tabela a seguir descreve as tarefas e listas de gerenciamento das funes definidas pelo usurio, onde
voc pode executar cada tarefa:
Tarefa.

rea para executar a tarefa

Editar uma funo definida pelo


usurio

- Clique em Ferramentas > Funes Definidas pelo Usurio.


- Clique com o boto direito do mouse em uma funo definida pelo usurio.

Valide uma funo definida pelo


usurio

- Clique em Ferramentas > Funes Definidas pelo Usurio.


- Clique com o boto direito do mouse em uma funo definida pelo usurio no
Navegador, na janela Resultados da consulta ou na janela Exibir histrico.

Exclua uma funo definida pelo


usurio

- Clique em Ferramentas > Funes Definidas pelo Usurio.

Exibir propriedades de uma


funo definida pelo usurio

- Clique em Ferramentas > Funes Definidas pelo Usurio.


- Clique com o boto direito do mouse em uma funo definida pelo usurio.

Exibir dependncias de funes


definidas pelo usurio

- Clique em Ferramentas > Funes Definidas pelo Usurio.


- Clique com o boto direito do mouse em uma funo definida pelo usurio.

Exporte uma funo definida


pelo usurio

- Clique em Ferramentas > Funes Definidas pelo Usurio.


- Clique com o boto direito do mouse em uma funo definida pelo usurio.

Gerenciar controle de verso da


funo definida pelo usurio

- Clique em Ferramentas > Funes Definidas pelo Usurio.


- Clique com o boto direito do mouse em uma funo definida pelo usurio.

Edio de Funes Definidas pelo Usurio


Voc pode editar uma funo definida pelo usurio para alterar as propriedades da funo. As alteraes se
propagam a todas as funes definidas pelo usurio e as expresses que a utilizam.
Use as seguintes regras e diretrizes ao editar uma funo definida pelo usurio:

Se voc alterar o nome da funo definida pelo usurio, o Designer no propaga a alterao do nome
para as expresses dentro do objeto. Mapeamentos e fluxos de trabalho que usam uma expresso com a
funo definida pelo usurio podem ser invlidos.

Se voc alterar a expresso de uma funo definida pelo usurio, o Designer pode alterar o tipo de dados
dos valores que a funo retorna quando usada em uma expresso.

Voc no pode alterar uma funo definida pelo usurio de pblica para privada.

Se uma funo definida pelo usurio for invlida, os mapeamentos e fluxos de trabalho que a utilizam
tambm podem ser invlidos. Validar os mapeamentos ou fluxos de trabalho.

Excluso de Funes Definidas pelo Usurio


Quando voc exclui uma funo definida pelo usurio, o Servio de Repositrio a exclui de outras funes e
expresses definidas pelo usurio que a utilizam. Como resultado, estas funes e expresses definidas
pelo usurio podem ser invlidas. Mapeamentos e fluxos de trabalho que usam a funo definida pelo
usurio, ou uma expresso com esse tipo de funo, tambm podem ser invlidos. Validar os mapeamentos
ou fluxos de trabalho.

Gerenciamento de Funes Definidas pelo Usurio

169

Exportao de Funes Definidas pelo Usurio


Voc pode exportar uma funo definida pelo usurio para XML. E depois import-la para outros repositrios
ou pastas de repositrio.
O cliente PowerCenter exporta a funo definida pelo usurio, se voc exportar um mapeamento ou fluxo de
trabalho com essa funo.

Validao de Funes Definidas pelo Usurio


Voc pode validar uma funo definida pelo usurio das seguintes reas:

Editor de Expresso, quando voc cria ou edita uma funo definida pelo usurio

menu Ferramentas

janela Consultar Resultados

janela Exibir Histrico

Ao validar uma funo definida pelo usurio, o Cliente do PowerCenter no valida outras funes e
expresses definidas pelo usurio que usam a funo. Se uma funo definida pelo usurio for invlida, toda
funo e expresso definida pelo usurio que usa essa funo tambm ser invlida. De forma semelhante,
mapeamentos e fluxos de trabalho que usam a funo definida pelo usurio so invlidos.

Cpia e Implantao de Funes Definidas pelo Usurio


Quando voc copia um objeto que contm uma funo definida pelo usurio, o Assistente de Cpia tambm
copia a funo definida pelo usurio:
Quando voc implanta um grupo de implantao esttica que contm funes definidas pelo usurio, o
Assistente de Cpia tambm copia as funes. Quando voc implanta um grupo de implantao dinmica
que contm funes definidas pelo usurio, o Assistente de Cpia no implanta as funes que no esto
includas em uma expresso.

Criando Expresses com Funes Definidas pelo


Usurio
Voc pode adicionar uma funo definida pelo usurio a uma expresso. Se voc inserir uma funo
definida pelo usurio ao criar manualmente uma expresso, ser necessrio usar um prefixo com :UDF para
a funo definida pelo usurio. Quando voc cria uma expresso com o Editor de Expresso, as funes
vlidas definidas pelo usurio so exibidas na guia Funes definidas pelo usurio. Use funes definidas
pelo usurio como faria com qualquer outra funo.
Se voc criar uma funo definida pelo usurio, que s utilizvel no Designer, ela s exibida no
Designer.
Quando voc seleciona uma funo definida pelo usurio, o Editor de Expresso mostra a sintaxe de funo
no seguinte formato:
<return datatype> <function name> (<argument 1> as <datatype>,
<argument N> as <datatype>)
Por exemplo:
NSTRING RemoveSpaces(NAMES as string)

170

Captulo 9: Trabalhando com Funes Definidas pelo Usurio

Quando voc adiciona a funo janela Frmula, ela inclui o prefixo :UDF, como no exemplo abaixo:
:UDF.RemoveSpaces( )
Quando voc valida a expresso, o Powercenter no valida a funo definida pelo usurio. Ele s valida a
expresso.

Criando Expresses com Funes Definidas pelo Usurio

171

CAPTULO 10

Uso do Depurador
Este captulo inclui os seguintes tpicos:

Viso Geral do Depurador, 172

Criao de Pontos de Interrupo, 174

Configurao do Depurador, 180

Execuo do Depurador, 183

Monitorao do Depurador, 186

Modificao de Dados, 192

Avaliao de Expresses, 193

Cpia de Informaes e da Configurao do Ponto de Interrupo, 194

Soluo de Problemas do Depurador, 195

Viso Geral do Depurador


Voc pode depurar um mapeamento vlido para obter informaes de soluo de problemas sobre
condies de dados e erros. Para depurar um mapeamento, configure e execute o Depurador no Mapping
Designer. O Depurador usa uma sesso para executar o mapeamento no Servio de Integrao. Quando o
Depurador executado, ele faz pausas em pontos de interrupo e voc pode exibir e editar os dados de
sada da transformao.
Talvez voc queira executar o depurador nas seguintes situaes:

Antes de executar uma sesso. Depois de salvar um mapeamento, voc pode executar alguns testes
iniciais com uma sesso de depurao antes de criar e configurar uma sesso no Workflow Manager.

Depois de executar uma sesso. Se uma sesso falhar ou se voc receber resultados inesperados no
destino, execute o Depurador na sesso. Voc tambm pode executar o Depurador em uma sesso se
desejar depurar o mapeamento usando as propriedades de sesso configuradas.

Tipos de Sesso do Depurador


Voc pode selecionar trs tipos diferentes de sesso quando configura o Depurador. O Depurador executa
um fluxo de trabalho para cada tipo de sesso. possvel escolher entre os seguintes tipos de sesso de
Depurador ao configurar o Depurador:

172

Usar uma sesso no-reutilizvel existente. O Depurador usa propriedades de configurao da


origem, destino e sesso existentes. Quando voc executa o Depurador, o Servio de Integrao executa
a sesso no-reutilizvel e o fluxo de trabalho existente. O Depurador no suspenso em caso de erro.

Usar uma sesso reutilizvel existente. O Depurador usa propriedades de configurao da origem,
destino e sesso existentes. Quando voc executa o Depurador, o Servio de Integrao executa uma
instncia de depurao da sesso reutilizvel e cria e executa um fluxo de trabalho de depurao para a
sesso.

Criar uma instncia de depurao da sesso. Voc pode definir propriedades de configurao de
origem, destino e sesso atravs do Assistente do Depurador. Quando voc executa o Depurador, o
Servio de Integrao executa uma instncia de depurao do fluxo de trabalho de depurao e cria e
executa um fluxo de trabalho de depurao para a sesso.

Processo de Depurao
Para depurar um mapeamento, conclua as seguintes etapas:
1.

Crie pontos de interrupo. Crie pontos de interrupo em um mapeamento no qual deseja que o
Servio de Integrao avalie dados e condies de erro.

2.

Configure o Depurador. Use o Assistente do Depurador para configurar o Depurador para o


mapeamento. Selecione o tipo de sesso que o Servio de Integrao usar ao executar o Depurador.
Ao criar uma sesso de depurao, voc configura um subconjunto de propriedades da sesso no
Assistente do Depurador, como local de origem e destino. Voc tambm pode optar por carregar ou
descartar dados de destino.

3.

Execute o Depurador. Execute o Depurador de dentro do Mapping Designer. Ao executar o Depurador,


o Designer se conecta ao Servio de Integrao. O Servio de Integrao inicializa o Depurador e
executa a sesso de depurao e fluxo de trabalho. O Servio de Integrao l os pontos de interrupo
e pausa o Depurador quando os pontos de interrupo so avaliados como verdadeiros.

4.

Monitore o Depurador. Ao executar o Depurador, voc pode monitorar dados de destino,


transformao e dados de sada de mapplet, o log de depurao e o log de sesso. Ao executar o
Depurador, o Designer exibe as seguintes janelas:

5.

Log de depurao. Exiba mensagens do Depurador.

Janela de destino. Exibir dados de destino.

Janela Instncia. Exibir dados da transformao.

Modificar dados e pontos de interrupo. Quando o Depurador pausar, voc poder modificar dados
e visualizar o efeito nas transformaes, mapplets e destinos, conforme os dados se movem pelo
pipeline. Voc tambm pode modificar informaes do ponto de interrupo.

O Designer salva informaes de ponto de interrupo de mapeamento e do Depurador nos arquivos do


espao de trabalho. Voc pode copiar as informaes do ponto de interrupo e a configurao do
Depurador em outro mapeamento. Se desejar executar o Depurador de outra mquina Cliente do
PowerCenter, voc poder copiar as informaes do ponto de interrupo e a configurao do Depurador na
outra mquina Cliente do PowerCenter.

Viso Geral do Depurador

173

A figura a seguir mostra as janelas no Mapping Designer que aparecem quando o Depurador executado:

1. Log do depurador.
2. Log da sesso.
3. Janela Instncia.
4. Janela de destino.

Criao de Pontos de Interrupo


Antes de executar o Depurador, use o Editor de Ponto de Interrupo no Mapping Designer para criar
condies de ponto de interrupo em um mapeamento. possvel criar pontos de interrupo de erro ou
dados para transformaes ou para condies globais. Quando voc executa o Depurador, o Servio de
Integrao pausa o Depurador no momento em que um ponto de interrupo avaliado como verdadeiro.
Voc pode revisar e modificar dados de transformao e, em seguida, continuar a sesso.
Nota: No possvel criar pontos de interrupo para Transformaes de Entrada e Sada de mapplet.

174

Captulo 10: Uso do Depurador

O ponto de interrupo pode consistir em um nome de instncia, um tipo de ponto de interrupo e uma
condio. Ao inserir pontos de interrupo, defina os respectivos parmetros de ponto de interrupo na
seguinte ordem:
1.

Selecione o nome da instncia. Escolha criar um ponto de interrupo global ou um ponto de


interrupo em relao a uma nica transformao no mapeamento ou mapplet.

2.

Selecione o tipo de ponto de interrupo. Escolha avaliar condies de erro ou dados. Tambm
possvel escolher o nmero de linhas a ignorar do tipo de ponto de interrupo .

3.

Insira a condio. Insira as condies de dados de pontos de interrupo de dados de transformao


ou globais. No possvel inserir condies de pontos de interrupo de erro.

Aps definir o nome da instncia, o tipo de ponto de interrupo e a condio de dados opcional, voc pode
exibir cada parmetro na seo Pontos de Interrupo do Editor de Ponto de Interrupo:

Nome da instncia. Do parmetro Nome da Instncia.

Sinalizador de ponto de interrupo habilitado. Habilitar na seo Exibir Pontos de Interrupo.

Nmero de ponto de interrupo. O Designer atribui um nmero baseado na quantidade de pontos de


interrupo que voc cria no mapeamento. Esses nmeros so sequenciais. Se voc remover um ponto
de interrupo, o Designer os renumera quando voc fecha e reabre o Editor de Ponto de Interrupo.

Tipo de ponto de interrupo. Da seo Tipo de Ponto de Interrupo.

Nmero de linhas a ignorar. Da seo Tipo de Ponto de Interrupo.

Condio de dados. Da seo Condio.

A figura a seguir mostra os parmetros na seo Pontos de Interrupo:

Para a transformao Pesquisa, LKP_Store, a seleo indica que o ponto de interrupo est habilitado.
N2 o nmero de ponto de interrupo sequencial, "Dados" indica o tipo de ponto de interrupo, "0"
indica o nmero de linhas do ponto de interrupo a ignorar e "Store_ID = [2641]" a condio de dados.

Seleo do Nome da Instncia


Ao selecionar o nome da instncia, voc pode criar um ponto de interrupo para uma transformao
individual ou criar um ponto de interrupo global:

Instncia de transformao. Selecione uma transformao de um mapeamento ou mapplet para


configurar uma condio de ponto de interrupo que o Servio de integrao avalia ao processar essa
informao. A conveno de nomenclatura para transformaes em mapplets
MappletName.TransformationName.

Criao de Pontos de Interrupo

175

Instncia global. Selecione Global para configurar uma condio de ponto de interrupo que o Servio
de Integrao avalia quando processa cada transformao no mapeamento.

Criao de Pontos de Interrupo de Erro


Ao criar um ponto de interrupo de erro, o Depurador pausa quando o Servio de Integrao encontra
condies de erro, como um erro de transformao, ou ativa a funo ERROR.
Tambm possvel definir o nmero de erros que sero ignorados em cada ponto de interrupo antes de o
Depurador pausar:

Se voc desejar que o Depurador pause em cada erro, defina o nmero de erros para zero.

Se desejar que o Depurador pause aps um nmero especificado de erros, defina o nmero de erros
para um valor maior que zero. Por exemplo, se voc definir o nmero de erros para cinco, o Depurador
ir ignorar cinco erros e pausar em cada sexto erro.

Avaliao de Pontos de Interrupo de Erro


O Servio de Integrao usa o seguinte processo para avaliar pontos de interrupo de erro:

O Servio de Integrao encontra um valor de entrada nulo, e a porta contm um valor padro ERROR ( )
definido pelo usurio.

O Servio de Integrao encontra um erro de transformao de sada, e a porta contm o valor padro
ERROR ( ) do sistema. Os erros a seguir so considerados erros de transformao:
- Erros de converso de dados, como passar uma string para data
- Erros de avaliao de expresso, como dividir por zero
- Chama a funo ERROR em uma expresso

O Servio de Integrao encontra um valor de entrada nulo ou um erro de sada de transformao, e a


porta contm um valor padro ABORT ( ) definido pelo usurio.

O Servio de Integrao encontra um erro fatal.

Se o Servio de Integrao encontrar um erro ao processar uma transformao, ele avalia os pontos de
interrupo do erro daquela transformao e os pontos de interrupo de erro global. Se algum ponto de
interrupo de erro avalia como verdadeiro, o Depurador pausa e no avalia os pontos de interrupo dos
dados.

Nota: Quando o Servio de Integrao encontra um erro fatal ou um ABORT, o Depurador interrompe,
mesmo se no tiver alcanado o nmero de erros configurado para ignorar.

Criao de Pontos de Interrupo de Dados


Ao criar um ponto de interrupo de dados, o Depurador pausa quando o ponto de interrupo de dados
avaliado como verdadeiro. possvel definir o nmero de linhas a ignorar ou uma condio de dados, ou
ambos. As seguintes opes esto disponveis quando voc define pontos de interrupo de dados:

176

Se desejar que o Depurador pause em cada linha, defina o nmero de linhas como zero e no defina uma
condio de dados.

Se desejar que o Depurador pause aps um nmero especificado de linhas passar pela transformao,
defina o nmero de linhas para um valor maior do que zero. Por exemplo, se voc define o nmero de
linhas como trs, o Depurador ignora trs linhas de dados e pausa a cada quarta linha.

Se desejar que o Depurador pause cada vez que os dados corresponderem a uma condio de dados,
insira a condio de dados e defina o nmero de linhas como zero.

Captulo 10: Uso do Depurador

Se desejar que o depurador pause em intervalos designados quando uma linha corresponder condio
de dados, voc pode inserir a condio de dados e definir o nmero de linhas como maior do que zero.
Por exemplo, se voc define o nmero de linhas como trs, o Depurador ignora trs linhas de pontos de
interrupo que correspondem condio e pausa a cada quarta linha.

A tabela a seguir resume as opes no momento em que voc define tipos e condies de pontos de
interrupo de dados:
Nmero de
linhas

Condio
de Dados

Comportamento do Depurador

No

Pausa a cada linha.

>0

No

Pausa aps cada n vezes que o nmero de linhas passa pela transformao.

Sim

Pausa cada vez que a linha corresponde condio de dados.

>0

Sim

Pausa aps cada n vezes que a linha corresponde condio de dados.

Inserindo a Condio de Ponto de Interrupo de Dados


Ao criar uma condio de dados, insira um parmetro global ou um parmetro de uma transformao nica.
Voc tem diversas opes, dependendo da instncia selecionada e do tipo de condio criados.
Use a sintaxe a seguir ao avaliar uma transformao em relao a uma porta ou valor constante:
<port> <operator> <type> <value>
Use a sintaxe a seguir ao selecionar valores nulo e padro, seja globalmente ou em uma transformao:
<port> <operator>
Em uma transformao nica, voc pode inserir vrias condies em um ponto de interrupo se desejar
que o Depurador pause quando todas as condies forem verdadeiras. Voc tambm pode inserir vrios
pontos de interrupo em uma transformao nica, se desejar que o Depurador pause quando pelo menos
uma condio for verdadeira.
A figura a seguir mostra vrias condies em um nico ponto de interrupo:

Nesse exemplo, o Depurador pausa quando ambas as condies forem verdadeiras.

Criao de Pontos de Interrupo

177

A figura a seguir mostra vrios pontos de interrupo em uma transformao nica:

Nesse exemplo, o Depurador pausa quando uma das condies for verdadeira.
A tabela a seguir descreve os parmetros de condio de pontos de interrupo de transformao e de
dados globais:
Parmetro

Opes de Transformao

Opes Globais

Porta

Escolha nome da porta <<ROW-ID>>,


<<ROW-TYPE>> ou <<ANY-PORT>>.

<ANY-PORT>. possvel avaliar essa condio


em relao a cada porta em cada
transformao e mapplet.

Operador

<, <=, =, >, >=, !=, ISNULL, ISDEFAULT.

ISNULL, ISDEFAULT.

Tipo

Constante, Porta. Avalie em relao a um


valor constante ou a outra porta na
transformao.

No disponvel

Valor

Insira o valor ou selecione o nome da porta.

No disponvel

Insero de uma Condio de Dados de Transformao


Quando uma condio de dados de transformao inserida, voc pode selecionar uma porta especfica na
transformao ou um dos seguintes parmetros de porta:

Tipo de linha. Inserir, atualizar, excluir, rejeitar ou filtrado.

ID da linha. Nmero da linha que est passando pela transformao.

Qualquer porta. Quando voc escolhe <<ANY-PORT>>, pode inserir uma condio que o Servio de
Integrao avalia para todas as portas na transformao. Use o operador ISNULL ou ISDEFAULT para
testar valores padro nulos ou de erros.

Nota: Para obter melhores resultados com comparao porta a porta, use portas que tenham o mesmo tipo
de dados. Quando voc compara portas com tipos de dados diferentes, o Servio de Integrao converte o
tipo de dados da porta upstream no tipo de dados da porta downstream antes de comparar as portas, o que
pode resultar em uma comparao invlida.

178

Captulo 10: Uso do Depurador

Insero de uma Condio de Dados Global


Ao inserir uma condio de dados globais, insira uma condio que o Servio de Integrao avalie como
valores padro nulo e erro, em cada porta, em cada transformao. Voc pode escolher <ANY-PORT>
<ISNULL> ou <ANY-PORT> <ISDEFAULT>.

Usando ISNULL e ISDEFAULT


Voc pode criar condies ISNULL e ISDEFAULT em pontos de interrupo de dados globais e de
transformao. Quando voc usa o operador ISNULL ou ISDEFAULT, no pode usar o tipo ou o valor na
condio.
Ao criar uma condio ISNULL, o Depurador pausa quando o Servio de Integrao encontra um valor de
entrada nulo e a porta contm o valor padro do sistema.
Ao criar uma condio ISDEFAULT, o Depurador pausa nas seguintes circunstncias:

O Servio de Integrao encontra um erro de transformao de sada e a porta contm um valor padro
definido pelo usurio de um valor constante ou expresso constante.

O Servio de Integrao encontra um valor de entrada nulo e a porta contm um valor padro definido
pelo usurio de um valor constante ou expresso constante.

Etapas para Inserir Pontos de Interrupo


Conclua as seguintes etapas para inserir pontos de interrupo.
Para inserir pontos de interrupo:
1.

Em um mapeamento, abra o Editor de Pontos de Interrupo de uma das seguintes maneiras:

Pressione as teclas Alt+F9.

Clique em Mapeamentos > Depurado > Editar Pontos de Interrupo.

Clique com o boto direito do mouse em uma transformao ou em um mapplet e escolha Editar
Ponto de Interrupo.

Nota: Voc pode clicar com o boto direito do mouse em qualquer parte de um mapplet ou de uma
transformao com cone. Se a transformao ou o mapplet estiver na exibio normal, clique com o
boto direito do mouse na barra de ttulos.
2.

Selecione o nome da instncia na seo Nome da Instncia.

3.

Clique em Adicionar para adicionar um novo ponto de interrupo.


Se voc selecionar <<ALL INSTANCES>> e clicar em Adicionar, o Designer solicitar que voc escolha
uma transformao especfica ou uma instncia global.
Voc pode clicar em OK para criar um ponto de interrupo de dados incondicional.

4.

Selecione o tipo de ponto de interrupo.

5.

Se selecionar um tipo de ponto de interrupo de dados, voc poder inserir a condio. Insira vrias
condies se desejar que o Servio de Integrao avalie mais de uma condio.

6.

Repita as etapas 2 a 5 para cada ponto de interrupo.

7.

Clique em OK.

Edio de um Ponto de Interrupo


Talvez voc queira rever os pontos de interrupo antes ou durante uma sesso do Depurador. Voc pode
editar, desabilitar ou remover os pontos de interrupo dentro do Editor de Ponto de Interrupo.

Criao de Pontos de Interrupo

179

Para editar os pontos de interrupo:


1.

Em um mapeamento, abra o Editor de Pontos de Interrupo de uma das seguintes maneiras:

Pressione as teclas Alt+F9.

Clique em Mapeamentos > Depurado > Editar Pontos de Interrupo.

Clique com o boto direito do mouse em uma transformao e escolha Editar Ponto de Interrupo.

Nota: Voc pode clicar com o boto direito do mouse em qualquer parte de um mapplet ou de uma
transformao com cone. Se a transformao estiver no modo de exibio normal, clique com o boto
direito do mouse na barra de ttulo.
2.

Selecione um nome da instncia na seo Nome da Instncia.


Sugesto: Selecione <<TODAS AS INSTNCIAS>> na lista Nome de Instncia para exibir todos os
pontos de interrupo de um mapeamento.

3.

Selecione um ponto de interrupo na seo Pontos de interrupo.

4.

Altere a condio ou o tipo do ponto de interrupo.

5.

Limpe a caixa de seleo de um ponto de interrupo para desabilit-lo. Voc pode habilitar novamente
o ponto de interrupo, marcando a caixa de seleo.

6.

Crie um novo ponto de interrupo usando as instrues acima para criar pontos de interrupo.

7.

Clique no boto Remover para remover um ponto de interrupo selecionado.

8.

Clique no boto Remover todos para remover todos os pontos de interrupo da instncia selecionada.
Se desejar remover todos os pontos de interrupo no mapeamento, selecione <<TODAS AS
INSTNCIAS>>.

Configurao do Depurador
Alm de configurar os pontos de interrupo, necessria a configurao do Depurador. Use o Assistente
do Depurador no Mapping Designer para configurar o Depurador em relao ao mapeamento salvo. Ao
configurar o Depurador, digite parmetros como o Servio de Integrao, tipo de origem e destino e
parmetros de memria. necessrio habilitar a depurao na configurao do Servio de Integrao antes
de us-la para executar o Depurador.
O Assistente do Depurador possui as seguintes pginas:

180

1.

Introduo. Esta pgina oferece uma viso geral do assistente. No configure nenhuma propriedade
nesta pgina.

2.

Servio de Integrao e tipo de sesso. Escolha o Servio de Integrao para executar a sesso.
Tambm possvel optar por executar o Depurador em uma sesso existente no-reutilizvel, uma
sesso existente reutilizvel ou criar uma instncia de sesso de depurao. Quando voc executa o
Depurador em relao a uma sesso existente, o Servio de Integrao executa a sesso no modo de
depurao. Ao criar uma sesso de depurao, voc configura um subconjunto de propriedades da
sesso no Assistente do Depurador, como local de origem e destino.

3.

Informaes da sesso. Se voc executar o Depurador em relao sesso existente, selecione o


nome da sesso. Se voc criar uma sesso de depurao, configure os parmetros da sesso.

4.

Configurao da sesso. Se voc criar uma sesso de depurao, defina a configurao da sesso.

5.

Opes de destino. Escolha carregar ou descarregar dados de destino.

Captulo 10: Uso do Depurador

Etapa 1. Introduo ao Depurador


A primeira pgina do Assistente do Depurador oferece uma viso geral do assistente.

Etapa 2. Selecionar o Servio de Integrao e o Tipo de Sesso


Na segunda pgina possvel selecionar as seguintes opes:

Servio de Integrao para executar a sesso. A lista exibe todos os Servios de Integrao associados
ao repositrio. Escolha um Servio de Integrao com depurao habilitada.

Execute o Depurador em relao a uma sesso existente no-reutilizvel, uma sesso existente
reutilizvel ou crie uma instncia de sesso de depurao. Se desejar depurar um mapeamento que usa
propriedades de sesso, como agregao incremental, FTP ou comandos antes ou depois da sesso,
voc dever executar uma sesso existente no modo de depurao.

Ao clicar em Avanar, o Designer testa a conexo com o Servio de Integrao e verifica se a depurao
est habilitada para o Servio de Integrao Se a conexo falhar, o Designer solicitar que voc selecione
outro Servio de Integrao.

Etapa 3. Selecionar Informaes da Sesso


A pgina exibida pelo assistente com as informaes da sesso varia, se voc escolher executar uma
sesso de depurao ou uma sesso existente no modo de depurao.

Execuo de uma Sesso Existente no Modo de Depurao


Se voc escolher executar uma sesso existente no modo de depurao, o Assistente do Depurador exibe
uma lista na pasta ativa de todas as sesses que usam o mapeamento. Selecione a sesso que deseja usar.
No possvel executar o Depurador em relao a uma sesso configurada com vrias parties ou uma
sesso configurada para execuo em uma grade. Voc deve alterar as propriedades da sesso ou criar
uma sesso de depurao para o mapeamento.

Execuo de uma Sesso de Depurao


Se voc optar por executar uma sesso de depurao, pode especificar alguns parmetros de sesso. O
Depurador usa parmetros padro para todos os outros parmetros que voc no pode configurar com uma
sesso de depurao. O Assistente do Depurador exibe uma pgina de sesso que contm as guias a
seguir:

Conexes. Selecione as informaes de conexo da origem e do destino.


Para origens e destinos relacionais, voc pode selecionar uma conexo de banco de dados configurada
no Workflow Manager. Para os destinos relacionais, voc pode optar por truncar as tabelas de destino.
Para origens e destinos de arquivo, voc pode substituir o nome do arquivo. Os locais padro so
$SourceFileDir e $TargetFileDir. Para substituir o local padro para um arquivo de origem ou destino, use
a guia Parmetros da Sesso. No insira o caminho direto no campo do nome do arquivo.

Propriedades. Configure as propriedades de origem e destino.

Leitor/Gravador. Configure leitores e gravadores para as instncias de origem e de destino no


mapeamento.

Quando voc executa uma sesso de depurao, o Servio de Integrao usa propriedades padro de
sesso para todas as propriedades que voc no configurar no Assistente do Depurador.

Configurao do Depurador

181

Voc pode selecionar conexes de origem e destino para cada instncia de origem e destino na sesso de
depurao, na guia Conexes.
Voc pode escolher o tipo de leitor da origem e de gravador do destino, para cada instncia de origem e
destino na sesso de depurao na guia Leitor/Gravador.
A guia Propriedades exibe propriedades diferentes de origem e destino, dependendo do tipo de leitor ou
gravador que voc seleciona na guia Leitor/Gravador. O Servio de Integrao usa valores padro para
todas as propriedades de sesso que voc no configurar na guia Propriedades.
possvel propriedades da sesso para a sesso de Depurao.

Etapa 4. Definir Configurao da Sesso


Ao definir a configurao da sesso de depurao, voc configura as informaes de localizao de
arquivos, tipo de linha e memria.
A tabela a seguir descreve os parmetros de sesso para uma sesso de depurao:
Parmetro de
sesso

Descrio

Tipo de linha

Insert, Delete, Update ou Driven. O tipo de linha padro para uma sesso que usa uma
Estratgia de Atualizao Atualizao.

Tamanho de buffer do
DTM

A alocao de memria padro 12 MB. Talvez seja necessrio aument-la para 24


MB, se voc executar uma sesso com grandes quantidades de dados de caracteres
em um Servio de Integrao configurado para executar em modo Unicode.

Arquivo de parmetros

Nome e localizao do arquivo de parmetro, se o mapeamento usar quaisquer


parmetros ou variveis. O diretrio de trabalho atual do Servio de Integrao a
localizao padro do arquivo de parmetros.

Habilitar Alta Preciso

Quando selecionado, o Servio de Integrao processa o tipo de dados Decimal at


uma preciso de 28. Se a sesso no usar o tipo de dados Decimal, no permitir a
alta preciso.

Valor de Conexo
$Source

Conexo de banco de dados que voc deseja que o Servio de Integrao use para a
varivel $Source.

Valor de Conexo
$Target

Conexo de banco de dados que voc deseja que o Servio de Integrao use para a
varivel $Target.

Solicitao de
Carregamento
Baseado em
Restries

Usa carregamento baseado em restries.

Etapa 5. Configurar Opes de Destino


Na ltima pgina do Assistente do Depurador, voc pode selecionar as seguintes opes de destino:

182

Descartar dados de destino. possvel escolher carregar ou descartar dados de destino ao executar o
Depurador. Se voc descartar dados de destino, o Servio de Integrao no se conectar ao destino.

Exibir dados de destino. possvel selecionar as instncias de destino que voc deseja exibir na janela
Destino enquanto executa uma sesso de depurao.

Captulo 10: Uso do Depurador

Ao clicar em Concluir, se o mapeamento inclui mapplets, o Depurador exibir a caixa de dilogo de instncia
de mapplet. Selecione os mapplets dessa caixa de dilogo que voc deseja depurar. Para remover um
mapplet selecionado, pressione a tecla Ctrl e selecione o mapplet.
Ao selecionar um mapplet para depurar, o Designer o expande para exibir as transformaes individuais
quando o Depurador for executado.
Quando voc no seleciona um mapplet para depurar, o Designer no o expande no espao de trabalho.
No possvel concluir as seguintes tarefas de transformaes no mapplet:

Monitorar ou modificar dados de transformao.

Avaliar expresses.

Editar pontos de interrupo.

Etapa para uma instncia de transformao.

Execuo do Depurador
Quando voc conclui o Assistente do Depurador, o Servio de Integrao inicia a seo e inicializa o
Depurador. Aps inicializao, o Depurador muda os estados de execuo e pausa com base nos pontos de
interrupo e comandos derivados do Mapping Designer. O Depurador pode estar em um dos estados a
seguir:

Inicializando. O Designer se conecta ao Servio de Integrao.

Em execuo. O Servio de Integrao processa os dados.

Pausado. O Servio de Integrao encontra uma interrupo e pausa o Depurador.

Nota: Para permitir que vrios usurios depurem o mesmo mapeamento simultaneamente, cada usurio
deve configurar nmeros de porta diferentes na guia Ferramentas > Opes > Depurar.
O Depurador no usa a funcionalidade de alta disponibilidade.

Estado de Inicializao
Ao executar o Depurador, o Designer se conecta ao Servio de Integrao e o Servio de Integrao
inicializa a sesso. Durante a inicializao, o Designer fecha a janela Navegador e desabilita funes, como
a alternar para outra ferramenta, salvar o repositrio ou obrir uma pasta. Essas funes permanecem
desabilitadas at o Depurador parar.

Estado de Execuo
Quando a inicializao concluda, o Depurador passa para o estado pausado e espera pelo comando para
continuar processando. Quando voc continua, o depurador passa para o estado de execuo. O Servio de
Integrao transforma os dados e avalia-os em relao s condies de ponto de interrupo. O Depurador
permanece no estado de execuo at que o Servio de Integrao encontre um ponto de interrupo, voc
emita um comando de interrupo ou a sesso termine.

Execuo do Depurador

183

Estado Pausado
O Depurador pausa quando o Servio de Integrao encontra uma interrupo. As condies de interrupo
a seguir fazem com que o Depurador pause:

O Servio de Integrao encontra uma condio de ponto de interrupo configurada.

Instrua o Servio de Integrao a continuar at uma instncia que no tenha uma interrupo associada.

Emita um comando de interrupo manual

O Servio de Integrao encontra um erro fatal.

O Servio de Integrao conclui a avaliao de todos os dados. A guia Depurador exibe uma mensagem
de que a sesso foi concluda. Ao continuar a sesso, o Depurador limpa as janelas Destino e
Transformao.

Durante a pausa do depurador, possvel rever e modificar os dados de sada da transformao. O


Depurador permanece em pausa at que voc continue ou finalize a sesso.

Tarefas do Depurador
possvel executar vrias tarefas ao executar o Depurador. O tipo de informao que voc monitora e as
tarefas que voc executa podem variar, dependendo do estado do Depurador. Por exemplo, voc pode
monitorar logs em todos os trs estados do Depurador, mas s pode modificar dados quando o Depurador
estiver no estado pausado. Voc pode concluir os seguintes tipos de tarefas:

Monitorar a sesso. Enquanto o Servio de Integrao executa o Depurador, o Mapping Designer exibe
indicadores e janelas para ajud-lo a monitorar a sesso.

Modificar dados e pontos de interrupo. Quando o depurador pausa, voc pode modificar dados de
sada, indicadores de linha e condies do ponto de interrupo.

Avaliar expresses. Quando o Depurador pausa, voc pode chamar o Editor de Expresso e avaliar
uma expresso em relao aos dados atuais em uma transformao. O Depurador retorna o resultado da
expresso em uma caixa de mensagem. Voc pode inserir expresses usando portas na transformao
selecionada. Tambm possvel avaliar variveis de mapeamento.

Emitir comandos para o Servio de Integrao. possvel emitir comandos para o Servio de
Integrao, como interromper, continuar ou parar.

A tabela a seguir descreve as diferentes tarefas que podem ser executadas em cada um dos estados do
Depurador:
Tarefa.

Descrio

Estado do
Depurado
r

Acesso

Monitorar logs

Monitore o log da sesso e o log de


depurao na janela de Sada.

Inicializand
o

- Exibir Janela de Sada

Executand
o
Pausado
Monitorar dados de
destino

184

Captulo 10: Uso do Depurador

Quando o Depurador passa do estado de


inicializao para o estado de execuo,
o Designer exibe a janela Destino.
possvel exibir os dados de destino
atualizados medida que o Servio de
Integrao os processa.

Executand
o
Pausado

- Exibir Janela Instncia de


Destino
- Exibir Comando Dados de
Destino

Tarefa.

Descrio

Estado do
Depurado
r

Acesso

Monitorar indicadores
de depurao

Os indicadores de depurao so
exibidos em objetos de mapeamento que
o ajudam a monitorar os pontos de
interrupo e fluxo de dados.

Executand
o

- Exibir Objetos de
Mapeamento

Monitorar dados de
transformao

Quando o Depurador passa do estado de


inicializao para o estado de execuo,
o Designer exibe a janela Instncia.
Quando o Depurador pausa, a janela
Instncia exibe dados da transformao
que causou a interrupo. Tambm
possvel selecionar outras
transformaes para exibir.

Pausado

- Exibir Janela Instncia


- Comando Mostrar
Instncia Atual

Modificar dados

Quando o Depurador pausa, voc pode


modificar dados de sada e parmetros
de linha.

Pausado

- Exibir Janela Instncia

Avaliar expresses

Enquanto o Depurador pausado, use o


Editor de Expresso para avaliar
variveis de mapeamento e expresses
em uma transformao.

Pausado

- Comando Avaliar
Expresso

Emitir um comando
de interrupo
manual

Emita um comando de interrupo


manual quando desejar exibir dados de
transformao.

Executand
o

- Comando Break Now


(Interromper Agora)

Editar pontos de
interrupo

O Servio de Integrao comea a avaliar


os pontos de interrupo modificados
imediatamente.

Executand
o

- Comando Editar Pontos


de Interrupo

Atualizar dados

Aps modificar os dados, voc pode


atualiz-los. Ao atualizar dados, o
Servio de Integrao retorna o resultado
da modificao. Se voc inserir dados
que no so vlidos, poder edit-los
novamente antes de continuar o
processamento.

Pausado

- Comando Atualizar Dados


da Janela Instncia

Continuar o
processamento

Ao terminar de exibir e modificar dados,


voc pode continuar com o Depurador.
Esto disponveis vrias opes para
continuar a sesso.

Pausado

- Comando Prxima
Instncia
- Comando Step to
Instance (Etapa at a
Instncia)

Pausado

Pausado

- Comando Continuar

Execuo do Depurador

185

Tarefa.

Descrio

Estado do
Depurado
r

Acesso

Parar o Depurador

Parar o Depurador.

Inicializand
o

- Comando Parar
Depurador

Executand
o
Pausado
Solicitao de status

Ao solicitar o status do Depurador, o


Servio de Integrao exibe o respectivo
status na janela Sada.

Executand
o

- Comando Solicitao de
Status

Pausado

Trabalhando com Valores Persistentes


Quando voc executa o Depurador em mapeamentos com geradores de sequncia e variveis de
mapeamento, o Servio de Integrao pode salvar ou descartar valores persistentes:

Descartar valores persistentes. O Servio de Integrao no salva valores finais de variveis de


mapeamento ou nmeros de sequncia gerados no repositrio quando voc executa uma sesso de
depurao ou uma sesso no modo de depurao e descarta dados de destino.

Salvar valores persistentes. O Servio de Integrao salva valores finais de variveis de mapeamento e
nmeros de sequncia gerados no repositrio quando voc executa uma sesso no modo de depurao
e no descarta dados de destino. Voc pode exibir o valor final de transformaes do Gerador de
Sequncia e Normalizador nas propriedades da transformao.

Comportamento do Designer
Quando o Depurador for iniciado, voc no poder executar as seguintes tarefas:

Fechar a pasta ou abrir outra pasta.

Usar o Navegador.

Executar funes de repositrio, como Salvar.

Editar ou fechar o mapeamento.

Alternar para qualquer ferramenta do Designer, como o Target Designer.

Fechar o Designer.

Nota: O particionamento dinmico desabilitado durante a depurao.


Voc pode executar essas tarefas depois que o Depurador terminar.

Monitorao do Depurador
Ao executar o Depurador, voc pode monitorar as seguintes informaes:

186

Status da sesso. Monitorar o status da sesso.

Movimentao de dados. Monitorar dados conforme eles se movem pelas transformaes.

Captulo 10: Uso do Depurador

Pontos de interrupo. Monitorar dados que atendem s condies de ponto de interrupo.

Dados de destino. Monitorar dados de destino linha por linha.

O Mapping Designer exibe janelas e indicadores de depurao que o ajudam a monitorar a sesso:

Indicadores de depurao. Os Indicadores de depurao em transformaes o ajudam a acompanhar


pontos de interrupo e fluxos de dados.

Janela Instncia. Quando o Depurador pausa, voc pode exibir dados da transformao e informaes
de linha na janela Instncia.

Janela de destino. Exibir dados de destino de cada destino no mapeamento.

Janela Sada. O Servio de Integrao grava mensagens nas seguintes guias da janela Sada:
- Guia Depurador. O log de depurao exibido na guia Depurador.
- Guia Log de Sesso. O log de depurao exibido na guia Log de Sesso.
- Guia Notificaes. Exibe mensagens do Servio de Repositrio.

Enquanto monitora o Depurador voc pode querer alterar os dados de sada da transformao para
visualizar o efeito em transformaes subsequentes ou destinos em fluxo de dados. Voc tambm pode
desejar editar ou adicionar mais informaes de ponto de interrupo para monitorar a sesso com mais
cuidado.

Monitorao de Indicadores de Depurao


Durante uma sesso, o mapeamento exibe os indicadores no canto superior esquerdo de transformaes
que o auxiliam a monitorar pontos de interrupo, fluxo de dados e status do Depurador:

Indicador do ponto de interrupo. Aps o Servio de Integrao concluir a inicializao, ele l os


pontos de interrupo no mapeamento e exibe um sinal de parada em cada transformao, para indicar
as condies dos pontos de interrupo. Voc pode exibir os indicadores de ponto de interrupo
enquanto o Depurador estiver em execuo ou estado pausado. O Mapping Designer no exibe
indicadores de pontos de interrupo globais.

Indicador do qualificador de origem atual. Quando o Servio de Integrao executa o Depurador, por
padro ele processa dados de cada qualificador de origem em um grupo de ordem de carregamento de
destino simultaneamente. O Mapping Designer exibe uma seta piscando em todos os qualificadores de
origem atuais.
Nota: Voc pode configurar o Servio de Integrao para ler origens conectadas s transformaes de
Ligao sequencialmente.

Indicador de transformao atual. O Depurador exibe uma seta amarela slida que indica a
transformao ou o mapplet que o Servio de Integrao estava processando quando encontrou uma
quebra. Essa transformao chamada de a transformao atual. O Depurador exibe uma seta azul
slida em todas as outras transformaes que o Servio de Integrao estava processando quando
encontrou uma quebra na transformao atual.

Status do depurador. Ao iniciar o Depurador, o Mapping Designer exibe o cone Depurador na barra de
ferramentas que indica o estado do Depurador. Quando o Depurador est sendo inicializado ou em
execuo, o cone gira. Quando o Depurador est pausado, o cone para.

Monitorao dos Dados da Transformao


Quando o Depurador pausado, ele exibe a linha atual de dados na janela Instncia para a transformao
no mapeamento ou no mapplet em que o Servio de Integrao encontrou a interrupo. Esta a
transformao atual. Voc pode exibir os dados de qualquer transformao no ponto em que o Depurador foi
pausado, selecionando outra transformao na lista da janela Instncia.

Monitorao do Depurador

187

Se no selecionar nenhum mapplet para depurar depois de concluir Assistente do Depurador, voc no
poder monitorar ou exibir as transformaes dentro do mapplet quando o Depurador estiver em execuo.
Clique em Ferramentas > Opes > guia Depurar para selecionar as colunas que deseja exibir na janela
Exibio de Dados do Depurador. Para obter mais informaes sobre como exibir colunas, consulte
Configurando as Opes de Depurao na pgina 8.
Nota: Quando o mapeamento contiver uma transformao Personalizada, a janela Instncia exibe as
informaes das portas de todos os grupos de entrada e de sada.
Voc pode exibir as seguintes informaes na janela Instncia:

Nome da porta. Exibe todas as portas que esto conectadas a outra transformao ou a outro destino.

ID da linha. Exibe o nmero da linha que est passando pela transformao.

Valor. Exibe o valor de cada porta. Se a porta contiver dados binrios, essa coluna exibe <dados
brutos>. Se a porta no contiver dados, ou se for NULL, essa coluna exibe <nenhum dado disponvel>.
Para transformaes Roteador, os valores so exibidos para portas de entrada e de sada que atendem
s condies do grupo. As portas de sada que no atendem s condies do grupo exibem <nenhum
dado disponvel> na coluna de valor.

Tipo de dados. Exibe o tipo de dados da porta.

Escala e preciso/tamanho. Exibe o comprimento/preciso e a escala da porta.

Indicador de nulo. Se uma coluna contiver um valor nulo, a coluna do indicador de nulo ser
selecionada e o valor ser exibido como <nenhum dado disponvel>.

Tipo de linha. Inserir, atualizar, excluir, rejeitar, filtrado ou no aplicvel. <<ROW TYPE>> exibido na
coluna Porta e o valor do tipo de linha exibido na coluna Valor. O tipo de linha no ser exibido se ele
no for aplicvel, como com as transformaes Gerador de Sequncia.

Indicador de porta. Exibe um dos seguintes indicadores ao lado do nome da porta:


- Linha atual. Indica a porta que est na linha atual.
- Linha anterior. Indica que a porta est na linha anterior.
- Linha atual, valor padro. Indica que o valor da coluna na linha atual o valor padro.
- Linha anterior, valor padro. Indica que o valor da coluna na linha anterior o valor padro.
- Linha atual, modificvel. Indica uma porta de sada na linha atual que voc pode modificar.

Sugesto: Mova o ponteiro sobre o indicador da porta para exibir dicas de ferramentas sobre o indicador.
Quando a janela Instncia exibe a transformao atual ou qualquer transformao no pipeline antes da
transformao atual, as linhas atuais sero exibidas. Se voc exibir uma transformao na janela Instncia
que exibida no pipeline aps a instncia atual, as linhas anteriores sero exibidas. Um indicador tambm
exibido ao lado do nome da porta para designar a linha atual ou anterior.
Por exemplo, no mapeamento a seguir, FILTRANS a transformao atual, conforme mostrado pelo
indicador da transformao atual. Ao exibir a janela Instncia para FILTRANS ou SQ_ORDERS, voc v a
linha atual. Se alternar para EXPTRANS, voc ver a linha anterior porque o Servio de Integrao no
processou a linha pelo EXPTRANS.
A figura a seguir mostra as transformaes com indicadores de processamento de porta:

188

Captulo 10: Uso do Depurador

Os indicadores de linha anterior e atual tambm podem ser exibidos quando a janela Instncia exibir o valor
padro. O Depurador usa as mesmas regras para exibir o indicador de valor padro na janela Instncia que
usa para avaliar valores padro para pontos de interrupo.
Nota: O Depurador no descarta imediatamente as linhas sinalizadas para serem descartadas. Isso inclui as
linhas invlidas, com erro e filtradas. O Servio de Integrao define ROW_FLAG como NULL e atribui ao
tipo de linha um nmero negativo, como -3 (erro). Voc v os indicadores de erro nos registros de sesso
somente com o rastreamento de dados detalhados. O Servio de Integrao descarta as linhas
posteriormente no pipeline.

Continuao do Depurador
Depois de rever ou modificar os dados, voc pode continuar com o Depurador das seguintes formas:

Continuar at a prxima interrupo. Para continuar at a prxima interrupo, clique em Continuar na


barra de ferramentas ou no menu de opes Mapeamento > Depurador. O Depurador continua a
execuo at encontrar a prxima interrupo.

Continuar at a prxima instncia.Para continuar at a prxima instncia, clique em Prxima Instncia


na barra de ferramentas ou na opo de menu Mapeamento > Depurador. O Depurador continua a
execuo at alcanar a prxima transformao ou encontrar uma interrupo. Se a instncia atual tiver
sada indo para mais de uma instncia de transformao, o Depurador para na primeira instncia do
processo. Se voc no selecionou um mapplet para depurar, ao completar as etapas do Assistente do
Depurador, o Depurador continua at a instncia aps o mapplet.

Etapa para uma instncia especificada. Para continuar at uma instncia especfica, selecione a
instncia de transformao no mapeamento e clique em Etapa at a instncia na barra de ferramentas ou
no menu de opes Mapeamento > Depurador. O Depurador continua a execuo at alcanar a prxima
transformao selecionada no mapeamento ou at encontrar uma interrupo.
Voc pode ir at as transformaes conectadas no mapeamento, mesmo que elas no tenham um ponto
de interrupo associado. No possvel ir at as seguintes instncias:
- Origens
- Destinos
- Transformaes desconectadas
- Mapplets no selecionados para depurao

Monitorao dos Dados de Destino


Quando o Depurador executado, o Designer armazena em cache os dados de destino. Voc pode exibir os
dados armazenados em cache na janela Destino enquanto o Depurador est sendo executado ou pausado.
Voc pode exibir dados de destino armazenados, mesmo que voc configure o Assistente do Depurador
para descartar dados de destino.
Voc pode exibir as seguintes informaes para cada linha de dados de destino:

ID de Linha . Nmero da linha dos dados de destino armazenados em cache.

Tipo de linha. Inserir, atualizar, excluir, rejeitar ou filtrado.

Nome e valor da coluna. Nome e valor da coluna para cada linha no cache.

Se o mapeamento tiver mais de um destino, voc pode escolher o destino que quer exibir. Selecione um
destino para exibir a partir da lista na janela Debugger Target Display (Exibio de Destino do Depurador).
Os destinos exibidos na lista so os destinos selecionados no Assistente do Depurador. Se voc desejar
exibir um destino que voc no selecionou no assistente, clique em Mapeamentos > Depurador > Exibir
Dados de Destino.

Monitorao do Depurador

189

A janela Destino exibe at 1.000 linhas. Aps alcanar 1.000 linhas, o Designer comea a sobrescrever
dados da primeira linha. Voc pode limpar o cache e a janela Exibio de Destino do Depurador clicando
com o boto direito do mouse na janela Exibio de Destino do Depurador e selecionando Limpar Dados.

Monitorando o Log de Depurao


Quando o Depurador inicializa, o Servio de Integrao comea a gravar o log de depurao na guia
Depurador da janela Sada. O Servio de Integrao grava os seguintes tipos de mensagens no log de
depurao:

Inicializao da sesso

Confirmar solicitao de usurio

O Servio de Integrao encontra uma interrupo

Erros de depurao

Status do depurador

A sesso interrompida

Quando a linha inferior na janela Sada l que o Servio de Integrao est pronto, voc sabe que o
Depurador est pausado. O Servio de Integrao permanece e pausa at que voc emita um comando,
como Continuar, Avanar para ou Parar.
Nota: Se o Depurador no iniciar ou se ele parar abruptamente, e o Servio de Integrao no gravar
nenhuma mensagem na janela Sada, voc pode examinar a pgina de Domnio do Console de
Administrao para obter mais informaes.
A tabela a seguir mostra exemplos de mensagens de log de depurao na janela Sada:
Ao do Depurador

Exemplos de mensagens de log de depurao

O Depurador
inicializado.

Establishing a connection to the Integration Service


dwilliam...
Integration Service dwilliam acknowledged its ability to
debug a mapping.
Initializing debugger...
Sending request to Integration Service dwilliam to debug
mapping Customers...
Waiting for Integration Service to initialize...
Establishing communication with the DTM...
Established communication with the DTM.
Waiting for DTM initialization to complete...
O Servio de Integrao est em execuo no modo ASCII.
O Servio de Integrao est em execuo com Alta Preciso
desabilitada.
Inicializao do Servio de Integrao concluda.

Depois da inicializao, o
Servio de Integrao
reconhece os pontos de
interrupo no
mapeamento.

DSQ Execution Order:

O Servio de Integrao est Pronto.


Sending breakpoints to the Integration Service...
O Servio de Integrao reconheceu a solicitao para
definir os pontos de interrupo.

190

Captulo 10: Uso do Depurador

Ao do Depurador

Exemplos de mensagens de log de depurao

O Servio de Integrao
encontra um ponto de
interrupo.

O Servio de Integrao parou em um ponto de interrupo de


dados.
List of breakpoints that the Integration Service hit:
#3 Data(2,"CUSTOMER_ID > [14]")
The current transformation is Exp_Customers.
O Servio de Integrao est Pronto.

D o comando Continuar.

Sending request to continue...


O Servio de Integrao reconheceu a solicitao para
continuar.

D o comando Etapa at
a Prxima Instncia. O
Servio de Integrao
reconhece e executa a
solicitao.

Sending request to go to next instance...


O Servio de Integrao reconheceu a solicitao para
avanar para a prxima instncia.
The current transformation is Exp_Customers.
O Servio de Integrao est Pronto.

D o comando Etapa at
a Instncia. O Servio de
Integrao reconhece e
executa a solicitao.

Sending request to step to instance...


O Servio de Integrao confirmou a solicitao para a
etapa at a instncia.
The current transformation is SQ_CUSTOMERS.
O Servio de Integrao est Pronto.

Modificar dados na janela


Instncia.

Sending request to modify data for transformation


Exp_Customers, port NEW_CUST_ID, to value [1234566...]
O Servio de Integrao reconheceu a solicitao para
modificar os dados.
Sending request to continue...
O Servio de Integrao reconheceu a solicitao para
continuar.

Sesso concluda. O
Servio de Integrao
aguarda o ltimo
comando para encerrar o
Depurador.

Response from the Integration Service: Session completed


<successfully/with failure>. Last chance to look at target
data. Debugger will shut down when we continue.

Depurador concludo.

O Servio de Integrao est encerrando...

O Servio de Integrao est Pronto.

O Servio de Integrao concluiu a execuo.


Debugger shutdown complete.

Para salvar o log quando a sesso for concluda, clique com o boto direito do mouse dentro da guia
Depurador e selecione Salvar sada como no menu.

Usando o Workflow Monitor


Voc pode exibir sesses e fluxos de trabalho concludos e em execuo no Workflow Monitor. O Servio de
Integrao usa um fluxo de trabalho de depurao para executar a sesso de depurao. O Workflow

Monitorao do Depurador

191

Monitor exibe os nomes da sesso e do fluxo de trabalho de depurao de formas diferentes, dependendo
do tipo de sesso que voc escolher no Assistente do Depurador.
A tabela a seguir descreve os nomes da sesso e do fluxo de trabalho que o Workflow Monitor exibe para
cada tipo de sesso de depurao.
Tipo de sesso

Nome do fluxo de trabalho

Nome da Sesso

Sesso reutilizvel existente

DebugWorkflow_mappingname

DebugInst_sessionname

Sesso no reutilizvel
existente

workflowname

sessionname

Sesso de depurao

DebugWorkflow_mappingname

DebugInst_DebugSession_mappingname

O Workflow Monitor exibe o modo de execuo de depurao na coluna Tipo de Execuo, para todos os
fluxos de trabalho e sesses do depurador. Voc tambm pode acessar os registros pelo Workflow Monitor.
Nota: No possvel usar o Workflow Monitor para reiniciar, cancelar ou interromper uma sesso de
depurao, um fluxo de trabalho de depurao ou para executar uma sesso no modo de depurao.

Modificao de Dados
Quando o Depurador pausa, a instncia atual exibida na janela Instncia e o indicador de instncia atual
exibido na transformao do mapeamento. Voc pode fazer as seguintes modificaes na instncia atual
quando o Depurador pausar em um ponto de interrupo de dados:

Modificar dados de sada. possvel modificar dados de sada da transformao atual. Ao continuar a
sesso, o Servio de Integrao valida os dados. Ele realiza a mesma validao de quando passa os
dados de porta a porta em uma sesso comum.

Altere os dados nulos para no nulos. Limpe a coluna nula e digite um valor na coluna de valor para
alterar os dados nulos para no nulos.

Altere os dados nulos para no nulos. Selecione a coluna nula para alterar os dados no nulos para
nulos. O Designer solicita que voc confirme se deseja fazer esta alterao.

Modifique os tipos de linha. Modifique a estratgia de atualizao, filtro ou tipos de linha de


transformao Roteador.
Para as transformaes Roteador, voc pode alterar o tipo de linha para substituir a avaliao da
condio de grupo dos grupos definidos pelo usurio. Por exemplo, se uma condio de grupo avalia
como falso, as linhas no so passadas atravs das portas de sada para a prxima transformao ou
destino. A janela Instncia exibe <nenhum dado disponvel>, e o tipo de linha filtrado. Se voc deseja
passar a linha filtrada para a prxima transformao ou destino, possvel alterar o tipo de linha para
Inserir. Da mesma forma, voc pode alterar o tipo de linha de inserir para filtrado de um grupo que
corresponde condio de grupo.

Depois de alterar os dados, voc pode atualizar o cache antes de continuar a sesso. Quando voc emite o
comando Atualizar, o Designer processa a solicitao da transformao atual e voc pode ver se os dados
inseridos so vlidos. Voc pode alterar novamente os dados antes de continuar a sesso.

192

Captulo 10: Uso do Depurador

Restries
Os dados no podem ser mudados nas seguintes portas de sada:

Transformao de Normalizador. Portas de Chaves Geradas e ID de Coluna Gerada.

Transformao Classificao. Porta RANKINDEX.

Transformao Roteador. Todas as portas de sada.

Transformao Gerador de Sequncia. Portas CURRVAL e NEXTVAL.

Transformao de Pesquisa. Porta NewLookupRow para uma transformao de Pesquisa configurada


para usar um cache dinmico.

Transformao personalizada. Portas em grupos de sada diferentes do grupo de sada atual.

Transformao Java. Portas em grupos de sada diferentes do grupo de sada atual.

Alm disso, no possvel alterar dados associados a:

Mapplets no selecionados para depurao

Portas de entrada ou de entrada e sada

Portas de sada quando o Depurador pausa em um ponto de interrupo de erro

Avaliao de Expresses
Quando o Depurador pausar, use o Editor de Expresses para avaliar expresses usando variveis e portas
de mapeamento em uma transformao selecionada.
possvel avaliar expresses nas seguintes transformaes:

Transformao Agregador

Transformao Expresso

Transformao Filtro

Transformao Classificao

Transformao Roteador

Transformao Atualizar Estratgia

Ao criar uma expresso, voc utiliza as referncias para portas na transformao. O Editor de Expresso
no exibe portas de outras transformaes no mapeamento. Ao avaliar a expresso, o Depurador retorna o
resultado da expresso em uma caixa de mensagem.

Avaliando Expresses que usam Variveis de Mapeamento


Se voc definir variveis no mapeamento, poder avaliar o valor inicial ou o valor atual da varivel de
mapeamento. Para descobrir o valor inicial de uma varivel de mapeamento, avalie apenas a varivel de
mapeamento.
O Depurador usa o seguinte processo para determinar o valor inicial de uma varivel de mapeamento:
1.

Arquivo de parmetros. Se voc usar um arquivo de parmetro, o Depurador retornar o valor no


arquivo de parmetro.

2.

Repositrio. Se voc no usar um arquivo de parmetro, o Depurador retornar o valor no repositrio.

Avaliao de Expresses

193

3.

Valor inicial. Se o repositrio no tiver nenhum valor armazenado para a varivel, o Depurador
retornar o valor inicial configurado na varivel de mapeamento.

4.

Valor padro. Se voc no configurar um valor inicial para a varivel de mapeamento, o Depurador
retornar o valor padro baseado em tipos de dados.

Para descobrir o valor atual de uma varivel de mapeamento, avalie a varivel de mapeamento com uma
das funes de varivel, como SetMaxVariable ou SetCountVariable. O Designer exibe apenas as variveis
de mapeamento associadas s transformaes no mapeamento. Para exibir as variveis de mapeamento
associadas a um mapplet, selecione a transformao no mapplet expandido quando o Depurador estiver
sendo executado.

Etapas para Avaliar Expresses


Para avaliar uma expresso durante a pausa do Depurador, conclua as etapas a seguir:
Para avaliar uma expresso durante a pausa do Depurador:
1.

Selecione a transformao para a qual voc deseja avaliar uma expresso.

2.

Clique em Mapeamentos > Depurador > Avaliar Expresso.

3.

Digite uma expresso no Editor de Expresso que referencie as portas na transformao selecionada.

4.

Para validar a expresso, clique em Validar.

5.

Para avaliar a expresso, clique em Avaliar.


Se a expresso for vlida, o Servio de Integrao faz a avaliao dela. O Servio de Integrao retorna
o resultado da expresso em uma caixa de mensagem.

Cpia de Informaes e da Configurao do Ponto


de Interrupo
O Designer armazena informaes de ponto de interrupo e configurao do Depurador nos arquivos do
espao de trabalho. Se voc copiar um mapeamento ou criar um atalho para outra pasta ou se desejar
depurar o mapeamento de outra mquina do Cliente do PowerCenter, poder transferir os pontos de
interrupo e a configurao usando as opes Salvar Configurao e Carregar Configurao no menu
Depurador.
Para salvar pontos de interrupo e configurao associados a um mapeamento:
1.

Abra o mapeamento que possui os pontos de interrupo e a configurao que voc deseja salvar.

2.

Clique em Mapeamentos > Depurador > Salvar Configurao.

3.

Salve o arquivo com uma extenso .dcf.

4.

Ao escolher um arquivo .dcf existente, o Designer anexa as informaes de configurao ao arquivo.

5.

Se o arquivo contiver informaes de configurao do mapeamento, o Designer solicitar que voc se


certifique de que deseja substituir a configurao.

Transferncia e Configurao dos Pontos de Interrupo


Voc pode transferir as informaes salvas dos pontos de interrupo e da configurao de um mapeamento
para outro.

194

Captulo 10: Uso do Depurador

Para carregar os pontos de interrupo e a configurao para outro mapeamento:


1.

Torne o arquivo .dcf acessvel mquina do cliente PowerCenter onde voc deseja carregar as
configuraes.

2.

Abra o mapeamento que voc deseja para carregar a configurao.

3.

Clique em Mapeamento > Depurador > Carregar configurao.


exibida a caixa de dilogo Abrir arquivo DCF.

4.

Selecione o arquivo de configurao .dcf e clique em Abrir.


Se houver vrias configuraes no arquivo, ou se o Designer no localizar um nome de mapeamento
correspondente ele exibir uma lista de configuraes de mapeamento no arquivo.

5.

Selecione um mapeamento e clique em OK.


O Designer carrega todos os pontos de interrupo e a configurao dos objetos de mapeamento
correspondente. Ele carrega toda a configurao que no dependente de objetos de mapeamento,
como o Servio de Integrao e a opo para descartar os dados de destino.
Nota: No possvel carregar os pontos de interrupo enquanto o Depurador estiver ativo.

Soluo de Problemas do Depurador


Estou tentando executar uma sesso do Depurador e recebi a seguinte mensagem de erro:
Establishing a connection to the Integration Service <name>...
Integration Service <name> acknowledged its ability to debug a mapping.
Initializing debugger...
bind: (WSAEADDRINUSE)Address already in use
Este erro ocorre quando a porta que o Depurador est usando j est sendo usada por outro aplicativo.
Atribua uma porta diferente para o Depurador.
Para atribuir uma porta diferente para o Depurador:
1.

Clique em Ferramentas > Opes > Depurar.

2.

Atribua um novo nmero de porta no campo Porta ou selecione Escolher automaticamente um nmero
de porta entre Mn e Mx, e atribua um intervalo de portas para o Depurador usar.
Voc pode selecionar uma porta entre 5001 e 32000 ou definir um intervalo entre 5001 e 32000.

Soluo de Problemas do Depurador

195

CAPTULO 11

Exibindo Linhagem de Dados


Este captulo inclui os seguintes tpicos:

Exibindo Linhagem de Dados - Viso Geral, 196

Configurando o Acesso Linhagem de Dados, 197

Executando Linhagem de Dados do Designer, 197

Exibindo Linhagem de Dados - Viso Geral


Voc pode usar um Metadata Manager para rastrear o fluxo de dados no PowerCenter das origens aos
destinos. Com a linhagem de dados do Metadata Manager, voc pode analisar a origem dos dados, como
eles foram transformados e quais objetos o transformam e onde os dados terminam. possvel analisar o
fluxo de dados dentro de um nico repositrio do PowerCenter ou em mltiplos repositrios do PowerCenter.
Voc pode exibir a linhagem de dados de objetos PowerCenter no Designer. Ao exibir a linhagem de dados
de um objeto PowerCenter, o Designer se conecta ao aplicativo Metadata Manager e extrai as informaes
de linhagem de dados a partir do Depsito do Metadata Manager. O diagrama de linhagem de dados
exibido em uma janela do navegador.
A anlise de linhagem de dados em um repositrio do PowerCenter exibe um ou mais objetos do
PowerCenter abaixo:

196

Repositrios. Voc pode carregar objetos de vrios repositrios PowerCenter para o Metadata Manager.
Na linhagem de dados, o Metadata Manager exibe o repositrio de cada objeto de metadados.

Estruturas de dados. Linhagem de dados no objeto PowerCenter inclui definio de origem, definio de
destino e estruturas de dados de transformao.

Campos. Campos so objetos dentro de estruturas de dados que armazenam os metadados. Linhagem
de dados em um objeto PowerCenter inclui a origem, o destino e as portas de transformao.

Configurando o Acesso Linhagem de Dados


Para configurar o PowerCenter e o Metadata Manager para exibir linhagem de objetos do PowerCenter,
conclua as seguintes tarefas:
1.

Certifique-se de que o Metadata Manager est em execuo. Crie um Servio do Metadata Manager
no Console de Administrao ou verifique se h um Servio do Metadata Manager habilitado no domnio
que contm o repositrio do PowerCenter em que voc deseja executar a anlise da linhagem de
dados.

2.

Carregar os metadados de repositrio do PowerCenter. Crie um recurso para o repositrio do


PowerCenter no Metadata Manager e carregue metadados de repositrio do PowerCenter no Depsito
do Metadata Manager.

3.

Configurar a conexo entre o repositrio do PowerCenter e o Metadata Manager. Configure o


Servio do Metadata Manager e o nome do recurso do repositrio do PowerCenter no Console de
Administrao do PowerCenter.

4.

Configurar o navegador da Web. Ao executar a anlise de linhagem de dados em um objeto do


PowerCenter, o Designer inicia a anlise de linhagem de dados no navegador padro configurado em
seu sistema. A linhagem de dados requer o visualizador Flash 9 instalado no navegador.

Executando Linhagem de Dados do Designer


Voc pode acessar a linhagem de dados de qualquer ferramenta do PowerCenter Designer. A linhagem de
dados pode ser exibida em definies de origem e de destino, transformaes, mapplets e mapeamentos.
Para executar a linhagem de dados no PowerCenter Designer:
1.

No Designer, abra a pasta PowerCenter que contm o objeto no qual voc deseja executar a linhagem
de dados.

2.

Abra o objeto na rea do espao de trabalho aplicvel.


Por exemplo, se voc deseja executar a linhagem de dados em uma transformao, abra a
transformao no Transformation Developer.

3.

No espao de trabalho, clique com o boto direito do mouse e selecione Linhagem de Dados.
A linhagem de dados do objeto exibida em uma janela do navegador.
Nota: O desempenho da anlise da linhagem de dados varia de acordo com a quantidade de recursos
de sistema disponveis no computador que est executando o Aplicativo Metadata Manager. Executar
vrias anlises de linhagem de dados em diversos objetos simultaneamente pode afetar o desempenho.

Depois de acessar a linhagem de dados, voc pode exibir os detalhes de cada objeto no diagrama da
linhagem de dados. Voc pode exportar a linhagem de dados para um arquivo de imagem PNG ou imprimir o
diagrama. Tambm possvel enviar a linhagem de dados por e-mail para outros usurios.

Configurando o Acesso Linhagem de Dados

197

CAPTULO 12

Comparando Objetos
Este captulo inclui os seguintes tpicos:

Comparando Objetos - Viso Geral, 198

Comparando Origens, Destinos e Transformaes , 200

Comparando Mapeamentos e Mapplets, 200

Comparando Objetos - Viso Geral


Voc pode comparar dois objetos de repositrio do mesmo tipo para identificar diferenas entre os objetos
usando o Designer. Por exemplo, voc pode usar uma definio de destino em um mapeamento, mas
existem duas definies de destino iguais. Convm comparar as definies de destino para ver qual delas
contm as colunas que voc precisa. Ao comparar dois objetos, o Designer exibe seus atributos lado a lado.
Voc pode comparar os seguintes tipos de objetos:

Origens. Voc pode comparar duas origens, dois atalhos de origem ou uma origem com um atalho de
origem.

Destinos. Dois destinos, dois atalhos de destino ou um destino com um atalho de destino.

Transformaes. Duas transformaes, dois atalhos de transformao ou uma transformao com um


atalho de transformao.

Mapeamentos e mapplets. Voc pode comparar dois mapeamentos, dois atalhos de mapeamento ou um
mapeamento com um atalho de mapeamento. Dois mapplets, dois atalhos de mapplets ou um mapplet
com um atalho de mapplet.

Instncias. Dentro dos mapeamentos e dos mapplets, possvel comparar duas instncias de origem,
duas instncias de destino ou duas transformaes. Dentro dos mapeamentos, tambm possvel
comparar duas instncias de mapplet.

Pastas. Voc pode comparar duas pastas no Repository Manager.

Verses de atalho do objeto. Voc pode comparar duas verses de um objeto no Repository Manager.

Voc pode comparar os objetos nas seguintes circunstncias:

198

Quando ambos os objetos existirem em pastas abertas. possvel comparar um objeto em qualquer
pasta aberta com outro objeto do mesmo tipo em qualquer pasta aberta. As pastas podem estar em
repositrios distintos. No possvel comparar objetos de tipos diferentes.

Quando importar um objeto. Quando voc importa um objeto para uma pasta que contm um objeto
com o mesmo nome, o Designer permite a comparao dos objetos para determinar se voc deseja
substituir ou usar o objeto existente.

Quando copiar um objeto. Se voc copiar um objeto para uma pasta que contm um objeto daquele tipo
com o mesmo nome, o Designer permite a comparao dos dois objetos para determinar se voc deseja
substituir ou usar o objeto existente.

Quando copiar ou implantar objetos em um outro repositrio. Se voc copiar ou implantar um objeto
para uma pasta em um outro repositrio, o Assistente de Cpia ou Implantao compara os objetos na
pasta de destino com os objetos implantados ou copiados.

Quando voc exibir um objeto que possui vrias verses. possvel comparar a verso anterior de
um objeto com a verso atual do objeto para ver as alteraes feitas na ltima verso.

Quando voc exibir um objeto na janela Exibio de resultados. Quando voc exibir um objeto na
janela Exibio de resultados, possvel comparar as verses anteriores do objeto com a verso atual
para exibir as diferenas entre verses.

Voc pode comparar objetos em pastas e repositrios usando o Designer. Para fazer isso, as duas pastas
precisam estar abertas. Quando voc compara os objetos, uma caixa de dilogo exibe os resultados. Cada
caixa de dilogo contm guias diferentes para diversos tipos de objetos.
A figura a seguir mostra uma comparao de duas origens relacionais:

Nesta caixa de dilogo, cada guia contm duas colunas. A coluna esquerda lista os atributos no primeiro
objeto que voc compara, e a coluna direita lista os atributos no segundo objeto. Uma linha divisria
separa as duas colunas. Deslize o divisor esquerda ou direita para redimensionar as colunas. O
Designer reala as diferenas entre os objetos. Portas ou colunas comuns a ambos os objetos so exibidos
na mesma linha.
Nota: No possvel alterar os metadados exibidos nos resultados.

Comparando Objetos - Viso Geral

199

Comparando Origens, Destinos e Transformaes


Voc pode comparar objetos individuais do mesmo tipo para identificar diferenas entre os objetos usando o
Designer.
A tabela a seguir descreve os mtodos que podem ser usados para comparar origens, destinos ou
transformaes:
Para comparar...

Abra a seguinte
ferramenta...

Prxima etapa...

Origens

Source Analyzer

Clique em Origens > Comparar.

Destinos

Target Designer

Clique em Destinos > Comparar.

Transformaes

Transformation Developer

Clique em Transformao > Comparar.

Instncias em um
mapeamento

Mapping Designer

Selecione um objeto e clique em Transformao >


Comparar.

Instncias em um
mapplet

Mapplet Designer

Selecione um objeto e clique em Transformao >


Comparar.

Nota: Se um dos campos nessa caixa de dilogo estiver em branco ou exibir o nome de um objeto que voc
no deseja comparar, clique em Procurar para selecionar objetos para comparar.

Comparando Mapeamentos e Mapplets


Voc pode comparar dois mapeamentos ou dois mapplets. Por exemplo, se voc tem dois mapeamentos
com o mesmo nome em pastas diferentes, voc pode compar-los para ver se diferem.
Quando voc compara dois mapeamentos ou dois mapplets, uma caixa de dilogo exibe os resultados. Use
as guias nesta caixa de dilogo para exibir as seguintes informaes:

200

Informaes de resumo. Exibir um resumo das diferenas entre cada mapeamento ou mapplet na guia
Resumo. Voc pode salvar essas informaes em um arquivo de texto.

Informaes gerais. Comparar as informaes gerais sobre cada objeto como nome, descrio e
validade na guia Mappings ou Mapplets. Voc tambm pode comparar as informaes gerais sobre
atalho.

Instncias. Comparar as instncias de origem, destino e transformao em cada mapeamento ou


mapplet na guia Instncias. Voc pode comparar as instncias de origem, destino, transformao e
mapplet de mesmo tipo. Instncias com o mesmo nome aparecem na mesma linha. Para comparar as
instncias com detalhe, selecione uma instncia em cada mapeamento ou mapplet e clique em Comparar
instncias.

Links. Comparar as diferenas nos links de entrada e sada e as portas que conectam a instncia a
outras instncias de transformao usando a guia Instncias. Para comparar links, compare primeiro as
instncias em dois mapeamentos ou mapplets. Em seguida, clique em uma instncia na guia Instncias e
clique em Comparar links. Para comparar os links de entrada, clique na guia Links de entrada. Para
comparar os links de sada, clique na guia Links de sada. Para comparar as portas de cada link, clique
em um link. Se uma porta existe em ambas as instncias, ela aparece na mesma linha.

Captulo 12: Comparando Objetos

Parmetros e variveis. Comparar os parmetros e as variveis em cada objeto na guia Variveis.

Ordens de carregamento do destino. Comparar a ordem da carga de destino em cada mapeamento na


guia Ordem de carga de destino. O Designer no exibe essa guia quando voc compara os mapplets.

Extenses de metadados. Comparar as extenses de metadados em cada mapeamento ou mapplet na


guia Extenses de metadados.

A tabela a seguir descreve o mtodo de comparao de mapeamentos, mapplets ou instncias em dois


mapeamentos ou mapplets:
Para comparar...

Abra a seguinte ferramenta...

Selecionar

Mapeamentos

Mapping Designer

Clique em Mapeamentos > Comparar.

Mapplets

Mapplet Designer

Clique em Mapeamentos > Comparar.

Instncias em dois
mapeamentos

Mapping Designer

Clique em Mapeamentos > Comparar.

Instncias em dois
mapplets

Mapplet Designer

Clique em Mapeamentos > Comparar.

Nota: Se um dos campos nessa caixa de dilogo estiver em branco ou exibir o nome de um objeto que voc
no deseja comparar, clique em Procurar para selecionar um objeto.

Comparando Mapeamentos e Mapplets

201

CAPTULO 13

Gerenciando Componentes
Comerciais
Este captulo inclui os seguintes tpicos:

Gerenciando Componentes Comerciais - Viso Geral, 202

Gerenciando Componentes Comerciais e Diretrios, 203

Gerenciando Componentes Comerciais - Viso Geral


Use componentes comerciais para agrupar e exibir origens e mapplets em uma pasta de repositrio. Um n
de componente comercial aparece em cada pasta de repositrio no Repository Manager e no Designer.
possvel adicionar um nmero ilimitado de diretrios rvore de componentes comerciais.
O componente comercial pode fazer referncia a uma origem, um mapplet ou um atalho para uma origem ou
mapplet.
A figura a seguir mostra diretrios nos quais voc agrupa componentes comerciais.

possvel usar o mesmo mapplet ou origem vrias vezes na rvore de componentes comerciais.
Se a rvore de componentes comerciais estiver em uma pasta compartilhada, todos os diretrios na rvore
sero compartilhados.

202

Bloqueio do Componente Comercial


O Designer bloqueia a rvore de componentes comerciais enquanto o respectivo contedo est sendo
editado. No possvel copiar um componente comercial quando a rvore de componentes comerciais
estiver bloqueada.

Criao de Links para Documentao de Componentes


Comerciais
Voc pode criar e editar os links clicados pelos usurios para exibir a documentao comercial desenvolvida
para os componentes e diretrios comerciais. A documentao comercial oferece detalhes sobre um objeto
de repositrio ou expresso de transformao especfica.

Gerenciando Componentes Comerciais e Diretrios


Use o Designer para realizar as seguintes tarefas:

Criar um diretrio.

Criar um componente comercial.

Editar um diretrio.

Excluir um diretrio ou componente comercial.

Copiar um diretrio ou componente comercial.

Para mover um componente ou diretrio comercial, arraste um nico componente comercial ou um diretrio
inteiro dentro da mesma rvore de componente comercial. Se voc arrastar um nico componente comercial
ou um diretrio inteiro para/de uma pasta de repositrio ou repositrio diferente, o Designer solicita que voc
crie uma cpia do objeto original no local de destino.

Criando e Editando um Diretrio


Use diretrios para organizar objetos de repositrio na rvore de componentes comerciais. Voc pode inserir
um nome para cada diretrio na rvore e fornecer comentrios para identific-lo. Ao criar um diretrio, o
local do diretrio aparece como uma de suas propriedades. possvel criar um diretrio em um outro local
selecionando um n de diretrio distinto ao criar o diretrio.
Para criar um diretrio de componentes comerciais:
1.

No Designer, conecte-se a um repositrio e abra uma pasta.

2.

Clique em Repositrio > Componentes Comerciais > Novo Diretrio.


Nota: Para criar um diretrio de componentes comerciais sob outro diretrio, selecione o diretrio no
Navegador e clique em Repositrio > Componentes Comerciais > Novo Diretrio.

3.

Insira um nome e uma descrio para o diretrio de componentes comerciais.

Edio de um Diretrio
Para editar um diretrio de componentes comerciais:
1.

No Designer, conecte-se a um repositrio e abra uma pasta.

2.

Selecione o diretrio dos componentes comerciais que voc deseja editar.

Gerenciando Componentes Comerciais e Diretrios

203

3.

Clique em Repositrio > Componentes Comerciais > Editar Propriedades.

Criando um Componente Comercial


Crie componentes comerciais para exibir as origens e os mapplets que usam diretrios. Edite o objeto a
partir do seu local original ou do diretrio de componentes comerciais. possvel fazer referncia a uma
origem ou mapplet vrias vezes na rvore de componentes comerciais.
Voc tambm pode criar componentes comerciais com objetos de outras pastas de repositrio ou
repositrios, usando atalhos ou copiando os componentes comerciais.
Para criar um componente comercial:
1.

No Designer, conecte-se a um repositrio.

2.

Abra a pasta de repositrio na qual deseja criar um componente comercial.

3.

Nesta pasta de repositrio, a partir do Navegador, selecione a origem ou o mapplet para o qual deseja
criar a referncia.

4.

Arraste a origem ou o mapplet para o diretrio na rvore do componente comercial.

Criando Componentes Comerciais de uma Cpia


Para criar uma cpia de um componente comercial no compartilhado, arraste o objeto de uma pasta de
repositrio para um diretrio na rvore do componente comercial. O Designer solicita que voc crie uma
cpia do objeto na rvore do componente comercial. Cpias de objetos das outras pastas de repositrio no
herdam as alteraes feitas no objeto original.

Criao de Componentes Comerciais usando Atalhos


Para criar um componente comercial de um objeto em uma pasta compartilhada dentro de um repositrio,
arraste o objeto para um diretrio na rvore do componente comercial. O Designer solicita que voc crie um
atalho local. Um atalho local faz referncia a uma origem ou mapplet em uma pasta compartilhada dentro de
um repositrio.
Para criar um componente comercial de um objeto em uma pasta compartilhada de um repositrio global,
conecte-se a ele e arraste o objeto para um diretrio na rvore do componente comercial. O Designer solicita
que voc crie um atalho global. Atalho global um atalho em um repositrio local que faz referncia a um
objeto em uma pasta compartilhada dentro do repositrio global.

Excluso de um Diretrio ou Componente Comercial


Voc pode excluir um diretrio ou componente comercial da rvore de componentes comerciais. A excluso
de um diretrio exclui todos os subdiretrios e componentes comerciais no diretrio. Excluir um diretrio ou
componente comercial no exclui os objetos de repositrio originais.
Para excluir um diretrio de componentes comerciais:
1.

No Designer, conecte-se a um repositrio e abra uma pasta.

2.

Selecione um diretrio de componentes comerciais e clique em Editar > Excluir.


Sugesto: Voc pode excluir um diretrio selecionando-o no Navegador e pressionando a tecla Delete.

204

Captulo 13: Gerenciando Componentes Comerciais

Excluindo um Componente Comercial


Para excluir um componente comercial:
1.

No Designer, conecte-se a um repositrio e abra uma pasta.

2.

Selecione um componente comercial e clique em Editar > Excluir.


Sugesto: possvel excluir um componente comercial selecionando-o no Navegador e pressionando a
tecla Delete.

Copiando um Diretrio ou Componente Comercial


possvel copiar um diretrio de componentes comerciais em outro local na mesma rvore. Tambm
possvel copiar um diretrio de componentes comerciais em uma outra pasta de repositrio ou repositrio.
Cpias de objetos das outras pastas de repositrio no herdam as alteraes feitas no objeto original.
Para copiar um diretrio ou componente comercial:
1.

No Designer, conecte-se ao banco de dados de origem e abra a pasta da qual deseja copiar o diretrio
ou componente comercial.

2.

No Navegador, selecione o objeto a ser copiado.

3.

Clique em Editar > Copiar, ou pressione Ctrl + C.

4.

Se desejar copiar o objeto em um outro repositrio, conecte-se ao repositrio de destino.

5.

Se desejar copiar o objeto em uma outra pasta, abra a pasta de destino.

6.

No Navegador, selecione o local do diretrio de componentes comerciais em que deseja colar o diretrio
ou o componente comercial.

7.

Clique em Editar > Colar ou pressione Ctrl+V.


Sugesto: possvel copiar um diretrio ou componente comercial conectando-se a um repositrio e
pressionando a tecla Control enquanto arrasta o diretrio ou o componente comercial para o n de
componentes comerciais na pasta de destino.

Gerenciando Componentes Comerciais e Diretrios

205

CAPTULO 14

Criando Cubos e Dimenses


Este captulo inclui os seguintes tpicos:

Viso Geral da Criao de Cubos e Dimenses, 206

Criao de uma Dimenso, 208

Criao de um Cubo, 209

Edio de um Cubo, 210

Edio de uma Dimenso, 210

Excluso de Cubo ou Dimenso, 211

Abrindo e Fechando um Cubo, 211

Exibindo Metadados para Cubos e Dimenses, 211

Dicas para Cubos e Dimenses, 212

Viso Geral da Criao de Cubos e Dimenses


O Target Designer fornece uma interface que permite criar e editar cubos e dimenses. Os metadados
multidimensionais recorrem organizao lgica dos dados usada para anlises em aplicativos de
processamento analtico online (OLAP). Essa organizao lgica geralmente especializada para a
representao de dados mais eficiente e acessada por usurios finais do aplicativo OLAP. As sees
seguintes fornecem uma viso geral dos conceitos relevantes aos recursos multidimensionais do
PowerCenter.

Noes Bsicas de Metadados Multidimensionais


O modelo multidimensional um aspecto importante da criao de data warehouse. Um modelo dimensional
bem projetado pode ajud-lo a organizar grandes quantidades de dados. O modelo dimensional foi criado
originalmente para a indstria de varejo, onde analistas exibem dados empresariais em dimenses simples,
como produtos e geografias. Este modelo dimensional consiste em uma grande tabela fato central e tabelas
de dimenses menores. A tabela fato contm fatos mensurveis, como o total das vendas e unidades
vendidas, e separar as dimenses representa os atributos que pertencem vrios segmentos empresariais
da indstria. A tabela fato central a nica tabela no esquema com vrias junes conectando-a s tabelas
de dimenso. Cada tabela de dimenso, por sua vez, possui uma nica juno que se conecta tabela fato
central.
Existem tipos diferentes de modelos multidimensionais, dependendo do grau de redundncia no esquema
lgico. Mais redundncia pode melhorar a eficincia de acesso aos dados, mas representa menos exibio
normalizada do esquema lgico. O tipo mais comum de esquema multidimensional chamado de esquema

206

em estrela. O esquema em estrela um modelo multidimensional normalizado onde cada um de suas


dimenses separadas representada em uma nica tabela.
Um outro tipo de modelo multidimensional normalizado o esquema floco de neve. Um esquema floco de
neve logicamente semelhante a um esquema em estrela, a no ser que pelo menos uma dimenso seja
representada em duas ou mais tabelas relacionadas hierarquicamente. O esquema em estrela pode se
tornar um esquema floco de neve, se a dimenso do produto for representada por meio de vrias tabelas.
Por exemplo, voc poder adicionar uma tabela de dimenso para os atributos do principal produto, uma
para os atributos da marca e outra para os atributos de uma marca especfica.
Os modelos multidimensionais no normalizados possuem atributos duplicados associados dimenso.
Voc pode recuperar rapidamente vrios atributos de uma dimenso, sem ter que realizar vrias junes
entre tabelas na dimenso.

Elementos-chave de Metadados Multidimensionais


A tabela a seguir descreve os principais elementos dos metadados multidimensionais:
Termo

Definio

Agregado

Resumo dos dados pr-armazenados ou agrupamento dos dados detalhados que satisfaz
uma regra comercial especfica da empresa. Exemplo de regras: sum, min, count ou suas
combinaes.

Nvel

Uma propriedade especfica de uma dimenso. Exemplos: tamanho, tipo e cor.

Cubo

Um conjunto de medidas reais, agregaes e dimenses correspondentes para um


problema especfico de anlise dimensional. Exemplo: venda de produtos regionais.

Dimenso

Um conjunto de propriedades de nvel que descreve um aspecto especfico de um


negcio, usado para analisar as medidas reais de um ou mais cubos que usam essa
dimenso. Exemplos: geografia, horrio, cliente e produto.

Sondagem

Sondagem (drilling) o termo usado para navegar por um cubo. Essa navegao
normalmente realizada para acessar um nvel resumido de informaes ou para
oferecer mais detalhes das propriedades em uma hierarquia.

Fato

Um fato uma medida da variante de tempo de dados quantitativos em um cubo. Por


exemplo, unidades vendidas, vendas em dlares ou lucro total.

Hierarquia

O conceito de hierarquia se refere ao nvel de granularidade representado pelos dados


em uma determinada dimenso de um cubo. Por exemplo, estado, condado, distrito e
cidade representam granularidades diferentes na hierarquia da dimenso geogrfica.

Medio

Meios de representar dados quantitativos em fatos ou agregaes. Medidas de exemplo:


venda total ou unidades vendidas por ano.

Normalizao

Um processo usado para reduzir redundncias e remover anomalias nas tabelas de


dimenso correspondentes em vrias hierarquias.

Redundncia

Termo usado para se referir duplicao de dados entre tabelas relacionadas visando o
aumento de velocidade no processamento de consultas.

Viso Geral da Criao de Cubos e Dimenses

207

Termo

Definio

Esquema em
estrela

Um modelo multidimensional normalizado onde cada dimenso separada representada


por uma nica tabela.

Esquema em flocos
de neve

Um modelo multidimensional normalizado onde pelo menos uma dimenso


representada por duas ou mais tabelas relacionadas hierarquicamente.

Criao de uma Dimenso


Ante de voc criar um cubo, necessrio criar as dimenses. Conclua as seguintes etapas para criar uma
dimenso:
1.

Digite uma descrio da dimenso:

2.

Adicionar nveis dimenso.

3.

Adicionar hierarquias dimenso.

4.

Adicione nveis de instncia s hierarquias.

Etapa 1. Criar uma Dimenso


Para criar uma dimenso:
1.

No Target Designer, clique em Destinos > Criar/Editar Dimenso.


O Editor de dimenso exibe.

2.

Clique em Adicionar dimenso.

3.

Digite as seguintes informaes:

Nome. Nomes de dimenso devem ser exclusivos na pasta.

Descrio. Digite uma descrio para a dimenso. Esta descrio aparece no Repository Manager.

Tipo de banco de dados O tipo de banco de dados de uma dimenso deve corresponder ao tipo de
banco de dados do cubo.

Nota: No possvel alterar o tipo de banco de dados aps criar a dimenso.


4.

Clique em OK.

Etapa 2. Adicionar Nveis Dimenso


Depois de criar a dimenso, adicione os nveis desejados. Os nveis contm as propriedades necessrias
para criar as tabelas de destino.
Para adicionar um nvel dimenso.
1.

No Editor de Dimenso, selecione Nveis e clique em Adicionar nvel.

2.

Digite um nome e uma descrio para o nvel.


O nome do Nvel deve ser exclusivo dentro da dimenso.

208

3.

Clique em Propriedades do nvel.

4.

Clique no boto Importar dos Campos de origem.

Captulo 14: Criando Cubos e Dimenses

O nome de uma propriedade de nvel deve ser exclusivo dentro da dimenso.


5.

Selecione a tabela de origem a partir da qual deseja copiar as colunas para o nvel.
As colunas so exibidas na seo Campos de origem.

6.

Selecione as colunas que deseja adicionar ao nvel.

7.

Clique no boto Copiar colunas para adicionar colunas de origem no nvel.

8.

Clique no boto Adicionar colunas para adicionar uma nova coluna no nvel.

9.

Clique em OK depois que voc adicionar todas as colunas.


O Editor de Dimenso exibe o novo nvel.

Etapa 3. Adicionar Hierarquias Dimenso


Para adicionar uma hierarquia dimenso:
1.

No Editor de Dimenso, selecione Hierarquias.

2.

Clique em Adicionar hierarquia.

3.

Digite um nome e uma descrio de hierarquia, e selecione Normalizada ou No normalizada.


Cubos normalizados se restringem a dados redundantes. Cubos normalizados permitem dados
redundantes, o que aumenta a velocidade de recuperao dos dados.

Etapa 4. Adicionar Nveis Hierarquia


Aps criar uma hierarquia, voc adiciona nveis a ela. S possvel haver um nvel raiz em uma hierarquia.
Para adicionar um nvel hierarquia.
1.

No Editor de Dimenses, faa uma busca detalhada para exibir os nveis na dimenso.

2.

Arraste o nvel que deseja definir como o nvel raiz na hierarquia.


O nvel raiz o nvel de granularidade mais refinado.

3.

Insira nome e descrio da tabela de destino.

4.

Clique em OK.
Uma janela exibe uma lista de todos os objetos afetados pelo novo nvel.

5.

Clique em OK.
O novo nvel exibido sob a hierarquia.

Criao de um Cubo
Para criar um cubo:
1.

No Target Designer, clique em Destinos > Criar cubo.

2.

Digite as seguintes informaes:

Nome do cubo. O nome do cubo deve ser exclusivo em uma pasta.

Criao de um Cubo

209

Tipo de cubo. Selecione Normalizado ou No normalizado. As dimenses normalizadas devem ter


um cubo normalizado. Paralelamente, as dimenses no normalizadas devem ter um cubo no
normalizado.

Tipo de banco de dados O tipo de banco de dados para o cubo deve ser compatvel com o tipo de
banco de dados para as dimenses no cubo.

3.

Clique em Avanar.

4.

Especifique as dimenses e hierarquias para incluir no cubo.

5.

Clique em Avanar.

6.

Adicione medidas ao cubo.


Voc pode copiar as colunas das tabelas de origem ou adicionar novas colunas.
Os nomes de medida devem ser exclusivos dentro de um fato. Os nomes de nvel devem ser exclusivos
dentro de cada cubo.

7.

Adicione um nome para a tabela de fato.

8.

Clique em Concluir.
O Designer adiciona as tabelas de cubo e de fato ao espao de trabalho.

Edio de um Cubo
possvel editar um cubo no Target Designer. Voc no pode editar uma tabela de fatos ou dimenses
diretamente. Para editar uma coluna em uma tabela de fatos ou de dimenses,voc precisa editar o cubo ou
a dimenso.
Para editar um cubo:
1.

Clique em Destinos > Editar Cubo.

2.

possvel modificar qualquer configurao na dimenso, exceto as seguintes:

3.

Tipo de banco de dados

Tipo de dimenso (normalizada ou no normalizada)

Clique em Fechar.

Edio de uma Dimenso


possvel editar dimenses no Target Designer. Entretanto, voc no pode mudar o tipo de banco de dados
aps criar uma dimenso.
Quando voc edita uma dimenso, o Designer marca todos os mapeamentos com a dimenso invlida.
Para editar uma dimenso:

210

1.

Clique em Destinos > Criar/Editar Dimenso.

2.

Opcionalmente, modifique qualquer configurao na dimenso, exceto tipo de banco de dados ou tipo
de dimenso.

3.

Clique em Fechar.

Captulo 14: Criando Cubos e Dimenses

Excluso de Cubo ou Dimenso


possvel excluir um cubo ou dimenso do Navegador no Designer. Diferente do que ocorre nas tabelas de
destino, voc no pode excluir cubos e dimenses no Target Designer.
Quando voc exclui um cubo, exclui tambm todas as tabelas associadas a ele. Quando voc exclui uma
dimenso, exclui todas as tabelas e referncias dimenso.
Para excluir um cubo ou dimenso:
1.

No Designer, abra o repositrio.

2.

No Navegador, selecione o cubo ou dimenso que voc deseja excluir.

3.

Clique em Excluir.
Uma mensagem solicita que voc confirme se deseja excluir o cubo ou dimenso.

4.

Clique em OK para excluir o cubo ou a dimenso.

Abrindo e Fechando um Cubo


Voc pode abrir um cubo no Target Designer.
Para abrir um cubo:
1.

Abra um repositrio e abra uma pasta.

2.

Abra o Target Designer.

3.

Selecione o cubo e arraste-o para a rea de trabalho.


Uma mensagem solicita que voc limpe o espao de trabalho.

4.

Clique em OK para abrir o cubo.


O Designer limpa a rea de trabalho e exibe todas as tabelas de dados e dimenses associadas ao
cubo.

Para fechar um cubo no Target Designer, clique em Destinos > Fechar Cubo. O Designer fecha o cubo,
salvando o layout de todas as tabelas.

Exibindo Metadados para Cubos e Dimenses


Voc pode exibir os metadados de cubos e dimenses no Repository Manager.
Para exibir metadados de cubo ou dimenso:
1.

No Repository Manager, abra uma pasta.

2.

Navegue at o cubo ou a dimenso que deseja analisar.


O Repository Manager exibe os metadados para cada objeto.

Excluso de Cubo ou Dimenso

211

Dicas para Cubos e Dimenses


Considere as seguintes dicas ao trabalhar com cubos e dimenses:

212

Se voc deseja copiar um cubo, deve copiar a pasta que o armazena.

Para exibir os nveis de um cubo ou dimenso, voc pode edit-lo ou usar o Navegador no Repository
Manager.

Voc no pode reverter para verses prvias de cubos ou dimenses.

Voc pode excluir um cubo ou dimenso do Navegador.

Voc pode excluir uma dimenso usando Destinos > Criar/Editar Dimenso.

Voc no pode excluir cubos e dimenses do espao de trabalho do Target Designer.

Se voc deseja alterar uma coluna em uma tabela de fatos ou dimenses, deve editar o cubo ou
dimenso. Voc no pode editar uma tabela de fatos ou dimenses diretamente.

Se voc excluir um nvel, o Designer exclui as instncias de nvel associadas nas hierarquias. O Designer
tambm remove a instncia de nvel de qualquer cubo associado.

Uma chave primria gerada para cada tabela de fatos e dimenses. O formato GK_TABLE_NAME.

Uma chave externa adicionada tabela de fatos apropriada quando voc associa uma instncia de
nvel de dimenso tabela de fatos.

Voc pode arrastar um cubo para o espao de trabalho e depois editar o cubo e a cardinalidade, clicando
duas vezes nos links.

Voc no pode excluir ou criar um link entre as tabelas de fatos e dimenses no espao de trabalho.
Voc pode somente excluir e criar links nos Editores de Cubo e Dimenso. Voc pode criar um grfico na
hierarquia.

Captulo 14: Criando Cubos e Dimenses

CAPTULO 15

Usando os Assistentes de
Mapeamento
Este captulo inclui os seguintes tpicos:

Mantendo Esquemas em Estrela, 213

Noes Bsicas de Assistentes de Mapeamento, 214

Criando um Mapeamento de Passagem, 217

Criao de um Mapeamento de Destino de Crescimento Lento, 218

Criao de um Mapeamento de Dimenso de Tipo 1, 221

Criando um Mapeamento de Dimenso Tipo 2/Dados de Verso, 225

Criando um Mapeamento de Dimenso Tipo 2/Sinalizar Atual, 231

Criando um Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo, 237

Criao de um Mapeamento de Dimenso de Tipo 3, 243

Criao de Destinos no Banco de Dados de Destino, 249

Agendando Sesses e Fluxos de Trabalho, 250

Criao de um Mapeamento a partir dos Modelos de Mapeamento Informatica, 251

Mantendo Esquemas em Estrela


Quando voc cria um esquema em estrela, a tabela de fatos criada para informaes coletadas ao longo
do tempo, como compras ou transaes. Depois voc compila tabelas de dimenso separadas para listas de
informaes relacionadas, como inventrio ou mtodos de remessa. Cada tabela de dimenso possui uma
chave primria lgica ou de composio, gerada para habilitar o acesso a dados dimensionais. Por exemplo,
voc poderia usar um inventrio de pea nmero como chave primria ou criar uma chave de composio
usando uma pea nmero e um sinalizador vigente.
Ao implementar um esquema em estrela, decida como lidar com as atualizaes das tabelas de fatos e
dimenso. As tabelas de fatos se alteram regularmente medida que novas informaes so coletadas.
necessrio manter todos os dados existentes na tabela de fatos, ou voc s quer a verso ou a captura de
tela mais recente?
Se voc no precisa de nenhuma informao de fatos histricos, pode descartar ou truncar a tabela de fatos
existente usando uma nova sesso em um fluxo de trabalho. Para manter as informaes histricas em uma
tabela de fatos, normalmente acrescenta-se a ltima captura de tela tabela existente, usando um

213

sinalizador como uma data de carregamento ou nmero um nmero de sesso para identificar a captura de
tela mais recente.
Embora as tabelas de dimenso sejam tipicamente listas estticas, a maioria sofre alterao ao longo do
tempo. Por exemplo, talvez voc precise atualizar a dimenso de inventrio uma vez por ms para refletir as
peas nmero novas e alteradas. Como essas alteraes so menores em magnitude comparada s
alteraes nas tabelas de fatos, elas so conhecidas como dimenses de crescimento lento ou de alterao
lenta.
As dimenses de crescimento lento so tabelas de dimenso que possuem dados de dimenso de aumento
lento sem atualizar as dimenses existentes. Mantenha as dimenses de crescimento lento acrescentando
novos dados tabela existente.
As dimenses de crescimento lento so tabelas de dimenso que possuem dados de dimenso de aumento
lento e que atualiza as dimenses existentes. Ao atualizar as dimenses existentes, decida se mantm todos
os dados histricos, nenhum dado histrico ou apenas as verses dos dados de dimenso atual e anterior.
Se voc no precisa das informaes histricas em uma tabela de dimenso de crescimento lento ou de
alterao lenta, pode descartar ou truncar a tabela existente usando uma nova sesso em um fluxo de
trabalho. No entanto, em alguns casos, inserir novas dimenses e atualizar as dimenses existentes pode
ser mais eficaz do que recarregar a tabela inteira.
Se voc precisa das informaes histricas em uma tabela de dimenso, decida como diferenciar os dados
atuais dos histricos no destino:

Para manter um histrico completo, voc poderia criar uma nova verso dos dados novos:
- Criando um nmero de verso e uma nova verso da chave primria.
- Criando uma chave de composio usando um sinalizador de verso atual.
- Criando um intervalo de datas efetivo.

Para manter um histrico parcial, voc poderia manter uma verso atual e uma anterior em uma nica
linha. Voc tambm pode digitar um carimbo de data/hora para indicar a ltima atualizao.

Noes Bsicas de Assistentes de Mapeamento


O Designer oferece dois assistentes de mapeamento para ajud-lo a criar mapeamentos de maneira rpida e
fcil. Ambos os assistentes foram projetados para criar mapeamentos para carregar e manter esquemas em
estrela, uma srie de dimenses relacionadas a uma tabela central de fatos. possvel, no entanto, usar os
mapeamentos gerados para carregar outros tipos de destinos.
Voc escolhe um outro assistente e outras opes em cada assistente com base no tipo de destino que
deseja carregar e na maneira pela qual deseja tratar dados histricos no destino:

Assistente de Introduo. Cria mapeamentos para carregar tabelas de fatos e dimenses estticas e
tabelas de dimenso de crescimento lento.

Assistente para Dimenses de Alterao Lenta. Cria mapeamentos para carregar tabelas de
dimenses de alterao lenta com base na quantidade de dados de dimenso histrica que voc deseja
manter e no mtodo selecionado para manipular dados de dimenso histrica.

Aps usar um assistente de mapeamento, voc pode editar o mapeamento gerado para personaliz-lo
posteriormente.

214

Captulo 15: Usando os Assistentes de Mapeamento

Usando o Assistente do Guia de Introduo


O Assistente do Guia de Introduo cria mapeamentos para carregar tabelas de fatos e dimenses estticas
e tabelas de dimenso de crescimento lento.
O Assistente do Guia de Introduo pode criar dois tipos de mapeamento:

Passagem. Carrega uma tabela de fatos e dimenses estticas, inserindo todas as linhas. Use este
mapeamento quando deseja descartar todos os dados existentes da tabela, antes de carregar dados
novos.

Destino de crescimento lento. Carrega uma tabela de fatos e dimenses de crescimento lento inserindo
novas linhas. Use este mapeamento para carregar dados novos quando os existentes no exigem
atualizaes.

A tabela a seguir descreve os tipos de mapeamento do Guia de Introduo:


Tipos de
Mapeamento do Guia
de Introduo

Tipo da Tabela de
Destino

Histrico

Manipulao de Dados

Passagem

Fato ou Dimenso
Esttica

Nenhum

Insere todas as linhas de origem. Use a opo


de tabela de destino truncado nas
propriedades da sesso, ou use um comando
shell pr-sesso para descartar ou truncar o
destino antes de cada execuo da sesso.

Destino de crescimento
lento

Fato ou Dimenso
de Crescimento
Lento

Completo

Sinaliza e insere novas linhas ao destino


existente.

Usando o Assistente de Dimenses de Alterao Lenta


O Assistente de Dimenses de Alterao Lenta cria mapeamentos para carregar tabelas de dimenso de
alterao lenta:

Mapeamento de Dimenso Tipo 1. Carrega uma tabela de dimenso de alterao lenta, inserindo novas
dimenses e substituindo as existentes. Use este mapeamento, se voc no quiser um histrico dos
dados de dimenso anterior.

Mapeamento de Dimenso Tipo 2/Dados de Verso. Carrega uma tabela de dimenso de alterao
lenta, inserindo dimenses novas e alteradas que usam um nmero de verso e chave primria
incrementada para rastrear as alteraes. Use este mapeamento, se voc quiser manter um histrico
completo dos dados de dimenso para rastrear a progresso das alteraes.

Mapeamento de Dimenso Tipo 2/Sinalizar Atual. Carrega uma tabela de dimenso de alterao lenta,
inserindo dimenses novas e alteradas que usam um sinalizador para marcar os dados da dimenso
atual verso e uma chave primria incrementada para rastrear as alteraes. Use este mapeamento, se
voc quiser manter um histrico completo dos dados de dimenso, rastreando a progresso das
alteraes enquanto sinaliza somente a dimenso atual.

Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo. Carrega uma tabela de dimenso de
alterao lenta, inserindo dimenses novas e alteradas que usam um intervalo de datas para definir os
dados da dimenso atual. Use este mapeamento, se voc quiser manter um histrico completo dos dados
de dimenso, rastreando as alteraes com um intervalo de datas efetivo.

Mapeamento de Dimenso Tipo 3. Carrega uma tabela de dimenso de alterao lenta inserindo novas
dimenses e atualizando valores em dimenses existentes. Use este mapeamento quando voc quiser
manter os valores atual e anterior da dimenso na tabela de dimenso.

Noes Bsicas de Assistentes de Mapeamento

215

A tabela a seguir descreve os tipos de mapeamento de dimenso de alterao lenta:


Mapeamento de
Dimenses de
Alterao Lenta

Tabela de Destino

Histrico

Manipulao de Dados

Dimenso Tipo 1

Dimenso de
alterao lenta

Nenhuma

Insere novas dimenses. Substitui as


dimenses existentes pelas dimenses
alteradas.

Mapeamento de
Dimenso Tipo 2/
Dados de Verso

Dimenso de
Alterao Lenta

Completo

Insere dimenses novas e alteradas. Cria um


nmero de verso e incrementa a chave
primria para rastrear as alteraes.

Dimenso Tipo 2/
Sinalizar Atual

Dimenso de
Alterao Lenta

Completo

Insere dimenses novas e alteradas. Sinaliza a


verso atual e incrementa a chave primria
para rastrear as alteraes.

Dimenso Tipo 2/
Intervalo de Datas
Efetivo

Dimenso de
Alterao Lenta

Completo

Insere dimenses novas e alteradas. Cria um


intervalo de datas efetivo para rastrear as
alteraes.

Dimenso Tipo 3

Dimenso de
Alterao Lenta

Parcial

Insere novas dimenses. Atualiza os valores


alterados nas dimenses existentes. Como
opo, usa a data de carregamento para
rastrear as alteraes.

Escolha de Origens para os Mapeamentos


Use as origens a seguir com o assistente de mapeamento:

Arquivo simples

Relacional

Aplicativo

Atalho para origens de aplicativo, arquivo simples ou relacional

Voc no pode usar as origens COBOL ou XML com os assistentes de mapeamento.


Ao selecionar uma origem para um mapeamento, os assistentes de mapeamento exibem todas as origens
disponveis por nome de origem. O Designer pode exibir, opcionalmente, as definies de origens e destinos
pelo nome comercial, em vez do nome da origem e destino. Mesmo quando essa opo selecionada, os
assistentes de mapeamento exibem as origens por nome de origem.
O Assistente de Mapeamento no importa uma origem quando um nome de coluna usa uma palavra-chave
SQL. Quando o Assistente de Mapeamento encontra uma palavra-chave SQL usada como um nome de
coluna, ele solicita que voc escolha uma outra origem. Se voc quiser usar uma origem com uma coluna
que usa uma palavra-chave SQL, crie o mapeamento no Mapping Designer.
Com base na origem selecionada, os assistentes de mapeamento tambm concluem:

216

Use o nome de origem para o qualificador de origem, conforme abaixo: SQ_SourceName para origens de
arquivo ou relacionais, ou ASQ_SourceName para origens de Aplicativos.

Crie nomes de porta com base nos nomes da coluna de origem.

Captulo 15: Usando os Assistentes de Mapeamento

Criando um Mapeamento de Passagem


O mapeamento de passagem insere todas as linhas de origem. Use o mapeamento de passagem para
carregar tabelas quando no for necessrio manter dados histricos na tabela de destino. Se as linhas de
origem j existirem no destino, trunque ou descarte o destino existente antes de executar o fluxo de trabalho.
No mapeamento de passagem todas as linhas so atuais.
possvel usar o mapeamento de passagem para carregar uma tabela de dimenses ou de fatos se a tabela
permanecer esttica por um perodo e, em seguida, alterar consideravelmente.
Por exemplo, voc pode ter uma tabela de dimenses de fornecedor que permanece a mesma por um ano.
No final do ano voc recarrega a tabela para refletir novos contratos de fornecedores e informaes de
contato. Se essas informaes forem alteradas consideravelmente e voc no desejar manter informaes
histricas, voc pode descartar a tabela de dimenso existente e usar o mapeamento de passagem para
recarregar toda a tabela. Se as informaes forem alteradas apenas incrementalmente, voc talvez prefira
atualizar a tabela existente usando o mapeamento de Dimenso Tipo 1 criado pelo Assistente para
Dimenses de Alterao Lenta.

Noes Bsicas de Mapeamento


O mapeamento de passagem realiza as seguintes tarefas:

Seleciona todas as linhas de origem

Insere todas as linhas no destino

A figura a seguir mostra um mapeamento que o Assistente de Introduo cria quando voc cria um
mapeamento de passagem:

Um nico fluxo de dados passa de uma definio de origem, atravs de um qualificador de origem e uma
transformao Expresso, para o destino. Por padro, a transformao Expresso passa dados diretamente
para o destino sem alteraes.

Noes Bsicas das Transformaes


A tabela a seguir descreve a funo de cada transformao no mapeamento de passagem:
Nome da
Transformao

Tipo de
Transformao

Descrio

SQ_SourceName

Qualificador de Origem
ou Qualificador de
Origem do Aplicativo

Seleciona todas as linhas a partir da origem que voc


escolher no Assistente de Mapeamento.

EXP_TransformData

Expresso

Transfere todos os dados da origem para o destino, sem


alteraes.

T_TargetName

Definio de destino

Definio de destino que permite que os dados de origem


sejam inseridos no destino.

Criando um Mapeamento de Passagem

217

Etapas para Criar um Mapeamento de Passagem


Para criar um mapeamento de passagem:
1.

No Mapping Designer, clique em Mapeamentos > Assistentes > Guia de Introduo.

2.

Insira um nome de mapeamento, selecione Passagem Simples e clique em Avanar.


A conveno de nomenclatura para nomes de mapeamento m_MappingName.

3.

Selecione uma definio de origem para usar no mapeamento.


Todas as definies de origem disponveis aparecem na lista Selecionar Tabela de Origem. Esta lista
pode incluir origens de Aplicativo, atalhos, arquivo simples e relacionais.

4.

Insira um nome para a tabela de destino do mapeamento e clique em Concluir.


O novo mapeamento aparece no espao de trabalho. A conveno de nomenclatura para definies de
destino T_TARGET_NAME.
Faa as edies necessrias no mapeamento.

Crie a tabela de destino no banco de dados de destino antes de executar um fluxo de trabalho.

Personalizao do Mapeamento
Depois que o assistente cria o mapeamento, voc pode configurar a transformao Expresso,
EXP_TransformData. Tambm possvel adicionar qualquer outra transformao para personalizar o
mapeamento.
Se voc quiser que os dados passem diretamente da origem para o destino sem nenhuma outra
transformao, exclua a transformao Expresso. possvel otimizar o desempenho para passagem de
mapeamentos, conectando o qualificador de origem diretamente ao destino.

Configurando uma Sesso de Passagem


O mapeamento de passagem insere linhas de origem no destino. Para impedir erros de chave primria de
linhas duplicadas, cancele ou trunque a tabela de destino antes de executar o fluxo de trabalho. Use a opo
Truncar Tabela de Destino nas propriedades de sesso ou um comando shell pr-sesso para executar essa
tarefa automaticamente.

Criao de um Mapeamento de Destino de


Crescimento Lento
O mapeamento de destino de crescimento lento filtra as linhas de origem com base nas comparaes
definidas pelo usurio e insere somente as consideradas como novas para o destino. Use o mapeamento de
destino de crescimento lento para determinar quais linhas de origem so novas e para carreg-las para uma
tabela de destino existente. No mapeamento de crescimento lento todas as linhas so atuais.
Use o mapeamento de destino de crescimento lento para carregar um fato de crescimento lento ou uma
tabela de dimenso, uma que os dados existente no exijam atualizaes.
Por exemplo, voc tem uma tabela de dimenso de cdigo de site que contm somente um nome de loja e
um cdigo de site correspondente que voc atualiza somente depois que a empresa abre uma nova loja.
Embora as lojas listadas possam fechar, voc deseja manter o cdigo e o nome da loja na dimenso para
anlise histrica. Com o mapeamento de destino de crescimento lento, voc pode carregar as novas linhas
de origem para a tabela de dimenso de cdigo de site sem excluir sites histricos.

218

Captulo 15: Usando os Assistentes de Mapeamento

Manipulao de Chaves
Quando voc cria um mapeamento de destino de crescimento lento, o Designer cria uma coluna adicional no
destino de mapeamento, PM_PRIMARYKEY. Nessa coluna, o Servio de Integrao gera uma chave
primria para cada linha gravada no destino, incrementando novos valores de chave em 1.

Noes Bsicas de Mapeamento


O mapeamento de destino que cresce lentamente executa as seguintes tarefas:

Seleciona todas as linhas

Armazena em cache o destino existente como uma tabela de pesquisa

Compara as colunas de chaves lgicas na origem com as colunas correspondentes da tabela de


pesquisa do destino

Filtra linhas existentes

Gera uma chave primria para novas linhas

Insere novas linhas no destino

A figura a seguir mostra um mapeamento que o Assistente de Introduo cria quando voc cria um
mapeamento de destino de crescimento lento:

O mapeamento de destino de crescimento lento usa uma transformao Pesquisa e Expresso para
comparar dados de origem com os dados de destino existentes. Ao avanar pelo Assistente de Introduo,
voc insere as colunas de chave lgica na origem para comparar com o destino existente. Quando a
transformao Expresso detecta linhas de origem sem colunas de chave correspondentes no destino, ela
sinaliza a linha como nova.
A transformao Filtro passa somente novas linhas para a transformao Estratgia de Atualizao. A
transformao Estratgia de Atualizao marca novas linhas para inserir e o Gerador de Sequncia cria um
novo valor de chave primria para cada linha gravada no destino.

Criao de um Mapeamento de Destino de Crescimento Lento

219

Noes Bsicas das Transformaes


A tabela a seguir descreve a funo de cada transformao no mapeamento de destino de crescimento
lento:
Nome da
Transformao

Tipo de
Transformao

Descrio

SQ_SourceName

Qualificador de Origem
ou Qualificador de
Origem do Aplicativo

Seleciona todas as linhas a partir da origem que voc


escolher no Assistente de Mapeamento.

LKP_GetData

Pesquisa

Armazena em cache a tabela de destino existente.


Compara uma coluna de chave lgica na origem em
relao coluna de chave correspondente no destino.

EXP_DetectChanges

Expresso

Usa a expresso a seguir para sinalizar linhas de origem


que no tm nenhuma chave correspondente no destino
(indicando que elas so novas):
IIF(ISNULL(PM_PRIMARYKEY),TRUE,FALSE)
Preenche o campo NewFlag com os resultados.
Passa todas as linhas para FIL_InsertNewRecord.

FIL_InsertNewRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer linha


de EXP_DetectChanges que no esteja marcada como
nova (TRUE): NewFlag. Transmite novas linhas para
UPD_ForceInserts.

UPD_ForceInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

SEQ_GenerateKeys

Gerador de Sequncia

Gera um valor para cada nova linha gravada no destino,


com valores de incremento igual a 1.
Passa valores para o destino para preencher a coluna
PM_PRIMARYKEY.

T_TargetName

Definio de destino

A instncia da definio de destino para as novas linhas


que sero inseridas no destino.

Etapas para Criar um Mapeamento de Destino de Crescimento


Lento
Para criar um mapeamento de destino de crescimento lento:
1.

No Mapping Designer, clique em Mapeamentos > Assistentes > Guia de Introduo.

2.

Insira um nome de mapeamento e selecione Destino de Crescimento Lento e clique em Avanar.


A conveno de nomenclatura para nomes de mapeamento m_MappingName.

3.

Selecione uma definio de origem a ser usada no mapeamento.


Todas as definies de origem disponveis aparecem na lista Selecionar Tabela de Origem. Esta lista
inclui origens de Aplicativo, atalhos, arquivo simples e relacionais.

4.

Insira um nome para a tabela de destino do mapeamento. Clique em Avanar.


A conveno de nomenclatura para definies de destino T_TARGET_NAME.

220

Captulo 15: Usando os Assistentes de Mapeamento

5.

Selecione a(s) coluna(s) na lista Campos da Tabela de Destino que voc deseja que o Servio de
Integrao use para procurar dados na tabela de destino. Clique em Add.
O assistente adiciona as colunas selecionadas lista Campos de Chave Lgica.
Sugesto: As colunas selecionadas devem ser colunas de chave na origem.
Quando voc executa um fluxo de trabalho que contm a sesso, o Servio de Integrao executa uma
pesquisa nos dados de destino existentes. O Servio de Integrao retorna dados de destino quando as
colunas Campos de Chave Lgica correspondem s respectivas colunas de destino.
Para remover uma coluna de Campos de Chave Lgica, selecione a coluna e clique em Remover.
Nota: Voc no pode adicionar uma porta usando o nome, FILLER, para a lista de campos de Chave
Lgica.

6.

Clique em Concluir.
O novo mapeamento aparece no espao de trabalho. Faa as edies necessrias no mapeamento.
Nota: A opo Campos para Comparar Alteraes desativada para o mapeamento de destino de
crescimento lento.

Configurando uma Sesso de Destino de Crescimento Lento


O mapeamento lento do destino em crescimento sinaliza novas linhas de origem e as insere no destino com
uma nova chave primria. O mapeamento usa uma transformao Estratgia de Atualizao para indicar que
novas linhas devem ser inseridas. Portanto, quando voc criar uma sesso para o mapeamento, configure a
sesso conforme segue:
1.

Nas propriedades da sesso, clique nas configuraes de Opes Gerais na guia Propriedades.
Configure Tratar Linhas de Origem Como para Controlado por Dados.

2.

Nas propriedades da sesso, clique nas configuraes de Propriedades do Destino na guia


Mapeamento. Para verificar se o Servio de Integrao carrega as linhas corretamente para o destino,
selecione Inserir para cada destino relacional.

Criao de um Mapeamento de Dimenso de Tipo 1


O mapeamento de Dimenso Tipo 1 filtra linhas de origem com base em comparaes definidas pelo usurio
e insere no destino apenas aquelas consideradas novas dimenses no destino. As linhas que contm
alteraes nas dimenses existentes so atualizadas no destino, substituindo a dimenso existente. No
mapeamento de dimenso do tipo 1, todas as linhas contm dados atuais de dimenso.
Use o mapeamento de dimenso do tipo 1 para atualizar a tabela de dimenso de atualizao lenta, quando
voc no precisar manter as verses anteriores das dimenses na tabela.
Por exemplo, talvez voc tenha uma tabela de dimenso de site com cdigo, localidade e despesas gerais
atualizada, depois que a empresa abre uma nova loja. Essa dimenso usada para clculos de vendas e
despesas gerais. Como voc no precisa saber o endereo anterior da mesma loja ou as despesas gerais da
loja no ano anterior, no h necessidade dos dados de dimenso anterior na tabela. Com o mapeamento de
dimenso do tipo 1, voc pode manter os dados atuais sem um log do histrico.

Criao de um Mapeamento de Dimenso de Tipo 1

221

Manipulao de Chaves
Ao usar a opo Dimenso Tipo 1, o Designer cria uma coluna adicional no destino do mapeamento,
PM_PRIMARYKEY. Nessa coluna, o Servio de Integrao gera uma chave primria para cada linha
gravada no destino, incrementando novos valores de chave em 1.

Noes Bsicas de Mapeamento


O mapeamento de Dimenso Tipo 1 executa as tarefas a seguir:

Seleciona todas as linhas.

Armazena em cache o destino existente como uma tabela de pesquisa.

Compara as colunas de chaves lgicas na origem com aquelas correspondentes tabela de pesquisa do
destino.

Compara as colunas de origem com as de destino correspondentes, se as colunas de chaves


corresponderem.

Sinaliza linhas novas e alteradas.

Cria dois fluxos de dados: um para linhas novas e outro para as alteradas.

Gera uma chave primria para novas linhas.

Insere novas linhas no destino.

Atualiza as linhas alteradas no destino, substituindo as linhas existentes.

A figura a seguir mostra um mapeamento que o Assistente para Dimenses de Alterao Lenta cria quando
voc seleciona a opo Dimenso Tipo 1:

O mapeamento de Dimenso Tipo 1 usa uma transformao Pesquisa e uma Expresso para comparar os
dados de origem com os dados de destino existentes. Quando voc segue as etapas do Assistente para
Dimenses de Alterao Lenta, insere as condies de pesquisa (colunas de chave de origem) e as colunas
de origem que o Servio de Integrao deve comparar com o destino existente.
Para cada linha de origem sem uma chave primria correspondente no destino, a transformao Expresso
marca a linha como nova. Para cada linha de origem com uma chave primria correspondente no destino, a
Expresso compara as colunas de origem e destino definidas pelo usurio. Se essas colunas no
corresponderem, a Expresso marca a linha como alterada. Em seguida, o mapeamento se divide em dois
fluxos de dados distintos.
O primeiro fluxo usa a transformao Filtro, FIL_InsertNewRecord, para filtrar as linhas existentes. A
transformao Filtro transfere somente novas linhas para a transformao Estratgia de Atualizao
UPD_ForceInserts. UPD_ForceInserts insere novas linhas no destino e um Gerador de Sequncia cria uma
chave primria para cada linha.

222

Captulo 15: Usando os Assistentes de Mapeamento

No segundo fluxo de dados, a transformao FIL_UpdateChangedRecord Filter permite que somente as


linhas alteradas sejam transferidas para a transformao Estratgia de Atualizao, UPD_ChangedUpdate.
UPD_ChangedUpdate substitui as linhas existentes no destino pelas linhas de origem atualizadas.

Noes Bsicas das Transformaes


A tabela a seguir descreve a funo de cada transformao no mapeamento da Dimenso de Tipo 1:
Nome da
Transformao

Tipo de
Transformao

Descrio

SQ_SourceName

Qualificador de Origem
ou Qualificador de
Origem do Aplicativo

Seleciona todas as linhas a partir da origem que voc


escolher no Assistente de Mapeamento.

LKP_GetData

Pesquisa

Armazena em cache a tabela de destino existente.


Compara as colunas de chaves na origem com aquelas
correspondentes no destino. Quando existem chaves
correspondentes, o LKP_GetData retorna dados de coluna
adicionais do destino para a comparao.
Transfere todas as linhas para EXP_DetectChanges.

EXP_DetectChanges

Expresso

Usa a seguinte expresso para sinalizar linhas de origem


que no tm chaves correspondentes no destino. A
expresso retorna TRUE se uma chave correspondente
no existir no destino e indicar que a linha nova:
IIF(ISNULL(PM_PRIMARYKEY),TRUE,FALSE)
Preenche a porta NewFlag com os resultados.
Usa a seguinte expresso para sinalizar linhas de origem
que tm uma chave correspondente no destino e contm
alteraes nas colunas especificadas. A expresso retorna
TRUE somente se uma chave correspondente existir no
destino (indicando que a linha no nova) e se detectar
uma diferena entre as colunas de origem e destino:
IIF(ISNULL(PM_PRIMARYKEY) AND
(SourceColumnName<>PM_PREV_TargetColumnNam
e) AND (other comparisons) TRUE,FALSE)
Preenche a porta ChangedFlag com os resultados.
Passa todas as linhas para FIL_InsertNewRecord e
FIL_UpdateChangedRecord.

Fluxo de Dados de Linhas Novas


Para cada nova linha na origem, este fluxo de dados cria uma chave primria, define o incio do intervalo de
datas efetivo e insere a linha no destino:

Criao de um Mapeamento de Dimenso de Tipo 1

223

A tabela a seguir descreve o fluxo de dados para as novas linhas:


Nome da
Transformao

Tipo de
transformao

Descrio

FIL_InsertNewRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer linha


de EXP_DetectChanges que no esteja marcada como
nova (TRUE): NewFlag. Transmite novas linhas para
UPD_ForceInserts.

UPD_ForceInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

SEQ_GenerateKeys

Gerador de Sequncia

Gera um valor para cada nova linha gravada no destino,


com valores de incremento igual a 1.
Passa valores para o destino para preencher a coluna
PM_PRIMARYKEY.

T_TargetName

Definio de destino

A instncia da definio de destino para as novas linhas


que sero inseridas no destino.

Fluxo de Dados de Linhas Alteradas


Em cada linha alterada na origem, esse fluxo de dados marca a linha para atualizao e substitui a linha
correspondente no destino.
A tabela a seguir descreve o fluxo de dados para as linhas alteradas:
Nome da Transformao

Tipo de
transformao

Descrio

FIL_UpdateChangedRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer


linha EXP_DetectChanges que no esteja marcada
como alterada (TRUE): ChangedFlag. Passa linhas
alteradas para UPD_ChangedUpdate.

UPD_ChangedUpdate

Estratgia de
Atualizao

Usa DD_UPDATE para sobrescrever as linhas


correspondentes no destino.

T_TargetName1

Definio de destino

A instncia da definio de destino que permite que


linhas alteradas sejam sobrescritas no destino.

Etapas para Criar um Mapeamento de Dimenso Tipo 1


Para criar um mapeamento de destino de crescimento lento, conclua as seguintes etapas.
Para criar um mapeamento de Dimenso Tipo 1:
1.

No Mapping Designer, clique em Mapeamentos > Assistentes > Dimenso de Alterao Lenta.

2.

Insira um nome de mapeamento e selecione Dimenso Tipo 1; clique em Avanar.


A conveno de nomenclatura de mapeamentos m_MappingName.

3.

Selecione uma definio de origem a ser usada pelo mapeamento.


Todas as definies de origem disponveis aparecem na lista Selecionar Tabela de Origem. Esta lista
inclui origens de Aplicativo, atalhos, arquivo simples e relacionais.

224

Captulo 15: Usando os Assistentes de Mapeamento

4.

Insira um nome para a tabela de destino do mapeamento. Clique em Avanar.


A conveno de nomenclatura para definies de destino T_TARGET_NAME.

5.

Selecione a coluna ou as colunas que deseja usar como condio de pesquisa na lista Campos da
Tabela de Destino e clique em Adicionar.
O assistente adiciona as colunas selecionadas lista Campos de Chave Lgica.
Sugesto: As colunas selecionadas devem ser colunas de chave na origem.
Quando voc executa o fluxo de trabalho que contm a sesso, o Servio de Integrao executa uma
pesquisa nos dados de destino existentes. O Servio de Integrao retorna dados de destino quando as
colunas Campos de Chave Lgica correspondem s respectivas colunas de destino.
Para remover uma coluna de Campos de Chave Lgica, selecione a coluna e clique em Remover.

6.

Selecione a coluna ou as colunas cujas alteraes o Servio de Integrao deve comparar e clique em
Adicionar.
O assistente adiciona as colunas selecionadas lista Campos para Comparar Alteraes.
Quando voc executa o fluxo de trabalho que contm a sesso, o Servio de Integrao compara as
colunas na lista Campos para Comparar Alteraes entre as linhas de origem e as linhas de destino
(pesquisa) correspondentes. Se o Servio de Integrao detectar uma alterao, ele marcar a linha
alterada.
Para remover uma coluna da lista, selecione a coluna e clique em Remover.

7.

Clique em Concluir.
O novo mapeamento aparece no espao de trabalho. Faa as edies necessrias nos mapeamentos.
Nota: No mapeamento Dimenso Tipo 1, o Designer usa duas instncias da mesma definio de
destino para permitir insero e atualizao de dados na mesma tabela de destino. Gere apenas uma
tabela de destino no banco de dados de destino.

Configurando uma Sesso Dimenso de Tipo 1


O mapeamento de Dimenso Tipo 1 insere novas linhas com uma chave primria nova e atualiza as linhas
existentes. Ao criar uma sesso para o mapeamento, configure a sesso conforme segue:
1.

Nas propriedades da sesso, clique nas configuraes de Opes Gerais na guia Propriedades.
Configure Tratar Linhas de Origem Como para Controlado por Dados.

2.

Nas propriedades da sesso, clique nas configuraes de Propriedades do Destino na guia


Mapeamento. Para verificar se o Servio de Integrao carrega as linhas corretamente para o destino,
selecione Inserir e Atualizar como Atualizao para cada destino relacional.

Criando um Mapeamento de Dimenso Tipo 2/Dados


de Verso
O mapeamento de Dimenso Tipo 2/Dados de Verso filtra linhas de origem com base em comparaes
definidas pelo usurio e insere tanto dimenses novas quanto dimenses alteradas no destino. As
alteraes so controladas na tabela de destino, com a criao de uma nova verso de chave primria e de
um nmero de verso para cada dimenso na tabela. No destino de Dados de Dimenso/Verso do Tipo 2, a
verso atual de uma dimenso tem o nmero de verso mais alto e a chave primria da dimenso
incrementada ao mximo.

Criando um Mapeamento de Dimenso Tipo 2/Dados de Verso

225

Use o mapeamento de Dimenso Tipo 2/Dados de Verso para atualizar uma tabela de dimenso de
alterao lenta quando desejar manter um histrico completo dos dados de dimenso na tabela. As chaves
primrias com verso e nmeros de verso controlam a ordem das alteraes de cada dimenso.
Quando voc usa essa opo, o Designer cria dois campos adicionais no destino:

PM_PRIMARYKEY. O Servio de Integrao gera uma chave primria para cada linha gravada no
destino.

PM_VERSION_NUMBER. O Servio de Integrao gera um nmero de verso para cada linha gravada
no destino.

Manipulao de Chaves
Em um mapeamento de Dimenso Tipo 2/Dados da Verso, o Servio de Integrao gera um valor de chave
primria novo para cada nova dimenso que ele insere no destino. Uma transformao Expresso
incrementa valores chave em 1.000 para novas dimenses.
Ao atualizar uma dimenso, o Servio de Integrao incrementa a chave primria existente em 1.
Por exemplo, o Servio de Integrao insere a nova linha a seguir com valor chave de 65.000, desde que
esta seja a 65 dimenso na tabela.
PM_PRIMARYKEY

ITEM

STYLES

65000

Sandal

Na prxima vez que voc executar o fluxo de trabalho que contm a sesso, o mesmo item ter um outro
nmero de estilos. O Servio de Integrao cria uma nova linha com informaes de estilo atualizadas e
aumenta a chave existente em 1 para criar uma nova chave de 65.001. As duas linhas esto presentes no
destino, mas a linha com verso de chave superior contm dados de dimenso atuais.
PM_PRIMARYKEY

ITEM

STYLES

65000

Sandal

65001

Sandal

14

Quando voc executa o fluxo de trabalho novamente, o Servio de Integrao incrementa novamente a
chave. A verso de chave superior contm dados de dimenso atuais. O destino mantm um histrico
completo do item e da ordem em que as verses ocorreram.
PM_PRIMARYKEY

ITEM

STYLES

65000

Sandal

65001

Sandal

14

65002

Sandal

17

Numerao das Verses


Alm de criar uma nova verso da chave primria, o Servio de Integrao gera um nmero de verso
correspondente para cada linha inserida no destino. Os nmeros de verso correspondem ao ltimo dgito
na chave primria. Dimenses novas possuem um nmero de verso 0.

226

Captulo 15: Usando os Assistentes de Mapeamento

Por exemplo, nos dados abaixo, as verses so 0, 1 e 2. O nmero de verso mais alto contm os dados de
dimenso atuais.
PM_PRIMARYKEY

ITEM

STYLES

PM_VERSION_NUMBER

65000

Sandal

65001

Sandal

14

65002

Sandal

17

Noes Bsicas de Mapeamento


O mapeamento Dimenso de Tipo 2/Dados de Verso executa as tarefas a seguir:

Seleciona todas as linhas.

Armazena em cache o destino existente como uma tabela de pesquisa.

Compara as colunas de chaves lgicas na origem com aquelas correspondentes tabela de pesquisa do
destino.

Compara as colunas de origem com as de destino correspondentes, se as colunas de chaves


corresponderem.

Sinaliza linhas novas e alteradas.

Cria dois fluxos de dados: um para linhas novas e outro para as alteradas.

Gera uma chave primria e um nmero de verso para novas linhas.

Insere novas linhas no destino.

Incrementa a chave primria e um nmero de verso para linhas alteradas.

Insere linhas alteradas no destino.

A figura a seguir mostra um mapeamento que o Assistente para Dimenses de Alterao Lenta cria quando
voc seleciona a opo Dimenso de Tipo 2/Dados de Verso:

O mapeamento Dimenso de Tipo 2/Dados de Verso usa uma transformao Pesquisa e uma Expresso
para comparar os dados de origem com os de destino existentes. Quando voc segue as etapas do
Assistente para Dimenses de Alterao Lenta, insere as condies de pesquisa (colunas de chave de
origem) e as colunas de origem que o Servio de Integrao deve comparar com o destino existente.
Para cada linha de origem sem uma chave primria correspondente no destino, a transformao Expresso
marca a linha como nova. Para cada linha de origem com uma chave primria correspondente no destino, a
Expresso compara as colunas de origem e destino definidas pelo usurio. Se essas colunas no

Criando um Mapeamento de Dimenso Tipo 2/Dados de Verso

227

corresponderem, a Expresso marca a linha como alterada. Em seguida, o mapeamento divide dois fluxos
de dados.
O primeiro fluxo usa a transformao Filtro, FIL_InsertNewRecord, para filtrar as linhas existentes. A
transformao Filtro transfere somente novas linhas para a transformao Estratgia de Atualizao
UPD_ForceInserts. UPD_ForceInserts insere novas linhas no destino. Um Gerador de Sequncia cria uma
chave primria para cada linha. A transformao Expresso, EXP_KeyProcessing_InsertNew, aumenta o
incremento entre as chaves por 1.000 e cria um nmero de verso 0 para cada nova linha.
No segundo fluxo de dados, a transformao FIL_InsertChangedRecord Filter permite que somente as linhas
alteradas sejam transferidas para a transformao Estratgia de Atualizao, UPD_ChangedInserts.
UPD_ChangedInserts insere linhas alteradas no destino. A transformao Expresso,
EXP_KeyProcessing_InsertChanged, incrementa a chave e o nmero da verso por um.

Noes Bsicas das Transformaes


A tabela a seguir descreve a funo de cada transformao no mapeamento da Dimenso Tipo 2/Dados de
Verso:
Nome da
Transformao

Tipo de
Transformao

Descrio

SQ_SourceName

Qualificador de Origem
ou Qualificador de
Origem do Aplicativo

Seleciona todas as linhas a partir da origem que voc


escolher no Assistente de Mapeamento.

LKP_GetData

Pesquisa

Armazena em cache a tabela de destino existente.


Compara as colunas de chaves na origem com aquelas
correspondentes no destino. Quando existem chaves
correspondentes, o LKP_GetData retorna dados de coluna
adicionais do destino para a comparao.
Transfere todas as linhas para EXP_DetectChanges.

EXP_DetectChanges

Expresso

Usa a seguinte expresso para sinalizar linhas de origem


que no tm chaves correspondentes no destino. A
expresso retorna TRUE se uma chave correspondente
no existir no destino e indicar que a linha nova:
IIF(ISNULL(PM_PRIMARYKEY),TRUE,FALSE)
Preenche a porta NewFlag com os resultados.
Usa a seguinte expresso para sinalizar linhas de origem
que tm uma chave correspondente no destino e contm
alteraes nas colunas especificadas. A expresso retorna
TRUE somente se uma chave correspondente existir no
destino (indicando que a linha no nova) e se detectar
uma diferena entre as colunas de origem e destino:
IIF(ISNULL(PM_PRIMARYKEY) AND
(SourceColumnName<>PM_PREV_TargetColumnNam
e) AND (other comparisons) TRUE,FALSE)
Preenche a porta ChangedFlag com os resultados.
Passa todas as linhas para FIL_InsertNewRecord e
FIL_InsertChangedRecord.

228

Captulo 15: Usando os Assistentes de Mapeamento

Fluxo de Dados de Linhas Novas


A tabela a seguir descreve o fluxo de dados para as novas linhas. Para cada nova linha na origem, esse
fluxo de dados cria uma chave primria e um nmero de verso e, em seguida, o insere no destino:
Nome da
Transformao

Tipo de
transformao

Descrio

FIL_InsertNewRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer linha


de EXP_DetectChanges que no esteja marcada como
nova (TRUE): NewFlag. Transmite novas linhas para
UPD_ForceInserts.

UPD_ForceInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

SEQ_GenerateKeys

Gerador de Sequncia

Gera um valor para cada nova linha gravada no destino,


com valores de incremento igual a 1.
Transmite valores para EXP_KeyProcessing_InsertNew.

EXP_KeyProcessing_I
nsertNew

Expresso

Usa a expresso a seguir para incrementar valores gerados


em 1.000: NEXTVAL * 1.000. Em seguida, passa
valores incrementados para o destino para preencher a
coluna PM_PRIMARYKEY.
Cria um nmero de verso de 0 para cada linha para
preencher a coluna PM_VERSION_NUMBER no destino.

T_TargetName

Definio de destino

A instncia da definio de destino para as novas linhas


que sero inseridas no destino.

Fluxo de Dados de Linhas Alteradas


A tabela a seguir descreve o fluxo de dados para as linhas alteradas. Para cada linha alterada na origem,
esse fluxo de dados incrementa a chave primria existente em uma unidade, cria um nmero de verso
correspondente e insere a linha no destino:
Nome da Transformao

Tipo de
Transformao

Descrio

FIL_InsertChangedRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer


linha EXP_DetectChanges que no esteja marcada
como alterada (TRUE): ChangedFlag. Passa as linhas
alteradas para UPD_ChangedInserts.

UPD_ChangedInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

EXP_KeyProcessing_InsertC
hanged

Expresso

Usa a seguinte expresso para incrementar a chave


primria existente em 1: PM_PRIMARYKEY + 1.
Usa a seguinte expresso para incrementar o nmero
de verso existente em 1: (PM_PRIMARYKEY + 1) %
1.000.

T_TargetName1

Definio de
Destino

A instncia da definio de destino que permite que


linhas alteradas sejam inseridas no destino.

Criando um Mapeamento de Dimenso Tipo 2/Dados de Verso

229

Etapas para Criar um Mapeamento de Dimenso Tipo 2/Dados de


Verso
Para criar um mapeamento de Dimenso Tipo 2/Dados de Verso:
1.

No Mapping Designer, clique em Mapeamentos > Assistentes > Dimenses de Alterao Lenta.

2.

Insira um nome de mapeamento e selecione Dimenso Tipo 2. Clique em Avanar.

3.

Selecione uma definio de origem a ser usada pelo mapeamento.


Todas as definies de origem disponveis aparecem na lista Selecionar Tabela de Origem. A lista inclui
origens de Aplicativo, atalhos, arquivo simples e relacionais.

4.

Insira um nome para a tabela de destino do mapeamento. Clique em Avanar.


A conveno de nomenclatura para definies de destino T_TARGET_NAME.

5.

Selecione a coluna ou as colunas que deseja usar como condio de pesquisa na lista Campos da
Tabela de Destino e clique em Adicionar.
O assistente adiciona as colunas selecionadas lista Campos de Chave Lgica.
Sugesto: As colunas selecionadas devem ser colunas de chave na origem.
Quando voc executa o fluxo de trabalho que contm a sesso, o Servio de Integrao executa uma
pesquisa nos dados de destino existentes. O Servio de Integrao retorna dados de destino quando as
colunas Campos de Chave Lgica correspondem s respectivas colunas de destino.
Para remover uma coluna de Campos de Chave Lgica, selecione a coluna e clique em Remover.

6.

Selecione a coluna ou as colunas cujas alteraes o Servio de Integrao deve comparar e clique em
Adicionar.
O assistente adiciona as colunas selecionadas lista Campos para Comparar Alteraes.
Quando voc executa o fluxo de trabalho que contm a sesso, o Servio de Integrao compara as
colunas na lista Campos para Comparar Alteraes entre as linhas de origem e as linhas de destino
correspondentes. Se o Servio de Integrao detectar uma alterao, ele marcar a linha alterada.
Para remover uma coluna da lista, selecione a coluna e clique em Remover.

7.

Clique em Avanar.

8.

Selecione Keep the Version Number in Separate Column (Manter Nmero da 'Verso' em Coluna
Separada). Clique em Concluir.
Nota: No mapeamento de Dimenso Tipo 2/Dados de Verso, o Designer usa duas instncias da
mesma definio de destino para permitir que os dois fluxos de dados distintos gravem na mesma
tabela de destino. Gere apenas uma tabela de destino no banco de dados de destino.

Personalizao do Mapeamento
Dependendo do nmero de verses que voc espera que os dados da dimenso tenham, possvel reduzir
ou aumentar o incremento que o Servio de Integrao cria entre as chaves geradas. Por padro, o Servio
de Integrao incrementa a sequncia em 1.000. Isto permite 1.000 verses de uma nica dimenso.
Se apropriado, voc pode reduzir ou aumentar o incremento. Para isto, voc edita a transformao
Expresso, EXP_KeyProcessing_InsertNew, depois de criar o mapeamento.
Para alterar o incremento da chave primria:

230

1.

Clique duas vezes na barra de ttulo da transformao de Expresso, EXP_KeyProcessing_InsertNew.

2.

Clique na guia Portas.

3.

Clique no canto extremo direito do campo Expresso da porta PM_PRIMARYKEY.

Captulo 15: Usando os Assistentes de Mapeamento

O Editor de Expresso ser exibido.


4.

Exclua o valor existente (1000) e insira o valor que o Servio de Integrao dever usar quando
incrementar a chave primria. Clique em Validar.

Configurando uma Sesso Dimenso Tipo 2/Dados de Verso


O mapeamento da Dimenso de Tipo 2/Dados de Verso insere linhas novas e atualizadas com uma chave
primria exclusiva. Quando voc configurar uma sesso para o mapeamento, conclua as etapas a seguir:
1.

Nas propriedades da sesso, clique nas configuraes de Opes Gerais na guia Propriedades.
Configure Tratar Linhas de Origem Como para Controlado por Dados.

2.

Nas propriedades da sesso, clique nas configuraes de Propriedades do Destino na guia


Mapeamento. Para verificar se o Servio de Integrao carrega as linhas corretamente para o destino,
selecione Inserir para cada destino relacional.

Criando um Mapeamento de Dimenso Tipo 2/


Sinalizar Atual
O mapeamento de Dimenso/Sinalizador Atual Tipo 2 filtra linhas de origem com base em comparaes
definidas pelo usurio e insere dimenses novas e alteradas no destino. As alteraes so controladas na
tabela de destino, sinalizando a verso atual de cada dimenso e gerao de verso de chave primria. No
destino de Dimenso/Sinalizador Atual Tipo 2, a verso atual de uma dimenso possui um sinalizador
definido como 1 e a chave primria incrementada mais alta.
Use o mapeamento de Dimenso/Sinalizador Atual Tipo 2 para atualizar uma tabela de dimenso de
alterao lenta quando desejar manter um histrico completo dos dados da dimenso na tabela, com os
dados mais atuais sinalizados. As chaves primrias com verso controlam a ordem das alteraes de cada
dimenso.
Quando voc usa essa opo, o Designer cria dois campos adicionais no destino:

PM_CURRENT_FLAG. O Servio de Integrao sinaliza a linha atual como "1" e todas as verses
anteriores como "0".

PM_PRIMARYKEY. O Servio de Integrao gera uma chave primria para cada linha gravada no
destino.

Sinalizao do Valor Atual


O Servio de Integrao gera um sinalizador atual de 1 para cada linha gravada no destino. Esse sinalizador
indica se a dimenso nova ou recm-atualizada. Se a linha for uma atualizao de uma dimenso
existente, o Servio de Integrao redefine a sinalizao atual de dimenso existente para 0.
Como resultado, todas as verses atuais da dimenso aparecem no destino com sinalizao atual de 1.
Todas as verses anteriores tm um sinalizador atual de 0.
Por exemplo, os dados de dimenso a seguir so atuais, pois o sinalizador atual est definido como 1:
ITEM

STYLES

PM_CURRENT_FLAG

Sandal

Criando um Mapeamento de Dimenso Tipo 2/Sinalizar Atual

231

ITEM

STYLES

PM_CURRENT_FLAG

Boot

25

Quando essas dimenses so alteradas, o Servio de Integrao insere as verses atualizadas com o
sinalizador atual de1. O Servio de Integrao tambm atualiza as linhas existentes no destino. Ela localiza
a verso atual anterior (em que o sinalizador atual est definido como 1) e atualiza o sinalizador atual como
0:
ITEM

STYLES

PM_CURRENT_FLAG

Sandal

Boot

25

Sandal

12

Boot

15

Manipulao de Chaves
Ao usar a opo Intervalo de Datas Efetivo, o Servio de Integrao gerar um valor de chave primria para
cada linha gravada no destino, incrementando valores chave em um. Uma transformao Expresso
incrementa valores chave em 1.000 para novas dimenses.
Ao atualizar uma dimenso existente, o Servio de Integrao incrementa a chave primria existente em 1.
Por exemplo, as seguintes dimenses so dados de dimenses atuais (sinalizadores atuais definidos como
um). As respectivas chaves primrias so mltiplos de 1.000. Isso indica que elas so a primeira verso de
uma dimenso:
PM_PRIMARYKEY

ITEM

STYLES

PM_CURRENT_FLAG

3000

Sandal

4000

Boot

25

Quando o Servio de Integrao insere verses atualizadas dessas dimenses no destino, ele define o
sinalizador atual como 1. Ele tambm cria uma nova chave primria para a linha atualizada, incrementando a
chave da dimenso existente em um. O Servio de Integrao indica que a dimenso existente no mais
atual, redefinindo seu sinalizador atual como 0:

232

PM_PRIMARYKEY

ITEM

STYLES

PM_CURRENT_FLAG

3000

Sandal

4000

Boot

25

3001

Sandal

12

4001

Boot

15

Captulo 15: Usando os Assistentes de Mapeamento

Noes Bsicas de Mapeamento


O mapeamento de Dimenso de Tipo 2/Sinalizar Atual executa as tarefas a seguir:

Seleciona todas as linhas.

Armazena em cache o destino existente como uma tabela de pesquisa.

Compara as colunas de chaves lgicas na origem com aquelas correspondentes tabela de pesquisa do
destino.

Compara as colunas de origem com as de destino correspondentes, se as colunas de chaves


corresponderem.

Sinaliza linhas novas e alteradas.

Cria dois fluxos de dados: um para linhas novas e outro para as alteradas.

Gera uma chave primria e um sinalizador atual para novas linhas.

Insere novas linhas no destino.

Incrementa a chave primria existente e define a sinalizao atual das linhas modificadas.

Insere linhas alteradas no destino.

Atualiza verses existentes das linhas modificadas no destino, redefinindo a sinalizao atual para indicar
que a linha no mais atual.

A figura a seguir mostra um mapeamento que a opo Dimenso Tipo 2/Sinalizar Atual cria no Assistente de
Dimenses de Alterao Lenta:

O mapeamento de Dimenso Tipo 2/Sinalizar Atual usa uma transformao Pesquisa e uma Expresso para
comparar os dados de origem com os dados de destino existentes. Quando voc segue as etapas do
Assistente para Dimenses de Alterao Lenta, insere as condies de pesquisa (colunas de chave de
origem) e as colunas de origem que o Servio de Integrao deve comparar com o destino existente.
Para cada linha de origem sem uma chave primria correspondente no destino, a transformao Expresso
marca a linha como nova. Para cada linha de origem com uma chave primria correspondente no destino, a
Expresso compara as colunas de origem e destino definidas pelo usurio. Se essas colunas no
corresponderem, a Expresso marca a linha como alterada. Em seguida, o mapeamento se divide em trs
fluxos de dados.
O primeiro fluxo usa a transformao Filtro, FIL_InsertNewRecord, para filtrar as linhas existentes. A
transformao Filtro transfere somente novas linhas para a transformao Estratgia de Atualizao
UPD_ForceInserts. UPD_ForceInserts insere novas linhas no destino. Um Gerador de Sequncia cria uma

Criando um Mapeamento de Dimenso Tipo 2/Sinalizar Atual

233

chave primria para cada nova linha. A transformao Expresso, EXP_KeyProcessing_InsertNew, aumenta
o incremento entre as chaves em 1.000 e cria um sinalizador atual 1 para cada nova linha.
No segundo fluxo de dados, a transformao FIL_InsertChangedRecord Filter permite que somente as linhas
alteradas sejam transferidas para a transformao Estratgia de Atualizao, UPD_ChangedInserts.
UPD_ChangedInserts insere linhas alteradas no destino. A transformao Expresso,
EXP_KeyProcessing_InsertChanged, incrementa a chave primria em um e cria uma sinalizao atual de 1
para indicar que a linha atualizada contm dados de dimenso atuais.
No terceiro fluxo de dados, para cada linha modificada gravada no destino, a transformao Filtro,
FIL_UpdateChangedRecord, passa a chave primria da verso anterior para a transformao Estratgia de
Atualizao, UPD_ChangedUpdate. UPD_ChangedUpdate atualiza dimenses no destino. A transformao
Expresso, EXP_UpdateChanged, define a sinalizao atual para 0. Isso modifica o status da dimenso
anterior de atual para no atual.

Noes Bsicas das Transformaes


A tabela a seguir descreve a funo de cada transformao no mapeamento da Dimenso Tipo 2/Sinalizar
Atual:
Nome da
Transformao

Tipo de
Transformao

Descrio

SQ_SourceName

Qualificador de
Origem ou
Qualificador de
Origem do
Aplicativo

Seleciona todas as linhas a partir da origem que voc escolher


no Assistente de Mapeamento.

LKP_GetData

Pesquisa

Armazena em cache a tabela de destino existente.


Compara as colunas de chaves na origem com aquelas
correspondentes no destino. Quando existem chaves
correspondentes, o LKP_GetData retorna dados de coluna
adicionais do destino para a comparao.
Transfere todas as linhas para EXP_DetectChanges.

EXP_DetectChanges

Expresso

Usa a seguinte expresso para sinalizar linhas de origem que


no tm chaves correspondentes no destino. A expresso
retorna TRUE se uma chave correspondente no existir no
destino e indicar que a linha nova:
IIF(ISNULL(PM_PRIMARYKEY),TRUE,FALSE)
Preenche a porta NewFlag com os resultados.
Usa a seguinte expresso para sinalizar linhas de origem que
tm uma chave correspondente no destino e contm alteraes
nas colunas especificadas. A expresso retornar TRUE
somente se uma chave correspondente existir no destino (o
que indica que a linha no nova) e se detectar uma diferena
entre as colunas de origem e de destino:
IIF(ISNULL(PM_PRIMARYKEY) AND
(SourceColumnName<>PM_PREV_TargetColumnName)
AND (other comparisons) TRUE,FALSE)
Preenche a porta ChangedFlag com os resultados.
Passa todas as linhas para FIL_InsertNewRecord,
FIL_InsertChangedRecord e FIL_UpdateChangedRecord.

234

Captulo 15: Usando os Assistentes de Mapeamento

Fluxo de Dados de Linhas Novas


A tabela a seguir descreve o fluxo de dados para as novas linhas. Para cada linha nova na origem, este fluxo
de dados cria uma chave primria e o incrementa em 1.000. Ele tambm sinaliza linha atual e a insere no
destino:
Nome da
Transformao

Tipo de
transformao

Descrio

FIL_InsertNewRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer linha


de EXP_DetectChanges que no esteja marcada como
nova (TRUE): NewFlag. Transmite novas linhas para
UPD_ForceInserts.

UPD_ForceInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

SEQ_GenerateKeys

Gerador de Sequncia

Gera um valor para cada nova linha gravada no destino,


com valores de incremento igual a 1.
Transmite valores para EXP_KeyProcessing_InsertNew.

EXP_KeyProcessing_I
nsertNew

Expresso

Usa a expresso a seguir para incrementar valores gerados


em 1.000: NEXTVAL * 1,000. Em seguida, passa
valores incrementados para o destino para preencher a
coluna PM_PRIMARYKEY.
Cria uma identificao atual de 1 em cada linha para
preencher a coluna PM_CURRENT_FLAG no destino.

T_TargetName

Definio de destino

A instncia da definio de destino para as novas linhas


que sero inseridas no destino.

Fluxo de Dados de Linhas Alteradas


A tabela a seguir descreve o fluxo de dados para as linhas alteradas. Para cada linha alterada na origem,
esse fluxo de dados incrementa a chave primria existente em 1, sinaliza a linha atual e a insere no destino:
Nome da Transformao

Tipo de
transformao

Descrio

FIL_InsertChangedRecord

Filtro

Usa a seguinte condio de filtro para filtrar para fora


todas as linhas que no estejam marcadas como
alteradas: ChangedFlag. Passa as linhas alteradas
para UPD_ChangedInserts.

UPD_ChangedInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

EXP_KeyProcessing_InsertC
hanged

Expresso

Usa a seguinte expresso para incrementar a chave


primria existente em 1: PM_PRIMARYKEY + 1.
Cria uma identificao atual de 1 em cada linha para
preencher a coluna PM_CURRENT_FLAG no destino.

T_TargetName2

Definio de destino

A instncia da definio de destino que permite que


linhas alteradas sejam inseridas no destino.

Criando um Mapeamento de Dimenso Tipo 2/Sinalizar Atual

235

Fluxo de Dados para Atualizar Linhas Existentes


A tabela a seguir descreve o fluxo de dados para as linhas existentes. Para cada linha alterada na origem,
este fluxo de dados atualiza a data final da linha correspondente no destino, a fim de indicar que a linha
existente no mais atual:
Nome da Transformao

Tipo de
Transformao

Descrio

FIL_UpdateChangedRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer


linha EXP_DetectChanges que no esteja marcada
como alterada (TRUE): ChangedFlag.
Para cada linha alterada, transfere a chave primria da
verso prvia para UPD_ChangedUpdate.

UPD_ChangedUpdate

Estratgia de
Atualizao

Usa DD_UPDATE para atualizar as linhas existentes no


destino.

EXP_KeyProcessing_Update
Changed

Expresso

Para cada linha alterada, configura


PM_CURRENT_FLAG como 0 para a verso prvia no
destino, indicando que essa verso no mais atual.

T_TargetName3

Definio de
destino

Instncia da definio de destino, que permite


atualizaes s linhas existentes no destino.

Etapas para Criar um Mapeamento de Dimenso Tipo 2/Sinalizar


Atual
Para criar um Mapeamento de Dimenso Tipo 2/Sinalizar Atual:
1.

No Mapping Designer, clique em Mapeamentos > Assistentes > Dimenses de Alterao Lenta.

2.

Insira um nome de mapeamento e selecione Dimenso Tipo 2. Clique em Avanar.


A conveno de nomenclatura de mapeamentos m_MappingName.

3.

Selecione uma definio de origem a ser usada pelo mapeamento.


Todas as definies de origem disponveis aparecem na lista Selecionar Tabela de Origem. Esta lista
inclui origens de Aplicativo, atalhos, arquivo simples e relacionais.

4.

Insira um nome para a tabela de destino do mapeamento. Clique em Avanar.


A conveno de nomenclatura para definies de destino T_TARGET_NAME.

5.

Selecione a coluna ou as colunas que deseja usar como condio de pesquisa na lista Campos da
Tabela de Destino e clique em Adicionar.
O assistente adiciona as colunas selecionadas lista Campos de Chave Lgica.
Sugesto: As colunas selecionadas devem ser colunas de chave na origem.
Quando voc executa a sesso, o Servio de Integrao executa uma pesquisa nos dados de destino
existentes. O Servio de Integrao retorna dados de destino quando as colunas Campos de Chave
Lgica correspondem s respectivas colunas de destino.
Para remover uma coluna de Campos de Chave Lgica, selecione a coluna e clique em Remover.

6.

Selecione a coluna ou as colunas cujas alteraes o Servio de Integrao deve comparar e clique em
Adicionar.
O assistente adiciona as colunas selecionadas lista Campos para Comparar Alteraes.

236

Captulo 15: Usando os Assistentes de Mapeamento

Ao executar a sesso, o Servio de Integrao compara as colunas na lista Campos para Comparar
Alteraes entre as linhas de origem e as linhas de destino (pesquisa) correspondentes. Se o Servio
de Integrao detectar uma alterao, ele marcar a linha alterada.
Para remover uma coluna da lista, selecione a coluna e clique em Remover.
7.

Clique em Avanar. Selecione Marcar o Registro de Dimenso 'Atual' com um Sinalizador.

8.

Clique em Concluir.
O novo mapeamento aparece no espao de trabalho. Faa as edies necessrias nos mapeamentos.
Nota: No mapeamento Dimenso do Tipo 2/Sinalizar Atual, o Designer usa trs instncias da mesma
definio de destino para permitir que os trs fluxos de dados distintos gravem na mesma tabela de
destino. Gere apenas uma tabela de destino no banco de dados de destino.

Configurando uma Sesso Dimenso Tipo 2/Sinalizar Atual


O mapeamento da Dimenso Tipo 2/Sinalizar Atual insere linhas novas e atualizadas com uma chave
primria exclusiva. Ele tambm atualiza linhas existentes no destino. Quando voc configurar uma sesso
para o mapeamento, conclua as etapas a seguir:
1.

Nas propriedades da sesso, clique nas configuraes de Opes Gerais na guia Propriedades.
Configure Tratar Linhas de Origem Como para Controlado por Dados.

2.

Nas propriedades da sesso, clique nas configuraes de Propriedades do Destino na guia


Mapeamento. Para verificar se o Servio de Integrao carrega as linhas corretamente para o destino,
selecione Inserir e Atualizar como Atualizao para cada destino relacional.

Criando um Mapeamento de Dimenso Tipo 2/


Intervalo de Datas Efetivo
O mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo filtra linhas de origem com base em
comparaes definidas pelo usurio e insere tanto dimenses novas quanto dimenses alteradas no destino.
As ateraes so monitoradas na tabela de destino atravs da manuteno de um intervalo de data efetiva
para cada verso de cada dimenso no destino. No destino Dimenso de Tipo 2/Intervalo de Data Efetiva, a
verso atual de uma dimenso tem uma data de incio sem data de trmino correspondente.
Use o mapeamento Dimenso de Tipo 2/Intervalo de Data Efetiva para atualizar uma tabela de dimenso de
alterao lenta quando desejar manter um histrico completo dos dados de dimenso na tabela. Um
intervalo de datas efetivo acompanha o histrico cronolgico das alteraes para cada dimenso.
Quando voc usa essa opo, o Designer cria os seguintes campos adicionais no destino:

PM_BEGIN_DATE. Para cada dimenso nova ou alterada gravadas no destino, o Servio de Integrao
usa a data dos sistema para indicar o incio do intervalo de datas efetivo para a dimenso.

PM_END_DATE. Para cada dimenso que est sendo atualizada, o Servio de Integrao usa as datas
do sistema para indicar o trmino do intervalo de datas efetivo para a dimenso.

PM_PRIMARYKEY. O Servio de Integrao gera uma chave primria para cada linha gravada no
destino.

Criando um Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo

237

Manuteno do Intervalo de Data Efetiva


O Servio de Integrao gera uma data de incio para cada dimenso nova e alterada que ele insere no
destino, usando a data do sistema atual. A data de trmino dessas dimenses NULL.
Sempre que o Servio de Integrao insere uma dimenso alterada, ele atualiza a verso anterior da
dimenso no destino, usando a data do sistema atual para preencher a coluna de data de trmino nula
anterior.
Como resultado, todos os dados da dimenso atual no destino de Dimenso do Tipo 2/Intervalo de Datas
Efetivo ficam com valores nulos na coluna PM_END_DATE. Todas as verses anteriores de dados de
dimenso tm uma data do sistema em PM_END_DATE para indicar o trmino do intervalo de datas efetivo
de cada verso.
Por exemplo, as seguintes dimenses so dados de dimenses atuais, pois as respectivas colunas de data
de trmino so nulas:
PM_PRIMARYKEY

ITEM

STYLES

PM_BEGIN_DATE

PM_END_DATE

4325

Sock

13

9/1/98

5401

Boot

20

10/1/98

Quando o Servio de Integrao encontra verses atualizadas dessas dimenses na origem, ele as insere
no destino, usando a data do sistema para indicar o incio dos respectivos intervalos de datas efetivos e
deixando as datas de trmino nulas.
O Servio de Integrao tambm atualiza as verses existentes no destino, inserido a data do sistema para
finalizar o intervalo de datas efetivo.
PM_PRIMARYKEY

ITEM

STYLES

PM_BEGIN_DATE

PM_END_DATE

4325

Sock

13

9/1/98

6/1/99

5401

Boot

20

10/1/98

6/1/99

6345

Sock

18

6/1/99

6346

Boot

25

6/1/99

Manipulao de Chaves
Ao usar a opo Intervalo de Datas Efetivo, o Servio de Integrao gera um valor de chave primria para
cada linha gravada no destino, incrementando valores chave em um.

Noes Bsicas de Mapeamento


O mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo executa as tarefas a seguir:

238

Seleciona todas as linhas.

Armazena em cache o destino existente como uma tabela de pesquisa.

Compara as colunas de chaves lgicas na origem com aquelas correspondentes tabela de pesquisa do
destino.

Compara as colunas de origem com as de destino correspondentes, se as colunas de chaves


corresponderem.

Captulo 15: Usando os Assistentes de Mapeamento

Sinaliza linhas novas e alteradas.

Cria trs fluxos de dados: uma para as novas linhas, uma para as linhas alteradas, uma para atualizar as
linhas existentes.

Gera uma chave primria e o incio do intervalo de datas em vigor para as novas linhas.

Insere novas linhas no destino.

Gera uma chave primria e o incio do intervalo de datas efetivo para as linhas alteradas.

Insere linhas alteradas no destino.

Atualiza as verses existentes das linhas alteradas no destino, gerando o trmino do intervalo de datas
em vigor para indicar que a linha no mais vigente.

A figura a seguir mostra um mapeamento que a opo Dimenso Tipo 2/Intervalo de Datas Efetivo cria no
Assistente de Dimenses de Alterao Lenta:

O mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo usa uma transformao Pesquisa e uma
Expresso para comparar os dados de origem com os de destino existentes. Quando voc segue as etapas
do Assistente para Dimenses de Alterao Lenta, insere as condies de pesquisa (colunas de chave de
origem) e as colunas de origem que o Servio de Integrao deve comparar com o destino existente.
Para cada linha de origem sem uma chave primria correspondente no destino, a transformao Expresso
marca a linha como nova. Para cada linha de origem com uma chave primria correspondente no destino, a
Expresso compara as colunas de origem e destino definidas pelo usurio. Se essas colunas no
corresponderem, a Expresso marca a linha como alterada. Em seguida, o mapeamento se divide em trs
fluxos de dados.
O primeiro fluxo usa a transformao Filtro, FIL_InsertNewRecord, para filtrar as linhas existentes. A
transformao Filtro transfere somente novas linhas para a transformao Estratgia de Atualizao
UPD_ForceInserts. UPD_ForceInserts insere novas linhas no destino. Um Gerador de Sequncia cria uma
chave primria para cada linha. A transformao Expresso, EXP_KeyProcessing_InsertNew, usa a data do
sistema para indicar o intervalo de datas em vigor. A transformao deixa a data de trmino nula, o que
indica que a nova linha contm dados de dimenso atuais.
No segundo fluxo de dados, a transformao FIL_InsertChangedRecord Filter permite que somente as linhas
alteradas sejam transferidas para a transformao Estratgia de Atualizao, UPD_ChangedInserts.
UPD_ChangedInserts insere linhas alteradas no destino. A transformao Expresso,
EXP_KeyProcessing_InsertChanged, usa a data do sistema para indicar o intervalo de datas efetivo. A
transformao deixa a data de trmino nula, o que indica que a linha alterada contm dados de dimenso
atuais.

Criando um Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo

239

No terceiro fluxo de dados, para cada linha modificada gravada no destino, a transformao Filtro,
FIL_UpdateChangedRecord, passa a chave primria da verso anterior para a transformao Estratgia de
Atualizao, UPD_ChangedUpdate. UPD_ChangedUpdate atualiza linhas no destino. A transformao
Expresso, EXP_UpdateChanged, atualiza a coluna de data de trmino com a data do sistema. Isso altera o
status da dimenso da verso atual para a verso anterior.

Noes bsicas das transformaes


A tabela a seguir descreve a funo de cada transformao no mapeamento da Dimenso Tipo 2/Intervalo
de Datas Efetivo:
Nome da
Transformao

Tipo de
transformao

Descrio

SQ_SourceName

Qualificador de
Origem ou
Qualificador de
Origem do
Aplicativo

Seleciona todas as linhas a partir da origem que voc escolher


no Assistente de Mapeamento.

LKP_GetData

Pesquisa

Armazena em cache a tabela de destino existente.


Compara as colunas de chaves na origem com aquelas
correspondentes no destino. Quando existem chaves
correspondentes, o LKP_GetData retorna dados de coluna
adicionais do destino para a comparao.
Transfere todas as linhas para EXP_DetectChanges.

EXP_DetectChanges

Expresso

Usa a seguinte expresso para sinalizar linhas de origem que


no tm chaves correspondentes no destino. A expresso
retorna TRUE se uma chave correspondente no existir no
destino e indicar que a linha nova:
IIF(ISNULL(PM_PRIMARYKEY),TRUE,FALSE)
Preenche a porta NewFlag com os resultados.
Usa a seguinte expresso para sinalizar linhas de origem que
tm uma chave correspondente no destino e contm alteraes
nas colunas especificadas. A expresso retorna TRUE somente
se uma chave correspondente existir no destino (indicando que
a linha no nova) e se detectar uma diferena entre as
colunas de origem e destino:
IIF(ISNULL(PM_PRIMARYKEY) AND
(SourceColumnName<>PM_PREV_TargetColumnName)
AND (other comparisons) TRUE,FALSE)
Preenche a porta ChangedFlag com os resultados.
Passa todas as linhas para FIL_InsertNewRecord,
FIL_InsertChangedRecord e FIL_UpdateChangedRecord.

240

Captulo 15: Usando os Assistentes de Mapeamento

Fluxo de Dados de Linhas Novas


A tabela a seguir descreve o fluxo de dados para as novas linhas. Para cada nova linha na origem, este fluxo
de dados cria uma chave primria, define o incio do intervalo de datas efetivo e insere a linha no destino:
Nome da
Transformao

Tipo de
Transformao

Descrio

FIL_InsertNewRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer linha


de EXP_DetectChanges que no esteja marcada como
nova (TRUE): NewFlag. Transmite novas linhas para
UPD_ForceInserts.

UPD_ForceInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

SEQ_GenerateKeys

Gerador de Sequncia

Gera um valor para cada nova linha gravada no destino,


com valores de incremento igual a 1.
Transmite valores para EXP_KeyProcessing_InsertNew.

EXP_KeyProcessing_I
nsertNew

Expresso

Transmite os valores gerados para o destino para


preencher a coluna PM_PRIMARYKEY no destino.
Usa SYSDATE para preencher a coluna PM_BEGIN_DATE
no destino, criando o incio do intervalo de datas efetivo.

T_TargetName

Definio de destino

A instncia da definio de destino para as novas linhas


que sero inseridas no destino.

Fluxo de Dados de Linhas Alteradas


A tabela a seguir descreve o fluxo de dados para as linhas alteradas. Para cada linha alterada na origem,
esse fluxo de dados cria uma nova chave primria, define o incio do intervalo de datas efetivo e insere a
linha no destino:
Nome da Transformao

Tipo de
transformao

Descrio

FIL_InsertChangedRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer


linha EXP_DetectChanges que no esteja marcada
como alterada (TRUE): ChangedFlag. Passa as
linhas alteradas para UPD_ChangedInserts.

UPD_ChangedInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

SEQ_GenerateKeys (mesmo
Gerador de Sequncia
acima)

Gerador de Sequncia

Gera um valor para cada linha alterada gravada no


destino, com valores de incremento iguais a 1.
Passa valores para
EXP_KeyProcessing_InsertChanged.

Criando um Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo

241

Nome da Transformao

Tipo de
transformao

Descrio

EXP_KeyProcessing_Insert
Changed

Expresso

Transmite os valores gerados para o destino para


preencher a coluna PM_PRIMARYKEY no destino.
Usa SYSDATE para preencher a coluna
PM_BEGIN_DATE no destino, criando o incio do
intervalo de datas efetivo.

T_TargetName2

Definio de destino

A instncia da definio de destino que permite que


linhas alteradas sejam inseridas no destino.

Fluxo de Dados para Atualizar Linhas Existentes


A tabela a seguir descreve o fluxo de dados para as linhas existentes. Para cada linha alterada na origem,
este fluxo de dados atualiza a data final da linha correspondente no destino, a fim de indicar que a linha
existente no mais atual:
Nome da Transformao

Tipo de
Transformao

Descrio

FIL_UpdateChangedRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer


linha EXP_DetectChanges que no esteja marcada
como alterada (TRUE): ChangedFlag.
Para cada linha alterada, transfere a chave primria
da verso prvia para UPD_ChangedUpdate.

UPD_ChangedUpdate

Estratgia de
Atualizao

Usa DD_UPDATE para atualizar as linhas existentes


no destino.

EXP_CalcToDate

Expresso

Usa SYSDATE para atualizar a coluna


PM_END_DATE na linha de destino existente,
marcando o fim do intervalo da data de efetivao.

T_TargetName3

Definio de destino

Instncia da definio de destino, que permite


atualizaes s linhas existentes no destino.

Etapas para Criar um Mapeamento de Dimenso Tipo 2/Intervalo


de Datas Efetivo
Para criar um mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo:
1.

No Mapping Designer, clique em Mapeamentos > Assistentes > Dimenses de Alterao Lenta.

2.

Insira um nome de mapeamento e selecione Dimenso Tipo 2. Clique em Avanar.


A conveno de nomenclatura de mapeamentos m_MappingName.

3.

Selecione uma definio de origem a ser usada pelo mapeamento.


Todas as definies de origem disponveis aparecem na lista Selecionar Tabela de Origem. Esta lista
inclui origens de Aplicativo, atalhos, arquivo simples e relacionais.

4.

Insira um nome para a tabela de destino do mapeamento. Clique em Avanar.


A conveno de nomenclatura para definies de destino T_TARGET_NAME.

242

Captulo 15: Usando os Assistentes de Mapeamento

5.

Selecione a coluna ou as colunas que deseja usar como condio de pesquisa na lista Campos da
Tabela de Destino e clique em Adicionar.
O assistente adiciona as colunas selecionadas lista Campos de Chave Lgica.
Sugesto: As colunas selecionadas devem ser colunas de chave na origem.
Quando voc executa a sesso, o Servio de Integrao executa uma pesquisa nos dados de destino
existentes. O Servio de Integrao retorna dados de destino quando as colunas Campos de Chave
Lgica correspondem s respectivas colunas de destino.
Para remover uma coluna de Campos de Chave Lgica, selecione a coluna e clique em Remover.

6.

Selecione a coluna ou as colunas cujas alteraes o Servio de Integrao deve comparar e clique em
Adicionar.
O assistente adiciona as colunas selecionadas lista Campos para Comparar Alteraes.
Ao executar a sesso, o Servio de Integrao compara as colunas na lista Campos para Comparar
Alteraes entre as linhas de origem e as linhas de destino correspondentes. Se o Servio de
Integrao detectar uma alterao, ele marcar a linha alterada.
Para remover uma coluna da lista, selecione a coluna e clique em Remover.

7.

Clique em Avanar.

8.

Selecione Marcar dimenso dos registros com seu intervalo de data de efetivao. Clique em Concluir.
O novo mapeamento aparece no espao de trabalho. Faa as edies necessrias nos mapeamentos.
Nota: No mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo, o Designer usa trs instncias da
mesma definio de destino para permitir que os trs fluxos de dados distintos gravem na mesma tabela
de destino. Gere apenas uma tabela de destino no banco de dados de destino.

Configurando uma Sesso Dimenso Tipo 2/Intervalo de Datas


Efetivo
O mapeamento da Dimenso Tipo 2/Intervalo de Datas Efetivo insere linhas novas e atualizadas com uma
chave primria exclusiva. Ele tambm atualiza linhas existentes no destino. Quando voc configurar uma
sesso para o mapeamento, conclua as etapas a seguir:
1.

Nas propriedades da sesso, clique nas configuraes de Opes Gerais na guia Propriedades.
Configure Tratar Linhas de Origem Como para Controlado por Dados.

2.

Nas propriedades da sesso, clique nas configuraes de Propriedades do Destino na guia


Mapeamento. Para verificar se o Servio de Integrao carrega as linhas corretamente para o destino,
selecione Inserir e Atualizar como Atualizao para cada destino relacional.

Criao de um Mapeamento de Dimenso de Tipo 3


O mapeamento de Dimenso Tipo 3 filtra linhas de origem com base em comparaes definidas pelo usurio
e insere no destino apenas aquelas consideradas novas dimenses no destino. Linhas que contm
alteraes em dimenses existentes so atualizadas no destino. Ao atualizar uma dimenso existente, o
Servio de Integrao salva os dados existentes em colunas distintas da mesma linha e substitui os dados
existentes pelas atualizaes. Opcionalmente, o Servio de Integrao insere a data do sistema como
carimbo de data e hora em cada linha que ele insere ou atualiza. No destino de Dimenso Tipo 3, cada
dimenso contm dados de dimenso atuais.

Criao de um Mapeamento de Dimenso de Tipo 3

243

Use o mapeamento de Dimenso Tipo 3 para atualizar uma tabela de dimenso de alterao lenta quando
desejar manter somente verses atuais e anteriores de dados da coluna na tabela. Ambas as verses da
coluna ou das colunas especificadas so salvas na mesma linha.
Quando voc usa essa opo, o Designer cria campos adicionais no destino:

PM_PREV_ColumnName. O Designer gera uma coluna anterior correspondente a cada coluna para a
qual voc deseja dados histricos. O Servio de Integrao mantm a verso anterior de dados de
dimenso nessas colunas.

PM_PRIMARYKEY. O Servio de Integrao gera uma chave primria para cada linha gravada no
destino.

PM_EFFECT_DATE. Um campo opcional. O Servio de Integrao usa a data do sistema para indicar
quando ele cria ou atualiza uma dimenso.

Salvamento de Valores Prvios


Ao percorrer as etapas do Assistente de Dimenses de Alterao Lenta, selecione as colunas nas quais
deseja detectar alteraes. O Designer cria uma coluna adicional para cada coluna selecionada e nomeia a
coluna adicional ColumnName PM_PREV_, depois do original. O Servio de Integrao usa essas colunas
para armazenar os valores de dimenso anteriores.
Quando o Servio de Integrao grava uma nova dimenso no destino, as colunas anteriores permanecem
nulas. Toda vez que o Servio de Integrao atualiza uma dimenso, ele grava os dados existentes na
coluna anterior correspondente, e grava as atualizaes na coluna original. Consequentemente, cada linha
em um destino de Dimenso do Tipo 3 contm dados de dimenso atuais. Cada linha tambm contm
verses anteriores dos dados de dimenso, se a dimenso for alterada.
Por exemplo, a primeira vez que o Servio de Integrao grava as dimenses a seguir no destino, a coluna
anterior, PM_PREV_STYLES, permanece nula:
PM_PRIMARYKEY

ITEM

STYLES

PM_PREV_STYLES

6345

Sock

20

6346

Boot

25

Quando o Servio de Integrao atualiza essas linhas, ele grava os valores na coluna STYLES (20 e 25) em
PM_PREV_STYLES e substitui os dados de estilo pelos novos dados de estilo (14 e 31):
PM_PRIMARYKEY

ITEM

STYLES

PM_PREV_STYLES

6345

Sock

14

20

6346

Boot

31

25

Manipulao de Chaves
No mapeamento de Dimenso Tipo 3, o Servio de Integrao gera um valor de chave primria para cada
linha nova gravada no destino, incrementando valores de chave em um. As linhas atualizadas mantm os
valores de chave originais.

Marcao da Data Efetiva


O mapeamento da Dimenso de Tipo 3 pode, opcionalmente, registrar a data em que o Servio de
Integrao cria ou atualiza uma dimenso. Se voc escolher esta opo, o Designer cria a coluna

244

Captulo 15: Usando os Assistentes de Mapeamento

PM_EFFECT_DATE. O Servio de Integrao insere a data do sistema nesta coluna cada vez que ele cria
uma nova linha ou atualiza uma linha.

Noes Bsicas de Mapeamento


O mapeamento de Dimenso Tipo 3 executa as tarefas a seguir:

Seleciona todas as linhas.

Armazena em cache o destino existente como uma tabela de pesquisa.

Compara as colunas de chaves lgicas na origem com aquelas correspondentes tabela de pesquisa do
destino.

Compara as colunas de origem com as de destino correspondentes, se as colunas de chaves


corresponderem.

Sinaliza linhas novas e alteradas.

Cria dois fluxos de dados: uma para linhas novas, outra para linhas alteradas.

Gera uma chave primria e anota opcionalmente a data efetiva de novas linhas.

Insere novas linhas no destino.

Grava valores anteriores para cada linha modificada em colunas anteriores e substitui valores anteriores
por valores atualizados.

Opcionalmente, usa a data do sistema para anotar a data efetiva de valores inseridos e atualizados.

Atualiza linhas alteradas no destino.

A figura a seguir mostra um mapeamento que a opo Tipo 3 Dimenso no Assistente de Dimenses de
Alterao Lenta cria:

O mapeamento de Dimenso Tipo 3 usa uma transformao Pesquisa e uma Expresso para comparar os
dados de origem com os dados de destino existentes. Quando voc segue as etapas do Assistente para
Dimenses de Alterao Lenta, insere as condies de pesquisa (colunas de chave de origem) e as colunas
de origem que o Servio de Integrao deve comparar com o destino existente. O Designer cria colunas
adicionais para que as colunas modificadas mantenham dados histricos.
Para cada linha de origem sem uma chave primria correspondente no destino, a transformao Expresso
marca a linha como nova. Para cada linha de origem com uma chave primria correspondente no destino, a
Expresso compara as colunas de origem e destino definidas pelo usurio. Se essas colunas no
corresponderem, a Expresso marca a linha como alterada. Em seguida, o mapeamento divide dois fluxos
de dados.
O primeiro fluxo de dados usa a transformao Filtro, FIL_InsertNewRecord, para filtrar linhas. A
transformao Filtro transfere somente novas linhas para a transformao Estratgia de Atualizao

Criao de um Mapeamento de Dimenso de Tipo 3

245

UPD_ForceInserts. UPD_ForceInserts insere novas linhas no destino. Um Gerador de Sequncia cria uma
chave primria para cada linha. Se voc selecionar a opo Data Efetiva no assistente de mapeamento, o
Designer criar uma transformao Expresso, EXP_EffectiveDate_InsertNew. O Servio de Integrao usa
a data do sistema para indicar quando ele cria ou atualiza uma nova linha.
No segundo fluxo de dados, a transformao FIL_UpdateChangedRecord Filter permite que somente as
linhas alteradas sejam transferidas para a transformao Estratgia de Atualizao, UPD_ChangedInserts.
Alm disso, a transformao Filtro atualiza a linha modificada: ela utiliza as novas verses de dados do
qualificador de origem e usa verses existentes de dados de dimenso (passados da transformao
Pesquisa) para preencher os campos de colunas anteriores. UPD_ChangedInserts insere linhas alteradas no
destino. Se voc selecionar a opo Data Efetiva no assistente de mapeamento, o Designer criar uma
transformao Expresso, EXP_EffectiveDate_InsertChanged. O Servio de Integrao usa a data do
sistema para indicar quando ele atualiza uma linha.

Noes Bsicas das Transformaes


A tabela a seguir descreve a funo de cada transformao no mapeamento da Dimenso de Tipo 3:
Nome da
Transformao

Tipo de
Transformao

Descrio

SQ_SourceName

Qualificador de
Origem ou
Qualificador de
Origem do Aplicativo

Seleciona todas as linhas a partir da origem que voc escolher


no Assistente de Mapeamento.

LKP_GetData

Pesquisa

Armazena em cache a tabela de destino existente.


Compara as colunas de chaves na origem com aquelas
correspondentes no destino. Quando existem chaves
correspondentes, o LKP_GetData retorna dados de coluna
adicionais do destino para a comparao.
Transfere todas as linhas para EXP_DetectChanges.

EXP_DetectChanges

Expresso

Usa a seguinte expresso para sinalizar linhas de origem que


no tm chaves correspondentes no destino. A expresso
retorna TRUE se uma chave correspondente no existir no
destino e indicar que a linha nova:
IIF(ISNULL(PM_PRIMARYKEY),TRUE,FALSE)
Preenche a porta NewFlag com os resultados.
Usa a seguinte expresso para sinalizar linhas de origem que
tm uma chave correspondente no destino e contm
alteraes nas colunas especificadas. A expresso retorna
TRUE somente se uma chave correspondente existir no
destino (indicando que a linha no nova) e se detectar uma
diferena entre as colunas de origem e destino:
IIF(ISNULL(PM_PRIMARYKEY) AND
(SourceColumnName<>PM_PREV_TargetColumnName)
AND (other comparisons) TRUE,FALSE)
Preenche a porta ChangedFlag com os resultados.
Passa todas as linhas para FIL_InsertNewRecord e
FIL_UpdateChangedRecord.

246

Captulo 15: Usando os Assistentes de Mapeamento

Fluxo de Dados de Linhas Novas


A tabela a seguir descreve o fluxo de dados para as novas linhas. Para cada nova linha na origem, esse
fluxo de dados cria uma chave primria, opcionalmente registra a data de carregamento e insere a linha no
destino:
Nome da
Transformao

Tipo de
transformao

Descrio

FIL_InsertNewRecord

Filtro

Usa a seguinte condio de filtro para filtrar qualquer linha


de EXP_DetectChanges que no esteja marcada como
nova (TRUE): NewFlag. Transmite novas linhas para
UPD_ForceInserts.

UPD_ForceInserts

Estratgia de
Atualizao

Usa DD_INSERT para inserir linhas no destino.

SEQ_GenerateKeys

Gerador de Sequncia

Gera um valor para cada nova linha gravada no destino,


com valores de incremento igual a 1.
Passa linhas atualizadas para
EXP_KeyProcessing_InsertNew, se voc selecionou a
opo Data Efetiva do Assistente de Mapeamento. Caso
contrrio, transmite valores para o destino para preencher
a coluna PM_PRIMARYKEY.

EXP_KeyProcessing_I
nsertNew

Expresso

Criado apenas quando voc seleciona a opo Data Efetiva


no Assistente de Mapeamento.
Transmite os valores gerados para o destino para
preencher a coluna PM_PRIMARYKEY no destino.
Usa SYSDATE para preencher a coluna
PM_EFFECT_DATE no destino, indicando quando a linha
criada.

T_TargetName

Definio de destino

A instncia da definio de destino para as novas linhas


que sero inseridas no destino.

Criao de um Mapeamento de Dimenso de Tipo 3

247

Fluxo de Dados para Atualizar Linhas Existentes


A tabela a seguir descreve o fluxo de dados para as linhas existentes. Para cada linha alterada na origem,
este fluxo de dados atualiza a linha correspondente no destino, copiando os dados existente nas colunas
anteriores, atualizando novos dados e anotando opcionalmente a data em que a linha foi alterada:
Nome da Transformao

Tipo de
Transformao

Descrio

FIL_UpdateChangedRecord

Filtro

Usa a seguinte condio de filtro para filtrar


qualquer linha EXP_DetectChanges que no esteja
marcada como alterada (TRUE): ChangedFlag.
Usa valores retornados de LKP_GetData para
preencher as colunas anteriores.
Passa linhas alteradas para UPD_ChangedUpdate.

UPD_ChangedUpdate

Estratgia de
Atualizao

Usa DD_UPDATE para atualizar as linhas


existentes no destino.
Passa linhas atualizadas para
EXP_EffectiveDate_InsertChanged, se voc
selecionou a opo Data Efetiva do Assistente de
Mapeamento. Do contrrio, passa linhas
atualizadas para o destino.

EXP_EffectiveDate_InsertChanged

Expresso

Criado apenas quando voc seleciona a opo


Data Efetiva no Assistente de Mapeamento.
Usa SYSDATE para preencher a coluna
PM_EFFECT_DATE no destino, indicando quando
a linha atualizada.

T_TargetName2

Definio de
destino

Instncia da definio de destino, que permite


atualizaes s linhas existentes no destino.

Etapas para Criar um Mapeamento de Dimenso Tipo 3


Para criar um mapeamento de Dimenso Tipo 3:
1.

No Mapping Designer, clique em Mapeamentos > Assistentes > Dimenses de Alterao Lenta.

2.

Insira um nome de mapeamento e selecione Dimenso Tipo 3. Clique em Avanar.


A conveno de nomenclatura de mapeamentos m_MappingName.

3.

Selecione uma definio de origem a ser usada pelo mapeamento.


Todas as definies de origem disponveis aparecem na lista Selecionar Tabela de Origem. Esta lista
inclui origens de Aplicativo, atalhos, arquivo simples e relacionais.

4.

Insira um nome para a tabela de destino do mapeamento. Clique em Avanar.


A conveno de nomenclatura para definies de destino T_TARGET_NAME.

5.

Selecione a coluna ou as colunas que deseja usar como condio de pesquisa na lista Campos da
Tabela de Destino e clique em Adicionar.
O assistente adiciona as colunas selecionadas lista Campos de Chave Lgica.
Sugesto: As colunas selecionadas devem ser colunas de chave na origem.

248

Captulo 15: Usando os Assistentes de Mapeamento

Quando voc executa a sesso, o Servio de Integrao executa uma pesquisa nos dados de destino
existentes. O Servio de Integrao retorna dados de destino quando as colunas Campos de Chave
Lgica correspondem s respectivas colunas de destino.
Para remover uma coluna de Campos de Chave Lgica, selecione a coluna e clique em Remover.
6.

Selecione a coluna ou as colunas cujas alteraes o Servio de Integrao deve comparar e clique em
Adicionar.
O assistente adiciona as colunas selecionadas lista Campos para Comparar Alteraes.
Ao executar a sesso, o Servio de Integrao compara as colunas na lista Campos para Comparar
Alteraes entre as linhas de origem e as linhas de destino (pesquisa) correspondentes. Se o Servio
de Integrao detectar uma alterao, ele marcar a linha alterada.
Nota: Selecione as colunas para as quais deseja manter os valores anteriores. Para manter os valores
anteriores no destino, o Designer cria uma coluna adicional para cada coluna na lista. Ele nomeia as
colunas PM_PREV_ColumnName.
Para remover uma coluna da lista, selecione a coluna e clique em Remover.

7.

Clique em Avanar.

8.

Se desejar que o Servio de Integrao insira um carimbo de data e hora nas linhas novas e nas
alteradas, selecione Data Efetiva.
O assistente exibe as colunas que o Servio de Integrao compara e o nome da coluna para
armazenar valores histricos.

9.

Clique em Concluir.
Nota: No mapeamento Dimenso Tipo 3, o Designer usa duas instncias da mesma definio de
destino para permitir que os dois fluxos de dados distintos gravem na mesma tabela de destino. Gere
apenas uma tabela de destino no banco de dados de destino.

Configurando uma Sesso Dimenso de Tipo 3


O mapeamento da Dimenso Tipo 3 insere novas linhas e atualiza linhas existentes no destino. Quando
voc configurar uma sesso, execute as etapas a seguir:
1.

Clique nas configuraes Opes Gerais da guia Propriedades. Configure Tratar Linhas de Origem
Como para Controlado por Dados.

2.

Clique nas configuraes Propriedades de Destino da guia Mapeamentos. Para verificar se o Servio de
Integrao carrega as linhas corretamente para o destino, selecione Inserir e Atualizar como
Atualizao para cada destino relacional.

Criao de Destinos no Banco de Dados de Destino


Os assistentes de mapeamento criam uma nova definio de destino com base nas colunas da definio de
origem e nas opes selecionadas. Isso garante que a tabela de destino resultante contm as colunas
necessrias para o mapeamento. Por padro, a definio de destino resultante possui:

O mesmo tipo de banco de dados do repositrio.

Os mesmos nomes de coluna, as mesmas definies, descries e restries de chave da definio de


origem.

Quaisquer colunas adicionais necessrias para controlar ou atualizar as alteraes.

Criao de Destinos no Banco de Dados de Destino

249

Depois que o assistente criar uma definio de destino para o mapeamento, use o Target Designer para
criar a tabela de destino no banco de dados de destino antes de executar a sesso.
Se os tipos do repositrio e do banco de dados de destino diferirem, altere o tipo de banco de dados da
definio de destino para corresponder ao banco de dados de destino antes de gerar o destino.

Agendando Sesses e Fluxos de Trabalho


Aps criar mapeamentos para carregar os esquemas em estrela, crie sesses e fluxos de trabalho para
executar os mapeamentos. Para verificar se o Servio de Integrao carrega cada tabela de forma correta,
configure cada sesso de acordo com o tipo de mapeamento criado.
Para verificar se as tabelas de fatos contm os dados mais recentes, atualize todas as tabelas de dimenso
antes de carregar a tabela de fatos. Voc pode fazer isso criando um fluxo de trabalho que executa as
sesses de dimenso antes de executar a sesso de fato.
Para verificar se todas as sesses de dimenso foram concludas com xito antes do Servio de Integrao
executar uma sesso de fato, use a seguinte lgica de fluxo de trabalho:
1.

Coloque todas as sesses de dimenso no fluxo de trabalho antes da sesso de fato.

2.

Vincule todas as sesses de dimenso a uma tarefa Deciso.

3.

Defina a seguinte condio de deciso:


$<session_name1>.Status = SUCCEEDED AND $<session_name2>.Status = SUCCEEDED AND ...
$<session_nameN>.Status = SUCCEEDED

4.

Coloque a sesso de fato no fluxo de trabalho aps a tarefa Deciso e vincule a tarefa Deciso
sesso de fato.

5.

Configure a seguinte condio de vnculo da tarefa Deciso sesso de fato:


$<Decision_name>.Condition = TRUE

Por exemplo, voc cria trs sesses que carregam dados em tabelas de dimenso e uma sesso que
carrega dados em uma tabela de fatos.
A figura a seguir mostra a fluxo de trabalho que pode ser criado:

Defina a seguinte condio de deciso para a tarefa Deciso sess_successful:


$s_dimension1.Status = SUCCEEDED AND $s_dimension2.Status = SUCCEEDED AND
$s_dimension3.Status = SUCCEEDED
Defina a seguinte condio de vnculo para o vnculo da tarefa Deciso sesso de fato s_fact:
$sess_successful.Condition = TRUE
Para melhorar o desempenho do fluxo de trabalho, execute as sesses de dimenso simultaneamente.
Organize as sesses no fluxo de trabalho para iniciar ao mesmo tempo. Se o Servio de Integrao no

250

Captulo 15: Usando os Assistentes de Mapeamento

conseguir iniciar e executar todas as sesses de dimenso simultaneamente devido ao carregamento de


sesso existente, voc poder executar as sesses de dimenso sequencialmente, organizando-as
simultaneamente no fluxo de trabalho.
Se voc tiver uma tabela de dimenso que no precisa ser recarregada sempre que o fluxo de trabalho for
executado, poder desabilitar essa sesso.f

Criao de um Mapeamento a partir dos Modelos de


Mapeamento Informatica
Modelos de mapeamento Informatica so modelos de mapeamento predefinidos que cobrem padres de
data warehousing comuns. Dimenses de Alterao Lenta, Remover Duplicados e Carregamento
Incremental so padres de data warehousing para os quais a Informatica oferece modelos de mapeamento.
Esses modelos oferecem solues para problemas comuns nos designs de data warehousing. Voc pode
usar os modelos de mapeamento predefinidos para documentar mtodos, a fim de mapear ou processar
dados.
Use o Assistente de Importao de Modelo de Mapeamento para especificar nome de mapeamento,
descrio e valores de parmetro para cada mapeamento que desejar criar do modelo de mapeamento da
Informatica.
Nota: Ao usar novamente um arquivo de parmetro, verifique se o arquivo de parmetro e o modelo de
mapeamento pertencem ao mesmo tipo de parmetro.
Para criar um mapeamento dos assistentes de modelo de mapeamento, conclua as seguintes tarefas:
1.

Selecione o modelo de mapeamento.

2.

Especifique os detalhes de mapeamento e os valores de parmetro:

3.

Crie os mapeamentos e salve os valores de parmetro.

4.

Importe os mapeamentos para o repositrio.

Etapa 1. Selecionar o Modelo de Mapeamento


Na primeira etapa do Assistente de Modelo de Mapeamento, selecione o modelo que deseja usar.
Para iniciar o Assistente de Modelo de Mapeamento:
1.

Abra o Designer e conecte-se ao repositrio.

2.

Abra a pasta que contm os objetos de origem e destino ou um atalho para os objetos de origem e
destino que voc deseja usar nos mapeamentos importados.

3.

Selecione Mapeamento> Assistentes de Modelo de Mapeamento e selecione o modelo de mapeamento


que voc deseja usar.
O Assistente de Importao de Modelo de Mapeamento exibido.

4.

Para usar um arquivo de parmetro de modelo de mapeamento existente, clique em Usar Existente.
Navegue at o local em que o arquivo de parmetro est armazenado e ento selecione o arquivo.
Por padro, os arquivos de parmetro esto armazenados no diretrio a seguir:
C:\Documents and Settings\<current user>\Local Settings\Temp

Criao de um Mapeamento a partir dos Modelos de Mapeamento Informatica

251

Etapa 2. Especificar Detalhes e Valores de Parmetro do


Mapeamento
Voc pode especificar os valores de parmetro para cada mapeamento que deseja gerar.
Para especificar os detalhes de mapeamento e os valores de parmetro:
1.

Na primeira pgina do Assistente de Importao de Modelo de Mapeamento, clique no boto Adicionar.

2.

No campo MappingName, insira um nome para o mapeamento.

3.

Ou ento, insira uma descrio.

4.

Clique no boto Abrir no campo Parmetros/Valores.

5.

Insira as seguintes informaes na caixa de dilogo Parmetros para o Mapeamento:


Campo

Descrio

Tabela de Origem

Todas as definies de origem disponveis do diretrio de trabalho


atual.

Condio de Extrao
Incremental

Condio de extrao incremental. Por exemplo, insira UPDATETS>SYSDATE-1 como condio de extrao incremental.

Criar Tabela de Destino

Cria uma tabela de destino em vez de usar uma das existentes.


O tipo do banco de dados de destino ser igual ao de origem.

Tabela de Destino

Todas as definies de destino disponveis na pasta de repositrio.

Chave Substituta

Chave primria da tabela de destino.

Campos da Chave Lgica

Colunas da tabela de origem que identificam uma entidade especfica.

Campos da Chave de
Comparao

Conjunto de campos que identificam uma linha alterada entre as


tabelas de origem e destino.

O campo Tipos de Banco de Dados mostra o tipo do banco de dados que voc selecionou. No
possvel desabilitar essa opo.
6.

Se voc usa uma tabela de destino existente, configure a associao do campo. Para isso, clique em
Configurar Associao dos Campos.

7.

Na caixa de dilogo Associao de Campo, clique no boto Adicionar.

8.

Selecione o campo de origem na lista Campos de Origem.

9.

Selecione o campo de destino na lista Campos de Destino.

10.

Na caixa de dilogo Associao de Campo, clique em OK.

11.

Na caixa de dilogo Parmetros para o Mapeamento, clique em OK.

12.

No Assistente de Importao de Modelo de Mapeamento, clique em Avanar.


A segunda pgina do Assistente de Importao de Modelo de Mapeamento exibe a lista de
mapeamentos que voc configurou.

Etapa 3. Criar Mapeamentos e Salvar Valores de Parmetro


Voc pode selecionar os mapeamentos que deseja gerar. Para salvar os valores de parmetros do
mapeamento selecionado, reutilize o arquivo de parmetro do modelo de mapeamento e crie mais

252

Captulo 15: Usando os Assistentes de Mapeamento

mapeamentos. O assistente salva os valores de parmetro de cada mapeamento selecionado no arquivo de


parmetro do modelo de mapeamento.
Nota: Salve os valores de parmetro em um arquivo de parmetro de modelo de mapeamento. Se voc
salvar o arquivo de parmetro de um mapeamento e ocorrer um erro ao gerar esse mapeamento, voc pode
recuperar as configuraes de valor de parmetro.
Para criar os mapeamentos e salvar os valores de parmetro:
1.

Quando a lista de mapeamentos for exibida, selecione os que voc deseja gerar.

2.

Para criar um mapeamento com vrios pipelines, clique em Criar vrios pipelines e um nico
mapeamento e digite um nome para o mapeamento.

3.

Clique em Salvar valores de parmetro dos mapeamentos selecionados, e clique em Procurar para
navegar at a pasta onde voc deseja salvar o arquivo de parmetro.
Por padro, a funo Modelo de Publicao cria um modelo de arquivo de parmetro no mesmo local
que o arquivo de modelo de mapeamento. Voc pode escolher entre substituir o arquivo existente ou
criar um arquivo de parmetro de modelo de mapeamento.

4.

Clique em Avanar.
O assistente solicita que voc exporte as definies de tabela.

5.

Clique em Sim.
A caixa de dilogo Exportar objeto exibida e as definies de tabela so exportadas para o local
padro.

6.

Clique em Fechar na caixa de dilogo Exportar objetos.

Etapa 4. Importar Mapeamentos para o Repositrio


Voc pode importar os mapeamentos para o Repositrio usando essas etapas.
Para importar os mapeamentos para o repositrio:
1.

Reveja a lista de mapeamentos para verificar se o assistente gerou a quantidade correta de


mapeamentos.
A opo para criar fluxos de trabalho e sesses para os mapeamentos selecionada por padro.

2.

Para iniciar o Assistente de Gerao de Fluxo de Trabalho, clique em Avanar. Para obter mais
informaes sobre o Assistente de Gerao de Fluxo de Trabalho, consulte Usando o Assistente de
Gerao de Fluxo de Trabalho na pgina 138.
Para desabilitar a opo para criar fluxos de trabalho e sesses para os mapeamentos, clique em
Concluir.
Os mapeamentos gerados so exibidos no n dos mapeamentos da pasta de repositrio selecionada:

Criao de um Mapeamento a partir dos Modelos de Mapeamento Informatica

253

APNDICE A

Referncia do Tipo de Dados


Este apndice inclui os seguintes tpicos:

Viso Geral de Referncia de Tipo de Dados, 254

Tipos de Dados de Transformao, 255

IBM DB2 e Tipos de Dados de Transformao, 260

Informix e Tipos de Dados de Transformao, 261

Microsoft SQL Server e Tipos de Dados de Transformao, 263

Oracle e Tipos de Dados de Transformao, 265

Tipos de Dados SAP HANA e de Transformao, 267

Sybase e Tipos de Dados de Transformao, 268

Teradata e Tipos de Dados de Transformao, 271

ODBC e Tipos de Dados de Transformao, 272

COBOL e Tipos de Dados de Transformao, 274

Arquivo Simples e Tipos de Dados de Transformao, 274

Tipos de dados XML e de Transformao, 275

Converso de Dados, 275

Viso Geral de Referncia de Tipo de Dados


Ao criar um mapeamento, voc cria um conjunto de instrues para o Servio de Integrao ler os dados da
tabela de origem, transform-la e grav-la em uma tabela de destino. O Servio de Integrao transforma os
dados com base no fluxo de dados do mapeamento, comeando pela primeira transformao e o tipo de
dados atribudo a cada porta em um mapeamento.
O Designer exibe dois tipos de tipos de dados:

254

Tipos de dados nativos. Especfico para bancos de dados de origem e destino, arquivos simples ou
sistemas ERP. Tipos de dados nativos aparecem no Source Analyzer e no Target Designer. Eles tambm
aparecem nas definies de origem e destino no Mapping Designer e nas definies de origem no
Mapplet Designer.

Tipos de dados de transformao. Conjunto de tipos de dados que aparece nas transformaes. Os
tipos de dados so internos, com base nos tipos de dados genricos ANSI SQL-92, que o Servio de
Integrao usa para mover dados entre plataformas. Como os tipos de dados de transformao so
genricos, voc pode usar plataformas de origem e destino diferentes. Por exemplo, voc pode ler as
informaes a partir de uma origem Oracle e grav-las em um destino Sybase. Do mesmo modo,
possvel ler as informaes a partir de um arquivo simples e grav-las em um banco de dados Microsoft
SQL Server. Os tipos de dados de transformao aparecem em todas as transformaes em um
mapeamento.

Quando o Servio de Integrao l os dados da origem, ele converte tipos de dados nativos em tipos de
dados de transformao comparveis antes de transformar os dados. Quando o Servio de Integrao grava
em um destino, ele converte tipos de dados de transformao em tipos de dados nativos comparveis.
Quando voc especifica um conjunto de caractere multibyte, os tipos de dados alocam espao extra no
banco de dados para armazenar caracteres de at trs bytes.

Tipos de Dados de Transformao


A tabela a seguir descreve os tipos de dados de transformao:
Tipo de
dados

Tamanho em Bytes

Descrio

Bigint

8 bytes

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Preciso 19, escala de 0
Valor inteiro.

Binrio

Preciso

1 a 104.857.600 bytes
Voc no pode usar dados binrios para origens
COBOL ou de arquivo simples.

Data/hora

16 bytes

De 1 de jan de 0001 D.C. a 31 de dez de 9999 D.C.


Preciso 29, escala de 9
(preciso para nanossegundo)
Valor de data/hora combinado.

Decimal

8 bytes (se alta preciso estiver


desativada ou se a preciso for maior
do que 28)

Preciso 1 a 28 dgitos; escala 0 a 28


Valor decimal com preciso e escala declaradas. A
escala deve ser menor que ou igual preciso.

16 bytes (se a preciso <= 18 e alta


preciso estiver ativada)
20 bytes (se a preciso > 18 e <= 28)
Double

8 bytes

Preciso de 15 dgitos
Valor numrico de ponto flutuante e preciso dupla.

Integer

4 bytes

-2.147.483.648 a 2.147.483.647
Preciso 10, escala de 0
Valor inteiro.

Tipos de Dados de Transformao

255

Tipo de
dados

Tamanho em Bytes

Descrio

Nstring

Modo Unicode: 2* (preciso + 1)

1 a 104.857.600 caracteres

Modo ASCII: preciso + 1

Sequncia de caracteres de comprimento fixo ou


varivel.

Ntext

Real

Modo Unicode: 2* (preciso + 1)

1 a 104.857.600 caracteres

Modo ASCII: preciso + 1

Sequncia de caracteres de comprimento fixo ou


varivel.

8 bytes

Preciso 7, escala de 0
Valor numrico de ponto flutuante e preciso dupla.

Integer curto

4 bytes

-32.768 e 32.767
Preciso 5, escala de 0
Valor inteiro.

String

Texto

Modo Unicode: 2* (preciso + 1)

1 a 104.857.600 caracteres

Modo ASCII: preciso + 1

Sequncia de caracteres de comprimento fixo ou


varivel.

Modo Unicode: 2* (preciso + 1)

1 a 104.857.600 caracteres

Modo ASCII: preciso + 1

Sequncia de caracteres de comprimento fixo ou


varivel.

Tipos de Dados Inteiro


possvel passar dados inteiros de origens para destinos e executar transformaes nesses dados. A
linguagem de transformao oferece suporte a tipos de dados Bigint, integer e integer curto.
Os tipos de dados inteiros de transformao representam valores exatos.

Valores inteiros em clculos


Quando voc usa valores inteiros em clculos, o Servio de Integrao s vezes converte os valores inteiros
em nmeros de ponto de flutuao antes de realizar o clculo. Por exemplo, para avaliar MOD( 12.00, 5 ), O
Servio de Integrao converte o valor inteiro de 5 em um nmero de ponto de flutuao antes de realizar a
operao de diviso. O Servio de Integrao converte valores integer em valores double ou decimais,
dependendo se voc habilitar alta preciso.

256

Apndice A: Referncia do Tipo de Dados

O Servio de Integrao converte valores inteiros nas operaes aritmticas a seguir:


Operao aritmtica

Alta preciso desativada

Funes e clculos que no podem introduzir


pontos decimais.

Sem converso

Alta preciso ativada


Decimal

Por exemplo, adio, subtrao e multiplicao de


inteiros e funes como CUME, MVINGSUM e
SUM.
Funes no cientficas e clculos que podem
introduzir pontos decimais.

Double

Decimal

Double

Double

Por exemplo, diviso de inteiros e funes como


AVG, MEDIAN e PERCENTILE.
Todas as funes cientficas e as funes EXP,
LN, LOG, POWER e SQRT.

1. Se o clculo gerar um resultado que esteja fora do intervalo, o Servio de Integrao gravar um erro de linha.
O tipo de dados de transformao Dupla oferece suporte preciso de at 15 dgitos, enquanto que o tipo
de dados Bigint oferece suporte preciso de at 19 dgitos. Portanto, a perda de preciso pode ocorrer em
clculos que produzem valores Bigint com preciso de mais de 15 dgitos.
Por exemplo, uma transformao de expresso contm o seguinte clculo:
POWER( BIGINTVAL, EXPVAL )
Antes de realizar o clculo, o Servio de Integrao converte as entradas na funo POWER para duplicar
valores. Se a porta BIGINTVAL contiver o valor Bigint 9223372036854775807, o Servio de Integrao
converter esse valor em 9.22337203685478e+18, perdendo os quatro ltimos dgitos de preciso. Se a
porta EXPVAL contiver o valor 1.0 e a porta resultante for um Bigint, esse clculo produzir um erro de linha,
j que o resultado, 9223372036854780000, excede o valor bigint mximo.
Quando voc usa um tipo de dados integer em um clculo que pode gerar valores decimais e executa a
sesso com alta preciso, o Servio de Integrao converte os valores integer em valores decimais. O tipo
de dados Decimal da transformao oferece suporte preciso de at 28 dgitos. Portanto, a perda na
preciso no ocorre em um clculo, a no ser que o resultado produza um valor com preciso maior que 28
dgitos. Nesse caso, o Servio de Integrao armazena o resultado como double.

Nmeros inteiros constantes em expresses


O Servio de Integrao interpreta constantes em uma expresso como valores de ponto flutuante, mesmo
se o clculo produzir um resultado com um nmero inteiro. Por exemplo, na expresso INTVALUE + 1000, o
Servio de Integrao converte o valor do nmero inteiro "1000" para um valor dobrado se a alta preciso
no estiver habilitada. Ele converte o valor 1000 para um valor decimal se a alta preciso estiver habilitada.
Para processar o valor 1000 como um nmero inteiro, crie uma porta varivel com um tipo de dados Inteiro
para armazenar a constante e modifique a expresso para adicionar as duas portas.

Valores NaN
NaN (no um nmero) um valor geralmente retornado como resultado de uma operao com operandos
de entrada invlidos, especialmente em clculos de ponto flutuante. Por exemplo, quando uma operao
tenta dividir zero por zero, isso retorna um resultado NaN.

Tipos de Dados de Transformao

257

Sistemas operacionais e linguagens de programao podem representar o NaN de formas diferentes. Por
exemplo, a lista a seguir mostra representaes de strings vlidas de NaN:
nan
NaN
NaN%
NAN
NaNQ
NaNS
qNaN
sNaN
1.#SNAN
1.#QNAN
O Servio de Integrao converte valores QNAN para 1.#QNAN em plataformas Win64EMT. 1.#QNAN
uma representao vlida de NaN.

Converter valores de string em valores integer


Quando o Servio de Integrao realiza a converso implcita de um valor de sequncia de caracteres em
um valor inteiro, ele trunca os dados no primeiro caractere no numrico. Por exemplo, voc vincula uma
porta de sequncia que contm o valor 9.000.000.000.000.000.000.777 a uma porta Bigint. O Servio de
Integrao converte a string no valor de bigint de 9.000.000.000.000.000.000.

Gravar valores inteiros em arquivos simples


Quando valores inteiros so gravados em um arquivo simples com largura fixa, o gravador no verifica se os
dados esto no intervalo. Por exemplo, o gravador de arquivo grava o resultado 3.000.000.000 em uma
coluna de destino integer se a largura de campo da coluna de destino for pelo menos 13. O gravador de
arquivo no rejeita a linha porque o resultado est fora do intervalo vlido para os valores de Inteiro.

Tipo de Dados Binrio


Se um mapeamento inclui dados binrios, defina a preciso da transformao de tipo de dados binrio, de
forma que o Servio de Integrao possa alocar memria suficiente para mover os dados da origem para o
destino.
Voc no pode usar tipos de dados binrios para origens COBOL ou de arquivo simples.

Tipo de Dados de Data/Hora


O tipo data/hora trata anos entre 1 d.C. a 9999 d.C. no sistema de calendrio gregoriano. Anos posteriores a
9999 d.C causam erro.
O tipo de dados de Data e Hora oferece suporte a datas com preciso de nanossegundo. O tipo de dados
tem preciso de 29 e escala de 9. Alguns tipos de dados nativos tm uma preciso menor. Ao importar uma
origem que contm valores de data e hora, o processo de importao importa a preciso correta da coluna
de origem. Por exemplo, o tipo de dados de data e hora do Microsoft SQL Server tem uma preciso de 23 e
uma escala de 3. Ao importar uma origem do Microsoft SQL Server que contm valores de data e hora, as
colunas data e hora na origem do mapeamento tm uma preciso de 23 e uma escala de 3.
O Servio de Integrao l os valores de data e hora da origem at a preciso especificada na origem do
mapeamento. Quando o Servio de Integrao transforma os valores de data e hora, ele oferece suporte a
uma preciso de at 29 dgitos. Por exemplo, se voc importar um valor de data e hora com preciso de
milissegundos poder usar a funo ADD_TO_DATE em uma transformao Expresso para adicionar
nanossegundos data.
Ao gravar um valor Data/Hora em uma coluna de destino que oferece suporte a uma preciso menor, o
Servio de Integrao trunca o valor para a preciso da coluna de destino. Ao gravar um valor Data/Hora em

258

Apndice A: Referncia do Tipo de Dados

uma coluna de destino que oferece suporte a uma preciso maior, o Servio de Integrao insere zeros na
parte sem suporte do valor de data e hora.

Tipos de Dados Decimais e Duplos


Voc pode passar dados decimais e duplos das origens para os destinos e realizar transformaes em
dados decimais e duplos. A linguagem de transformao oferece suporte aos seguintes tipos de dados:

Decimal. Preciso 1 a 28 dgitos; escala 0 a 28 Voc no pode usar valores decimais com escala maior
que a preciso ou com uma preciso negativa. As transformaes exibem qualquer intervalo para atribuir
um tipo de dados Decimal, mas o Servio de Integrao suporta somente preciso de at 28.

Duplo. Preciso de 15.

Valores decimais e double em clculos


O tipo de dados Decimal da transformao oferece suporte preciso de at 28 dgitos e o tipo de dados
Duplo oferece suporte preciso de at 15 dgitos. A perda de preciso pode ocorrer em qualquer tipo de
dados em um clculo, quando o resultado produz um valor com uma preciso maior que o mximo.
Se voc desativar a alta preciso, o Servio de Integrao converte valores decimais em double. Portanto, a
perda de preciso ocorrer se o valor decimal tiver uma preciso maior do que 15 dgitos. Por exemplo, voc
tem um mapeamento com Decimal (20.0) que passa o nmero 40012030304957666903. Se voc desativar a
alta preciso, o Servio de Integrao converte o valor decimal em double e passar 4,00120303049577 x
10 19 .
Para garantir preciso de at 28 dgitos, use o tipo de dados Decimal e ative alta preciso. Quando voc
ativa alta preciso, o Servio de Integrao processa valores decimais como decimais. Perda na preciso
no ocorre em um clculo, a no ser que o resultado produza um valor com preciso maior que 28 dgitos.
Nesse caso, o Servio de Integrao armazena o resultado como double. No use o tipo de dados Duplo
para os dados que voc utiliza em uma condio de igualdade, como uma pesquisa ou condio de juno.
A tabela a seguir lista como o Servio de Integrao manipula os valores decimais com base na
configurao da preciso alta:
Tipo de dados da
porta

Preciso

Preciso alta desativada

Preciso alta ativada

Decimal

0-28

Double

Decimal

Decimal

Mais de 28

Double

Double

Quando voc ativa a preciso alta, o Servio de Integrao converte as constantes numricas de qualquer
funo da expresso em Decimal. Se voc no ativar a preciso alta, o Servio de Integrao converte as
constantes numricas em Duplo.
Para garantir a preciso mxima para valores numricos maiores que 28 dgitos, trunque ou arredonde o
nmero grande antes de executar clculos ou transformaes com as funes de transformao.

Mtodos de Arredondamento para Valores Duplos


Devido a diferenas nas bibliotecas de tempo de execuo do sistema e o sistema do computador em que o
banco de dados processa clculos de tipo de dados duplo, os resultados podem no ser o esperado. O tipo
de dados duplo compatvel com o padro IEEE 794. Alteraes na biblioteca de cliente do banco de dados,
verses diferentes de um banco de dados ou alteraes na biblioteca de tempo de execuo do sistema
afetam a representao binria de valores matematicamente equivalentes. Alm disso, muitas bibliotecas de

Tipos de Dados de Transformao

259

tempo de execuo do sistema implementam o mtodo de arredondamento para pares ou o metdo


aritmtico simtrico. O mtodo de arredondamento para pares determina que, se um nmero fica entre o
prximo nmero maior ou menor, ele arredondado para o valor mais prximo com um bit par menos
significativo. Por exemplo, no mtodo de arredondamento para par, 0,125 arredondado para 0,12. O
mtodo aritmtico simtrico arredonda o nmero para o prximo dgito maior quando o ltimo dgito for 5 ou
superior. Por exemplo, no mtodo aritmtico simtrico 0,125 arredondado para 0,13 e 0,124 arredondado
para 0,12.
Para oferecer resultados de clculo menos suscetveis s diferenas de plataforma, o Servio de Integrao
armazena os 15 dgitos significativos e valores de tipo de dados duplos. Por exemplo, se um clculo no
Windows retornar o nmero 1234567890.1234567890 e o mesmo clculo no UNIX retornar
1234567890.1234569999, o Servio de Integrao converter esse nmero em 1234567890.1234600000.

Tipo de Dados de String


A transformao de tipos de dados inclui os seguintes tipos de dados de string:

Nstring

Ntext

String

Texto

Embora os tipos de dados Nstring, Ntext, String e Text ofeream suporte mesmo a preciso de at
104.857.600 caracteres, o Servio de Integrao usa String para mover os dados de strings da origem para
o destino e Texto para mover dados de texto da origem para o destino. Como alguns bancos de dados
armazenam dados de texto de forma diferente dos dados de string, o Servio de Integrao precisa distinguir
entre os dois tipos de dados de caractere. Se o qualificador de origem exibir String, defina a coluna de
destino como String. Do contrrio, se um qualificador de origem exibir Texto, defina a coluna de destino
como Text, Long ou Long Varchar, dependendo do banco de dados de origem.
Geralmente, os tipos de dados de string menores, como Char e Varchar, so exibidos como String nas
transformaes Qualificador de origem, Pesquisa e Procedimento Armazenado, enquanto os tipos de dados
de texto maiores, como Text, Long e Long Varchar, so exibidos no Qualificador de origem.
Use Nstring, Ntext, String e Text, alternadamente, dentro das transformaes. No entanto, nas
transformaes Qualificador de origem, Pesquisa e Procedimento Armazenado os tipos de dados de destino
devem ser compatveis. Os drivers do banco de dados precisam correlacionar os tipos de dados de string
com os tipos de dados de transformao, fazendo com que os dados passem de forma precisa. Por
exemplo, Nchar em uma tabela de pesquisa deve corresponder a Nstring na transformao Pesquisa.

IBM DB2 e Tipos de Dados de Transformao


A tabela a seguir compara tipos de dados IBM DB2 e tipos de dados de transformao:
Tipo de dados

Intervalo

Transformao

Intervalo

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Preciso 19, escala 0

Blob

260

1 a 2,147,483,647 bytes

Apndice A: Referncia do Tipo de Dados

Binrio

1 a 104.857.600 bytes

Tipo de dados

Intervalo

Transformao

Intervalo

Char(L)

1 a 254 caracteres

String

1 a 104.857.600 caracteres

Char para dados bit

1 a 254 bytes

Binrio

1 a 104.857.600 bytes

CLOB

1 a 2,447,483,647 bytes

Texto

1 a 104.857.600 caracteres

Data

0001 a 9999 DC.

Data/Hora

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

Preciso 19; escala 0 (preciso


para o dia)

(preciso de nanossegundo)

Dbclob

At 1 GB

Ntext

1 a 104.857.600 caracteres

Decimal(P,S)

Preciso 1 a 31, escala 0 a 31

Decimal

Preciso 1 a 28, escala 0 a 28

Flutuante

Preciso 1 a 15

Duplo

Preciso 15

Elemento grfico

1 a 127 bytes

Nstring

1 a 104.857.600 caracteres

Nmero inteiro

-2.147.483.648 a 2.147.483.647

Nmero inteiro

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

Long Varchar

1 a 32,700 caracteres

String

1 a 104.857.600 caracteres

Long Vargraphic

At 16.350 bytes

Ntext

1 a 104.857.600 caracteres

Numeric(P,S)

Preciso 1 a 31, escala 0 a 31

Decimal

Preciso 1 a 28, escala 0 a 28

Smallint

-32.768 a 32.767

Nmero inteiro
curto

Preciso 5, escala 0

perodo de 24 horas

Data/Hora

Preciso 19, escala 0

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

(preciso para o segundo)

(preciso de nanossegundo)

Hora

Carimbo de data/
hora

26 bytes

Data/Hora

Preciso 26, escala 6

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

(preciso para o microsegundo)

(preciso de nanossegundo)

Varchar

At 4.000 caracteres

String

1 a 104.857.600 caracteres

Varchar para dados


bit

At 4,000 bytes

Binrio

1 a 104.857.600 bytes

Vargraphic

At 16,336 bytes

String

1 a 104.857.600 caracteres

Informix e Tipos de Dados de Transformao


A tabela a seguir compara os tipos de dados Informix com os tipos de dados de transformao exibidos nas
transformaes Qualificador de Origem, Pesquisa e Procedimento Armazenado. Voc pode alterar o tipo de

Informix e Tipos de Dados de Transformao

261

dados de transformao dentro do mapeamento e o Servio de Integrao converte os dados. No entanto, o


tipo de dados nas transformaes Qualificador de Origem, Pesquisa e Procedimento Armazenado deve ser
compatveis com o tipo de dados da origem. Se eles no forem compatveis, o mapeamento invalidado.
Nota: S o tipo de dados Informix Text aparece como o tipo de dados da transformao Texto nas
transformaes Qualificador de Origem, Pesquisa e Procedimento Armazenado. No entanto, use os tipos de
dados de transformao Texto e String alternadamente.
Informix

Faixa

Transformao

Faixa

Byte

O mnimo 1 byte. Sem tamanho


mximo.

Binrio

1 a 104.857.600 bytes

Char(L)

1 a 32.767 caracteres

String

1 a 104.857.600 caracteres

Data

De 1 de jan de 0001 D.C. a 31 de


dez de 9999 D.C.

Data/hora

De 1 de jan de 0001 D.C. a 31


de dez de 9999 D.C.

Preciso 19, escala 0

(preciso para nanossegundo)

(preciso para o dia)


Data e hora do
ano para frao

De 1 de jan de 0001 D.C. a 31 de


dez de 9999 D.C.

Data/hora

Preciso 21 a 25, escala 1 a 5

De 1 de jan de 0001 D.C. a 31


de dez de 9999 D.C.
(preciso para nanossegundo)

(preciso para milissegundos)


Decimal(P,S)

Preciso 1 a 32, escala 0 a 32

Decimal

Preciso 1 a 28, escala 0 a 28

Float(P)

Preciso 1 a 14

Double

Preciso 15

Int8

-9.223.372.036.854.775.807 a
9.223.372.036.854.775.807

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Preciso 19, escala 0

Integer

-2.147.483.647 a 2.147.483.647

Integer

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

Money(P,S)

Preciso de 1 a 32, escala 2

Decimal

Preciso 1 a 28, escala 0 a 28

Nvarchar

1 a 255 caracteres

Nstring

1 a 104.857.600 caracteres

Serial(L)

-2.147.483.647 a 2.147.483.647

Integer

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

262

Smallfloat

Preciso 1 a 7, escala 0

Real

Preciso 7, escala 0

Smallint

-32.767 a 32.767

Integer curto

Preciso 5, escala 0

Texto

Comprimento mximo 2e31

Texto

1 a 104.857.600 caracteres

Varchar(M,R)

1 a 255 caracteres

String

1 a 104.857.600 caracteres

Apndice A: Referncia do Tipo de Dados

Sinnimos de Tipos de Dados


A tabela a seguir compara sinnimos Informix com tipos de dados de transformao:
Sinnimo

Transformao

Bigint (Servidor Paralelo Estendido)

Bigint

Character(L)

String

Character Varying(m,r)

String

Dec

Decimal

Preciso dupla

Duplo

Int

Nmero inteiro

Numrico

Decimal

Real

Real

Microsoft SQL Server e Tipos de Dados de


Transformao
A tabela a seguir compara tipos de dados do Microsoft SQL Server e tipos de dados de transformao:
Microsoft SQL

Faixa

Transformao

Faixa

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Preciso 19, escala 0

Binary(L)

1 a 8.000 bytes

Binrio

1 a 104.857.600 bytes

Bit

1 bit

String

1 a 104.857.600 caracteres

Char(L)

1 a 8.000 caracteres

String

1 a 104.857.600 caracteres

Data e hora

1 de janeiro de 1753 D.C. a 31


de dezembro de 9999 D.C.

Data/Hora

1 de janeiro de 0001 D.C. a 31


de dezembro de 9999 D.C.

Preciso 23, escala 3

(preciso de nanossegundo)

(preciso para 3,33 milsimo de


segundos)
Datetime2

1 de janeiro de 1 D.C. a 31 de
dezembro de 9999 D.C.
Preciso 27, escala 7

Data/Hora

1 de janeiro de 0001 D.C. a 31


de dezembro de 9999 D.C.
(preciso de nanossegundo)

(preciso de 100
nanossegundos)

Microsoft SQL Server e Tipos de Dados de Transformao

263

Microsoft SQL

Faixa

Transformao

Faixa

Decimal(P,S)

Preciso 1 a 38, escala 0 a 38

Decimal

Preciso 1 a 28, escala 0 a 28

Flutuante

-1.79E+308 a 1.79E+308

Duplo

Preciso 15

Imagem

1 a 2.147.483.647 bytes

Binrio

1 a 104.857.600 bytes

Int

-2.147.483.648 a 2.147.483.647

Nmero Inteiro

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

Dinheiro

-922.337.203.685.477,5807 at

Decimal

Preciso 1 a 28, escala 0 a 28

922.337.203.685.477,5807
Nchar

1 a 4.000 caracteres

Nstring

1 a 104.857.600 caracteres

Ntext

1 a 1.073.741.823 caracteres

Ntext

1 a 104.857.600 caracteres

Numeric(P,S)

Preciso 1 a 38, escala 0 a 38

Decimal

Preciso 1 a 28, escala 0 a 28

Identidade
numrica

1 a 9.999

Nmero Inteiro

Nvarchar

1 a 4.000 caracteres

Nstring

1 a 104.857.600 caracteres

Real

-3.40E+38 a 3.40E+38

Real

Preciso 7, escala 0

Smalldatetime

1 de janeiro de 1900 a 6 de
junho de 2079

Data/Hora

1 de janeiro de 0001 D.C. a 31


de dezembro de 9999 D.C.
(preciso de nanossegundo)

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

Preciso 19, escala 0


(preciso para o minuto)

264

Smallint

-32.768 a 32.768

Nmero Inteiro
Curto

Preciso 5, escala 0

Smallmoney

-214.748,3648 a 214.748,3647

Decimal

Preciso 1 a 28, escala 0 a 28

Sysname

1 a 128 caracteres

Nstring

1 a 104.857.600 caracteres

Texto

1 a 2.147.483.647 caracteres

Texto

1 a 104.857.600 caracteres

Carimbo de Data/
Hora

8 bytes

Binrio

1 a 104.857.600 bytes

Tinyint

0 a 255

Nmero Inteiro
Curto

Preciso 5, escala 0

Varbinary(L)

1 a 8.000 bytes

Binrio

1 a 104.857.600 bytes

Varchar(L)

1 a 8.000 caracteres

String

1 a 104.857.600 caracteres

Apndice A: Referncia do Tipo de Dados

Sinnimos de Tipos de Dados


A tabela a seguir compara sinnimos do Microsoft SQL Server para transformao de tipos de dados:
Sinnimo

Transformao

Variao Binria

Binrio

Caractere

String

Variao de Caractere

String

Dec

Decimal

Preciso dupla

Duplo

Nmero inteiro

Nmero inteiro

Tipo de Dados Uniqueidentifier


O PowerCenter importa o tipo de dados de identificador exclusivo do Microsoft SQL Server como um tipo de
dados Varchar do Microsoft SQL Server de 38 caracteres.

Oracle e Tipos de Dados de Transformao


A tabela a seguir compara tipos de dados Oracle e tipos de dados de transformao:
Oracle

Faixa

Transformao

Faixa

Blob

At 4 GB

Binrio

1 a 104.857.600 bytes

Char(L)

1 a 2.000 bytes

String

1 a 104.857.600 caracteres

Clob

At 4 GB

Texto

1 a 104.857.600 caracteres

Data

1 de janeiro de 4712 A.C. a 31 de


dezembro de 4712 D.C.

Data/Hora

1 de janeiro de 0001 D.C. a 31 de


dezembro de 9999 D.C.

Preciso 19, escala 0


Longo

At 2 GB

(preciso de nanossegundo)
Texto

1 a 104.857.600 caracteres
Se voc incluir dados Longos em
um mapeamento, o Servio de
Integrao os converter ao tipo
de dados String de transformao
e os truncar para 104.857.600
caracteres.

Longo Bruto

At 2 GB

Binrio

1 a 104.857.600 bytes

Nchar

1 a 2.000 bytes

Nstring

1 a 104.857.600 caracteres

Oracle e Tipos de Dados de Transformao

265

Oracle

Faixa

Transformao

Faixa

Nclob

At 4 GB

Ntext

1 a 104.857.600 caracteres

Nmero

Preciso de 1 a 38

Duplo

Preciso de 15

Preciso de 1 a 38,

Decimal

Preciso 1 a 28; escala 0 a 28

Nmero(P,S)

escala de 0 a 38
Nvarchar2

1 a 4.000 bytes

Nstring

1 a 104.857.600 caracteres

Raw(L)

1 a 2.000 bytes

Binrio

1 a 104.857.600 bytes

Carimbo de
Data/Hora

1 de janeiro de 4712 A.C. a 31 de


dezembro de 9999 D.C.

Data/Hora

1 de janeiro de 0001 D.C. a 31 de


dezembro de 9999 D.C.

Preciso de 19 a 29, escala de 0 a


9

(preciso de nanossegundo)

(preciso de nanossegundo)
Varchar(L)

1 a 4.000 bytes

String

1 a 104.857.600 caracteres

Varchar2(L)

1 a 4.000 bytes

String

1 a 104.857.600 caracteres

Armazenamen
to CLOB
baseado em
tipo XML

At 4 GB

Texto

1 a 104.857.600 caracteres

Tipo de Dados Nmero(P,S)


O PowerCenter oferece suporte aos valores Nmero(P,S) Oracle com escala negativa. No entanto, ele no
oferece suporte a valores Nmero(P, S) com escala maior que preciso 28 ou uma preciso negativa.
Se voc importar uma tabela com um Nmero Oracle com escala negativa, o Mapping Designer o exibe
como tipo de dados Decimal, mas o Servio de Integrao o converte para um duplo.

Tipos de Dados Char, Varchar, Clob


Quando o Servio de Integrao usa o modo de movimentao de dados Unicode, ele l a preciso de
colunas Char, Varchar e Clob baseado na semntica de comprimento definida para colunas no banco de
dados Oracle. Se voc usar a semntica de bytes para determinar o comprimento da coluna, o Servio de
Integrao ler a preciso como o nmero de bytes. Se voc utilizar a semntica de char, o Servio de
Integrao ler a preciso como o nmero de caracteres.

266

Apndice A: Referncia do Tipo de Dados

Tipos de Dados SAP HANA e de Transformao


A tabela a seguir compara os tipos de dados SAP HANA e de transformao:
Tipo de Dados SAP
HANA

Faixa

Tipo de Dados de
Transformao

Faixa

Alphanum

Preciso de 1 a 127

Nstring

1 a 104.857.600
caracteres

Bigint

-9.223.372.036.854.775.8
08 a
9.223.372.036.854.775.8
07

Bigint

-9.223.372.036.854.775.8
08 a
9.223.372.036.854.775.8
07
Preciso 19, escala 0

Binary

Usado para armazenar


bytes de dados binrios

Binary

1 a 104.857.600 bytes

Blob

At 2 GB

Binary

1 a 104.857.600 bytes

Clob

At 2 GB

Text

1 a 104.857.600
caracteres

Date

De 1 de jan de 0001 D.C.


a 31 de dez de 9999 D.C.

Date/Time

De 1 de jan de 0001 D.C.


a 31 de dez de 9999 D.C.

Preciso 10, escala 0

(preciso de
nanossegundo)

Decimal (preciso,
escala) ou Dec (p, e)

Preciso 1 a 34

Decimal

Preciso 1 a 28, escala 0


a 28

Double

Especifica um nmero de
ponto flutuante de 64 bits
de preciso nica

Double

Preciso 15

Float

Preciso 1 a 53

Double

Preciso 15

Integer

-2.147.483.648 a
2.147.483.647

Integer

-2.147.483.648 a
2.147.483.647
Preciso 10, escala 0

NClob

At 2 GB

Ntext

1 a 104.857.600
caracteres

Nvarchar

Preciso 1 a 5000

Nstring

1 a 104.857.600
caracteres

Real

Especifica um nmero de
ponto flutuante de 32 bits
de preciso nica

Real

Preciso 7, escala 0

Seconddate

0001-01-01 00:00:01 a
9999-12-31 24:00:00

Date/Time

De 1 de jan de 0001 D.C.


a 31 de dez de 9999 D.C.
(preciso de
nanossegundo)

Tipos de Dados SAP HANA e de Transformao

267

Tipo de Dados SAP


HANA

Faixa

Tipo de Dados de
Transformao

Faixa

Shorttext

Especifica uma string de


caracteres de tamanho
varivel, que oferece
suporte a recursos de
pesquisa de texto e de
string

Nstring

1 a 104.857.600
caracteres

Smalldecimal

Preciso 1 a 16

Decimal

Preciso 1 a 28, escala 0


a 28

Smallint

-32.768 a 32.767

Small Integer

Preciso 5, escala 0

Text

Especifica uma string de


caractere de tamanho
varivel, que oferece
suporte a recursos de
pesquisa de texto

Text

1 a 104.857.600
caracteres

Time

Perodo de 24 horas

Date/Time

De 1 de jan de 0001 D.C.


a 31 de dez de 9999 D.C.
(preciso de
nanossegundo)

Timestamp

0001-01-01
00:00:00.0000000 a
9999-12-31
23:59:59.9999999

Date/Time

De 1 de jan de 0001 D.C.


a 31 de dez de 9999 D.C.

Tinyint

0 a 255

Small Integer

Preciso 5, escala 0

Varchar

Preciso 1 a 5000

String

1 a 104.857.600
caracteres

Varbinary

1 a 5000 bytes

Binary

1 a 104.857.600 bytes

(preciso de
nanossegundo)

Sybase e Tipos de Dados de Transformao


A tabela a seguir compara tipos de dados Sybase ASE e IQ e tipos de dados de transformao:
Sybase

Intervalo

Transformao

Intervalo

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Preciso 19, escala 0

Binrio (n)

268

- Sybase ASE: tamanho da pgina


lgica do servidor
- Sybase IQ: 1 a 255 bytes

Apndice A: Referncia do Tipo de Dados

Binrio

1 a 104.857.600 bytes

Sybase

Intervalo

Transformao

Intervalo

Bit

0 ou 1

String

1 a 104.857.600 caracteres

Char (n)

tamanho da pgina lgica do


servidor ASE

String

1 a 104.857.600 caracteres

Data

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

Data/Hora

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

Preciso 10, escala 0


Datetime

1 de janeiro, 1753 A.D. a 31 de


dezembro, 9999 A.D.

(preciso de nanossegundo)
Data/Hora

Preciso 23, escala 3

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.
(preciso de nanossegundo)

(preciso para 1/300 segundos)


Decimal (P,S)

Preciso 1 a 38, escala 0 a 38

Decimal

Preciso 1 a 28, escala 0 a 28

Flutuante

dependente de mquina

Duplo

Preciso 15

Imagem

1 a 2,147,483,647 bytes

Binrio

1 a 104.857.600 bytes

Int

-2.147.483.648 a 2.147.483.647

Nmero inteiro

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

Moeda

-922,337,203,685,477.5808 a

Decimal

Preciso 1 a 28, escala 0 a 28

922,337,203,685,477.5807
Nchar (n)

tamanho da pgina lgica do


servidor ASE

Nstring

1 a 104.857.600 caracteres

Numeric (P,S)

Preciso 1 a 38, escala 0 a 38

Decimal

Preciso 1 a 28, escala 0 a 28

Nvarchar (n)

tamanho da pgina lgica do


servidor ASE

Nstring

1 a 104.857.600 caracteres

Real

dependente de mquina

Real

Preciso 7, escala 0

Smalldatetime

1 de janeiro de 1900 a 6 de junho


de 2079

Data/Hora

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

Preciso 19, escala 0

(preciso de nanossegundo)

(preciso para o minuto)


Smallint

-32.768 a 32.767

Nmero inteiro
curto

Preciso 5, escala 0

Smallmoney

-214,748.3648 a 214,748.3647

Decimal

Preciso 1 a 28, escala 0 a 28

Texto

1 a 2,147,483,647 caracteres

Texto

1 a 104.857.600 caracteres

12:00:00 a 23:59:59:999

Data/Hora

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

Hora

Preciso 8; escala 0

(preciso de nanossegundo)

Sybase e Tipos de Dados de Transformao

269

Sybase

Intervalo

Transformao

Intervalo

Carimbo de
data/hora

8 bytes

Binrio

1 a 104.857.600 bytes

Carimbo de
data/hora
(Sybase IQ)

0001-01-01

Data/Hora

1 de janeiro, 0001 A.D. a 31 de


dezembro de 9999 A.D.

00:00:00.000000 a 31-12-9999
23:59:59.999999

(preciso de nanossegundo)

Preciso 26, escala 6


Tinyint

0 a 255

Nmero inteiro
curto

Preciso 5, escala 0

Unichar

tamanho da pgina lgica do


servidor ASE

Nstring

1 a 104.857.600 caracteres

Univarchar

tamanho da pgina lgica do


servidor ASE

Nstring

1 a 104.857.600 caracteres

Varbinary (n)

- Sybase ASE: tamanho da pgina


lgica do servidor
- Sybase IQ: 1 a 32,767 bytes

Binrio

1 a 104.857.600 bytes

Varchar (n)

tamanho da pgina lgica do


servidor ASE

String

1 a 104.857.600 caracteres

Os tipos de dados a seguir no so suportador pelo Sybase IQ:

Imagem

Nchar (n)

Nvarchar (n)

Texto

Unichar

Univarchar

Sinnimos de Tipos de Dados


A tabela a seguir compara sinnimos Sysbase com tipos de dados de Transformao:

270

Sinnimo

Transformao

Char Varying

String

Character(L)

String

Variao de Caractere

String

Dec

Decimal

Nmero inteiro

Nmero inteiro curto

National Char

Nstring

Apndice A: Referncia do Tipo de Dados

Sinnimo

Transformao

National Char Varying

Nstring

National Character

Nstring

National Character Varying

Nstring

Nchar Varying

Nstring

Tipo de Dados Binrios e Varbinary para Sybase IQ


O Sybase IQ oferece suporte para tipos de dados binrios e varbinary quando a opo de banco de dados
ASE_Binary_Display estiver definida como OFF no Sybase IQ. Por padro, a opo est definida como ON.
Para obter mais informaes, consulte a documentao do Sybase.

Teradata e Tipos de Dados de Transformao


A tabela a seguir compara tipos de dados Teradata e tipos de dados de transformao:
Teradata

Faixa

Transformao

Faixa

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Preciso 19, escala 0

Byte

1 a 64.000 bytes

Binrio

1 a 104.857.600 bytes

Byteint

-128 a 127

Nmero Inteiro
Curto

Preciso 5, escala 0

Caractere

1 a 64.000 bytes

String

1 a 104.857.600 caracteres

Data

1 de janeiro de 0001 D.C. a 31 de


dezembro de 9999 D.C.

Data/Hora

1 de janeiro de 0001 D.C. a 31 de


dezembro de 9999 D.C.

Preciso 19, escala 0

(preciso de nanossegundo)

Decimal

Preciso 1 a 18, escala 0 a 18

Decimal

Preciso 1 a 28, escala 0 a 28

Flutuante

-2,226 E+308 a 1,797 E+308

Duplo

Preciso 15

Nmero
inteiro

-2.147.483.648 a 2.147.483.647

Nmero inteiro

Smallint

-32.768 a 32.768

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

Nmero Inteiro
Curto

Preciso 5, escala 0

Teradata e Tipos de Dados de Transformao

271

Teradata

Faixa

Transformao

Faixa

Tempo

00:00:00.000000 a
23:59:61.999999

Data/Hora

1 de janeiro de 0001 D.C. a 31 de


dezembro de 9999 D.C.

Preciso 8, escala 0
Carimbo de
Data/Hora

1 a 19 caracteres

(preciso de nanossegundo)
Data/Hora

Preciso de 19 a 26, escala de 0 a


6

1 de janeiro de 0001 D.C. a 31 de


dezembro de 9999 D.C.
(preciso de nanossegundo)

Varbyte

1 a 64.000 bytes

Binrio

1 a 104.857.600 bytes

Varchar

1 a 64.000 bytes

String

1 a 104.857.600 caracteres

Sinnimos de Tipos de Dados


A tabela a seguir compara sinnimos Teradata com tipos de dados de transformao:
Sinnimo

Transformao

Preciso dupla

Duplo

Numrico

Decimal

Real

Duplo

ODBC e Tipos de Dados de Transformao


A tabela a seguir compara tipos de dados ODBC, como o Microsoft Access ou Excel, com tipos de dados de
transformao:
Tipo de dados

Transformao

Intervalo

Bigint

Bigint

-9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Preciso 19, escala 0

Binrio

Binrio

1 a 104.857.600 bytes

Bit

String

1 a 104.857.600 caracteres

Char(L)

String

1 a 104.857.600 caracteres

Data

Data/Hora

1 de janeiro, 0001 A.D. a 31 de dezembro de 9999 A.D.


(preciso de nanossegundo)

Decimal(P, S)

272

Decimal

Apndice A: Referncia do Tipo de Dados

Preciso 1 a 28, escala 0 a 28

Tipo de dados

Transformao

Intervalo

Duplo

Duplo

Preciso 15

Flutuante

Duplo

Preciso 15

Nmero inteiro

Nmero inteiro

-2.147.483.648 a 2.147.483.647
Preciso 10, escala 0

Varbinary longo

Binrio

1 a 104.857.600 bytes

Nchar

Nstring

1 a 104.857.600 caracteres

Nvarchar

Nstring

1 a 104.857.600 caracteres

Ntext

Ntext

1 a 104.857.600 caracteres

Numrico

Decimal

Preciso 1 a 28, escala 0 a 28

Real

Real

Preciso 7, escala 0

Smallint

Smallint

Preciso 5, escala 0

Texto

Texto

1 a 104.857.600 caracteres

Hora

Data/Hora

1 de janeiro, 0001 A.D. a 31 de dezembro de 9999 A.D.


(preciso de nanossegundo)

Carimbo de data/hora

Data/Hora

1 de janeiro, 0001 A.D. a 31 de dezembro de 9999 A.D.


(preciso de nanossegundo)

Tinyint

Nmero inteiro curto

Preciso 5, escala 0

Varbinary

Binrio

1 a 104.857.600 bytes

Varchar(L)

String

1 a 104.857.600 caracteres

Nota: Quando o Servio de Integrao executado no modo de movimentao de dados Unicode, a


preciso da coluna que voc especificou para os tipos de dados ODBC determina o nmero de caracteres
que o Servio de Integrao l e grava.

ODBC e Tipos de Dados de Transformao

273

COBOL e Tipos de Dados de Transformao


A tabela a seguir compara tipos de dados COBOL com tipos de dados de transformao:
COBOL

Transformao

Intervalo

Nstring

String

1 a 104.857.600 caracteres

Nmero

Decimal

Preciso 1 a 28; escala 0 a 28

String

String

1 a 104.857.600 caracteres

Arquivo Simples e Tipos de Dados de


Transformao
A tabela a seguir compara tipos de dados de arquivo simples e tipos de dados de transformao:
Arquivo
Simples

Transformao

Intervalo

Bigint

Bigint

Preciso de 19 dgitos, escala de 0

Datetime

Data/Hora

1 jan, 0001 D.C. a 31 dez, 9999 D.C. (preciso at o


nanossegundo)

Duplo

Duplo

Preciso de 15 dgitos

Nmero inteiro

Nmero inteiro

-2.147.483.648 a 2.147.483.647

Nstring

Nstring

1 a 104.857.600 caracteres

Nmero

Decimal

Preciso 1 a 28, escala 0 a 28

String

String

1 a 104.857.600 caracteres

Quando o Servio de Integrao l dados no numricos em uma coluna numrica de um arquivo simples,
ele remove a linha e escreve uma mensagem no log da sesso. Alm disso, quando o Servio de Integrao
l dados que no so de data e hora em uma coluna de data e hora de um arquivo simples, ele remove a
linha e grava uma mensagem no log da sesso.

Tipo de Dados Nmero


Para os arquivos simples, o Servio de Integrao l os dados com um tipo de dados Nmero, conforme
aparece no arquivo. Se voc deseja especificar a preciso decimal e a escala, use uma transformao
Expresso para converter portas de nmero em portas decimais. Tambm ative a preciso alta na sesso.

274

Apndice A: Referncia do Tipo de Dados

Por exemplo, se o arquivo simples contm um campo numrico de 5 dgitos chamado Preo, e voc deseja
gerar o Preo como sada na forma de um nmero com duas casas decimais, deve montar a expresso a
seguir:
PRICE / 100
Esta expresso move a casa decimal dois dgitos esquerda, conforme mostrado no exemplo a seguir:

Number

Return Value

34500

345.00

12340

123.40

23450

234.50

Tipos de dados XML e de Transformao


O PowerCenter oferece suporte a todos os tipos de dados XML especificados na Recomendao W3C de 2
de maio de 2001. Para obter mais informaes sobre os tipos de dados XML, consulte as especificaes
W3C para tipos de dados XML em http://www.w3.org/TR/xmlschema-2.
Ao transmitir dados para o destino, certifique-se de que eles estejam no formato correto para que o Servio
de Integrao grave os dados corretamente no arquivo XML de destino.
Voc pode alterar os tipos de dados XML nas definies de origem e destino. Voc pode alterar os tipos de
dados XML midstream no Transformation Developer. Voc no pode alterar os tipos de dados XML quando
import-los de um esquema XML e no pode alterar os tipos de dados de transformao para origens XML
em um mapeamento.

Converso de Dados
Voc pode converter os dados de um tipo de dados para outro, usando os mtodos a seguir:

Passar dados entre portas com tipos de dados diferentes (converso porta a porta).

Usando funes de transformao para converter dados.

Usando operadores de transformao aritmticos para converter dados.

Converso de Dados Porta a Porta


O Servio de Integrao converte os dados com base no tipo de dados da porta. Toda vez que os dados
passam atravs de uma porta, o Servio de Integrao examina o tipo de dados atribudo porta e converte
os dados, se necessrio.
Quando voc passa dados entre portas do mesmo tipo de dados numrico e os mesmos so transferidos
entre transformaes, o Servio de Integrao no os converte para a escala e preciso da porta por onde
os dados so passados. Por exemplo, transfira dados entre duas transformaes em um mapeamento. Se

Tipos de dados XML e de Transformao

275

voc passar dados de uma porta decimal com uma preciso de 5 para uma porta decimal com uma preciso
de 4, o Servio de Integrao armazena o valor internamente e no trunca os dados.
Voc pode converter dados passando-os entre portas com tipos de dados diferentes. Por exemplo, converta
uma string em um nmero passando-o por uma porta de Nmero inteiro.
O Servio de Integrao realiza converses porta a porta entre transformaes e entre a ltima
transformao em um fluxo de dados e um destino.
A tabela a seguir descreve as converses porta a porta que o Servio de Integrao realiza:
Tipo de
dados

Bigint

Nmero
inteiro,
Nmero
inteiro
curto

Decimal

Duplo,
Real

String,
Texto

Nstring,
Ntext

Data/
Hora

Binrio

Bigint

No

Sim

Sim

Sim

Sim

Sim

No

No

Nmero
inteiro,

Sim

No

Sim

Sim

Sim

Sim

No

No

Decimal

Sim

Sim

No

Sim

Sim

Sim

No

No

Duplo,
Real

Sim

Sim

Sim

No

Sim

Sim

No

No

String,
Texto

Sim

Sim

Sim

Sim

Sim

Sim

Sim

No

Nstring,
Ntext

Sim

Sim

Sim

Sim

Sim

Sim

Sim

No

Data/Hora

No

No

No

No

Sim

Sim

Sim

No

Binrio

No

No

No

No

No

No

No

Sim

Nmero
inteiro
curto

Convertendo Strings em Datas


Voc pode converter strings em valores de data e hora passando as sequncias para uma porta Data e
Hora. Entretanto, as strings devem ser armazenadas no formato de data definido pela propriedade de
sesso String de Formato de Data e Hora.

Convertendo Strings em Nmeros


O Servio de Integrao converte strings em nmeros com base no formato numrico ASCII.

276

Apndice A: Referncia do Tipo de Dados

A tabela a seguir oferece exemplos de como o Servio de Integrao converte strings em nmeros, quando
voc passa as strings de uma porta de string a uma porta numrica:
String

Converte para decimal

Duplo, Real

Begint, Nmero Inteiro, Nmero


Inteiro Curto

18e-3

18

0.018

18

18-e-3abc

18

0.018

18

123abc

123

123

123

A123cb

abc

Converso de Dados

277

NDICE

A
abrindo
mapeamentos 110
adicionando
instrues de atualizar destino 133
origens para mapeamentos 124
repositrios 18
agendando
sesses para assistentes de mapeamento 250
agregado
definio (metadados) 207
alta preciso
tipo de dados Bigint 256
tipo de dados Decimal 256
analisador
Transformao de Dados 98
aplicativos OLAP
metadados 206
argumentos
para funes definidas pelo usurio 167
armazenamento de palavra
COBOL 45
arquivo rejeitado da sesso
usando para dados excedentes 131
usando para dados truncados 131
arquivos de largura fixa
configuraes avanadas 60
importando origens 60
arquivos de parmetros
especificando o local para a sesso de depurao 182
strings de expresso, definindo 163
arquivos simples
assistente de importao 52
atualizando definies de origem ASCII 58
caracteres de alternao consecutiva 74
comparando com tipos de dados de transformao 274
configuraes de caractere com suporte 52
configuraes de coluna 53
criando por transao 129
dados multibyte 75
delimitado 66
diferencia deslocamentos 73
editando propriedades de definio de destino 58
editando propriedades de definio de origem 58
formatando colunas 67
importando delimitado 64
importando largura fixa 60
importando, viso geral 52
pgina de cdigo 52
pginas de cdigo 75
preciso, destinos 75
regras para delimitados 66
requisitos para arquivo simples que diferencia a tecla Shift 74
solucionando problemas 75
tipos de dados, leitura 274

278

arquivos simples ()
tratamento de caracteres especiais 52
arquivos simples delimitados
configuraes avanadas 64
configuraes de coluna 55
configuraes de linha 64
importando definies de origem 64
regras 66
Assistente de Arquivo Simples
configuraes da coluna de arquivo simples 53
configuraes da coluna delimitada 55
importando definies de origem 52
opes de arquivo delimitado 55
opes de arquivo simples 53
Assistente de Dimenses de Alterao Lenta
criando destinos para 249
descrio 215
mapeamento da Dimenso de Tipo 1 221
Mapeamento da Dimenso de Tipo 2/Dados de Verso 215, 225
Mapeamento da Dimenso de Tipo 2/Sinalizar Atual 215, 231
mapeamento da Dimenso de Tipo 3 215, 243
Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo 215,
237
origens 216
sesses de agendamento 250
Assistente de Gerao de Fluxo de Trabalho
regras e diretrizes 138
viso geral 138
Assistente de Introduo
criando destinos 249
descrio 215
mapeamento de destino com crescimento lento 215, 218
mapeamento de passagem 215, 217
origens 216
sesses de agendamento 250
Assistente do Depurador
configurando 180
Assistente para Cubos
viso geral 209
assistentes
Assistente de Arquivo Simples 52
Assistente de Dimenses de Alterao Lenta 215
Assistente de Introduo 215
Assistente para Cubos 209
viso geral de tipos de mapeamento 214
assistentes de mapeamento
Assistente de Dimenses de Alterao Lenta 215
criando destinos 249
Guia de Introduo 215
origens 216
sesses de agendamento de 250
viso geral 214
atalhos
como componentes comerciais 204
criando 19
em mapplets 142

atributos
propagados 121
atributos de campo
definies de origem COBOL 46
atualizao do destino
adicionando instrues 133
viso geral 131
atualizando
definies da origem do arquivo simples 58
definies de origem relacional 39
destinos relacionais 90
modificando a instruo SQL 132
regras para atualizaes de destino 132

B
barra de ferramentas Exibir
viso geral 10
barra de ferramentas Layout
viso geral 10
Barra de Ferramentas Padro
viso geral 10
barra de ferramentas Repositrio
viso geral 10
barra de status
definio 2
barras de ferramentas
criando 12
descrio 10
Designer 10
exibindo 12
personalizando 12
bigint
constantes em expresses 257
gravando em arquivos simples 258
tratamento de alta preciso 256
usando nos clculos 256
bloqueando
componentes comerciais 203
bloqueando transformaes
validao de fluxo de dados 136

C
caminhos de link
exibindo 113
propagando dependncias 118, 119
campos
definies de origem COBOL 44
excluindo 23
movendo 23
campos de descrio
preciso mxima 58, 91
caracteres curinga
Nomes de origem da Transformao de Dados 102
caracteres nulos
arquivo simples 62
origem de largura fixa 60
chaves
criando destinos 91
relacionamentos importantes e reimportao de origem 40
COBOL
comparando com tipos de dados de transformao 274
controle de tabulao 42
copybook 42
criando destinos normalizados 83

coluna FileName
destinos de arquivos simples 59
executando uma sesso com destinos de arquivo simples 129
exemplo de arquivo simples 130
gerando destinos de arquivo simples 129
colunas
adicionando a destinos 59
adicionando s dimenses 208
configuraes do arquivo delimitado 55
destinos relacionais 92
colunas COMP
armazenamento de palavra COBOL 45
comentrios
adicionando a definies de origem 39
adicionando a mapeamentos 112
comparando
dependncias de mapeamento e mapplet 200
destinos 200
extenses de metadados 200
instncias de destino 200
instncias de mapplet 200
instncias de origem 200
instncias de transformao 200
links de mapeamento e mapplet 200
mapeamentos e mapplets 200
mapeando parmetros e variveis 200
ordens de carregamento do destino 200
origens 200
transformaes reutilizveis 200
componente streamer
Transformao de Dados 98
componente transformador
Transformao de Dados 98
componentes comerciais
adicionando atalhos 204
atalhos locais versus globais 204
bloqueando 203
copiando 205
criando 204
definio 202
diretrios 202
excluindo 204
movendo 203
vinculando-se documentao 203
viso geral 202
condies de ponto de interrupo de dados
globais 179
transformaes 178
viso geral 177
conectando
grupos de sada de mapplet 148
mapplets com substituio SQL 148
mapplets para mapeamentos 147
objetos nos mapeamentos 114
origens aos destinos, viso geral 114
portas 116
regras para conectar objetos 115
transformaes 116
vrias transformaes 115
conexes
validando 115, 135
configurando
Depurador 180
ferramentas personalizadas 13
Linhagem de dados 197
pontos de interrupo 174
portas de mapplet 147

ndice

279

conjuntos de caracteres
Assistente de Arquivo Simples 52
conjuntos de registros
definies de origem COBOL 44
controle de verso
barra de ferramentas 10
convenes de nomenclatura
para mapeamentos 109
converso de dados porta a porta
viso geral 275
convertendo
strings em nmeros 274, 276
strings para datas 276
tipos de dados 274
copiando
componentes comerciais 205
diretrio de componentes comerciais 205
funes definidas pelo usurio 170
mapeamentos 110
mapplets 146
copiar como
mapeamentos 111
cores
configurando 6
opes de formato 6
criando
chaves de destinos 91
componentes comerciais 204
cubos 209
definies da origem do arquivo simples 59
definies de destino 77, 88
definies de destino do arquivo simples 59
dimenses 208
diretrio de componentes comerciais 204
funes definidas pelo usurio 168
mapeamento da Dimenso de Tipo 1 221, 224
Mapeamento da Dimenso de Tipo 2/Dados de Verso 225, 230
Mapeamento da Dimenso de Tipo 2/Sinalizar Atual 231, 236
mapeamento da Dimenso de Tipo 3 243, 248
Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo 237,
242
mapeamentos 109
mapplets 144
pontos de interrupo 174
portas de mapplet 147
tabelas de destino 249
cubos
abrindo e fechando 211
adicionando tabelas de fato 209
assistente para criao 209
criando 209
definio (metadados) 207
dicas 212
editando 210
excluindo 211
exibindo metadados 211
Tipo de banco de dados 209
viso geral 206

D
dados
convertendo porta a porta 274
convertendo strings em nmeros 274
convertendo tipos de 274
tratando truncados e de estouro 131
visualizando 24

280

ndice

dados da transformao
monitorando 187
Dados de Instncia
janela 2
dados excedentes
manipulando 131
dados histricos
diferenciando do atual 213
mantendo 213
dados truncados
manipulando 131
Data Transformation Studio
viso geral 97
datas
exibir formato 19
decimal
tratamento de alta preciso 256, 259
definio
parmetros de mapeamento 157
definies de arquivo simples
gerando arquivos simples por transao 129
definies de destino
adicionando a mapeamentos 124
adicionando colunas 59, 92
atualizao, relacional 90
comparando tipos de dados com transformaes 86
conectando portas 114
criao a partir de uma transformao com vrios grupos 85
criando a partir de definies de origem 82
criando a partir de transformaes 84, 87, 88
criando chaves 91
criando de um mapplet 86
criando de uma transformao Normalizador 85
criando os ndices 93
criando, viso geral 77
definindo opes 89
editando definies relacionais 89
etapas para criar a partir de transformaes 87
gerando tabelas de destino de 94
importando destinos relacionais 80
importando ndices 80
renomeando 90
solucionando problemas 95
tratamento de caracteres especiais 78
viso geral, relacional 77
visualizando dados 24
definies de origem
adicionando a mapeamentos 124
alterando o tipo de banco de dados 39
atualizando 39
atualizando ASCII 58
atualizando relacional 39
COBOL 44
conectando portas 114
editando a largura fixa 58
editando COBOL 44
editando relacional 39
em mapplets 142
Importando arquivo simples delimitado 64
importando o Microsoft Excel 48
importando relacional 37
para assistentes de mapeamento 216
reimportar 40
renomeando 39
tratamento de caracteres especiais 34
usando como base para as definies de destino 82
viso geral 33, 51

definies de origem COBOL


armazenamento de palavra 45
atributos de campo 46
campos 44
clusulas PICTURE 46
componentes 43
configurao de propriedades 44
copybooks 42
importando 42
instruo OCCURS 44, 46
Instruo REDEFINES 44
opes de tabela 45
pginas de cdigo 41
Seo FD 43, 46
dependncias
caminho do link 118, 119
exibindo 113
implcitas 118, 120
propagados 121
dependncias da coluna de origem
exibindo 113
dependncias implcitas
propagando 118, 120
depurao
mapeamentos 112, 172
mapplets 182
Depurador
ANY-PORT 177
Assistente do Depurador 180
avaliando expresses 193
barra de ferramentas 10
Comportamento do Designer 186
condies dos dados 177
configurando 180
continuando 189
copiando a configurao 194
criao de uma sesso de depurao 181
criando pontos de interrupo 172, 174
em execuo no modo de depurao 181
estado de execuo 183
estado de inicializao 183
estado pausado 184
estados 183
executando 183
indicadores de depurao 187
janela Dados de Destino 2
janela Dados de Instncia 2
Janela de destino 186
janela Instncia 186
modificando dados 192
monitorando dados de destino 189
opes 8
opes de destino 182
pontos de interrupo de dados 176
pontos de interrupo de erro 176
prxima instncia 189
restries para modificao de dados 193
ROW-ID 177
ROW-TYPE 177
tarefas 184
tipo de sesso 181
valores persistentes 186
viso geral 172
desalinhamento
Arquivo simples 53
descrio da coluna
manter ao reimportar uma origem 40

descrio da origem
manter ao reimportar uma origem 40
descrio da porta
manter ao reimportar uma origem 40
Designer
abrindo e fechando uma pasta 19
adicionando mapeamentos 109
barra de status 2
barras de ferramentas 10
Comandos DDL do SQL 94
comportamento durante as sesses do Depurador 186
configurando linhagem de dados 197
copiando objetos 21
criando atalhos 19
criando barras de ferramentas 12
criando links para a documentao comercial 30
documentao comercial 29
exibindo a linhagem de dados 197
exibindo relatrios 31
exportando objetos 22
fazendo check-out e check-in de objetos com verso 19
ferramentas 1
formato de exibio de data 19
formato de exibio de hora 19
importando objetos 22
imprimindo mapeamentos 18
janela Dados de Destino 2
janela Dados de Instncia 2
janela de sada 2
janela do espao de trabalho 2
janelas 2
Mapping Designer 1
Mapplet Designer 1
Navegador 2
personalizando barras de ferramentas 12
personalizando opes 3
pesquisando 14
procurando objetos com verso 20
Source Analyzer 1
tarefas 18
Target Designer 1
teclas de atalho 23
trabalhando com componentes comerciais 202
validao de porta 116
viso geral 1
zoom 17
Destino da Transformao de Dados
configuraes 103
definindo o nome do servio 98
descrio 103
guias 103
portas 103
processamento da sesso 105
tipo de entrada 103
viso geral 97
destinos
adicionando a mapeamentos 77
assistentes de mapeamento 249
comparando 200
conectando vrias transformaes a 115
dados de mapplet 142
editando cubos 210
editando dimenses 210
em mapeamentos 127
exibindo dependncias de origem 113
extenses de metadados em 26
gerando arquivos simples por transao 129
pginas de cdigo 78

ndice

281

destinos ()
prefixo de nome de tabela, nome do proprietrio 133
regras para atualizao 132
substituio de atualizao de destino 131
substituio SQL de destino 131
Substituindo atualizao para incluir colunas no-chave 132
substituindo o nome da tabela de destino 134
tipos de banco de dados 77
viso geral, relacional 77
visualizando dados 24
dicas
criando mapplets 150
cubos e dimenses 212
diferencia deslocamentos
arquivos simples 73
caracteres de alternao consecutiva 74
requisitos 74
dimenses
alterao lenta 213
crescimento lento 213
criando 208
definio (metadados) 207
dicas 212
editando 210
excluindo 211
exibindo metadados 211
tipo de banco de dados para 208
viso geral 206
diretrio de componentes comerciais
copiando 205
criando 204
editando 203
excluindo 204
diretrios
agrupando componentes comerciais 202
documentao
caminho 30
documentao comercial
adicionando links a mapeamentos 39, 112
criando links 30
exibindo 31
para expresses 29
para objetos de repositrio 29
raiz 30
domnios
extenses de metadados 26
Drivers ODBC (Open Database Connectivity) da DataDirect
drivers especficos da plataforma obrigatrios 37, 80
duplo
tratamento de alta preciso 259

E
editando
cubos 210
definies de origem relacional 39
dimenses 210
diretrio de componentes comerciais 203
funes definidas pelo usurio 169
mapeamentos 111
mapplets 145
Editor de Expresso
funes pblicas e privadas 167
parmetros de mapeamento 157
usando funes definidas pelo usurio 170
variveis de mapeamento 163

282

ndice

Editor de SQL
usando para modificar a instruo UPDATE 132
Editor de XML
visualizando dados 24
erros
Porta 115
validados durante mapeamentos 135
escala
descrio 59, 67
destinos relacionais 92
origens relacionais 39
espao de trabalho
criando cone 16
navegando 14
recuperando 16
utilizao de 2
zoom 17
Espao de trabalho
impresso 18
modo de exibio de tela inteira 17
esquema em estrela
definio 206
mantendo 213
esquema floco de neve
definio 206
Etapa para a instncia
Depurador 189
Excel
tipos de dados 272
excluindo
componentes comerciais 204
cubos 211
dimenses 211
diretrio de componentes comerciais 204
funes definidas pelo usurio 169
mapeamentos 112
mapplets 146
exibies MX
desempenho 3
exibindo
barras de ferramentas 12
caminhos de link 113
data 19
dependncias da coluna de origem 113
documentao comercial 31
hora 19
cones 16
linhagem de dados 197
metadados para cubos e dimenses 211
tela inteira 17
verses mais antigas de objetos 20
zoom 17
exportando
funes definidas pelo usurio 170
mapeamentos 111
mapplets 146
objetos 22
exportar o esquema da hierarquia
Origem da Transformao de Dados 101
expresses
criando com funes definidas pelo usurio 167, 170
validando 136
extenses de metadados
comparando todos os mapeamentos 200
criando 26
domnios 26
editando 27
excluindo 28

extenses de metadados ()
viso geral 26

F
fazendo check-in
objetos com verso 19
fazendo check-out
objetos com verso 19
Ferramenta Localizar no Espao de Trabalho
viso geral 14
Ferramenta Localizar Prximo
viso geral 14
ferramentas
barra de ferramentas 10
opes de depurao 8
opes de servio da web 9
personalizao de configurao 13
ferramentas personalizadas
configurando 13
funo ISNULL
condies de ponto de interrupo 179
funes
em variveis de mapeamento 160
funes definidas pelo usurio 166
funes definidas pelo usurio
aninhando 167
configurando argumentos 167
configurando sintaxe de funo 167
copiando 170
criando 168
editando 169
excluindo 169
exportando 170
importando 170
no Editor de Expresso 170
validando 170
viso geral 166

G
globalizao
origens 33
grupos de implantao
funes definidas pelo usurio, adicionando 170
grupos de ordem de carregamento de destino
descrio 128
grupos de sada
conectando-se a portas de sada nos mapplets 148
definio 142
portas 147
Guia Configuraes
Origem da Transformao de Dados 99
guia Depurador
janela Sada 186
monitorando log de depurao 190
Guia Hierarquia de Sada
Origem da Transformao de Dados 99
guia Log de Sesso
janela Sada 186

hierarquias
adicionando s dimenses 209
definio (metadados) 207
exemplo de esquema 206
hora
formato de exibio 19

I
IBM DB2
comparando com tipos de dados de transformao 261
IFCONTENTMASTER_HOME
varivel de ambiente 97
importando
arquivos simples 52
definies de destino relacional 80
definies de origem de arquivo simples de largura fixa 60
definies de origem do arquivo simples delimitado 64
definies de origem do Microsoft Excel 48
definies de origem relacional 37
funes definidas pelo usurio 170
mapeamentos 111
mapplets 146
objetos 22
origens COBOL 42
impresso
mapeamentos 18
indicadores de depurao
monitorando 187
Informix
comparando com tipos de dados de transformao 261
insero
descries do objeto de repositrio 20
instncia de destino
SQL de pr- e ps-sesso 134
instruo OCCURS
definies de origem COBOL 44
instruo REDEFINES
definies de origem COBOL 44
inteiros
constantes em expresses 257
convertendo de strings 258
gravando em arquivos simples 258
usando nos clculos 256
invalidao
sesses 112
ISDEFAULT
condies de ponto de interrupo 179

J
janela Dados de Destino
descrio 2
Janela de destino
Depurador 186
monitorando 189
janela Instncia
Depurador 186
monitorando dados 187
janela Sada
exemplo de validao de mapeamento 137
guia Depurador 186
guia Log de Sesso 186

Habilitar Alta Preciso


parmetro de sesso de depurao 182

ndice

283

L
largura do campo
descrio 67
linhagem de dados
exibindo 197
Linhagem de dados
configurando 197
descrio 196
lista de arquivos
Porta CurrentlyProcessedFileName 73
retornando nomes de arquivo de origem com linhas de dados 73
log de depurao
exemplo 190
monitorando 190

M
mantendo
dados histricos 213
esquemas em estrela 213
mapeador
Transformao de Dados 98
mapeamento da Dimenso de Tipo 1
criando 221, 224
descrio 215
manipulao de chaves 222
objetos de repositrio criados 222
opes de sesso 225
transformaes 223
viso geral 221
mapeamento da Dimenso de Tipo 2/Dados de Verso
manipulao de chaves 226
numerando as verses 226
objetos de repositrio criados 227
transformaes 228
Mapeamento da Dimenso de Tipo 2/Dados de Verso
criando 225, 230
descrio 215
opes de sesso 231
personalizando 230
Mapeamento da Dimenso de Tipo 2/Sinalizar Atual
criando 231, 236
descrio 215
manipulao de chaves 232
objetos de repositrio criados 233
opes de sesso 237
transformaes 234
viso geral 231
mapeamento da Dimenso de Tipo 3
criando 243, 248
descrio 215
manipulao de chaves 244
objetos de repositrio criados 245
opes de sesso 249
transformaes 246
viso geral 243
mapeamento de destino com crescimento lento
chaves, manipulao 219
criando 218
descrio 215
objetos de repositrio criados 219
opes de sesso 221
viso geral 218
mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo
manipulao de chaves 238
objetos de repositrio criados 238

284

ndice

Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo


criando 237, 242
descrio 215
opes de sesso 243
transformaes 240
viso geral 237
mapeamento de passagem
criando 217
descrio 215
objetos de repositrio criados 217
opes de sesso 218
personalizando 218
viso geral 217
mapeamento de passagem simples
descrio 215
mapeamentos
abrindo 110
adio de mapplets 147
adicionando comentrios 112
adicionando destinos 77
adicionando origens 124
atualizando os destinos 89
barra de ferramentas 10
comparando 200
comparando dependncias 200
comparando links 200
conectando a porta FileName de arquivo simples 129
conectando objetos 114
copiando 110
copiar como 111
criando 109
depurao 112
destino de crescimento lento 215
editando 111
editando alteraes no banco de dados relacional 35, 39
esquemas em estrela 213
excluindo 112
exibindo relatrios 31
exportando 111
extenses de metadados em 26
importando 111
impresso 18
imprimindo diferenas entre 200
mapeamento da Dimenso de Tipo 1 221
Mapeamento da Dimenso de Tipo 2/Dados de Verso 215, 225
Mapeamento da Dimenso de Tipo 2/Sinalizar Atual 215, 231
mapeamento da Dimenso de Tipo 3 215, 243
mapeamento de destino com crescimento lento 218
Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo 215,
237
mapeamento de passagem 215, 217
motivos de invalidao 35
processo 108
renomeando 112
revertendo para verses anteriores 111
substituindo o nome da tabela de destino 134
substituindo o nome da tabela de origem 125
tarefas 109
trabalhando com destinos 127
trabalhando com mapplets 126
trabalhando com transformaes 126
validando 135
validando vrios 138
viso geral da depurao 172
Mapping Architect for Visio
modelos de mapeamento 108
Mapping Designer
criando mapeamentos 109

Mapping Designer ()
utilizao de 1
Mapplet Designer
utilizao de 1, 141
mapplets
adicionando uma descrio 146
ativa e passiva 144
atributos de porta 147
barra de ferramentas 10
comparando 200
comparando dependncias 200
comparando instncias 200
comparando links 200
componentes 142
comportamento da sesso 141
conectando portas de entrada 147
conectando-se com a substituio SQL 148
configurando 144
copiando 146
criao da lgica de transformao 144
criando 144
criando destinos de 86
dados de origem de entrada 142
data destino 142
definio 141
definir nvel de rastreamento 146
dicas para criao 150
editando 145
em mapeamentos 126
excluindo 146
exibindo relatrios 31
exportando 146
extenses de metadados em 26
grupos de sada 142, 147, 148
ilustrao de 143
importando 146
imprimindo diferenas entre 200
monitorando dados 187
objetos do repositrio com suporte 143
objetos no compatveis 149
origens dentro do mapplet 142
particionamento de pipeline 149
portas 147
portas de entrada 142
portas de sada 142
regras de validao 145
selecionando para depurao 182
uso em mapeamentos 147
validando 145
variveis de mapeamento 161
viso geral 141
viso geral de sada 142
medida
definio (metadados) 207
metadados
agregado 207
cubos 207
dimenso 207
esquema em estrela 207
esquema floco de neve 207
exibindo cubos e dimenses 211
hierarquias 207
medida 207
multidimensional 206
nveis 207
normalizao 207
redundncia 207
sondagem 207

metadados ()
tabela fato 207
metadados multidimensionais
viso geral 206
Metadata Manager
configurando linhagem de dados 197
exibindo a linhagem de dados 196
Microsoft Access
tipos de dados 272
Microsoft Excel
formatando dados numricos 49
importando definies de origem 49
tipos de dados 272
Microsoft SQL Server
comparando com tipos de dados de transformao 263
tipos de dados 263
modificando dados
Depurador 192
modo de movimentao de dados
tipos de dados 254
Modo Unicode
preciso de ODBC 272
monitorando
data destino 189
Depurador 186, 191
indicadores de depurao 187
log de depurao 190
MX (Metadata Exchange)
salvando dados 3

N
NaN
descrita 257
no normalizado
atributo de cubo 209
tabelas de dimenses 206
Navegador
excluindo mapeamentos de 112
utilizao de 2
nveis
adicionando hierarquia 209
adicionando s dimenses 208
definio (metadados) 207
tabelas de dimenses 208
nveis de rastreamento
em mapplets 146
Nvel de Rastreamento do Status
Origem da Transformao de Dados 99
Nome de Sada Dinmico
Destino da Transformao de Dados 103
nome do proprietrio da tabela
destinos 133
nome do servio
definindo para Transformao de Dados 98
Nome do Servio Dinmico
Destino da Transformao de Dados 103
nomes comerciais
adicionado a origens 28
adicionando a definies de destino 58, 91
adicionando a destinos 28
como nomes de coluna de destino 29
como nomes de coluna de origem 29
destinos de exibio 3
exibindo no Navegador 29
no Qualificador de Origem 29
origens de exibio 3

ndice

285

nomes comerciais ()
renomeando origens importadas 37
usando 28
nomes de tabela
substituindo o nome da tabela de destino 134
substituindo o nome da tabela de origem 125
normalizao
definio (metadados) 207
normalizadas
atributo de cubo 209
esquema multidimensional 206
nmeros inteiros curtos
constantes em expresses 257
gravando em arquivos simples 258
usando nos clculos 256

O
objetos
conexo em mapeamentos 114
copiando 21
exibindo a linhagem de dados 197
Objetos
comparando 20
exibindo verses mais antigas 20
objetos com verso
comparando verses anteriores 20
exibindo no espao de trabalho 20
exibindo vrias verses 20
fazendo check-in 19
fazendo check-out 19
Opo Permitir Excluso sem Check-out 9
pesquisas no Designer 20
objetos de repositrio
com suporte em mapplets 142
descrio 20
editando 23
objetos do espao de trabalho
criando cone 16
recuperando 16
ODBC (Open Database Connectivity)
comparando tipos de dados com a transformao 272
Importando definies de destino 80
importando definies de origem 37
preciso no modo unicode 272
Problemas de driver da DataDirect 37, 80
opo Rejeitar Linhas Truncadas/De estouro
usando 131
opes
depurar 8
servios da Web 9
temas de cor, selecionando 8
opes (Designer)
formatar 6
Geral 3
tabelas 5
opes de formato
configurando no Designer 6
opes gerais
Designer, configurando 3
opes padro
Designer, personalizao 3
operaes numricas
convertendo strings em datas 276
convertendo strings em nmeros 276
Oracle
comparando com tipos de dados de transformao 265

286

ndice

Oracle ()
valores Nmero(P,S) 266
ordem de carregamento do destino
comparando todos os mapeamentos 200
configurao 128
Origem da Transformao de Dados
definindo o nome do servio 98
exportando a hierarquia de sada 101
grupos de portas de sada 101
Guia Configuraes 99
guias 99
Porta ServiceName 100
portas 100
processamento da sesso 102
usando caracteres curinga nas propriedades da sesso 102
viso geral 97
origens
adicionando a mapeamentos 124
adicionando s dimenses 208
caractere nulo 62
comparando 200
conectando destinos 114
configurando 6
dentro de mapplets 142
destinos conectados 113
extenses de metadados em 26
pgina de cdigo de arquivo simples 60, 64
para assistentes de mapeamento 216
recursos de globalizao 33
solucionando problemas 50
substituindo o nome da tabela de origem 125
Origens COBOL
controle de tabulao 42

P
pginas de cdigo
arquivos simples 75
destinos relacionais 78
origem de largura fixa 60
origem delimitada 64
Origens COBOL 41
parmetros de mapeamento 155
perda de caractere 75
variveis de mapeamento 155
palavras chave
definindo os destinos relacionais 91
parmetros
mapeamentos 152
parmetros de mapeamento
comparando 200
conveno de nomenclatura 156
criando 156
definio 155, 157
dicas de uso 164
expandindo em expresses 163
formato de data e hora 156
pginas de cdigo 155
propriedade IsExprVar 156, 163
usando em expresses 157
valores iniciais 153
valores padro 153
viso geral 152
particionamento de pipeline
mapplets 149
pastas
abrindo e fechando 19

pastas ()
copiar como 110
perda de caractere
arquivos simples 75
pginas de cdigo 75
pesquisando
Designer 14
objetos com verso no Designer 20
pontos de interrupo
arquivos .dcf 194
condies de dados de transformaes 178
condies de dados globais 179
condies de erro 176
condies dos dados 176, 177
copiando 194
criando 172, 174
Depurador 172
etapas para inserir 179
globais 175
ISDEFAULT 179
ISNULL 179
nome da instncia 175
transformao 175
pontos de interrupo de dados
opes de transformao 177
opes globais 177
Porta CurrentlyProcessedFileName
adicionando a origens de arquivos 73
Porta ServiceName
Origem da Transformao de Dados 100
portas
adicionado a transformaes de Entrada e Sada 147
atributos de propagao 118
conectando 116
conectando a entrada de mapplet 147
conectando a vrias transformaes 115
criando em mapplets 147
dependncias de origem 113
erros 115
excluindo 23
Origem da Transformao de Dados 100
renomeando 23
vinculao 116
vinculando por nome 117
vinculando por posio 116
portas de entrada
conectando mapplet 147
definindo em mapplets 142
viso geral 114
portas de entrada/sada
viso geral 114
portas de mapplet
adicionado a transformaes de Entrada e Sada 147
configurando 147
criando 147
portas de sada
mapplets 142
viso geral 114
powrmart.ini
configure para drivers de terceiros 38, 81
importando ndices de destino 80
tamanho de tabulao padro 42
preciso
arquivos simples 75
descrio 59, 67
destinos relacionais 92
origens relacionais 39

preencher a partir do servio


Portas de Transformao de Dados 106
prefixo de nome de tabela
proprietrio de destino 133
privada
configurando funes definidas pelo usurio 167
propagar
atributos de porta 118
propriedade IsExprVar
parmetros de mapeamento 156, 163
variveis de mapeamento 161, 163
propriedades do arquivo COBOL
configurando Propriedades avanadas 45
Propriedades do arquivo COBOL
configurando a guia Colunas 46
configurando a guia Tabela 45
proprietrio de destino
prefixo de nome de tabela 133
Prxima instncia
Depurador 189
pblica
configurando funes definidas pelo usurio 167

Q
QNAN
convertendo para 1.#QNAN 257

R
redundncia
definio (metadados) 207
registros
atualizando para incluir colunas no-chave 132
regras
arquivos simples delimitados 66
para atualizao de destino 132
Relatrio de Composio de Mapeamento
exibindo 31
Relatrio de Composio do Mapplet
exibindo 31
Relatrios do Repositrio do PowerCenter
exibindo no Designer 31
renomeando
definies de origem 39
Repositrio de Transformao de Dados
localizao 97
viso geral 97
Repositrio do PowerCenter
exibindo anlise da linhagem de dados 196
repositrios
adicionando 18
repositrios globais
componentes comerciais 204
Repository Manager
exibindo metadados em 211
restries
adicionando a definies de destino 91

S
salvando
dados histricos 213
Seo FD
definies de origem COBOL 43

ndice

287

serializador
Transformao de Dados 98
Servio de Integrao
uso do tipo de dados 254
Servio de Transformao de Dados
criando portas a partir de 106
servios
Transformao de Dados 98
servios da Web
compatibilidade com verses anteriores 9
opes 9
sesso de depurao
parmetros de sesso 181
sesses
agendamento de esquemas em estrela 250
atualizaes de definies de origem 39
configurando Dimenso Tipo 1 225
configurando Dimenso Tipo 2/Intervalo de Datas Efetivo 243
configurando Dimenso Tipo 2/Verso 231
configurando Dimenso Tipo 3 249
configurando uma Dimenso Tipo 2/Sinalizar Atual 237
destino de crescimento lento, configurando 221
em execuo no modo de depurao 181
invalidao 112
passagem, configurando 218
sintaxe
configurando funes definidas pelo usurio 167
Solicitao de Carregamento Baseado em Restries
parmetro de sesso de depurao 182
solucionando problemas
arquivos simples 75
definies de destino 95
origens 50
sondagem
definio (metadados) 207
Source Analyzer
editando definies de origem 39
importando definies de origem relacional 38
utilizao de 1
SQL
gerando e executando para criar destinos 94
SQL de pr- e ps-sesso
instncias de destino 134
strings
convertendo em datas 276
convertendo em nmeros 258, 276
strings de expresso
definindo em arquivos de parmetro 163
substituio SQL de destino
viso geral 131
substituindo
mapeando valores de varivel 163
Sybase ASE
comparando com tipos de dados de transformao 268
Sybase IQ
comparando com tipos de dados de transformao 268

T
tabelas
opes do Designer, configurando 5
tabelas de destino
criando 94
recriando 95
substituindo o nome da tabela 134
visualizando dados 24

288

ndice

tabelas de dimenses
metadados 206
modelos no normalizados 206
motivos para 213
nveis 208
origens 208
tabelas de origem
substituindo nome de tabela 125
tabelas fato
adicionando aos cubos 209
com metadados 206
definio 213
definio (metadados) 207
Tamanho da parte do streamer
Origem da Transformao de Dados 99
Tamanho de Buffer do DTM
parmetro de sesso de depurao 182
Target Designer
criando cubos e dimenses em 206
usando 77
utilizao de 1
teclas de atalho
teclado 23
tela inteira
exibir 17
temas de cor
aplicao 8
Teradata
comparando tipos de dados com a transformao 271
tipos de dados 271
tipo de banco de dados
para dimenses 208
Tipo de banco de dados
para cubos 209
tipo de funo
descrio 167
Tipo de linha
parmetro de sesso de depurao 182
tipos de dados
arquivo simples 274
Bigint 256
binary 258
COBOL 274
converso 274
Data/Hora 258
decimal 259
duplo 259
IBM DB2 260
Informix 261
lendo origens de arquivo simples 274
Microsoft SQL Server 263
nmero inteiro 256
Nmero Inteiro Curto 256
ODBC 272
Oracle 265
para argumentos de funo definidos pelo usurio 167
string 260
Sybase ASE 268
Teradata 271
tipos de dados de transformao nos destinos 86
tipos de dados nativos 254
transformao 254, 255
variveis de mapeamento 159
viso geral 254
XML 275
tipos de dados binrios
viso geral 258

Tipos de Dados de Data/Hora.


viso geral 258
tipos de dados de string
viso geral 260
tipos de dados de transformao
comparao com o Oracle 265
comparando Teradata 271
comparando com COBOL 274
comparando com IBM DB2 261
comparando com Informix 261
comparando com o arquivo simples 274
comparando com ODBC 272
comparando com Sybase ASE 268
comparando com Sybase IQ 268
lista de 255
Microsoft SQL Server 263
viso geral 254
tipos de dados decimais
viso geral 259
tipos de dados duplos
viso geral 259
tipos de dados nativos
viso geral 254
tipos de dados sinnimos
comparaes 265
Teradata 272
transformao Classificao
depurao 193
Transformao Controle de Transao
exemplo com uma transformao Expresso 130
Transformao de entrada
configurando 147
em mapplets 147
portas 147
Transformao de Qualificador de Origem de Aplicativo
descrio 124
Transformao de Qualificador de Origem XML
descrio 124
Transformao de sada
configurando 147
em mapplets 142, 147
portas 147
transformao Entrada
em mapplets 142
Transformao Expresso
exemplo com a transformao Controle de Transao 130
Transformao Gerador de Sequncia
depurao 193
transformao Normalizador
criando um destino de 85
depurao 193
descrio 124
Transformao Qualificador de Origem
descrio 124
nomes comerciais 29
opo para criar automaticamente 5
opo para criar manualmente 5
usando parmetros de string 154
usando variveis 154
transformaes
barra de ferramentas 10
comparando 200
conectando 116
criando 116
criando destinos de 84
em mapeamentos 126
em mapplets 142
extenses de metadados em 26

transformaes ()
mapeamento da Dimenso de Tipo 1 223
mapeamento da Dimenso de Tipo 2/Dados de Verso 228
Mapeamento da Dimenso de Tipo 2/Sinalizar Atual 234
mapeamento da Dimenso de Tipo 3 246
mapeamento de destino com crescimento lento 220
Mapeamento de Dimenso Tipo 2/Intervalo de Datas Efetivo 240
mapeamento de passagem 217
reutilizao em mapplets 141
Transformao de entrada 147
Transformao de sada 147
transformaes ativas
conectando 115
mapplets 144
transformaes passivas
conectando 115
mapplets 144
transformaes reutilizveis
em mapplets 142
tratamento de caracteres especiais
definies de arquivo simples 52
tabela de destino e nomes de campos 78
tabela de origem e nomes de campos 34
tratamento de erros
desalinhamento, arquivo simples 53

V
validao de fluxo de dados
viso geral 136
validao de objeto
viso geral 136
validando
funes definidas pelo usurio 170
mapeamentos 135
mapplets 145
vrios mapeamentos 138
valor atual
variveis de mapeamento 159
valor de conexo $Target
parmetro de sesso de depurao 182
valor de conexo $Source
parmetro de sesso de depurao 182
valor inicial
variveis de mapeamento 158
valores
variveis de mapeamento 158
valores iniciais
formato de data e hora 156, 161
parmetros de mapeamento 153
variveis de mapeamento 153
valores Nmero(P,S)
Oracle 266
valores padro
parmetros de mapeamento 153
variveis de mapeamento 153
valores persistentes
Depurador 186
variveis
expandindo em expresses 163
mapeamentos 152
variveis de ambiente
IFCONTENTMASTER_HOME 97
variveis de expresso
mapeando parmetros e variveis 163
variveis de mapeamento
comparando 200

ndice

289

variveis de mapeamento ()
conveno de nomenclatura 161
criando 161
definio 158
Depurador 186, 193
dicas de uso 164
expandindo em expresses 163
formato de data e hora 161
funes 160
limpando valores 163
mapplets 161
pginas de cdigo 155
propriedade IsExprVar 161, 163
substituindo valores 163
tipo de agregao 159
tipo de dados 159
usando em expresses 163
valor atual 159
valor inicial 158
valores 158
valores iniciais 153
valores padro 153
viso geral 152
varivel de raiz
viso geral 30
verses
revertendo aos mapeamentos anteriores 111
verses mais antigas de objetos
exibindo 20
vinculao
documentao de componente comercial 203
vinculao automtica por nome 117
vinculando automaticamente por posio 116
vincular automaticamente
por nome 117

290

ndice

vincular automaticamente ()
por posio 116
visualizao de dados
destinos relacionais 24
visualizando dados
dados XML 24
destino 24

W
Workflow Manager
adicionando repositrios 18
Workflow Monitor
monitorando o Depurador 191
WSDL
criao para mapeamentos gerados 9

X
XML
tipos de dados 275
visualizando dados 24

Z
zoom
formato de exibio 17

Vous aimerez peut-être aussi