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

Назначение Oracle

  • Статья

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

Назначение Oracle позволяет выполнять массовые загрузки данных в Oracle Database.

Для подключения к источнику данных это назначение использует диспетчер подключений Oracle. Дополнительные сведения см. в статье о диспетчере подключений Oracle.

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

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

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

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

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

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

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

  • Код ошибки. Номер, обозначающий тип текущей ошибки. Код ошибки может быть получен из таких источников:

    • Сервер Oracle. Подробное описание ошибки см. в документации по базе данных Oracle.
    • Среда выполнения Integration Services. Список кодов ошибок служб SSIS см. в «Справочнике по кодам ошибок и сообщениям служб SIS».

  • Столбец с ошибкой. Номер исходного столбца, который вызывает ошибки преобразования.

  • Столбцы данных с ошибкой. Данные, которые вызывают ошибку.

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

Свойство Максимальное количество ошибок (MaxErrors) позволяет задать максимальное число ошибок, которые могут возникнуть. Если достигается это максимальное количество, выполнение останавливается и возвращаются ошибки. При этом в целевую таблицу будут добавлены только записи о выполнении до достижения этого предельного количества. Дополнительные сведения о настройке см. в разделе Редактор назначения Oracle (страница "Диспетчер подключений").

Parallelism

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

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

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

Нет оснований использовать один параллельный сеанс.

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

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

Устранение неполадок с назначением Oracle

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

Пользовательские свойства назначения Oracle

В следующей таблице описаны пользовательские свойства назначения Oracle. Все свойства доступны для чтения и записи.

Имя свойства Тип данных Описание Режим загрузки
BatchSize Целое число Размер пакета для массовой загрузки. Это количество строк, загружаемых в виде одного пакета. Используется только в пакетном режиме.
DefaultCodePage Целое число Кодовая страница, которая используется, если для источника данных нет сведений о кодовой странице.
Примечание. Это свойство задает только Расширенный редактор.		 Используется в обоих режимах.
FastLoad Логическое значение Указывает, используется ли быстрая загрузка. Значение по умолчанию — false. Это свойство можно также задать в редакторе назначения Oracle (страница "Диспетчер подключений"). Используется в обоих режимах.
MaxErrors Целое число Максимальное число ошибок, после превышения которого останавливается поток данных. По умолчанию задано значение 0, что означает отсутствие ограничения на число ошибок.
Используется, если на странице Обработка ошибок выбрано Перенаправить поток. До достижения предельного числа ошибок в вывод ошибок возвращаются все ошибки. Дополнительные сведения см. в разделе Обработка ошибок.		 Используется только в режиме быстрой загрузки.
NoLogging Логическое значение Указывает, отключено ли ведение журнала базы данных. По умолчанию задано значение False. Это означает, что ведение журнала включено. Используется в обоих режимах.
Параллельные Логическое значение Указывает, разрешена ли параллельная загрузка. Значение True указывает, что другие сеансы загрузки могут выполняться для одной и той же целевой таблицы.
Дополнительные сведения см. в разделе Параллелизм.		 Используется только в режиме быстрой загрузки.
TableName Строка Имя таблицы с используемыми данными. Используется в обоих режимах.
TableSubName Строка Уточняющее имя подраздела. Это значение является необязательным.
Примечание. Это свойство можно задать только в Расширенном редакторе.		 Используется только в режиме быстрой загрузки.
TransactionSize Целое число Число операций вставки, которые можно выполнить в рамках одной транзакции. Значение по умолчанию BatchSize. Используется только в пакетном режиме.
TransferBufferSize Целое число Размер буфера передачи. Значение по умолчанию — 64 КБ. Используется только в режиме быстрой загрузки.

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

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

На рисунке ниже показан редактор назначения Oracle. Он содержит такие страницы: "Диспетчер подключений", "Сопоставления" и "Вывод ошибок".

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

Назначение Oracle

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

  • На экране Поток данных конкретного проекта Integration Services щелкните правой кнопкой мыши назначение Oracle и выберите пункт Показать расширенный редактор.

Дополнительные сведения о свойствах, которые вы можете задать в диалоговом окне "Расширенный редактор", см. в разделе Пользовательские свойства назначения Oracle.

Редактор назначения Oracle (страница "Диспетчер подключений")

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

Открытие страницы диспетчера подключений в редакторе назначения Oracle

  • В SQL Server Data Tools откройте пакет SQL Server Integration Services (SSIS) с назначением Oracle.

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

  • В окне "Редактор назначения Oracle" щелкните "Диспетчер подключений".

Параметры

Connection manager

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

Создать

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

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

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

Параметр Описание
Имя таблицы Настройте назначение Oracle для работы в пакетном режиме. Параметры:

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

Размер транзакций. Укажите число операций вставки, которые можно выполнить в рамках одной транзакции. Значение по умолчанию BatchSize.

Размер пакета. Укажите размер пакета (число загружаемых строк) для массовой загрузки.
Имя таблицы — быстрая загрузка Настройте назначение Oracle для работы в режиме быстрой загрузки (прямой загрузки).

Доступные параметры:

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

Параллельная загрузка. Указывает, включена ли параллельная загрузка. Дополнительные сведения см. в разделе Параллелизм.

Без ведения журнала. Этот флажок позволяет отключить ведение журнала базы данных. Этот журнал используется для восстановления базы данных Oracle (он не связан с трассировкой).

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

Все возникающие ошибки будут возвращаться в окне вывода ошибок.

Размер буфера передачи (КБ). Введите размер буфера передачи. Размер по умолчанию — 64 КБ.

Просмотр существующих данных

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

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

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

Открытие страницы "Сопоставления" в редакторе назначения Oracle

  • В SQL Server Data Tools откройте пакет SQL Server Integration Services (SSIS) с назначением Oracle.

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

  • В редакторе назначения Oracle щелкните "Сопоставления".

Параметры

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

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

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

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

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

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

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

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

Примечание

Столбцы неподдерживаемых типов данных будут удалены из сопоставления с предупреждением.

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

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

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

  • В SQL Server Data Tools откройте пакет SQL Server Integration Services (SSIS) с назначением Oracle.

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

  • В окне "Редактор назначения Oracle" щелкните "Вывод ошибок".

Параметры

Действия при ошибке

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

Усечение

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

Дальнейшие действия