Bereitstellen von Modelllösungen mithilfe des Bereitstellungshilfsprogramms
Gilt für:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Mit dem Hilfsprogramm Microsoft.AnalysisServices.Deployment können Sie die SQL Server Analysis Services-Bereitstellungs-Engine über die Eingabeaufforderung starten. Als Eingabedatei verwendet das Hilfsprogramm die XML-Ausgabedateien, die durch das Erstellen eines SQL Server Analysis Services-Projekts in SQL Server Data Tools generiert werden. Die Eingabedateien können problemlos geändert werden, um die Bereitstellung eines SQL Server Analysis Services-Projekts anzupassen. Anschließend kann das generierte Bereitstellungsskript entweder sofort ausgeführt oder für eine spätere Bereitstellung gespeichert werden.
Der SQL Server Analysis Services-Bereitstellungs-Assistent/-Hilfsprogramm wird mit SQL Server Managment Studio (SSMS) installiert. Stellen Sie sicher, dass Sie die neueste Version verwenden. Standardmäßig wird die neueste Version des Bereitstellungsprogramms, das mit SSMS 18.x oder höher installiert ist, unter C:\Programme (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE installiert. Bei der Installation mit früheren SSMS 17.x lautet der Standardpfad C:\Programme (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio.
Syntax
Microsoft.AnalysisServices.Deployment [ASdatabasefile]
{[/s[:logfile]] | [/a] | [[/o[:output_script_file]] [/d]]}
Argumente
ASdatabasefile
Der vollständige Pfad des Ordners, in dem sich die SQL Server Analysis Services-Bereitstellungsskriptdatei (.asdatabase) befindet. Diese Datei wird generiert, wenn Sie ein Projekt in SQL Server Data Tools bereitstellen. Sie befindet sich im Projektpapierkorb. Die AS-Datenbankdatei enthält die bereitzustellenden Objektdefinitionen. Wird dieses Argument nicht angegeben, wird der aktuelle Ordner verwendet.
/s
Führt das Hilfsprogramm im unbeaufsichtigten Modus aus; Dialogfelder werden nicht angezeigt. Weitere Informationen zu den Ausführungsmodi finden Sie im Abschnitt Modiweiter unten in diesem Thema.
Logfile
Der vollständige Pfad und der Dateiname der Protokolldatei. Ablaufverfolgungsereignisse werden in der angegebenen Protokolldatei protokolliert. Wenn die Protokolldatei bereits vorhanden ist, wird der Inhalt der Datei ersetzt.
/a
Führt das Hilfsprogramm im Antwortmodus aus. Alle Antworten, die während des assistentenbasierten Teils des Hilfsprogramms angegeben werden, werden in die Eingabedateien geschrieben, es werden jedoch keine wirklichen Änderungen an den Bereitstellungszielen vorgenommen.
/O
Führt das Hilfsprogramm im Ausgabemodus aus. Es erfolgt keine Bereitstellung; das XMLA-Skript (XML for Analysis), das normalerweise an die Bereitstellungsziele gesendet würde, wird stattdessen in der angegebenen Ausgabeskriptdatei gespeichert. Wenn output_script_file nicht angegeben wird, versucht das Hilfsprogramm, die Ausgabeskriptdatei zu verwenden, die in der Eingabedatei mit den Bereitstellungsoptionen (.deploymentoptions) angegeben ist. Wird in der Eingabedatei mit den Bereitstellungsoptionen keine Ausgabeskriptdatei angegeben, tritt ein Fehler auf.
Weitere Informationen zu den Ausführungsmodi finden Sie im Abschnitt Modiweiter unten in diesem Thema.
output_script_file
Der vollständige Pfad und der Dateiname der Ausgabeskriptdatei.
/d
Falls das /o -Argument verwendet wird, gibt dieses Argument an, dass das Hilfsprogramm keine Verbindung mit der Zielinstanz herstellen soll. Da keine Verbindung mit den Bereitstellungszielen hergestellt wird, wird das Ausgabeskript nur basierend auf den Informationen generiert, die aus den Eingabedateien abgerufen werden.
Hinweis
Das Argument /d wird nur im Ausgabemodus verwendet. Dieses Argument wird ignoriert, wenn es im Antwortmodus oder im unbeaufsichtigten Modus angegeben wird. Weitere Informationen zu den Ausführungsmodi finden Sie im Abschnitt Modiweiter unten in diesem Thema.
Hinweise
Das Hilfsprogramm Microsoft.AnalysisServices.Deployment liest eine Gruppe von Dateien, die die Objektdefinitionen, Bereitstellungsziele, Bereitstellungsoptionen und Konfigurationseinstellungen angeben, und versucht, die Objektdefinitionen mithilfe der angegebenen Bereitstellungsoptionen und Konfigurationseinstellungen auf den angegebenen Bereitstellungszielen bereitzustellen. Dieses Hilfsprogramm kann eine Benutzeroberfläche bereitstellen, wenn es im Antwort- oder Ausgabemodus aufgerufen wird. Weitere Informationen zur Verwendung der für dieses Hilfsprogramm bereitgestellten Benutzeroberfläche zum Erstellen von Antwortdateien finden Sie unter Bereitstellen von Modelllösungen mithilfe des Bereitstellungs-Assistenten.
Das Hilfsprogramm befindet sich im Ordner \Program files (x86)\Microsoft SQL Server\140\Binn\ManagementStudio.
Modi
Das Hilfsprogramm kann in den folgenden Modi ausgeführt werden.
| Mode | Beschreibung |
|---|---|
| Unbeaufsichtigter Modus | Es wird keine Benutzeroberfläche angezeigt. Alle Informationen, die für die Bereitstellung benötigt werden, werden durch die Eingabedateien angegeben. Im unbeaufsichtigten Modus gibt das Hilfsprogramm keinen Status aus. Stattdessen kann eine optionale Protokolldatei verwendet werden, um Status- und Fehlerinformationen für eine spätere Prüfung aufzuzeichnen. |
| Antwortmodus | Die Benutzeroberfläche des Bereitstellungs-Assistenten wird angezeigt; die Benutzerantworten werden in den angegebenen Ausgabedateien gespeichert, um sie bei einer späteren Bereitstellung verwenden zu können. Im Antwortmodus erfolgt keine Bereitstellung. Der Antwortmodus dient lediglich dazu, die Benutzerantworten aufzuzeichnen. |
| Ausgabemodus | Es wird keine Benutzeroberfläche angezeigt. Alle Informationen, die für die Bereitstellung benötigt werden, werden durch die Eingabedateien angegeben. Anders als im unbeaufsichtigten Modus wird die Ausgabe des Hilfsprogramms jedoch in eine Ausgabeskriptdatei geschrieben und nicht an die in den Eingabedateien angegebenen Bereitstellungsziele gesendet. Sofern das Argument /d nicht angegeben wird, stellt das Hilfsprogramm eine Verbindung mit jedem Bereitstellungsziel her, um die Metadaten zu vergleichen, während die Ausgabeskriptdatei generiert wird. |
Beispiele
Das folgende Beispiel zeigt, wie Sie ein SQL Server Analysis Services-Projekt im unbeaufsichtigten Modus bereitstellen und Status- und Fehlermeldungen zur späteren Überprüfung protokollieren:
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
Weitere Informationen
Referenz zum Eingabeaufforderungshilfsprogramm (Datenbank-Engine)