Create an Analysis Services Job Step

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

重要

Azure SQL 受控執行個體目前支援多數 (但非全部) 的 SQL Server Agent 功能。 如需詳細資料，請參閱來自 SQL Server 的 Azure SQL 受控執行個體 \(部分機器翻譯\)。

此主題描述如何使用 SQL Server Management Studio、Transact-SQL 或 SQL Server 管理物件，在 SQL Server 中建立和定義執行 SQL Server Analysis Services 命令與查詢的 SQL Server Agent 作業步驟。

開始之前

限制事項

  • 如果作業步驟使用 Analysis Services 命令，命令陳述式必須是 XML for Analysis Services Execute 方法。 此陳述式可能不包含完整的簡易物件存取通訊協定 (SOAP) Envelope 或 XML for Analysis Discover 方法。 雖然 SQL Server Management Studio 支援完整的 SOAP Envelope 與 Discover 方法，但是 SQL Server Agent 作業步驟則不支援。 如需有關 XML for Analysis Services 的詳細資訊，請參閱 XML for Analysis 概觀 (XMLA)。

  • 如果作業步驟使用 Analysis Services 查詢，查詢陳述式必須是多維度運算式 (MDX) 查詢。 如需 MDX 的詳細資訊，請參閱 MDX 陳述式基礎觀念 (MDX)。

安全性

權限

  • 若要執行使用 Analysis Services 子系統的作業步驟，使用者必須是 系統管理員 (sysadmin) 固定伺服器角色的成員，或具有已定義能使用此子系統之有效 Proxy 帳戶的存取權。 此外，SQL Server Agent 服務帳戶或 Proxy 必須是 Analysis Services 系統管理員，且必須是有效的 Windows 網域帳戶。

  • 只有 系統管理員 (sysadmin) 固定伺服器角色的成員可以將作業步驟輸出寫入檔案。 若作業步驟是由屬於 msdb 資料庫之 SQLAgentUserRole 資料庫角色 的使用者執行，則輸出只能寫入一個資料表。 SQL Server Agent 會將作業步驟輸出寫入到 msdb 資料庫中的 sysjobstepslog 資料表。

  • 如需詳細資訊，請參閱＜ 實作 SQL Server Agent 安全性＞。

使用 SQL Server Management Studio

若要建立 Analysis Services 命令作業步驟

  1. 在 [物件總管] 中，連線至 SQL Server 資料庫引擎的執行個體，然後展開該執行個體。

  2. 展開 SQL Server Agent，建立新作業或以滑鼠右鍵按一下現有作業，然後按一下 [屬性] 。 如需建立作業的詳細資訊，請參閱 建立作業。

  3. 在 [作業屬性] 對話方塊中，按一下 [步驟] 頁面，然後按一下 [新增]。

  4. 在 [新增作業步驟] 對話方塊中，輸入作業 步驟名稱。

  5. 在 [類型] 清單中，按一下 [SQL Server Analysis Services 命令]。

  6. 在 [執行身分] 清單中，選取已定義為使用「Analysis Services 命令」子系統的 Proxy。 身為 系統管理員 (sysadmin) 固定伺服器角色成員的使用者，也可以選取 [SQL 代理程式服務帳戶] 來執行這個作業步驟。

  7. 選取將執行作業步驟的 伺服器 ，或輸入伺服器名稱。

  8. 在 [命令] 方塊中，輸入要執行的陳述式，或按一下 [開啟] 選取陳述式。

  9. 按一下 [進階] 頁面以定義這個作業步驟的選項，例如在作業步驟成功或失敗時，SQL Server Agent 所該採取的行動、應該嘗試作業步驟多少次，以及應該在何處寫入作業步驟輸出。

若要建立 Analysis Services 查詢作業步驟

  1. 在 [物件總管] 中，連線至 SQL Server 資料庫引擎的執行個體，然後展開該執行個體。

  2. 展開 SQL Server Agent，建立新作業或以滑鼠右鍵按一下現有作業，然後按一下 [屬性] 。 如需建立作業的詳細資訊，請參閱 建立作業。

  3. 在 [作業屬性] 方塊中，按一下 [步驟] 頁面，然後按一下 [新增] 。

  4. 在 [新增作業步驟] 對話方塊中，輸入一個作業 步驟名稱。

  5. 在 [類型] 清單中，按一下 [SQL Server Analysis Services 查詢]。

  6. 在 [執行身分] 清單中，選取已定義為使用「Analysis Services 查詢」子系統的 Proxy。 身為 系統管理員 (sysadmin) 固定伺服器角色成員的使用者，也可以選取 [SQL 代理程式服務帳戶] 來執行這個作業步驟。

  7. 選取將執行作業步驟的 伺服器 與 資料庫 ，或輸入伺服器或資料庫名稱。

  8. 在 [命令] 方塊中，輸入要執行的陳述式，或按一下 [開啟] 選取陳述式。

  9. 按一下 [進階] 頁面以定義這個作業步驟的選項，例如在作業步驟成功或失敗時，SQL Server Agent 所該採取的行動、應該嘗試作業步驟多少次，以及應該在何處寫入作業步驟輸出。

使用 TRANSACT-SQL

若要建立 Analysis Services 命令作業步驟

  1. 在物件總管中，連線到資料庫引擎的執行個體。

  2. 在標準列上，按一下 [新增查詢] 。

  3. 複製下列範例並將其貼到查詢視窗中，然後按一下 [執行] 。

    -- Creates a job step that uses XMLA to create a relational data source that
-- references the AdventureWorks2022 Microsoft SQL Server database.  
USE msdb;  
GO  
EXEC sp_add_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_name =
        N'Create a relational data source that references the AdventureWorks2022 Microsoft SQL Server database',  
    @subsystem = N'ANALYSISCOMMAND',  
    @command =
        N' <Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>AdventureWorks2022</DatabaseID>  
    </ParentObject>  
    <ObjectDefinition>  
        <DataSource xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:type="RelationalDataSource">  
            <ID>AdventureWorks2022</ID>  
            <Name>Adventure Works 2022</Name>  
            <ConnectionString>Data Source=localhost;Initial Catalog=AdventureWorks2022;Integrated Security=True</ConnectionString>  
            <ImpersonationInfo>  
                <ImpersonationMode>ImpersonateServiceAccount</ImpersonationMode>  
            </ImpersonationInfo>  
            <ManagedProvider>System.Data.SqlClient</ManagedProvider>  
            <Timeout>PT0S</Timeout>  
        </DataSource>  
    </ObjectDefinition>  
</Create>', ;  
GO

如需詳細資訊，請參閱 sp_add_jobstep (Transact-SQL)。

若要建立 Analysis Services 查詢作業步驟

  1. 在物件總管中，連線到資料庫引擎的執行個體。

  2. 在標準列上，按一下 [新增查詢] 。

  3. 複製下列範例並將其貼到查詢視窗中，然後按一下 [執行] 。

    -- Creates a job step that uses MDX to return data  
USE msdb;  
GO  
EXEC sp_add_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_name = N'Returns the Internet sales amount by state',  
    @subsystem = N'ANALYSISQUERY',  
    @command = N' SELECT  
   [Measures].[Internet Sales Amount] ON COLUMNS,  
   [Customer].[State-Province].Members ON ROWS  
FROM [AdventureWorks2022]',   
    @retry_attempts = 5,  
    @retry_interval = 5 ;  
GO

如需詳細資訊，請參閱 sp_add_jobstep (Transact-SQL)。

使用 SQL Server 管理物件

建立 PowerShell 指令碼作業步驟

透過所選的程式語言，例如 XMLA 或 MDX，使用 JobStep 類別。 如需詳細資訊，請參閱 SQL Server 管理物件 (SMO)。