Artigo
04/01/2012

Propriedades personalizadas de fontes

Os objetos do Fluxo de Dados nos modelos de objeto do Integration Services Microsoft SQL Server têm propriedades comuns e personalizadas no nível do componente, da entrada e saída e das colunas de entrada e saída. É possível acessar as propriedades personalizadas somente em tempo de execução e não constam da Documentação de Referência de Programação Gerenciada do Integration Services.

Este tópico lista e descreve as propriedades personalizadas de fontes de fluxos de dados.

Origem do ADO.NET
Origem do Excel
Fonte de arquivo simples
Origem OLE DB
Fonte Arquivo Bruto
Origem XML

Para obter mais informações sobre as propriedades comuns à maioria dos objetos do Fluxo de Dados, consulte Propriedades comuns.

Algumas propriedades de fontes podem ser definidas usando expressões de propriedade, conforme indicado neste tópico. Para obter mais informações, consulte Propriedades de fluxo de dados que podem ser definidas usando expressões.

Propriedades personalizadas da origem do ADO.NET

A origem do ADO.NET tem as propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da origem do ADO.NET. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
CommandTimeout	Cadeia de caracteres	Um valor que especifica quanto segundos faltam para que o comando SQL expire. Um valor de 0 indica que o comando nunca expirará.
SqlCommand	Cadeia de caracteres	A instrução SQL usada pela origem do ADO.NET para extrair dados. Quando o pacote é carregado, é possível atualizar esta propriedade de forma dinâmica com a instrução SQL que será usada pela origem do ADO.NET. Para obter mais informações, consulte Referência de Expressão do Integration Services e Usando expressões de propriedade em pacotes.
AllowImplicitStringConversion	Booleano	Um valor que indica se o seguinte acontece: Nenhuma geração de erro de validação se não houver correspondência entre tipos de metadados externos e tipos de coluna de saída que são cadeias de caracteres (DT_WSTR ou DT_NTEXT). Conversão implícita de tipos de metadados externos para tipo de dados de cadeia de caracteres usado pela coluna de saída. O valor padrão é TRUE. Para obter mais informações, consulte Origem do ADO.NET.

CommandTimeout

Cadeia de caracteres

Um valor que especifica quanto segundos faltam para que o comando SQL expire. Um valor de 0 indica que o comando nunca expirará.

SqlCommand

Cadeia de caracteres

A instrução SQL usada pela origem do ADO.NET para extrair dados.

Quando o pacote é carregado, é possível atualizar esta propriedade de forma dinâmica com a instrução SQL que será usada pela origem do ADO.NET. Para obter mais informações, consulte Referência de Expressão do Integration Services e Usando expressões de propriedade em pacotes.

AllowImplicitStringConversion

Booleano

Um valor que indica se o seguinte acontece:

Nenhuma geração de erro de validação se não houver correspondência entre tipos de metadados externos e tipos de coluna de saída que são cadeias de caracteres (DT_WSTR ou DT_NTEXT).
Conversão implícita de tipos de metadados externos para tipo de dados de cadeia de caracteres usado pela coluna de saída.

O valor padrão é TRUE.

Para obter mais informações, consulte Origem do ADO.NET.

A saída e as colunas de saída da origem do ADO.NET não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Origem do ADO.NET.

Propriedades personalizadas da origem do Excel

A origem do Excel tem as propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da origem do Excel. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
AccessMode	Inteiro	O modo usado para acessar o banco de dados. Os valores possíveis são Abrir Conjunto de Linhas , Abrir Conjunto de Linhas da Variável, Comando do SQL e Comando SQL a partir da Variável. O valor padrão é Abrir Conjunto de Linhas.
CommandTimeout	Inteiro	O número de segundos antes de um comando expirar. Um valor de 0 indica que nunca expirará. Observação: esta propriedade não está disponível no Editor de Origem do Excel, mas pode ser definida usando o Editor Avançado.
OpenRowset	Cadeia de caracteres	O nome do objeto de banco de dados usado para abrir um conjunto de linhas.
OpenRowsetVariable	Cadeia de caracteres	A variável que contém o nome do objeto de banco de dados usado para abrir um conjunto de linhas.
ParameterMapping	Cadeia de caracteres	O mapeamento de parâmetros no comando SQL para variáveis.
SqlCommand	Cadeia de caracteres	O comando SQL a ser executado.
SqlCommandVariable	Cadeia de caracteres	A variável que contém o comando do SQL a ser executado.

A saída e as colunas de saída da origem do Excel não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Origem do Excel.

Propriedades personalizadas da fonte de Arquivo Simples

A fonte de Arquivo Simples tem as propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da fonte de Arquivo Simples. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
FileNameColumnName	Cadeia de caracteres	O nome de uma coluna de saída que contém o nome de arquivo. Se nenhum nome for especificado, nenhuma coluna de saída que contém o nome de arquivo será gerada. Observação Esta propriedade não está disponível no Editor de Fonte de Arquivo Simples, mas pode ser definida usando o Editor Avançado.
RetainNulls	Booleano	Um valor que especifica se os valores Nulos do arquivo de origem devem ser retidos como valores Nulos quando os dados forem processados pelo mecanismo Pipeline de Transformação de Dados. O valor padrão desta propriedade é False.

A saída da fonte de Arquivo Simples não tem nenhuma propriedade personalizada.

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

Nome da propriedade	Tipo de dados	Descrição
FastParse	Booleano	Um valor que indica se as colunas usam as rotinas de análise mais rápidas, mas que não fazem distinção entre localidades, fornecido pelo DTS, ou as rotinas de análise padrão que fazem distinção entre localidades. Para obter mais informações, consulte Análise rápida e Análise padrão. O valor padrão desta propriedade é False. Observação Esta propriedade não está disponível no Editor da Fonte de Arquivo Simples, mas pode ser definida usando o Editor Avançado.

Para obter mais informações, consulte Fonte de Arquivo Simples.

Propriedades personalizadas da origem de OLE DB

A origem de OLE DB tem as propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da origem de OLE DB. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
AccessMode	Inteiro	O modo usado para acessar o banco de dados. Os valores possíveis são Abrir Conjunto de Linhas, Abrir Conjunto de Linhas da Variável, Comando do SQL e Comando SQL da Variável. O valor padrão é Abrir Conjunto de Linhas.
AlwaysUseDefaultCodePage	Booleano	Um valor que indica se o valor da propriedade DefaultCodePage deve ser usado para todas as colunas ou para tentar derivar a página de código da localidade de cada coluna. O valor padrão desta propriedade é False.
CommandTimeout	Inteiro	O número de segundos antes de um comando expirar. Um valor de 0 indica que nunca expirará. Observação Esta propriedade não está disponível no Editor de Origem de OLE DB, mas pode ser definida usando o Editor Avançado.
DefaultCodePage	Inteiro	A página de código a ser usada quando informações de página de código não estão disponíveis na fonte de dados.
OpenRowset	Cadeia de caracteres	O nome do objeto de banco de dados usado para abrir um conjunto de linhas.
OpenRowsetVariable	Cadeia de caracteres	A variável que contém o nome do objeto de banco de dados usado para abrir um conjunto de linhas.
ParameterMapping	Cadeia de caracteres	O mapeamento de parâmetros no comando SQL para variáveis.
SqlCommand	Cadeia de caracteres	O comando SQL a ser executado.
SqlCommandVariable	Cadeia de caracteres	A variável que contém o comando SQL a ser executado.

A saída e as colunas de saída da origem de OLE DB não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Origem de OLE DB.

Propriedades personalizadas da fonte de Arquivo Bruto

A fonte de Arquivo Bruto tem as propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas da fonte de Arquivo Bruto. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
AccessMode	Inteiro (enumeração)	O modo usado para acessar os dados brutos. Os valores possíveis são File name (0) e File name from variable (1). O valor padrão é File name (0).
FileName	Cadeia de Caracteres	O caminho e o nome do arquivo do arquivo de origem.

A saída e as colunas de saída da fonte Arquivo Bruto não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Origem do arquivo bruto.

Propriedades personalizadas da origem XML

A origem XML contém propriedades personalizadas e as propriedades comuns a todos os componentes de fluxo de dados.

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

Nome da propriedade	Tipo de dados	Descrição
AccessMode	Inteiro	O modo usado para acessar os dados XML.
UseInlineSchema	Booleano	Um valor que indica se deve ser usada uma definição de esquema embutido dentro da origem XML. O valor padrão desta propriedade é False.
XMLData	Cadeia de caracteres	O arquivo ou variáveis dos quais é possível recuperar os dados XML. O valor dessa propriedade pode ser especificado com uma expressão de propriedade.
XMLSchemaDefinition	Cadeia de caracteres	O caminho e nome de arquivo do arquivo de definição de esquema (.xsd). O valor dessa propriedade pode ser especificado com uma expressão de propriedade.