Excel 目的地Excel Destination

適用於: 是SQL Server,包括在 Linux 上 是Azure SQL Database 是Azure SQL 資料倉儲 否平行處理資料倉儲 APPLIES TO: yesSQL Server, including on Linux yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

Excel 目的地會將資料載入至 MicrosoftMicrosoft Excel 活頁簿中的工作表或範圍。The Excel destination loads data into worksheets or ranges in MicrosoftMicrosoft Excel workbooks.

重要

如需連接至 Excel 檔案,以及將資料從 Excel 檔案載入或載入至 Excel 檔案的限制與已知問題的詳細資訊,請參閱使用 SQL Server Integration Services (SSIS) 將資料從 Excel 載入或載入至 ExcelFor detailed info about connecting to Excel files, and about limitations and known issues for loading data from or to Excel files, see Load data from or to Excel with SQL Server Integration Services (SSIS).

存取模式Access Modes

Excel 目的地提供三種不同的資料存取模式用於載入資料:The Excel destination provides three different data access modes for loading data:

  • 資料表或檢視。A table or view.

  • 在變數中指定的資料表或檢視。A table or view specified in a variable.

  • SQL 陳述式的結果。The results of an SQL statement. 查詢可以是參數化查詢。The query can be a parameterized query.

設定 Excel 目的地Configure the Excel Destination

Excel 目的地會使用 Excel 連接管理員,以連接到資料來源,而連接管理員會指定要使用的活頁簿檔案。The Excel destination uses an Excel connection manager to connect to a data source, and the connection manager specifies the workbook file to use. 如需詳細資訊,請參閱 Excel Connection ManagerFor more information, see Excel Connection Manager.

Excel 目的地擁有一個規則輸入與一個錯誤輸出。The Excel destination has one regular input and one error output.

您可以透過 SSISSSIS 設計師或以程式設計方式設定屬性。You can set properties through SSISSSIS Designer or programmatically.

[進階編輯器] 對話方塊會反映能以程式設計的方式設定之所有屬性。The Advanced Editor dialog box reflects all the properties that can be set programmatically. 如需有關可以在 [進階編輯器] 對話方塊中或以程式設計方式設定之屬性的詳細資訊,請按下列其中一個主題:For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

如需如何設定屬性的詳細資訊,請參閱 設定資料流程元件的屬性For more information about how to set properties, see Set the Properties of a Data Flow Component.

Excel 目的地編輯器 (連接管理員頁面)Excel Destination Editor (Connection Manager Page)

使用 [Excel 目的地編輯器] 對話方塊的 [連接管理員] 頁面,來指定資料來源資訊,以及預覽結果。Use the Connection Manager page of the Excel Destination Editor dialog box to specify data source information, and to preview the results. Excel 目的地會將資料載入 Microsoft ExcelMicrosoft Excel 活頁簿中的工作表或具名範圍。The Excel destination loads data into a worksheet or a named range in a Microsoft ExcelMicrosoft Excel workbook.

注意

[Excel 目的地編輯器] 中無法使用 Excel 目的地的 CommandTimeout屬性,但可使用 [進階編輯器] 來設定這個屬性。The CommandTimeout property of the Excel destination is not available in the Excel Destination Editor, but can be set by using the Advanced Editor. 此外, [進階編輯器] 中只會有特定的快速載入選項。In addition, certain Fast Load options are available only in the Advanced Editor. 如需有關這個屬性的詳細資訊,請參閱< Excel Custom Properties>的<Excel 目的地>一節。For more information on these properties, see the Excel Destination section of Excel Custom Properties.

靜態選項Static Options

Excel 連接管理員Excel connection manager
從清單中選取現有的 Excel 連線管理員,或按一下 [新增] 建立新的連線管理員。Select an existing Excel connection manager from the list, or create a new connection by clicking New.

新增New
使用 [Excel 連線管理員] 對話方塊來建立新的連線管理員。Create a new connection manager by using the Excel Connection Manager dialog box.

資料存取模式Data access mode
從來源中指定選取資料的方法。Specify the method for selecting data from the source.

選項Option DescriptionDescription
資料表或檢視Table or view 將資料載入 Excel 資料來源中的工作表或具名範圍。Loads data into a worksheet or named range in the Excel data source.
資料表名稱或檢視名稱變數Table name or view name variable 在變數中指定工作表或範圍名稱。Specify the worksheet or range name in a variable.

相關資訊在套件中使用變數Related information: Use Variables in Packages
SQL (命令)SQL command 使用 SQL 查詢將資料載入 Excel 目的地。Load data into the Excel destination by using an SQL query.

Excel 工作表的名稱Name of the Excel sheet
從下拉式清單中選取 Excel 目的地。Select the excel destination from the drop-down list. 如果此清單為空,請按一下 [新增]If the list is empty, click New.

新增New
按一下 [新增] 以啟動 [建立工資料表] 對話方塊。Click New to launch the Create Table dialog box. 按一下 [確定] 時,對話方塊會建立 [Excel 連接管理員] 指向的 Excel 檔案。When you click OK, the dialog box creates the excel file that the Excel Connection Manager points to.

檢視現有的資料View Existing Data
使用 [預覽查詢結果] 對話方塊來預覽結果。Preview results by using the Preview Query Results dialog box. 預覽最多可顯示 200 個資料列。Preview can display up to 200 rows.

資料存取模式動態選項Data Access Mode Dynamic Options

資料存取模式 = 資料表或檢視Data access mode = Table or view

Excel 工作表的名稱Name of the Excel sheet
從資料來源裡可用的資訊清單中,選取工作表或具名範圍的名稱。Select the name of the worksheet or named range from a list of those available in the data source.

資料存取模式 = 資料表名稱或檢視名稱變數Data access mode = Table name or view name variable

變數名稱Variable name
選取包含工作表名稱或具名範圍的變數。Select the variable that contains the name of the worksheet or named range.

資料存取模式 = SQL 命令Data access mode = SQL command

SQL 命令文字SQL command text
輸入 SQL 查詢的文字,按一下 [建立查詢] 來建立查詢,或是按一下 [瀏覽] 以找出包含查詢文字的檔案。Enter the text of an SQL query, build the query by clicking Build Query, or locate the file that contains the query text by clicking Browse.

建立查詢Build Query
使用 [查詢產生器] 對話方塊,以視覺化的方式來建構 SQL 查詢。Use the Query Builder dialog box to construct the SQL query visually.

瀏覽Browse
使用 [開啟] 對話方塊來找出包含 SQL 查詢文字的檔案。Use the Open dialog box to locate the file that contains the text of the SQL query.

剖析查詢Parse Query
請確認查詢文字的語法。Verify the syntax of the query text.

Excel 目的地編輯器 (對應頁面)Excel Destination Editor (Mappings Page)

使用 [Excel 目的地編輯器] 對話方塊的 [對應] 頁面,將輸入資料行對應至目的地資料行。Use the Mappings page of the Excel Destination Editor dialog box to map input columns to destination columns.

選項。Options

可用的輸入資料行Available Input Columns
檢視可用的輸入資料行清單。View the list of available input columns. 使用拖放作業,即可將資料表中的可用輸入資料行對應到目的地資料行。Use a drag-and-drop operation to map available input columns in the table to destination columns.

可用的目的地資料行Available Destination Columns
檢視可用的目的地資料行清單。View the list of available destination columns. 使用拖放作業,即可將資料表中的可用目的地資料行對應到輸入資料行。Use a drag-and-drop operation to map available destination columns in the table to input columns.

輸入資料行Input Column
從上述資料表檢視選取的輸入資料行。View input columns selected from the table above. 您可以使用 [可用的輸入資料行] 清單來變更對應。You can change the mappings by using the list of Available Input Columns.

目的地資料行Destination Column
檢視每個可用的目的地資料行,不論是否已經對應。View each available destination column, whether it is mapped or not.

Excel 目的地編輯器 (錯誤輸出頁面)Excel Destination Editor (Error Output Page)

使用 [Excel 目的地編輯器] 對話方塊的 [進階] 頁面,即可指定錯誤處理的選項。Use the Advanced page of the Excel Destination Editor dialog box to specify options for error handling.

選項。Options

輸入或輸出Input or Output
檢視資料來源的名稱。View the name of the data source.

資料行Column
檢視您在 [Excel 來源編輯器] 對話方塊的 [連線管理員] 節點中所選取的外部 (來源) 資料行。View the external (source) columns that you selected in the Connection Manager node of the Excel Source Editordialog box.

錯誤Error
指定錯誤發生時要採取的動作:忽略失敗、重新導向資料列,或使元件失效。Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

相關主題: 資料中的錯誤處理Related Topics: Error Handling in Data

截斷Truncation
指定截斷發生時要採取的動作:忽略失敗、重新導向資料列,或使元件失效。Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

說明Description
檢視錯誤的描述。View the description of the error.

將這個值設定到選取的資料格Set this value to selected cells
指定發生錯誤或截斷時要對所有選取之資料格採取的動作:忽略失敗、重新導向資料列,或使元件失效。Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

套用Apply
將錯誤處理選項套用至選取的資料格。Apply the error handling option to the selected cells.

另請參閱See Also

使用 SQL Server Integration Services (SSIS) 將資料從 Excel 載入或載入至 ExcelLoad data from or to Excel with SQL Server Integration Services (SSIS)
Excel 來源 Excel Source
Excel 連線管理員Excel Connection Manager