Поделиться через


Параметры пакета и проекта Integration Services (SSIS)

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

Параметры служб Integration Services (SSIS) могут быть использованы для присвоения значений свойствам внутри пакетов во время их выполнения. Можно создать параметры проекта на уровне проекта и параметры пакета на уровне пакета. Параметры проекта используются для предоставления любых внешних данных, получаемых проектом, одному пакету в проекте или более. Параметры пакета позволяют изменить выполнение пакета. При этом изменять пакет и развертывать его повторно не придется.

В SQL Server Data Tools вы создаете, изменяете или удаляете параметры проекта с помощью окна Project.params . Параметры пакета создаются, изменяются и удаляются с помощью вкладки "Параметры " в конструкторе служб SSIS. Диалоговое окно Параметризация позволяет связать новый или существующий параметр со свойством задачи. Дополнительные сведения об использовании окна Project.params и вкладки Параметры см. в разделе Create Parameters. Дополнительные сведения о диалоговом окне Параметризация см. в разделе Parameterize Dialog Box.

Параметры и модель развертывания пакета

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

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

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

При развертывании проекта на сервере служб Integration Services (SSIS) используются представления, хранимые процедуры и пользовательский интерфейс SQL Server Management Studio для управления параметрами проекта и пакета. Дополнительные сведения см. в следующих разделах:

Значения параметров

Можно назначить до 3 различных значений для параметра. С началом выполнения пакета для параметра используется одно значение, а параметр разрешается в свое последнее литеральное значение.

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

Имя значения Description Тип значения
Значение выполнения Значение, которое назначается определенному экземпляру выполнения пакета. Это значение переопределяет все прочие значения, но применяется только к одному экземпляру выполнения пакета. Литерал
Значение сервера Значение, присваиваемое параметру в области проекта после развертывания проекта на сервере служб Integration Services. Это значение переопределяет значение по умолчанию проекта. Литерал или ссылка на переменную среды
Значение проекта Значение, назначенное параметру при создании или редактировании проекта в SQL Server Data Tools. Это значение сохраняется в проекте. Литерал

С помощью одного параметра можно присваивать значения нескольким свойствам пакета. Единственному свойству пакета может быть присвоено значение только одного параметра.

Выполнения и значения параметров

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

Если значение параметра для параметра выполнения задано явно, то к этому конкретному экземпляру выполнения будет применяться только это значение. Значение выполнения используется вместо значения сервера или значения проекта. Если не задано явно значение выполнения, но задано значение сервера, то используется значение сервера.

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

Переменные среды

Если параметр ссылается на переменную среды, литеральное значение этой переменной разрешается посредством заданной ссылки на среду и применяется к параметру. Окончательное литеральное значение параметра, используемое при выполнении пакета, называется значением параметра выполнения. Указывайте ссылку на среду для выполнения с помощью диалогового окна Выполнить

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

Чтобы просмотреть переменные среды, назначенные значениям параметра, запросите представление catalog.object_parameters. Дополнительные сведения см. в статье catalog.object_parameters (база данных SSISDB).

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

Для отображения и задания значений параметров можно использовать следующие представления и хранимые процедуры Transact-SQL.

catalog.execution_parameter_values (база данных SSISDB) (представление)
Показывает фактические значения параметров в определенном выполнении.

catalog.get_parameter_values (база данных SSISDB) (хранимая процедура)
Разрешает и показывает фактические значения для заданного пакета и ссылки на среду.

catalog.object_parameters (база данных SSISDB) (представление)
Отображает параметры и свойства для всех пакетов и проектов в каталоге служб Integration Services, включая значения по умолчанию конструктора и сервера по умолчанию.

catalog.set_execution_parameter_value (база данных SSISDB)
Задает значение параметра для экземпляра выполнения в каталоге служб Integration Services.

Вы также можете использовать диалоговое окно "Выполнение пакета" в SQL Server Data Tools (SSDT) изменить значение параметра. Дополнительные сведения см. в разделе Execute Package Dialog Box.

Также можно использовать параметр dtexec /Parameter для изменения значения параметра. Дополнительные сведения см. в статье dtexec Utility.

Проверка параметров

Если значения параметров не могут быть разрешены, выполнение соответствующего пакета завершится с ошибкой. Чтобы избежать сбоев, можно проверить проекты и пакеты с помощью диалогового окна "Проверка " в SQL Server Data Tools (SSDT). Проверка позволяет установить, имеют ли все параметры необходимые значения и могут ли необходимые значения быть разрешены с помощью определенных ссылок среды. Также проверка устанавливает наличие других часто встречающихся проблем пакетов.

Дополнительные сведения см. в разделе Validate Dialog Box.

Пример параметра

В этом примере описывается параметр с именем pkgOptions , используемый для задания параметров для пакета, в котором он расположен.

Во время разработки, когда параметр был создан в SQL Server Data Tools, значение по умолчанию 1 было назначено параметру. Это значение по умолчанию называется значением по умолчанию проекта. Если проект развертывается в каталоге SSISDB, и данному параметру не было назначено других значений, то во время выполнения пакета его свойству, соответствующему параметру pkgOptions , будет присвоено значение 1. Значение по умолчанию проекта сохраняется в проекте на протяжении всего его жизненного цикла.

Во время подготовки определенного экземпляра выполнения пакета параметру pkgOptions присваивается значение 5. Это значение называется значением выполнения, поскольку оно применяется к параметру только в этом определенном экземпляре выполнения. При запуске выполнения свойству пакета, соответствующему параметру pkgOptions , присваивается значение 5.

Создание параметров

Для создания параметров проекта и параметров пакета используется SQL Server Data Tools (SSDT). Следующие процедуры содержат пошаговые инструкции для создания параметров пакета (проекта).

Примечание.

Если выполняется преобразование проекта, созданного с помощью предыдущей версии служб Службы Integration Services, в модель развертывания проекта, то для создания параметров на основе конфигураций можно запустить Мастер преобразования проектов служб Integration Services. Дополнительные сведения см. в разделе Развертывание проектов и пакетов служб Integration Services (SSIS).

Создание параметров пакета

  1. Откройте пакет в SQL Server Data Tools и перейдите на вкладку "Параметры " в конструкторе служб SSIS.

    Вкладка

  2. Нажмите кнопку Добавить параметр на панели инструментов.

    Кнопка

  3. Введите значения для свойств Имя, Тип данных, Значение, С учетом регистраи Обязательно в сам список или в окно Свойства . Эти свойства рассматриваются в таблице ниже.

    Свойство Описание
    Имя. Имя параметра.
    Тип данных Тип данных параметра.
    Default value Значение по умолчанию для параметра, назначаемое во время разработки. Оно также называется значением по умолчанию проекта.
    Конфиденциальные Конфиденциальные значения параметров шифруются в каталоге и при просмотре с помощью Transact-SQL или в среде SQL Server Management Studio отображаются как значения NULL.
    Обязательное поле Требует указать значение, отличное от значения по умолчанию проекта, перед выполнением пакета.
    Description Для удобства обслуживания — описание параметра. В SQL Server Data Tools (SSDT) задайте описание параметра в окно свойств Visual Studio при выборе параметра в окне применимых параметров.

    Примечание.

    При развертывании проекта в каталог с ним будут связаны еще несколько свойств. Чтобы просмотреть все свойства для всех параметров в каталоге, используйте представление catalog.object_parameters (база данных SSISDB).

  4. Сохраните проект для сохранения изменений, внесенных в параметры. Значения параметров хранятся в файле проекта.

    Предупреждение

    Можно изменять список на месте или в окне Свойства изменить значения свойств параметра. Можно удалить параметр, нажав кнопку Удалить (X) на панели инструментов. С помощью последней кнопки панели инструментов можно указать значение параметра, используемого только при выполнении пакета в SQL Server Data Tools.

    Примечание.

    Если повторно открыть файл пакета, не открыв при этом проект в среде SQL Server Data Tools, вкладка Параметры будет пустой и неактивной.

Создание параметров проекта

  1. Откройте проект в SQL Server Data Tools.

  2. В обозревателе решений щелкните правой кнопкой мыши Project.params и выберите команду Открыть или дважды щелкните файл Project.params , чтобы открыть его.

    Окно параметров проекта

  3. Нажмите кнопку Добавить параметр на панели инструментов.

    Кнопка

  4. Введите значения для свойств Имя, Тип данных, Значение, С учетом регистраи Обязательно .

    Свойство Описание
    Имя. Имя параметра.
    Тип данных Тип данных параметра.
    Default value Значение по умолчанию для параметра, назначаемое во время разработки. Оно также называется значением по умолчанию проекта.
    Конфиденциальные Конфиденциальные значения параметров шифруются в каталоге и при просмотре с помощью Transact-SQL или в среде SQL Server Management Studio отображаются как значения NULL.
    Обязательное поле Требует указать значение, отличное от значения по умолчанию проекта, перед выполнением пакета.
    Description Для удобства обслуживания — описание параметра. В SQL Server Data Tools задайте описание параметра в окно свойств Visual Studio, если параметр выбран в окне применимых параметров.
  5. Сохраните проект для сохранения изменений, внесенных в параметры. Значения параметров хранятся в конфигурации в файле проекта. Сохраните файл проекта для фиксации на диске любых изменений в значениях параметров.

    Предупреждение

    Можно изменять список на месте или в окне Свойства изменить значения свойств параметра. Можно удалить параметр, нажав кнопку Удалить (X) на панели инструментов. С помощью последней кнопки панели инструментов для открытия диалогового окна "Управление значениями параметров" можно указать значение параметра, используемого только при выполнении пакета в SQL Server Data Tools.

Диалоговое окно "Параметризация"

Диалоговое окно Параметризация позволяет связать новый или существующий параметр со свойством задачи. Откроется диалоговое окно, щелкнув правой кнопкой мыши задачу или вкладку "Поток управления" в конструкторе служб SSIS, а затем нажав кнопку "Параметризация". Следующий список описывает элементы пользовательского интерфейса в диалоговом окне. Дополнительные сведения о параметрах см. в разделе Параметры служб Integration Services (SSIS).

Параметры

Свойство
Выберите свойство задачи, которую нужно связать с параметром. Этот список заполняется всеми свойствами, которые могут быть параметризированы.

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

Не использовать параметр
Выберите этот параметр для удаления ссылки на параметр. Параметр не удаляется.

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

Имя
Задайте имя создаваемого параметра.

Description
Задайте описание параметра.

Value
Задайте значение параметра по умолчанию. Оно также называется значением по умолчанию проекта, которое может быть переопределено позднее во время развертывания.

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

С учетом регистра
Установив или сняв флажок, определите конфиденциальность параметра. Конфиденциальные значения параметров шифруются в каталоге и при просмотре с помощью Transact-SQL или в среде SQL Server Management Studio отображаются как значения NULL.

Обязательный
Укажите, необходимо ли задавать параметру значение, отличное от значения по умолчанию проекта, перед выполнением пакета.

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

Мастер развертывания позволяет задавать значения параметров по умолчанию сервера при развертывании проекта в каталог. После развертывания проекта в каталог задать значения по умолчанию сервера можно будет с помощью обозревателя объектов среды SQL Server Management Studio (SSMS) или Transact-SQL.

Настройка параметров сервера по умолчанию с помощью обозревателя объектов SSMS

  1. Выберите и щелкните правой кнопкой мыши проект в узле Службы Integration Services .

  2. Выберите пункт Свойства , чтобы открыть диалоговое окно Свойства проекта .

  3. Откройте страницу «Параметры», нажав кнопку Параметры в разделе Выбор страницы.

  4. Выберите нужный параметр в списке Параметры . Примечание. Столбец Контейнер помогает отличить параметры проекта от параметров пакета.

  5. В столбце Значение укажите необходимое значение параметра по умолчанию сервера.

Настройка параметров сервера по умолчанию с помощью Transact-SQL

Чтобы установить параметры по умолчанию для сервера с использованием Transact-SQL, используйте хранимую процедуру catalog.set_object_parameter_value (база данных SSISDB). Чтобы просмотреть текущие параметры по умолчанию для сервера, используйте запрос к представлению catalog.object_parameters (база данных SSISDB). Чтобы удалить значение по умолчанию для сервера, используйте хранимую процедуру, используйте хранимую процедуру catalog.clear_object_parameter_value (база данных SSISDB).