Definir as propriedades de um componente de fluxo de dados

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

Para definir as propriedades dos componentes do fluxo de dados, que incluem fontes, destinos e transformações, utilize uma das seguintes funcionalidades:

  • Os editores de componentes que o Integration Services fornece. Estes editores incluem apenas as propriedades personalizadas de cada componente do fluxo de dados.

  • A janela de Propriedades lista as propriedades personalizadas ao nível dos componentes de cada elemento, bem como as propriedades comuns a todos os elementos de fluxo de dados.

  • A caixa de diálogo Editor Avançado oferece acesso a propriedades personalizadas para cada componente. A caixa de diálogo Editor Avançado também fornece acesso às propriedades comuns a todos os componentes do fluxo de dados — as propriedades das entradas, saídas, saídas de erro, colunas e colunas externas.

Defina as propriedades de um componente de fluxo de dados com um editor de componentes

  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 no separador Control Flow e depois clique duas vezes na tarefa Fluxo de Dados que contém o data flow com o componente cujas propriedades pretende visualizar e modificar.

  4. Clique duas vezes no componente de fluxo de dados.

  5. No editor de componentes, visualize ou modifique os valores das propriedades e depois feche o editor.

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

Defina as propriedades de um componente de fluxo de dados na janela Propriedades

  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 no separador Control Flow e depois clique duas vezes na tarefa Fluxo de Dados que contém o componente cujas propriedades pretende visualizar e modificar.

  4. Clique com o botão direito no componente de fluxo de dados e depois clique em Propriedades.

  5. Veja ou modifique os valores das propriedades e depois feche a janela de Propriedades .

    Observação

    Muitas propriedades são apenas de leitura e não podem ser modificadas.

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

Defina as propriedades de um componente de fluxo de dados com o Editor Avançado

  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 no separador Control Flow e depois clique duas vezes na tarefa Fluxo de Dados que contém o componente que pretende visualizar ou modificar.

  4. No designer de fluxo de dados, clique com o botão direito no componente de fluxo de dados e depois clique em Mostrar Editor Avançado.

    Observação

    No SQL Server, os componentes de fluxo de dados que suportam múltiplas entradas não podem usar o Editor Avançado.

  5. Na caixa de diálogo Editor Avançado, faça qualquer um dos seguintes passos:

    • Para visualizar e especificar a ligação que o componente utiliza, clique no separador Gerentes de Ligações .

      Observação

      O separador Gestores de Ligações está disponível apenas para componentes de fluxo de dados que utilizam gestores de ligação para se ligar a fontes de dados como ficheiros e bases de dados

    • Para visualizar e modificar propriedades ao nível dos componentes, clique no separador Propriedades dos Componentes .

    • Para visualizar e modificar mapeamentos entre colunas externas e a saída disponível, clique no separador Column Maappings .

      Observação

      O separador Mapeamentos de Colunas está disponível apenas ao visualizar ou editar fontes ou destinos.

    • Para ver a lista das colunas de entrada disponíveis e atualizar os nomes das colunas de saída, clique no separador Input Columns.

      Observação

      O separador Colunas de Entrada está disponível apenas quando se trabalha com transformações ou destinos. Para mais informações, consulte Transformações de Serviços de Integração.

    • Para visualizar e modificar as propriedades das entradas, saídas e saídas de erro, bem como as propriedades das colunas que contêm, clique no separador Propriedades de Entrada e Saída .

      Observação

      As fontes não têm entradas. Os destinos não têm saídas, exceto uma saída de erro opcional.

  6. Visualize ou modifique os valores das propriedades.

  7. Clique em OK.

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

Propriedades comuns dos componentes do fluxo de dados

Os objetos de fluxo de dados no modelo de objetos Microsoft SQL Server Integration Services têm propriedades comuns e propriedades personalizadas aos níveis de componente, entrada e saída, e coluna de entrada e coluna de saída. Muitas propriedades têm valores de apenas leitura que são atribuídos em tempo de execução pelo motor de fluxo de dados.

Este tópico lista e descreve as propriedades comuns dos objetos de fluxo de dados.

Propriedades dos componentes

No modelo de objetos Integration Services, um componente do fluxo de dados implementa a IDTSComponentMetaData100 interface.

A tabela seguinte descreve as propriedades dos componentes num fluxo de dados. Algumas propriedades têm valores de só leitura que são atribuídos em tempo de execução pelo motor de fluxo de dados.

Property Tipo de dados Descrição
ComponentClassID String O CLSID do componente.
Informações de contacto String Informação de contacto do desenvolvedor de um componente.
Descrição String A descrição do componente de fluxo de dados. O valor padrão desta propriedade é o nome do componente de fluxo de dados.
ID Integer Um valor que identifica de forma única esta instância do componente.
IdentificationString String Identifica o componente.
IsDefaultLocale booleano Indica se o componente utiliza a localização da tarefa Fluxo de Dados à qual pertence.
LocaleID Integer A localização que o componente de fluxo de dados utiliza quando o pacote é executado. Todos os locais do Windows estão disponíveis para utilização em componentes de fluxo de dados.
Name String O nome do componente de fluxo de dados.
PipelineVersion Integer A versão da tarefa de fluxo de dados dentro da qual um componente é concebido para executar.
Utiliza disposições booleano Indica se um componente tem uma saída de erro.
ValidateExternalMetadata booleano Indica se os metadados das colunas externas estão validados. O valor padrão dessa propriedade é True.
Versão Integer A versão de um componente.

Propriedades de entrada

No modelo de objetos Integration Services, transformações e destinos têm entradas. Uma entrada de um componente no fluxo de dados implementa a IDTSInput100 interface.

A tabela seguinte descreve as propriedades das entradas dos componentes num fluxo de dados. Algumas propriedades têm valores de só leitura que são atribuídos em tempo de execução pelo motor de fluxo de dados.

Property Tipo de dados Descrição
Descrição String A descrição da entrada.
ErrorOrTruncationOperation String Uma cadeia opcional que especifica os tipos de erros ou truncamentos que podem ocorrer ao processar uma linha.
DisposiçãoErroLinha DTSRowDisposition Um valor que especifica o tratamento dos erros. Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento.
HasSideEffects booleano Indica se um componente pode ser removido do plano de execução do fluxo de dados quando não está ligado a um componente a jusante e quando o RunInOptimizedModeé verdadeiro.
ID Integer Um valor que identifica de forma única a entrada.
IdentificationString String Uma cadeia que identifica a entrada.
IsSorted booleano Indica se os dados na entrada estão ordenados.
Name String O nome da entrada.
SourceLocale Integer O identificador de região (LCID) dos dados de entrada.
Disposição da linha de truncagem DTSRowDisposition Um valor que determina como o componente lida com truncamentos que ocorrem ao processar linhas. . Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento.

Os destinos e algumas transformações não suportam saídas de erro, e as propriedades ErrorRowDisposition e TruncationRowDisposition destes componentes são apenas de leitura.

Propriedades da coluna de entrada

No modelo de objetos Integration Services, uma entrada contém uma coleção de colunas de entrada. Uma coluna de entrada de um componente no fluxo de dados implementa a IDTSInputColumn100 interface.

A tabela seguinte descreve as propriedades das colunas de entrada dos componentes num fluxo de dados. Algumas propriedades têm valores de só leitura que são atribuídos em tempo de execução pelo motor de fluxo de dados.

Property Tipo de dados Descrição
Sinalizadores de comparação Integer Um conjunto de flags que especificam a comparação de colunas que têm um tipo de dado de carácter. Para mais informações, consulte Comparando Dados de Strings.
Descrição String Descreve a coluna de entrada.
ErrorOrTruncationOperation String Uma cadeia opcional que especifica os tipos de erros ou truncamentos que podem ocorrer ao processar uma linha.
DisposiçãoErroLinha DTSRowDisposition Um valor que especifica o tratamento dos erros. Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento.
ExternalMetadataColumnID IDTSExternalMetadataColumn100 O ID da coluna externa de metadados atribuída a uma coluna de entrada.
ID Integer Um valor que identifica de forma única a coluna de entrada.
IdentificationString String Uma cadeia que identifica a coluna de entrada.
LineageID Integer O ID da coluna de origem.
LinhagemIdentificaçãoString String A sequência de identificação que inclui o nome da coluna de origem.
Name String O nome da coluna de entrada.
SortKeyPosition Integer Um valor que indica se uma coluna está ordenada, a sua ordem de ordenação e a sequência em que múltiplas colunas são ordenadas. O valor 0 indica que a coluna não está ordenada. Para obter mais informações, consulte Classificar dados para as transformações de mesclagem e mesclagem de junção.
Disposição da linha de truncagem DTSRowDisposition Um valor que determina como o componente lida com truncamentos que ocorrem ao processar linhas. Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento.
UpstreamComponentName String O nome do componente ascendente.
Tipo de uso DTSUsageType Um valor que determina como uma coluna de entrada é usada pelo componente.

As colunas de entrada também têm as propriedades do tipo de dado descritas em "Propriedades do Tipo de Dados."

Propriedades de saída

No modelo de objetos dos Serviços de Integração, as fontes e transformações têm saídas. Uma saída de um componente no fluxo de dados implementa a interface IDTSOutput100.

A tabela seguinte descreve as propriedades das saídas dos componentes num fluxo de dados. Algumas propriedades têm valores de só leitura que são atribuídos em tempo de execução pelo motor de fluxo de dados.

Property Tipo de dados Descrição
Eliminar saída ao desanexar o caminho booleano Um valor que determina se o motor de fluxo de dados elimina a saída quando a mesma é desanexada de um caminho.
Descrição String Descreve a saída.
ErrorOrTruncationOperation String Uma cadeia opcional que especifica os tipos de erros ou truncamentos que podem ocorrer ao processar uma linha.
DisposiçãoErroLinha DTSRowDisposition Um valor que especifica o tratamento dos erros. Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento.
Grupo de Exclusão Integer Um valor que identifica um grupo de saídas mutuamente exclusivas.
HasSideEffects booleano Um valor que indica se um componente pode ser removido do plano de execução do fluxo de dados quando não está ligado a um componente a montante e quando RunInOptimizedModeé verdadeiro.
ID Integer Um valor que identifica de forma única a saída.
IdentificationString String Uma cadeia que identifica a saída.
IsErrorOut booleano Indica se a saída é uma saída de erro.
IsSorted booleano Indica se a saída está ordenada. O valor padrão é False.

** Importante ** Definir o valor da propriedade IsSorted para True não ordena os dados. Esta propriedade apenas fornece uma indicação aos componentes subsequentes de que os dados já tinham sido ordenados. Para obter mais informações, consulte Classificar dados para as transformações de mesclagem e mesclagem de junção.
Name String O nome do resultado.
SynchronousInputID Integer O ID de uma entrada que é síncrona à saída.
Disposição da linha de truncagem DTSRowDisposition Um valor que determina como o componente lida com truncamentos que ocorrem ao processar linhas. Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento.

Propriedades da coluna de saída

No modelo de objetos Integration Services, uma saída contém uma coleção de colunas de saída. Uma coluna de saída de um componente no fluxo de dados implementa a IDTSOutputColumn100 interface.

A tabela seguinte descreve as propriedades das colunas de saída dos componentes num fluxo de dados. Algumas propriedades têm valores de só leitura que são atribuídos em tempo de execução pelo motor de fluxo de dados.

Property Tipo de dados Descrição
Sinalizadores de comparação Integer Um conjunto de flags que especificam a comparação de colunas que têm um tipo de dado de carácter. Para mais informações, consulte Comparando Dados de Strings.
Descrição String Descreve a coluna de saída.
ErrorOrTruncationOperation String Uma cadeia opcional que especifica os tipos de erros ou truncamentos que podem ocorrer ao processar uma linha.
DisposiçãoErroLinha DTSRowDisposition Um valor que especifica o tratamento dos erros. Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento. O valor predefinido é Fail component.
ExternalMetadataColumnID Integer O ID da coluna externa de metadados atribuída a uma coluna de entrada.
ID Integer Um valor que identifica de forma única a coluna de saída.
Cadeia de identificação String Uma cadeia que identifica a coluna de saída.
LineageID Integer O ID da coluna de saída. Os componentes subsequentes fazem referência à coluna utilizando este valor.
LinhagemIdentificaçãoString String A cadeia identificadora que inclui o nome da coluna.
Name String O nome da coluna de saída.
SortKeyPosition Integer Um valor que indica se uma coluna está ordenada, a sua ordem de ordenação e a sequência em que múltiplas colunas são ordenadas. O valor 0 indica que a coluna não está ordenada. Para obter mais informações, consulte Classificar dados para as transformações de mesclagem e mesclagem de junção.
Bandeiras Especiais Integer Um valor que contém os sinalizadores especiais da coluna de saída.
Disposição da linha de truncagem DTSRowDisposition Um valor que determina como o componente lida com truncamentos que ocorrem ao processar linhas. Os valores são Componente de falha, Ignorar falha e Linha de Redirecionamento. O valor predefinido é Fail component.

As colunas de saída incluem também um conjunto de propriedades do tipo de dado.

Propriedades da coluna de metadados externos

No modelo de objetos Integration Services, as entradas e saídas podem conter uma coleção de colunas externas de metadados. Uma coluna externa de metadados de um componente no fluxo de dados implementa a IDTSExternalMetadataColumn100 interface.

A tabela seguinte descreve as propriedades das colunas externas de metadados dos componentes num fluxo de dados. Algumas propriedades têm valores de só leitura que são atribuídos em tempo de execução pelo motor de fluxo de dados.

Property Tipo de dados Descrição
Descrição String Descreve a coluna externa.
ID Integer Um valor que identifica de forma única a coluna.
IdentificationString String Uma sequência de caracteres que identifica a coluna.
Name String O nome da coluna externa.

As colunas externas de metadados também incluem um conjunto de propriedades de tipo de dados.

Propriedades do tipo de dado

As colunas de saída e as colunas externas de metadados incluem um conjunto de propriedades do tipo de dados. Dependendo do tipo de dado da coluna, as propriedades podem ser de leitura/escrita ou apenas leitura.

A tabela seguinte descreve as propriedades dos tipos de dados das colunas de saída e das colunas externas de metadados.

Property Tipo de dados Descrição
Página de código Integer Especifica a página de códigos para dados de cadeia que não são Unicode.
Tipo de dados Inteiro (enumeração) O tipo de dados de Serviços de Integração da coluna. Para obter mais informações, consulte Tipos de dados do Integration Services.
Length Integer O comprimento, medido em caracteres, de uma coluna.
Precision Integer A precisão de uma coluna numérica.
Dimensionar Integer A escala de uma coluna numérica.

Propriedades personalizadas dos componentes do fluxo de dados

Para informações sobre propriedades personalizadas, consulte os seguintes tópicos

Usar uma expressão num componente de fluxo de dados

Este procedimento descreve como adicionar uma expressão à transformação de Divisão Condicional ou à transformação de Coluna Derivada. A transformação de Divisão Condicional usa expressões para definir as condições que direcionam as linhas de dados para uma saída de transformação, e a transformação Coluna Derivada usa expressões para definir valores atribuídos a colunas.

Para implementar uma expressão numa transformação, o pacote deve já incluir pelo menos uma tarefa Fluxo de Dados e uma fonte.

  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. No SSIS Designer, clique no separador Control Flow e depois clique na tarefa Fluxo de Dados que contém o data flow onde pretende implementar uma expressão.

  4. Clique no separador Fluxo de Dados e arraste uma transformação de Divisão Condicional ou Coluna Derivada da Toolbox para a superfície de design.

  5. Arraste o conector verde da origem ou de uma transformação para a Divisão Condicional ou para a transformação de Coluna Derivada.

  6. Clique duas vezes na transformação para abrir a caixa de diálogo.

  7. No painel esquerdo, expanda Variáveis para mostrar variáveis definidas pelo sistema e pelo utilizador, e expanda Colunas para mostrar as colunas de entrada da transformação.

  8. No painel direito, expanda Funções Matemáticas, Funções de String, Funções Data/Hora, Funções NULL, Type Casts e Operadores para aceder às funções, casts e operadores fornecidos pela gramática de expressões.

  9. Dependendo da transformação, faça uma das seguintes ações para construir uma expressão:

    • Na caixa de diálogo do Conditional Split Transformation Editor, arraste variáveis, colunas, funções, operadores e conversões de tipo para a coluna Condição. Em alternativa, pode escrever uma expressão diretamente na coluna Condição .

    • Na caixa de diálogo Editor de Transformação de Colunas Derivadas, arraste variáveis, colunas, funções, operadores e conversões para a coluna Expressão. Em alternativa, pode escrever uma expressão diretamente na coluna Expressão .

      Observação

      Quando remove o foco da coluna Condição ou da coluna Expressão , o texto da expressão pode ser destacado para indicar que a sintaxe da expressão está incorreta.

  10. Clica em OK para sair da caixa de diálogo.

    Observação

    Se a expressão não for válida, aparece um alerta que descreve os erros de sintaxe na expressão.

Propriedades do fluxo de dados que podes definir com uma expressão

Os valores de certas propriedades dos objetos data flow podem ser especificados usando expressões de propriedades disponíveis no contentor de tarefas Fluxo de Dados.

Para informações sobre o uso de expressões de propriedades, veja Usar Expressões de Propriedades em Pacotes.

Pode usar expressões de propriedades para personalizar configurações para cada instância implementada de um pacote. Também pode usar expressões de propriedades para especificar restrições de tempo de execução para um pacote usando a opção /set com a utilidade do prompt de comandos dtexec . Por exemplo, pode restringir os MaximumThreads usados pela transformação Sort, ou o MaxMemoryUsage das transformações Fuzzy Grouping e Fuzzy Lookup. Se não forem restritos, estas transformações podem armazenar grandes quantidades de dados em memória.

Para especificar uma expressão de propriedade para uma das propriedades dos objetos data flow listados neste tópico, mostre a janela Properties para a tarefa Fluxo de Dados selecionando a tarefa Fluxo de Dados na superfície Control Flow do designer, ou selecionando o separador Fluxo de Dados do designer sem selecionar qualquer componente ou caminho individual. Selecione a propriedade Expressões e clique na reticência (...) para mostrar a caixa de diálogo do Editor de Expressões de Propriedades . Selecione uma propriedade na lista pendente Propriedade, em seguida escreva uma expressão na caixa de texto Expressão ou clique nas reticências (...) para apresentar a caixa de diálogo Construtor de Expressões.

A lista Propriedade apresenta as propriedades disponíveis apenas para os objetos de fluxo de dados que já colocou na superfície Fluxo de Dados do estruturador. Portanto, não pode usar a lista de propriedades para visualizar todas as propriedades possíveis dos objetos de fluxo de dados que suportam expressões de propriedades. Por exemplo, se tiver colocado uma origem ADO NET na superfície do estruturador, a lista Propriedade inclui uma entrada para a propriedade [ADO NET Source].[SqlCommand]. A lista também apresenta muitas propriedades da própria tarefa Fluxo de Dados.

Os valores das propriedades na lista seguinte podem ser especificados usando expressões de propriedades.

Fontes de fluxo de dados

Objeto Fluxo de Dados Property
Fonte ADO NET Propriedade TableOrViewName

Propriedade SqlCommand
Fonte XML Propriedade XMLData

Propriedade XMLSchemaDefinition

Transformações de fluxo de dados

Para mais informações sobre estas propriedades personalizadas, consulte Propriedades Personalizadas de Transformação.

Objeto Fluxo de Dados Property
Transformação de Divisão Condicional Propriedade FriendlyExpression
Transformação de coluna derivada Propriedade FriendlyExpression
Transformação por agrupamento difuso Propriedade MaxMemoryUsage
Transformação por Pesquisa Fuzzy Propriedade MaxMemoryUsage
Transformação de procura Propriedade SqlCommand

Propriedade SqlCommandParam
Transformação do comando OLE DB Propriedade SqlCommand
Transformação por amostragem percentual Propriedade SamplingValue
Transformação de pivô Propriedade PivotKeyValue
Transformação de amostragem de linhas Propriedade SamplingValue
Transformação de ordenação Propriedade MaximumThreads
Transformação de despivô Propriedade PivotKeyValue

Destinos de fluxo de dados

Objeto Fluxo de Dados Property
Destino do ADO NET Propriedade TableOrViewName

Propriedade BatchSize

Propriedade CommandTimeout
Destino do ficheiro plano Propriedade do cabeçalho
Destino SQL Server Compact Propriedade TableName
Destino do SQL Server Propriedade BulkInsertTableName

Propriedade BulkInsertFirstRow

Propriedade BulkInsertLastRow

Propriedade BulkInsertOrder

Propriedade de tempo limite
  • Last updated on