Развертывание решений модели с помощью программы развертывания
Применимо к:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Служебная программа Microsoft.AnalysisServices.Deployment позволяет запустить подсистему развертывания SQL Server Analysis Services из командной строки. В качестве входного файла программа использует выходные XML-файлы, созданные при создании проекта SQL Server Analysis Services в SQL Server Data Tools. Входные файлы легко изменяются для настройки развертывания проекта SQL Server Analysis Services. Сформированный скрипт развертывания можно затем либо сразу запустить, либо сохранить и запустить позднее.
Мастер и служебная программа развертывания SQL Server Analysis Services устанавливается вместе с SQL Server Managment 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 для аналитики (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
См. также раздел
Справочник по служебной программе командной строки (ядро СУБД)