System. Data. Ole Db Пространство имен
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Классы
Представляет инструкцию SQL или хранимую процедуру, выполняемую с источником данных.
Автоматически генерирует однотабличные команды, которые позволяют согласовать изменения, вносимые в объект DataSet, со связанной базой данных. Этот класс не наследуется.
Представляет открытое подключение к источнику данных.
Удобное средство, с помощью которого можно создавать используемые классом OleDbConnection строки соединений и управлять их содержимым.
Представляет набор команд данных и подключение к базе данных, которые используются для заполнения DataSet и обновления источника данных.
Предоставляет способ чтения потока строк данных из источника только в прямом порядке. Этот класс не наследуется.
Предоставляет механизм для перечисления всех доступных поставщиков OLE DB в локальной сети.
Собирает сведения, имеющие отношение к предупреждению или ошибке, возвращенной источником данных.
Исключение, которое генерируется, когда соответствующий поставщик возвращает предупреждение или ошибку для источника данных OLE DB. Этот класс не наследуется.
Представляет набор методов для создания экземпляров классов поставщиков OLEDB, реализующих источник данных.
Предоставляет данные для события InfoMessage. Этот класс не наследуется.
Предоставляет список констант для использования с методом GetSchema в целях извлечения коллекций метаданных.
Предоставляет статические значения, которые используются для имен столбцов в объектах OleDbMetaDataCollectionNames, содержащихся в таблице DataTable. Объект DataTable создан с помощью метода GetSchema.
Представляет параметр для объекта OleDbCommand и (необязательно) его сопоставление со столбцом DataSet. Этот класс не наследуется.
Представляет коллекцию параметров, относящихся к OleDbCommand, а также соответствующие им сопоставления со столбцами в DataSet.
Связывает операцию безопасности с пользовательским атрибутом безопасности.
Предоставляет данные для события RowUpdated.
Предоставляет данные для события RowUpdating.
Возвращает тип таблицы схемы, указываемой методом GetOleDbSchemaTable(Guid, Object[]).
Представляет транзакцию SQL, которую нужно выполнить в источнике данных. Этот класс не наследуется.
Перечисления
Возвращает сведения о литералах, используемых в текстовых командах, значениях данных и объектах баз данных.
Задает тип данных поля или свойства для использования в объекте OleDbParameter.
Делегаты
Представляет метод, обрабатывающий событие InfoMessageOleDbConnection.
Представляет метод, обрабатывающий событие RowUpdatedOleDbDataAdapter.
Представляет метод, обрабатывающий событие RowUpdatingOleDbDataAdapter.
Комментарии
обзор поставщика OLE DB майкрософт для SQL Server
поставщик OLE DB майкрософт для SQL Server, SQLOLEDB предоставляет ADO доступ к Microsoft SQL Server.
поставщик OLE DB майкрософт для SQL Server (SQLOLEDB) остается устаревшим и не рекомендуется использовать его для новых задач разработки. Вместо этого используйте новый драйвер Microsoft OLE DB для SQL Server (MSOLEDBSQL), который будет обновлен с самыми последними серверными компонентами.
Параметры строки соединения
Чтобы подключиться к поставщику, задайте для аргумента поставщика в качестве значения свойства ConnectionString значение:
Типичная строка подключения
Типичная строка подключения для этого поставщика:
Строка состоит из следующих ключевых слов:
| Ключевое слово | Описание |
|---|---|
| Поставщик | Указывает поставщика OLE DB для SQL Server. |
| Источник данных или сервер | Указывает имя сервера. |
| Исходный каталог или база данных | Указывает имя базы данных на сервере. |
| Идентификатор пользователя или UID | указывает имя пользователя (для проверки подлинности SQL Server). |
| Password или PWD | указывает пароль пользователя (для SQL Server проверки подлинности). |
при подключении к поставщику источника данных, который поддерживает проверку подлинности Windows, следует указать Trusted_Connection = yes или Integrated Security = SSPI вместо сведений об идентификаторе пользователя и пароле в строке подключения.
Параметры подключения Provider-Specific
Поставщик поддерживает несколько параметров соединения, зависящих от поставщика, помимо тех, которые определены в ADO. Как и в случае со свойствами соединения ADO, эти свойства, зависящие от поставщика, могут быть заданы через коллекцию свойств соединения или могут быть заданы как часть ConnectionString.
Использование объекта команды
SQLOLEDB принимает в качестве допустимого синтаксиса амалгам, SQL характерную для ODBC, ANSI и SQL Server. Например, следующая инструкция SQL использует escape-последовательность ODBC SQL, чтобы указать строковую функцию LCASE.
Функция LCASE возвращает строковое выражение, в котором все символы приведены к нижнему регистру. в ansi SQL строковая функция LOWER выполняет одну и ту же операцию, поэтому следующая инструкция SQL является эквивалентом приведенной выше инструкции ODBC в кодировке ansi.
SQLOLEDB успешно обрабатывает любую форму инструкции, если она указана в качестве текста для команды.
Хранимые процедуры
при выполнении SQL Server хранимой процедуры с помощью команды SQLOLEDB используйте escape-последовательность вызова процедуры ODBC в тексте команды. затем служба SQLOLEDB использует механизм удаленного вызова процедур SQL Server для оптимизации обработки команд. например, следующая инструкция ODBC SQL является предпочтительным текстом команды в форме Transact-SQL:
ODBC SQL
Transact-SQL
Функции SQL Server
доступ к данным sql_variant с помощью mdac 2,7, mdac 2,8 или Windows DAC 6,0
Множественные приведение типов данных приведет к несовпадению типов. Например, при преобразовании sql_variant с подтипом GUID в DBTYPE_VARIANT приведет к подтипу SAFEARRAY(bytes). Преобразование этого типа обратно в sql_variant приведет к созданию нового подтипа массива(байт).
В клиентских приложениях, использующих MDAC 2,5, sql_variant данные могут использоваться с запросами Microsoft SQL Server. Однако значения sql_variant данных обрабатываются как строки. такие клиентские приложения должны быть обновлены до mdac 2,7, mdac 2,8 или Windows DAC 6,0.
Поведение набора записей
SQLOLEDB не может использовать SQL Server курсоры для поддержки нескольких результатов, созданных многими командами. если потребитель запрашивает набор записей, который требует SQL Server поддержки курсора, возникает ошибка, если используемый текст команды создает в качестве результата больше одного набора записей.
доступные для прокрутки наборы записей SQLOLEDB поддерживаются SQL Server курсорами. SQL Server накладывает ограничения на курсоры, которые чувствительны к изменениям, внесенным другими пользователями базы данных. в частности, строки в некоторых курсорах не могут быть упорядочены, и попытка создать набор записей с помощью команды, содержащей предложение SQL order BY, может завершиться ошибкой.
Динамические свойства
поставщик OLE DB майкрософт для SQL Server вставляет несколько динамических свойств в коллекцию свойств неоткрытыго соединения, набора записейи командных объектов.
В следующих таблицах приведены перекрестные индексы имен ADO и OLE DB для каждого динамического свойства. Ссылка на OLE DB программиста ссылается на имя свойства ADO по термину «описание». Дополнительные сведения об этих свойствах можно найти в справочнике по программисту OLE DB. Найдите имя свойства OLE DB в индексе или см. приложение в: OLE DB свойства.
Динамические свойства подключения
| Имя свойства ADO | Имя свойства OLE DB |
|---|---|
| Активные сеансы | DBPROP_ACTIVESESSIONS |
| Прервать асинхронная | DBPROP_ASYNCTXNABORT |
| Асинхронная фиксация | DBPROP_ASYNCTNXCOMMIT |
| Уровни изоляции с автоматической фиксацией | DBPROP_SESS_AUTOCOMMITISOLEVELS |
| Расположение каталога | DBPROP_CATALOGLOCATION |
| Термин каталога | DBPROP_CATALOGTERM |
| Определение столбца | DBPROP_COLUMNDEFINITION |
| Время ожидания соединения | DBPROP_INIT_TIMEOUT |
| Текущий каталог | DBPROP_CURRENTCATALOG |
| Источник данных | DBPROP_INIT_DATASOURCE |
| Имя базы данных-источника | DBPROP_DATASOURCENAME |
| Потоковая модель объекта источника данных | DBPROP_DSOTHREADMODEL |
| Имя СУБД | DBPROP_DBMSNAME |
| Версия СУБД | DBPROP_DBMSVER |
| Расширенные свойства | DBPROP_INIT_PROVIDERSTRING |
| ГРУППИРОВКа по поддержке | DBPROP_GROUPBY |
| Поддержка разнородных таблиц | DBPROP_HETEROGENEOUSTABLES |
| Чувствительность идентификатора к регистру | DBPROP_IDENTIFIERCASE |
| Начальный каталог | DBPROP_INIT_CATALOG |
| Уровни изоляции | DBPROP_SUPPORTEDTXNISOLEVELS |
| Хранение изоляции | DBPROP_SUPPORTEDTXNISORETAIN |
| Идентификатор локали | DBPROP_INIT_LCID |
| Максимальный размер индекса | DBPROP_MAXINDEXSIZE |
| Максимальный размер строки | DBPROP_MAXROWSIZE |
| Максимальный размер строки включает большой двоичный объект | DBPROP_MAXROWSIZEINCLUDESBLOB |
| Максимальное число таблиц в SELECT | DBPROP_MAXTABLESINSELECT |
| Несколько наборов параметров | DBPROP_MULTIPLEPARAMSETS |
| Множественные результаты | DBPROP_MULTIPLERESULTS |
| несколько служба хранилища объектов | DBPROP_MULTIPLESTORAGEOBJECTS |
| Обновление нескольких таблиц | DBPROP_MULTITABLEUPDATE |
| Порядок параметров сортировки NULL | DBPROP_NULLCOLLATION |
| Поведение сцепления со значением NULL | DBPROP_CONCATNULLBEHAVIOR |
| Версия OLE DB | DBPROP_PROVIDEROLEDBVER |
| Поддержка объектов OLE | DBPROP_OLEOBJECTS |
| Поддержка открытых наборов строк | DBPROP_OPENROWSETSUPPORT |
| УПОРЯДОЧЕНие по столбцам в списке выбора | DBPROP_ORDERBYCOLUMNSINSELECT |
| Доступность выходного параметра | DBPROP_OUTPUTPARAMETERAVAILABILITY |
| Методы доступа для передачи по ссылке | DBPROP_BYREFACCESSORS |
| Пароль | DBPROP_AUTH_PASSWORD |
| Сохранять сведения о безопасности | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
| Тип постоянного идентификатора | DBPROP_PERSISTENTIDTYPE |
| Поведение при подготовке к прерыванию | DBPROP_PREPAREABORTBEHAVIOR |
| Действие подготовки к фиксации | DBPROP_PREPARECOMMITBEHAVIOR |
| Условие процедуры | DBPROP_PROCEDURETERM |
| prompt | DBPROP_INIT_PROMPT |
| Понятное имя поставщика | DBPROP_PROVIDERFRIENDLYNAME |
| Provider Name | DBPROP_PROVIDERFILENAME |
| Версия поставщика | DBPROP_PROVIDERVER |
| Источник данных Read-Only | DBPROP_DATASOURCEREADONLY |
| Преобразования наборов строк для команды | DBPROP_ROWSETCONVERSIONSONCOMMAND |
| Термин схемы | DBPROP_SCHEMATERM |
| Использование схемы | DBPROP_SCHEMAUSAGE |
| Поддержка SQL | DBPROP_SQLSUPPORT |
| структурированные служба хранилища | DBPROP_STRUCTUREDSTORAGE |
| Поддержка вложенных запросов | DBPROP_SUBQUERIES |
| Термин таблицы | DBPROP_TABLETERM |
| DDL транзакции | DBPROP_SUPPORTEDTXNDDL |
| Идентификатор пользователя. | DBPROP_AUTH_USERID |
| Имя пользователя | DBPROP_USERNAME |
| Дескриптор окна | DBPROP_INIT_HWND |
Динамические свойства набора записей
| Имя свойства ADO | Имя свойства OLE DB |
|---|---|
| Порядок доступа | DBPROP_ACCESSORDER |
| блокировка служба хранилища объектов | DBPROP_BLOCKINGSTORAGEOBJECTS |
| Тип закладки | DBPROP_BOOKMARKTYPE |
| С закладками | DBPROP_IROWSETLOCATE |
| Изменить вставленные строки | DBPROP_CHANGEINSERTEDROWS |
| Права доступа к столбцу | DBPROP_COLUMNRESTRICT |
| Уведомление о наборе столбцов | DBPROP_NOTIFYCOLUMNSET |
| Время ожидания команды | DBPROP_COMMANDTIMEOUT |
| Откладывание столбца | DBPROP_DEFERRED |
| откладывание служба хранилища обновлений объектов | DBPROP_DELAYSTORAGEOBJECTS |
| Получить назад | DBPROP_CANFETCHBACKWARDS |
| Удержание строк | DBPROP_CANHOLDROWS |
| IAccessor | DBPROP_IAccessor |
| IColumnsInfo | DBPROP_IColumnsInfo |
| IColumnsRowset | DBPROP_IColumnsRowset |
| IConnectionPointContainer | DBPROP_IConnectionPointContainer |
| IConvertType | DBPROP_IConvertType |
| Строки немобильных устройств | DBPROP_IMMOBILEROWS |
| IRowset | DBPROP_IRowset |
| IRowsetChange | DBPROP_IRowsetChange |
| ировсетидентити | DBPROP_IRowsetIdentity |
| IRowsetInfo | DBPROP_IRowsetInfo |
| IRowsetLocate | DBPROP_IRowsestLocate |
| Интерфейс irowsetresynch | |
| IRowsetScroll | DBPROP_IRowsetScroll |
| IRowsetUpdate | DBPROP_IRowsetUpdate |
| ISequentialStream | DBPROP_ISequentialStream |
| ISupportErrorInfo | DBPROP_ISupportErrorInfo |
| Литеральные закладки | DBPROP_LITERALBOOKMARKS |
| Удостоверение литеральной строки | DBPROP_LITERALIDENTITY |
| Максимальное число открытых строк | DBPROP_MAXOPENROWS |
| Максимальное число ожидающих строк | DBPROP_MAXPENDINGROWS |
| Максимальное число строк | DBPROP_MAXROWS |
| Гранулярность уведомлений | DBPROP_NOTIFICATIONGRANULARITY |
| Этапы уведомления | DBPROP_NOTIFICATIONPHASES |
| Транзакционные объекты | DBPROP_TRANSACTEDOBJECT |
| Изменения видны другим пользователям | DBPROP_OTHERUPDATEDELETE |
| Видимые вставки других пользователей | DBPROP_OTHERINSERT |
| Видны собственные изменения | DBPROP_OWNUPDATEDELETE |
| Видны собственные вставки | DBPROP_OWNINSERT |
| Сохранить при прерывании | DBPROP_ABORTPRESERVE |
| Сохранить при фиксации | DBPROP_COMMITPRESERVE |
| Быстрый перезапуск | DBPROP_QUICKRESTART |
| Повторные события | DBPROP_REENTRANTEVENTS |
| Удалить удаленные строки | DBPROP_REMOVEDELETED |
| Отчет о нескольких изменениях | DBPROP_REPORTMULTIPLECHANGES |
| Возврат ожидающих вставок | DBPROP_RETURNPENDINGINSERTS |
| Уведомление об удалении строки | DBPROP_NOTIFYROWDELETE |
| Уведомление о первом изменении строки | DBPROP_NOTIFYROWFIRSTCHANGE |
| Уведомление о вставке строки | DBPROP_NOTIFYROWINSERT |
| Права доступа к строке | DBPROP_ROWRESTRICT |
| Уведомление о повторной синхронизации строк | DBPROP_NOTIFYROWRESYNCH |
| Потоковая модель строк | DBPROP_ROWTHREADMODEL |
| Уведомление об отмене изменения строки | DBPROP_NOTIFYROWUNDOCHANGE |
| Уведомление об отмене удаления строки | DBPROP_NOTIFYROWUNDODELETE |
| Уведомление об отмене вставки строки | DBPROP_NOTIFYROWUNDOINSERT |
| Уведомление об обновлении строки | DBPROP_NOTIFYROWUPDATE |
| Уведомление об изменении расположения выборки набора строк | DBPROP_NOTIFYROWSETFETCHPOSISIONCHANGE |
| Уведомление о выпуске набора строк | DBPROP_NOTIFYROWSETRELEASE |
| Прокрутка назад | DBPROP_CANSCROLLBACKWARDS |
| Серверный курсор | DBPROP_SERVERCURSOR |
| Пропустить удаленные закладки | DBPROP_BOOKMARKSKIPPED |
| Строгая идентификация строк | DBPROP_STRONGITDENTITY |
| Уникальные строки | DBPROP_UNIQUEROWS |
| Updatability | DBPROP_UPDATABILITY |
| Использование закладок | DBPROP_BOOKMARKS |
Динамические свойства команды
| Имя свойства ADO | Имя свойства OLE DB |
|---|---|
| Порядок доступа | DBPROP_ACCESSORDER |
| Базовый путь | SSPROP_STREAM_BASEPATH |
| блокировка служба хранилища объектов | DBPROP_BLOCKINGSTORAGEOBJECTS |
| Тип закладки | DBPROP_BOOKMARKTYPE |
| С закладками | DBPROP_IROWSETLOCATE |
| Изменить вставленные строки | DBPROP_CHANGEINSERTEDROWS |
| Права доступа к столбцу | DBPROP_COLUMNRESTRICT |
| Уведомление о наборе столбцов | DBPROP_NOTIFYCOLUMNSET |
| Тип содержимого | SSPROP_STREAM_CONTENTTYPE |
| Автоматическая выборка курсора | SSPROP_CURSORAUTOFETCH |
| Откладывание столбца | DBPROP_DEFERRED |
| Отложенная подготовка | SSPROP_DEFERPREPARE |
| откладывание служба хранилища обновлений объектов | DBPROP_DELAYSTORAGEOBJECTS |
| Получить назад | DBPROP_CANFETCHBACKWARDS |
| Удержание строк | DBPROP_CANHOLDROWS |
| IAccessor | DBPROP_IAccessor |
| IColumnsInfo | DBPROP_IColumnsInfo |
| IColumnsRowset | DBPROP_IColumnsRowset |
| IConnectionPointContainer | DBPROP_IConnectionPointContainer |
| IConvertType | DBPROP_IConvertType |
| Строки немобильных устройств | DBPROP_IMMOBILEROWS |
| IRowset | DBPROP_IRowset |
| IRowsetChange | DBPROP_IRowsetChange |
| ировсетидентити | DBPROP_IRowsetIdentity |
| IRowsetInfo | DBPROP_IRowsetInfo |
| IRowsetLocate | DBPROP_IRowsetLocate |
| Интерфейс irowsetresynch | DBPROP_IRowsetResynch |
| IRowsetScroll | DBPROP_IRowsetScroll |
| IRowsetUpdate | DBPROP_IRowsetUpdate |
| ISequentialStream | DBPROP_ISequentialStream |
| ISupportErrorInfo | DBPROP_ISupportErrorInfo |
| Литеральные закладки | DBPROP_LITERALBOOKMARKS |
| Удостоверение литеральной строки | DBPROP_LITERALIDENTITY |
| Режим блокировки | DBPROP_LOCKMODE |
| Максимальное число открытых строк | DBPROP_MAXOPENROWS |
| Максимальное число ожидающих строк | DBPROP_MAXPENDINGROWS |
| Максимальное число строк | DBPROP_MAXROWS |
| Гранулярность уведомлений | DBPROP_NOTIFICATIONGRANULARITY |
| Этапы уведомления | DBPROP_NOTIFICATIONPHASES |
| Транзакционные объекты | DBPROP_TRANSACTEDOBJECT |
| Изменения видны другим пользователям | DBPROP_OTHERUPDATEDELETE |
| Видимые вставки других пользователей | DBPROP_OTHERINSERT |
| Свойство кодирования вывода | DBPROP_OUTPUTENCODING |
| Свойство потока вывода | DBPROP_OUTPUTSTREAM |
| Видны собственные изменения | DBPROP_OWNUPDATEDELETE |
| Видны собственные вставки | DBPROP_OWNINSERT |
| Сохранить при прерывании | DBPROP_ABORTPRESERVE |
| Сохранить при фиксации | DBPROP_COMMITPRESERVE |
| Быстрый перезапуск | DBPROP_QUICKRESTART |
| Повторные события | DBPROP_REENTRANTEVENTS |
| Удалить удаленные строки | DBPROP_REMOVEDELETED |
| Отчет о нескольких изменениях | DBPROP_REPORTMULTIPLECHANGES |
| Возврат ожидающих вставок | DBPROP_RETURNPENDINGINSERTS |
| Уведомление об удалении строки | DBPROP_NOTIFYROWDELETE |
| Уведомление о первом изменении строки | DBPROP_NOTIFYROWFIRSTCHANGE |
| Уведомление о вставке строки | DBPROP_NOTIFYROWINSERT |
| Права доступа к строке | DBPROP_ROWRESTRICT |
| Уведомление о повторной синхронизации строк | DBPROP_NOTIFYROWRESYNCH |
| Потоковая модель строк | DBPROP_ROWTHREADMODEL |
| Уведомление об отмене изменения строки | DBPROP_NOTIFYROWUNDOCHANGE |
| Уведомление об отмене удаления строки | DBPROP_NOTIFYROWUNDODELETE |
| Уведомление об отмене вставки строки | DBPROP_NOTIFYROWUNDOINSERT |
| Уведомление об обновлении строки | DBPROP_NOTIFYROWUPDATE |
| Уведомление об изменении расположения выборки набора строк | DBPROP_NOTIFYROWSETFETCHPOSITIONCHANGE |
| Уведомление о выпуске набора строк | DBPROP_NOTIFYROWSETRELEASE |
| Прокрутка назад | DBPROP_CANSCROLLBACKWARDS |
| Серверный курсор | DBPROP_SERVERCURSOR |
| Данные сервера при вставке | DBPROP_SERVERDATAONINSERT |
| Пропустить удаленные закладки | DBPROP_BOOKMARKSKIP |
| Строгая идентификация строк | DBPROP_STRONGIDENTITY |
| Updatability | DBPROP_UPDATABILITY |
| Использование закладок | DBPROP_BOOKMARKS |
| Корень XML | SSPROP_STREAM_XMLROOT |
| XSL | SSPROP_STREAM_XSL |
сведения о конкретной реализации и сведения о функциональных возMicrosoft SQL Serverии OLE DB поставщика см. в разделе поставщик SQL Server.
Назначение «OLE DB»
Для источника данных Microsoft Office Excel 2007 потребуется поставщик данных, отличный от того, который использовался в предыдущих версиях Excel. Дополнительные сведения см. в разделе Подключение к книге Excel.
Назначение «OLE DB» предусматривает пять различных режимов доступа для загружаемых данных:
Таблица или представление. Можно указать существующую таблицу или представление или создать новую таблицу.
Таблица или представление с параметрами быстрой загрузки. Можно указать существующую таблицу или создать новую.
Таблица или представление, указанные в переменной.
Таблица или представление, указанные в переменной с параметрами быстрой загрузки.
Результат выполнения инструкции SQL.
Назначение «OLE DB» не поддерживает параметры. Если необходимо выполнить параметризованную инструкцию INSERT, лучше воспользоваться преобразованием «Команда OLE DB». Дополнительные сведения см. в разделе OLE DB Command Transformation.
При использовании диалогового окна Редактор назначения «OLE DB» в конструкторе Integration Services для создания целевой таблицы, в которую целевой объект OLE DB вставляет данные, потребуется вручную выбрать вновь созданную таблицу. Необходимость выбора вручную возникает, когда поставщик OLE DB, такой как OLE DB для DB2, автоматически добавляет идентификаторы схемы в имя таблицы.
Это назначение использует диспетчер соединений OLE DB для подключения к источнику данных, и диспетчер соединений определяет используемый поставщик OLE DB. Дополнительные сведения см. в разделе Диспетчер соединений OLE DB.
Проект служб Службы Integration Services также содержит объект источника данных, из которого можно создать диспетчер соединений OLE DB, чтобы источники данных и представления источников данных стали доступными для целевой OLE DB.
Целевой объект OLE DB содержит сопоставления между входными столбцами и столбцами в источнике данных назначения. Нет необходимости сопоставлять входные столбцы всем целевым столбцам, но в зависимости от свойств целевых столбцов могут произойти ошибки, если входные столбцы не сопоставлены целевым столбцам. Например, если целевой столбец не допускает значений NULL, входной столбец должен быть ему сопоставлен. Кроме того, типы данных сопоставленных столбцов должны быть совместимыми. Например, нельзя сопоставить входной столбец строкового типа целевому столбцу числового типа данных.
Целевой объект OLE DB имеет один обычный вход и один выход ошибок.
Дополнительные сведения о типах данных см. в разделе Integration Services Data Types.
Параметры быстрой загрузки
Не совмещать значения идентичности с импортированным файлом данных или использовать уникальные значения, назначенные SQL Server.
Сохранить значение NULL при выполнении операции массовой загрузки.
Проверочное ограничение в целевой таблице или представлении при выполнении операции массового импорта.
Получить блокировку на уровне таблиц на период операции массовой загрузки.
Указать число строк в пакете и зафиксировать размер.
Любое нарушение ограничения в назначении вызывает сбой обработки всего пакета строк, определенного параметром FastLoadMaxInsertCommitSize.
| Параметры быстрой загрузки | Описание |
|---|---|
| KILOBYTES_PER_BATCH | Устанавливает размер в килобайтах для вставки. Параметр имеет форму KILOBYTES_PER_BATCH = . |
| FIRE_TRIGGERS | Устанавливает запуск триггеров при вставке таблицы. Параметр имеет форму FIRE_TRIGGERS. Наличие параметра означает, что триггер запускается. |
| ORDER | Устанавливает способ сортировки введенных данных. Параметр имеет форму ORDER ASC|DESC. Количество столбцов может быть любым, необязательно включать порядок сортировки. Если порядок сортировки пропущен, операция вставки предполагает, что данные не отсортированы. Примечание. Производительность можно повысить, если использовать параметр ORDER для сортировки загружаемых данных в соответствии с кластеризованным индексом таблицы. |
Ключевые слова Transact-SQL традиционно набираются буквами в верхнем регистре, однако учет их регистра не осуществляется.
Дополнительные сведения о параметрах быстрой загрузки см. в разделе BULK INSERT (Transact-SQL).
Устранение неполадок, связанных с назначением «OLE DB»
В журнал можно записывать вызовы, сделанные назначением «OLE DB» к внешним поставщика данных. Эта возможность ведения журнала может быть использована для устранения неполадок при сохранении данных во внешние источники данных, выполняемом назначением «OLE DB». Чтобы вести журнал вызовов, которые назначение «OLE DB» совершает к внешним поставщикам данных, необходимо включить ведение журнала пакета и выбрать событие Диагностика на уровне пакета. Дополнительные сведения см. в разделе Инструменты устранения неполадок при выполнении пакетов.
Настройка целевого объекта OLE DB
Значения свойств можно задавать с помощью конструктора Integration Services или программными средствами.
Диалоговое окно Расширенный редактор содержит свойства, которые можно установить с помощью программных средств. Дополнительные сведения о свойствах, которые вы можете задать в диалоговом окне Расширенный редактор или программными средствами, см. в следующих разделах.
Дополнительные сведения о настройке свойств см. в следующих разделах.
Редактор назначения OLE DB (страница «Диспетчер соединений»)
Страница Диспетчер соединений диалогового окна Редактор назначения «OLE DB» используется для выбора подключения OLE DB для назначения. На этой странице также можно выбрать таблицу или представление базы данных.
Для источника данных Microsoft Office Excel 2007 потребуется поставщик данных, отличный от того, который использовался в предыдущих версиях Excel. Дополнительные сведения см. в разделе Подключение к книге Excel.
Свойство CommandTimeout вступает в силу только тогда, когда действует режим доступа Команда SQL.
Статические параметры
Диспетчер соединений OLE DB
Выберите из списка существующий диспетчер соединений или создайте новое соединение, нажав кнопку Создать.
Режим доступа к данным
Укажите метод загрузки данных в назначение. Загрузка данных с двухбайтовой кодировкой (DBCS) требует одного из режимов быстрой загрузки. Дополнительные сведения о режимах доступа для быстрой загрузки данных, оптимизированных для массовой вставки, см. в разделе OLE DB Destination.
| Параметр | Описание |
|---|---|
| Таблица или представление | Загрузка данных в таблицу или представление назначения «OLE DB». |
| Быстрая загрузка таблицы или представления | Загрузка данных в таблицу или представление назначения «OLE DB» и использование параметра быстрой загрузки. Дополнительные сведения о режимах доступа для быстрой загрузки данных, оптимизированных для массовой вставки, см. в разделе OLE DB Destination. |
| Переменная, содержащая имя таблицы или представления | Задайте переменную, содержащую имя таблицы или представления. Дополнительные сведения Использование переменных в пакетах |
| Быстрая загрузка переменной имени представления или имени таблицы | Укажите переменную, содержащую имя таблицы или представления, и используйте для загрузки данных параметр быстрой загрузки. Дополнительные сведения о режимах доступа для быстрой загрузки данных, оптимизированных для массовой вставки, см. в разделе OLE DB Destination. |
| Команда SQL | Загрузка данных в назначение «OLE DB» при помощи SQL-запроса. |
Динамические параметры режима доступа к данным
Режим доступа к данным = Таблица или представление
Имя таблицы или представления
Выберите имя таблицы или представления из списка доступных в источнике данных.
Режим доступа к данным = таблица или представление — быстрая загрузка
Имя таблицы или представления
Выберите из этого списка таблицу или представление базы данных или создайте новую таблицу, нажав кнопку Создать.
Сохранять ИД
Укажите, следует ли при загрузке данных копировать значения идентификаторов. Это свойство доступно только с параметром быстрой загрузки. Значение по умолчанию этого свойства равно false.
Сохранять значения NULL
Укажите, следует ли при загрузке данных копировать значения NULL. Это свойство доступно только с параметром быстрой загрузки. Значение по умолчанию этого свойства равно false.
Блокировка таблицы
Укажите, должна ли таблица блокироваться при загрузке. Значение по умолчанию этого свойства равно true.
Проверочные ограничения
Определите, будет ли назначение проверять ограничения во время загрузки данных. Значение по умолчанию этого свойства равно true.
Строк на пакет
Задает количество строк в одном пакете. Это свойство по умолчанию имеет значение -1, которое указывает на то, что никакое значение не присваивалось.
Макс. фиксируемый размер вставок
Задайте размер пакетов, который назначение «OLE DB» пытается зафиксировать во время операций быстрой загрузки. Значение 0 указывает, что фиксация всех данных производится в одном пакете после обработки всех строк.
Если назначение «OLE DB» и другой компонент потока данных обновляют одну и ту же исходную таблицу, то значение 0 может привести к тому, что выполняемый пакет перестанет отвечать на запросы. Чтобы решить эту проблему, задайте для параметра Макс. фиксируемый размер вставок значение 2147483647.
При задании значения этого свойства назначение фиксирует строки в пакетах, которые меньше (а) значения Макс. фиксируемый размер вставокили (б) количества оставшихся строк в буфере, обрабатываемом в текущий момент.
Режим доступа к данным — переменная, содержащая имя таблицы или представления
Имя переменной
Выберите переменную, содержащую имя таблицы или представления.
Режим доступа к данным = переменная, содержащая имя таблицы или представления (быстрая загрузка)
Имя переменной
Выберите переменную, содержащую имя таблицы или представления.
Сохранять ИД
Укажите, следует ли при загрузке данных копировать значения идентификаторов. Это свойство доступно только с параметром быстрой загрузки. Значение по умолчанию этого свойства равно false.
Сохранять значения NULL
Укажите, следует ли при загрузке данных копировать значения NULL. Это свойство доступно только с параметром быстрой загрузки. Значение по умолчанию этого свойства равно false.
Блокировка таблицы
Укажите, должна ли таблица блокироваться при загрузке. Значение по умолчанию этого свойства равно false.
Проверочные ограничения
Укажите, действуют ли на задачу проверочные ограничения. Значение по умолчанию этого свойства равно false.
Строк на пакет
Задает количество строк в одном пакете. Это свойство по умолчанию имеет значение -1, которое указывает на то, что никакое значение не присваивалось.
Макс. фиксируемый размер вставок
Задайте размер пакетов, который назначение «OLE DB» пытается зафиксировать во время операций быстрой загрузки. Значение по умолчанию 2147483647 указывает на то, что фиксация всех данных производится одним пакетом после обработки всех строк.
Если назначение «OLE DB» и другой компонент потока данных обновляют одну и ту же исходную таблицу, то значение 0 может привести к тому, что выполняемый пакет перестанет отвечать на запросы. Чтобы решить эту проблему, задайте для параметра Макс. фиксируемый размер вставок значение 2147483647.
Режим доступа к данным — команда SQL
Текст команды SQL
Введите текст SQL-запроса, постройте запрос, нажав кнопку Создать запрос, или выберите файл, содержащий текст запроса, нажав кнопку Обзор.
Назначение «OLE DB» не поддерживает параметры. Если необходимо выполнить параметризованную инструкцию INSERT, лучше воспользоваться преобразованием «Команда OLE DB». Дополнительные сведения см. в разделе OLE DB Command Transformation.
Создать запрос
Воспользуйтесь диалоговым окном Построитель запросов для визуального конструирования SQL-запроса.
Обзор
Воспользуйтесь диалоговым окном Открыть для выбора файла, содержащего текст SQL-запроса.
Анализ запроса
Проверить синтаксис текста запроса.
Редактор назначения OLE DB (страница «Сопоставления»)
Страница Сопоставления диалогового окна Редактор назначения «OLE DB» используется для сопоставления входных столбцов с целевыми.
Параметры
Доступные входные столбцы
Просмотрите список доступных входных столбцов. Для сопоставления доступных входных столбцов с целевыми столбцами используется операция перетаскивания.
Доступные целевые столбцы
Просмотрите список доступных целевых столбцов. Чтобы сопоставить доступные целевые столбцы с входными столбцами, воспользуйтесь операцией перетаскивания.
Целевой столбец
Позволяет просмотреть каждый из доступных целевых столбцов без учета наличия или отсутствия сопоставления.
Редактор назначения «OLE DB» (страница «Вывод ошибок»)
Страница Вывод ошибок диалогового окна Редактор назначения «OLE DB» используется для задания параметров обработки ошибок.
Параметры
Ввод-вывод
Просмотрите имя входных данных.
Столбец
Не используется.
Error
Задайте действие, которое необходимо выполнить при возникновении ошибки: пропустить ошибку, перенаправить строку или вызвать сбой компонента.
Усечение
Не используется.
Описание
Просмотрите описание операции.
Присвоить указанное значение выбранным ячейкам
Укажите действие, которое необходимо применить ко всем выбранным ячейкам при возникновении ошибки или усечения: пропустить ошибку, перенаправить строку или вызвать сбой компонента.
Применить
Применить параметр обработки ошибок к выбранным ячейкам.
