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

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

Мастер развертывания служб анализа SQL Server использует выходные файлы JSON, созданные из проекта служб анализа SQL Server в качестве входных файлов. Эти исходные файлы могут быть легко модифицированы для настройки развертывания проекта 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 дважды щелкните <файл project name.asdatabase>.

  Замечание

  Если не удается найти asdatabase-файл, попробуйте использовать поиск и укажите *.asdatabase. Кроме того, может потребоваться создать проект в SSDT.

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

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

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

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

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

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

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

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

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

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

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

2. Введите Microsoft.AnalysisServices.Deployment.exe с переключателями, соответствующими режиму, в котором вы хотите запустить мастер.

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

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

• Первая часть скрипта развертывания содержит команды, необходимые для создания, изменения или удаления соответствующих объектов Microsoft SQL Server в целевой базе данных. По умолчанию входные файлы, создаваемые проектом SQL Server Analysis Services, основаны на инкрементном развертывании. В результате скрипт развертывания XMLA влияет только на те объекты, которые были изменены или удалены.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  –или–

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

  –или–

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

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

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

Обзор параметров развертывания разделов и ролей

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

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

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

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

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

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

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

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

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

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

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

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

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

  –или–

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

  –или–

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

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

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

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

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

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

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

  Замечание

  Для табличных моделей на уровне совместимости 1400 и выше со структурированными подключениями к источнику данных поставщика, при выборе сохранить параметры конфигурации для существующих объектов на странице "Указание свойств конфигурации" мастера, имя пользователя и пароль в базе данных табличной модели на целевом сервере не будут сохранены. Администраторы должны вручную задать имя пользователя и пароль с помощью SSMS после завершения развертывания.

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

• Расположения хранилища — этот параметр задает расположение хранилища для каждого куба, группы мер и секции в базе данных. Если для объекта не указано значение, мастер развертывания использует расположение по умолчанию для объекта. Например, секции используют расположение для группы мер, группы мер используют расположение куба, а кубы используют расположение по умолчанию для объектов на экземпляре сервера. Расположение хранилища может быть локальным или универсальным путем соглашения об именовании (UNC).

• Сервер отчетов — этот параметр указывает расположение сервера отчетов и папки для каждого действия отчета, определенного в каждом кубе базы данных.

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

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

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

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

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

  –или–

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

  –или–

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

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

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

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

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

• Метод обработки . Этот параметр определяет, обрабатываются ли развернутые объекты после развертывания и тип обработки, который будет выполнен. Существует три варианта обработки:

  • Обработка по умолчанию (по умолчанию) обнаруживает состояние процесса объектов базы данных и выполняет обработку, необходимую для доставки необработанных или частично обработанных объектов в полностью обработанное состояние.

  • Полная обработка обрабатывает объект и все содержащиеся в нем объекты. При выполнении Process Full над уже обработанным объектом, службы Analysis Services удаляют все данные в объекте, а затем выполняют его повторную обработку.

  • Ни один из них не означает, что обработка не выполняется.

• Параметры таблицы обратной записи. Если обратная запись включена в проекте, этот параметр определяет, как обрабатывается обратная запись. Существует три варианта таблицы обратной записи:

  • По умолчанию, если существует таблица обратной записи, она будет использоваться. Если таблица обратной записи не существует, будет создана новая таблица обратной записи.

  • Если таблица для записи обратных данных уже существует, развертывание завершается неудачно. Если таблица обратной записи не существует, будет создана новая таблица обратной записи.

  • Независимо от того, существует ли таблица обратной записи, будет создана новая таблица обратной записи. В этом случае мастер развертывания удаляет любую существующую таблицу и заменяет ее новой таблицей обратной записи.

• Развертывание транзакций . Этот параметр определяет, происходит ли развертывание изменений метаданных и команд обработки в одной транзакции или в отдельных транзакциях.

  • Если этот параметр имеет значение True (по умолчанию), службы SQL Server Analysis Services развертывают все изменения метаданных и все команды процесса в рамках одной транзакции.

  • Если этот параметр имеет значение False, службы SQL Server Analysis Services развёртывание изменений метаданных осуществляется в одной транзакции, а развёртывание каждой команды обработки осуществляется в собственной транзакции.

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

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

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

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

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

  –или–

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

  –или–

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

См. также

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