Artigo
04/01/2012

Propriedades personalizadas de destino

Os objetos Data Flow nos modelos de objeto do Microsoft SQL Server Integration Services têm propriedades comuns e personalizadas no nível de componente, entradas e saídas e colunas de entrada e saída. As propriedades personalizadas estão disponíveis somente em tempo de execução e não constam na Documentação de Referência de Programação Gerenciada do Integration Services.

Este tópico lista e descreve as propriedades personalizadas de destinos de fluxo de dados.

Destino ADO NET
Destino Treinamento do Modelo de Mineração de Dados
Destino DataReader
Destino Processamento de Dimensão
Destino do Excel
Destino Arquivo Simples
Destino OLE DB
Destino Processamento de Partições
Destino Arquivo Bruto
Destino Conjunto de Registros
Destino SQL Server Compact Edition
Destino SQL Server

Para obter mais informações sobre as propriedades comuns à maioria dos objetos Data Flow, consulte Propriedades comuns.

Algumas propriedades de destinos 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.

Destino ADO NET

O destino ADO.NET tem as propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino ADO.NET. Todas as propriedades são de leitura/gravação. Essas propriedades não estão disponíveis no Editor de Destinos ADO NET, mas podem ser definidas usando o Editor Avançado.

Propriedade	Tipo de Dados	Descrição
BatchSize	Inteiro	O número de linhas em um lote enviadas ao servidor. O valor 0 indica que o tamanho do lote corresponde ao tamanho do buffer interno. O valor padrão dessa propriedade é 0.
CommandTimeOut	Inteiro	O número máximo de segundos em que o comando SQL pode ser executado antes que o tempo limite seja excedido. O valor 0 indica que não há limite de tempo. O valor padrão dessa propriedade é 0.
TableOrViewName	String	O nome da tabela ou exibição de destino.
UseBulkInsertWhenAvailable	Boolean	Um valor que especifica se a interface System.Data.SqlClient..::..SqlBulkCopy deve ser usada para melhorar o desempenho de operações de inserção em massa. Somente determinados provedores ADO.NET dão suporte a essa interface. O valor padrão é True.

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

Propriedades personalizadas do destino Treinamento do Modelo de Mineração de Dados

O destino Treinamento do Modelo de Mineração de Dados tem propriedades personalizadas e as propriedades comum a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino Treinamento do Modelo de Mineração de Dados. Todas as propriedades são de leitura/gravação.

Propriedade	Tipo de dados	Descrição
ASConnectionId	Cadeia de caracteres	O identificador exclusivo do gerenciador de conexões.
ASConnectionString	Cadeia de caracteres	A cadeia de caracteres de conexão com uma instância do Analysis Services ou com um projeto do Analysis Services.
ObjectRef	Cadeia de caracteres	Uma marca XML que identifica a estrutura de mineração de dados usada pela transformação.

A entrada e as colunas de entrada do destino Treinamento do Modelo de Mineração de Dados não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino de treinamento do modelo de mineração de dados.

Propriedades personalizadas do destino DataReader

O destino DataReader tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino DataReader. Todas as propriedades, exceto DataReader, são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
DataReader	Cadeia de caracteres	O nome da classe do destino DataReader.
FailOnTimeout	Booleano	Indica se deve haver falha na ocorrência de ReadTimeout. O valor padrão dessa propriedade é False.
ReadTimeout	Inteiro	O número de milissegundos antes de um tempo limite. O valor padrão dessa propriedade é 30000 (30 segundos).

A entrada e as colunas de entrada do destino DataReader não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino DataReader.

Propriedades personalizadas do destino Processamento de Dimensões

O destino Processamento de Dimensões tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino Processamento de Dimensões. Todas as propriedades são de leitura/gravação.

Propriedade	Tipo de dados	Descrição
ASConnectionString	Cadeia de caracteres	A cadeia de caracteres de conexão com uma instância do Analysis Services ou com um projeto do Analysis Services.
KeyDuplicate	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar erros de chave duplicados. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é IgnoreError (0).
KeyErrorAction	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar erros de chave. Os valores possíveis são ConvertToUnknown (0) e DiscardRecord (1). O valor padrão dessa propriedade é ConvertToUnknown (0).
KeyErrorLimit	Inteiro	Quando UseDefaultConfiguration é False, o limite superior de erros de chave habilitados.
KeyErrorLimitAction	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica a ação a ser realizada quando KeyErrorLimit é alcançado. Os valores possíveis são StopLogging (1) e StopProcessing (0). O valor padrão dessa propriedade é StopProcessing (0).
KeyErrorLogFile	Cadeia de Caracteres	Quando UseDefaultConfiguration é False, o caminho e o nome de arquivo do arquivo de log de erros.
KeyNotFound	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar erros de chave não encontrados. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é IgnoreError (0).
NullKeyConvertedToUnknown	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar chaves nulas convertidas no valor desconhecido. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é IgnoreError (0).
NullKeyNotAllowed	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar nulos desaprovados. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é IgnoreError (0).
ProcessType	Inteiro (enumeração)	O tipo de processamento de dimensões usado pela transformação. Os valores são ProcessAdd (1) (incremental), ProcessFull (0) e ProcessUpdate (2).
UseDefaultConfiguration	booleano	Um valor que especifica se a transformação usa a configuração de erro padrão. Se essa propriedade for False, a transformação incluirá informações sobre processamento de erros.

A entrada e as colunas de entrada do destino Processamento de Dimensões não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino de processamento de dimensões.

Propriedades personalizadas do destino Excel

O destino Excel tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

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

Nome da propriedade	Tipo de dados	Descrição
AccessMode	Inteiro (enumeração)	Um valor que especifica como o destino acessa o seu banco de dados de destino. Essa propriedade pode ter um dos seguintes valores: OpenRowset (0) — Você fornece o nome de uma tabela ou exibição. OpenRowset from Variable (1) — Você fornece o nome de uma variável que contém o nome de uma tabela ou exibição. OpenRowset Using Fastload (3) — Você fornece o nome de uma tabela ou exibição. OpenRowset Using Fastload from Variable (4) — Você fornece o nome de uma variável que contém o nome de uma tabela ou exibição. SQL Command (2) — Você fornece uma instrução SQL.
CommandTimeout	Inteiro	O número máximo de segundos que o comando SQL pode ser executado antes que o tempo limite seja excedido. O valor 0 indica que não há limite de tempo. O valor padrão dessa propriedade é 0. Observação Essa propriedade não está disponível no Editor de Destinos Excel, mas pode ser definida no Editor Avançado.
FastLoadKeepIdentity	Booleano	Um valor que especifica se os valores de identidade devem ser copiados quando os dados são carregados. Essa propriedade só está disponível quando uma das opções de carregamento rápido é usada. O valor padrão dessa propriedade é False.
FastLoadKeepNulls	Booleano	Um valor que especifica se os valores Nulos devem ser copiados quando os dados são carregados. Essa propriedade só está disponível com uma das opções de carregamento rápido. O valor padrão dessa propriedade é False.
FastLoadMaxInsertCommitSize	Inteiro	Um valor que especifica o tamanho do lote que o destino Excel tenta confirmar durante as operações de carregamento rápido. O valor padrão, 0, indica uma única operação de confirmação após o processamento de todas as linhas.
FastLoadOptions	Cadeia de caracteres	Uma coleção de opções de carregamento rápido. As opções de carregamento rápido incluem o bloqueio de tabelas e a verificação de restrições. É possível especificar uma, ambas ou nenhuma. Observação Algumas opções dessa propriedade não estão disponíveis no Editor de Destinos Excel, mas podem ser definidas no Editor Avançado.
OpenRowset	Cadeia de caracteres	Quando AccessMode é OpenRowset, o nome da tabela ou exibição acessada pelo destino Excel.
OpenRowsetVariable	Cadeia de caracteres	Quando AccessMode é OpenRowset from Variable, o nome da variável que contém o nome da tabela ou exibição acessada pelo destino Excel.
SqlCommand	Cadeia de caracteres	Quando AccessMode é Comando SQL, a instrução Transact-SQL usada pelo destino Excel para especificar as colunas de destino dos dados.

A entrada e as colunas de entrada do destino Excel não têm nenhuma propriedade personalizada.

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

Propriedades personalizadas do destino Arquivo Simples

O destino Arquivo Simples tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

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

Nome da propriedade	Tipo de dados	Descrição
Header	Cadeia de caracteres	Um bloco de texto inserido no arquivo antes que qualquer dado seja gravado. O valor dessa propriedade pode ser especificado com uma expressão de propriedade.
Overwrite	Booleano	Um valor que especifica se será substituído ou adicionado a um arquivo de destino existente de mesmo nome. O valor padrão dessa propriedade é True.

Header

Cadeia de caracteres

Um bloco de texto inserido no arquivo antes que qualquer dado seja gravado.

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

Overwrite

Booleano

Um valor que especifica se será substituído ou adicionado a um arquivo de destino existente de mesmo nome. O valor padrão dessa propriedade é True.

A entrada e as colunas de entrada do destino Arquivo Simples não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino de arquivo simples.

Propriedades personalizadas do destino OLE DB

O destino OLE DB tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

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

Observação
As opções de FastLoad relacionadas aqui (FastLoadKeepIdentity, FastLoadKeepNulls e FastLoadOptions) correspondem às propriedades de nomes parecidos expostas pela interface IRowsetFastLoad implementada pelo Microsoft OLE DB Provider for SQL Server (SQLOLEDB). Para obter mais informações, procure por IRowsetFastLoad na Biblioteca MSDN.

Nome da propriedade	Tipo de dados	Descrição
AccessMode	Inteiro (enumeração)	Um valor que especifica como o destino acessa o seu banco de dados de destino. Essa propriedade pode ter um dos seguintes valores: OpenRowset (0) — Você fornece o nome de uma tabela ou exibição. OpenRowset from Variable (1) — Você fornece o nome de uma variável que contém o nome de uma tabela ou exibição. OpenRowset Using Fastload (3) — Você fornece o nome de uma tabela ou exibição. OpenRowset Using Fastload from Variable (4) — Você fornece o nome de uma variável que contém o nome de uma tabela ou exibição. SQL Command (2) — Você fornece uma instrução SQL.
AlwaysUseDefaultCodePage	booliano	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 dessa propriedade é False.
CommandTimeout	Inteiro	O número máximo de segundos em que o comando SQL pode ser executado antes que o tempo limite seja excedido. O valor 0 indica que não há limite de tempo. O valor padrão dessa propriedade é 0. Observação Essa propriedade não está disponível no Editor de Destinos OLE DB, mas pode ser definida no Editor Avançado.
DefaultCodePage	Inteiro	A página de código padrão associada ao destino OLE DB.
FastLoadKeepIdentity	Booleano	Um valor que especifica se os valores de identidade devem ser copiados quando os dados são carregados. Essa propriedade só está disponível com uma das opções de carregamento rápido. O valor padrão dessa propriedade é False. Essa propriedade corresponde à propriedade IRowsetFastLoad (OLE DB) do OLE DB SSPROP_FASTLOADKEEPIDENTITY.
FastLoadKeepNulls	Booleano	Um valor que especifica se os valores Nulos devem ser copiados quando os dados são carregados. Essa propriedade só está disponível com uma das opções de carregamento rápido. O valor padrão dessa propriedade é False. Essa propriedade corresponde à propriedade IRowsetFastLoad (OLE DB) do OLE DB SSPROP_FASTLOADKEEPNULLS.
FastLoadMaxInsertCommitSize	Inteiro	Um valor que especifica o tamanho do lote que o destino OLE DB tenta confirmar durante as operações de carregamento rápido. O valor padrão, 2147483647, indica uma única operação de confirmação após o processamento de todas as linhas.
FastLoadOptions	Cadeia de caracteres	Uma coleção de opções de carregamento rápido. As opções de carregamento rápido incluem o bloqueio de tabelas e a verificação de restrições. É possível especificar uma, ambas ou nenhuma. Essa propriedade corresponde à propriedade IRowsetFastLoad do OLE DB SSPROP_FASTLOADOPTIONS e aceita opções de cadeia de caracteres como CHECK_CONSTRAINTS e TABLOCK. Observação Algumas opções dessa propriedade não estão disponíveis no Editor de Destinos Excel, mas podem ser definidas no Editor Avançado.
OpenRowset	Cadeia de caracteres	Quando AccessMode é OpenRowset, o nome da tabela ou exibição acessada pelo destino OLE DB.
OpenRowsetVariable	Cadeia de caracteres	Quando AccessMode é OpenRowset from Variable, o nome da variável que contém o nome da tabela ou exibição acessada pelo destino OLE DB.
SqlCommand	Cadeia de caracteres	Quando AccessMode é Comando SQL, a instrução Transact-SQL usada pelo destino OLE DB para especificar as colunas de destino dos dados.

A entrada e as colunas de entrada do destino OLE DB não têm nenhuma propriedade personalizada.

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

Propriedades personalizadas do destino Processamento de Partições

O destino Processamento de Partições tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino Processamento de Partições. Todas as propriedades são de leitura/gravação.

Propriedade	Tipo de dados	Descrição
ASConnectionString	Cadeia de caracteres	A cadeia de caracteres de conexão com uma instância do Analysis Services ou com um projeto do Analysis Services.
KeyDuplicate	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar erros de chave duplicados. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é IgnoreError (0).
KeyErrorAction	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar erros de chave. Os valores possíveis são ConvertToUnknown (0) e DiscardRecord (1). O valor padrão dessa propriedade é ConvertToUnknown (0).
KeyErrorLimit	Inteiro	Quando UseDefaultConfiguration é False, o limite superior de erros de chave permitidos.
KeyErrorLimitAction	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica a ação a ser realizada quando KeyErrorLimit é alcançado. Os valores possíveis são StopLogging (1) e StopProcessing (0). O valor padrão dessa propriedade é StopProcessing (0).
KeyErrorLogFile	Cadeia de Caracteres	Quando UseDefaultConfiguration é False, o caminho e o nome de arquivo do arquivo de log de erros.
KeyNotFound	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar erros de chave não encontrados. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é ReportAndContinue (1).
NullKeyConvertedToUnknown	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar chaves nulas convertidas para o valor Desconhecido. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é IgnoreError (0).
NullKeyNotAllowed	Inteiro (enumeração)	Quando UseDefaultConfiguration é False, um valor que indica como controlar nulos desaprovados. Os valores possíveis são IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). O valor padrão dessa propriedade é ReportAndContinue (1).
ProcessType	Inteiro (enumeração)	O tipo de processamento de partições usado pela transformação. Os valores possíveis são ProcessAdd (1) (incremental), ProcessFull (0) e ProcessUpdate (2).
UseDefaultConfiguration	booleano	Um valor que especifica se a transformação usa a configuração de erro padrão. Se essa propriedade for False, a transformação usará os valores das propriedades personalizadas de controle de erro relacionadas na tabela, inclusive KeyDuplicate, KeyErrorAction e assim por diante.

A entrada e as colunas de entrada do destino Processamento de Partições não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino de Processamento de Partições.

Propriedades personalizadas do destino Arquivo Bruto

O destino Arquivo Bruto tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

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

Nome da propriedade	Tipo de dados	Descrição
AccessMode	Inteiro (enumeração)	Um valor que especifica se a propriedade FileName contém um nome de arquivo ou o nome de uma variável que contenha um nome de arquivo. As opções são File name (0) e File name from variable (1).
FileName	Cadeia de Caracteres	O nome do arquivo no qual o destino Arquivo Bruto grava.
WriteOption	Inteiro (enumeração)	Um valor que especifica se o destino Arquivo Bruto exclui um arquivo existente de mesmo nome. As opções são Create Always (0), Create Once (1), Truncate and Append (3) e Append (2). O valor padrão dessa propriedade é Create Always (0).

Observação
Uma operação de acréscimo requer que os metadados dos dados acrescentados correspondam aos metadados dos dados já existentes no arquivo.

A entrada e as colunas de entrada do destino Arquivo Bruto não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino Arquivo Bruto.

Propriedades personalizadas do destino Conjunto de Registros

O destino Conjunto de Registros tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino Conjunto de Registros. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
VariableName	Cadeia de caracteres	O nome da variável que mantém o conjunto de registros ADO.

A entrada e as colunas de entrada do destino Conjunto de Registros não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino do Conjunto de Registros.

Propriedades personalizadas do destino SQL Server Compact Edition

O destino SQL Server Compact tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino SQL Server Compact. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
TableName	Cadeia de caracteres	O nome da tabela de destino em um banco de dados do SQL Server Compact. O valor dessa propriedade pode ser especificado com uma expressão de propriedade.

TableName

Cadeia de caracteres

O nome da tabela de destino em um banco de dados do SQL Server Compact.

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

A entrada e as colunas de entrada do destino SQL Server Compact não têm nenhuma propriedade personalizada.

Para obter mais informações, consulte Destino do SQL Server Compact Edition.

Propriedades personalizadas do destino SQL Server

O destino SQL Server tem propriedades personalizadas e propriedades comuns a todos os componentes de fluxo de dados.

A tabela a seguir descreve as propriedades personalizadas do destino SQL Server. Todas as propriedades são de leitura/gravação.

Nome da propriedade	Tipo de dados	Descrição
AlwaysUseDefaultCodePage	Booleano	Força o uso do valor da propriedade DefaultCodePage. O valor padrão dessa propriedade é False.
BulkInsertCheckConstraints	Booleano	Um valor que especifica se a inserção em massa verifica restrições. O valor padrão dessa propriedade é True.
BulkInsertFireTriggers	Booleano	Um valor que especifica se a inserção em massa aciona gatilhos em tabelas. O valor padrão dessa propriedade é False.
BulkInsertFirstRow	Inteiro	Um valor que especifica a primeira linha a ser inserida. O valor padrão dessa propriedade é -1, que indica que nenhum valor foi atribuído.
BulkInsertKeepIdentity	Booleano	Um valor que especifica se podem ser inseridos valores em colunas de identidade. O valor padrão dessa propriedade é False.
BulkInsertKeepNulls	Booleano	Um valor que especifica se a inserção em massa mantém valores Nulos. O valor padrão dessa propriedade é False.
BulkInsertLastRow	Inteiro	Um valor que especifica a última linha a ser inserida. O valor padrão dessa propriedade é -1, que indica que nenhum valor foi atribuído.
BulkInsertMaxErrors	Inteiro	Um valor que especifica o número de erros que podem ocorrer antes que a inserção em massa seja interrompida. O valor padrão dessa propriedade é -1, que indica que nenhum valor foi atribuído.
BulkInsertOrder	Cadeia de caracteres	Os nomes das colunas de classificação. Cada coluna pode ser classificada em ordem crescente ou decrescente. Se forem usadas várias colunas de classificação, os nomes de coluna serão separados por vírgulas.
BulkInsertTableName	Cadeia de caracteres	A tabela ou exibição do SQL Server no banco de dados para o qual os dados são copiados.
BulkInsertTablock	Booleano	Um valor que especifica se a tabela é bloqueada durante a inserção em massa. O valor padrão dessa propriedade é True.
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.
MaxInsertCommitSize	Inteiro	Um valor que especifica o número máximo de linhas a serem inseridas em um lote. Quando o valor é zero, todas as linhas são inseridas em um único lote.
Timeout	Inteiro	Um valor que especifica a duração em segundos da espera do destino SQL Server até a conclusão, se não houver dados disponíveis para inserção. O valor 0 significa que não há tempo limite para o destino SQL Server. O valor padrão dessa propriedade é 30.