Пользовательские свойства источника

Объекты потока данных в моделях объектов служб MicrosoftSQL ServerIntegration Services имеют общие свойства и пользовательские свойства на уровне компонента, ввода и вывода, а также входного и выходного столбцов. Пользовательские свойства доступны только во время выполнения и не описаны в документации по программированию служб Integration Services для управляемой среды.

Этот раздел содержит список и описание пользовательских свойств источников потоков данных.

  • Источник - ADO NET

  • Источник Excel

  • Источник «Плоский файл»

  • Источник «OLE DB»

  • Источник «Необработанный файл»

  • XML-источник

Дополнительные сведения о свойствах, общих для большинства объектов потока данных, см. в разделе Общие свойства.

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

Пользовательские свойства источника «ADO NET»

Источник «ADO NET» обладает как пользовательскими свойствами, так и свойствами, общими для всех компонентов потока данных.

В следующей таблице описаны пользовательские свойства источника «ADO NET». Все свойства доступны для чтения и записи.

Имя свойства

Тип данных

Описание

CommandTimeout

String

Задает число секунд до истечения времени ожидания команды SQL. Значение 0 означает, что время выполнения команды не ограничено.

SqlCommand

String

Инструкция SQL, используемая источником «ADO NET» для извлечения данных.

При загрузке пакета можно динамически обновлять это свойство инструкцией SQL, которая будет использована источником «ADO NET». Дополнительные сведения см. в разделах Справочник по выражениям служб Integration Services и Использование выражений свойств в пакетах.

AllowImplicitStringConversion

Boolean

Значение, указывающее, происходят ли следующие события.

  • Отмена формирования ошибки проверки в случае несоответствия типов внешних метаданных и типов выходных столбцов, являющихся строковыми (DT_WSTR или DT_NTEXT).

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

Значение по умолчанию — TRUE.

Дополнительные сведения см. в разделе Источник ADO NET.

Выход и выходные столбцы источника «ADO NET» не имеют пользовательских свойств.

Дополнительные сведения см. в разделе Источник ADO NET.

Пользовательские свойства источника «Excel»

Источник «Excel» обладает как пользовательскими свойствами, так и свойствами, общими для всех компонентов потока данных.

В следующей таблице описаны пользовательские свойства источника «Excel». Все свойства доступны для чтения и записи.

Имя свойства

Тип данных

Описание

AccessMode

Integer

Режим, используемый для доступа к базе данных. Возможные значения: Открытый набор строк, Открытый набор строк из переменной, Команда SQL и Команда SQL из переменной. Значение по умолчанию: Открытый набор строк.

CommandTimeout

Integer

Время ожидания для выполнения команды (в секундах). Значение 0 указывает на бесконечное время ожидания.

Примечание   Это свойство недоступно в диалоговом окне Редактор источника «Excel», однако его можно установить при помощи окна Расширенный редактор.

OpenRowset

String

Имя объекта базы данных, используемого для открытия набора строк.

OpenRowsetVariable

String

Переменная, содержащая имя объекта базы данных, используемого для открытия набора строк.

ParameterMapping

String

Сопоставление между параметрами в команде SQL и переменными.

SqlCommand

String

Команда SQL для выполнения.

SqlCommandVariable

String

Переменная, содержащая команду SQL для выполнения.

Выход и выходные столбцы источника «Excel» не имеют пользовательских свойств.

Дополнительные сведения см. в разделе Источник Excel.

Пользовательские свойства источника «Плоский файл»

Источник «Плоский файл» обладает как пользовательскими свойствами, так и свойствами, общими для всех компонентов потока данных.

В следующей таблице описаны пользовательские свойства источника «Плоский файл». Все свойства доступны для чтения и записи.

Имя свойства

Тип данных

Описание

FileNameColumnName

String

Имя выходного столбца, который содержит имя файла. Если имя не указано, выходной столбец с именем файла не будет сформирован.

ПримечаниеПримечание
Это свойство недоступно в диалоговом окне Редактор источника «Плоский файл», однако его можно установить при помощи окна Расширенный редактор.

RetainNulls

Boolean

Значение указывает, будут ли значения NULL из исходного файла сохранены как значения NULL при обработке данных конвейером преобразования данных. По умолчанию для этого свойства устанавливается значение False.

Выход источника «Плоский файл» не имеет пользовательских свойств.

В следующей таблице описаны пользовательские свойства выходных столбцов источника «Плоский файл». Все свойства доступны для чтения и записи.

Имя свойства

Тип данных

Описание

FastParse

Boolean

Указывает, используются ли для столбца более быстрые, но независимые от языкового стандарта процедуры синтаксического анализа, предоставляемые службами DTS, либо стандартные процедуры, зависимые от языкового стандарта. Дополнительные сведения см. в разделах Быстрый синтаксический анализ и Стандартный синтаксический анализ. По умолчанию для этого свойства устанавливается значение False.

ПримечаниеПримечание
Это свойство недоступно в диалоговом окне Редактор источника «Плоский файл», однако его можно установить при помощи окна Расширенный редактор.

Дополнительные сведения см. в разделе Источник «Плоский файл».

Пользовательские свойства источника «OLE DB»

Источник «OLE DB» обладает как пользовательскими свойствами, так и свойствами, общими для всех компонентов потока данных.

В следующей таблице описаны пользовательские свойства источника «OLE DB». Все свойства доступны для чтения и записи.

Имя свойства

Тип данных

Описание

AccessMode

Integer

Режим, используемый для доступа к базе данных. Возможные значения: Открытый набор строк, Открытый набор строк из переменной, Команда SQL и Команда SQL из переменной. Значение по умолчанию: Открытый набор строк.

AlwaysUseDefaultCodePage

Boolean

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

CommandTimeout

Integer

Время ожидания для выполнения команды (в секундах). Значение 0 указывает на бесконечное время ожидания.

ПримечаниеПримечание
Это свойство недоступно в диалоговом окне Редактор источника «OLE DB», однако его можно установить при помощи окна Расширенный редактор.

DefaultCodePage

Integer

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

OpenRowset

String

Имя объекта базы данных, используемого для открытия набора строк.

OpenRowsetVariable

String

Переменная, содержащая имя объекта базы данных, используемого для открытия набора строк.

ParameterMapping

String

Сопоставление между параметрами в команде SQL и переменными.

SqlCommand

String

Команда SQL для выполнения.

SqlCommandVariable

String

Переменная, содержащая команду SQL для выполнения.

Выход и выходные столбцы источника «OLE DB» не имеют пользовательских свойств.

Дополнительные сведения см. в разделе Источник OLE DB.

Пользовательские свойства источника «Необработанный файл»

Источник «Необработанный файл» обладает как пользовательскими свойствами, так и свойствами, общими для всех компонентов потока данных.

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

Имя свойства

Тип данных

Описание

AccessMode

Integer (перечисление)

Режим, используемый для доступа к необработанным данным. Допустимые значения — File name (0) и File name from variable (1). Значение по умолчанию — File name (0).

FileName

String

Полный путь и имя исходного файла.

Выход и выходные столбцы источника «Необработанный файл» не имеют пользовательских свойств.

Дополнительные сведения см. в разделе Источник «Необработанный файл».

Пользовательские свойства источника «XML»

Источник «XML» обладает как пользовательскими свойствами, так и свойствами, общими для всех компонентов потока данных.

В следующей таблице описаны пользовательские свойства источника «XML». Все свойства доступны для чтения и записи.

Имя свойства

Тип данных

Описание

AccessMode

Integer

Режим, используемый для доступа к XML-данным.

UseInlineSchema

Boolean

Указывает, следует ли использовать в источнике «XML» определение встроенной схемы. По умолчанию для этого свойства устанавливается значение False.

XMLData

String

Файл или переменные, из которых следует получить XML-данные.

Значение этого свойства можно задать с помощью выражения свойства.

XMLSchemaDefinition

String

Полный путь и имя файла определения схемы (XSD).

Значение этого свойства можно задать с помощью выражения свойства.

В следующей таблице описаны пользовательские свойства выхода источника «XML». Все свойства доступны для чтения и записи.

Имя свойства

Тип данных

Описание

RowsetID

String

Определяет набор строк, связанный с выходом.

Выходные столбцы источника «XML» не имеют пользовательских свойств.

Дополнительные сведения см. в разделе XML-источник.

Журнал изменений

Обновления

  • Добавлены числовые значения для свойства AccessMode источника «Необработанный файл».