Partilhar via


Propriedades personalizadas de transformação

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

Além das propriedades comuns à maioria dos objetos de fluxo de dados no modelo de objeto do SQL Server Integration Services, muitos objetos de fluxo de dados têm propriedades personalizadas específicas do objeto. Essas propriedades personalizadas estão disponíveis somente em tempo de execução e não estão documentadas na Documentação de Referência de Programação Gerenciada do Integration Services.

Este tópico lista e descreve as propriedades personalizadas das várias transformações de fluxo de dados. Para obter informações sobre as propriedades comuns à maioria dos objetos de fluxo de dados, consulte Propriedades comuns.

Algumas propriedades de transformações podem ser definidas usando expressões de propriedade. Para obter mais informações, consulte Propriedades de fluxo de dados que podem ser definidas usando expressões.

Transformações com propriedades personalizadas

Transformações sem propriedades personalizadas

As transformações a seguir não têm propriedades personalizadas nos níveis de componente, entrada ou saída: Merge Transformation, Multicast Transformation e Union All Transformation. Eles usam apenas as propriedades comuns a todos os componentes de fluxo de dados.

Propriedades personalizadas de transformação agregada

A transformação Aggregate agrega tanto propriedades personalizadas como as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação Agregada. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Fator de Autoextensão (AutoExtendFactor) Número inteiro Um valor entre 1 e 100 que especifica a porcentagem pela qual a memória pode ser estendida durante a agregação. O valor padrão dessa propriedade é 25.
CountDistinctKeys Número inteiro Um valor que especifica o número exato de contagens distintas que a agregação pode gravar. Se um valor CountDistinctScale for especificado, o valor em CountDistinctKeys terá precedência.
CountDistinctScale Inteiro (enumeração) Um valor que descreve o número aproximado de valores distintos em uma coluna que a agregação pode contar. Esta propriedade pode ter um dos seguintes valores:

Baixo (1) - indica até 500.000 valores-chave

Médio (2) - indica até 5 milhões de valores-chave

Alto (3) - indica mais de 25 milhões de valores-chave.

Não especificado (0)-indica que nenhum valor CountDistinctScale é usado. Usar a opção Não especificado (0) pode afetar o desempenho em grandes conjuntos de dados.
Chaves Número inteiro Um valor que especifica o número exato de chaves Group By que a agregação grava. Se um KeyScalevalue for especificado, o valor em Keys terá precedência.
Escala de chaves Inteiro (enumeração) Um valor que descreve aproximadamente quantos valores de chave Group By a agregação pode gravar. Esta propriedade pode ter um dos seguintes valores:

Baixo (1) - indica até 500.000 valores-chave.

Médio (2) - indica até 5 milhões de valores-chave.

Alto (3) - indica mais de 25 milhões de valores-chave.

Não especificado (0)-indica que nenhum valor KeyScale é usado.

A tabela a seguir descreve as propriedades personalizadas da saída da transformação Agregada. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Chaves Número inteiro Um valor que especifica o número exato de chaves Group By que a agregação pode gravar. Se um valor KeyScale for especificado, o valor em Keys terá precedência.
Escala de chaves Inteiro (enumeração) Um valor que descreve aproximadamente quantos valores de chave Group By a agregação pode gravar. Esta propriedade pode ter um dos seguintes valores:

Baixo (1)-indica até 500.000 valores-chave,

Médio (2) - indica até 5 milhões de valores-chave,

Alto (3) - indica mais de 25 milhões de valores-chave.

Não especificado (0)-indica que nenhum valor KeyScale é usado.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Agregada. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
AggregationColumnId Número inteiro O LineageID de uma coluna que participa em GROUP BY ou funções de agregação.
AgregaçãoComparaçãoSinalizadores Número inteiro Um valor que especifica como a transformação Agregar compara dados de cadeia de caracteres em uma coluna. Para obter mais informações, consulte Comparando dados de cadeia de caracteres.
TipoDeAgregação Inteiro (enumeração) Um valor que especifica a operação de agregação a ser executada na coluna. Esta propriedade pode ter um dos seguintes valores:

Agrupar por (0)

Contagem (1)

Contar tudo (2)

ContagemDistinta (3)

Soma (4)

Média (5)

Máximo (7)

Mínimo (6)
CountDistinctKeys Número inteiro Quando o tipo de agregação é Count distinct, um valor que especifica o número exato de chaves que a agregação pode gravar. Se um valor CountDistinctScale for especificado, o valor em CountDistinctKeys terá precedência.
CountDistinctScale Inteiro (enumeração) Quando o tipo de agregação é Count distinct, um valor que descreve aproximadamente quantos valores-chave a agregação pode gravar. Esta propriedade pode ter um dos seguintes valores:

Baixo (1)-indica até 500.000 valores-chave,

Médio (2) - indica até 5 milhões de valores-chave,

Alto (3) - indica mais de 25 milhões de valores-chave.

Não especificado (0)-indica que nenhum valor CountDistinctScale é usado.
IsBig Booleano Um valor que indica se a coluna contém um valor maior que 4 bilhões ou um valor com mais precisão do que um valor de ponto flutuante de precisão dupla. O valor pode ser 0 ou 1. 0 indica que IsBig é False e a coluna não contém um valor grande ou preciso. O valor padrão dessa propriedade é 1.

As entradas e as colunas de entrada da transformação Agregar não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação agregada.

Transformação de Auditoria: Propriedades Personalizadas

A transformação Audit tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Audit. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
ItemSelecionadoDeLinagem Inteiro (enumeração) O item de auditoria selecionado para saída. Esta propriedade pode ter um dos seguintes valores:

GUID da instância de execução (0)

Tempo de início da execução (4)

Nome da máquina (5)

ID do pacote (1)

Nome do pacote (2)

ID da tarefa (8)

Nome da tarefa (7)

Nome de utilizador (6)

ID da versão (3)

A entrada, as colunas de entrada e a saída da transformação Audit não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de auditoria.

Transformação de Cache Propriedades Personalizadas

A transformação Cache Transform tem propriedades personalizadas, assim como as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades do Cache Transform. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Connectionmanager Cordão Especifica o nome do gerenciador de conexões.
ValidateExternalMetadata Booleano Indica se a Transformação de Cache é validada usando fontes de dados externas em tempo de conceção. Se a propriedade estiver definida como False, a validação em relação a fontes de dados externas ocorrerá em tempo de execução.

O valor padrão é True.
ColunasDeEntradaDisponíveis Cordão Uma lista das colunas de entrada disponíveis.
Colunas de Entrada Cordão Uma lista das colunas de entrada selecionadas.
CacheColumnName Cordão Especifica o nome da coluna mapeada para uma coluna de entrada selecionada.

O nome da coluna na propriedade CacheColumnName deve corresponder ao nome da coluna correspondente listada na página Colunas do Editor do Gerenciador de Conexões de Cache.

Para obter mais informações, consulte Editor do Gerenciador de Conexões de Cache

Propriedades personalizadas de transformação do mapa de caracteres

A transformação Mapa de Caracteres tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Mapa de Caracteres. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
IdDeLinagemDeColunaDeEntrada Número inteiro Um valor que especifica o LineageID da coluna de entrada que é a origem da coluna de saída.
MapFlags Inteiro (enumeração) Um valor que especifica as operações de cadeia de caracteres que a transformação Mapa de Caracteres executa na coluna. Esta propriedade pode ter um dos seguintes valores:

Reversão de bytes (2)

Largura total (6)

Meia largura (5)

Hiragana (3)

Katakana (4)

Invólucro linguístico (7)

Minúsculas (0)

Chinês simplificado (8)

Chinês tradicional(9)

Maiúsculas (1)

A entrada, as colunas de entrada e a saída da transformação Mapa de Caracteres não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação do mapa de caracteres.

Propriedades personalizadas de transformação divisória condicional

A transformação Divisão Condicional tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

A tabela a seguir descreve as propriedades personalizadas da saída da transformação Split Condicional. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Ordem de Avaliação Número inteiro Um valor que especifica a posição de uma condição, associada a uma saída, na lista de condições que a transformação Divisão Condicional avalia. As condições são avaliadas em ordem do menor para o maior valor.
Expressão Cordão Uma expressão que representa a condição avaliada pela transformação Divisão Condicional. As colunas são representadas por identificadores de linhagem.
Expressão Amigável Cordão Uma expressão que representa a condição avaliada pela transformação Divisão Condicional. As colunas são representadas pelos seus nomes.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.
IsDefaultOut Booleano Um valor que indica se a saída é a saída padrão.

A entrada, as colunas de entrada e as colunas de saída da transformação Divisão Condicional não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de divisão condicional.

Copiar propriedades personalizadas de transformação de coluna

A transformação de cópia de coluna tem apenas as propriedades comuns a todos os componentes de fluxo de dados ao nível do componente.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Copy Column. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
copyColumnId Número inteiro O LineageID da coluna de entrada da qual a coluna de saída é copiada.

A entrada, as colunas de entrada e a saída da transformação Copiar Coluna não têm propriedades personalizadas.

Para obter mais informações, consulte Copiar transformação de coluna.

Propriedades personalizadas de transformação de conversão de dados

A transformação de Conversão de Dados tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação de Conversão de Dados. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
FastParse Booleano Um valor que indica se a coluna usa as rotinas de análise rápidas, mas sem distinção de localidade, que o Integration Services fornece ou as rotinas de análise padrão sensíveis à localidade. O valor padrão dessa propriedade é False. Para obter mais informações, consulte Fast Parse e Standard Parse. .

Nota: Esta propriedade não está disponível no Editor de Transformação de Conversão de Dados, mas pode ser definida usando o Editor Avançado.
IdentificadorDeLinhasDeOrigemDeColunaDeEntradaFonte Número inteiro O LineageID da coluna de entrada que é a origem da coluna de saída.

A entrada, as colunas de entrada e a saída da transformação de Conversão de Dados não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de Conversão de Dados.

Propriedades Personalizadas de Transformação de Consultas de Mineração de Dados

A transformação de Consulta de Mineração de Dados possui propriedades personalizadas, além das propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação da Consulta de Mineração de Dados. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
ASConnectionId Cordão O identificador exclusivo do objeto de conexão.
ASConnectionString Cordão A cadeia de conexão com um projeto do Analysis Services ou um banco de dados do Analysis Services.
NomeDoCatálogo Cordão O nome de um banco de dados do Analysis Services.
Nome do modelo Cordão O nome do modelo de mineração de dados.
NomeDaEstruturaDoModelo Cordão O nome da estrutura de mineração.
ObjectRef Cordão Uma marca XML que identifica a estrutura de mineração de dados usada pela transformação.
Texto de Consulta Cordão A instrução de consulta de previsão que a transformação usa.

As colunas de entrada, as colunas de saída, e a transformação da Consulta de Mineração de Dados não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de consulta de mineração de dados.

Propriedades personalizadas de transformação de coluna derivada

A transformação Coluna derivada tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada e de saída da transformação Coluna Derivada. Quando você opta por adicionar a coluna derivada como uma nova coluna, essas propriedades personalizadas se aplicam à nova coluna de saída; Quando você opta por substituir o conteúdo de uma coluna de entrada existente pelos resultados derivados, essas propriedades personalizadas se aplicam à coluna de entrada existente. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Expressão Cordão Uma expressão que representa a condição avaliada pela transformação Divisão Condicional. As colunas são representadas pela propriedade LineageID da coluna.
Expressão Amigável Cordão Uma expressão que representa a condição avaliada pela transformação Divisão Condicional. As colunas são representadas pelos seus nomes.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

A entrada e a saída da transformação Coluna derivada não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de coluna derivada.

Exportar propriedades personalizadas de transformação de coluna

A transformação Exportar Coluna tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação de Exportação de Colunas. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Permitir Anexação Booleano Um valor que especifica se a transformação acrescenta dados a um arquivo existente. O valor padrão dessa propriedade é False.
ForceTruncate Booleano Um valor que especifica se a transformação trunca um arquivo existente antes de gravar dados. O valor padrão dessa propriedade é False.
ID da Coluna de Dados do Ficheiro Número inteiro Um valor que identifica a coluna que contém os dados que a transformação insere em um arquivo. Na coluna Extract, esta propriedade tem um valor de 0; na coluna Caminho do arquivo, essa propriedade contém o LineageID da coluna Extract.
WriteBOM Booleano Um valor que especifica se uma marca de ordem de bytes (BOM) é gravada no arquivo.

As colunas de entrada, saída e de exportação da transformação Exportar Coluna não têm propriedades personalizadas.

Para obter mais informações, consulte Exportar transformação de coluna.

Importar propriedades personalizadas de transformação de coluna

A transformação Importar Coluna tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação Importar Coluna. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
ExpectBOM Booleano Um valor que especifica se a transformação Importar Coluna requer uma marca de ordem de bytes (BOM). Um BOM só é esperado se os dados tiverem o tipo de dados DT_NTEXT.
ID da Coluna de Dados do Ficheiro Número inteiro Um valor que identifica a coluna que contém os dados que a transformação insere no fluxo de dados. Na coluna de dados a ser inserida, essa propriedade tem um valor de 0; na coluna que contém os caminhos do arquivo de origem, essa propriedade contém o LineageID da coluna de dados a ser inserida.

As colunas de entrada, saída e de saída da transformação Importar Coluna não têm propriedades personalizadas.

Para obter mais informações, consulte Import Column Transformation.

Propriedades personalizadas de transformação de agrupamento difuso

A transformação Agrupamento Fuzzy (Fuzzy Grouping) tem propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação de Agrupamento Fuzzy. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Delimitadores Cordão Os delimitadores de token que a transformação usa. Os delimitadores padrão incluem os seguintes caracteres: espaço ( ), vírgula(,), ponto (.), ponto-e-vírgula (;), dois pontos (:), hífen (-), aspas retas duplas ("), aspas retas simples ('), e comercial (&), barra (/), barra invertida (\), no sinal (@), ponto de exclamação (!), ponto de interrogação (?), parêntese de abertura ((), parêntese de fechamento ()), menor que (<), maior que (>), colchete de abertura ([), colchete de fechamento (]), chave de abertura ({), chave de fechamento (}), tubo (|), sinal numérico (#), asterisco (*), acento circunflexo (^) e porcentagem (%).
Exaustivo Booleano Um valor que especifica se cada registro de entrada é comparado a todos os outros registros de entrada. O valor de True destina-se principalmente para fins de depuração. O valor padrão dessa propriedade é False.

Nota: Esta propriedade não está disponível no Editor de Transformação de Agrupamento Fuzzy, mas pode ser definida usando o Editor Avançado.
UsoMáximoDeMemória Número inteiro A quantidade máxima de memória para uso pela transformação. O valor padrão dessa propriedade é 0, que permite o uso de memória dinâmica.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

Nota: Esta propriedade não está disponível no Editor de Transformação de Agrupamento Fuzzy, mas pode ser definida usando o Editor Avançado.
MinSimilaridade Duplo O limiar de semelhança que a transformação usa para identificar duplicatas, expresso como um valor entre 0 e 1. O valor padrão dessa propriedade é 0.8.

A tabela abaixo descreve as propriedades personalizadas das colunas de entrada da transformação de agrupamento fuzzy. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
ExactFuzzy Inteiro (enumeração) Um valor que especifica se a transformação executa uma correspondência difusa ou uma correspondência exata. Os valores válidos são Exato e Fuzzy. O valor padrão para essa propriedade é Fuzzy.
FuzzyComparisonFlags Inteiro (enumeração) Um valor que especifica como a transformação compara os dados da cadeia de caracteres em uma coluna. Esta propriedade pode ter um dos seguintes valores:

Totalmente sensível

IgnorarCaso

IgnoreKanaType

IgnorarEspaçoNão

IgnoreSymbols

IgnorarLargura



Para obter mais informações, consulte Comparando dados de cadeia de caracteres.
LeadingTrailingNumeraisSignificativos Inteiro (enumeração) Um valor que especifica a significância dos algarismos. Esta propriedade pode ter um dos seguintes valores:

NumeralsNotSpecial (0) - use se os algarismos não são significativos.

LeadingNumeralsSignificant (1)-use se os algarismos principais forem significativos.

TrailingNumeralsSignificant (2)-use se os números finais forem significativos.

LeadingAndTrailingNumeralsSignificant (3)-use se os algarismos iniciais e finais forem significativos.
MinSimilaridade Duplo O limiar de semelhança usado para a junção na coluna, especificado como um valor entre 0 e 1. Apenas as linhas que excedem o limiar se qualificam como correspondências.
ToBeCleaned Booleano Um valor que especifica se a coluna é usada para identificar duplicatas; ou seja, se esta é uma coluna na qual você está agrupando. O valor padrão dessa propriedade é False.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação de Agrupamento Fuzzy. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
Tipo de coluna Inteiro (enumeração) Um valor que identifica o tipo de coluna de saída. Esta propriedade pode ter um dos seguintes valores:

Indefinido (0)

Entrada de chave (1)

Saída de chave (2)

Semelhança (3)

ColumnSimilarity (4)

PassThru (5)

Canónico (6)
ID de entrada Número inteiro O LineageID da coluna de entrada correspondente.

A entrada e a saída da transformação Agrupamento Fuzzy não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de agrupamento difuso.

Propriedades personalizadas da transformação de pesquisa difusa

A transformação Pesquisa Difusa tem propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação Pesquisa Difusa. Todas as propriedades, exceto ReferenceMetadataXML, são leitura/gravação.

Propriedade Tipo de dados Descrição
CopyReferenceTable Booleano Especifica se uma cópia da tabela de referência deve ser feita para a construção do índice de pesquisa difusa e pesquisas subsequentes. O valor padrão dessa propriedade é True.
Delimitadores Cordão Os delimitadores que a transformação usa para tokenizar valores de coluna. Os delimitadores padrão incluem os seguintes caracteres: espaço ( ), vírgula (,), ponto (.) ponto-e-vírgula (;), dois pontos (:) hífen (-), aspas retas duplas ("), aspas retas simples ('), e comercial (&), barra (/), barra invertida (\), arroba (@), ponto de exclamação (!), ponto de interrogação (?), parêntese de abertura ((), parêntese de fechamento ()), menor que (<), maior que (>), colchete de abertura ([), colchete de fechamento (]), chave de abertura ({), chave de fechamento (}), barra vertical (|). sinal numérico (#), asterisco (*), acento circunflexo (^) e percentagem (%).
EliminarÍndiceCorrespondenteExistente Booleano Um valor que especifica se o índice de correspondência especificado em MatchIndexName é excluído quando MatchIndexOptions não está definido como ReuseExistingIndex. O valor padrão para essa propriedade é True.
Exaustivo Booleano Um valor que especifica se cada registro de entrada é comparado a todos os outros registros de entrada. O valor de True destina-se principalmente para fins de depuração. O valor padrão dessa propriedade é False.

Nota: Esta propriedade não está disponível no Editor de Transformação de Pesquisa Fuzzy, mas pode ser definida usando o Editor Avançado.
MatchIndexName Cordão O nome do índice de correspondência. O índice de correspondência é a tabela na qual a transformação cria e salva o índice que ela usa. Se o índice de correspondência for reutilizado, MatchIndexName especifica o índice a ser reutilizado. MatchIndexName deve ser um nome de identificador válido do SQL Server. Por exemplo, se o nome contiver espaços, o nome deverá ser colocado entre parênteses.
MatchIndexOptions Inteiro (enumeração) Um valor que especifica como a transformação gerencia o índice de correspondência. Esta propriedade pode ter um dos seguintes valores:

ReuseExistingIndex (0)

GenerateNewIndex (1)

GenerateAndPersistNewIndex (2)

GenerateAndMaintainNewIndex (3)
UsoMáximoDeMemória Número inteiro O tamanho máximo do cache para a tabela de pesquisa. O valor padrão dessa propriedade é 0, o que significa que o tamanho do cache não tem limite.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

Nota: Esta propriedade não está disponível no Editor de Transformação de Pesquisa Fuzzy, mas pode ser definida usando o Editor Avançado.
MáximoDeCorrespondênciasDeSaídaPorEntrada Número inteiro O número máximo de resultados que a transformação pode devolver para cada linha de entrada. O valor padrão dessa propriedade é 1.

Nota: Valores maiores que 100 só podem ser especificados usando o Editor Avançado.
MinSimilaridade Número inteiro O limiar de semelhança que a transformação usa no nível do componente, especificado como um valor entre 0 e 1. Apenas as linhas que excedem o limiar se qualificam como correspondências.
ReferenceMetadataXML Cordão Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.
NomeDaTabelaReferencia Cordão O nome da tabela de pesquisa. O nome deve ser um nome de identificador válido do SQL Server. Por exemplo, se o nome contiver espaços, o nome deverá ser colocado entre parênteses.
WarmCaches Booleano Quando true, a pesquisa carrega parcialmente o índice e a tabela de referência na memória antes do início da execução. Isso pode melhorar o desempenho.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação Pesquisa difusa. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
FuzzyComparisonFlags Número inteiro Um valor que especifica como a transformação compara os dados da cadeia de caracteres em uma coluna. Para obter mais informações, consulte Comparando dados de cadeia de caracteres.
FuzzyComparisonFlagsEx Inteiro (enumeração) Um valor que especifica quais bandeiras de comparação estendida a transformação utiliza. Os valores podem incluir MapExpandLigatures, MapFoldCZone, MapFoldDigits, MapPrecomposed e NoMapping. NoMapping não pode ser usado com outros sinalizadores.
JuntarÀColunaDeReferência Cordão Um valor que especifica o nome da coluna na tabela de referência à qual a coluna está associada.
Tipo de Adesão Número inteiro Um valor que especifica se a transformação executa uma correspondência difusa ou exata. O valor padrão para essa propriedade é Fuzzy. O valor inteiro para o tipo de junção exato é 1 e o valor para o tipo de junção difusa é 2.
MinSimilaridade Duplo O limiar de semelhança que a transformação usa no nível da coluna, especificado como um valor entre 0 e 1. Apenas as linhas que excedem o limiar se qualificam como correspondências.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Pesquisa difusa. Todas as propriedades são de leitura/gravação.

Observação

Para colunas de saída que contêm valores de passagem das colunas de entrada correspondentes, CopyFromReferenceColumn está vazio e SourceInputColumnLineageID contém o LineageID da coluna de entrada correspondente. Para colunas de saída que contêm resultados de pesquisa, CopyFromReferenceColumn contém o nome da coluna de pesquisa e SourceInputColumnLineageID está vazio.

Propriedade Tipo de dados Descrição
Tipo de coluna Inteiro (enumeração) Um valor que identifica o tipo de coluna de saída para colunas que a transformação adiciona à saída. Esta propriedade pode ter um dos seguintes valores:

Indefinido (0)

Semelhança (1)

Confiança (2)

ColumnSimilarity (3)
CopiarDeColunaDeReferência Cordão Um valor que especifica o nome da coluna na tabela de referência que fornece o valor em uma coluna de saída.
IdentificadorDeLinhasDeOrigemDeColunaDeEntradaFonte Número inteiro Um valor que identifica a coluna de entrada que fornece valores para essa coluna de saída.

A entrada e a saída da transformação Fuzzy Lookup não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de pesquisa difusa.

Propriedades personalizadas da transformação de pesquisa

A transformação Pesquisa tem propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

As tabelas a seguir descrevem as propriedades específicas da transformação Lookup. Todas as propriedades, exceto ReferenceMetadataXML, são leitura/gravação.

Propriedade Tipo de dados Descrição
Tipo de Cache Inteiro (enumeração) O tipo de cache para a tabela de consulta. Os valores são Completo (0), Parcial (1) e Nenhum (2). O valor padrão dessa propriedade é Full.
Página de Código Padrão Número inteiro A página de código padrão a ser usada quando as informações da página de código não estão disponíveis na fonte de dados.
UsoMáximoDeMemória Número inteiro O tamanho máximo do cache para a tabela de pesquisa. O valor padrão dessa propriedade é 25, o que significa que o tamanho do cache não tem limite.
UtilizaçãoMáximaDeMemória64 Número inteiro O tamanho máximo do cache para a tabela de pesquisa em um computador de 64 bits.
NoMatchBehavior Inteiro (enumeração) Um valor que especifica se as linhas sem entradas correspondentes no conjunto de dados de referência são tratadas como erros.

Quando a propriedade é definida como Tratar linhas sem entradas correspondentes como erros (0), as linhas sem entradas correspondentes são tratadas como erros. Você pode especificar o que deve acontecer quando esse tipo de erro ocorre usando a página Saída de Erro da caixa de diálogo Editor de Transformação de Pesquisa . Para obter mais informações, consulte Editor de Transformação de Pesquisa (Página de Saída de Erro).

Quando a propriedade é definida como Enviar linhas sem entradas correspondentes à saída 'sem correspondência' (1), as linhas não são tratadas como erros.

O valor padrão é Tratar linhas sem entradas correspondentes como erros (0).
Mapa de parâmetros Cordão Uma lista delimitada por ponto-e-vírgula de IDs de proveniência que correspondem aos parâmetros utilizados na instrução SqlCommand.
ReferenceMetaDataXML Cordão Metadados para as colunas na tabela de referência que a transformação copia para o seu resultado.
SqlCommand Cordão A instrução SELECT que preenche a tabela de pesquisa.
SqlCommandParam Cordão A instrução SQL parametrizada que preenche a tabela de pesquisa.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação de Lookup. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
CopiarDeColunaDeReferência Cordão O nome da coluna na tabela de referência da qual uma coluna é copiada.
JuntarAosColunasDeReferência Cordão O nome da coluna na tabela de referência à qual uma coluna de origem se junta.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Lookup. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
CopiarDeColunaDeReferência Cordão O nome da coluna na tabela de referência da qual uma coluna é copiada.

A entrada e a saída da transformação de pesquisa não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de pesquisa.

Propriedades personalizadas da transformação de junção de mesclagem

A transformação Merge Join tem propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação Junção de Mesclagem.

Propriedade Tipo de dados Descrição
Tipo de Adesão Inteiro (enumeração) Especifica se a junção é interna (2), externa esquerda (1) ou completa (0).
MaxBuffersPerInput Número inteiro Não é mais necessário configurar o valor da propriedade MaxBuffersPerInput porque a Microsoft fez alterações que reduzem o risco de que a transformação Merge Join consuma memória excessiva. Esse problema às vezes ocorreu quando as várias entradas do Merge Join produziram dados a taxas irregulares.
NúmeroDeColunasChave Número inteiro O número de colunas que são usadas na junção.
TratarNulosComoIgual Booleano Um valor que especifica se a transformação manipula valores nulos como valores iguais. O valor padrão dessa propriedade é True. Se o valor da propriedade for False, a transformação manipulará valores nulos como o SQL Server.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Merge Join. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
ID da Coluna de Entrada Número inteiro O LineageID da coluna de entrada da qual os dados são copiados para esta coluna de saída.

A entrada, as colunas de entrada e a saída da transformação Merge Join não têm propriedades personalizadas.

Para obter mais informações, consulte Merge Join Transformation.

Propriedades personalizadas de transformação de comando OLE DB

A transformação do comando OLE DB conta com propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação do comando OLE DB.

Nome da propriedade Tipo de dados Descrição
CommandTimeout Número inteiro O número máximo de segundos que o comando SQL pode executar antes do tempo limite. Um valor de 0 indica um tempo infinito. O valor padrão dessa propriedade é 0.
Página de Código Padrão Número inteiro A página de código a ser usada quando as informações da página de código não estiverem disponíveis na fonte de dados.
SQLCommand Cordão A instrução Transact-SQL afirma que a transformação será executada para cada linha no fluxo de dados.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

A tabela a seguir descreve as propriedades personalizadas das colunas externas da transformação do comando OLE DB. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
DBParamInfoFlag Inteiro (máscara de bits) Um conjunto de sinalizadores que descrevem as características dos parâmetros. Para obter mais informações, consulte o DBPARAMFLAGSENUM na documentação do OLE DB na Biblioteca MSDN.

A entrada, as colunas de entrada, a saída e as colunas de saída da transformação do comando OLE DB não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de comando OLE DB.

Propriedades personalizadas de transformação de amostragem percentual

A transformação Amostragem Percentual tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela seguinte descreve as propriedades personalizadas da transformação Amostragem por Percentagem.

Propriedade Tipo de dados Descrição
AmostragemSementes Número inteiro A semente que o gerador de números aleatórios usa. O valor padrão dessa propriedade é 0, indicando que a transformação usa uma contagem de ticks.
Valor da amostragem Número inteiro O tamanho da amostra como uma porcentagem da fonte.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

A tabela seguinte descreve as propriedades definidas pelo utilizador das saídas da transformação Amostragem Percentual. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
Selecionados Booleano Designa a saída para a qual as linhas amostradas são direcionadas. Na saída selecionada, Selected é definido como True e, na saída não selecionada, Selected é definido como False.

O input, as colunas de entrada e as colunas de saída da transformação Amostragem Percentual não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de amostragem percentual.

Propriedades personalizadas de transformação de pivô

A tabela a seguir descreve as propriedades do componente personalizado da transformação Pivot.

Propriedade Tipo de dados Descrição
PassThroughUnmatchedPivotKeys Booleano Defina como True para configurar a transformação Pivot para ignorar linhas que contêm valores não reconhecidos na coluna Chave Dinâmica e para exportar todos os valores de chave dinâmica para uma mensagem de log, quando o pacote for executado.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação Pivot. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Uso do pivô Inteiro (enumeração) Um valor que especifica a função de uma coluna quando o conjunto de dados é pivotado.

0:
A coluna não é girada e os valores da coluna são passados para a saída da transformação.

:
A coluna faz parte da chave set que identifica uma ou mais linhas como parte de um conjunto. Todas as linhas de entrada com a mesma chave definida são combinadas em uma linha de saída.

2
A coluna é uma coluna de pivô. Pelo menos uma coluna é criada a partir de cada valor de coluna.

3
Os valores desta coluna são colocados em colunas que são criadas como resultado do pivô.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Pivot. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
PivotKeyValue Cordão Um dos valores possíveis da coluna que é marcada como a chave de pivô pelo valor de sua propriedade PivotUsage.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.
ColunaFonte Número inteiro O LineageID de uma coluna de entrada que contém um valor pivotado ou -1. O valor de -1 indica que a coluna não é usada em uma operação de pivô.

Para obter mais informações, consulte Transformação de Pivot.

Propriedades personalizadas de transformação de contagem de linhas

A transformação Contagem de linhas tem propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação de contagem de linhas. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
Nome_variável Cordão O nome da variável que contém a contagem de linhas.

As entradas, as colunas de entrada, a saída e as colunas de saída da transformação de Contagem de Linhas não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação da contagem de linhas.

Transformação de Amostragem de Linha: Propriedades Personalizadas

A transformação de Amostragem de Linha tem propriedades personalizadas e comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação Row Sampling. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
AmostragemSementes Número inteiro A semente que o gerador de números aleatórios usa. O valor padrão dessa propriedade é 0, indicando que a transformação usa uma contagem de ticks.
Valor da amostragem Número inteiro A contagem de linhas da amostra.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

As propriedades personalizadas das saídas da transformação de amostragem de linha são descritas na tabela a seguir. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
Selecionados Booleano Designa a saída para a qual as linhas amostradas são direcionadas. Na saída selecionada, Selected é definido como True e, na saída não selecionada, Selected é definido como False.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação de amostragem de linhas. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
IdDeLinagemDeColunaDeEntrada Número inteiro Um valor que especifica o LineageID da coluna de entrada que é a origem da coluna de saída.

As colunas de entrada e as colunas de entrada da transformação de Amostragem de Linha não têm propriedades personalizadas.

Para mais informações, consulte Transformação de Amostragem de Linha.

Propriedades personalizadas do componente de script

O componente Script tem propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados. As mesmas propriedades personalizadas estão disponíveis se o Componente de Script funcionar como origem, transformação ou destino.

A tabela a seguir descreve as propriedades personalizadas do componente Script. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
ReadOnlyVariables Cordão Uma lista separada por vírgulas de variáveis disponíveis para o componente Script para acesso somente leitura.
ReadWriteVariables Cordão Uma lista separada por vírgulas de variáveis disponíveis para o componente de script para acesso de leitura/gravação.

As colunas de entrada, as colunas de saída e o Componente de Script não têm propriedades personalizadas, a menos que o desenvolvedor do script crie propriedades personalizadas para elas.

Para obter mais informações, consulte Componente de script.

Mudando lentamente as propriedades personalizadas da transformação de dimensão

A transformação de Dimensão de Mudança Lenta possui propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela seguinte descreve as propriedades personalizadas da transformação de Dimensão de Mudança Lenta. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
CurrentRowWhere Cordão A cláusula WHERE na instrução SELECT que seleciona a linha atual entre linhas com a mesma chave comercial.
AtivarMembroInferido Booleano Um valor que especifica se as atualizações de membros inferidas são detetadas. O valor padrão dessa propriedade é True.
FalhaAoModificarAtributoFixo Booleano Um valor que especifica se a transformação falha quando colunas de linha com atributos fixos contêm alterações ou a pesquisa na tabela de dimensões falha. Se você espera que as linhas de entrada contenham novos registros, defina esse valor como True para fazer com que a transformação continue depois que a pesquisa falhar, porque a transformação usa a falha para identificar novos registros. O valor padrão dessa propriedade é False.
FailOnLookupFailure Booleano Um valor que especifica se a transformação falha quando uma pesquisa de um registro existente falha. O valor padrão dessa propriedade é False.
Tipo de Alteração de Linha de Entrada Número inteiro Um valor que especifica se todas as linhas de entrada são novas linhas ou se a transformação deve detetar o tipo de alteração.
IndicadorDeMembroInferido Cordão O nome da coluna para o membro inferido.
SQLCommand Cordão A instrução SQL usada para criar um conjunto de linhas de esquema.
AtualizarHistóricoDeAlteraçãoDeAtributo Booleano Um valor que indica se as atualizações de atributos históricos são direcionadas para a saída de transformação para atualizações de atributos que mudam.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação de Mudança Lenta de Dimensão. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Tipo de coluna Inteiro (enumeração) O tipo de atualização da coluna. Os valores são: Atributo Variável (2), Atributo Fixo (4), Atributo Histórico (3), Chave (1) e Outros (0).

As colunas de entrada, as colunas de saída e a transformação de Dimensão de Mudança Lenta não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de Dimensão de Mudança Lenta.

Propriedades personalizadas de transformação de classificação

A transformação Sort tem propriedades personalizadas, além das propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação Sort. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
EliminarDuplicados Booleano Especifica se a transformação remove linhas duplicadas da saída da transformação. O valor padrão dessa propriedade é False.
NúmeroMáximoDeThreads Número inteiro Contém o número máximo de threads que a transformação pode usar para classificação. Um valor de 0 indica um número infinito de threads. O valor padrão dessa propriedade é 0.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação Sort. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
NovasFlâmulasDeComparação Inteiro (máscara de bits) Um valor que especifica como a transformação compara os dados da cadeia de caracteres em uma coluna. Para obter mais informações, consulte Comparando dados de cadeia de caracteres.
NovaPosiçãoChaveDeOrdenação Número inteiro Um valor que especifica a ordem de classificação da coluna. Um valor 0 indica que os dados não estão classificados nesta coluna.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Sort. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
SortColumnID Número inteiro O LineageID de uma coluna de classificação.

A entrada e a saída da transformação Sort não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de classificação.

Propriedades personalizadas da transformação de extração de termos

A transformação Term Extraction possui propriedades personalizadas, bem como as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação Term Extraction. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Limite de Frequência Número inteiro Um valor numérico que indica o número de vezes que um termo deve ocorrer antes de ser extraído. O valor padrão dessa propriedade é 2.
ÉSensívelACaso Booleano Um valor que especifica se a diferenciação de maiúsculas e minúsculas é usada ao extrair substantivos e frases nominais. O valor padrão dessa propriedade é False.
MaxLengthOfTerm Número inteiro Um valor numérico que indica o comprimento máximo de um termo. Esta propriedade aplica-se apenas a frases. O valor padrão dessa propriedade é 12.
NecessitaDadosDeReferência Booleano Um valor que especifica se a transformação usa uma lista de termos de exclusão armazenados em uma tabela de referência. O valor padrão dessa propriedade é False.
OutTermColumn Cordão O nome da coluna que contém os termos de exclusão.
OutTermTable Cordão O nome da tabela que contém a coluna com termos de exclusão.
Tipo de pontuação Número inteiro Um valor que especifica o tipo de pontuação a ser associada ao termo. Os valores válidos são 0 indicando frequência e 1 indicando uma pontuação TFIDF. A pontuação TFIDF é o produto da Frequência do Termo e da Frequência Inversa de Documento, definida como: TFIDF de um Termo T = (frequência de T) * log(número de linhas de Entrada / número de linhas contendo T). O valor padrão dessa propriedade é 0.
WordOrPhrase Número inteiro Um valor que especifica o tipo de termo. Os valores válidos são 0 indicando apenas palavras, 1 indicando apenas frases nominais e 2 indicando palavras e frases nominais. O valor padrão dessa propriedade é 0.

As colunas de entrada, as colunas de saída e a transformação de extração de termos não têm propriedades personalizadas.

Para obter mais informações, consulte Extração e Transformação de Termos.

Propriedades personalizadas da transformação de pesquisa de termos

A transformação Pesquisa de Termo tem propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da transformação de Pesquisa de Termos. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
ÉSensívelACaso Booleano Um valor que especifica se uma comparação que diferencia maiúsculas de minúsculas se aplica à correspondência entre o texto da coluna de entrada e o termo de pesquisa. O valor padrão dessa propriedade é False.
RefTermColumn Cordão O nome da coluna que contém os termos de pesquisa.
Tabela de Termos de Referência Cordão O nome da tabela que contém a coluna com termos de pesquisa.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação Pesquisa de Termos. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
TipoDeColunaDeEntrada Número inteiro Um valor que especifica o uso da coluna. Os valores válidos são 0 para uma coluna de passagem, 1 para uma coluna de pesquisa e 2 para uma coluna que é de passagem e de pesquisa.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação de pesquisa de termos. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
CustomLineageID Número inteiro O LineageID da coluna de entrada correspondente, caso o InputColumnType dessa coluna seja 0 ou 2.

A entrada e a saída da transformação Pesquisa de Termo não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação de pesquisa de termos.

Propriedades personalizadas da transformação Unpivot

A transformação Unpivot tem apenas as propriedades comuns a todos os componentes de fluxo de dados no nível do componente.

Observação

Esta seção se baseia no cenário Unpivot descrito em Unpivot Transformation para ilustrar o uso das opções descritas aqui.

A tabela a seguir descreve as propriedades personalizadas das colunas de entrada da transformação Unpivot. Todas as propriedades são de leitura/gravação.

Propriedade Tipo de dados Descrição
Coluna de Destino Número inteiro O LineageID da coluna de saída para onde a coluna de entrada está mapeada. Um valor de -1 indica que a coluna de entrada não está mapeada para uma coluna de saída.
PivotKeyValue Cordão Uma coluna de saída de transformação para a qual um valor é copiado.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

No cenário Unpivot descrito em Unpivot Transformation, os Valores Pivot são os valores de texto Ham, Coke, Milk, Beer e Chips. Eles aparecerão como valores de texto na nova coluna produto utilizada pela opção Nome da Coluna de Valor de Chave Dinâmica.

A tabela a seguir descreve as propriedades personalizadas das colunas de saída da transformação Unpivot. Todas as propriedades são de leitura/gravação.

Nome da propriedade Tipo de dados Descrição
Chave Dinâmica Booleano Indica se os valores na propriedade PivotKeyValue das colunas de entrada são gravados nessa coluna de saída.

No cenário Unpivot descrito em Unpivot Transformation, o nome da coluna Valor Pivot é Produto e designa a nova coluna Produto na qual as colunas Presunto, Coca-Cola, Leite, Cerveja e Batatas fritas são despivotadas.

A entrada e a saída da transformação Unpivot não têm propriedades personalizadas.

Para obter mais informações, consulte Transformação desdinâmica.

Ver também

Transformações do Integration Services
Propriedades comuns
Propriedades do caminho
Propriedades de fluxo de dados que podem ser definidas usando expressões