Установка свойств пакета

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

При создании пакета в SQL Server Data Tools (SSDT) с помощью графического интерфейса, предоставляемого службами Integration Services, необходимо задать свойства объекта пакета в окно свойств.

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

При упорядочении по категории содержимое окна Свойства группируется по следующим категориям:

• Контрольные точки

• Выполнение

• Значение параметра «Принудительное выполнение»

• Идентификация

• Разное

• Безопасность

• Транзакции

• Версия

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

Установка свойств пакета в окне «Свойства»

• Установка свойств переменной пакета

Свойства, упорядоченные по категориям

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

Контрольные точки

Свойства этой категории позволяют перезапускать пакет с точки сбоя в его потоке управления без необходимости перезапуска с самого начала потока управления. Дополнительные сведения см. в разделе Restart Packages by Using Checkpoints.

Свойство	Description
CheckpointFileName	Имя файла для записи сведений о контрольных точках, которые позволяют перезапускать пакет. При успешном завершении пакета этот файл удаляется.
CheckpointUsage	Определяет, когда пакет может быть перезапущен. Допустимые значения — Never, IfExistsи Always. Значение этого свойства по умолчанию равно Never, что означает невозможность перезапуска пакета. Дополнительные сведения см. в разделе DTSCheckpointUsage.
SaveCheckpoints	Определяет, записываются ли контрольные точки в файл контрольных точек при запуске пакета. Это свойство имеет значение по умолчанию False.

Примечание.

Указание параметра /CheckPointing on команды dtexec эквивалентно заданию для свойства SaveCheckpoints пакета значения True, а для свойства CheckpointUsage — значения Always. Дополнительные сведения см. в статье dtexec Utility.

Выполнение

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

Свойство	Description
DelayValidation	Указывает, откладывается ли проверка пакета до того момента, как он будет запущен. Значение этого свойства по умолчанию — False.
Отключить	Указывает, отключен ли пакет. Это свойство имеет значение по умолчанию False.
DisableEventHandlers	Определяет, запускаются ли обработчики событий пакета. Это свойство имеет значение по умолчанию False.
FailPackageOnFailure	Определяет, происходит ли аварийное завершение пакета в случае ошибки в каком-либо его компоненте. Единственным допустимым значением для этого свойства является значение False.
FailParentOnError	Определяет, происходит ли аварийное завершение родительского контейнера в случае ошибки в дочернем контейнере. Значение этого свойства по умолчанию равно False.
MaxConcurrentExecutables	Число исполняемых файлов, которые могут быть параллельно запущены пакетом. Значение этого свойства по умолчанию равно -1, что означает отсутствие ограничения.
MaximumErrorCount	Максимальное число ошибок, после достижения которого выполнение пакета прекращается. Значение этого свойства по умолчанию равно 1.
PackagePriorityClass	Класс приоритета потока пакета в системе Win32. Допустимые значения — Default, AboveNormal, Normal, BelowNormal, Idle. Значение по умолчанию этого свойства равно Default. Дополнительные сведения см. в разделе DTSPriorityClass.

Значение параметра «Принудительное выполнение»

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

Свойство	Description
ForcedExecutionValue	Если свойство ForceExecutionValue имеет значение True, то данное значение определяет возвращаемое пакетом значение необязательного выполнения. Значение этого свойства по умолчанию равно 0.
ForcedExecutionValueType	Тип данных свойства ForcedExecutionValue. Значение по умолчанию этого свойства равно Int32.
ForceExecutionValue	Логическое значение, указывающее, должно ли необязательное значение выполнения для контейнера содержать конкретное значение. Это свойство имеет значение по умолчанию False.

Идентификация

Свойства этой категории содержат такие данные, как уникальный идентификатор и имя пакета.

Свойство	Description
CreationDate	Дата создания пакета.
CreatorComputerName	Имя компьютера, на котором был создан пакет.
CreatorName	Имя пользователя, создавшего пакет.
Description	Описание функциональных возможностей пакета.
ИД	Идентификатор GUID пакета, назначаемый ему при создании. Это свойство доступно только для чтения. Чтобы создать новое случайное значение свойства ID, выберите в раскрывающемся списке команду <Сформировать новый идентификатор>.
Имя	Имя пакета.
PackageType	Тип пакета. Допустимые значения — Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaintи SQLReplication. Значение по умолчанию этого свойства равно Default. Дополнительные сведения см. в разделе DTSPackageType.

Прочее

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

Свойство	Description
Конфигурации	Коллекция конфигураций, используемых пакетом. Нажмите кнопку обзора (…) для просмотра и настройки конфигурации пакета.
Выражения	Нажмите кнопку обзора (…) для создания выражений для свойств пакета. Обратите внимание, что выражения свойств можно создавать для всех свойств пакета, включенных в объектную модель, а не только для перечисленных в окне "Свойства". Дополнительные сведения см. в разделе Использование выражений свойств в пакетах. Для просмотра существующих выражений свойств раскройте список Expressions. Нажмите кнопку обзора (…) в текстовом поле выражения для изменения и вычисления этого выражения.
ForceExecutionResult	Результат выполнения пакета. Допустимые значения: None, Success, Failureи Completion. Значение по умолчанию этого свойства равно None. Дополнительные сведения см. в разделе T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.
LocaleId	Локаль Microsoft Win32. Значение этого свойства по умолчанию равно локали операционной системы на локальном компьютере.
LoggingMode	Значение, определяющее для пакета режим записи в журнал. Допустимые значения — Disabled, Enabledи UseParentSetting. Значение по умолчанию этого свойства равно UseParentSetting. Дополнительные сведения см. в разделе DTSLoggingMode.
OfflineMode	Указывает, работает ли пакет в режиме «вне сети». Это свойство доступно только для чтения. Это свойство устанавливается на уровне проекта. Как правило, конструктор служб SSIS пытается подключиться к каждому источнику данных, используемому пакетом для проверки метаданных, связанных с источниками и назначениями. Можно установить флажок Работать вне сети в меню служб SSIS даже перед открытием пакета, чтобы избежать этих попыток подключения и возникающих по этой причине ошибок проверки, если источники данных недоступны. Флажок Работать вне сети можно также установить для ускорения работы конструктора и снять его только для проверки пакета.
SuppressConfigurationWarnings	Указывает, подавляются ли предупреждения, создаваемые конфигурациями. Это свойство имеет значение по умолчанию False.
UpdateObjects	Указывает, обновляется ли пакет для использования новых версий содержащихся в нем объектов, когда эти новые версии становятся доступны. Например, если для этого свойства задано значение True, пакет, включающий задачу массового вставки, обновляется, чтобы использовать более новую версию задачи массового вставки, которую предоставляет службы Integration Services. Это свойство имеет значение по умолчанию False.

Безопасность

Свойства этой категории используются для установки уровня защиты пакета. Дополнительные сведения см. в разделе Access Control for Sensitive Data in Packages.

Свойство	Description
PackagePassword	Пароль для уровней защиты пакета (EncryptSensitiveWithPassword и EncryptAllWithPassword), требующих использование пароля.
ProtectionLevel	Уровень защиты пакета. Допустимые значения — DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPasswordи ServerStorage. Значение по умолчанию этого свойства равно EncryptSensitiveWithUserKey. Дополнительные сведения см. в разделе DTSProtectionLevel.

Транзакции

Свойства этой категории позволяют настраивать уровень изоляции и параметр транзакции для пакета. Дополнительные сведения см. в разделе Транзакции служб Integration Services.

Свойство	Description
IsolationLevel	Уровень изоляции транзакции пакета. Допустимые значения — Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializableи Snapshot. Значение по умолчанию этого свойства равно Serializable. Примечание. Значение Snapshot для свойства IsolationLevel несовместимо с пакетными транзакциями. Поэтому нельзя использовать свойство IsolationLevel для задания уровня изоляции транзакций пакета Shapshot. Вместо этого используйте SQL-запрос для задания транзакций пакетов моментальным снимком. Дополнительные сведения см. в разделе Инструкция SET TRANSACTION ISOLATION LEVEL (Transact-SQL). Система применяет свойство IsolationLevel к транзакциям пакета только в случае, если свойство TransactionOption имеет значение Required. Значение свойства IsolationLevel , запрашиваемое дочерним контейнером, не учитывается, если выполняются следующие условия. Свойство TransactionOption дочернего контейнера имеет значение Supported. Дочерний контейнер присоединяется к транзакции родительского контейнера. Значение свойства IsolationLevel , запрашиваемое контейнером, учитывается только в случае, когда контейнер запускает новую транзакцию. Контейнер запускает новую транзакцию, если выполняются следующие условия. Свойство TransactionOption контейнера имеет значение Required. Родительский пакет еще не запустил транзакцию. Дополнительные сведения см. в разделе IsolationLevel.
TransactionOption	Участие пакета в транзакции. Допустимые значения — NotSupported, Supported, Required. Значение по умолчанию этого свойства равно Supported. Дополнительные сведения см. в разделе DTSTransactionOption.

Версия

Свойства этой категории содержат сведения о версии объекта пакета.

Свойство	Description
VersionBuild	Номер версии сборки пакета.
VersionComments	Примечания к версии пакета.
VersionGUID	Идентификатор GUID версии пакета. Это свойство доступно только для чтения.
VersionMajor	Последняя основная версия пакета.
VersionMinor	Последняя вспомогательная версия пакета.

Установка свойств пакета в окне "Свойства"

1. В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий пакет, который требуется настроить.

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

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

   • Щелкните правой кнопкой мыши в области конструктора потока управления и выберите Свойства.

   • В меню Просмотр выберите пункт Окно свойств.

4. Отредактируйте свойства пакета в окне Свойства .

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