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


Источник ADO NET

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

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

Для подключения к База данных SQL Microsoft Azure можно использовать источник ADO NET. Подключение к База данных SQL с помощью OLE DB не поддерживается. Дополнительные сведения о База данных SQL см. в разделе "Общие рекомендации и ограничения" (База данных SQL Azure).

Поддержка типов данных

Источник преобразует любой тип данных, который не сопоставляется с определенным типом данных Служб Integration Services с типом данных DT_NTEXT Integration Services. Преобразованию подвергаются даже данные типа System.Object.

Тип данных DT_NTEXT можно изменить на тип DT_WSTR, а DT_WSTR на DT_NTEXT. Типы данных меняются установкой свойства DataType в диалоговом окне Расширенный редактор источника ADO NET. Дополнительные сведения см. в статье Common Properties.

Тип данных DT_NTEXT можно также преобразовать в типы DT_BYTES и DT_STR с помощью преобразования «Конвертация данных» после источника ADO NET. Дополнительные сведения см. в статье Data Conversion Transformation.

В службах Integration Services типы данных даты, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 и DT_DBTIMESTAMPOFFSET сопоставляют с определенными типами данных даты в SQL Server. Вы можете настроить источник ADO NET для преобразования типов данных даты из тех, которые SQL Server использует в те, которые используют службы Integration Services. Чтобы настроить источник ADO NET для преобразования этих типов данных дат, задайте для свойства Type System Version диспетчера подключений ADO.NET значение Latest. (Свойство Версия системы типов находится на странице Все диалогового окна Диспетчер соединений. Чтобы открыть диалоговое окно Диспетчер соединений, щелкните правой кнопкой мыши диспетчер подключений ADO.NET и выберите команду Изменить.)

Примечание.

Если для диспетчера подключений ADO.NET задано свойство Type System Version для SQL Server 2005, система преобразует типы данных даты SQL Server в DT_WSTR.

Система преобразует определяемые пользователем типы данных (определяемые пользователем) в двоичные объекты служб Integration Services (BLOB), когда диспетчер подключений ADO.NET указывает поставщик в качестве поставщика данных .NET для SQL Server (SqlClient). При преобразовании определяемых пользователем типов данных система применяет следующие правила.

  • Если данные не являются большим определяемым пользователем типом, система преобразует данные в тип DT_BYTES.

  • Если данные не являются большим определяемым пользователем типом и свойство Длина столбца базы данных равно -1 или его величина превышает 8000 байт, система преобразует эти данные в тип DT_IMAGE.

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

    Примечание.

    Если источник ADO NET не настроен для использования вывода ошибок на выходе, система передает данные столбцу DT_IMAGE в виде потока фрагментами по 8000 байт. Если источник ADO NET настроен для использования вывода ошибок на выходе, система передает весь массив байтов столбцу DT_IMAGE. Дополнительные сведения о настройке компонентов для использования вывода ошибок на выходе см. в разделе Обработка ошибок в данных.

Дополнительные сведения о типах данных служб Integration Services, поддерживаемых преобразованиях типов данных и сопоставлении типов данных в некоторых базах данных, включая SQL Server, см. в разделе "Типы данных служб Integration Services".

Сведения о сопоставлении типов данных Служб Integration Services с управляемыми типами данных см. в статье "Работа с типами данных" в Поток данных.

Устранение неполадок источника ADO NET

Можно протоколировать вызовы, сделанные источником ADO NET к внешним поставщикам данных. Эта возможность ведения журнала может быть использована для устранения неполадок загрузки данных из внешнего источника, выполняемой источником ADO NET. Чтобы протоколировать вызовы источника ADO NET к внешнему поставщику данных, необходимо разрешить ведение журнала пакета и выбрать событие Диагностика на уровне пакета. Дополнительные сведения см. в разделе Инструменты устранения неполадок при выполнении пакетов.

Настройка источника ADO NET

Источник ADO NET настраивается предоставлением инструкции SQL, которая определяет результирующий набор. Например, источник ADO NET, который подключается к базе данных AdventureWorks2022 и использует инструкцию SQL SELECT * FROM Production.Product , извлекает все строки из таблицы Production.Product и предоставляет набор данных для нисходящего компонента.

Примечание.

При использовании инструкции SQL для вызова хранимой процедуры, возвращающей результаты из временной таблицы, используйте параметр WITH RESULT SET для определения метаданных результирующий набор.

Примечание.

Если вы используете инструкцию SQL для выполнения хранимой процедуры и пакет завершается сбоем со следующей ошибкой, вы можете устранить эту ошибку, добавив инструкцию SET FMTONLY OFF перед инструкцией exec.

Столбец <имя_столбца> не найден в источнике данных.

Источник ADO NET использует диспетчер соединений ADO.NET для подключения к источнику данных, а диспетчер соединений указывает поставщика .NET. Дополнительные сведения см. в статье ADO.NET Connection Manager.

Источник ADO NET имеет один обычный выход и один выход ошибок.

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

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

Дополнительные сведения о настройке свойств см. в разделе Установление свойств компонента потока данных.

Редактор источника данных «ADO.NET» (страница «Диспетчер соединений»)

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

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

Открытие страницы «Диспетчер соединений»

  1. В SQL Server Data Tools (SSDT) откройте пакет служб Integration Services, имеющий источник ADO NET.

  2. На вкладке Поток данных дважды щелкните источник данных "ADO.NET".

  3. В окне Редактор источника «ADO.NET»нажмите кнопку Диспетчер соединений.

Статические параметры

Диспетчер соединений ADO.NET
Выберите из списка существующий диспетчер соединений или создайте новое соединение, нажав кнопку Создать.

Новый
Создайте новый диспетчер соединений с помощью диалогового окна Настройка диспетчера соединений ADO.NET .

Режим доступа к данным
Укажите метод выбора данных из источника.

Вариант Описание
Таблица или представление Извлеките данные из таблицы или представления в источнике данных ADO.NET.
Команда SQL Извлеките данные из источника данных ADO.NET с помощью SQL-запроса.

Предварительный просмотр
Осуществляйте предварительный просмотр результатов в диалоговом окне Просмотр данных . В окнеПредварительный просмотр может отображаться до 200 строк.

Примечание.

При предварительном просмотре столбцы с определяемым пользователем типом данных CLR не содержат данных. Вместо этого отображается текст <value too big to display> (значение слишком велико для отображения) или значение System.Byte[]. Первый отображается при доступе к источнику данных с помощью поставщика ADO.NET, последний при использовании поставщика собственного клиента SQL Server.

Динамические параметры режима доступа к данным

Режим доступа к данным = Таблица или представление

Имя таблицы или представления
Выберите имя таблицы или представления из списка доступных в источнике данных.

Режим доступа к данным — команда SQL

Текст команды SQL
Введите текст SQL-запроса, постройте запрос, нажав кнопку Создать запрос, или выберите файл, содержащий текст запроса, нажав кнопку Обзор.

Создать запрос
Воспользуйтесь диалоговым окном Построитель запросов для визуального конструирования SQL-запроса.

Обзор
Воспользуйтесь диалоговым окном Открыть для выбора файла, содержащего текст SQL-запроса.

Редактор источника «ADO.NET» (страница «Столбцы»)

Страница Столбцы диалогового окна Редактор источника "ADO.NET" используется для сопоставления выходного столбца с каждым внешним (исходным) столбцом.

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

Открытие страницы «Столбцы»

  1. В SQL Server Data Tools (SSDT) откройте пакет служб Integration Services, имеющий источник ADO NET.

  2. На вкладке Поток данных дважды щелкните источник данных "ADO.NET".

  3. В окне Редактор источника «ADO.NET»нажмите кнопку Столбцы.

Параметры

Доступные внешние столбцы
Просмотр списка доступных внешних столбцов источника данных. В этой таблице нельзя добавлять или удалять столбцы.

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

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

Редактор источника данных «ADO.NET» (страница «Вывод ошибок»)

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

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

Открытие страницы «Вывод ошибок»

  1. В SQL Server Data Tools (SSDT) откройте пакет служб Integration Services, имеющий источник ADO NET.

  2. На вкладке Поток данных дважды щелкните источник данных "ADO.NET".

  3. В окне Редактор источника «ADO.NET»нажмите кнопку Вывод ошибок.

Параметры

Ввод-вывод
Просмотр имени источника данных.

Столбец
Просмотрите внешние (исходные) столбцы, выбранные на странице Диспетчер подключений диалогового окна Редактор источника "ADO.NET" .

Ошибка
Задайте действие, которое необходимо выполнить при возникновении ошибки: пропустить ошибку, перенаправить строку или вызвать сбой компонента.

Связанные разделы: обработка ошибок в данных

Усечение
Укажите, что нужно сделать при усечении: пропустить ошибку, перенаправить строку или вызвать сбой компонента.

Description
Просмотреть описание ошибки.

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

Применить
Применить параметр обработки ошибок к выбранным ячейкам.

См. также

Назначение DataReader
Назначение "ADO.NET"
Поток данных