Устаревшее развертывание пакетов (службы SSIS)Legacy Package Deployment (SSIS)

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data FactoryПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factory

Службы SQL ServerSQL Server Службы Integration ServicesIntegration Services включают в себя средства и мастера, которые упрощают развертывание пакетов с компьютера разработчика на рабочий сервер или другие компьютеры.SQL ServerSQL Server Службы Integration ServicesIntegration Services includes tools and wizards that make it simple to deploy packages from the development computer to the production server or to other computers.

Процесс развертывания пакетов состоит из четырех шагов.There are four steps in the package deployment process:

  1. Первый шаг является необязательным и заключается в создании конфигураций пакетов для обновления свойств элементов пакетов во время выполнения.The first step is optional and involves creating package configurations that update properties of package elements at run time. Настройки будут автоматически включены при развертывании пакета.The configurations are automatically included when you deploy the packages.

  2. Второй шаг — построение проекта служб Службы Integration ServicesIntegration Services для создания программы развертывания пакетов.The second step is to build the Службы Integration ServicesIntegration Services project to create a package deployment utility. Программа развертывания для проекта содержит пакеты, которые необходимо развернуть.The deployment utility for the project contains the packages that you want to deploy

  3. Третий шаг — копирование папки развертывания, созданной в ходе построения проекта служб Службы Integration ServicesIntegration Services , на целевой компьютер.The third step is to copy the deployment folder that was created when you built the Службы Integration ServicesIntegration Services project to the target computer.

  4. Четвертый шаг заключается в запуске на целевом компьютере мастера установки пакета, который позволяет установить пакеты в файловую систему или на экземпляр SQL ServerSQL Server.The fourth step is to run, on the target computer, the Package Installation Wizard to install the packages to the file system or to an instance of SQL ServerSQL Server.

Конфигурации пакетовPackage Configurations

Службы SQL ServerSQL Server Службы Integration ServicesIntegration Services содержат конфигурацию пакетов, которую можно использовать для обновления значений свойств во время выполнения.SQL ServerSQL Server Службы Integration ServicesIntegration Services provides package configurations that you can use to update the values of properties at run time.

ПРИМЕЧАНИЕ. Доступны конфигурации для модели развертывания пакетов.NOTE: Configurations are available for the package deployment model. Для моделей развертывания проектов вместо конфигураций используются параметры.Parameters are used in place of configurations for the project deployment model. Модель развертывания проектов позволяет развертывать проекты служб Службы Integration ServicesIntegration Services на сервере служб Службы Integration ServicesIntegration Services .The project deployment model enables you to deploy Службы Integration ServicesIntegration Services projects to the Службы Integration ServicesIntegration Services server. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.For more information about the deployment models, see Deployment of Projects and Packages.

Конфигурация представляет собой пару вида «свойство-значение», которая добавляется к завершенному пакету.A configuration is a property/value pair that you add to a completed package. Обычно свойства пакета устанавливаются в объектах пакета во время его разработки, а затем к пакету добавляется конфигурация.Typically, you create a package set properties on the package objects during package development, and then add the configuration to the package. При выполнении пакета он получает новые значения свойств из конфигурации.When the package runs, it gets the new values of the property from the configuration. Например, с помощью конфигурации можно изменить строку соединения в диспетчере соединений или обновить значение переменной.For example, by using a configuration, you can change the connection string of a connection manager, or update the value of a variable.

Конфигурации пакета дают следующие преимущества.Package configurations provide the following benefits:

  • Конфигурации облегчают перенос пакетов из среды разработки в рабочую среду.Configurations make it easier to move packages from a development environment to a production environment. Например, конфигурация может обновить путь к исходному файлу или изменить имя базы данных или сервера.For example, a configuration can update the path of a source file, or change the name of a database or server.

  • Конфигурации полезны при развертывании пакетов на множестве разных серверов.Configurations are useful when you deploy packages to many different servers. Например, переменная в конфигурации каждого развернутого пакета может иметь различное значение места на диске; если доступное место на диске не соответствует этому значению, данный пакет не запускается.For example, a variable in the configuration for each deployed package can contain a different disk space value, and if the available disk space does not meet this value, the package does not run.

  • Конфигурации делают пакеты более гибкими.Configurations make packages more flexible. Например, конфигурация может обновить значение переменной, используемой в выражении свойства.For example, a configuration can update the value of a variable that is used in a property expression.

Службы Integration ServicesIntegration Services поддерживают несколько различных методов хранения конфигураций пакетов, таких как XML-файлы, таблицы в базе данных SQL ServerSQL Server , переменные среды и пакета.supports several different methods of storing package configurations, such as XML files, tables in a SQL ServerSQL Server database, and environment and package variables.

Каждая конфигурация является парой вида «свойство-значение».Each configuration is a property/value pair. XML-файл конфигурации и SQL ServerSQL Server могут включать несколько конфигураций.The XML configuration file and SQL ServerSQL Server configuration types can include multiple configurations.

Конфигурации включаются при создании программы развертывания для установки пакетов.The configurations are included when you create a package deployment utility for installing packages. При установке пакета обновление конфигураций может быть одним из этапов установки.When you install the packages, the configurations can be updated as a step in the package installation.

Основные сведения о применении параметров конфигурации пакетов во время выполненияUnderstanding How Package Configurations Are Applied at Run Time

Если для выполнения развернутого пакета используется программа командной строки dtexec (dtexec.exe), эта программа применяет параметры конфигурации пакета дважды.When you use the dtexec command prompt utility (dtexec.exe) to run a deployed package, the utility applies package configurations twice. до и после применения настроек, указанных в командной строке.The utility applies configurations both before and after it applies the options that you specified on command line.

Когда программа загружает и выполняет пакет, события происходят в следующем порядке.As the utility loads and runs the package, events occur in the following order:

  1. Программа dtexec загружает пакет.The dtexec utility loads the package.

  2. Программа применяет параметры конфигурации, заданные в пакете во время разработки, в порядке, который указан в пакете.The utility applies the configurations that were specified in the package at design time and in the order that is specified in the package. (Единственным исключением являются параметры конфигурации переменных родительского пакета.(The one exception to this is the Parent Package Variables configurations. Программа применяет их только один раз, в ходе дальнейшего процесса.)The utility applies these configurations only once and later in the process.)

  3. Затем программа применяет параметры, указанные в командной строке.The utility then applies any options that you specified on the command line.

  4. Затем программа повторно загружает параметры конфигурации, заданные в пакете во время разработки, в порядке, который указан в пакете.The utility then reloads the configurations that were specified in the package at design time and in the order specified in the package. (Исключением из этого правила вновь являются параметры конфигурации переменных родительского пакета.)(Again, the exception to this rule is the Parent Package Variables configurations). Программа применяет указанные параметры командной строки для повторной загрузки параметров конфигурации.The utility uses any command-line options that were specified to reload the configurations. Поэтому возможна повторная загрузка различных значений из различных расположений.Therefore, different values might be reloaded from a different location.

  5. Программа применяет параметры конфигурации переменных родительского пакета.The utility applies the Parent Package Variable configurations.

  6. Программа выполняет пакет.The utility runs the package.

Способ, которым программа dtexec применяет параметры конфигурации, влияет на следующие параметры командной строки:The way in which the dtexec utility applies configurations affects the following command-line options:

  • Во время выполнения можно использовать параметр /Connection или /Set , чтобы загрузить параметры конфигурации пакета из расположения, отличного от указанного во время разработки.You can use the /Connection or /Set option at run time to load package configurations from a location other than the location that you specified at design time.

  • С помощью параметра /ConfigFile можно загрузить дополнительные конфигурации, не указанные во время разработки.You can use the /ConfigFile option to load additional configurations that you did not specify at design time.

Однако к этим параметрам командной строки применяются некоторые ограничения.However, these command-line options do have some restrictions:

  • Нельзя использовать параметр /Set или /Connection для переопределения единичных значений, которые также задаются конфигурацией.You cannot use the /Set or the /Connection option to override single values that are also set by a configuration.

  • Нельзя использовать параметр /ConfigFile для загрузки конфигураций, которые заменяют параметры, указанные во время разработки.You cannot use the /ConfigFile option to load configurations that replace the configurations that you specified at design time.

Дополнительные сведения об этих параметрах и о различиях в их работе между службами Службы SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) и более ранними версиями см. в разделе Изменения в работе служб Integration Services в SQL Server 2016.For more information about these options, and how the behavior of these options differs between Службы SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) and earlier versions, see Behavior Changes to Integration Services Features in SQL Server 2016.

Типы конфигураций пакетаPackage Configuration Types

Следующая таблица описывает типы конфигураций пакета.The following table describes the package configuration types.

ТипType ОписаниеDescription
XML-файл конфигурацииXML configuration file XML-файл содержит конфигурации.An XML file contains the configurations. XML-файл может включать несколько конфигураций.The XML file can include multiple configurations.
Переменная средыEnvironment variable Переменная среды содержит конфигурацию.An environment variable contains the configuration.
Параметр реестраRegistry entry Параметр реестра содержит конфигурацию.A Registry entry contains the configuration.
Переменная родительского пакетаParent package variable Переменная пакета содержит конфигурацию.A variable in the package contains the configuration. Этот тип конфигурации обычно используется для обновления свойств вызываемых пакетов.This configuration type is typically used to update properties in child packages.
Таблица SQL ServerSQL ServerSQL ServerSQL Server table Таблица в базе данных SQL ServerSQL Server содержит конфигурацию.A table in a SQL ServerSQL Server database contains the configuration. Таблица может включать несколько конфигураций.The table can include multiple configurations.

XML-файлы конфигурацииXML Configuration Files

Выбрав тип конфигурации XML-файл конфигурации , можно создать новый файл конфигурации, использовать существующий и добавить новые конфигурации или использовать существующий и перезаписать его содержимое.If you select the XML configuration file configuration type, you can create a new configuration file, reuse an existing file and add new configurations, or reuse an existing file but overwrite existing file content.

XML-файл конфигурации содержит следующие два раздела.An XML configuration file includes two sections:

  • Заголовок, содержащий сведения о файле конфигурации.A heading that contains information about the configuration file. Этот элемент включает атрибуты, такие как дата создания файла и имя создателя файла.This element includes attributes such as when the file was created and the name of the person who generated the file.

  • Элементы конфигурации, содержащие сведения о каждой конфигурации.Configuration elements that contain information about each configuration. Этот элемент включает атрибуты, такие как путь свойства и заданное значение свойства.This element includes attributes such as the property path and the configured value of a property.

Следующий программный код на языке XML показывает синтаксис XML-файла конфигурации.The following XML code demonstrates the syntax of an XML configuration file. В этом примере показана конфигурация свойства Value для целочисленной переменной с именем MyVar.This example shows a configuration for the Value property of an integer variable named 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>  
  

Параметр реестраRegistry Entry

Если для хранения конфигурации нужно использовать параметр реестра, то можно либо использовать существующий раздел, либо создать новый подраздел в разделе HKEY_CURRENT_USER.If you want to use a Registry entry to store the configuration, you can either use an existing key or create a new key in HKEY_CURRENT_USER. Используемый раздел реестра должен иметь значение с именем Value.The Registry key that you use must have a value named Value. Значение может иметь строковый тип или тип DWORD.The value can be a DWORD or a string.

Если выбран тип конфигурации Запись реестра , необходимо ввести имя раздела реестра в соответствующее поле.If you select the Registry entry configuration type, you type the name of the Registry key in the Registry entry box. Формат — <registry key>.The format is <registry key>. Если есть необходимость применить раздел реестра, не находящийся в корне куста HKEY_CURRENT_USER, используйте для указания этого раздела формат <Registry key\registry key\...>.If you want to use a Registry key that is not at the root of HKEY_CURRENT_USER, use the format <Registry key\registry key\...> to identify the key. Например, чтобы использовать раздел MyPackage, расположенный в разделе SSISPackages, введите SSISPackages\MyPackage.For example, to use the MyPackage key located in SSISPackages, type SSISPackages\MyPackage.

SQL ServerSQL Server

При выборе типа конфигурации SQL Server задается соединение с базой данных SQL ServerSQL Server , в которой необходимо хранить конфигурации.If you select the SQL Server configuration type, you specify the connection to the SQL ServerSQL Server database in which you want to store the configurations. Можно сохранить конфигурации в существующей таблице или создать новую в указанной базе данных.You can save the configurations to an existing table or create a new table in the specified database.

Следующая инструкция SQL показывает применяемую по умолчанию инструкцию CREATE TABLE, которую предоставляет мастер настройки пакета.The following SQL statement shows the default CREATE TABLE statement that the Package Configuration Wizard provides.

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 .The name that you provide for the configuration is the value stored in the ConfigurationFilter column.

Прямые и косвенные конфигурацииDirect and Indirect Configurations

Службы Integration ServicesIntegration Services предоставляют прямые и косвенные конфигурации.provides direct and indirect configurations. Если задать конфигурации напрямую, службы Службы Integration ServicesIntegration Services создадут прямую связь между элементом конфигурации и свойством объекта пакета.If you specify configurations directly, Службы Integration ServicesIntegration Services creates a direct link between the configuration item and the package object property. Прямые конфигурации используются в том случае, когда местоположение источника не меняется.Direct configurations are a better choice when the location of the source does not change. Например, если пользователь уверен, что все развертываемые элементы пакета используют один и тот же путь к файлу, можно задать XML-файл конфигурации.For example, if you are sure that all deployments in the package use the same file path, you can specify an XML configuration file.

Косвенные конфигурации используют переменные среды.Indirect configurations use environment variables. Конфигурация указывает на переменную среды, содержащую значение конфигурации, вместо задания значения конфигурации напрямую.Instead of specifying the configuration setting directly, the configuration points to an environment variable, which in turn contains the configuration value. Использовать косвенные конфигурации лучше в случае, когда местоположение конфигурации меняется для каждого развертываемого пакета.Using indirect configurations is a better choice when the location of the configuration can change for each deployment of a package.

Создание конфигурации пакетовCreate Package Configurations

Создайте конфигурации пакетов с помощью диалогового окна Организатор конфигураций пакетов , а также мастера настройки пакетов.Create package configurations by using the Package Configuration Organizer dialog box and the Package Configuration Wizard. Для доступа к этим средствам выберите Конфигурация пакетов в меню службы SSIS среды SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).To access these tools, click Package Configurations on the SSIS menu in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).

ПРИМЕЧАНИЯ.NOTES:

Можно также открыть Организатор конфигураций пакета , нажав кнопку с многоточием рядом со свойством Конфигурация .You can also access the Package Configuration Organizer by clicking the ellipsis button next to the Configuration property. Свойство «Конфигурация» отображается в окне свойств пакета.The Configuration property appears in the properties window for the package.

Доступны конфигурации для модели развертывания пакетов.Configurations are available for the package deployment model. Для моделей развертывания проектов вместо конфигураций используются параметры.Parameters are used in place of configurations for the project deployment model. Модель развертывания проектов позволяет развертывать проекты служб Службы Integration ServicesIntegration Services на сервере служб Службы Integration ServicesIntegration Services .The project deployment model enables you to deploy Службы Integration ServicesIntegration Services projects to the Службы Integration ServicesIntegration Services server. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.For more information about the deployment models, see Deployment of Projects and Packages.

В окне Организатор конфигураций пакетов можно разрешить пакетам использовать, добавить и удалить конфигурации, а также настроить порядок загрузки конфигураций.In the Package Configuration Organizer dialog box, you can enable packages to use configurations, add and delete configurations, and set the preferred order in which configurations should be loaded.

При загрузке в указанном порядке конфигурации загружаются с верхней части списка, показанного в диалоговом окне Организатор конфигураций пакетов , в нижнюю часть списка.When package configurations load in the preferred order, configurations load from the top of the list shown in the Package Configuration Organizer dialog box to the bottom of the list. Однако во время выполнения конфигурации пакетов могут загружаться в другом порядке.However, at run time, package configurations might not load in the preferred order. В частности, конфигурации родительских пакетов загружаются после всех остальных конфигураций.In particular, parent package configurations load after configurations of other types.

Если для одного свойства объекта задано несколько конфигураций, то при запуске будет загружаться значение, которое применялось в прошлый раз.If multiple configurations set the same object property, the value loaded last is used at run time.

В окне Организатор конфигураций пакетов можно запускать мастер настройки пакетов, с помощью которого создаются конфигурации.From the Package Configuration Organizer dialog box, you run the Package Configuration Wizard, which guides you through the steps to create a configuration. Чтобы запустить мастер настройки пакетов, добавьте новую конфигурацию в диалоговом окне Организатор конфигураций пакетов или измените существующую конфигурацию.To run the Package Configuration Wizard, add a new configuration in the Package Configurations Organizer dialog box or edit an existing one. На страницах мастера предлагается выбрать тип конфигурации, способ доступа к ней (напрямую или с помощью переменных среды), а также свойства, которые будут сохранены в конфигурации.On the wizard pages, you choose the configuration type, select whether you want to access the configuration directly or use environment variables, and select the properties to save in the configuration.

Следующий пример демонстрирует целевые свойства переменных и пакетов в том порядке, в котором они появляются на странице «Завершение работы мастера» мастера настройки пакета:The following example shows the target properties of a variable and a package as they appear on the Completing the Wizard page of the Package Configuration Wizard.:

\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]

\Package.Properties[MaximumErrorCount]\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]\Package.Properties[LocaleID]

\Package\My SQL Task.Variables[User::varTableName].Properties[Value]\Package\My SQL Task.Variables[User::varTableName].Properties[Value]

В этом примере конфигурация обновляет следующие свойства:In this example, the configuration updates these properties:

  • Свойство RaiseChangedEvent пользовательской переменной TodaysDate.The RaiseChangedEvent property of user-defined variable, TodaysDate.

  • Свойства MaximumErrorCount, LoggingMode и LocaleID пакета.The MaximumErrorCount, LoggingMode, and LocaleID properties of the package.

  • Свойство Value пользовательской переменной varTableNameв рамках области задачи "My SQL Task".The Value property of user-defined variable, varTableName, within scope of the task, My SQL Task.

«\Package» представляет собой корневой каталог, а точки (.) разделяют объекты, определяющие путь к свойству, которое изменяет конфигурация.The "\Package" represents the root, and periods (.) separate the objects that define the path to the property that the configuration updates. Имена переменных и свойств заключаются в скобки.The names of variables and properties are enclosed in brackets. Термин «Package» всегда используется в конфигурациях, независимо от имени пакета; тем не менее, другие объекты в пути используют пользовательские имена.The term Package is always used in configuration, regardless of the package name; however, all other objects in the path use their user-defined names.

После окончания работы мастера новая конфигурация добавляется в список конфигураций в диалоговом окне Организатор конфигураций пакетов .After the wizard finishes, the new configuration is added to the configuration list in the Package Configuration Organizer dialog box.

ПРИМЕЧАНИЕ. Последняя страница мастера настройки пакета перечисляет целевые свойства в конфигурации.NOTE: The last page in the Package Configuration Wizard, Completing the Wizard, lists the target properties in the configuration. Если во время запуска пакета с помощью программы командной строки dtexec необходимо изменить его свойства, можно сформировать строки, представляющие пути свойства, запустив мастер настройки пакетов, а затем скопировав и вставив их в окно командной строки, чтобы использовать в качестве параметров программы dtexec.If you want to update properties when you run packages by using the dtexec command prompt utility, you can generate the strings that represent the property paths by running the Package Configuration Wizard and then copy and paste them into the command prompt window for use with the set option of dtexec.

В приведенной ниже таблице описаны столбцы списка конфигураций в диалоговом окне Организатор конфигураций пакетов .The following table describes the columns in the configuration list in the Package Configuration Organizer dialog box.

СтолбецColumn ОписаниеDescription
Имя конфигурацииConfiguration Name Имя конфигурации.The name of the configuration.
Тип конфигурацииConfiguration Type Тип конфигурации.The configuration type.
Строка конфигурацииConfiguration String Расположение конфигурации.The location of the configuration. Расположением может быть путь, переменная среды, раздел реестра, имя переменной в родительском пакете или таблица в базе данных SQL ServerSQL Server .The location can be a path, an environment variable, a Registry key, a parent package variable name, or a table in a SQL ServerSQL Server database.
Целевой объектTarget Object Имя объекта со свойством, у которого есть конфигурация.The name of the object with a property that has a configuration. Если конфигурация является XML-файлом конфигурации, столбец остается пустым, потому что конфигурация может обновлять несколько объектов.If the configuration is an XML configuration file, the column is blank, because the configuration can update multiple objects.
Целевое свойствоTarget Property Имя свойства.The name of the property. Если конфигурация записывается в XML-файл конфигурации или таблицу SQL Server, столбец остается пустым, потому что конфигурация может обновлять несколько объектов.If the configuration writes to an XML configuration file or a SQL Server table, the column is blank, because the configuration can update multiple objects.

Создание конфигурации пакетаTo create a package configuration

  1. В среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)откройте проект служб Службы Integration ServicesIntegration Services , содержащий необходимый пакет.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Службы Integration ServicesIntegration Services project that contains the package you want.

  2. Чтобы открыть пакет, дважды щелкните его в обозревателе решений.In Solution Explorer, double-click the package to open it.

  3. В конструкторе служб Integration ServicesSSIS перейдите на вкладку Поток управления, Поток данных, Обработчики событияили Обозреватель пакетов .In Integration ServicesSSIS Designer, click the Control Flow, Data Flow, Event Handler, or Package Explorer tab.

  4. В меню Службы SSIS выберите команду Конфигурации пакетов.On the SSIS menu, click Package Configurations.

  5. В диалоговом окне Организатор конфигурации пакетов выберите Включить конфигурации пакетови нажмите кнопку Добавить.In the Package Configuration Organizer dialog box, select Enable package configurations, and then click Add.

  6. На странице приветствия мастера настройки пакетов нажмите кнопку Далее.On the welcome page of the Package Configuration Wizard page, click Next.

  7. На странице «Выбор типа конфигурации» следует выбрать тип конфигурации и установить свойства, относящиеся к этому типу конфигурации.On the Select Configuration Type page, specify the configuration type, and then set the properties that are relevant to the configuration type. Дополнительные сведения см. в статье Справочник по пользовательскому интерфейсу мастера конфигурации пакетов.For more information, see Package Configuration Wizard UI Reference.

  8. На странице «Выбор свойств для экспорта» выберите свойства объектов пакетов, которые будут включены в конфигурацию.On the Select Properties to Export page, select the properties of package objects to include in the configuration. Если тип конфигурации поддерживает только одно свойство, заголовком текущей страницы мастера будет «Выбор целевого свойства».If the configuration type supports only one property, the title of this wizard page is Select Target Property. Дополнительные сведения см. в статье Справочник по пользовательскому интерфейсу мастера конфигурации пакетов.For more information, see Package Configuration Wizard UI Reference.

    ПРИМЕЧАНИЕ. Только конфигурации типов XML-файл конфигурации и SQL Server поддерживают включение нескольких свойств в конфигурацию.NOTE: Only the XML Configuration File and SQL Server configuration types support including multiple properties in a configuration.

  9. На странице "Завершение работы мастера" введите имя конфигурации и нажмите кнопку Готово.On the Completing the Wizard page, type the name of the configuration, and then click Finish.

  10. Просмотрите конфигурацию в диалоговом окне Организатор конфигураций пакетов .View the configuration in the Package Configuration Organizer dialog box.

  11. Щелкните Закрыть.Click Close.

Организатор конфигураций пакетовPackage Configurations Organizer

Диалоговое окно Организатор конфигураций пакетов используется для включения конфигураций пакетов, просмотра списка конфигураций для текущего пакета, а также для указания порядка, в котором следует загружать конфигурации.Use the Package Configurations Organizer dialog box to enable package configurations, view a list of configurations for the current package, and specify the preferred order in which the configurations should be loaded.

ПРИМЕЧАНИЕ. Доступны конфигурации для модели развертывания пакетов.NOTE: Configurations are available for the package deployment model. Для моделей развертывания проектов вместо конфигураций используются параметры.Parameters are used in place of configurations for the project deployment model. Модель развертывания проектов позволяет развертывать проекты служб Службы Integration ServicesIntegration Services на сервере служб Службы Integration ServicesIntegration Services .The project deployment model enables you to deploy Службы Integration ServicesIntegration Services projects to the Службы Integration ServicesIntegration Services server. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.For more information about the deployment models, see Deployment of Projects and Packages.

Если несколько конфигураций обновляют одно и то же свойство, то значения из конфигураций, расположенных в нижней части списка, заменят значения из конфигураций, расположенных в верхней части списка.If multiple configurations update the same property, values from configurations listed lower in the configuration list will replace values from configurations higher in the list. Последнее значение, загружаемое в свойства, является значением, которое используется при выполнении пакета.The last value loaded into the property is the value that is used when the package runs. Кроме того, если пакет использует сочетание прямой конфигурации, например XML-файла конфигурации, и непрямой конфигурации, например переменной среды, то непрямая конфигурация, указывающая на расположение прямой конфигурации, должна располагаться выше в списке.Also, if the package uses a combination of direct configuration such as an XML configuration file and an indirect configuration such as an environment variable, the indirect configuration that points to the location of the direct configuration must be higher in the list.

ПРИМЕЧАНИЕ. При загрузке в указанном порядке конфигурации загружаются с верхней части списка, показанного в диалоговом окне Организатор конфигураций пакетов , в нижнюю часть списка.NOTE: When package configurations load in the preferred order, configurations load from the top of the list shown in the Package Configuration Organizer dialog box to the bottom of the list. Однако во время выполнения конфигурации пакетов могут загружаться в другом порядке.However, at run time, package configurations might not load in the preferred order. В частности, конфигурации родительских пакетов загружаются после всех остальных конфигураций.In particular, Parent Package Configurations load after configurations of other types.

Конфигурации пакета обновляют значения свойств объектов пакета во время выполнения.Package configurations update the values of properties of package objects at run time. После загрузки пакета значения, полученные из конфигураций, заменяют значения, установленные при разработке пакета.When a package is loaded, the values from the configurations replace the values that were set when the package was developed. Службы Integration ServicesIntegration Services поддерживают различные типы конфигураций.supports different configuration types. Например, можно использовать XML-файл, содержащий несколько конфигураций, или переменную среды, содержащую всего одну конфигурацию.For example, you can use an XML file that can contain multiple configurations, or an environment variable that contains a single configuration. Дополнительные сведения см. в статье Package Configurations.For more information, see Package Configurations.

ПараметрыOptions

Включить конфигурацию пакетовEnable package configurations
Выберите, чтобы использовать конфигурации с пакетом.Select to use configurations with the package.

Имя конфигурацииConfiguration Name
Просмотр имени конфигурации.View the name of the configuration.

Тип конфигурацииConfiguration Type
Просмотр типа месторасположения конфигураций.View the type of the location where configurations are stored.

Строка конфигурацииConfiguration String
Просмотр расположения значений конфигураций.View the location where the configuration values are stored. Расположение может представлять собой путь к файлу, имя переменной среды, имя переменной родительского пакета, раздел реестра или имя таблицы SQL ServerSQL Server .The location can be the path of a file, the name of an environment variable, the name of a parent package variable, a Registry key, or the name of a SQL ServerSQL Server table.

Целевой объектTarget Object
Просмотр имени объекта, обновляемого конфигурацией.View the name of the object that the configuration updates. Если конфигурация является XML-файлом конфигурации или таблицей SQL Server, столбец остается пустым, потому что конфигурация может содержать несколько объектов.If the configuration is an XML configuration file or a SQL Server table, the column is blank because the configuration can include multiple objects.

Целевое свойствоTarget Property
Просмотр имени свойства, измененного конфигурацией.View the name of the property modified by the configuration. Этот столбец пустой, если тип конфигурации поддерживает одновременно несколько конфигураций.This column is blank if the configuration type supports multiple configurations.

ДобавлениеAdd
Добавление конфигурации с помощью мастера настройки пакета.Add a configuration by using the Package Configuration Wizard.

Edit (Изменение)Edit
Редактирование существующей конфигурации при помощи перезапуска мастера настройки пакета.Edit an existing configuration by rerunning the Package Configuration Wizard.

УдалитьRemove
Выберите конфигурацию, а затем нажмите кнопку Удалить.Select a configuration, and then click Remove.

СтрелкиArrows
Выберите конфигурацию и, используя стрелки вверх и вниз, переместите ее вверх или вниз в списке.Select a configuration and use the up and down arrows to move it up or down in the list. Конфигурации загружаются в последовательности, указанной в списке.Configurations are loaded in the sequence in which they appear in the list.

Мастер конфигурации пакетов справочника по пользовательскому интерфейсуPackage Configuration Wizard UI Reference

Мастер настройки пакета используется для создания конфигураций, обновляющих свойства пакета служб Службы Integration ServicesIntegration Services и его объекты во время выполнения.Use the Package Configuration Wizard to create configurations that update the properties of an Службы Integration ServicesIntegration Services package and its objects at run time. Мастер запускается при добавлении новой конфигурации или изменении существующей в диалоговом окне Организатор конфигураций пакетов .This wizard runs when you add a new configuration or modify an existing one in the Package Configurations Organizer dialog box. Для открытия диалогового окна Организатор конфигураций пакетов выберите пункт Конфигурации пакета в меню службы SSIS в среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).To open the Package Configurations Organizer dialog box, select Package Configurations on the SSIS menu in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). Дополнительные сведения см. в разделе Создание конфигурации пакетов.For more information, see Create Package Configurations.

ПРИМЕЧАНИЕ. Доступны конфигурации для модели развертывания пакетов.NOTE: Configurations are available for the package deployment model. Для моделей развертывания проектов вместо конфигураций используются параметры.Parameters are used in place of configurations for the project deployment model. Модель развертывания проектов позволяет развертывать проекты служб Службы Integration ServicesIntegration Services на сервере служб Службы Integration ServicesIntegration Services .The project deployment model enables you to deploy Службы Integration ServicesIntegration Services projects to the Службы Integration ServicesIntegration Services server. Дополнительные сведения о моделях развертывания см. в разделе Deployment of Projects and Packages.For more information about the deployment models, see Deployment of Projects and Packages.

В следующих разделах описаны страницы мастера.The following sections describe pages of the Wizard.

Страница приветствия мастера настройки пакетаWelcome to the Package Configuration Wizard Page

Мастер настройки служб SSIS используется для создания конфигураций, обновляющих свойства пакета и его объекты во время выполнения.Use the SSIS Configuration Wizard to create configurations that update the properties of a package and its objects at run time.

ПараметрыOptions

Больше не показывать это окноDon't show this page again
Пропустить страницу приветствия при следующем запуске мастера.Skip the welcome page the next time you open the wizard.

ДальшеNext
Перейти на следующую страницу мастера.Go the next page in the wizard.

Страница «Выбор типа конфигурации»Select Configuration Type Page

Страница Выбор типа конфигурации позволяет указать тип создаваемой конфигурации.Use the Select Configuration Type page to specify the type of configuration to create.

Если требуются дополнительные сведения для определения того, какой тип конфигурации должен использоваться, см. раздел Package Configurations.If you need additional information to determine which type of configuration to use, see Package Configurations.

Статические параметрыStatic Options

Тип конфигурацииConfiguration type
С помощью следующих параметров выберите тип источника, в котором будет храниться конфигурация:Select the type of source in which to store the configuration, using the following options:

ЗначениеValue ОписаниеDescription
XML-файл конфигурацииXML configuration file Конфигурация хранится в виде XML-файла.Store the configuration as an XML file. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации.Selecting this value displays the dynamic options in the section, Configuration Type.
Переменная средыEnvironment variable Конфигурация хранится в одной из переменных среды.Store the configuration in one of the environment variables. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации.Selecting this value displays the dynamic options in the section, Configuration Type.
Параметр реестраRegistry entry Храните конфигурацию в реестре.Store the configuration in the Registry. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации.Selecting this value displays the dynamic options in the section, Configuration Type.
Переменная родительского пакетаParent package variable Конфигурация хранится в переменной пакета, который содержит задачу.Store the configuration as a variable in the package that contains the task. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации.Selecting this value displays the dynamic options in the section, Configuration Type.
SQL ServerSQL Server Конфигурация хранится в таблице SQL ServerSQL Server.Store the configuration in a table in SQL ServerSQL Server. При выборе этого значения отображаются динамические параметры в данном разделе, Тип конфигурации.Selecting this value displays the dynamic options in the section, Configuration Type.

ДальшеNext
Позволяет перейти к следующей странице мастера.View the next page in the wizard sequence.

Динамические параметрыDynamic Options

Тип конфигурации — XML-файл конфигурацииConfiguration Type Option = XML Configuration File

Указать параметры конфигурации непосредственноSpecify configuration settings directly
Позволяет непосредственно указать параметры конфигурации.Use to specify settings directly.

ЗначениеValue ОписаниеDescription
Имя файла конфигурацииConfiguration file name Введите путь к файлу конфигурации, сформированному мастером.Type the path of the configuration file that the wizard generates.
ОбзорBrowse Диалоговое окно Выбор расположения файла конфигурации позволяет указать путь к файлу конфигурации, сформированному мастером.Use the Select Configuration File Location dialog box to specify the path of the configuration file that the wizard generates. Если файл отсутствует, мастер создает его.If the file does not exist, it is created by the wizard.

Сведения о расположении файла конфигурации хранятся в переменной средыConfiguration location is stored in an environment variable
Позволяет указать переменную среды, в которую записывается конфигурация.Use to specify the environment variable in which to store the configuration.

ЗначениеValue ОписаниеDescription
Переменная средыEnvironment variable Выберите переменную среды из списка.Select an environment variable from the list.
Тип конфигурации — переменная средыConfiguration Type Option = Environment Variable

Переменная средыEnvironment variable
Выберите переменную среды, которая содержит сведения о конфигурации.Select the environment variable that contains the configuration information.

Тип конфигурации — запись реестраConfiguration Type Option = Registry Entry

Указать параметры конфигурации непосредственноSpecify configuration settings directly
Позволяет непосредственно указать параметры конфигурации.Use to specify settings directly.

ЗначениеValue ОписаниеDescription
Параметр реестраRegistry entry Введите раздел реестра, который содержит сведения о конфигурации.Type the Registry key that contains the configuration information. Формат — <registry key>.The format is <registry key>.

Этот раздел реестра должен уже существовать в кусте HKEY_CURRENT_USER и иметь значение с именем Value.The Registry key must already exist in HKEY_CURRENT_USER and have a value named Value. Значение может иметь строковый тип или тип DWORD.The value can be a DWORD or a string.

Если есть необходимость применить раздел реестра, не находящийся в корне куста HKEY_CURRENT_USER, используйте для указания этого раздела формат <Registry key\registry key\...>.If you want to use a Registry key is not at the root of HKEY_CURRENT_USER, use the format <Registry key\registry key\...> to identify the key.

Сведения о расположении файла конфигурации хранятся в переменной средыConfiguration location is stored in an environment variable
Позволяет указать переменную среды, в которую записывается конфигурация.Use to specify the environment variable to store the configuration in.

ЗначениеValue ОписаниеDescription
Переменная средыEnvironment variable Выберите переменную среды из списка.Select an environment variable from the list.
Тип конфигурации — переменная родительского пакетаConfiguration Type Option = Parent Package Variable

Указать параметры конфигурации непосредственноSpecify configuration settings directly
Позволяет непосредственно указать параметры конфигурации.Use to specify settings directly.

ЗначениеValue ОписаниеDescription
Родительская переменнаяParent variable Укажите переменную родительского пакета, которая содержит сведения о конфигурации.Specify the variable in the parent package that contains the configuration information.

Сведения о расположении файла конфигурации хранятся в переменной средыConfiguration location is stored in an environment variable
Позволяет указать переменную среды, в которой хранится конфигурация.Use to specify the environment variable that stores the configuration.

ЗначениеValue ОписаниеDescription
Переменная средыEnvironment variable Выберите переменную среды из списка.Select an environment variable from the list.
Тип конфигурации — SQL ServerConfiguration Type Options = SQL Server

Указать параметры конфигурации непосредственноSpecify configuration settings directly
Позволяет непосредственно указать параметры конфигурации.Use to specify settings directly.

ЗначениеValue ОписаниеDescription
СоединениеConnection Выберите соединение из списка или нажмите Создать , чтобы создать новое соединение.Select a connection from the list, or click New to create a new connection.
Таблица конфигурацииConfiguration table Выберите существующую таблицу или нажмите кнопку Создать , чтобы ввести инструкцию SQL, создающую новую таблицу.Select an existing table, or click New to write a SQL statement that creates a new table.
Фильтр конфигурацииConfiguration filter Выберите существующее имя конфигурации или введите новое.Select an existing configuration name or type a new name.

В одной и той же таблице можно хранить целый ряд конфигураций SQL Server, причем каждая конфигурация может включать множество элементов конфигурации.Many SQL Server configurations can be stored in the same table, and each configuration can include multiple configuration items.

Это определяемое пользователем значение хранится в таблице, что позволяет обозначать элементы конфигурации, принадлежащие к конкретной конфигурацииThis user-defined value is stored in the table to identify configuration items that belong to a particular configuration

Сведения о расположении файла конфигурации хранятся в переменной средыConfiguration location is stored in an environment variable
Позволяет указать переменную среды, в которой хранится конфигурация.Use to specify the environment variable where the configuration is stored.

ЗначениеValue ОписаниеDescription
Переменная средыEnvironment variable Выберите переменную среды из списка.Select an environment variable from the list.

Страница «Выбор объектов для экспорта»Select Objects to Export Page

Страница Выбор целевого свойства или свойств для экспорта используется для указания свойств объекта, включенного в конфигурацию.Use the Select Target Property or Select Properties to Export page to specify the object properties that the configuration contains. Возможность выбора нескольких свойств доступна только в случае выбора типа конфигурации XML.The ability to select multiple properties is available only if you select the XML configuration type.

ПараметрыOptions

ОбъектыObjects
Позволяет раскрывать иерархию пакетов и выбирать свойства для экспорта.Expand the package hierarchy and select the properties to export.

Атрибуты свойстваProperty attributes
Позволяет просматривать атрибуты свойства.View the attributes of a property.

ДальшеNext
Перейдите на следующую страницу мастера.Go to the next page in the wizard.

Страница «Завершение работы мастера»Completing the Wizard Page

Используйте страницу Завершение работы мастера , чтобы задать имя конфигурации и просмотреть параметры настройки, используемые мастером при создании конфигурации.Use the Completing the Wizard page to provide a name for the configuration and view settings used by the wizard to create the configuration. После завершения работы мастера отображается в Организаторе конфигураций пакетов , который перечисляет все настройки для пакета.After the wizard completes, the Package Configurations Organizer is displayed, which lists all configurations for the package.

ПараметрыOptions

Имя конфигурацииConfiguration name
Введите имя конфигурации.Type the name of the configuration.

Предварительный просмотрPreview
Просмотр параметров настройки, используемых мастером для создания конфигурации.View the settings used by the wizard to create the configuration.

ГотовоFinish
Создайте конфигурацию и выйдите из мастера настройки пакета.Create the configuration and exit the Package Configuration Wizard.

Использование значений переменных и параметров в дочернем пакетеUse the Values of Variables and Parameters in a Child Package

Данная процедура описывает создание конфигурации пакета, которая использует тип конфигурации родительской переменной.This procedure describes how to create a package configuration that uses the parent variable configuration type. Данный тип конфигурации, позволяет дочернему пакету, который запускается из родительского, получить доступ к переменной в родительском элементе.This configuration type enables a child package that is run from a parent package to access a variable in the parent.

Примечание

Чтобы передать значения в дочерний пакет, можно настроить задачу «Выполнение пакета» так, чтобы значения стали доступны для дочернего пакета. Для этого переменные, параметры родительского пакета, либо параметры проекта необходимо сопоставить с параметрами дочернего пакета.You can also pass values to a child package by configuring the Execute Package Task to map parent package variables or parameters, or project parameters, to child package parameters. Дополнительные сведения см. в статье Execute Package Task.For more information, see Execute Package Task.

Нет необходимости создавать переменные в родительских пакетах до создания пакета конфигурации в дочернем пакете.It is not necessary to create the variable in the parent package before you create the package configuration in the child package. Можно добавить переменные в родительский пакет в любое время, но нужно использовать правильное имя родительской переменной в конфигурации пакета.You can add the variable to the parent package at any time, but you must use the exact name of the parent variable in the package configuration. Тем не менее перед созданием конфигурации родительской переменной в дочернем пакете должна быть переменная, изменяемая конфигурацией.However, before you can create a parent variable configuration, there must be an existing variable in the child package that the configuration can update. Дополнительные сведения о добавлении и настройке переменных см. в разделе Добавление, удаление и изменение области определяемой пользователем переменной в пакете.For more information about adding and configuring variables, see Add, Delete, Change Scope of User-Defined Variable in a Package.

Область видимости переменной родительского пакета, которая используется в конфигурации родительской переменной, может быть установлена в задаче «Выполнение пакета», в контейнере задачи или в пакете.The scope of the variable in the parent package that is used in a parent variable configuration can be set to the Execute Package task, to the container that has the task, or to the package. Если в пакете имеется несколько переменных с одним именем, используется переменная, наиболее близкая к области задачи «Выполнение пакета».If multiple variables with the same name are defined in a package, the variable that is closest in scope to the Execute Package task is used. Ближайшей областью к задаче «Выполнение пакета» является сама задача.The closest scope to the Execute Package task is the task itself.

Добавление переменной в родительский пакетTo add a variable to a parent package

  1. В среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)откройте проект служб Службы Integration ServicesIntegration Services , содержащий пакет, к которому нужно добавить переменную для передачи в дочерний пакет.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Службы Integration ServicesIntegration Services project that contains the package to which you want to add a variable to pass to a child package.

  2. Чтобы открыть пакет, дважды щелкните его в обозревателе решений.In Solution Explorer, double-click the package to open it.

  3. Для определения области переменной в конструкторе служб Integration ServicesSSIS выполните одно из следующих действий.In Integration ServicesSSIS Designer, to define the scope of the variable, do one of the following:

    • Чтобы установить в качестве области область пакета, щелкните в любом месте области конструктора на вкладке Поток управления .To set the scope to the package, click anywhere on the design surface of the Control Flow tab.

    • Чтобы установить в качестве области родительский контейнер задачи «Выполнение пакета», щелкните этот контейнер.To set the scope to a parent container of the Execute Package task, click the container.

    • Для настройки области задачи «Выполнение пакета» щелкните задачу.To set the scope to the Execute Package task, click the task.

  4. Добавьте и настройте переменную.Add and configure a variable.

    Примечание

    Выберите тип данных, совместимый с данными, которые хранятся в переменной.Select a data type that is compatible with the data that the variable will store.

  5. Чтобы сохранить обновленный пакет, выберите пункт Сохранить выбранные элементы в меню Файл .To save the updated package, click Save Selected Items on the File menu.

Добавление переменной в дочерний пакетTo add a variable to a child package

  1. В среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)откройте проект служб Службы Integration ServicesIntegration Services с пакетом, в который необходимо вставить конфигурацию родительской переменной.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Службы Integration ServicesIntegration Services project that contains the package to which you want to add a parent variable configuration.

  2. Чтобы открыть пакет, дважды щелкните его в обозревателе решений.In Solution Explorer, double-click the package to open it.

  3. Чтобы установить в качестве области область пакета, щелкните в любом месте конструктора служб Integration ServicesSSIS на вкладке Поток управления .In Integration ServicesSSIS Designer, to set the scope to the package, click anywhere on the design surface of the Control Flow tab.

  4. Добавьте и настройте переменную.Add and configure a variable.

    Примечание

    Выберите тип данных, совместимый с данными, которые хранятся в переменной.Select a data type that is compatible with the data that the variable will store.

  5. Чтобы сохранить обновленный пакет, выберите пункт Сохранить выбранные элементы в меню Файл .To save the updated package, click Save Selected Items on the File menu.

Create a Deployment UtilityCreate a Deployment Utility

Первый шаг в развертывании пакетов — это создание программы развертывания для проекта служб Службы Integration ServicesIntegration Services .The first step in deploying packages is to create a deployment utility for an Службы Integration ServicesIntegration Services project. Программа развертывания — это папка, которая содержит файлы, требуемые для развертывания пакетов проекта служб Службы Integration ServicesIntegration Services на другом сервере.The deployment utility is a folder that contains the files you need to deploy the packages in an Службы Integration ServicesIntegration Services project on a different server. Программа развертывания создается на компьютере, где хранится проект служб Службы Integration ServicesIntegration Services .The deployment utility is created on the computer on which the Службы Integration ServicesIntegration Services project is stored.

Создание программы развертывания пакета для проекта служб Службы Integration ServicesIntegration Services начинается с настройки конфигурации процесса построения для его создания, и затем построения самого проекта.You create a package deployment utility for an Службы Integration ServicesIntegration Services project by first configuring the build process to create a deployment utility, and then building the project. Когда производится построение проекта, все пакеты и их конфигурации в проекте включаются в него автоматически.When you build the project, all packages and package configurations in the project are automatically included. Для развертывания дополнительных файлов, таких как файл Readme проекта, поместите файлы в папку Разное проекта служб Службы Integration ServicesIntegration Services .To deploy additional files such as a Readme file with the project, place the files in the Miscellaneous folder of the Службы Integration ServicesIntegration Services project. Когда проект построен, эти файлы также автоматически включаются в проект.When the project is built, these files are also automatically included.

Можно установить независимое развертывание каждого проекта.You can configure each project deployment differently. Перед построением проекта и созданием программы развертывания пакета можно установить свойства программы развертывания, чтобы определить способ развертывания пакетов в проекте.Before you build the project and create the package deployment utility, you can set the properties on the deployment utility to customize the way the packages in the project will be deployed. Например, можно указать, будут ли обновлены конфигурации пакета при развертывании проекта.For example, you can specify whether package configurations can be updated when the project is deployed. Для получения доступа к свойствам проекта служб Службы Integration ServicesIntegration Services щелкните правой кнопкой мыши проект и затем выберите пункт Свойства.To access the properties of an Службы Integration ServicesIntegration Services project, right-click the project and click Properties.

В следующей таблице производится перечисление свойств программы развертывания.The following table lists the deployment utility properties.

СвойствоProperty ОписаниеDescription
AllowConfigurationChangeAllowConfigurationChange Значение, указывающее, возможно ли обновление конфигураций во время развертывания.A value that specifies whether configurations can be updated during deployment.
CreateDeploymentUtilityCreateDeploymentUtility Значение, указывающее, будет ли во время построения пакета производиться создание программы развертывания.A value that specifies whether a package deployment utility is created when the project is built. Для создания программы развертывания значение свойства должно быть равно True .This property must be True to create a deployment utility.
DeploymentOutputPathDeploymentOutputPath Расположение программы развертывания, соответствующей проекту служб Службы Integration ServicesIntegration Services .The location, relative to the Службы Integration ServicesIntegration Services project, of the deployment utility.

При создании проекта служб Службы Integration ServicesIntegration Services создается файл манифеста <project name>.SSISDeploymentManifest.xml, который добавляется вместе с копиями пакетов проекта и их зависимостей в папку bin\Deployment проекта или в расположение, указанное в свойстве DeploymentOutputPath.When you build an Службы Integration ServicesIntegration Services project, a manifest file, <project name>.SSISDeploymentManifest.xml, is created and added, together with copies of the project packages and package dependencies, to the bin\Deployment folder in the project, or to the location specified in the DeploymentOutputPath property. Файл манифеста производит перечисление пакетов, их конфигураций, а также иных различных файлов проекта.The manifest file lists the packages, the package configurations, and any miscellaneous files in the project.

Содержимое папки развертывания обновляется каждый раз при построении проекта.The content of the deployment folder is refreshed every time that you build the project. Это означает, что любой файл, сохраненный в этой папке, который не копируется снова в эту папку в процессе построения, будет удален.This means that any file saved to this folder that is not copied to the folder again by the build process will be deleted. Например, файлы конфигурации пакета, сохраненные в папку развертывания, будут удалены.For example, package configuration files saved to the deployment folders will be deleted.

Создание программы развертывания пакетовTo create a package deployment utility

  1. В среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)откройте решение, содержащее проект служб Службы Integration ServicesIntegration Services , для которого необходимо создать программу развертывания пакетов.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the solution that contains the Службы Integration ServicesIntegration Services project for which you want to create a package deployment utility.

  2. Щелкните правой кнопкой мыши проект и выберите пункт Свойства.Right-click the project and click Properties.

  3. В диалоговом окне Страницы свойств <project name> выберите элемент Программа развертывания.In the <project name> Property Pages dialog box, click Deployment Utility.

  4. Для обновления конфигураций пакета после развертывания пакетов установите значение AllowConfigurationChanges равным True.To update package configurations when packages are deployed, set AllowConfigurationChanges to True.

  5. Установите значение CreateDeploymentUtility равным True.Set CreateDeploymentUtility to True.

  6. При необходимости обновите расположение программы развертывания посредством изменения свойства DeploymentOutputPath .Optionally, update the location of the deployment utility by modifying the DeploymentOutputPath property.

  7. Нажмите кнопку ОК.Click OK.

  8. В обозревателе решений щелкните правой кнопкой мыши проект и выберите Построить.In Solution Explorer, right-click the project, and then click Build.

  9. Просмотрите ход компоновки и ошибки в окне Выход .View the build progress and build errors in the Output window.

Развертывание пакетов с помощью программы развертыванияDeploy Packages by Using the Deployment Utility

Если сборка программы развертывания, предназначенной для установки пакетов из проекта служб Службы Integration ServicesIntegration Services , выполнена на компьютере, отличном от того, на котором находится сам проект, прежде всего необходимо скопировать папку развертывания на целевой компьютер.When you have built a deployment utility to install packages from an Службы Integration ServicesIntegration Services project on a different computer than the one on which the deployment utility was built, you must first copy the deployment folder to the destination computer.

Путь к папке развертывания указывается в свойстве DeploymentOutputPath того проекта служб Службы Integration ServicesIntegration Services , для которого была собрана данная программа развертывания.The path of the deployment folder is specified in the DeploymentOutputPath property of the Службы Integration ServicesIntegration Services project for which you created the deployment utility. По умолчанию папкой развертывания является папка bin\Deployment относительно проекта служб Службы Integration ServicesIntegration Services .The default path is bin\Deployment, relative to the Службы Integration ServicesIntegration Services project. Дополнительные сведения см. в статье Create a Deployment Utility.For more information, see Create a Deployment Utility.

Для установки пакетов используется мастер установки пакетов.You use the Package Installation Wizard to install the packages. Чтобы запустить мастер, дважды щелкните файл программы развертывания после копирования папки развертывания на сервер.To launch the wizard, double-click the deployment utility file after you have copied the deployment folder to the server. Этот файл называется <project name>.SSISDeploymentManifest и находится в папке развертывания на конечном компьютере.This file is named <project name>.SSISDeploymentManifest, and can be found in the deployment folder on the destination computer.

Примечание

В зависимости от версии развертываемого пакета, параллельная установка разных версий SQL ServerSQL Server может вызвать ошибку.Depending on the version of the package that you are deploying, you might encounter an error if you have different versions of SQL ServerSQL Server installed side-by-side. Эта ошибка может возникнуть из-за того, что расширение имени файла SSISDeploymentManifest одинаково для всех версий Службы Integration ServicesIntegration Services.This error can occur because the .SSISDeploymentManifest file name extension is the same for all versions of Службы Integration ServicesIntegration Services. Если дважды щелкнуть имя файла, вызывается установщик (dtsinstall.exe) последней установленной версии служб Службы Integration ServicesIntegration Services, которая может отличаться от версии файла программы развертывания.Double-clicking the file calls the installer (dtsinstall.exe) for the most recently installed version of Службы Integration ServicesIntegration Services, which might not be the same version as the deployment utility file. Чтобы решить эту проблему, запустите нужную версию dtsinstall.exe из командной строки и укажите путь к файлу программы развертывания.To work around this problem, run the correct version of dtsinstall.exe from the command line, and provide the path of the deployment utility file.

Мастер установки пакета проведет по всем шагам установки пакетов в файловую систему или в SQL ServerSQL Server.The Package Installation Wizard guides you through the steps to install packages to the file system or to SQL ServerSQL Server. Установку можно настроить следующим образом:You can configure the installation in the following ways:

  • выбрать тип расположения и само расположение для установки пакетов;Choosing the location type and location to install the packages.

  • выбрать расположение для установки зависимостей пакетов;Choosing location to install package dependencies.

  • проверить пакеты после их установки на целевом сервере.Validating the packages after they are installed on the target server.

Файловые зависимости для пакетов всегда устанавливаются в файловую систему.The file-based dependencies for packages are always installed to the file system. При установке пакета в файловую систему эти зависимости устанавливаются в ту же папку, которая была указана для данного пакета.If you install a package to the file system, the dependencies are installed in the same folder as the one that you specify for the package. При установке пакета в SQL ServerSQL Serverможно указать папку для хранения файловых зависимостей.If you install a package to SQL ServerSQL Server, you can specify the folder in which to store the file-based dependencies.

Если данный пакет содержит конфигурации, которые нужно будет изменить на целевом компьютере, значения соответствующих свойств можно изменить в этом мастере.If the package includes configurations that you want to modify for use on the destination computer, you can update the values of the properties by using the wizard.

Помимо установки пакетов с помощью мастера установки пакета их можно копировать и перемещать с помощью программы командной строки dtutil .In addition to installing packages by using the Package Installation Wizard, you can copy and move packages by using the dtutil command prompt utility. Дополнительные сведения см. в статье dtutil Utility.For more information, see dtutil Utility.

Развертывание пакетов в экземпляре SQL ServerTo deploy packages to an instance of SQL Server

  1. Откройте папку развертывания на целевом компьютере.Open the deployment folder on the target computer.

  2. Дважды щелкните файл манифеста, <project name>.SSISDeploymentManifest, чтобы запустить мастер установки пакета.Double-click the manifest file, <project name>.SSISDeploymentManifest, to start the Package Installation Wizard.

  3. На странице Установка пакетов служб SSIS выберите параметр Установить на SQL Server .On the Deploy SSIS Packages page, select the SQL Server deployment option.

  4. Можно также установить флажок Проверить пакеты после установки , чтобы проверить правильность пакетов после их установки на целевой сервер.Optionally, select Validate packages after installation to validate packages after they are installed on the target server.

  5. На странице Выбор целевого сервера SQL Server укажите экземпляр SQL ServerSQL Server , куда будут установлены пакеты, и выберите режим проверки подлинности.On the Specify Target SQL Server page, specify the instance of SQL ServerSQL Server to install the packages to and select an authentication mode. Если выбрать проверку подлинности SQL ServerSQL Server , необходимо будет ввести имя пользователя и пароль.If you select SQL ServerSQL Server Authentication, you must provide a user name and a password.

  6. На странице Выбор папки для установки укажите папку в файловой системе, куда будут установлены зависимости пакета.On the Select Installation Folder page, specify the folder in the file system for the package dependencies that will be installed.

  7. Если пакет содержит конфигурации, можно изменить его, обновляя значения в списке Значение на странице настройки пакетов.If the package includes configurations, you can edit configurations by updating values in the Value list on the Configure Packages page.

  8. Если выбрана функция проверки пакетов после установки, посмотрите результаты проверки развернутых пакетов.If you elected to validate packages after installation, view the validation results of the deployed packages.

Повторное развертывание пакетовRedeployment of Packages

После развертывания проекта может понадобится обновить или расширить функциональные возможности пакета и затем повторно развернуть проект служб Службы Integration ServicesIntegration Services , содержащий обновленные пакеты.After a project is deployed, you may need to update or extend package functionality and then redeploy the Службы Integration ServicesIntegration Services project that contains the updated packages. В рамках процесса повторного развертывания пакетов необходимо просмотреть свойства конфигурации, включенные в программу развертывания.As part of the process of redeploying packages, you should review the configuration properties that are included in the deployment utility. Например, можно запретить изменение конфигурации после повторного развертывания пакета.For example, you may not want to allow configuration changes after the package is redeployed.

Процесс повторного развертыванияProcess for Redeployment

После завершения обновления пакетов перестраивается проект, папка развертывания копируется на целевой компьютер и затем повторно запускается мастер установки пакета.After you finish updating the packages, you rebuild the project, copy the deployment folder to the target computer, and then rerun the Package Installation Wizard.

При обновлении нескольких пакетов в проекте развертывание всего пакета может не понадобиться.If you update only a few packages in the project, you may not want to redeploy the entire project. Для развертывания только нескольких пакетов можно создать новый проект служб Службы Integration ServicesIntegration Services , добавить обновленные пакеты в новый проект, затем скомпоновать и развернуть проект.To deploy only a few packages, you can create a new Службы Integration ServicesIntegration Services project, add the updated packages to the new project, and then build and deploy the project. Конфигурации пакетов автоматически копируются с пакетом при добавлении пакета в другой проект.Package configurations are automatically copied with the package when you add the package to a different project.

Мастер установки пакета справочника по пользовательскому интерфейсуPackage Installation Wizard UI Reference

Используйте Мастер установки пакета , чтобы развернуть проект служб Службы Integration ServicesIntegration Services , включая пакеты и другие файлы, которые в нем содержатся, а также любые зависимости пакетов.Use the Package Installation Wizard to deploy a Службы Integration ServicesIntegration Services project, including the packages and miscellaneous files it contains and any package dependencies.

Прежде чем выполнять развертывание пакетов, можно создать конфигурации, затем выполнить их развертывание вместе с пакетами.Before you deploy packages, you can create configurations and then deploy them with the packages. Службы Integration ServicesIntegration Services конфигурации используются для динамического обновления свойств и объектов пакетов во время выполнения.uses configurations to dynamically update properties of packages and package objects at run time. Например, строка соединения OLE DB может быть задана динамически во время выполнения с помощью конфигурации, которая сопоставляет значение и свойство, содержащее строку соединения.For example, the connection string of an OLE DB connection can be set dynamically at run time by providing a configuration that maps a value to the property that contains the connection string.

Нельзя запустить мастер установки пакета до тех пор, пока не собран проект служб Службы Integration ServicesIntegration Services и не создана программа развертывания.You cannot run the Package Installation Wizard until you build an Службы Integration ServicesIntegration Services project and create a deployment utility. Дополнительные сведения см. в статье Deploy Packages by Using the Deployment Utility.For more information, see Deploy Packages by Using the Deployment Utility.

В следующих разделах описаны страницы мастера.The following sections describe pages of the wizard.

Страница приветствия мастера установки пакетаWelcome to the Package Installation Wizard Page

Мастер установки пакета используется для развертывания проекта служб Службы Integration ServicesIntegration Services , для которого создается программа развертывания пакета.Use the Package Installation Wizard to deploy an Службы Integration ServicesIntegration Services project for which you built a package deployment utility.

Больше не показывать это окноDo not show this starting page again
Выберите этот параметр, чтобы пропустить начальную страницу при повторном запуске мастера.Select to skip the starting page when you run the wizard again.

ДальшеNext
Перейдите на следующую страницу мастера.Go to the next page in the wizard.

ГотовоFinish
Переход на страницу завершения работы мастера установки пакета.Skip to the Finish the Package Installation Wizard page. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.Use this option if you have backtracked through the wizard pages to revise your choices and have specified all of the required options.

Страница настройки пакетовConfigure Packages Page

Используйте страницу Настройка пакетов , чтобы отредактировать конфигурации пакета.Use the Configure Packages page to edit package configurations.

ПараметрыOptions

Файл конфигурацииConfiguration file
Редактируйте содержимое файла конфигурации путем выбора файла из списка.Edit the contents of a configuration file by selecting the file from the list.

См. также: Создание конфигурации пакетовRelated Topics: Create Package Configurations

ПутьPath
Просмотр пути к настраиваемому свойству.View the path of the property to be configured.

ТипType
Просмотр типа данных указанного свойства.View the data type of the property.

ЗначениеValue
Задание значения конфигурации.Specify the value of the configuration.

ДальшеNext
Перейдите на следующую страницу мастера.Go to the next page in the wizard.

ГотовоFinish
Переход на страницу завершения работы мастера установки пакета.Skip to the Finish the Package Installation Wizard page. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.Use this option if you have backtracked through the wizard pages to revise your choices and have specified all of the required options.

Страница подтверждения установкиConfirm Installation Page

Страница Подтверждение установки используется для запуска установки пакетов, для просмотра состояния, а также для просмотра данных, которые мастер будет использовать для установки файлов из указанного проекта.Use the Confirm Installation page to start the installation of packages, to view the status, and to view the information that the wizard will use to install files from the specified project.

ДальшеNext
Установите пакеты и их зависимости, затем, по окончании установки, перейдите на следующую страницу мастера.Install the packages and their dependencies and go to the next wizard page when installation is completed.

СостояниеStatus
Отображается ход установки пакета.Shows the progress of the package installation.

ГотовоFinish
Перейдите на страницу завершения работы мастера установки пакета.Go to the Finish the Package Installation Wizard page. Этот параметр можно использовать после возврата на предыдущие страницы мастера, чтобы просмотреть свой выбор после указания всех необходимых параметров.Use this option if you have backtracked through the wizard pages to revise your choices and have specified all the required options.

Страница развертывания пакетов служб SSISDeploy SSIS Packages Page

Страница Установка пакетов служб SSIS используется для задания места установки пакетов служб Службы Integration ServicesIntegration Services и их зависимостей.Use the Deploy SSIS Packages page to specify where to install Службы Integration ServicesIntegration Services packages and their dependencies.

ПараметрыOptions

Установить в файловую системуFile system deployment
Установить пакеты и зависимости в заданную папку в файловой системе.Deploy packages and dependencies in a specified folder in the file system.

Установить на SQL ServerSQL Server deployment
Установить пакеты и зависимости в экземпляр SQL ServerSQL Server.Deploy packages and dependencies in an instance of SQL ServerSQL Server. Используйте данный параметр, если SQL ServerSQL Server совместно использует пакеты между несколькими серверами.Use this option if SQL ServerSQL Server shares packages between servers. Все зависимости пакетов устанавливаются в заданную папку файловой системы.Any package dependencies are installed in the specified folder in the file system.

Проверить пакеты после установкиValidate packages after installation
Укажите, необходимо ли проверить пакеты после установки.Indicate whether to validate packages after installation.

ДальшеNext
Перейдите на следующую страницу мастера.Go to the next page in the wizard.

ГотовоFinish
Переход на страницу завершения работы мастера установки пакета.Skip to the Finish the Package Installation Wizard page. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.Use this option if you have backtracked through the wizard pages to revise your choices and have specified all of the required options.

Страница проверки пакетовPackages Validation Page

Используйте страницу Проверка пакетов для просмотра хода выполнения и результатов проверки пакета.Use the Packages Validation page to view the progress and results of the package validation.

ДальшеNext
Перейдите на следующую страницу мастера.Go to the next page in the wizard.

Страница выбора папки установкиSelect Installation Folder Page

Страница Выбор папки для установки используется для указания папки в файловой системе, в которую будут установлены пакеты и их зависимости.Use the Select Installation Folder page to specify the file system folder in which to install the packages and their dependencies.

ПараметрыOptions

ПапкаFolder
Позволяет указать путь к папке, в которую будет скопирован пакет и его зависимости.Specify the path and folder in which to copy the package and its dependencies.

ОбзорBrowse
Служит для выбора целевой папки в диалоговом окне Обзор папки .Browse to the target folder by using the Browse For Folder dialog box.

ДальшеNext
Перейдите на следующую страницу мастера.Go to the next page in the wizard.

ГотовоFinish
Переход на страницу завершения работы мастера установки пакета.Skip to the Finish the Package Installation Wizard page. Этот параметр следует использовать в случае попадания на данную страницу путем возвращения с последующих страниц мастера для проверки выбранных параметров, если все необходимые параметры были заданы.Use this option if you have backtracked through the wizard pages to revise your choices and if have specified all of the required options.

Страница выбора целевого сервера SQL ServerSpecify Target SQL Server Page

Используйте страницу Выбор целевого сервера SQL Server для указания параметров развертывания пакета на экземпляре SQL ServerSQL Server.Use the Specify Target SQL Server page to specify options for deploying the package to an instance of SQL ServerSQL Server.

ПараметрыOptions

Имя сервераServer name
Укажите имя сервера, на котором надо осуществлять развертывание пакетов.Specify the name of the server to deploy the packages to.

Использовать проверку подлинности WindowsUse Windows Authentication
Укажите, использовать ли проверку подлинности Windows при входе на сервер.Specify whether to use Windows Authentication to log on to the server. Для лучшей защиты рекомендуется использовать проверку подлинности Windows.Windows Authentication is recommended for better security.

Использовать проверку подлинности SQL ServerUse SQL Server Authentication
Укажите, должен ли пакет использовать проверку подлинности SQL ServerSQL Server при входе на сервер.Specify whether the package should use SQL ServerSQL Server Authentication to log on to the server. Если используется проверка подлинности SQL ServerSQL Server , необходимо ввести имя пользователя и пароль.If you use SQL ServerSQL Server Authentication, you must provide a user name and password.

User nameUser name
Укажите имя пользователя.Specify a user name.

ПарольPassword
Укажите пароль.Specify a password.

Путь пакетаPackage path
Укажите имя логической папки или введите «/» в качестве папки по умолчанию.Specify the name of the logical folder, or enter "/" for the default folder.

Чтобы выбрать папку в диалоговом окне Пакет служб SSIS , нажмите кнопку Обзор (...). Однако в диалоговом окне отсутствует возможность задать папку по умолчанию.To select the folder in the SSIS Package dialog box, click browse (...). However, the dialog box does not provide a means to select the default folder. Если необходимо использовать папку по умолчанию, то следует ввести в текстовое поле «/».If you want to use the default folder, you have to enter "/" in the text box.

Примечание

Если не ввести допустимый путь пакета, появится следующее сообщение об ошибке: "Один или несколько аргументов являются недопустимыми".If you do not enter a valid package path, the following error message appears: "One or more arguments are invalid."

Шифрование обеспечивается хранением на сервереRely on server storage for encryption
Выберите, чтобы использовать средства безопасности компонента Компонент Database EngineDatabase Engine для защиты пакетов.Select to use security features of the Компонент Database EngineDatabase Engine to help secure the packages.

ДальшеNext
Перейдите на следующую страницу мастера.Go to the next page in the wizard.

ГотовоFinish
Переход на страницу завершения работы мастера установки пакета.Skip to the Finish the Package Installation Wizard page. Этот параметр используется после возврата на предыдущие страницы мастера для просмотра выбранных позиций, если все нужные параметры заданы.Use this option if you have backtracked through the wizard pages to revise your choices and have specified all of the required options.

Страница завершения установки пакетаFinish the Package Installation Page

Страница Завершение работы мастера установки пакета используется для просмотра сводки о результатах установки пакетов.Use the Finish the Package Installation Wizard page to view a summary of the package installation results. На этой странице представлены такие сведения, как имя развертываемого проекта служб Службы Integration ServicesIntegration Services , список инсталлированных пакетов, файлы конфигурации и пути размещения компонентов.This page provides details such as the name of the deployed Службы Integration ServicesIntegration Services project, the packages that were installed, the configuration files, and the installation location.

ГотовоFinish
Для завершения работы мастера нажмите кнопку Готово.Exit the wizard by clicking Finish.