Caminhos dos Serviços de Integração

Aplica-se a:SQL Server SSIS Integration Runtime em 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 conecta uma fonte OLE DB e uma transformação Sort, a origem OLE DB é a origem do caminho e a transformação Sort é o destino do caminho. A origem é o componente onde o caminho começa e o destino é o componente onde o caminho termina.

Se você executar um pacote no Designer SSIS, poderá exibir 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 de depuração útil. Para obter mais informações, consulte Depurando fluxo de dados.

Configurar o caminho

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

As propriedades do caminho configurável incluem o nome, a descrição e a anotação do caminho. Você também pode configurar caminhos programaticamente. Para obter mais informações, consulte Conectando componentes de 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 desenho do separador Fluxo de Dados no Designer 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, enquanto outras anotações aparecem nas guias Fluxo de Dados, Fluxo de Controle e Manipulação de Eventos do Designer SSIS.

Os metadados mostram o nome, o tipo de dados, a precisão, a escala, o comprimento, a página de código e o 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. Este pode ou não ser o primeiro componente no fluxo de dados. Por exemplo, as transformações Union All e Sort criam suas próprias colunas e são as fontes de suas colunas de saída. Por outro lado, uma transformação "Copiar Coluna" pode passar por colunas sem alterá-las ou pode criar novas colunas ao copiar colunas de entrada. A transformação Copiar Coluna é apenas o componente de origem das novas colunas.

Definir as propriedades de um caminho com o Editor de Caminho de Fluxo de Dados

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

1. No SSDT (SQL Server Data Tools), abra o projeto 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 Dados, clique em Geral. Em seguida, você pode editar o nome padrão do caminho e fornecer uma descrição do caminho. Você também pode modificar a propriedade PathAnnotation.

5. Clique em OK.

6. Para guardar o pacote atualizado, clique em Guardar itens selecionados no menu Ficheiro.

Página Geral - Editor de Caminho de Fluxo de Dados

Use a caixa de diálogo Editor de Caminho de Fluxo de Dados para definir propriedades de caminho, exibir metadados de coluna e gerenciar os visualizadores de dados 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 para anotação de caminho.

Opções

Nome
Forneça um nome exclusivo para o caminho.

Identificação
O identificador de sequência do caminho. Esta propriedade é somente leitura.

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

Descrição
Descreva o caminho.

Anotação de Caminho
Especifique o tipo de anotação a ser usada. Escolha Nunca para desabilitar anotações, AsNeeded para habilitar a anotação sob demanda, SourceName para anotar automaticamente usando o valor da opção SourceName e PathName para anotar automaticamente usando o valor da propriedade Name .

Nome do destino
Exibe a entrada que está no final do caminho.

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

Página de Metadados - Editor de Caminho de Fluxo de Dados

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

Opções

Metadados do caminho
Lista os metadados da coluna. Clique nos cabeçalhos das colunas para ordenar os dados das colunas.

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
Liste o número de dígitos à direita da vírgula 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 ocorre quando os dados estão em Unicode ou têm um tipo de dados numérico, de data ou hora.

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

Bandeiras de comparação
Lista os sinalizadores de comparação que se aplicam à coluna.

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

Copiar para a área de transferência
Copie os metadados da coluna para a área de transferência. Por padrão, todas as linhas de metadados são copiadas como ordenadas na ordem exibida no momento.

Página de Visualizadores de Dados - Editor de Caminho de 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 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 .

Eliminar
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 .

Propriedades do caminho

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

Este tópico lista e descreve as propriedades personalizadas dos caminhos que conectam objetos de 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 IDTSPath100 interface.

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 estão listadas aqui.