Развертывание решений модели с использованием мастера развертывания

Статья
05/08/2023

Применимо к: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Мастер развертывания SQL Server Analysis Services использует выходные файлы JSON, созданные из проекта SQL Server Analysis Services, в качестве входных файлов. Эти входные файлы легко изменяются для настройки развертывания SQL Server Analysis Services проекта. Сформированный скрипт развертывания можно затем либо сразу запустить, либо сохранить и запустить позднее.

Мастер развертывания или служебная программа устанавливается вместе с SQL Server Management Studio (SSMS). Убедитесь, что вы используете последнюю версию. При запуске из командной строки по умолчанию последняя версия мастера развертывания устанавливается в папку C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

Развертывание можно выполнить с помощью мастера, как описано здесь. Также можно автоматизировать развертывание или использовать функцию синхронизации. При больших размерах развернутой базы данных на целевых системах рекомендуется использовать секции. Вы можете автоматизировать создание и заполнение секций с помощью табличной объектной модели (TOM), языка табличной модели (TMSL) и объектов AMO.

Важно!

Ни выходные файлы, ни сценарий развертывания не будут содержать идентификатор пользователя или пароль, если они указаны в строка подключения для источника данных или для олицетворения. Поскольку в данном сценарии они необходимы для обработки, добавьте их вручную. Если в ходе развертывания не выполнится обработка, то эти сведения для соединения и олицетворения при необходимости можно добавить после развертывания. Если в ходе развертывания выполнится обработка, то можно добавить эти сведения с помощью мастера или добавить их в скрипт развертывания после его сохранения.

Запуск мастера развертывания

Мастер развертывания можно запустить следующими способами:

Интерактивно . При интерактивном запуске мастер развертывания создает скрипт развертывания на основе входных файлов, которые в интерактивном режиме изменяются пользовательскими входными данными. Мастер применяет все пользовательские изменения только к скрипту развертывания. Мастер не изменяет входные файлы.
Из командной строки — при запуске в командной строке мастер развертывания создает скрипт развертывания на основе параметров, используемых для запуска мастера. Мастер может работать одним из следующих способов: выдать приглашение для ввода данных и изменить входные файлы на основе этих данных, запустить автоматическое развертывание с использованием исходных входных файлов или создать скрипт развертывания, который можно использовать позже.

Запуск в интерактивном режиме

При интерактивном запуске мастер развертывания считывает значения из входных файлов и предоставляет эти сведения. Вы можете изменить эти входные значения, такие как назначение развертывания, параметры конфигурации, параметры развертывания и строка подключения пароли, или оставить их без изменений. Если вы измените какие-либо входные значения, мастер использует эти изменения при создании скрипта развертывания. Однако мастер не изменяет какие-либо значения во входном файле.

Примечание

Если вы хотите, чтобы мастер развертывания изменял входные значения, запустите мастер в командной строке и настройте мастер для запуска в режиме файла ответов.

После того как вы просмотрите входные значения и внесете необходимые изменения, мастер создаст скрипт развертывания. который можно сразу запустить на целевом сервере или сохранить для использования в дальнейшем.

Запуск мастера развертывания служб Analysis Services в интерактивном режиме

Нажмите кнопку Пуск, а затем введите Мастер развертывания служб Analysis Services.

-или-
В папке Проекты проекта SQL Server Analysis Services дважды щелкните <файл имя> проекта.asdatabase.

Примечание

При невозможности нахождения файла .asdatabase попробуйте использовать функцию «Поиск», задав строку «*.asdatabase». Или может потребоваться выполнить сборку проекта в SSDT.

Запуск в командной строке

Мастер развертывания также можно запустить в командной строке. При запуске в командной строке укажите полный путь к файлу ASDATABASE и запустите мастер в одном из следующих режимов:

Режим файла ответов
В режиме файла ответов мастер позволяет в интерактивном режиме изменять входные файлы, созданные при сборке проекта SQL Server Analysis Services SQL Server Data Tools. Мастер сохраняет эти измененные входные файлы перед созданием скрипта развертывания. Измененные входные файлы становятся новой отправной точкой при следующем запуске мастера.

Чтобы запустить мастер в режиме файла ответов, используйте параметр /a .

Режим без вывода сообщений
В режиме молчания мастер запускает автоматическое развертывание на основе данных, находящихся во входных файлах.

Чтобы запустить мастер в автоматическом режиме, используйте параметр /s . В этом режиме сообщения выводятся на консоль или в файл журнала, если таковой имеется.

Режим вывода
В режиме вывода мастер создает скрипт развертывания для последующего выполнения на основе входных файлов.

Чтобы запустить мастер в режиме вывода, используйте параметр /o и укажите имя выходного файла.

Дополнительные сведения об этих параметрах командной строки см. в статье Развертывание решений модели с помощью программы развертывания.

Запуск мастера развертывания служб Analysis Services из командной строки

Если установлено вместе с SSMS 18.x, откройте командную строку и перейдите по пути по умолчанию C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.
Запустите Microsoft.AnalysisServices.Deployment.exe с ключом, определяющим режим запуска мастера.

Общие сведения о скрипте развертывания

Скрипт развертывания XMLA, созданный мастером развертывания, состоит из двух разделов:

Первая часть скрипта развертывания содержит команды, необходимые для создания, изменения или удаления соответствующих объектов Microsoft SQL Server в целевой базе данных. По умолчанию входные файлы, созданные проектом SQL Server Analysis Services, основаны на добавочном развертывании. В результате скрипт развертывания XML для аналитики влияет только на те объекты, которые были изменены или удалены.
Вторая часть скрипта развертывания содержит команды, необходимые для обработки только тех объектов, которые были созданы или изменены на целевом сервере (параметр «Обработка по умолчанию») или для полной обработки целевой базы данных. Кроме того, можно выбрать, чтобы скрипт развертывания не содержал команд обработки.

Весь скрипт развертывания может выполняться в одной транзакции или в нескольких транзакциях. Если скрипт выполняется в нескольких транзакциях, то первая часть скрипта выполняется в виде одной транзакции, а каждый объект обрабатывается в собственной транзакции.

Важно!

Мастер развертывания SQL Server Analysis Services развертывает объекты только в одной базе данных SQL Server Analysis Services. Он не осуществляет развертывание никаких объектов или данных уровня сервера.

Файлы скриптов развертывания — входные данные, используемые для создания скрипта развертывания

При сборке проекта SQL Server Data Tools создает файлы для проекта. SQL Server Data Tools затем помещает эти файлы в папку Output проекта. По умолчанию выходные данные помещают в папку \Bin. В следующей таблице перечислены XML-файлы, создаваемые SQL Server Data Tools:

Файл	Описание
<имя> проекта. asdatabase	XML-файл для многомерных проектов или проектов табличной модели 1100/1103 или JSON-файл для проектов табличных моделей 1200 и более поздних версий. Содержит декларативные определения для всех SQL Server Analysis Services объектов в проекте.
<имя> проекта. deploymenttargets	Содержит имя экземпляра SQL Server Analysis Services и базы данных, в которой будут созданы объекты SQL Server Analysis Services.
<имя> проекта. configsettings	Содержит параметры, которые относятся к окружению, например сведения о соединении с источником данных и о месте хранения объектов. Параметры в этом файле переопределяют параметры в < файле имени> проекта.asdatabase.
<имя> проекта. deploymentoptions	Содержит параметры развертывания, которые указывают, является ли развертывание транзакционным и нужно ли обрабатывать объекты после развертывания.

SQL Server Data Tools никогда не хранит пароли в файлах проекта.

Изменение входных файлов

Изменение значений во входных файлах или значений, полученных из входных файлов, позволяет изменить назначение развертывания, параметры конфигурации и параметры развертывания без изменения всего <файла имени> проекта.asdatabase (или всего файла скрипта при создании скрипта из существующей базы данных SQL Server Analysis Services). Благодаря возможности редактирования отдельных файлов можно легко создавать различные скрипты развертывания для разных целей.

Файлы скриптов развертывания — указание целевого объекта установки

Мастер развертывания считывает сведения о целевом объекте < установки из файла имя> проекта.deploymenttargets. SQL Server Data Tools создает этот файл при сборке проекта. SQL Server Data Tools использует базу данных и сервер, указанные на странице Развертывание диалогового <окна Страницы свойств имени>проекта, для создания < файла имени> проекта.targets.

Изменение целевого объекта установки

В некоторых ситуациях может потребоваться развернуть проект в базе данных или экземпляре, отличающихся от указанного на странице Развертывание . Например может быть необходимо развернуть проект на сервер для тестирования перед развертыванием, а затем развернуть его на производственный сервер после окончания тестирования. Может также быть необходимо развернуть завершенный и протестированный проект на несколько производственных серверов в кластере балансирования сетевой нагрузки, или на промежуточный сервер и производственный сервер.

Чтобы развернуть проект в другой базе данных или экземпляре, измените целевой объект установки во входном файле с помощью одного из методов, описанных в следующей процедуре:

Изменение целевого объекта установки после формирования входных файлов

Запустите мастер развертывания SQL Server Analysis Services в интерактивном режиме. На странице Цель установки укажите новое назначение для экземпляра SQL Server Analysis Services и базы данных.

-или-
Запустите мастер развертывания SQL Server Analysis Services в командной строке и настройте мастер для запуска в режиме файла ответов.

-или-
Измените < файл имени> проекта.deploymenttargets с помощью любого текстового редактора.

Файлы скриптов развертывания. Параметры развертывания секций и ролей

Мастер развертывания считывает параметры развертывания секций и ролей из < файла имени> проекта.deploymentoptions. SQL Server Data Tools создает этот файл при сборке проекта. SQL Server Data Tools затем использует параметры развертывания секций и ролей текущего проекта при < создании файла имени> проекта.deploymentoptions.

Просмотр параметров развертывания секций и ролей

Параметры развертывания в < файле project name.deploymentoptions >включают следующие:

Параметры развертывания секций
Файл <project name.deploymentoptions >указывает, сохраняются или перезаписываются существующие секции в целевой базе данных (по умолчанию). Если существующие секции сохраняются, то будут развернуты только новые секции, а секции и статистические схемы во всех существующих группах мер останутся неизменными.

Если группа мер, на которой основана секция, удаляется, то секция также автоматически удаляется.

Параметры развертывания ролей
В < файле project name.deploymentoptions> указывается один из следующих параметров развертывания роли:

Существующие роли и члены ролей в целевой базе данных сохраняются, и развертываются только новые роли и члены ролей.
Все существующие роли и члены ролей в целевой базе данных заменяются развертываемыми ролями и членами.
Существующие роли и члены ролей в целевой базе данных сохраняются, и новые роли не развертываются.

При сохранении существующих ролей и участников разрешения, связанные с этими ролями, сбрасываются на нет. Разрешения содержатся в защищаемых объектах, а не в ролях безопасности, с которыми они связаны. Дополнительные сведения о том, как работать с этим поведением с помощью мастера развертывания службы Analysis Service, см. в разделе Сохранение ролей и участников базы знаний Майкрософт.

Изменение параметров развертывания секций и ролей

Может потребоваться развернуть проект, используя параметры секции и роли, отличные от параметров, хранящихся в < файле имя> проекта.deploymentoptions. Например, может потребоваться сохранить существующие секции, роли и члены ролей вместо замены всех существующих секций, ролей и членов, как указано в < файле project name.deploymentoptions>.

Чтобы изменить развертывание секций и ролей в проекте, нельзя изменить параметры секций и ролей в проекте, так как диалоговое <окно Страницы свойств проекта> в SQL Server Data Tools не отображает эти параметры. Если вы хотите изменить параметры развертывания для ролей и секций, необходимо изменить эти сведения в < самом файле имени> проекта.deploymentoptions. В следующей процедуре описывается изменение параметров развертывания секций и ролей в < файле имя> проекта.deploymentoptions.

Изменение развертывания секций и ролей после формирования входных файлов

Запустите мастер развертывания в интерактивном режиме и на странице Параметры развертывания секций и ролей укажите новые параметры развертывания для секций и ролей.

-или-
Запустите мастер развертывания в командной строке и настройте мастер для запуска в режиме файла ответов.

-или-
< Откройте проект name.deploymentoptions> в любом текстовом редакторе и вручную измените параметры. Параметры PartitionDeployment: DeployPartitions, RetainPartitions. Параметры RoleDeployment: DeployRolesAndMembers, DeployRolesRetainMembers, RetainRoles.

Файлы скриптов развертывания — параметры конфигурации развертывания решения

Мастер развертывания считывает параметры развертывания секций и ролей, используемые в сценарии развертывания, < из файла имени> проекта.configsettings. Для многомерных проектов SQL Server Data Tools создает этот файл при сборке проекта. Для табличных проектов в зависимости от версии может потребоваться запустить мастер развертывания в режиме ответов, чтобы создать файл .configsettings. SQL Server Data Tools использует параметры конфигурации текущего проекта для создания < файла имени> проекта.configsettings.

Просмотр параметров конфигурации

Ниже приведены параметры конфигурации, хранящиеся в < файле имени> проекта.configsettings:

Строки подключения к источнику данных — это строки подключения для каждого источника данных на основе значений, указанных в проекте. Идентификатор пользователя и пароль всегда удаляются из строки соединения до того, как оставшаяся часть строки сохраняется в этом файле. Однако если мастер развертывания выполняет развертывание непосредственно в экземпляре служб Analysis Services, можно ввести нужный идентификатор пользователя и пароль в мастере, что обеспечит успешную обработку развертываемой базы данных. Эти сведения о соединении не сохраняются в самом скрипте развертывания, если он сохраняется мастером развертывания.
Учетные записи олицетворения . Этот параметр задает имя пользователя, которое SQL Server Analysis Services использует для выполнения инструкций в каждом источнике данных. Если учетная запись олицетворения не указана, SQL Server Analysis Services использует свою учетную запись входа для выполнения инструкций. Если учетной записи входа предоставляются разрешения непосредственно в источнике данных, все администраторы баз данных во всех базах данных в экземпляре SQL Server Analysis Services имеют доступ к источнику данных через учетную запись входа. Если учетная запись пользователя и пароль указаны, то эти сведения всегда удаляются до того, как данные для олицетворения сохраняются в этом файле. Однако если мастер развертывания выполняет развертывание непосредственно в экземпляре служб Analysis Services, можно ввести нужный идентификатор пользователя и пароль в мастере, что обеспечит успешную обработку развертываемой базы данных. Эти сведения об олицетворении не сохранятся в самом скрипте развертывания, если он сохраняется мастером развертывания.

Примечание

Для табличных моделей с уровнем совместимости 1400 и выше со структурированными подключениями к источникам данных поставщика при выборе параметра Сохранить параметры конфигурации для существующих объектов на странице Указание свойств конфигурации мастера имя пользователя и пароль, хранящиеся в базе данных табличной модели целевого сервера, не сохраняются. После завершения развертывания администраторы должны вручную задать имя пользователя и пароль с помощью SSMS.
Файлы журнала ошибок ключей . Этот параметр задает имя файла и путь к файлу журнала ошибок ключа для каждого куба, группы мер, секции и измерения в базе данных.
Расположения хранилища . Этот параметр указывает расположение хранилища для каждого куба, группы мер и секции в базе данных. Если для объекта не указано значение, мастер развертывания использует расположение по умолчанию для объекта. Например, секции используют расположение для группы мер, группы мер — расположение куба, а кубы — расположение по умолчанию для объектов на экземпляре сервера. Место хранения может быть локальным путем или путем в формате UNC.
Сервер отчетов — этот параметр указывает расположение сервера отчетов и папки для каждого действия отчета, определенного в каждом кубе базы данных.

Изменение параметров конфигурации

В некоторых случаях может потребоваться развернуть проект, используя параметры конфигурации, отличные от параметров, хранящихся в < файле имени> проекта.configsettings. Например, может быть необходимо изменить строку соединения с одним или несколькими источниками данных или задать места хранения для конкретных секций или групп мер.

Чтобы изменить развертывание секций и ролей в проекте, необходимо изменить эти сведения в < файле имя> проекта.configsettings, как описано в процедуре ниже. Вы не можете изменить параметры секции и ролей в проекте, так как диалоговое <окно "Страницы свойств проекта>" в SQL Server Data Tools не отображает эти параметры.

Примечание

Настройки конфигурации могут применяться ко всем объектам или только ко вновь созданным объектам. Применяйте параметры конфигурации к вновь созданным объектам, только если вы развертываете дополнительные объекты в ранее развернутой SQL Server Analysis Services базе данных и не хотите перезаписывать существующие объекты. Чтобы указать, применяются ли параметры конфигурации ко всем объектам или только к вновь созданным объектам, задайте этот параметр в < файле имя> проекта.deploymentoptions.

Изменение настройки конфигурации после формирования входных файлов

Запустите мастер развертывания в интерактивном режиме и на странице Параметры конфигурации укажите параметр конфигурации для развертываемых объектов.

-или-
Запустите мастер развертывания в командной строке и настройте мастер для запуска в режиме файла ответов.

-или-
Измените < файл имени> проекта.configsettings с помощью любого текстового редактора.

Файлы скриптов развертывания — параметры обработки

Мастер развертывания считывает параметры обработки из < файла имени> проекта.deploymentoptions. SQL Server Data Tools создает этот файл при сборке проекта. SQL Server Data Tools использует параметры обработки, указанные на странице Развертывание диалогового <окна Свойства страницы имени>проекта, чтобы создать < файл имени> проекта.deploymentoptions.

Просмотр параметров обработки

Параметры конфигурации, хранящиеся в < файле project name.deploymentoptions>:

Метод обработки . Этот параметр определяет, обрабатываются ли развернутые объекты после развертывания, и типом обработки, которая будет выполнена. Существуют три параметра обработки.
- Обработка по умолчанию (по умолчанию) определяет состояние процесса объектов базы данных и выполняет обработку, необходимую для доставки необработанных или частично обработанных объектов в полностью обработанное состояние.
- Полная обработка обрабатывает объект и все содержащиеся в нем объекты. Если полная обработка применяется к уже обработанному объекту, службы Analysis Services удаляют все данные объекта, а затем обрабатывают объект.
- Значение None означает, что обработка не выполняется.
Параметры таблицы обратной записи . Если в проекте включена обратная запись, этот параметр определяет, как обрабатывается обратная запись. Существуют три параметра таблицы обратной записи.
- По умолчанию: если таблица обратной записи существует, то она будет использоваться. Если таблицы обратной записи не существует, то будет создана новая таблица обратной записи.
- Если таблица обратной записи уже существует, то развертывание окончится сбоем. Если таблицы обратной записи не существует, то будет создана новая таблица обратной записи.
- Вне зависимости от того, существует ли уже таблица обратной записи, будет создана новая таблица обратной записи. В этом случае мастер развертывания удалит все существующие таблицы и заменит ее новой таблицей обратной записи.
Развертывание транзакций . Этот параметр определяет, выполняется ли развертывание изменений метаданных и команд обработки в одной транзакции или в отдельных транзакциях.
- Если этот параметр имеет значение True (по умолчанию), SQL Server Analysis Services развертывает все изменения метаданных и все команды процесса в рамках одной транзакции.
- Если этот параметр имеет значение False, SQL Server Analysis Services развертывает изменения метаданных в одной транзакции и развертывает каждую команду обработки в отдельной транзакции.

Изменение параметров обработки

Однако может потребоваться развернуть проект, используя параметры обработки, отличные от параметров, хранящихся в < файле project name.deploymentoptions>. Например может быть необходимо полностью обработать все объекты или обработать их с использованием параметра обработки по умолчанию, или не обрабатывать вообще. Если разрешена запись в кубы или измерения, то можно указать, будет ли использоваться новая или существующая таблица обратной записи.

Чтобы изменить параметры обработки во время развертывания, можно либо исправить и повторно собрать проект, либо изменить параметры обработки во входном файле, используя один из методов, описанных в следующей процедуре.

Изменение параметров обработки после формирования входных файлов

Запустите мастер развертывания в интерактивном режиме. На странице Параметры обработки укажите параметры обработки для развертываемого проекта.

-или-
Запустите мастер развертывания в командной строке и настройте мастер для запуска в режиме файла ответов.

-или-
Измените < файл имени> проекта.deploymentoptions с помощью любого текстового редактора.

См. также раздел

Развертывание решений модели с помощью XMLA
Развертывание решений модели с помощью программы развертывания