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

ODBC-источник

  • Статья

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Источник ODBC извлекает данные из базы данных с поддержкой ODBC с использованием таблицы базы данных, представления или инструкции SQL.

В источнике ODBC предусмотрены следующие режимы доступа к данным для извлечения данных.

  • Таблица или представление.

  • Результат выполнения инструкции SQL.

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

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

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

Обработка ошибок

Источник ODBC имеет вывод ошибок. Вывод ошибок компонента включает следующие выходные столбцы.

  • Код ошибки. Номер, который соответствует текущей ошибке. См. документацию для базы данных с поддержкой ODBC, которая используется для получения списка ошибок. Список кодов ошибок служб SSIS см. в «Справочнике по кодам ошибок и сообщениям служб SIS».

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

  • Стандартные устройства вывода столбцов данных.

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

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

Сведения о типах данных, поддерживаемых источником ODBC, см. в информации о компоненте "Соединитель для ODBC".

Параметры извлечения

Источник ODBC работает в пакетном ( Batch ) или построчном ( Row-by-Row ) режиме. Используемый режим определяется свойством FetchMethod . Описания режимов приведены в следующем списке.

  • Batch: компонент предпринимает попытку использовать наиболее эффективный метод выборки на основе предполагаемых возможностей поставщика ODBC. Для наиболее современных поставщиков ODBC этим методом является SQLFetchScroll с привязкой массива (где размер массива определяется свойством BatchSize ). Если выбран режим Batch , а поставщик не поддерживает этот способ выборки, назначение ODBC автоматически переключается на режим Row-by-row .

  • Row-by Row: компонент использует метод SQLFetch для получения строк друг за другом.

Дополнительные сведения о свойстве FetchMethod см. в разделе ODBC Source Custom Properties.

Parallelism

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

Однако количество параллельных соединений через поставщика может быть ограничено в используемом поставщике ODBC. Эти ограничения задают количество параллельных экземпляров, которые могут поддерживаться для источника ODBC. Разработчик служб SSIS должен знать ограничения всех используемых поставщиков ODBC и учитывать их при построении пакетов служб SSIS.

Устранение нарушений в работе источника ODBC

Предусмотрена возможность вести журнал вызовов к внешним поставщикам данных, выполняемых источником ODBC. Эту возможность ведения журнала можно использовать для устранения нарушений, связанных с загрузкой данных из внешних источников данных, выполняемой источником ODBC. Для ведения журнала вызовов к внешним поставщикам данных, выполняемых источником ODBC, включите трассировку диспетчера драйвера ODBC. Дополнительные сведения см. в документации Майкрософт по теме Как формировать трассировку ODBC с помощью администратора источника данных ODBC.

Настройка ODBC-источника

Источник ODBC вы можете настраивать программным путем или с помощью конструктора SSIS.

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

Открытие диалогового окна Расширенный редактор .

  • На экране Поток данных проекта SQL Server 2019 Integration Services (SSIS) щелкните правой кнопкой мыши источник ODBC и выберите Показать Расширенный редактор.

Дополнительные сведения о свойствах, которые вы можете задать в диалоговом окне «Расширенный редактор», см. в разделе ODBC Source Custom Properties.

в этом разделе

Редактор источника «ODBC» (страница «Диспетчер соединений»)

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

Список задач

Открытие страницы диспетчера соединений в редакторе источника ODBC

  • В среде SQL Server Data Tools откройте пакет SQL Server 2019 Integration Services (SSIS), который содержит источник ODBC.

  • На вкладке Поток данных дважды щелкните источник ODBC.

Параметры

Диспетчер соединений

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

Создать

Нажмите кнопку Создать. Откроется диалоговое окно Настройка редактора диспетчера соединений ODBC , где можно создать новый диспетчер соединений ODBC.

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

Выберите метод выбора данных из источника. Доступные параметры показаны в следующей таблице.

Параметр Описание
Имя таблицы Получение данных из таблицы или представления в источнике данных ODBC. Если выбран этот параметр, выберите значение из следующего списка.
Имя таблицы или представления. Выберите доступную таблицу или представление из списка или введите регулярное выражение, определяющее таблицу.
Этот список содержит только первые 1000 таблиц. Если база данных содержит больше 1000 таблиц, можно ввести начальную часть имени таблицы или воспользоваться символом-шаблоном (*), чтобы ввести любую часть имени для вывода нужных таблиц.
Команда SQL Получение данных из источника данных ODBC с помощью SQL-запроса. Запрос следует писать с соблюдением синтаксиса исходной базы данных, в которой будет работать запрос. Если выбран этот параметр, введите запрос одним из следующих способов.
Введите текст SQL-запроса в поле Текст команды SQL .
Нажмите кнопку Обзор , чтобы загрузить SQL-запрос из текстового файла.
Чтобы проверить синтаксис текста запроса, нажмите кнопку Анализ запроса .

Предварительный просмотр

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

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

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

Список задач

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

  1. В среде SQL Server Data Tools откройте пакет SQL Server 2019 Integration Services (SSIS), который содержит источник ODBC.

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

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

Параметры

Доступные внешние столбцы

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

Чтобы выбрать все столбцы, установите флажок Выделить все .

Внешний столбец

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

Выходной столбец

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

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

Страница Вывод ошибок диалогового окна Редактор источника ODBC используется для выбора параметров обработки ошибок.

Список задач

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

  • В среде SQL Server Data Tools откройте пакет SQL Server 2019 Integration Services (SSIS), который содержит источник ODBC.

  • На вкладке Поток данных дважды щелкните источник ODBC.

  • В окне Редактор источника ODBCнажмите кнопку Вывод ошибок.

Параметры

Ввод-вывод

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

Столбец

Не используется.

Ошибка

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

Усечение

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

Описание

Не используется.

Присвоить указанное значение выбранным ячейкам

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

Применить

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

Параметры обработки ошибок

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

Компонент, завершившийся сбоем

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

Пропуск неудачи

Ошибка или усечение пропускается.

Перенаправление потока

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