ODBC 目的地

適用於:SQL Server Azure Data Factory 的 SSIS Integration Runtime

ODBC 目的地會將資料大量載入到 ODBC 支援的資料庫資料表。 ODBC 目的地使用 ODBC 連接管理員來連接到資料來源。

ODBC 目的地包含輸入資料行與目的地資料來源中的資料行之間的對應。 您不一定要將輸入資料行對應到所有目的地資料行,但因目的地資料行屬性的不同,如果輸入資料行未對應到目的地資料行,則可能發生錯誤。 例如,如果目的地資料行不允許 Null 值,則輸入資料行必須對應到該資料行。 此外,雖然可對應不同類型的資料行,但是如果輸入資料與目的地資料行類型不相容,在執行階段會發生錯誤。 根據錯誤行為設定,錯誤會遭到忽略、造成失敗,或將該資料列傳送至錯誤輸出。

ODBC 目的地具有一個一般輸出和一個錯誤輸出。

載入選項

ODBC 目的地可以使用兩種存取載入模組其中之一。 您會在 ODBC 來源編輯器 (連線管理員頁面) 設定模式。 兩種模式為:

  • 批次:在此模式中,ODBC 目的地會根據其判斷的 ODBC 提供者能力,嘗試使用效率最高的插入方法。 對大多數現代 ODBC 提供者來說,這意味著先準備 INSERT 一個帶有參數的陳述,然後使用逐列陣列的參數綁定(陣列大小由 BatchSize 屬性控制)。 如果您選取 [批次] ,而提供者不支援此方法,ODBC 目的地會自動切換為逐列模式。

  • 逐列:在此模式下,ODBC 目的地會準備一個含參數的 INSERT 陳述式,並使用 SQL Execute 一次插入一列資料。

錯誤處理

ODBC 目的地有錯誤輸出。 此元件的錯誤輸出包含下列輸出資料行:

  • 錯誤碼:對應至目前錯誤的編號。 如需錯誤清單,請參閱來源資料庫的文件集。 如需 SSIS 錯誤碼清單,請參閱<SSIS 錯誤碼和訊息參考>。

  • 錯誤資料行:就轉換錯誤而言,造成錯誤的來源資料行。

  • 標準輸出資料欄。

根據錯誤行為設定,ODBC 目的地支援將擷取過程中發生的錯誤(資料轉換、截斷)傳回至錯誤輸出。 如需詳細資訊,請參閱 ODBC 來源編輯器 (錯誤輸出頁面)。

平行處理

可平行執行且針對相同或不同資料表的 ODBC 目的地元件數量沒有限制;無論是在同一部電腦或不同電腦上皆然(正常的全域工作階段限制除外)。

然而,所使用的 ODBC 提供者的限制可能會限制透過提供者的並行連接數目。 這些限制會限制 ODBC 目的地支援的平行執行個體數目。 SSIS 開發人員必須知道所使用的任何 ODBC 提供者的限制,並在建立 SSIS 封裝時將這些限制納入考量。

您還必須知道同時載入到相同資料表可能會因為標準記錄鎖定而降低效能。 這取決於正在載入的資料和資料表組織。

ODBC 目的地疑難排解

您可以記錄 ODBC 來源對外部資料提供者所執行的呼叫。 您可以使用這項記錄功能,針對 ODBC 目的地所執行之將資料儲存至外部資料來源的作業進行疑難排解。 若要記錄 ODBC 目的地對外部資料提供者執行的呼叫,請啟用 ODBC 驅動程式管理員追蹤。 如需詳細資訊,請參閱 Microsoft 文件集<如何使用 ODBC 資料來源管理員產生 ODBC 追蹤>。

設定 ODBC 目的地

您可以透過程式設計方式或透過 SSIS 設計工具設定 ODBC 目的地

如需詳細資訊,請參閱下列其中一個主題:

[進階編輯器] 對話方塊包含可以程式設計方式設定的屬性。

若要開啟 [進階編輯器] 對話方塊:

  • 在 SQL Server 2019 Integration Services (SSIS) 專案的資料流程畫面中,以滑鼠右鍵按一下 CDBC 目的地,然後選取 [顯示進階編輯器]。

如需有關可在 [進階編輯器] 對話方塊中設定之屬性的詳細資訊,請參閱< ODBC Destination Custom Properties>。

本節內容

ODBC 目的地編輯器 (連接管理員頁面)

使用 [ODBC 目的地編輯器] 對話方塊的 [連接管理員] 頁面,即可選取目的地的 ODBC 連接管理員。 這個頁面也可以讓您從資料庫中選取資料表或檢視表。

開啟 ODBC 目的地編輯器的連線管理員頁面

工作清單

  • 在 SQL Server Data Tools 中,開啟具有 ODBC 目的地的 SQL Server 2019 Integration Services (SSIS) 套件。

  • 在 [資料流程] 索引標籤上,按兩下 ODBC 目的地。

  • 在 [ODBC 目的地編輯器] 中,按一下 [連接管理員] 。

選項

連線管理員

從清單中選取現有的 ODBC 連接管理員,或按一下 [新增] 建立新的連接。 此連接可以指向任何 ODBC 支援的資料庫。

新增

按一下 [新增] 。 [設定 ODBC 連接管理員編輯器] 對話方塊隨即開啟,讓您能夠建立新的連接管理員。

資料存取模式

選取將資料載入目的地的方法。 下表將顯示這些選項:

選項 描述
資料表名稱 - 批次 若要將 ODBC 目的地設定成以批次模式運作,請選取此選項。 當您選取此選項時,可以使用下列選項:
資料表或檢視的名稱:從清單中選取可用的資料表或檢視表。

此清單只包含前 1000 個資料表。 如果您的資料庫包含超過 1000 個資料表,您可以輸入資料表名稱的開頭或使用 (*) 萬用字元來輸入名稱的任何部分,以便顯示您想要使用的資料表。

批次大小:輸入大量載入的批次大小。 這是以批次方式載入的資料列數量。
資料表名稱 - 逐列 選取此選項可將 ODBC 目的地設定為每次將一個資料列插入目的地資料表。 當您選取此選項時,可以使用下列選項:
資料表或檢視的名稱:從清單的資料庫中選取可用的資料表或檢視表。

此清單只包含前 1000 個資料表。 如果您的資料庫包含超過 1000 個資料表,您可以輸入資料表名稱的開頭或使用 (*) 萬用字元來輸入名稱的任何部分,以便顯示您想要使用的資料表。

預覽

按一下 [預覽] ,最多可檢視您所選取之資料表的 200 個資料列。

ODBC 目的地編輯器 (對應頁面)

使用 [ODBC 目的地編輯器] 對話方塊的 [對應] 頁面,即可將輸入資料行對應至目的地資料行。

選項

可用的輸入資料行

可用輸入資料行的清單。 將輸入資料行拖放到可用的目標資料行,以對應各資料行。

可用的目的欄位

可用目標資料行清單。 將目標資料行拖放到可用的輸入資料行,以對應各資料行。

輸入資料行

檢視所選取的輸入資料行。 您可以選取 <ignore> 來移除對應,從輸出中排除資料行。

目的地資料行

檢視所有可用的目的地資料行,包括已對應和未對應的資料行。

ODBC 目的地編輯器 (錯誤輸出頁面)

使用 [ODBC 目的地編輯器] 對話方塊的 [錯誤輸出] 頁面,即可選取錯誤處理選項。

開啟 ODBC 目的地編輯器的錯誤輸出頁面

工作清單

  • 在 SQL Server Data Tools 中,開啟具有 ODBC 目的地的 SQL Server 2019 Integration Services (SSIS) 套件。

  • 在 [資料流程] 索引標籤上,按兩下 ODBC 目的地。

  • 在 [ODBC 目的地編輯器] 中,按一下 [錯誤輸出] 。

選項

輸入/輸出

檢視資料來源的名稱。

資料行

未使用。

錯誤

選取 ODBC 目的地應該如何處理流程中的錯誤:忽略失敗、重新導向資料列,或使元件失效。

截斷

選取 ODBC 目的地應該如何處理流程中的截斷:忽略失敗、重新導向資料列,或使元件失效。

描述

檢視錯誤的描述。

將這個值設定到選取的資料格

選取當發生錯誤或截斷時,ODBC 目的地如何處理所有選取的儲存格:忽略失敗、將資料列重新導向,或使元件失敗。

套用

將錯誤處理選項套用至選取的資料格。

錯誤處理選項

您可以使用下列選項來設定 ODBC 目的地處理錯誤和截斷的方式。

故障元件

當發生錯誤或截斷時,資料流程工作將失敗。 此為預設行為。

忽略失敗

錯誤或截斷會被忽略。

重新導向流程

導致錯誤或截斷的資料列會被導向至 ODBC 目的地的錯誤輸出。 如需詳細資訊,請參閱<ODBC 目的地>。