Caminhos do Integration Services

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

Um caminho conecta dois componentes em um fluxo de dados conectando a saída de um componente de fluxo de dados à entrada de outro componente. Um caminho tem uma origem e um destino. Por exemplo, se um caminho conectar uma origem OLE DB e uma transformação Classificação, a origem OLE DB será a origem do caminho e a transformação Classificação será o destino do caminho. A origem é o componente onde o caminho inicia, e o destino é o componente onde o caminho termina.

Se você executar um pacote no Designer do SSIS, poderá ver os dados em um fluxo de dados anexando visualizadores de dados a um caminho. Um visualizador de dados pode ser configurado para exibir dados em uma grade. Um visualizador de dados é uma ferramenta útil de depuração. Para obter mais informações, consulte Debugging Data Flow.

Configurar o caminho

O Designer do SSIS fornece a caixa de diálogo Editor de Caminho do Fluxo de Dados para definir propriedades de caminho, exibindo os metadados das colunas de dados que passam pelo caminho e configurando visualizadores de dados.

As propriedades de caminho configurável incluem o nome, a descrição e a anotação do caminho. Você também pode configurar caminhos de forma programática. Para obter mais informações, consulte Conectando componentes do fluxo de dados programaticamente.

Uma anotação de caminho exibe o nome da origem do caminho ou o nome do caminho na superfície de design da guia Fluxo de Dados no Designer do SSIS. As anotações de caminho são semelhantes às anotações que você pode adicionar a fluxos de dados, fluxos de controle e manipuladores de eventos. A única diferença é que uma anotação de caminho é anexada a um caminho, ao passo que outras anotações aparecem nas guias Fluxo de Dados, Fluxo de Controle e Manipuladores de Eventos do Designer do SSIS.

Os metadados exibem nome, tipo de dados, precisão, escala, comprimento, página de código e componente de origem de cada coluna na saída do componente anterior. O componente de origem é o componente de fluxo de dados que criou a coluna. Isso pode ou não ser o primeiro componente no fluxo de dados. Por exemplo, as transformações Union All e Classificação criam as próprias colunas e são as origens de suas colunas de saída. Em contrapartida, uma transformação Copiar Coluna pode passar por colunas sem as alterá-las ou pode criar colunas novas copiando as colunas de entrada. A transformação Copiar Coluna é o componente de origem somente das novas colunas.

Definir as propriedades de um caminho por meio do Editor de Caminho do Fluxo de Dados

Os caminhos conectam dois componentes de fluxos de dados. Antes de você poder definir as propriedades do caminho, o fluxo de dados deve conter pelo menos dois componentes de fluxo de dados conectados.

  1. No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote desejado.

  2. No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.

  3. Clique na guia Fluxo de Dados e clique duas vezes em um caminho.

  4. No Editor de Caminho de Fluxo de Dado, clique em Geral. É possível editar o nome padrão do caminho e fornecer uma descrição do caminho. É possível também modificar a propriedade PathAnnotation.

  5. Clique em OK.

  6. Para salvar o pacote atualizado, clique em Salvar Itens Selecionados no menu Arquivo .

Página Geral – Editor de Caminho do Fluxo de Dados

Use a caixa de diálogo Editor de Caminho de Fluxo de Dados para definir propriedades de caminho, visualizar metadados de colunas e gerenciar os visualizadores de dados que estão anexados ao caminho.

Use o nó Geral da caixa de diálogo Editor de Caminho de Fluxo de Dados para nomear e descrever o caminho e especificar as opções de anotação de caminho.

Opções

Nome
Forneça um nome exclusivo para o caminho.

ID
O identificador de linhagem exclusivo do caminho. Essa propriedade é somente leitura.

IdentificationString
A cadeia de caracteres que identifica o caminho. Gerada automaticamente a partir do nome digitado acima.

Descrição
Descreva o caminho.

PathAnnotation
Especifique o tipo de anotação a ser usada. Escolha Never para desabilitar anotações, AsNeeded para habilitar anotação sob demanda, SourceName para anotações automáticas usando o valor da opção SourceName , e PathName para anotações automáticas usando o valor da propriedade Name .

DestinationName
Exibe a entrada que é o final do caminho.

SourceName
Exibe a saída que é o início do caminho.

Página de Metadados – Editor de Caminho do Fluxo de Dados

Use a página Metadados da caixa de diálogo Editor do Caminho de Fluxo de Dados para exibir o metadados das colunas de caminho.

Opções

Página de metadados
Lista metadados das colunas. Clique nos títulos das colunas para classificar seus dados.

Nome
Lista o nome da coluna.

Tipo de Dados
Lista o tipo de dados da coluna.

Precisão
Lista o número de dígitos em um valor numérico.

Escala
Lista o número de dígitos à direita da casa decimal em um valor numérico.

Comprimento
Lista o comprimento atual da coluna.

Página de Código
Lista a página de código da coluna. O valor 0 indica que a coluna não usa uma página de código. Isso acontece quando os dados estão em Unicode ou têm tipo de dados numérico, de data ou de hora.

Posição da Chave de Classificação
Lista a posição da chave de classificação da coluna. O valor 0 indica que a coluna não está classificada.

Observação

Um prefixo de menos (-) indica que a coluna está em ordem decrescente.

Sinalizadores de Comparação
Lista os sinalizadores de comparação aplicados à coluna.

Componente de Origem
Lista o componente do fluxo de dados que é a origem da coluna.

Copiar para a Área de Transferência
Copia os metadados da coluna para a área de transferência. Por padrão, todas as linhas de metadados são copiadas na ordem exibida atualmente.

Página Visualizadores de Dados – Editor de Caminho do Fluxo de Dados

Use a página Visualizadores de Dados da caixa de diálogo Editor de Caminho de Fluxo de Dados para gerenciar os visualizadores de dados que estão anexados ao caminho.

Opções

Nome
Lista os visualizadores de dados.

Tipo de Visualizador de Dados
Lista o tipo de visualizador de dados.

Adicionar
Clique para adicionar um visualizador de dados usando a caixa de diálogo Configurar Visualizador de Dados .

Delete (excluir)
Clique para excluir o visualizador de dados selecionado.

Configurar
Clique para configurar um visualizador de dados selecionado, usando a caixa de diálogo Configurar Visualizador de Dados .

Path Properties

Os objetos de fluxo de dados no modelo de objeto do Microsoft SQL Server Integration Services têm propriedades comuns e personalizadas no nível de componente, de entradas e saídas e de colunas de entrada e saída. Muitas propriedades têm valores somente leitura, atribuídos em tempo de execução pelo mecanismo de fluxo de dados.

Esse tópico lista e descreve as propriedades personalizadas dos caminhos que conectam objetos do fluxo de dados.

Propriedades personalizadas de um caminho

No modelo de objeto do Integration Services, um caminho que conecta componentes no fluxo de dados implementa a interface IDTSPath100.

A tabela a seguir descreve as propriedades configuráveis dos caminhos em um fluxo de dados. O mecanismo de fluxo de dados também atribui valores a propriedades somente leitura adicionais que não são listadas aqui.

Nome da propriedade Tipo de Dados Descrição
PathAnnotation Inteiro (enumeração) Um valor que indica se uma anotação deve ser exibida com o caminho na superfície do designer. Os valores possíveis são AsNeeded, SourceName, PathNamee Never. O valor padrão é AsNeeded.
DestinationName IDTSInput100 A entrada associada ao caminho.
SourceName IDTSOutput100 A saída associada ao caminho.