平面檔案連線管理員

適用於：SQL ServerAzure Data Factory 中的 SSIS Integration Runtime

「一般檔案」連接管理員可讓封裝存取一般檔案中的資料。 例如，「一般檔案」來源與目的地可以使用「一般檔案」連接管理員來擷取並載入資料。

「一般檔案」連接管理員僅可存取一個檔案。 若要參考多個檔案，請使用「多個一般檔案」連接管理員，而非「一般檔案」連接管理員。 如需詳細資訊，請參閱 Multiple Flat Files 連線管理員。

欄長度

依預設，「一般檔案」連接管理員會將字串資料行的長度設定成 50 個字元。 在 [一般檔案連接管理員編輯器] 對話方塊中，您可以評估取樣資料，並自動調整這些資料行的長度，以避免資料遭截斷或超出資料行寬度。 此外，除非您後續在平面檔案來源或轉換中重新調整資料行長度，否則字串資料行的資料行長度在整個資料流程中都會維持不變。 如果這些字串資料行對應到較窄的目的地資料行，使用者介面中將會出現警告。 此外，執行階段中也可能發生因為資料截斷所產生的錯誤。 若要避免錯誤或資料截斷，您可以調整資料行的大小，使其與一般檔案連接管理員、一般檔案來源或轉換中的目的地資料行相容。 若要修改輸出資料行的長度，您可以在 [進階編輯器] 對話方塊的 [輸入與輸出屬性] 索引標籤中設定輸出資料行的 Length 屬性。

如果在加入及設定使用「一般檔案」連接管理員的一般檔案來源之後，在該連接管理員中更新資料行長度，您就不需要手動調整一般檔案來源中輸出資料行的大小。 在您開啟 [一般檔案來源] 對話方塊時，一般檔案來源會提供一個用來同步化資料行中繼資料的選項。

平面檔案連接管理員的設定

當您將「一般檔案」連線管理員新增至套件時，SQL Server Integration Services 會建立一個連線管理員 (在執行階段會解析為「一般檔案」連線)、設定「一般檔案」連線屬性，並將「一般檔案」連線管理員新增至套件的 Connections 集合。

連接管理員的 ConnectionManagerType 屬性會設為 [FLATFILE] 。

依預設，平面檔案連接管理員一律會檢查未加引號資料中的資料列分隔符號，並在找到資料列分隔符號時開始新的資料列。 這可使連線管理員正確解析含有缺少資料行欄位之資料列的檔案。

在某些情況下，停用此功能可能會提升封裝效能。 您可以將平面檔案連線管理員的屬性 AlwaysCheckForRowDelimiters 設為 False，以停用此功能。

您可以以下列方式設定「平面檔案」連線管理員：

• 指定要使用的檔案、地區設定及字碼頁。 地區設定用於解譯區分地區設定的資料 (如日期)，字碼頁用於將字串資料轉換為 Unicode。

• 指定檔案格式。 您可以使用分隔格式、固定寬度格式或右側不齊格式。

• 指定標頭列、資料列及資料行分隔符號。 資料行分隔符號可以在檔案層級設定，並在資料行層級覆寫。

• 指定檔案中的第一列是否包含欄名。

• 指定文字限定詞字元。 每個資料行都可以設定為可辨識文字限定符號。

  一般資料檔連線管理員支援使用限定字元將限定字元嵌入至限定字串中。 文字限定符號連續出現兩次時，會被解讀為該字串本身的一個字面值。 例如，文字限定詞如果是單引號，而輸入資料為 'abc'、'def'、'g'hi'，則輸出資料為 abc、def、g'hi。 不過，若在使用限定符的字串中內嵌了限定符，會導致平面檔案來源失敗，並顯示錯誤 DTS_E_PRIMEOUTPUTFAILED。

• 在個別的資料行上設定屬性，例如名稱、資料類型和最大寬度。

您可以在 SQL Server Data Tools (SSDT) 的 [屬性] 視窗中指定運算式，藉此設定平面檔案連線管理員的 ConnectionString 屬性。 為避免驗證錯誤，請執行下列操作。

• 當您使用運算式指定檔案時，請在 [一般檔案連接管理員編輯器] 的 [檔案名稱] 方塊中加入檔案路徑。

• 在「一般檔案」連接管理員上將 DelayValidation 屬性設定為 [True] 。

您可以搭配平面檔案目的地使用平面檔案連線管理員，並利用運算式在執行階段建立檔案名稱。

您可以透過 SSIS 設計師或以程式設計方式設定屬性。

如需以程式設計方式設定連線管理員的資訊，請參閱 ConnectionManager 和 以程式設計方式加入連接。

平面檔案連線管理員編輯器 (一般頁面)

使用 [一般檔案連接管理員編輯器] 對話方塊的 [一般] 頁面，來選取檔案和資料格式。 平面檔案連線可讓套件連線至文字檔。

若要深入了解一般檔案連接管理員，請參閱＜ Flat File 連線管理員＞。

選項

連線管理員名稱
為工作流程中的平面檔案連線提供唯一名稱。 提供的名稱將顯示在 SSIS 設計師內。

說明
描述連接。 最佳作法是以其用途描述連接，使封裝可以自我記錄並易於維護。

檔案名稱
輸入在一般檔案連接中要使用的路徑和檔案名稱。

瀏覽
找出要在平面檔案連線中使用的檔案名稱。

地區設定
指定地區設定，以提供排序及日期與時間格式的語言特定資訊。

Unicode
指出是否使用 Unicode。 如果使用 Unicode，您就無法指定字碼頁。

字碼頁
指定非 Unicode 文字的字碼頁。

格式
指明檔案採用分隔符號、固定寬度或右側不齊格式。

值	描述
Delimited (分隔檔)	資料行是以分隔符號隔開，分隔符號是在 [資料行] 頁面上指定的。
固定寬度	欄具有固定的寬度。
右側不齊	右側不整齊檔案是指除了最後一個資料行外，每個資料行都具有固定寬度的檔案。 其分隔方式是使用資料列分隔符號。

文字限定詞
指定要使用的文字限定詞。 例如，您可以指定文字欄位加上引號。

注意

選取文字限定詞之後，就無法重新選取 [無] 選項。 輸入 None 即可取消選取文字限定詞。

標頭資料列分隔符號
從標頭資料列的分隔符號清單中選取，或輸入分隔符號文字。

值	描述
{CR}{LF}	標頭列以回車與換行的組合作為分隔符號。
{CR}	標頭資料列是以回車字元分隔。
{LF}	標頭列是以換行字元作為分隔符號。
分號 {;}	標頭資料列是以分號分隔。
冒號 {:}	標頭資料列以冒號分隔。
逗號 {,}	標頭列以逗號分隔。
Tab 鍵 {t}	標頭資料列以 Tab 字元分隔。
垂直線 {|}	標頭列是以垂直線（|）分隔。

要略過的標頭列
指定要略過的標頭資料列數或初始資料列數 (如果有的話)。

第一個資料列的資料行名稱
指定第一個資料列是否應包含欄名。

平面檔案連線管理員編輯器 (資料行頁面)

使用 [資料行] 頁面（位於 [平面檔案連接管理員編輯器] 對話方塊中）以指定資料列和資料行資訊，並預覽檔案。

若要深入了解一般檔案連接管理員，請參閱＜ Flat File 連線管理員＞。

靜態選項

連線管理員名稱
為工作流程中的平面檔案連線輸入唯一名稱。 提供的名稱將顯示在 SSIS 設計師內。

說明
描述連接。 最佳作法是以其用途描述連接，使封裝可以自我記錄並易於維護。

平面檔案格式動態選項

格式 = 使用分隔符號

列分隔符號
從可用的資料列分隔符號清單中選取，或輸入分隔符號文字。

值	描述
{CR}{LF}	資料列以回車與換行字元的組合作為分隔符號。
{CR}	資料列是以回車字元分隔。
{LF}	資料列之間以換行符號分隔。
分號 {;}	資料列是以分號分隔。
冒號 {:}	各列以冒號分隔。
逗號 {,}	資料列是以逗號分隔。
Tab 鍵 {t}	資料列以定位點分隔。
垂直線 {|}	資料列以豎線字元（|）分隔。

資料行分隔符號
從可用的資料行分隔符號清單中選取，或輸入分隔符號文字。

值	描述
{CR}{LF}	欄位是以回車與換行的組合分隔。
{CR}	各欄位以回車字元分隔。
{LF}	欄位之間以換行字元分隔。
分號 {;}	各欄位之間以分號分隔。
冒號 {:}	欄位以冒號分隔。
逗號 {,}	資料行是以逗號分隔。
Tab 鍵 {t}	各欄位之間以 Tab 字元分隔。
垂直線 {|}	欄位之間以豎線（|）分隔。

[重新整理]
按一下重新整理，即可查看變更略過分隔符號後的效果。 僅在您已變更其他連接選項之後，才會看見此按鈕。

資料列預覽
檢視一般檔案中的範例資料，使用選取的選項將資料分為資料行和資料列。

重設資料行
按一下 [重設資料行]，即可將原始資料行以外的資料行全部移除。

格式 = 固定寬度

字型
選取要顯示預覽資料的字型。

來源資料行
滑動垂直紅色資料列標記，即可調整資料列的寬度；而按一下預覽視窗上方的尺規，即可調整資料行的寬度

列寬
為個別資料行加入分隔符號之前，請先指定資料列的長度。 或者，在預覽視窗中拖曳垂直紅線來標示資料列結尾。 資料列寬度值會自動更新。

重設資料行
按一下 [重設資料行]，即可將原始資料行以外的資料行全部移除。

格式 = 右側不齊

注意

右側不整齊檔案是指除了最後一個資料行外，每個資料行都具有固定寬度的檔案。 其分隔方式是使用資料列分隔符號。

字型
選取要顯示預覽資料的字型。

來源資料行
滑動垂直紅色資料列標記，即可調整資料列的寬度；而按一下預覽視窗上方的尺規，即可調整資料行的寬度

列分隔符號
從可用的資料列分隔符號清單中選取，或輸入分隔符號文字。

值	描述
{CR}{LF}	資料列以回車與換行字元的組合作為分隔符號。
{CR}	資料列是以回車字元分隔。
{LF}	資料列之間以換行符號分隔。
分號 {;}	資料列是以分號分隔。
冒號 {:}	各列以冒號分隔。
逗號 {,}	資料列是以逗號分隔。
Tab 鍵 {t}	資料列以定位點分隔。
垂直線 {|}	資料列以豎線字元（|）分隔。

重設資料行
按一下 [重設資料行]，即可將原始資料行以外的資料行全部移除。

平面檔案連線管理員編輯器 (進階頁面)

您可以使用 [一般檔案連線管理員編輯器] 對話方塊的 [進階] 頁面設定屬性，以指定 Integration Services 讀取及寫入一般檔案的方式。 您可以變更一般檔案中的資料行名稱，並設定屬性以包含檔案中每個資料行的資料類型和分隔符號。

字串資料行的長度預設為 50 個字元。 您可以調整這些資料行的長度，以避免截斷資料或資料行寬度過大。 您也可更新其他中繼資料，以啟用與目的地資料行的相容性。 例如，您可能會將只包含整數資料之資料行的資料類型變更成數值資料類型 (例如 DT_I2)。 您可以手動進行這些修改，也可以按一下 [選取類型] 按鈕，使用 [建議資料行類型] 對話方塊評估範例資料，並自動為您進行其中某些變更。

若要深入了解一般檔案連接管理員，請參閱＜ Flat File 連線管理員＞。

選項

連線管理員名稱
為工作流程中的平面檔案連線管理員提供唯一名稱。 提供的名稱將顯示在 SSIS 設計師內。

說明
描述連接管理員。 最佳做法是依其用途來描述連線管理員，讓封裝具自我說明性且更易於維護。

設定每一個資料行的屬性
請在左窗格中選取一個資料行以便在右窗格中檢視它的屬性。 請參閱下表以了解資料類型屬性的描述。 列出的部分屬性僅適用於某些平面檔案格式。

屬性	描述
ColumnType	表示資料行是否為以分隔符號分隔、固定寬度或右側參差不齊的格式。 這個屬性是唯讀的。 右側不整齊檔案是指除了最後一個資料行外，每個資料行都具有固定寬度的檔案。 其分隔方式是使用資料列分隔符號。
OutputColumnWidth	指定儲存為位元組計數的值；針對 Unicode 檔案，此值將對應至字元計數。 在資料流程工作中，這個值會用於設定平面檔案來源的輸出資料行寬度。 在物件模型中，這個屬性的名稱為 MaximumWidth。
DataType	從可用的資料類型清單中選取。 如需詳細資訊，請參閱 Integration Services 資料類型。
TextQualified	指出文字資料是否會由文字限定詞字元 (例如引號字元) 括住。 True: 平面檔案中的文字資料是以文字限定符括住的。 False：平面檔案中的文字資料未使用文字限定符。
名稱	請提供具描述性的資料行名稱。 如果您未輸入名稱，Integration Services 會自動以 Column 0、Column 1 等等的格式建立名稱。
DataScale	指定數值資料的刻度。 Scale 是指小數點後的位數。 如需詳細資訊，請參閱 Integration Services 資料類型。
ColumnDelimiter	從可用的資料行分隔符號清單中選取。 請選擇不太可能會在文字中出現的分隔符號。 這個值在固定寬度資料行中會被忽略。 {CR}{LF} ： 欄位是以回車與換行的組合分隔。 {CR} ： 各欄位以回車字元分隔。 {LF} ： 欄位之間以換行字元分隔。 分號 {;} ： 各欄位之間以分號分隔。 冒號 {:}. 欄位以冒號分隔。 逗號 {,} . 資料行是以逗號分隔。 定位點 {t}。 各欄位之間以 Tab 字元分隔。 垂直線 {|}. 欄位之間以豎線（|）分隔。
DataPrecision	指定數值資料的精確度。 精度是指位數的多少。 如需詳細資訊，請參閱 Integration Services 資料類型。
輸入欄寬	指定將儲存為位元組計數的值；針對 Unicode 檔案，這將會顯示為字元計數。 對於分隔欄，此值會被忽略。 注意 ︰在物件模型中，這個屬性的名稱為 ColumnWidth。

新增
按一下 New 以新增資料行。 [新增] 按鈕預設會在清單結尾加入新資料行。 此按鈕還有下列選項，可以在下拉式清單中使用。

值	描述
新增資料行	在清單結尾加入新資料行。
向前插入	在選取的資料行之前插入新資料行。
插入於後方	在選取的資料行之後插入新資料行。

刪除
選取資料行，然後按一下 [刪除] 將其移除。

建議類型
使用 [建議資料行類型] 對話方塊，評估檔案中的範例資料，並取得對每個資料行之資料類型和長度的建議。 如需詳細資訊，請參閱 建議資料行類型對話方塊 UI 參考。

平面檔案連線管理員編輯器 (預覽頁面)

使用 [平面檔案連線管理員編輯器] 對話方塊的 [預覽] 節點，可用表格格式檢視來源檔案的內容。

若要深入了解一般檔案連接管理員，請參閱＜ Flat File 連線管理員＞。

選項

連線管理員名稱
為工作流程中的平面檔案連線輸入唯一名稱。 提供的名稱將顯示在 SSIS 設計師內。

說明
描述連接。 最佳作法是以其用途描述連接，使封裝可以自我記錄並易於維護。

要略過的資料列
指定平面檔案開頭要跳過的資料列數。

[重新整理]
按一下 重新整理，即可檢視變更略過資料列數的效果。 僅在您已變更其他連接選項之後，才會看見此按鈕。

資料列預覽
檢視一般檔案中的範例資料，根據您選取的選項將資料分為資料行和資料列。