Источник ADO NET
Применимо к:
sql Server SSIS Integration Runtime в фабрике данных Azure
Источник ADO NET использует данные поставщика .NET и делает данные доступными для потока данных.
Источник ADO NET можно использовать для подключения к Базе данных SQL Microsoft Azure. Подключение к базе данных 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 SETS для определения метаданных набора результатов.
Заметка
Если при использовании инструкции 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.
Открытие страницы «Диспетчер соединений»
В SQL Server Data Tools (SSDT) откройте пакет служб Integration Services, имеющий источник ADO NET.
На вкладке Поток данных дважды щелкните источник данных "ADO.NET".
В окне Редактор источника «ADO.NET»нажмите кнопку Диспетчер соединений.
Статические параметры
Диспетчер соединений ADO.NET
Выберите из списка существующий диспетчер соединений или создайте новое соединение, нажав кнопку Создать.
New
Создайте новый диспетчер соединений с помощью диалогового окна Настройка диспетчера соединений ADO.NET .
Режим доступа к данным
Укажите метод выбора данных из источника.
| Вариант | Description |
|---|---|
| Таблица или представление | Извлеките данные из таблицы или представления в источнике данных 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.
Открытие страницы «Столбцы»
В SQL Server Data Tools (SSDT) откройте пакет служб Integration Services, имеющий источник ADO NET.
На вкладке Поток данных дважды щелкните источник данных "ADO.NET".
В окне Редактор источника «ADO.NET»нажмите кнопку Столбцы.
Параметры
Доступные внешние столбцы
Просмотр списка доступных внешних столбцов источника данных. В этой таблице нельзя добавлять или удалять столбцы.
Внешний столбец
Просмотрите внешние столбцы (столбцы в источнике) в том порядке, в котором они отображаются при настройке компонентов, получающих данные из этого источника.
Выходной столбец
Введите уникальное имя для каждого выходного столбца. По умолчанию используется имя выбранного внешнего (исходного) столбца, однако можно выбрать любое уникальное описательное имя. Указанное имя будет отображено в конструкторе служб SSIS.
Редактор источника данных «ADO.NET» (страница «Вывод ошибок»)
Страница Вывод ошибок диалогового окна Редактор источника «ADO.NET» используется для выбора параметров обработки ошибок, а также для установки свойств выходных столбцов ошибок.
Дополнительные сведения об источниках данных «ADO.NET» см. в разделе ADO NET Source.
Открытие страницы «Вывод ошибок»
В SQL Server Data Tools (SSDT) откройте пакет служб Integration Services, имеющий источник ADO NET.
На вкладке Поток данных дважды щелкните источник данных "ADO.NET".
В окне Редактор источника «ADO.NET»нажмите кнопку Вывод ошибок.
Параметры
Ввод-вывод
Просмотр имени источника данных.
Column
Просмотрите внешние (исходные) столбцы, выбранные на странице Диспетчер подключений диалогового окна Редактор источника "ADO.NET" .
Ошибка
Задайте действие, которое необходимо выполнить при возникновении ошибки: пропустить ошибку, перенаправить строку или вызвать сбой компонента.
См. также:Обработка ошибок в данных
Усечение
Укажите, что нужно сделать при усечении: пропустить ошибку, перенаправить строку или вызвать сбой компонента.
Описание
Просмотреть описание ошибки.
Присвоить указанное значение выбранным ячейкам
Укажите действие, которое необходимо применить ко всем выбранным ячейкам при возникновении ошибки или усечения: пропустить ошибку, перенаправить строку или вызвать сбой компонента.
Применить
Применить параметр обработки ошибок к выбранным ячейкам.
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по