Definir as propriedades de um componente de fluxo de dados
Aplica-se a:
SQL Server SSIS Integration Runtime no Azure Data Factory
Para definir as propriedades de componentes de fluxo de dados, que incluem origens, destinos e transformações, use um dos seguintes recursos:
Os editores de componente fornecidos pelo Integration Services . Esses editores incluem somente as propriedades personalizadas de cada componente de fluxo de dados.
A janela Propriedades lista as propriedades personalizadas no nível do componente de cada elemento, bem como as propriedades comuns a todos os elementos do fluxo de dados.
A caixa de diálogo Editor Avançado fornece acesso a propriedades personalizadas para cada componente. A caixa de diálogo Editor Avançado também fornece acesso a propriedades comuns a todos os componentes de fluxo de dados: as propriedades de entradas, saídas, saídas de erro, colunas e colunas externas.
Definir as propriedades de um componente de fluxo de dados com um editor de componente
No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote desejado.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.
Clique na guia Fluxo de Controle e clique duas vezes na tarefa Fluxo de Dados que contém o fluxo de dados com os componentes cujas propriedades você deseja exibir e modificar.
Clique duas vezes no componente de fluxo de dados.
No editor de componente, exiba ou modifique os valores de propriedade e feche o editor.
Para salvar o pacote atualizado, no menu Arquivo , clique em Salvar Itens Selecionados.
Definir as propriedades de um componente de fluxo de dados na janela Propriedades
No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote desejado.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.
Clique na guia Fluxo de Controle e clique duas vezes na tarefa Fluxo de Dados que contém os componentes cujas propriedades você deseja exibir e modificar.
Clique com o botão direito do mouse no componente do fluxo de dados e clique em Propriedades.
Exiba ou modifique os valores de propriedade e então feche a janela Propriedades .
Observação
Muitas propriedades são somente leitura e não podem ser modificadas.
Para salvar o pacote atualizado, no menu Arquivo , clique em Salvar Itens Selecionados.
Definir as propriedades de um componente de fluxo de dados com o Editor Avançado
No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote desejado.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.
Clique na guia Fluxo de Controle e clique duas vezes na tarefa Fluxo de Dados que contém o componente que deseja exibir ou modificar.
No designer de fluxo de dados, clique com o botão direito do mouse no componente de fluxo de dados e clique em Mostrar Editor Avançado.
Observação
No SQL Server, os componentes de fluxo de dados que dão suporte a diversas entradas não podem usar o Editor Avançado.
Na caixa de diálogo Editor Avançado , execute uma das seguintes etapas:
Para exibir e especificar a conexão usada pelo componente, clique na guia Gerenciadores de Conexões .
Observação
A guia Gerenciadores de Conexões está disponível apenas para componentes de fluxo de dados que usam gerenciadores de conexões para se conectar com fontes de dados como arquivos e bancos de dados
Para exibir e modificar propriedades no nível do componente, clique na guia Propriedades do Componente .
Para exibir ou modificar mapeamentos entre colunas externas e a saída disponível, clique na guia Mapeamentos de Coluna .
Observação
A guia Mapeamentos de Coluna está disponível apenas ao exibir ou editar origens ou destinos.
Para exibir uma lista das colunas de entrada disponíveis e atualizar os nomes das colunas de saída, clique na guia Colunas de Entrada .
Observação
A guia Colunas de Entrada só fica disponível ao trabalhar com transformações ou destinos. Para obter mais informações, consulte Integration Services Transformations.
Para exibir e modificar as propriedades de entradas, saídas e saídas de erro e as propriedades das colunas que elas contêm, clique na guia Propriedades de Entrada e Saída .
Observação
Origens não têm entradas. Destinos não têm saídas, exceto uma saída de erro opcional.
Exiba ou modifique os valores de propriedade.
Clique em OK.
Para salvar o pacote atualizado, no menu Arquivo , clique em Salvar Itens Selecionados.
Propriedades comuns de componentes de fluxo de dados
Os objetos de fluxo de dados no modelo de objeto do Microsoft SQL Server Integration Services têm propriedades comuns e personalizadas nos níveis do componente, de entrada e saída 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.
Este tópico lista e descreve as propriedades comuns de objetos de fluxo de dados.
Component properties
No modelo de objeto do Integration Services, um componente no fluxo de dados implementa a interface IDTSComponentMetaData100.
A tabela a seguir descreve as propriedades dos componentes em um fluxo de dados. Algumas propriedades têm valores somente leitura que são atribuídos no tempo de execução pelo mecanismo de fluxo de dados.
| Propriedade | Tipo de Dados | Descrição |
|---|---|---|
| ComponentClassID | String | O CLSID do componente. |
| ContactInfo | String | Informações de contato para o desenvolvedor de um componente. |
| Descrição | String | Descrição do componente de fluxo de dados. O valor padrão dessa propriedade é o nome do componente de fluxo de dados. |
| ID | Integer | Valor que identifica essa instância do componente com exclusividade. |
| IdentificationString | String | Identifica o componente. |
| IsDefaultLocale | Booliano | Indica se o componente usa a localidade da tarefa de Fluxo de Dados à qual pertence. |
| LocaleID | Integer | A localidade usada pelo componente de fluxo de dados quando o pacote é executado. Todas as localidades do Windows estão disponíveis para uso em componentes de fluxo de dados. |
| Nome | String | Nome do componente de fluxo de dados. |
| PipelineVersion | Integer | Versão da tarefa de fluxo de dados dentro da qual um componente é projetado para ser executado. |
| UsesDispositions | Booliano | Indica se um componente tem uma saída com erro. |
| ValidateExternalMetadata | Boolean | Indica se os metadados de colunas externas foram validados. O valor padrão dessa propriedade é True. |
| Versão | Integer | Versão de um componente. |
Propriedades de entrada
No modelo de objeto do Integration Services , transformações e destinos têm entradas. Uma entrada de um componente no fluxo de dados implementa a interface IDTSInput100.
A tabela a seguir descreve as propriedades das entradas de componentes em um fluxo de dados. Algumas propriedades têm valores somente leitura que são atribuídos no tempo de execução pelo mecanismo de fluxo de dados.
| Propriedade | Tipo de Dados | DESCRIÇÃO |
|---|---|---|
| Descrição | String | Descrição da entrada. |
| ErrorOrTruncationOperation | String | Cadeia de caracteres opcional que especifica os tipos de erros ou truncamentos que podem ocorrer no processamento de uma linha. |
| ErrorRowDisposition | DTSRowDisposition | Valor que especifica a manipulação de erros. Os valores são Fail component, Ignore failuree Redirect row. |
| HasSideEffects | Booliano | Indica se um componente pode ser removido do plano de execução do fluxo de dados quando não é anexado a um componente downstream e quando RunInOptimizedMode é true. |
| ID | Integer | Valor que identifica a entrada com exclusividade. |
| IdentificationString | String | Cadeia de caracteres que identifica a entrada. |
| IsSorted | Booliano | Indica se os dados na entrada são classificados. |
| Nome | String | Nome da entrada. |
| SourceLocale | Integer | ID de localidade (LCID) dos dados de entrada. |
| TruncationRowDisposition | DTSRowDisposition | Valor que determina como o componente manipula os truncamentos que ocorrem no processamento de linhas. . Os valores são Fail component, Ignore failuree Redirect row. |
Os destinos e algumas transformações não oferecem suporte a saídas de erro e as propriedades ErrorRowDisposition e TruncationRowDisposition dos componentes são somente leitura.
Propriedades da coluna de entrada
No modelo de objeto do 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 interface IDTSInputColumn100.
A tabela a seguir descreve as propriedades das colunas de entrada de componentes em um fluxo de dados. Algumas propriedades têm valores somente leitura que são atribuídos no tempo de execução pelo mecanismo de fluxo de dados.
| Propriedade | Tipo de Dados | Descrição |
|---|---|---|
| ComparisonFlags | Integer | Um conjunto de sinalizadores que especifica a comparação de colunas que têm um tipo de dado de caractere. Para obter mais informações, consulte Comparing String Data. |
| Descrição | String | Descreve a coluna de entrada. |
| ErrorOrTruncationOperation | String | Cadeia de caracteres opcional que especifica os tipos de erros ou truncamentos que podem ocorrer no processamento de uma linha. |
| ErrorRowDisposition | DTSRowDisposition | Valor que especifica a manipulação de erros. Os valores são Fail component, Ignore failuree Redirect row. |
| ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | ID da coluna de metadados externa atribuída a uma coluna de entrada. |
| ID | Integer | Valor que identifica a coluna com exclusividade. |
| IdentificationString | String | Cadeia de caracteres que identifica a coluna de entrada. |
| LineageID | Integer | ID da coluna upstream. |
| LineageIdentificationString | String | A cadeia de caracteres de identificação que inclui o nome da coluna de upstream. |
| Nome | String | Nome da coluna de entrada. |
| SortKeyPosition | Integer | Valor que indica se uma coluna está classificada, sua ordem de classificação e a sequência em que diversas colunas são classificadas. O valor 0 indica que a coluna não está classificada. Para obter mais informações, consulte Classificar dados para as transformações Mesclagem e Junção de Mesclagem. |
| TruncationRowDisposition | DTSRowDisposition | Valor que determina como o componente manipula os truncamentos que ocorrem no processamento de linhas. Os valores são Fail component, Ignore failuree Redirect row. |
| UpstreamComponentName | String | Nome do componente upstream. |
| UsageType | DTSUsageType | Valor que determina como uma coluna de entrada é usada pelo componente. |
As colunas de entrada também têm as propriedades de tipo de dados descritas no item "Propriedades de Tipo de Dados".
Propriedades de saída
No modelo de objeto do Integration Services , origens e transformações têm saídas. Uma saída de um componente no fluxo de dados implementa a interface IDTSOutput100.
A tabela a seguir descreve as propriedades das saídas de componentes em um fluxo de dados. Algumas propriedades têm valores somente leitura que são atribuídos no tempo de execução pelo mecanismo de fluxo de dados.
| Propriedade | Tipo de Dados | Descrição |
|---|---|---|
| DeleteOutputOnPathDetached | Booliano | Valor que determina se o mecanismo de fluxo de dados exclui a saída quando ela é desanexada de um caminho. |
| Descrição | String | Descreve a saída. |
| ErrorOrTruncationOperation | String | Cadeia de caracteres opcional que especifica os tipos de erros ou truncamentos que podem ocorrer no processamento de uma linha. |
| ErrorRowDisposition | DTSRowDisposition | Valor que especifica a manipulação de erros. Os valores são Fail component, Ignore failuree Redirect row. |
| ExclusionGroup | Integer | Valor que identifica um grupo de saídas mutuamente exclusivas. |
| HasSideEffects | Booliano | Valor que indica se um componente pode ser removido do plano de execução do fluxo de dados quando não é anexado a um componente upstream e quando RunInOptimizedMode é true. |
| ID | Integer | Valor que identifica a saída com exclusividade. |
| IdentificationString | String | Cadeia de caracteres que identifica a saída. |
| IsErrorOut | Booliano | Indica se a saída é uma saída de erro. |
| IsSorted | Booliano | Indica se a saída está classificada. O valor padrão é Falso. ** Importante ** Configurar o valor da propriedade IsSorted como True não classifica os dados. Esta propriedade apenas fornece uma dica aos componentes downstream de que os dados foram classificados previamente. Para obter mais informações, consulte Classificar dados para as transformações Mesclagem e Junção de Mesclagem. |
| Nome | String | Nome da saída. |
| SynchronousInputID | Integer | ID de uma entrada que é síncrona à saída. |
| TruncationRowDisposition | DTSRowDisposition | Valor que determina como o componente manipula os truncamentos que ocorrem no processamento de linhas. Os valores são Fail component, Ignore failuree Redirect row. |
Propriedades da coluna de saída
No modelo de objeto do 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 interface IDTSOutputColumn100.
A tabela a seguir descreve as propriedades das colunas de saída de componentes em um fluxo de dados. Algumas propriedades têm valores somente leitura que são atribuídos no tempo de execução pelo mecanismo de fluxo de dados.
| Propriedade | Tipo de Dados | Descrição |
|---|---|---|
| ComparisonFlags | Integer | Um conjunto de sinalizadores que especifica a comparação de colunas que têm um tipo de dado de caractere. Para obter mais informações, consulte Comparing String Data. |
| Descrição | String | Descreve a coluna de saída. |
| ErrorOrTruncationOperation | String | Cadeia de caracteres opcional que especifica os tipos de erros ou truncamentos que podem ocorrer no processamento de uma linha. |
| ErrorRowDisposition | DTSRowDisposition | Valor que especifica a manipulação de erros. Os valores são Fail component, Ignore failuree Redirect row. O valor padrão é Fail component. |
| ExternalMetadataColumnID | Integer | ID da coluna de metadados externa atribuída a uma coluna de entrada. |
| ID | Integer | Valor que identifica a coluna de saída com exclusividade. |
| IdentificationString | String | Cadeia de caracteres que identifica a coluna de saída. |
| LineageID | Integer | ID da coluna de saída. Os componentes downstream referem-se à coluna usando esse valor. |
| LineageIdentificationString | String | A cadeia de caracteres de identificação que inclui o nome da coluna. |
| Nome | String | Nome da coluna de saída. |
| SortKeyPosition | Integer | Valor que indica se uma coluna está classificada, sua ordem de classificação e a sequência em que diversas colunas são classificadas. O valor 0 indica que a coluna não está classificada. Para obter mais informações, consulte Classificar dados para as transformações Mesclagem e Junção de Mesclagem. |
| SpecialFlags | Integer | Valor que contém os sinalizadores especiais da coluna de saída. |
| TruncationRowDisposition | DTSRowDisposition | Valor que determina como o componente manipula os truncamentos que ocorrem no processamento de linhas. Os valores são Fail component, Ignore failuree Redirect row. O valor padrão é Fail component. |
As colunas de saída também incluem um conjunto de propriedades de tipo de dados.
Propriedades da coluna de metadados externa
No modelo de objeto do Integration Services , entradas e saídas podem conter uma coleção de colunas de metadados externas. Uma coluna de metadados externa de um componente no fluxo de dados implementa a interface IDTSExternalMetadataColumn100.
A tabela a seguir descreve as propriedades das colunas de metadados externas de componentes em um fluxo de dados. Algumas propriedades têm valores somente leitura que são atribuídos no tempo de execução pelo mecanismo de fluxo de dados.
| Propriedade | Tipo de Dados | DESCRIÇÃO |
|---|---|---|
| Descrição | String | Descreve a coluna externa. |
| ID | Integer | Valor que identifica a coluna com exclusividade. |
| IdentificationString | String | Cadeia de caracteres que identifica a coluna. |
| Nome | String | Nome da coluna externa. |
As colunas de metadados externas também incluem um conjunto de propriedades de tipo de dados.
Propriedades de tipo de dados
As colunas de saída e as colunas de metadados externas incluem um conjunto de propriedades de tipo de dados. Dependendo do tipo de dados da coluna, as propriedades podem ser leitura/gravação ou somente leitura.
A tabela a seguir descreve as propriedades de tipo de dados de colunas de saída e de colunas de metadados externas.
| Propriedade | Tipo de Dados | Descrição |
|---|---|---|
| CodePage | Integer | Especifica a página de código para dados de cadeia de caracteres que não são Unicode. |
| Tipo de dados | Inteiro (enumeração) | Tipo de dados da coluna do Integration Services . Para obter mais informações, consulte Integration Services Data Types. |
| Tamanho | Integer | Comprimento, medido em caracteres, de uma coluna. |
| Precisão | Integer | Precisão de uma coluna numérica. |
| Escala | Integer | Escala de uma coluna numérica. |
Propriedades personalizadas de componentes de fluxo de dados
Para obter informações sobre propriedades personalizadas, consulte os tópicos a seguir
Propriedades personalizadas do destino Treinamento do Modelo de Mineração de Dados
Propriedades personalizadas do destino de processamento de dimensões
Propriedades personalizadas do OLE DB Propriedades personalizadas do OLE DB
Propriedades personalizadas do destino Processamento de Partições
Propriedades personalizadas do destino Conjunto de Registros
Propriedades personalizadas do destino SQL Server Compact Edition
Usar uma expressão em um componente de fluxo de dados
Este procedimento descreve como adicionar uma expressão à transformação Divisão Condicional ou à transformação Coluna derivada. A transformação Divisão Condicional usa expressões para definir as condições que direcionam linhas de dados a 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 em uma transformação, o pacote já deve incluir pelo menos uma tarefa Fluxo de Dados e uma fonte.
No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote desejado.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.
No Designer do SSIS , clique na guia Fluxo de Controle e clique na tarefa Fluxo de Dados que contém o fluxo de dados no qual você deseja implementar uma expressão.
Clique na guia Fluxo de Dados e arraste uma transformação Divisão Condicional ou Coluna Derivada da Caixa de Ferramentas para a superfície de design.
Arraste o conector verde da fonte ou uma transformação para a transformação Divisão Condicional ou Coluna Derivada.
Clique duas vezes na transformação para abrir sua caixa de diálogo.
No painel à esquerda, expanda Variáveis para exibir variáveis definidas pelo sistema e pelo usuário e expanda Colunas para exibir as colunas de entrada de transformação.
No painel à direita, expanda Funções Matemáticas, Funções de Cadeia de Caracteres, Funções de Data/Hora, Funções NULL, Conversões de Tipoe Operadores para acessar as funções, as conversões e os operadores fornecidos pela gramática de expressão.
Dependendo da transformação, execute uma das seguintes ações para criar uma expressão:
Na caixa de diálogo Editor de Transformação Divisão Condicional , arraste variáveis, colunas, funções, operadores e conversões até a coluna Condição . Se preferir, digite uma expressão diretamente na coluna Condição .
Na caixa de diálogo Editor de Transformação Coluna Derivada , arraste variáveis, colunas, funções, operadores e conversões até a coluna Expressão . Como alternativa, é possível digitar uma expressão diretamente na coluna Expressão .
Observação
Ao remover o foco da coluna Condição ou da coluna Expressão , o texto da expressão pode ser realçado para indicar que a sintaxe da expressão está incorreta.
Clique em OK para sair da caixa de diálogo.
Observação
Se a expressão não for válida, um alerta aparecerá descrevendo os erros de sintaxe na expressão.
Propriedades de fluxo de dados que podem ser definidas com uma expressão
Os valores de certas propriedades dos objetos de fluxo de dados podem ser especificados usando expressões de propriedades disponíveis no contêiner da tarefa de Fluxo de Dados.
Para obter informações sobre como usar expressões de propriedade, consulte Usar expressões de propriedade em pacotes.
É possível usar expressões de propriedade para personalizar configurações para cada instância implantada de um pacote. Você 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 o utilitário de prompt de comando dtexec . Por exemplo, você pode restringir o MaximumThreads usado pela transformação Classificação ou o MaxMemoryUsage das transformações Agrupamento Difuso e Pesquisa Difusa. Se irrestritas, essas transformações podem armazenar em cache grandes quantias de dados na memória.
Para especificar uma expressão de propriedade para uma das propriedades de objetos de fluxo de dados listadas nesse tópico, exiba a janela Propriedades para a tarefa de Fluxo de Dados selecionando a tarefa de Fluxo de Dados na superfície Fluxo de Controle do designer, ou selecionando a guia Fluxo de Dados do designer sem selecionar nenhum componente individual ou caminho. Selecione a propriedade Expressões e clique nas reticências (...) para exibir a caixa de diálogo Editor de Expressões de Propriedades . Abra a lista suspensa Propriedade para selecionar uma propriedade e digite uma expressão na caixa de texto Expressão ou clique nas reticências (...) para exibir a caixa de diálogo Construtor de Expressões .
A lista Propriedade exibe as propriedades disponíveis para apenas esses objetos de fluxo de dados já colocados na superfície Fluxo de Dados do designer. Portanto, não é possível usar a lista Propriedade para exibir todas as possíveis propriedades de objetos de fluxo de dados que aceitam expressões de propriedades. Por exemplo, se você tiver colocado uma origem do ADO NET na superfície do designer, a lista Propriedade conterá uma entrada para a propriedade [ADO NET Source].[SqlCommand] . A lista também exibe muitas propriedades da própria tarefa de Fluxo de Dados.
Os valores das propriedades na lista a seguir podem ser especificados usando expressões de propriedades.
Origens de fluxo de dados
| Objeto de Fluxo de Dados | Propriedade |
|---|---|
| Origem do ADO NET | Propriedade TableOrViewName Propriedade SqlCommand |
| Origem XML | Propriedade XMLData Propriedade XMLSchemaDefinition |
Transformações do fluxo de dados
Para obter mais informações sobre essas propriedades personalizadas, consulte Propriedades Personalizadas de Transformação.
| Objeto de Fluxo de Dados | Propriedade |
|---|---|
| Transformação Divisão Condicional | Propriedade FriendlyExpression |
| transformação Coluna Derivada | Propriedade FriendlyExpression |
| transformação Agrupamento Difuso | Propriedade MaxMemoryUsage |
| transformação Pesquisa Difusa | Propriedade MaxMemoryUsage |
| transformação Pesquisa | Propriedade SqlCommand Propriedade SqlCommandParam |
| transformação Comando OLE DB | Propriedade SqlCommand |
| transformação Amostragem Percentual | Propriedade SamplingValue |
| transformação Dinâmica | Propriedade PivotKeyValue |
| Transformação Amostragem de Linhas | Propriedade SamplingValue |
| Transformação Classificação | Propriedade MaximumThreads |
| Transformação Não Dinâmica | Propriedade PivotKeyValue |
Destinos de fluxo de dados
| Objeto de Fluxo de Dados | Propriedade |
|---|---|
| Destino do ADO NET | Propriedade TableOrViewName Propriedade BatchSize Propriedade CommandTimeout |
| Destino de arquivo simples | Propriedade Header |
| SQL Server Destino Compact | Propriedade TableName |
| Destino SQL Server | Propriedade BulkInsertTableName Propriedade BulkInsertFirstRow Propriedade BulkInsertLastRow Propriedade BulkInsertOrder Propriedade Timeout |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de