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

  • Статья

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

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

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

  • Назначение «ADO.NET»

  • Целевой объект «Обучение модели интеллектуального анализа данных»

  • Назначение DataReader

  • Назначение «Обработка измерений»

  • Назначение Excel

  • Назначение «Неструктурированный файл»

  • Адресат OLE DB

  • Назначение обработки секции

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

  • Назначение «Набор записей»

  • Назначение SQL Server Compact Edition

  • Назначение SQL Server

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

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

Назначение «ADO.NET»

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

В следующей таблице описаны пользовательские свойства назначения «ADO.NET». Все свойства доступны для чтения и записи. Эти свойства недоступны в диалоговом окне Редактор назначения «ADO.NET», однако их можно установить при помощи окна Расширенный редактор.

Свойство

Тип данных

Описание

BatchSize

Integer

Количество строк в пакете, отправленном серверу. Значение 0 означает, что размер пакета соответствует размеру внутреннего буфера. Значение этого свойства по умолчанию равно 0.

CommandTimeOut

Integer

Максимальное время ожидания в секундах, в течение которого может выполняться команда SQL. Значение 0 указывает на бесконечное время работы. Значение этого свойства по умолчанию равно 0.

TableOrViewName

Строковый

Имя целевой таблицы или представления.

UseBulkInsertWhenAvailable

Логические значения

Это значение указывает, следует ли использовать интерфейс System.Data.SqlClient..::..SqlBulkCopy для улучшения производительности операций массовой вставки. Только определенные провайдеры ADO.NET поддерживают этот интерфейс.

По умолчанию устанавливается значение True.

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

Пользовательские свойства назначения «Обучение модели интеллектуального анализа данных»

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

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

Свойство

Тип данных

Описание

ASConnectionId

String

Уникальный идентификатор диспетчера соединений.

ASConnectionString

String

Строка соединения с экземпляром служб Службы Analysis Services или с проектом служб Службы Analysis Services.

ObjectRef

String

XML-тег, определяющий структуру интеллектуального анализа данных, которую использует преобразование.

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

Дополнительные сведения см. в разделе Целевой объект «Обучение модели интеллектуального анализа данных».

Пользовательские свойства назначения «Модуль чтения данных»

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

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

Имя свойства

Тип данных

Описание

DataReader

String

Имя класса назначения «Модуль чтения данных».

FailOnTimeout

Boolean

Показывает, завершать ли работу с ошибкой, когда истекает время ожидания чтения (ReadTimeout). По умолчанию для этого свойства устанавливается значение False.

ReadTimeout

Integer

Количество миллисекунд до истечения времени ожидания. По умолчанию для этого свойства устанавливается значение 30000 (30 секунд).

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

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

Пользовательские свойства назначения «Обработка измерений»

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

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

Свойство

Тип данных

Описание

ASConnectionString

String

Строка соединения с экземпляром служб Службы Analysis Services или с проектом служб Службы Analysis Services.

KeyDuplicate

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать ошибки повторения ключа. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение IgnoreError (0).

KeyErrorAction

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать ошибки ключа. Допустимые значения — ConvertToUnknown (0) и DiscardRecord (1). По умолчанию это свойство имеет значение ConvertToUnknown (0).

KeyErrorLimit

Integer

Если свойство UseDefaultConfiguration имеет значение False, значит, включено максимально разрешенное количество ошибок ключа.

KeyErrorLimitAction

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство устанавливает действие при достижении предела KeyErrorLimit. Допустимые значения — StopLogging (1) и StopProcessing (0). По умолчанию это свойство имеет значение StopProcessing (0).

KeyErrorLogFile

String

Если свойство UseDefaultConfiguration имеет значение False, это свойство представляет собой путь и имя файла журнала ошибок.

KeyNotFound

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

Если UseDefaultConfiguration принимает значение False, то это значение показывает, как обрабатывать ошибки отсутствия ключа. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение IgnoreError (0).

NullKeyConvertedToUnknown

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать ключи NULL, преобразованные в значение Unknown. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение IgnoreError (0).

NullKeyNotAllowed

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать запрещенные значения NULL. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение IgnoreError (0).

ProcessType

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

Тип обработки измерений, используемый преобразованием. Допустимые значения — ProcessAdd (1) (добавочное), ProcessFull (0) и ProcessUpdate (2).

UseDefaultConfiguration

Boolean

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

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

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

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

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

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

Имя свойства

Тип данных

Описание

AccessMode

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

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

Это свойство может принимать одно из следующих значений.

  • OpenRowset (0) — необходимо указать имя таблицы или представления.

  • OpenRowset from Variable (1) — необходимо указать имя переменной, содержащей имя таблицы или представления.

  • OpenRowset Using Fastload (3) — необходимо указать имя таблицы или представления.

  • OpenRowset Using Fastload from Variable (4) — необходимо указать имя переменной, содержащей имя таблицы или представления.

  • SQL Command (2) — необходимо указать инструкцию SQL.

CommandTimeout

Integer

Максимальное время ожидания в секундах, в течение которого может выполняться команда SQL. Значение 0 указывает на бесконечное время работы. Значение этого свойства по умолчанию равно 0.

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

FastLoadKeepIdentity

Boolean

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

FastLoadKeepNulls

Boolean

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

FastLoadMaxInsertCommitSize

Integer

Это значение указывает размер пакетов, который назначение «Excel» пытается фиксировать во время операций быстрой загрузки. Значение по умолчанию 0 указывает, что используется единая операция фиксации после обработки всех строк.

FastLoadOptions

String

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

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

OpenRowset

String

Если свойство AccessMode имеет значение OpenRowset, то это значение — имя таблицы или представления, к которому имеет доступ назначение «Excel».

OpenRowsetVariable

String

Если свойство AccessMode имеет значение OpenRowset из переменной, то это имя переменной, содержащей имя таблицы или представления, к которому обращается назначение «Excel».

SqlCommand

String

Если свойство AccessMode имеет значение Команда SQL, то это инструкция языка Transact-SQL, которую использует назначение «Excel» для указания целевых столбцов данных.

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

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

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

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

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

Имя свойства

Тип данных

Описание

Header

String

Блок текста, вставляемый в файл перед записью в него каких-либо данных.

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

Overwrite

Boolean

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

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

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

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

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

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

ПримечаниеПримечание

Перечисленные здесь параметры быстрой загрузки (FastLoadKeepIdentity, FastLoadKeepNulls и FastLoadOptions) соответствуют свойствам со схожими именами, предоставляемым интерфейсом IRowsetFastLoad, который реализует поставщик Microsoft OLE DB для SQL Server (SQLOLEDB). Дополнительные сведения можно получить с помощью поиска по строке «IRowsetFastLoad» в библиотеке MSDN.

Имя свойства

Тип данных

Описание

AccessMode

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

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

Это свойство может принимать одно из следующих значений.

  • OpenRowset (0) — необходимо указать имя таблицы или представления.

  • OpenRowset from Variable (1) — необходимо указать имя переменной, содержащей имя таблицы или представления.

  • OpenRowset Using Fastload (3) — необходимо указать имя таблицы или представления.

  • OpenRowset Using Fastload from Variable (4) — необходимо указать имя переменной, содержащей имя таблицы или представления.

  • SQL Command (2) — необходимо указать инструкцию SQL.

AlwaysUseDefaultCodePage

Boolean

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

CommandTimeout

Integer

Максимальное время ожидания в секундах, в течение которого может выполняться команда SQL. Значение 0 указывает на бесконечное время работы. Значение этого свойства по умолчанию равно 0.

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

DefaultCodePage

Integer

Кодовая страница по умолчанию для назначения «OLE DB».

FastLoadKeepIdentity

Boolean

Значение, которое указывает, следует ли при загрузке данных копировать значения идентификаторов. Это свойство доступно только при использовании одного из параметров быстрой загрузки. По умолчанию для этого свойства устанавливается значение False. Это свойство соответствует свойству SSPROP_FASTLOADKEEPIDENTITY интерфейса OLE DB IRowsetFastLoad (OLE DB).

FastLoadKeepNulls

Boolean

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

FastLoadMaxInsertCommitSize

Integer

Значение, указывающее размер пакетов, который назначение «OLE DB» пытается фиксировать во время операций быстрой загрузки. Значение по умолчанию 2147483647 указывает, что используется единая операция фиксации после обработки всех строк.

FastLoadOptions

String

Коллекция параметров быстрой загрузки. К параметрам быстрой загрузки относятся параметры блокировки таблиц и проверки ограничений. Можно указать один, оба или не указывать ни одного параметра. Это свойство соответствует свойству SSPROP_FASTLOADOPTIONS интерфейса IRowsetFastLoad в OLE DB и принимает такие строковые значения, как CHECK_CONSTRAINTS и TABLOCK.

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

OpenRowset

String

Если свойство AccessMode имеет значение OpenRowset, это свойство — имя таблицы или представления, к которому обращается назначение «OLE DB».

OpenRowsetVariable

String

Если свойство AccessMode имеет значение OpenRowset из переменной, это свойство представляет собой имя переменной, содержащей имя таблицы или представления, к которому обращается назначение «OLE DB».

SqlCommand

String

Если свойство AccessMode имеет значение Команда SQL, это инструкция языка Transact-SQL, используемая назначением «OLE DB» для указания целевых столбцов данных.

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

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

Пользовательские свойства назначения «Обработка секций»

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

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

Свойство

Тип данных

Описание

ASConnectionString

String

Строка соединения с экземпляром служб Службы Analysis Services или с проектом служб Службы Analysis Services.

KeyDuplicate

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать ошибки повторения ключа. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение IgnoreError (0).

KeyErrorAction

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать ошибки ключа. Допустимые значения — ConvertToUnknown (0) и DiscardRecord (1). По умолчанию это свойство имеет значение ConvertToUnknown (0).

KeyErrorLimit

Integer

Если свойство UseDefaultConfiguration имеет значение False, это свойство представляет собой максимальное разрешенное количество ошибок ключа.

KeyErrorLimitAction

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство устанавливает действие при достижении предела KeyErrorLimit. Допустимые значения — StopLogging (1) и StopProcessing (0). По умолчанию это свойство имеет значение StopProcessing (0).

KeyErrorLogFile

String

Если свойство UseDefaultConfiguration имеет значение False, это свойство представляет собой путь и имя файла журнала ошибок.

KeyNotFound

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

Если UseDefaultConfiguration принимает значение False, то это значение показывает, как обрабатывать ошибки отсутствия ключа. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение ReportAndContinue (1).

NullKeyConvertedToUnknown

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать ключи NULL, преобразованные в значение Unknown. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение IgnoreError (0).

NullKeyNotAllowed

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

Если свойство UseDefaultConfiguration имеет значение False, это свойство показывает, как обрабатывать запрещенные значения NULL. Допустимые значения: IgnoreError (0), ReportAndContinue (1) и ReportAndStop (2). По умолчанию это свойство имеет значение ReportAndContinue (1).

ProcessType

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

Тип обработки секций, используемый преобразованием. Допустимые значения — ProcessAdd (1) (добавочное), ProcessFull (0) и ProcessUpdate (2).

UseDefaultConfiguration

Boolean

Значение, указывающее, используется ли преобразованием конфигурация ошибок по умолчанию. Если это свойство принимает значение False, то преобразование использует значения пользовательских свойств обработки ошибок, приведенных в этой таблице, в том числе KeyDuplicate, KeyErrorAction и др.

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

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

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

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

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

Имя свойства

Тип данных

Описание

AccessMode

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

Значение, указывающее, содержит ли свойство FileName имя файла, или указывающее переменную, которая содержит имя файла. Параметрами являются File name (0) и File name from variable (1).

FileName

String

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

WriteOption

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

Значение, указывающее, следует ли назначению «Необработанный файл» удалять существующий файл с таким же именем. Допустимые параметры — Create Always (0), Create Once (1), Truncate and Append (3) и Append (2). По умолчанию это свойство имеет значение Create Always (0).
ПримечаниеПримечание

Операция добавления в файл требует, чтобы метаданные добавляемых данных совпадали с метаданными данных, уже содержащихся в файле.

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

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

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

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

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

Имя свойства

Тип данных

Описание

VariableName

String

Имя переменной, содержащей набор записей ADO.

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

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

Пользовательские свойства назначения «SQL Server Compact Edition»

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

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

Имя свойства

Тип данных

Описание

TableName

String

Имя целевой таблицы в базе данных SQL Server Compact.

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

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

Дополнительные сведения см. в разделе Назначение «SQL Server Compact Edition».

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

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

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

Имя свойства

Тип данных

Описание

AlwaysUseDefaultCodePage

Boolean

Принудительно использует значение свойства DefaultCodePage. По умолчанию для этого свойства устанавливается значение False.

BulkInsertCheckConstraints

Boolean

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

BulkInsertFireTriggers

Boolean

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

BulkInsertFirstRow

Integer

Значение, указывающее первую вставляемую строку. Это свойство по умолчанию имеет значение -1, которое указывает на то, что никакое значение не присваивалось.

BulkInsertKeepIdentity

Boolean

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

BulkInsertKeepNulls

Boolean

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

BulkInsertLastRow

Integer

Значение, указывающее последнюю вставляемую строку. Это свойство по умолчанию имеет значение -1, которое указывает на то, что никакое значение не присваивалось.

BulkInsertMaxErrors

Integer

Значение, указывающее допустимое максимальное число ошибок, после превышения которого происходит прекращение массовой вставки. Это свойство имеет по умолчанию значение -1, указывающее, что значение не назначено.

BulkInsertOrder

String

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

BulkInsertTableName

String

Таблица или представление SQL Server в базе данных, в которую копируются данные.

BulkInsertTablock

Boolean

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

DefaultCodePage

Integer

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

MaxInsertCommitSize

Integer

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

Timeout

Integer

Значение, указывающее время ожидания в секундах, в течение которых назначение «SQL Server» ожидает поступления данных для вставки перед прекращением работы. Значение 0 означает, что назначение «SQL Server» имеет неограниченное время ожидания. Значение этого свойства по умолчанию равно 30.

У входных и выходных столбцов назначения «SQL Server» нет пользовательских свойств.

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