適用於:SQL Server
Azure Data Factory 中的 SSIS Integration Runtime
「多個一般檔案」連接管理員可讓封裝存取多個一般檔案中的資料。 例如,當資料流程工作位於迴圈容器 (如 For 迴圈容器) 內時,「一般檔案」來源可以使用「多個一般檔案」連接管理員。 在此容器的每一個迴圈上,「一般檔案」來源會從「多個一般檔案」連接管理員提供的下一個檔案名稱中載入資料。
當您將「多個一般檔案」連線管理員新增至套件時,SQL Server Integration Services 會建立一個連線管理員 (在執行階段會解析為「多個一般檔案」連線)、設定「多個一般檔案」連線管理員的屬性,並將「多個一般檔案」連線管理員新增至套件的 Connections 集合。
連接管理員的 ConnectionManagerType 屬性會設為 MULTIFLATFILE。
您可以以下列方式設定「多重平面檔案」連線管理員:
指定要使用的檔案、地區設定和字碼頁。 地區設定用於解譯區分地區設定的資料 (如日期),字碼頁用於將字串資料轉換為 Unicode。
指定檔案格式。 您可以使用分隔格式、固定寬度格式或右側不齊格式。
指定標頭列、資料列及資料行分隔符號。 資料行分隔符號可以在檔案層級設定,並在資料行層級覆寫。
指示檔案中的第一列是否包含欄名。
指定文字限定詞字元。 每個資料行都可以設定為可辨識文字限定符號。
在個別的資料行上設定屬性,例如名稱、資料類型和最大寬度。
當「多個一般檔案」連線管理員參照多個檔案時,各檔案的路徑會以豎線 (|) 字元分隔。 連接管理員的 ConnectionString 屬性具有下列格式:
< path>|<路徑>
您也可以使用萬用字元來指定多個檔案。 例如,若要參考 C 磁碟機上的所有文字檔,ConnectionString 屬性的值可以設定為 C:\*.txt。
如果「多個一般檔案」連接管理員參考多個檔案,則所有檔案必須具有相同的格式。
依預設,「多個一般檔案」連接管理員會將字串資料行的長度設定成 50 個字元。 在 [多個平面檔案連接管理員編輯器] 對話方塊中,您可以評估範例資料,並自動調整這些資料行的長度,以避免資料遭到截斷或資料行寬度過大。 除非在一般檔案來源或轉換中調整資料行長度,否則在整個資料流程中,資料行長度將維持不變。 如果這些資料行對應至較窄的目標資料行,使用者介面中會顯示警告,而且在執行階段可能會因資料截斷而發生錯誤。 您可以調整資料行的大小,使其與一般檔案連接管理員、一般檔案來源或轉換中的目的地資料行相容。 若要修改輸出資料行的長度,您可以在 [進階編輯器] 對話方塊的 [輸入與輸出屬性] 索引標籤中設定輸出資料行的 Length 屬性。
如果在加入及設定使用「多個一般檔案」連接管理員的一般檔案來源之後,在該連接管理員中更新資料行長度,您就不需要手動調整一般檔案來源中輸出資料行的大小。 在您開啟 [一般檔案來源] 對話方塊時,一般檔案來源會提供一個用來同步化資料行中繼資料的選項。
多個平面檔案連線管理員的設定
您可以透過 SSIS 設計師或以程式設計方式設定屬性。
如需以程式設計方式設定連線管理員的資訊,請參閱 ConnectionManager 和 以程式設計方式加入連接。
多個平面檔案連線管理員編輯器 (一般頁面)
使用 [多個一般檔案連線管理員編輯器] 對話方塊的 [一般] 頁面,即可選取一組具有相同資料格式的檔案,並指定其資料格式。 多個平面檔案連線可讓套件連線到一組格式相同的文字檔。
若要深入了解多個一般檔案連接管理員,請參閱< Multiple Flat Files 連線管理員>。
選項
連線管理員名稱
為工作流程中的多個平面檔案連線提供唯一名稱。 提供的名稱將顯示在 SSIS 設計師內。
說明
描述連接。 最佳作法是以其用途描述連接,使封裝可以自我記錄並易於維護。
檔案名稱
輸入要在多重平面檔案連線中使用的路徑和檔案名稱。 您可以使用萬用字元來指定多個檔案,例如「C:\*.txt」,或者使用分隔號 (|) 來分隔多個檔案名稱。 所有檔案必須有相同的資料格式。
瀏覽
瀏覽要在「多重平面檔案」連線中使用的檔案名稱。 您可以選取多個檔案。 所有檔案必須有相同的資料格式。
地區設定
指定位置,以提供訂購資訊以及日期和時間轉換資訊。
Unicode
指出是否使用 Unicode。 使用 Unicode 即無需指定字碼頁。
字碼頁
指定非 Unicode 文字的字碼頁。
格式
指出是要使用分隔符號、固定寬度或不齊右的格式。 所有檔案必須有相同的資料格式。
| 值 | 描述 |
|---|---|
| Delimited (分隔檔) | 資料行是以分隔符號隔開,分隔符號是在 [資料行] 頁面上指定的。 |
| 固定寬度 | 資料行具有固定寬度,由 [資料行] 頁面上的拖曳標記線所指定。 |
| 右側不齊 | 不齊右檔案是指每個資料行都具有固定寬度,但最後一個資料行除外;最後一個資料行是以在 資料行 頁面上指定的資料列分隔符號界定的檔案。 |
文字限定詞
指定要使用的文字限定詞。 例如,您可以指定文字必須加上引號。
標頭資料列分隔符號
從標頭資料列的分隔符號清單中選取,或輸入分隔符號文字。
| 值 | 描述 |
|---|---|
| {CR}{LF} | 標頭列以回車與換行的組合作為分隔符號。 |
| {CR} | 標頭資料列是以回車字元分隔。 |
| {LF} | 標頭列是以換行字元作為分隔符號。 |
| 分號 {;} | 標頭資料列是以分號分隔。 |
| 冒號 {:} | 標頭資料列以冒號分隔。 |
| 逗號 {,} | 標頭列以逗號分隔。 |
| Tab 鍵 {t} | 標頭資料列以 Tab 字元分隔。 |
| 垂直線 {|} | 標頭列是以垂直線(|)分隔。 |
要略過的標頭列
指定要略過的標頭列數 (如果有的話)。
第一個資料列的資料行名稱
指定第一個資料列是否應包含欄名。
多重平面檔案連線管理員編輯器 (資料行頁面)
使用 [多個平面檔案連接管理員編輯器] 對話方塊的 [資料行] 節點,指定資料列和資料行資訊,並預覽第一個選取的檔案。
若要深入了解多個一般檔案連接管理員,請參閱< Multiple Flat Files 連線管理員>。
靜態選項
連線管理員名稱
為工作流程中的多個平面檔案連線提供唯一名稱。 提供的名稱將顯示在 SSIS 設計師內。
說明
描述連接。 最佳作法是以其用途描述連接,使封裝可以自我記錄並易於維護。
平面檔案格式動態選項
格式 = 使用分隔符號
列分隔符號
從可用的資料列分隔符號清單中選取,或輸入分隔符號文字。
| 值 | 描述 |
|---|---|
| {CR}{LF} | 資料列以回車與換行字元的組合作為分隔符號。 |
| {CR} | 資料列是以回車字元分隔。 |
| {LF} | 資料列之間以換行符號分隔。 |
| 分號 {;} | 資料列是以分號分隔。 |
| 冒號 {:} | 各列以冒號分隔。 |
| 逗號 {,} | 資料列是以逗號分隔。 |
| Tab 鍵 {t} | 資料列以定位點分隔。 |
| 垂直線 {|} | 資料列以豎線字元(|)分隔。 |
資料行分隔符號
從可用的資料行分隔符號清單中選取,或輸入分隔符號文字。
| 值 | 描述 |
|---|---|
| {CR}{LF} | 欄位是以回車與換行的組合分隔。 |
| {CR} | 各欄位以回車字元分隔。 |
| {LF} | 欄位之間以換行字元分隔。 |
| 分號 {;} | 各欄位之間以分號分隔。 |
| 冒號 {:} | 欄位以冒號分隔。 |
| 逗號 {,} | 資料行是以逗號分隔。 |
| Tab 鍵 {t} | 各欄位之間以 Tab 字元分隔。 |
| 垂直線 {|} | 欄位之間以豎線(|)分隔。 |
重設資料行
按一下 [重設資料行],即可將原始資料行以外的資料行全部移除。
格式 = 固定寬度
字型
選取要顯示預覽資料的字型。
來源資料行
滑動垂直資料列標記,即可調整資料列的寬度,而按一下預覽視窗上方的尺規,即可調整資料行的寬度
列寬
為個別資料行加入分隔符號之前,請先指定資料列的長度。 或者,在預覽視窗中拖曳垂直線來標示資料列結尾。 資料列寬度值會自動更新。
重設資料行
按一下 重設資料行,即可移除原始資料行以外的所有資料行。
格式 = 右側不齊
注意
右側不齊檔案是指除最後一個資料行外,每個資料行的寬度都是固定的檔案。 其分隔方式是使用資料列分隔符號。
字型
選取要顯示預覽資料的字型。
來源資料行
滑動垂直資料列標記,即可調整資料列的寬度,而按一下預覽視窗上方的尺規,即可調整資料行的寬度
列分隔符號
從可用的資料列分隔符號清單中選取,或輸入分隔符號文字。
| 值 | 描述 |
|---|---|
| {CR}{LF} | 資料列以回車與換行字元的組合作為分隔符號。 |
| {CR} | 資料列是以回車字元分隔。 |
| {LF} | 資料列之間以換行符號分隔。 |
| 分號 {;} | 資料列是以分號分隔。 |
| 冒號 {:} | 各列以冒號分隔。 |
| 逗號 {,} | 資料列是以逗號分隔。 |
| Tab 鍵 {t} | 資料列以定位點分隔。 |
| 垂直線 {|} | 資料列以豎線字元(|)分隔。 |
重設資料行
按一下 [重設資料行],即可將原始資料行以外的資料行全部移除。
多個平面檔案連線管理員編輯器 (進階頁面)
使用 進階 頁面(位於 多個一般檔案連線管理員編輯器 對話方塊中),可設定一般檔案連線管理員所連接之文字檔中每個資料行的資料類型、分隔符號等屬性。
字串資料行的長度預設為 50 個字元。 您可以評估範例資料,並自動重新調整這些資料行的長度,以避免截斷資料或資料行寬度過大。 您也可更新其他中繼資料,以啟用與目的地資料行的相容性。 例如,您可能會將只包含整數資料之資料行的資料類型變更成數值資料類型 (例如 DT_I2)。
若要深入了解多個一般檔案連接管理員,請參閱< Multiple Flat Files 連線管理員>。
選項
連線管理員名稱
為工作流程中的多重平面檔案連線管理員指定唯一名稱。 提供的名稱將顯示在 SSIS 設計師的 [連線管理員] 區域內。
說明
描述連接管理員。 最佳做法是依其用途來描述連線管理員,讓封裝具自我說明性且更易於維護。
設定每一個資料行的屬性
請在左窗格中選取一個資料行以便在右窗格中檢視它的屬性。 請參閱下表以了解資料類型屬性的描述。 列出的部分屬性僅適用於某些平面檔案格式。
| 屬性 | 描述 |
|---|---|
| ColumnType | 表示資料行是否為以分隔符號分隔、固定寬度或右側參差不齊的格式。 這個屬性是唯讀的。 右側不齊檔案是指除了最後一個資料行以資料列分隔符號作為結束之外,每個資料行都具有固定寬度的檔案。 |
| OutputColumnWidth | 指定將儲存為位元組計數的值;針對 Unicode 檔案,這將會顯示為字元計數。 在資料流程工作中,這個值會用於設定平面檔案來源的輸出資料行寬度。 注意:在物件模型中,這個屬性的名稱為 MaximumWidth。 |
| DataType | 從可用的資料類型清單中選取。 如需詳細資訊,請參閱 Integration Services 資料類型。 |
| TextQualified | 指示文字資料是否使用文字限定字元加以限定: True:平面檔案中的文字資料已加上限定符。 False:一般檔案中文字資料是非限定的。 |
| 名稱 | 請輸入資料行名稱。 預設值為編號的資料行清單;但您可以選擇任何唯一且具描述性的名稱。 |
| DataScale | 指定數值資料的刻度。 Scale 是指小數點後的位數。 如需詳細資訊,請參閱 Integration Services 資料類型。 |
| ColumnDelimiter | 從可用的資料行分隔符號清單中選取。 請選擇不太可能會在文字中出現的分隔符號。 這個值在固定寬度資料行中會被忽略。 {CR}{LF} - 欄位是以回車字元與換行字元的組合作為分隔符號 {CR} - 欄位以回車字元分隔 {LF} - 欄位以換行字元分隔 分號 {;} :資料行是以分號分隔 冒號 {:} - 資料行以冒號分隔 逗號{,} :資料行是以逗號分隔 Tab {t} - 資料行以 Tab 分隔 垂直線 {|} - 資料行以垂直線分隔 |
| DataPrecision | 指定數值資料的精確度。 精度是指位數的多少。 如需詳細資訊,請參閱 Integration Services 資料類型。 |
| 輸入欄寬 | 指定將儲存為位元組計數的值;針對 Unicode 檔案,這將會顯示為字元計數。 對於分隔欄,此值會被忽略。 注意 ︰在物件模型中,這個屬性的名稱為 ColumnWidth。 |
新增
按一下 New 以新增資料行。 [新增] 按鈕預設會在清單結尾加入新資料行。 此按鈕還有下列選項,可以在下拉式清單中使用。
| 值 | 描述 |
|---|---|
| 新增資料行 | 在清單結尾加入新資料行。 |
| 向前插入 | 在選取的資料行之前插入新資料行。 |
| 插入於後方 | 在選取的資料行之後插入新資料行。 |
刪除
選取資料行,然後按一下 [刪除] 將其移除。
建議類型
使用 [建議資料行類型] 對話方塊,可評估第一個選定檔案中的範例資料,並取得對每個資料行之資料類型和長度的建議。 如需詳細資訊,請參閱 建議資料行類型對話方塊 UI 參考。
多個平面檔案連線管理員編輯器 (預覽頁面)
使用 多重一般檔案連接管理員編輯器 對話方塊的 預覽 頁面,即可檢視第一個選取的來源檔案內容,並依照您定義的方式將其分成資料行。
若要深入了解多個一般檔案連接管理員,請參閱< Multiple Flat Files 連線管理員>。
選項
連線管理員名稱
為工作流程中的「多個平面檔案」連線提供唯一名稱。 提供的名稱將顯示在 SSIS 設計師的 [連線管理員] 區域內。
說明
描述連接。 最佳作法是以其用途描述連接,使封裝可以自我記錄並易於維護。
要略過的資料列
指定平面檔案開頭要跳過的資料列數。
資料列預覽
檢視第一個選取的一般檔案中的範例資料,使用選取的選項將資料分為資料行和資料列。