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

Назначение «ODBC»

  • Статья

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

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

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

Назначение ODBC имеет один обычный вывод и один вывод ошибок.

Параметры загрузки

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

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

  • Row-by-row. В этом режиме назначение ODBC подготавливает инструкцию INSERT с параметрами и использует задачу Выполнение SQL для вставки строк друг за другом.

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

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

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

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

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

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

Параллелизм

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

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

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

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

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

Настройка назначения ODBC

Назначение ODBC можно настроить программным способом или с помощью конструктора служб SSIS

Дополнительные сведения см. в одном из следующих разделов:

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

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

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

Дополнительные сведения о свойствах, которые вы можете задать в диалоговом окне «Расширенный редактор», см. в разделе ODBC Destination 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 таблиц, можно ввести начальную часть имени таблицы или воспользоваться символом-шаблоном (*), чтобы ввести любую часть имени для вывода нужных таблиц.

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

Этот список содержит только первые 1000 таблиц. Если база данных содержит больше 1000 таблиц, можно ввести начальную часть имени таблицы или воспользоваться символом-шаблоном (*), чтобы ввести любую часть имени для вывода нужных таблиц.

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

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

Редактор назначения «ODBC» (страница «Сопоставления»)

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

Параметры

Доступные входные столбцы

Список доступных входных столбцов. Перетащите входной столбец в доступный целевой столбец, чтобы сопоставить эти столбцы.

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

Список доступных целевых столбцов. Перетащите целевой столбец в доступный входной столбец, чтобы сопоставить эти столбцы.

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

Позволяет просматривать выбранные входные столбцы. Сопоставления можно удалить, выбрав вариант <ignore>, чтобы исключить столбцы из выходных данных.

Целевой столбец

Просмотрите все доступные целевые столбцы, сопоставленные и несопоставленные.

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

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

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

Список задач

  • В SQL Server Data Tools откройте пакет СЛУЖБ SQL Server 2019 Integration Services (SSIS), имеющий назначение ODBC.

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

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

Параметры

Ввод-вывод

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

Column

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

Ошибка

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

Усечение

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

Описание

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

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

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

Применить

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

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

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

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

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

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

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

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

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