使用部署公用程式部署模型解決方案

適用於: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Microsoft.AnalysisServices.Deployment 公用程式可讓您從命令提示字元啟動 SQL Server Analysis Services 部署引擎。 作為輸入檔,公用程式會使用在 SQL Server Data Tools 中建置 SQL Server Analysis Services 專案所產生的 XML 輸出檔。 輸入檔案可以輕鬆地修改,以自定義 SQL Server Analysis Services 專案的部署。 然後,可以立即執行產生的部署腳本,或儲存以供稍後部署使用。

SQL Server Analysis Services 部署精靈/公用程式會與 SQL Server 管理 Studio (SSMS) 一起安裝。 請確定您使用的是最新版本。 根據預設,隨 SSMS 18.x 或更高版本一起安裝的部署公用程式最新版本會安裝到 C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE。 使用舊版 SSMS 17.x 安裝時,預設路徑為 C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio。

語法

Microsoft.AnalysisServices.Deployment [ASdatabasefile]   
    {[/s[:logfile]] | [/a] | [[/o[:output_script_file]] [/d]]}  

參數

ASdatabasefile
SQL Server Analysis Services 部署腳本 (.asdatabase) 檔案所在的資料夾完整路徑。 當您在 SQL Server Data Tools 中部署專案時,會產生此檔案。 它位於專案 bin 資料夾中。 .asdatabase 檔案包含要部署的物件定義。 如果未指定,則會使用目前的資料夾。

/s
以無訊息模式執行公用程式,而不會顯示任何對話方塊。 如需模式的詳細資訊,請參閱本主題稍後的 模式一節。

logfile
記錄檔的完整路徑和檔名。 追蹤事件將會記錄至指定的記錄檔。 如果記錄檔已經存在,則會取代檔案的內容。

/a
在回應模式中執行公用程式。 在公用程式精靈部分期間所做的所有回應都應該寫回輸入檔,但實際上不會對部署目標進行任何變更。

/o
在輸出模式中執行 公用程式。 部署不會發生,但通常會傳送至部署目標的 XML for Analysis (XMLA) 腳本會改為儲存至指定的輸出腳本檔案。 如果未指定 output_script_file,公用程式會嘗試使用部署選項 (.deploymentoptions) 輸入檔中指定的輸出腳本檔案。 如果未在部署選項輸入檔中指定輸出腳本檔案,就會發生錯誤。

如需模式的詳細資訊,請參閱本主題稍後的 模式一節。

output_script_file
輸出文稿檔案的完整路徑和檔名。

/d
如果使用 /o 自變數,則指定公用程式不應該連接到目標實例。 由於沒有連線到部署目標,因此只會根據從輸入檔擷取的信息產生輸出腳本。

注意

/d 自變數僅用於輸出模式。 如果在回應或無訊息模式中指定,則會忽略此自變數。 如需模式的詳細資訊,請參閱本主題稍後的 模式一節。

言論

Microsoft.AnalysisServices.Deployment 公用程式會採用一組檔案,提供物件定義、部署目標、部署選項和組態設定,並嘗試使用指定的部署選項和組態設定,將對象定義部署到指定的部署目標。 此公用程式可以在回應檔案或輸出模式中叫用時提供使用者介面。 如需如何使用此公用程式提供的使用者介面來建立回應檔案的詳細資訊,請參閱使用部署精靈部署模型解決方案。

公用程式位於 \Program files (x86)\Microsoft SQL Server\140\Binn\ManagementStudio 資料夾中。

模式

公用程式可以在下表所列的模式中執行。

模式 描述
無訊息模式 不會顯示任何使用者介面,而且輸入檔會提供部署所需的所有資訊。 公用程式不會以無訊息模式顯示任何進度。 相反地,選擇性記錄檔可用來擷取進度和錯誤資訊,以供稍後檢閱。
答案模式 [部署精靈] 使用者介面隨即顯示,且用戶回應會儲存至指定的輸入檔以供稍後部署。 部署不會在回應模式中發生。 回應模式的唯一目的是擷取用戶回應
輸出模式 不會顯示任何使用者介面,而且輸入檔會提供部署所需的所有資訊。

不過,與無訊息模式不同,公用程式的輸出會寫入輸出腳本檔案,而不會傳送至輸入檔中所指出的部署目標。 除非指定 /d 自變數,否則公用程式會與每個部署目標連線,以比較元數據,同時產生輸出腳本檔案。

回到自變數

例子

下列範例示範如何以無訊息模式部署 SQL Server Analysis Services 專案、記錄進度和錯誤訊息,以供稍後檢閱:

Microsoft.AnalysisServices.Deployment.exe

<drive>:\My Documents\Visual Studio 2010\Projects\AdventureWorksProject\Project1\bin

/s: C:\ My Documents\Visual Studio 2010\Projects\AdventureWorksProject\Project1\bin\deployment.log

另請參閱

命令提示字元公用程序參考 (資料庫引擎)