Источник «OData»

  • Статья

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

Компонент источника OData используется в пакете служб SSIS для получения данных от служб OData.

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

Этот компонент поддерживает протоколы OData версии 3 и 4.

  • Для протокола OData версии 3 компонент поддерживает форматы данных ATOM и JSON.

  • Для протокола OData версии v4; компонент поддерживает формат данных JSON.

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

Источник OData поддерживает следующие источники данных:

  • Microsoft Dynamics AX Online и Microsoft Dynamics CRM Online.
  • Списки SharePoint. Увидеть все списки на сервере SharePoint можно по следующему URL-адресу: https://<server>/_vti_bin/ListData.svc. Дополнительные сведения о соглашениях об URL-адресах SharePoint см. в разделе Интерфейс REST SharePoint Foundation.

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

Источник OData поддерживает следующие простые типы данных: int, byte[], bool, byte, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string и TimeSpan.

Чтобы просмотреть типы данных столбцов в источнике данных, проверьте страницу https://<OData feed endpoint>/$metadata.

Для типа данных Decimal точность и масштаб определяются исходными метаданными. Если в исходных метаданных не заданы свойства Точность и Масштаб, данные могут быть усечены.

Внимание

Компонент источника OData не поддерживает сложные типы в списках SharePoint, такие как элементы множественного выбора.

Примечание.

Если источник разрешает только подключение TLS 1.2, необходимо принудительно применить TLS 1.2 на компьютере с помощью параметров реестра. В командной строке с повышенными привилегиями выполните следующие команды:

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:64

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:32

Формат OData и производительность

Большинство служб OData могут возвращать результаты в различных форматах. Можно указать формат результирующего набора с помощью параметра запроса $format. Такие форматы, как JSON и JSON Light, более эффективны, чем ATOM или XML, и способны обеспечить более высокую производительность при передаче больших объемов данных. В следующей таблице отображаются результаты типовых тестов. Как видно, прирост производительности составил 30–53 % при переходе от ATOM к JSON и 67 % при переходе от ATOM к новому формату JSON Light (доступный в WCF Data Services 5.1).

Строки ATOM JSON JSON (Light)
10000 113 секунд 74 секунды 68 секунд
1000 000 1110 секунд 853 секунды 665 с

Редактор источника «OData» (страница «Подключение»)

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

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

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

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

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

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

Вариант Описание
Коллекция Извлечение данных из источника OData с помощью имени коллекции.
Путь к ресурсу Извлечение данных из источника OData с помощью пути к ресурсу.

Параметры запроса
Укажите параметры запроса. Например: $top=5

URL-адрес канала
Отображает доступный только для чтения URL-адрес веб-канала на основе параметров, выбранных в этом диалоговом окне.

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

Динамические параметры

Использование пути к коллекции или ресурсу = коллекция

Коллекция
Выберите коллекцию из раскрывающегося списка.

Использование пути к коллекции или ресурсу = путь к ресурсу

Resource path
Введите путь к ресурсу. Например: Employees

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

На странице Столбцы диалогового окна Редактор источника OData можно выбрать внешние (исходные) столбцы, которые должны быть включены в выходные данные, и сопоставить их с выходными столбцами.

Параметры

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

См. также

Диспетчер подключений OData