共用方式為


目的地自訂屬性

MicrosoftSQL ServerIntegration 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

字串

目的地資料表或檢視表的名稱。

如需詳細資訊,請參閱<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。

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

如需詳細資訊,請參閱<一般檔案目的地>。

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 目的地嘗試認可的批次大小。預設值 0 表示處理所有資料列之後的單一認可作業。

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,轉換就會使用此資料表中所列的錯誤處理自訂屬性值,包括 KeyDuplicateKeyErrorAction 等屬性。

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

如需詳細資訊,請參閱<資料分割處理目的地>。

原始檔案目的地自訂屬性

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

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

屬性名稱

資料類型

描述

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 資料庫中目的地資料表的名稱。

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

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。

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

如需詳細資訊,請參閱<SQL Server 目的地>。

變更記錄

更新的內容

  • 已針對下列屬性加入數值:

    • 維度處理目的地的 KeyDuplicateKeyErrorActionKeyErrorLimitActionKeyNotFoundNullKeyConvertedToUnknownNullKeyNotAllowedProcessType 屬性。

    • Excel 目的地的 AccessMode 屬性。

    • OLE DB 目的地的 AccessMode 屬性。

    • 資料分割處理目的地的 KeyDuplicateKeyErrorActionKeyErrorLimitActionKeyNotFoundNullKeyConvertedToUnknownNullKeyNotAllowedProcessType 屬性。

    • 原始檔案目的地的 AccessModeWriteOption 屬性。