Compartilhar via


Propriedades comuns

Os objetos de fluxo de dados no modelo de objeto do Microsoft SQL Server Integration Services têm propriedades comuns e personalizadas no componente, na entrada e saída e nos níveis de colunas de entrada e saída. Muitas propriedades têm valores somente leitura atribuídos no 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.

  • Componentes

  • Entradas

  • Colunas de entrada

  • Saídas

  • Colunas de saída

Propriedades do componente

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

Cadeia de caracteres

O CLSID do componente.

ContactInfo

Cadeia de caracteres

Informações de contato para o desenvolvedor de um componente.

Description

Cadeia de caracteres

Descrição do componente de fluxo de dados. O valor padrão dessa propriedade é o nome do componente de fluxo de dados.

ID

Inteiro

Valor que identifica essa instância do componente com exclusividade.

IdentificationString

Cadeia de caracteres

Identifica o componente.

IsDefaultLocale

Booleano

Indica se o componente usa a localidade da tarefa de Fluxo de Dados à qual pertence.

LocaleID

Inteiro

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.

Name

Cadeia de caracteres

Nome do componente de fluxo de dados.

PipelineVersion

Inteiro

Versão da tarefa de fluxo de dados dentro da qual um componente é projetado para ser executado.

UsesDispositions

Booleano

Indica se um componente tem uma saída com erro.

ValidateExternalMetadata

Booleano

Indica se os metadados de colunas externas foram validados. O valor padrão dessa propriedade é True.

Version

Inteiro

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

Description

Cadeia de caracteres

Descrição da entrada.

ErrorOrTruncationOperation

Cadeia de caracteres

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 failure e Redirect row.

HasSideEffects

Booleano

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

Inteiro

Valor que identifica a entrada com exclusividade.

IdentificationString

Cadeia de caracteres

Cadeia de caracteres que identifica a entrada.

IsSorted

Booleano

Indica se os dados na entrada são classificados.

Name

Cadeia de caracteres

Nome da entrada.

SourceLocale

Inteiro

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 failure e 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

Inteiro

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 Comparando dados de cadeia de caracteres.

Description

Cadeia de caracteres

Descreve a coluna de entrada.

ErrorOrTruncationOperation

Cadeia de caracteres

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 failure e Redirect row.

ExternalMetadataColumnID

IDTSExternalMetadataColumn100

ID da coluna de metadados externa atribuído a uma coluna de entrada.

ID

Inteiro

Valor que identifica a coluna com exclusividade.

IdentificationString

Cadeia de caracteres

Cadeia de caracteres que identifica a coluna de entrada.

LineageID

Inteiro

ID da coluna upstream.

Name

Cadeia de caracteres

Nome da coluna de entrada.

SortKeyPosition

Inteiro

Valor que indica se uma coluna está classificada, sua ordem de classificação e a seqüê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 Como classificar dados para as Transformações Mesclar 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 failure e Redirect row.

UpstreamComponentName

Cadeia de caracteres

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

Booleano

Valor que determina se o mecanismo de fluxo de dados exclui a saída quando ela é desanexada de um caminho.

Description

Cadeia de caracteres

Descreve a saída.

ErrorOrTruncationOperation

Cadeia de caracteres

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 failure e Redirect row.

ExclusionGroup

Inteiro

Valor que identifica um grupo de saídas mutuamente exclusivas.

HasSideEffects

Booleano

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

Inteiro

Valor que identifica a saída com exclusividade.

IdentificationString

Cadeia de caracteres

Cadeia de caracteres 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á classificada. O valor padrão é False.

Observação importanteImportante
Definir 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 Como classificar dados para as Transformações Mesclar e Junção de Mesclagem.

Name

Cadeia de caracteres

Nome da saída.

SynchronousInputID

Inteiro

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 failure e 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

Inteiro

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 Comparando dados de cadeia de caracteres.

Description

Cadeia de caracteres

Descreve a coluna de saída.

ErrorOrTruncationOperation

Cadeia de caracteres

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 failure e Redirect row. O valor padrão é Fail component.

ExternalMetadataColumnID

Inteiro

ID da coluna de metadados externa atribuída a uma coluna de entrada.

ID

Inteiro

Valor que identifica a coluna de saída com exclusividade.

IdentificationString

Cadeia de caracteres

Cadeia de caracteres que identifica a coluna de saída.

LineageID

Inteiro

ID da coluna de saída. Os componentes downstream referem-se à coluna usando esse valor.

Name

Cadeia de caracteres

Nome da coluna de saída.

SortKeyPosition

Inteiro

Valor que indica se uma coluna está classificada, sua ordem de classificação e a seqüê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 Como classificar dados para as Transformações Mesclar e Junção de Mesclagem.

SpecialFlags

Inteiro

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 failure e 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

Description

Cadeia de caracteres

Descreve a coluna externa.

ID

Inteiro

Valor que identifica a coluna com exclusividade.

IdentificationString

Cadeia de caracteres

Cadeia de caracteres que identifica a coluna.

Name

Cadeia de caracteres

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

Inteiro

Especifica a página de código para dados de cadeia de caracteres que não são Unicode.

DataType

Inteiro (enumeração)

Tipo de dados da coluna do Integration Services. Para obter mais informações, consulte Tipos de dados do Integration Services.

Length

Inteiro

Comprimento, medido em caracteres, de uma coluna.

Precision

Inteiro

Precisão de uma coluna numérica.

Scale

Inteiro

Escala de uma coluna numérica.