Устаревшее развертывание пакетов (службы SSIS)
Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure
Службы SQL Server Integration Services включают средства и мастера, которые упрощают развертывание пакетов с компьютера разработчика на рабочий сервер или другие компьютеры.
Процесс развертывания пакетов состоит из четырех шагов.
Первый шаг является необязательным и заключается в создании конфигураций пакетов для обновления свойств элементов пакетов во время выполнения. Настройки будут автоматически включены при развертывании пакета.
Второй шаг — построение проекта Integration Services для создания служебной программы развертывания пакетов. Программа развертывания для проекта содержит пакеты, которые необходимо развернуть.
Третий шаг — копирование папки развертывания, созданной при создании проекта Integration Services, на целевой компьютер.
Четвертый шаг — запуск на целевом компьютере мастера установки пакета, который позволяет установить пакеты в файловую систему или экземпляр SQL Server.
Конфигурации пакета
Службы SQL Server Integration Services содержат конфигурацию пакетов, которую можно использовать для обновления значений свойств во время выполнения.
Примечание.
Доступны конфигурации для модели развертывания пакетов. Для моделей развертывания проектов вместо конфигураций используются параметры. Модель развертывания проектов позволяет развертывать проекты Integration Services на сервере Integration Services. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.
Конфигурация представляет собой пару вида «свойство-значение», которая добавляется к завершенному пакету. Обычно свойства пакета устанавливаются в объектах пакета во время его разработки, а затем к пакету добавляется конфигурация. При выполнении пакета он получает новые значения свойств из конфигурации. Например, с помощью конфигурации можно изменить строку соединения в диспетчере соединений или обновить значение переменной.
Конфигурации пакета дают следующие преимущества.
Конфигурации облегчают перенос пакетов из среды разработки в рабочую среду. Например, конфигурация может обновить путь к исходному файлу или изменить имя базы данных или сервера.
Конфигурации полезны при развертывании пакетов на множестве разных серверов. Например, переменная в конфигурации каждого развернутого пакета может иметь различное значение места на диске; если доступное место на диске не соответствует этому значению, данный пакет не запускается.
Конфигурации делают пакеты более гибкими. Например, конфигурация может обновить значение переменной, используемой в выражении свойства.
Службы Integration Services поддерживают несколько разных методов хранения конфигураций пакетов, таких как XML-файлы, таблицы в базе данных SQL Server, переменные среды и пакета.
Каждая конфигурация является парой вида «свойство-значение». XML-файл конфигурации и типы конфигурации SQL Server могут включать несколько конфигураций.
Конфигурации включаются при создании программы развертывания для установки пакетов. При установке пакета обновление конфигураций может быть одним из этапов установки.
Основные сведения о применении параметров конфигурации пакетов во время выполнения
Если для выполнения развернутого пакета используется программа командной строки dtexec (dtexec.exe), эта программа применяет параметры конфигурации пакета дважды. до и после применения настроек, указанных в командной строке.
Когда программа загружает и выполняет пакет, события происходят в следующем порядке.
Программа dtexec загружает пакет.
Программа применяет параметры конфигурации, заданные в пакете во время разработки, в порядке, который указан в пакете. (Единственным исключением являются конфигурации переменных родительского пакета. Служебная программа применяет эти конфигурации только один раз и позже в процессе.)
Затем программа применяет параметры, указанные в командной строке.
Затем программа повторно загружает параметры конфигурации, заданные в пакете во время разработки, в порядке, который указан в пакете. (Исключением из этого правила вновь являются параметры конфигурации переменных родительского пакета.) Программа применяет указанные параметры командной строки для повторной загрузки параметров конфигурации. Поэтому возможна повторная загрузка различных значений из различных расположений.
Программа применяет параметры конфигурации переменных родительского пакета.
Программа выполняет пакет.
Способ, которым программа dtexec применяет параметры конфигурации, влияет на следующие параметры командной строки:
Во время выполнения можно использовать параметр /Connection или /Set , чтобы загрузить параметры конфигурации пакета из расположения, отличного от указанного во время разработки.
С помощью параметра /ConfigFile можно загрузить дополнительные конфигурации, не указанные во время разработки.
Однако к этим параметрам командной строки применяются некоторые ограничения.
Нельзя использовать параметр /Set или /Connection для переопределения единичных значений, которые также задаются конфигурацией.
Нельзя использовать параметр /ConfigFile для загрузки конфигураций, которые заменяют параметры, указанные во время разработки.
Дополнительные сведения об этих параметрах и о том, как поведение этих параметров отличается в SQL Server 2019 Integration Services (SSIS) и более ранних версиях, см. в статье Изменение поведения функций Integration Services в SQL Server 2016.
Типы конфигураций пакета
Следующая таблица описывает типы конфигураций пакета.
Тип | Описание |
---|---|
XML-файл конфигурации | XML-файл содержит конфигурации. XML-файл может включать несколько конфигураций. |
Переменная среды | Переменная среды содержит конфигурацию. |
Параметр реестра | Параметр реестра содержит конфигурацию. |
Переменная родительского пакета | Переменная пакета содержит конфигурацию. Этот тип конфигурации обычно используется для обновления свойств вызываемых пакетов. |
Таблица SQL Server | Таблица в базе данных SQL Server содержит конфигурацию. Таблица может включать несколько конфигураций. |
XML-файлы конфигурации
Выбрав тип конфигурации XML-файл конфигурации , можно создать новый файл конфигурации, использовать существующий и добавить новые конфигурации или использовать существующий и перезаписать его содержимое.
XML-файл конфигурации содержит следующие два раздела.
Заголовок, содержащий сведения о файле конфигурации. Этот элемент включает атрибуты, такие как дата создания файла и имя создателя файла.
Элементы конфигурации, содержащие сведения о каждой конфигурации. Этот элемент включает атрибуты, такие как путь свойства и заданное значение свойства.
Следующий программный код на языке XML показывает синтаксис XML-файла конфигурации. В этом примере показана конфигурация свойства Value для целочисленной переменной с именем MyVar
.
\<?xml version="1.0"?>
<DTSConfiguration>
<DTSConfigurationHeading>
<DTSConfigurationFileInfo
GeneratedBy="DomainName\UserName"
GeneratedFromPackageName="Package"
GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"
GeneratedDate="2/01/2005 5:58:09 PM"/>
</DTSConfigurationHeading>
<Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">
<ConfiguredValue>0</ConfiguredValue>
</Configuration>
</DTSConfiguration>
Параметр реестра
Если для хранения конфигурации нужно использовать параметр реестра, то можно либо использовать существующий раздел, либо создать новый подраздел в разделе HKEY_CURRENT_USER
. Используемый раздел реестра должен иметь значение с именем Value. Значение может иметь строковый тип или тип DWORD.
Если выбран тип конфигурации Запись реестра, необходимо ввести имя раздела реестра в соответствующее поле. Формат — <раздел реестра>. Если нужно использовать раздел реестра, корневым разделом которого является не HKEY_CURRENT_USER
, то для его задания используйте формат <Раздел реестра\раздел реестра...>>. Например, чтобы использовать раздел MyPackage, расположенный в разделе SSISPackages, введите SSISPackages\MyPackage.
SQL Server
При выборе типа конфигурации SQL Server устанавливается подключение к базе данных SQL Server, в которой необходимо хранить конфигурации. Можно сохранить конфигурации в существующей таблице или создать новую в указанной базе данных.
Следующая инструкция SQL показывает применяемую по умолчанию инструкцию CREATE TABLE, которую предоставляет мастер настройки пакета.
CREATE TABLE [dbo].[SSIS Configurations]
(
ConfigurationFilter NVARCHAR(255) NOT NULL,
ConfiguredValue NVARCHAR(255) NULL,
PackagePath NVARCHAR(255) NOT NULL,
ConfiguredValueType NVARCHAR(20) NOT NULL
)
Имя, задаваемое для конфигурации, является значением, которое хранится в столбце ConfigurationFilter .
Прямые и косвенные конфигурации
Службы Integration Services предоставляют прямые и косвенные конфигурации. Если задать конфигурации напрямую, службы Integration Services создадут прямую связь между элементом конфигурации и свойством объекта пакета. Прямые конфигурации используются в том случае, когда местоположение источника не меняется. Например, если пользователь уверен, что все развертываемые элементы пакета используют один и тот же путь к файлу, можно задать XML-файл конфигурации.
Косвенные конфигурации используют переменные среды. Конфигурация указывает на переменную среды, содержащую значение конфигурации, вместо задания значения конфигурации напрямую. Использовать косвенные конфигурации лучше в случае, когда местоположение конфигурации меняется для каждого развертываемого пакета.
Создание конфигурации пакетов
Создайте конфигурации пакетов с помощью диалогового окна Организатор конфигураций пакетов , а также мастера настройки пакетов. Для доступа к этим средствам выберите Конфигурация пакетов в меню SSIS в SQL Server Data Tools (SSDT).
Примечание.
Можно также открыть Организатор конфигураций пакета , нажав кнопку с многоточием рядом со свойством Конфигурация . Свойство «Конфигурация» отображается в окне свойств пакета.
Доступны конфигурации для модели развертывания пакетов. Для моделей развертывания проектов вместо конфигураций используются параметры. Модель развертывания проектов позволяет развертывать проекты Integration Services на сервере Integration Services. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.
В окне Организатор конфигураций пакетов можно разрешить пакетам использовать, добавить и удалить конфигурации, а также настроить порядок загрузки конфигураций.
При загрузке в указанном порядке конфигурации загружаются с верхней части списка, показанного в диалоговом окне Организатор конфигураций пакетов , в нижнюю часть списка. Однако во время выполнения конфигурации пакетов могут загружаться в другом порядке. В частности, конфигурации родительских пакетов загружаются после всех остальных конфигураций.
Если для одного свойства объекта задано несколько конфигураций, то при запуске будет загружаться значение, которое применялось в прошлый раз.
В окне Организатор конфигураций пакетов можно запускать мастер настройки пакетов, с помощью которого создаются конфигурации. Чтобы запустить мастер настройки пакетов, добавьте новую конфигурацию в диалоговом окне Организатор конфигураций пакетов или измените существующую конфигурацию. На страницах мастера предлагается выбрать тип конфигурации, способ доступа к ней (напрямую или с помощью переменных среды), а также свойства, которые будут сохранены в конфигурации.
Следующий пример демонстрирует целевые свойства переменных и пакетов в том порядке, в котором они появляются на странице «Завершение работы мастера» мастера настройки пакета:
\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]
\Package.Properties[MaximumErrorCount]
\Package.Properties[LoggingMode]
\Package.Properties[LocaleID]
\Package\My SQL Task.Variables[User::varTableName].Properties[Value]
В этом примере конфигурация обновляет следующие свойства:
Свойство RaiseChangedEvent пользовательской переменной
TodaysDate
.Свойства MaximumErrorCount, LoggingMode и LocaleID пакета.
Свойство Value пользовательской переменной
varTableName
в рамках области задачи "My SQL Task".
«\Package» представляет собой корневой каталог, а точки (.) разделяют объекты, определяющие путь к свойству, которое изменяет конфигурация. Имена переменных и свойств заключаются в скобки. Термин «Package» всегда используется в конфигурациях, независимо от имени пакета; тем не менее, другие объекты в пути используют пользовательские имена.
После окончания работы мастера новая конфигурация добавляется в список конфигураций в диалоговом окне Организатор конфигураций пакетов .
Примечание.
Последняя страница мастера настройки пакета перечисляет целевые свойства в конфигурации. Если во время запуска пакета с помощью программы командной строки dtexec необходимо изменить его свойства, можно сформировать строки, представляющие пути свойства, запустив мастер настройки пакетов, а затем скопировав и вставив их в окно командной строки, чтобы использовать в качестве параметров программы dtexec.
В приведенной ниже таблице описаны столбцы списка конфигураций в диалоговом окне Организатор конфигураций пакетов .
Столбец | Description |
---|---|
Имя конфигурации | Имя конфигурации. |
Тип конфигурации | Тип конфигурации. |
Строка конфигурации | Расположение конфигурации. Расположением может быть путь, переменная среды, раздел реестра, имя переменной в родительском пакете или таблица в базе данных SQL Server. |
Целевой объект | Имя объекта со свойством, у которого есть конфигурация. Если конфигурация является XML-файлом конфигурации, столбец остается пустым, потому что конфигурация может обновлять несколько объектов. |
Целевое свойство | Имя свойства. Если конфигурация записывается в XML-файл конфигурации или таблицу SQL Server, столбец остается пустым, потому что конфигурация может обновлять несколько объектов. |
Создание конфигурации пакета
В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.
Чтобы открыть пакет, дважды щелкните его в обозревателе решений.
В конструкторе SSIS перейдите на вкладку Поток управления, Поток данных, Обработчики события или Обозреватель пакетов.
В меню Службы SSIS выберите команду Конфигурации пакетов.
В диалоговом окне Организатор конфигураций пакетов выберите Включить конфигурации пакетов и нажмите кнопку Добавить.
На странице приветствия мастера настройки пакета нажмите кнопку Далее.
На странице «Выбор типа конфигурации» следует выбрать тип конфигурации и установить свойства, относящиеся к этому типу конфигурации. Дополнительные сведения см. в статье Справочник по пользовательскому интерфейсу мастера конфигурации пакетов.
На странице «Выбор свойств для экспорта» выберите свойства объектов пакетов, которые будут включены в конфигурацию. Если тип конфигурации поддерживает только одно свойство, заголовком текущей страницы мастера будет «Выбор целевого свойства». Дополнительные сведения см. в статье Справочник по пользовательскому интерфейсу мастера конфигурации пакетов.
Примечание.
Только конфигурации типов XML-файл конфигурации и SQL Server поддерживают включение нескольких свойств в конфигурацию.
На странице "Завершение работы мастера" введите имя конфигурации и нажмите кнопку Готово.
Просмотрите конфигурацию в диалоговом окне Организатор конфигураций пакетов .
Выберите Закрыть.
Организатор конфигураций пакетов
Диалоговое окно Организатор конфигураций пакетов используется для включения конфигураций пакетов, просмотра списка конфигураций для текущего пакета, а также для указания порядка, в котором следует загружать конфигурации.
Примечание.
Доступны конфигурации для модели развертывания пакетов. Для моделей развертывания проектов вместо конфигураций используются параметры. Модель развертывания проектов позволяет развертывать проекты Integration Services на сервере Integration Services. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.
Если несколько конфигураций обновляют одно и то же свойство, то значения из конфигураций, расположенных в нижней части списка, заменят значения из конфигураций, расположенных в верхней части списка. Последнее значение, загружаемое в свойства, является значением, которое используется при выполнении пакета. Кроме того, если пакет использует сочетание прямой конфигурации, например XML-файла конфигурации, и непрямой конфигурации, например переменной среды, то непрямая конфигурация, указывающая на расположение прямой конфигурации, должна располагаться выше в списке.
Примечание.
При загрузке в указанном порядке конфигурации загружаются с верхней части списка, показанного в диалоговом окне Организатор конфигураций пакетов , в нижнюю часть списка. Однако во время выполнения конфигурации пакетов могут загружаться в другом порядке. В частности, конфигурации родительских пакетов загружаются после всех остальных конфигураций.
Конфигурации пакета обновляют значения свойств объектов пакета во время выполнения. После загрузки пакета значения, полученные из конфигураций, заменяют значения, установленные при разработке пакета. Службы Integration Services поддерживают разные типы конфигурации. Например, можно использовать XML-файл, содержащий несколько конфигураций, или переменную среды, содержащую всего одну конфигурацию. Дополнительные сведения см. в статье Package Configurations.
Параметры
Включить конфигурацию пакетов
Выберите, чтобы использовать конфигурации с пакетом.
Имя конфигурации
Просмотр имени конфигурации.
Тип конфигурации
Просмотр типа месторасположения конфигураций.
Строка конфигурации
Просмотр расположения значений конфигураций. Расположением может быть путь к файлу, имя переменной среды, имя переменной родительского пакета, раздел реестра или имя таблицы SQL Server.
Целевой объект
Просмотр имени объекта, обновляемого конфигурацией. Если конфигурация является XML-файлом конфигурации или таблицей SQL Server, столбец остается пустым, потому что конфигурация может содержать несколько объектов.
Целевое свойство
Просмотр имени свойства, измененного конфигурацией. Этот столбец пустой, если тип конфигурации поддерживает одновременно несколько конфигураций.
Прибавить
Добавление конфигурации с помощью мастера настройки пакета.
Изменить
Редактирование существующей конфигурации при помощи перезапуска мастера настройки пакета.
Удалить
Выберите конфигурацию, а затем нажмите кнопку Удалить.
Стрелки
Выберите конфигурацию и, используя стрелки вверх и вниз, переместите ее вверх или вниз в списке. Конфигурации загружаются в последовательности, указанной в списке.
Справочник по пользовательскому интерфейсу мастера конфигурации пакетов
Мастер настройки пакета используется для создания конфигураций, обновляющих свойства пакета Integration Services и его объекты во время выполнения. Мастер запускается при добавлении новой конфигурации или изменении существующей в диалоговом окне Организатор конфигураций пакетов . Для открытия диалогового окна Организатор конфигураций пакетов выберите Конфигурации пакета в меню SSIS в SQL Server Data Tools (SSDT). Дополнительные сведения см. в разделе Создание конфигурации пакетов.
Примечание.
Доступны конфигурации для модели развертывания пакетов. Для моделей развертывания проектов вместо конфигураций используются параметры. Модель развертывания проектов позволяет развертывать проекты Integration Services на сервере Integration Services. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.
В следующих разделах описаны страницы мастера.
Страница приветствия мастера настройки пакета
Мастер настройки служб SSIS используется для создания конфигураций, обновляющих свойства пакета и его объекты во время выполнения.
Параметры
Больше не показывать это окно
Пропустить страницу приветствия при следующем запуске мастера.
Далее
Перейти на следующую страницу мастера.
Страница «Выбор типа конфигурации»
Страница Выбор типа конфигурации позволяет указать тип создаваемой конфигурации.
Если требуются дополнительные сведения для определения того, какой тип конфигурации должен использоваться, см. раздел Package Configurations.
Статические параметры
Тип конфигурации
С помощью следующих параметров выберите тип источника, в котором будет храниться конфигурация:
значение | Описание |
---|---|
XML-файл конфигурации | Конфигурация хранится в виде XML-файла. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации. |
Переменная среды | Конфигурация хранится в одной из переменных среды. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации. |
Параметр реестра | Храните конфигурацию в реестре. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации. |
Переменная родительского пакета | Конфигурация хранится в переменной пакета, который содержит задачу. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации. |
SQL Server | Конфигурация хранится в таблице в SQL Server. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации. |
Далее
Позволяет перейти к следующей странице мастера.
Динамические параметры
Тип конфигурации — XML-файл конфигурации
Указать параметры конфигурации непосредственно
Позволяет непосредственно указать параметры конфигурации.
значение | Описание |
---|---|
Имя файла конфигурации | Введите путь к файлу конфигурации, сформированному мастером. |
Обзор | Диалоговое окно Выбор расположения файла конфигурации позволяет указать путь к файлу конфигурации, сформированному мастером. Если файл отсутствует, мастер создает его. |
Сведения о расположении файла конфигурации хранятся в переменной среды
Позволяет указать переменную среды, в которую записывается конфигурация.
значение | Описание |
---|---|
Переменная среды | Выберите переменную среды из списка. |
Тип конфигурации — переменная среды
Переменная среды
Выберите переменную среды, которая содержит сведения о конфигурации.
Тип конфигурации — запись реестра
Указать параметры конфигурации непосредственно
Позволяет непосредственно указать параметры конфигурации.
значение | Описание |
---|---|
Параметр реестра | Введите раздел реестра, который содержит сведения о конфигурации. Формат — <раздел реестра>. Этот раздел реестра должен уже существовать в кусте HKEY_CURRENT_USER и иметь значение с именем Value. Значение может иметь строковый тип или тип DWORD.Если нужно использовать раздел реестра, корневым разделом которого является не HKEY_CURRENT_USER , то для его задания используйте формат <Раздел реестра\раздел реестра...>>. |
Сведения о расположении файла конфигурации хранятся в переменной среды
Позволяет указать переменную среды, в которую записывается конфигурация.
значение | Описание |
---|---|
Переменная среды | Выберите переменную среды из списка. |
Тип конфигурации — переменная родительского пакета
Указать параметры конфигурации непосредственно
Позволяет непосредственно указать параметры конфигурации.
значение | Описание |
---|---|
Родительская переменная | Укажите переменную родительского пакета, которая содержит сведения о конфигурации. |
Сведения о расположении файла конфигурации хранятся в переменной среды
Позволяет указать переменную среды, в которой хранится конфигурация.
значение | Описание |
---|---|
Переменная среды | Выберите переменную среды из списка. |
Тип конфигурации — SQL Server
Указать параметры конфигурации непосредственно
Позволяет непосредственно указать параметры конфигурации.
значение | Описание |
---|---|
Соединение | Выберите соединение из списка или нажмите Создать, чтобы создать новое соединение. |
Таблица конфигурации | Выберите существующую таблицу или нажмите кнопку Создать, чтобы ввести инструкцию SQL, создающую новую таблицу. |
Фильтр конфигурации | Выберите существующее имя конфигурации или введите новое. В одной и той же таблице можно хранить целый ряд конфигураций SQL Server, причем каждая конфигурация может включать множество элементов конфигурации. Это определяемое пользователем значение хранится в таблице, что позволяет обозначать элементы конфигурации, принадлежащие к конкретной конфигурации |
Сведения о расположении файла конфигурации хранятся в переменной среды
Позволяет указать переменную среды, в которой хранится конфигурация.
значение | Описание |
---|---|
Переменная среды | Выберите переменную среды из списка. |
Страница «Выбор объектов для экспорта»
Страница Выбор целевого свойства или свойств для экспорта используется для указания свойств объекта, включенного в конфигурацию. Возможность выбора нескольких свойств доступна только в случае выбора типа конфигурации XML.
Параметры
Объекты
Позволяет раскрывать иерархию пакетов и выбирать свойства для экспорта.
Атрибуты свойства
Позволяет просматривать атрибуты свойства.
Далее
Перейдите на следующую страницу мастера.
Страница «Завершение работы мастера»
Используйте страницу Завершение работы мастера , чтобы задать имя конфигурации и просмотреть параметры настройки, используемые мастером при создании конфигурации. После завершения работы мастера отображается в Организаторе конфигураций пакетов , который перечисляет все настройки для пакета.
Параметры
Имя конфигурации
Введите имя конфигурации.
Предварительный просмотр
Просмотр параметров настройки, используемых мастером для создания конфигурации.
Готово
Создайте конфигурацию и выйдите из мастера настройки пакета.
Использование значений переменных и параметров в дочернем пакете
Данная процедура описывает создание конфигурации пакета, которая использует тип конфигурации родительской переменной. Данный тип конфигурации, позволяет дочернему пакету, который запускается из родительского, получить доступ к переменной в родительском элементе.
Примечание.
Чтобы передать значения в дочерний пакет, можно настроить задачу «Выполнение пакета» так, чтобы значения стали доступны для дочернего пакета. Для этого переменные, параметры родительского пакета, либо параметры проекта необходимо сопоставить с параметрами дочернего пакета. Дополнительные сведения см. в статье Execute Package Task.
Нет необходимости создавать переменные в родительских пакетах до создания пакета конфигурации в дочернем пакете. Можно добавить переменные в родительский пакет в любое время, но нужно использовать правильное имя родительской переменной в конфигурации пакета. Тем не менее перед созданием конфигурации родительской переменной в дочернем пакете должна быть переменная, изменяемая конфигурацией. Дополнительные сведения о добавлении и настройке переменных см. в разделе Добавление, удаление и изменение области определяемой пользователем переменной в пакете.
Область видимости переменной родительского пакета, которая используется в конфигурации родительской переменной, может быть установлена в задаче «Выполнение пакета», в контейнере задачи или в пакете. Если в пакете имеется несколько переменных с одним именем, используется переменная, наиболее близкая к области задачи «Выполнение пакета». Ближайшей областью к задаче «Выполнение пакета» является сама задача.
Добавление переменной в родительский пакет
В SQL Server Data Tools (SSDT) откройте проект Integration Services, содержащий пакет, в который нужно добавить переменную для передачи в дочерний пакет.
Чтобы открыть пакет, дважды щелкните его в обозревателе решений.
Чтобы определить область переменной в конструкторе служб SSIS, выполните одно из следующих действий:
Чтобы установить в качестве области область пакета, щелкните в любом месте области конструктора на вкладке Поток управления.
Чтобы установить в качестве области родительский контейнер задачи «Выполнение пакета», щелкните этот контейнер.
Для настройки области задачи «Выполнение пакета» щелкните задачу.
Добавьте и настройте переменную.
Примечание.
Выберите тип данных, совместимый с данными, которые хранятся в переменной.
Чтобы сохранить обновленный пакет, выберите пункт Сохранить выбранные элементы в меню Файл.
Добавление переменной в дочерний пакет
В SQL Server Data Tools (SSDT) откройте проект Integration Services, содержащий пакет, в который нужно добавить конфигурацию родительской переменной.
Чтобы открыть пакет, дважды щелкните его в обозревателе решений.
В конструкторе SSIS, чтобы установить область для пакета, щелкните в любом месте области конструктора на вкладке Поток управления.
Добавьте и настройте переменную.
Примечание.
Выберите тип данных, совместимый с данными, которые хранятся в переменной.
Чтобы сохранить обновленный пакет, выберите пункт Сохранить выбранные элементы в меню Файл.
Создание программы развертывания
Первый шаг в развертывании пакетов — создание служебной программы развертывания для проекта Integration Services. Служебная программа развертывания — это папка, которая содержит файлы, требуемые для развертывания пакетов проекта Integration Services на другом сервере. Служебная программа развертывания создается на компьютере, где хранится проект Integration Services.
Чтобы создать служебную программу развертывания пакета для проекта Integration Services, настройте процесс для создания служебной программы, а затем создайте проект. Когда производится построение проекта, все пакеты и их конфигурации в проекте включаются в него автоматически. Для развертывания дополнительных файлов, таких как файл README проекта, поместите файлы в папку Разное проекта Integration Services. Когда проект построен, эти файлы также автоматически включаются в проект.
Можно установить независимое развертывание каждого проекта. Перед построением проекта и созданием программы развертывания пакета можно установить свойства программы развертывания, чтобы определить способ развертывания пакетов в проекте. Например, можно указать, будут ли обновлены конфигурации пакета при развертывании проекта. Для получения доступа к свойствам проекта Integration Services щелкните проект правой кнопкой мыши и выберите Свойства.
В следующей таблице производится перечисление свойств программы развертывания.
Свойство | Description |
---|---|
AllowConfigurationChange | Значение, указывающее, возможно ли обновление конфигураций во время развертывания. |
CreateDeploymentUtility | Значение, указывающее, будет ли во время построения пакета производиться создание программы развертывания. Для создания программы развертывания значение свойства должно быть равно True . |
DeploymentOutputPath | Расположение служебной программы развертывания, соответствующей проекту Integration Services. |
При создании проекта Integration Services файл манифеста — <имя_проекта>.SSISDeploymentManifest.xml — создается и добавляется вместе с копиями пакетов проекта и их зависимостей в папку bin\Deployment проекта или расположение, указанное в свойстве DeploymentOutputPath. Файл манифеста производит перечисление пакетов, их конфигураций, а также иных различных файлов проекта.
Содержимое папки развертывания обновляется каждый раз при построении проекта. Это означает, что любой файл, сохраненный в этой папке, который не копируется снова в эту папку в процессе построения, будет удален. Например, файлы конфигурации пакета, сохраненные в папку развертывания, будут удалены.
Создание программы развертывания пакетов
В SQL Server Data Tools (SSDT) откройте решение с проектом Integration Services, для которого нужно создать служебную программу развертывания.
Щелкните проект правой кнопкой мыши и выберите пункт Свойства.
В диалоговом окне <Страницы свойств >имя проекта выберите элемент Программа развертывания.
Для обновления конфигураций пакета после развертывания пакетов установите значение AllowConfigurationChanges равным True.
Установите значение CreateDeploymentUtility равным True.
При необходимости обновите расположение программы развертывания посредством изменения свойства DeploymentOutputPath .
Нажмите ОК.
В обозревателе решений щелкните правой кнопкой мыши проект и выберите пункт Сборка.
Просмотрите ход компоновки и ошибки в окне Выход .
Развертывание пакетов с помощью программы развертывания
Если сборка служебной программы развертывания, предназначенной для установки пакетов из проекта Integration Services, выполнена на компьютере, отличном от того, на котором находится сам проект, прежде всего необходимо скопировать папку развертывания на целевой компьютер.
Путь к папке развертывания указывается в свойстве DeploymentOutputPath того проекта Integration Services, для которого была создана служебная программа развертывания. По умолчанию папкой развертывания является папка bin\Deployment относительно проекта Integration Services. Дополнительные сведения см. в статье Create a Deployment Utility.
Для установки пакетов используется мастер установки пакетов. Чтобы запустить мастер, дважды щелкните файл программы развертывания после копирования папки развертывания на сервер. Этот файл называется <имя_проекта>.SSISDeploymentManifest и находится в папке развертывания на конечном компьютере.
Примечание.
В зависимости от версии развертываемого пакета, параллельная установка разных версий SQL Server может вызвать ошибку. Эта ошибка может возникнуть из-за того, что расширение имени файла SSISDeploymentManifest одинаково для всех версий Integration Services. Если дважды щелкнуть имя файла, вызывается установщик (dtsinstall.exe) последней установленной версии Integration Services, которая может отличаться от версии файла служебной программы развертывания. Чтобы решить эту проблему, запустите нужную версию dtsinstall.exe из командной строки и укажите путь к файлу программы развертывания.
Мастер установки пакета проведет по всем шагам установки пакетов в файловую систему или в SQL Server. Установку можно настроить следующим образом:
выбрать тип расположения и само расположение для установки пакетов;
выбрать расположение для установки зависимостей пакетов;
проверить пакеты после их установки на целевом сервере.
Файловые зависимости для пакетов всегда устанавливаются в файловую систему. При установке пакета в файловую систему эти зависимости устанавливаются в ту же папку, которая была указана для данного пакета. При установке пакета в SQL Server можно указать папку для хранения файловых зависимостей.
Если данный пакет содержит конфигурации, которые нужно будет изменить на целевом компьютере, значения соответствующих свойств можно изменить в этом мастере.
Помимо установки пакетов с помощью мастера установки пакета их можно копировать и перемещать с помощью программы командной строки dtutil . Дополнительные сведения см. в статье dtutil Utility.
Развертывание пакетов в экземпляре SQL Server
Откройте папку развертывания на целевом компьютере.
Дважды щелкните файл манифеста, <имя_проекта>.SSISDeploymentManifest, чтобы запустить мастер установки пакета.
На странице Установка пакетов служб SSIS выберите параметр Установить на SQL Server .
Можно также установить флажок Проверить пакеты после установки, чтобы проверить правильность пакетов после их установки на целевой сервер.
На странице Выбор целевого сервера SQL Server укажите экземпляр SQL Server для установки пакетов и выберите режим проверки подлинности. При выборе проверки подлинности SQL Server укажите имя пользователя и пароль.
На странице Выбор папки для установки укажите папку в файловой системе, куда будут установлены зависимости пакета.
Если пакет содержит конфигурации, можно изменить его, обновляя значения в списке Значение на странице настройки пакетов.
Если выбрана функция проверки пакетов после установки, посмотрите результаты проверки развернутых пакетов.
Повторное развертывание пакетов
После развертывания проекта может понадобится обновить или расширить функциональные возможности пакета и затем повторно развернуть проект Integration Services, содержащий обновленные пакеты. В рамках процесса повторного развертывания пакетов необходимо просмотреть свойства конфигурации, включенные в программу развертывания. Например, можно запретить изменение конфигурации после повторного развертывания пакета.
Процесс повторного развертывания
После завершения обновления пакетов перестраивается проект, папка развертывания копируется на целевой компьютер и затем повторно запускается мастер установки пакета.
При обновлении нескольких пакетов в проекте развертывание всего пакета может не понадобиться. Для развертывания только нескольких пакетов можно создать новый проект Integration Services, добавить обновленные пакеты в новый проект, а затем создать и развернуть проект. Конфигурации пакетов автоматически копируются с пакетом при добавлении пакета в другой проект.
Справочник по пользовательскому интерфейсу мастера установки пакетов
Используйте мастер установки пакета, чтобы развернуть проект Integration Services, включая пакеты и другие файлы, которые в нем содержатся, а также любые зависимости пакетов.
Прежде чем выполнять развертывание пакетов, можно создать конфигурации, затем выполнить их развертывание вместе с пакетами. Службы Integration Services используют конфигурации для динамического обновления свойств и объектов пакетов во время выполнения. Например, строка соединения OLE DB может быть задана динамически во время выполнения с помощью конфигурации, которая сопоставляет значение и свойство, содержащее строку соединения.
Нельзя запустить мастер установки пакета до тех пор, пока не будут созданы проект Integration Services и служебная программа развертывания. Дополнительные сведения см. в статье Deploy Packages by Using the Deployment Utility.
В следующих разделах описаны страницы мастера.
Страница приветствия мастера установки пакета
Используйте мастер установки пакета, чтобы развернуть проект Integration Services, для которого создается служебная программа развертывания пакета.
Больше не показывать это окно
Выберите этот параметр, чтобы пропустить начальную страницу при повторном запуске мастера.
Далее
Перейдите на следующую страницу мастера.
Готово
Переход на страницу завершения работы мастера установки пакета. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.
Страница настройки пакетов
Используйте страницу Настройка пакетов , чтобы отредактировать конфигурации пакета.
Параметры
Файл конфигурации
Редактируйте содержимое файла конфигурации путем выбора файла из списка.
Связанные разделы: создание конфигураций пакетов
Путь
Просмотр пути к настраиваемому свойству.
Тип
Просмотр типа данных указанного свойства.
Value
Задание значения конфигурации.
Далее
Перейдите на следующую страницу мастера.
Готово
Переход на страницу завершения работы мастера установки пакета. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.
Страница подтверждения установки
Страница Подтверждение установки используется для запуска установки пакетов, для просмотра состояния, а также для просмотра данных, которые мастер будет использовать для установки файлов из указанного проекта.
Далее
Установите пакеты и их зависимости, затем, по окончании установки, перейдите на следующую страницу мастера.
Состояние
Отображается ход установки пакета.
Готово
Перейдите на страницу завершения работы мастера установки пакета. Этот параметр можно использовать после возврата на предыдущие страницы мастера, чтобы просмотреть свой выбор после указания всех необходимых параметров.
Страница развертывания пакетов служб SSIS
Используйте страницу Установка пакетов SSIS, чтобы определить расположение для установки пакетов Integration Services и их зависимостей.
Параметры
Установить в файловую систему
Установить пакеты и зависимости в заданную папку в файловой системе.
Установить на SQL Server
Установите пакеты и зависимости в экземпляр SQL Server. Используйте этот вариант, если SQL Server совместно использует пакеты между несколькими серверами. Все зависимости пакетов устанавливаются в заданную папку файловой системы.
Проверить пакеты после установки
Укажите, необходимо ли проверить пакеты после установки.
Далее
Перейдите на следующую страницу мастера.
Готово
Переход на страницу завершения работы мастера установки пакета. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.
Страница проверки пакетов
Используйте страницу Проверка пакетов для просмотра хода выполнения и результатов проверки пакета.
Далее
Перейдите на следующую страницу мастера.
Страница выбора папки установки
Страница Выбор папки для установки используется для указания папки в файловой системе, в которую будут установлены пакеты и их зависимости.
Параметры
Папка
Позволяет указать путь к папке, в которую будет скопирован пакет и его зависимости.
Обзор
Служит для выбора целевой папки в диалоговом окне Обзор папки .
Далее
Перейдите на следующую страницу мастера.
Готово
Переход на страницу завершения работы мастера установки пакета. Этот параметр следует использовать в случае попадания на данную страницу путем возвращения с последующих страниц мастера для проверки выбранных параметров, если все необходимые параметры были заданы.
Страница выбора целевого сервера SQL Server
Используйте страницу Выбор целевого сервера SQL Server, чтобы определить параметры развертывания пакета в экземпляре SQL Server.
Параметры
Имя сервера
Укажите имя сервера, на котором надо осуществлять развертывание пакетов.
Использовать проверку подлинности Windows
Укажите, использовать ли проверку подлинности Windows при входе на сервер. Для лучшей защиты рекомендуется использовать проверку подлинности Windows.
Использовать проверку подлинности SQL Server
Укажите, должен ли пакет использовать проверку подлинности SQL Server при выполнении входа на сервер. При использовании проверки подлинности SQL Server необходимо указать имя пользователя и пароль.
Имя пользователя
Укажите имя пользователя.
Пароль
Укажите пароль.
Путь пакета
Укажите имя логической папки или введите «/» в качестве папки по умолчанию.
Чтобы выбрать папку в диалоговом окне Пакет служб SSIS, нажмите кнопку Обзор (...). Однако в диалоговом окне отсутствует возможность задать папку по умолчанию. Если необходимо использовать папку по умолчанию, то следует ввести в текстовое поле «/».
Примечание.
Если не ввести допустимый путь пакета, то появится следующее сообщение об ошибке: "Аргументы заданы неправильно".
Шифрование обеспечивается хранением на сервере
Выберите вариант с использованием компонентов безопасности ядра СУБД для защиты пакетов.
Далее
Перейдите на следующую страницу мастера.
Готово
Переход на страницу завершения работы мастера установки пакета. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.
Страница завершения установки пакета
Страница Завершение работы мастера установки пакета используется для просмотра сводки о результатах установки пакетов. На этой странице представлены такие сведения, как имя развертываемого проекта Integration Services, установленные пакеты, файлы конфигурации и расположение установки.
Готово
Для завершения работы мастера нажмите кнопку Готово.