發行項
04/02/2012

目的地自訂屬性

Microsoft SQL Server Integration Services 物件模型中的資料流程物件，具有元件層級、輸入和輸出層級，以及輸入資料行和輸出資料行層級上的通用屬性和自訂屬性。這些自訂屬性只能在執行階段使用，而且不會記錄在 Integration Services Managed 程式設計參考文件集中。

本主題將列出及描述資料流程目的地的自訂屬性。

ADO NET 目的地
資料採礦模型定型目的地
DataReader 目的地
維度處理目的地
Excel 目的地
一般檔案目的地
OLE DB 目的地
資料分割處理目的地
原始檔案目的地
資料錄集目的地
SQL Server Compact Edition 目的地
SQL Server 目的地

如需有關大部分資料流程物件通用之屬性的詳細資訊，請參閱＜通用屬性＞。

您可以使用屬性運算式來設定目的地的某些屬性，如本主題所示。如需詳細資訊，請參閱＜可以使用運算式設定的資料流程屬性＞。

ADO NET 目的地

ADO.NET 目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述 ADO.NET 目的地的自訂屬性。所有屬性都是可讀寫的。雖然您無法在 [ADO NET 目的地編輯器] 中使用這些屬性，但是可以使用 [進階編輯器] 來設定這些屬性。

屬性	資料類型	描述
BatchSize	整數	傳送給伺服器之批次內的資料列數。值為 0 表示批次大小與內部緩衝區大小相符。這個屬性的預設值為 0。
CommandTimeOut	整數	逾時之前 SQL 命令可以執行的秒數上限。值為 0 表示無限的時間。這個屬性的預設值為 0。
TableOrViewName	字串	目的地資料表或檢視表的名稱。
UseBulkInsertWhenAvailable	布林值	指定是否要使用 System.Data.SqlClient..::..SqlBulkCopy 介面來改善大量插入作業效能的值。只有某些 ADO.NET 提供者支援這個介面。預設值是 True。

如需詳細資訊，請參閱＜ADO NET 目的地＞。

資料採礦模型定型目的地自訂屬性

資料採礦模型定型目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述資料採礦模型定型目的地的自訂屬性。所有屬性都是可讀寫的。

屬性	資料類型	描述
ASConnectionId	字串	連接管理員的唯一識別碼。
ASConnectionString	字串	Analysis Services 執行個體或 Analysis Services 專案的連接字串。
ObjectRef	字串	可識別轉換所使用之資料採礦結構的 XML 標記。

資料採礦模型定型目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜資料採礦模型培訓目的地＞。

DataReader 目的地自訂屬性

DataReader 目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述 DataReader 目的地的自訂屬性。除了 DataReader 以外的所有屬性都是可讀寫的。

屬性名稱	資料類型	描述
DataReader	字串	DataReader 目的地的類別名稱。
FailOnTimeout	布林值	指出發生 ReadTimeout 時是否會失敗。此屬性的預設值為 False。
ReadTimeout	整數	發生逾時之前的毫秒數。此屬性的預設值為 30000 (30 秒)。

DataReader 目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜DataReader 目的地＞。

維度處理目的地自訂屬性

維度處理目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述維度處理目的地的自訂屬性。所有屬性都是可讀寫的。

屬性	資料類型	描述
ASConnectionString	字串	Analysis Services 執行個體或 Analysis Services 專案的連接字串。
KeyDuplicate	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理重複索引鍵錯誤的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 IgnoreError (0)。
KeyErrorAction	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理索引鍵錯誤的值。可能的值為 ConvertToUnknown (0) 和 DiscardRecord (1)。此屬性的預設值為 ConvertToUnknown (0)。
KeyErrorLimit	整數	當 UseDefaultConfiguration 為 False 時，就是啟用的索引鍵錯誤上限。
KeyErrorLimitAction	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出到達 KeyErrorLimit 時要採取之動作的值。可能的值為 StopLogging (1) 和 StopProcessing (0)。此屬性的預設值為 StopProcessing (0)。
KeyErrorLogFile	字串	當 UseDefaultConfiguration 為 False 時，就是錯誤記錄檔的路徑和檔案名稱。
KeyNotFound	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理遺漏索引鍵錯誤的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 IgnoreError (0)。
NullKeyConvertedToUnknown	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理轉換成未知值之 Null 索引鍵的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 IgnoreError (0)。
NullKeyNotAllowed	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理不允許之 Null 的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 IgnoreError (0)。
ProcessType	整數 (列舉)	轉換所使用的維度處理類型。值為 ProcessAdd (1) (累加)、ProcessFull (0) 和 ProcessUpdate (2)。
UseDefaultConfiguration	布林值	一個值，指定轉換是否要使用預設錯誤組態。如果此屬性為 False，轉換就會包含有關錯誤處理的資訊。

維度處理目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜維度處理目的地＞。

Excel 目的地自訂屬性

Excel 目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述 Excel 目的地的自訂屬性。所有屬性都是可讀寫的。

屬性名稱	資料類型	描述
AccessMode	整數 (列舉)	指定目的地如何存取其目的地資料庫的值。此屬性可以有下列其中一個值： OpenRowset (0) - 您要提供資料表或檢視表的名稱。 OpenRowset from Variable (1) - 您要提供包含資料表或檢視表名稱之變數的名稱。 OpenRowset Using Fastload (3) - 您要提供資料表或檢視表的名稱。 OpenRowset Using Fastload from Variable (4) - 您要提供包含資料表或檢視表名稱之變數的名稱。 SQL Command (2) - 您要提供 SQL 陳述式。
CommandTimeout	整數	逾時之前可以執行 SQL 命令的秒數上限。值為 0 表示無限的時間。這個屬性的預設值為 0。附註雖然您無法在 [Excel 目的地編輯器] 中使用這個屬性，但是可以使用 [進階編輯器] 來設定這個屬性。
FastLoadKeepIdentity	布林值	一個值，指定載入資料時是否要複製識別值。只有在您使用其中一個快速載入選項時，才能使用這個屬性。此屬性的預設值為 False。
FastLoadKeepNulls	布林值	一個值，指定載入資料時是否要複製 Null 值。這個屬性只能搭配其中一個快速載入選項使用。此屬性的預設值為 False。
FastLoadMaxInsertCommitSize	整數	一個值，指定快速載入作業期間，Excel 目的地嘗試認可的批次大小。預設值 0 表示處理所有資料列之後的單一認可作業。
FastLoadOptions	字串	快速載入選項的集合。快速載入選項包括資料表的鎖定和條件約束的檢查。您可以指定其中一個選項、兩個選項或不指定任何選項。附註雖然您無法在 [Excel 目的地編輯器] 中使用這個屬性的某些選項，但是可以使用 [進階編輯器] 來設定這些選項。
OpenRowset	字串	當 AccessMode 為 [OpenRowset] 時，就是 Excel 目的地所存取之資料表或檢視表的名稱。
OpenRowsetVariable	字串	當 AccessMode 為 [從變數 OpenRowset] 時，就是包含 Excel 目的地所存取之資料表或檢視表名稱的變數名稱。
SqlCommand	字串	當 AccessMode 為 [SQL 命令] 時，就是 Excel 目的地用來指定資料之目的地資料行的 Transact-SQL 陳述式。

Excel 目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜Excel 目的地＞。

一般檔案目的地自訂屬性

一般檔案目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述一般檔案目的地的自訂屬性。所有屬性都是可讀寫的。

屬性名稱	資料類型	描述
Header	字串	寫入任何資料之前插入檔案中的文字區塊。此屬性的值可以使用屬性運算式指定。
Overwrite	布林值	一個值，指定要覆寫或附加至具有相同名稱的現有目的地檔案。此屬性的預設值為 True。

Header

字串

寫入任何資料之前插入檔案中的文字區塊。

此屬性的值可以使用屬性運算式指定。

Overwrite

布林值

一個值，指定要覆寫或附加至具有相同名稱的現有目的地檔案。此屬性的預設值為 True。

一般檔案目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜一般檔案目的地＞。

OLE DB 目的地自訂屬性

OLE DB 目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述 OLE DB 目的地的自訂屬性。所有屬性都是可讀寫的。

[!附註]

此處所列的 FastLoad 選項 (FastLoadKeepIdentity、FastLoadKeepNulls 和 FastLoadOptions) 會對應至 Microsoft OLE DB Provider for SQL Server (SQLOLEDB) 所實作之 IRowsetFastLoad 介面所公開的類似名稱屬性。如需詳細資訊，請在 MSDN Library 中搜尋 IRowsetFastLoad。

屬性名稱	資料類型	描述
AccessMode	整數 (列舉)	指定目的地如何存取其目的地資料庫的值。此屬性可以有下列其中一個值： OpenRowset (0) - 您要提供資料表或檢視表的名稱。 OpenRowset from Variable (1) - 您要提供包含資料表或檢視表名稱之變數的名稱。 OpenRowset Using Fastload (3) - 您要提供資料表或檢視表的名稱。 OpenRowset Using Fastload from Variable (4) - 您要提供包含資料表或檢視表名稱之變數的名稱。 SQL Command (2) - 您要提供 SQL 陳述式。
AlwaysUseDefaultCodePage	布林值	指出要針對每個資料行使用 DefaultCodePage 屬性的值，或要嘗試從每個資料行之地區設定中衍生字碼頁的值。此屬性的預設值為 False。
CommandTimeout	整數	逾時之前 SQL 命令可以執行的秒數上限。值為 0 表示無限的時間。這個屬性的預設值為 0。附註雖然您無法在 [OLE DB 目的地編輯器] 中使用這個屬性，但是可以使用 [進階編輯器] 來設定這個屬性。
DefaultCodePage	整數	與 OLE DB 目的地相關聯的預設字碼頁。
FastLoadKeepIdentity	布林值	一個值，指定載入資料時是否要複製識別值。這個屬性只能搭配其中一個快速載入選項使用。此屬性的預設值為 False。這個屬性會對應至 OLE DB IRowsetFastLoad (OLE DB) 屬性 SSPROP_FASTLOADKEEPIDENTITY。
FastLoadKeepNulls	布林值	一個值，指定載入資料時是否要複製 Null 值。這個屬性只能搭配其中一個快速載入選項使用。此屬性的預設值為 False。這個屬性會對應至 OLE DB IRowsetFastLoad (OLE DB) 屬性 SSPROP_FASTLOADKEEPNULLS。
FastLoadMaxInsertCommitSize	整數	指定快速載入作業期間，OLE DB 目的地嘗試認可之批次大小的值。預設值 2147483647 表示處理所有資料列之後的單一認可作業。
FastLoadOptions	字串	快速載入選項的集合。快速載入選項包括資料表的鎖定和條件約束的檢查。您可以指定其中一個選項、兩個選項或不指定任何選項。這個屬性會對應至 OLE DB IRowsetFastLoad 屬性 SSPROP_FASTLOADOPTIONS 並接受字串選項，例如 CHECK_CONSTRAINTS 和 TABLOCK。附註雖然您無法在 [Excel 目的地編輯器] 中使用這個屬性的某些選項，但是可以使用 [進階編輯器] 來設定這些選項。
OpenRowset	字串	當 AccessMode 為 [OpenRowset] 時，就是 OLE DB 目的地所存取之資料表或檢視表的名稱。
OpenRowsetVariable	字串	當 AccessMode 為 [從變數 OpenRowset] 時，就是包含 OLE DB 目的地所存取之資料表或檢視表名稱的變數名稱。
SqlCommand	字串	當 AccessMode 為 [SQL 命令] 時，就是 OLE DB 目的地用來指定資料之目的地資料行的 Transact-SQL 陳述式。

OLE DB 目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜OLE DB 目的地＞。

資料分割處理目的地自訂屬性

資料分割處理目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述資料分割處理目的地的自訂屬性。所有屬性都是可讀寫的。

屬性	資料類型	描述
ASConnectionString	字串	Analysis Services 專案或 Analysis Services 執行個體的連接字串。
KeyDuplicate	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理重複索引鍵錯誤的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 IgnoreError (0)。
KeyErrorAction	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理索引鍵錯誤的值。可能的值為 ConvertToUnknown (0) 和 DiscardRecord (1)。此屬性的預設值為 ConvertToUnknown (0)。
KeyErrorLimit	整數	當 UseDefaultConfiguration 為 False 時，就是允許的索引鍵錯誤上限。
KeyErrorLimitAction	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出到達 KeyErrorLimit 時要採取之動作的值。可能的值為 StopLogging (1) 和 StopProcessing (0)。此屬性的預設值為 StopProcessing (0)。
KeyErrorLogFile	字串	當 UseDefaultConfiguration 為 False 時，就是錯誤記錄檔的路徑和檔案名稱。
KeyNotFound	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理遺漏索引鍵錯誤的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 ReportAndContinue (1)。
NullKeyConvertedToUnknown	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理轉換成未知值之 Null 索引鍵的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 IgnoreError (0)。
NullKeyNotAllowed	整數 (列舉)	當 UseDefaultConfiguration 為 False 時，就是指出如何處理不允許之 Null 的值。可能的值為 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此屬性的預設值為 ReportAndContinue (1)。
ProcessType	整數 (列舉)	轉換所使用的資料分割處理類型。可能的值為 ProcessAdd (1) (累加)、ProcessFull (0) 和 ProcessUpdate (2)。
UseDefaultConfiguration	布林值	一個值，指定轉換是否要使用預設錯誤組態。如果這個屬性為 False，轉換就會使用此資料表中所列的錯誤處理自訂屬性值，包括 KeyDuplicate、KeyErrorAction 等屬性。

資料分割處理目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜資料分割處理目的地＞。

原始檔案目的地自訂屬性

原始檔案目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述原始檔案目的地的自訂屬性。所有屬性都是可讀寫的。

屬性名稱	資料類型	描述
AccessMode	整數 (列舉)	一個值，指定 FileName 屬性包含檔案名稱，或包含檔案名稱之變數的名稱。這些選項包括 File name (0) 和 File name from variable (1)。
FileName	字串	原始檔案目的地寫入的檔案名稱。
WriteOption	整數 (列舉)	一個值，指定原始檔案目的地是否會刪除具有相同名稱的現有檔案。這些選項包括 Create Always (0)、Create Once (1)、Truncate and Append (3) 和 Append (2)。此屬性的預設值為 Create Always (0)。

[!附註]

附加作業要求已附加資料的中繼資料與檔案中已有資料的中繼資料相符。

原始檔案目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜原始檔案目的地＞。

資料錄集目的地自訂屬性

資料錄集目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述資料錄集目的地的自訂屬性。所有屬性都是可讀寫的。

屬性名稱	資料類型	描述
VariableName	字串	保存 ADO 資料錄集之變數的名稱。

資料錄集目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜資料錄集目的地＞。

SQL Server Compact Edition 目的地自訂屬性

SQL Server Compact 目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述 SQL Server Compact 目的地的自訂屬性。所有屬性都是可讀寫的。

屬性名稱	資料類型	描述
TableName	字串	SQL Server Compact 資料庫中目的地資料表的名稱。此屬性的值可以使用屬性運算式指定。

TableName

字串

SQL Server Compact 資料庫中目的地資料表的名稱。

此屬性的值可以使用屬性運算式指定。

SQL Server Compact 目的地的輸入和輸入資料行沒有任何自訂屬性。

如需詳細資訊，請參閱＜SQL Server Compact Edition 目的地＞。

SQL Server 目的地自訂屬性

SQL Server 目的地同時具有自訂屬性以及所有資料流程元件通用的屬性。

下表將描述 SQL Server 目的地的自訂屬性。所有屬性都是可讀寫的。

屬性名稱	資料類型	描述
AlwaysUseDefaultCodePage	布林值	強制使用 DefaultCodePage 屬性值。此屬性的預設值為 False。
BulkInsertCheckConstraints	布林值	一個值，指定大量插入是否會檢查條件約束。此屬性的預設值為 True。
BulkInsertFireTriggers	布林值	一個值，指定大量插入是否會引發資料表上的觸發程序。此屬性的預設值為 False。
BulkInsertFirstRow	整數	一個值，指定要插入的第一個資料列。此屬性的預設值是 -1，表示未指派任何值。
BulkInsertKeepIdentity	布林值	一個值，指定值是否可插入識別欄位中。此屬性的預設值為 False。
BulkInsertKeepNulls	布林值	一個值，指定大量插入是否會保留 Null 值。此屬性的預設值為 False。
BulkInsertLastRow	整數	一個值，指定要插入的最後一個資料列。此屬性的預設值是 -1，表示未指派任何值。
BulkInsertMaxErrors	整數	指定停止大量插入之前所能發生之錯誤數目的值。此屬性的預設值是 -1，表示未指派任何值。
BulkInsertOrder	字串	排序資料行的名稱。每個資料行都可依遞增或遞減順序來排序。如果使用了多個排序資料行，這些資料行名稱會以逗號隔開。
BulkInsertTableName	字串	要將資料複製到其中的 SQL Server 資料庫資料表或檢視表。
BulkInsertTablock	布林值	一個值，指定在進行大量插入期間是否會鎖定資料表。此屬性的預設值為 True。
DefaultCodePage	整數	無法從資料來源中取得字碼頁資訊時要使用的字碼頁。
MaxInsertCommitSize	整數	一個值，指定要在批次中插入的資料列數目上限。當此值為零時，就會在單一批次中插入所有資料列。
Timeout	整數	一個值，指定如果沒有資料可供插入，SQL Server 目的地在終止之前等候的秒數。值為 0 表示 SQL Server 目的地將不會逾時。這個屬性的預設值為 30。