Настройка REST в действии копирования

В этой статье описывается, как использовать действие копирования в конвейере для копирования данных из конечной точки REST и из нее.

В частности, этот универсальный соединитель REST поддерживает следующее:

  • Копирование данных из конечной точки REST с помощью методов GET или POST и копирования данных в конечную точку REST с помощью методов POST, PUT или PATCH .
  • Разбиение на страницы в REST API.
  • Для REST в качестве источника скопируйте ответ JSON в неизменном виде или выполните синтаксический анализ с помощью сопоставления схем. Поддерживается только полезная нагрузка ответа в JSON.

Поддерживаемая конфигурация

Для настройки каждой вкладки в действии копирования перейдите к следующим разделам соответственно.

General

Для настройки вкладки "Общие " перейдите к разделу "Общие".

Исходный материал

Следующие свойства поддерживаются для REST на вкладке "Источник " действия копирования.

Требуются следующие первые три свойства:

  • Подключение. Выберите подключение REST из списка подключений. Если подключение отсутствует, создайте новое подключение REST, нажав кнопку "Создать".
  • Тип подключения: выберите REST.
  • Относительный URL-адрес: относительный URL-адрес ресурса, содержащего данные. Если это свойство не указано, используется только URL-адрес, указанный в определении подключения. Соединитель HTTP копирует данные из объединенного URL-адреса: [URL specified in connection]/[relative URL specified]

В разделе "Дополнительно" можно указать следующие поля:

  • Метод запроса: метод HTTP. Допустимые значения: GET (по умолчанию) и POST.

    Снимок экрана: метод запроса.

  • Время ожидания запроса: время ожидания (значение интервала времени) для HTTP-запроса, чтобы получить ответ. Это значение — время ожидания для получения ответа, а не время ожидания для чтения данных ответа. Значение по умолчанию — 00:01:40.

  • Интервал запроса (мс): интервал между разными запросами для нескольких страниц в миллисекундах. Значение интервала запроса должно быть числом между [10, 60000].

  • Дополнительные заголовки: дополнительные заголовки HTTP-запроса.

    Снимок экрана: дополнительные заголовки.

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

    Снимок экрана: правила разбиения на страницы.

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

    Снимок экрана: дополнительные столбцы.

Место назначения

Следующие свойства поддерживаются для REST на вкладке "Назначение " действия копирования.

Требуются следующие первые три свойства:

  • Подключение. Выберите подключение REST из списка подключений. Если подключение отсутствует, создайте новое подключение REST, нажав кнопку "Создать".
  • Тип подключения: выберите REST.
  • Относительный URL-адрес: относительный URL-адрес ресурса, содержащего данные. Если это свойство не указано, используется только URL-адрес, указанный в определении подключения. Соединитель HTTP копирует данные из объединенного URL-адреса: [URL specified in connection]/[relative URL specified]

В разделе "Дополнительно" можно указать следующие поля:

  • Метод запроса: метод HTTP. Допустимые значения: POST (по умолчанию), PUT и PATCH.

  • Время ожидания запроса: время ожидания (значение интервала времени) для HTTP-запроса, чтобы получить ответ. Это значение — время ожидания для получения ответа, а не время ожидания для записи данных. Значение по умолчанию — 00:01:40.

  • Интервал запроса (мс): интервал между разными запросами для нескольких страниц в миллисекундах. Значение интервала запроса должно быть числом между [10, 60000].

  • Размер пакета записи: количество записей для записи в место назначения REST для каждого пакета. Значение по умолчанию — 10000.

  • Тип сжатия HTTP: тип сжатия HTTP для использования при отправке данных с оптимальным уровнем сжатия. Допустимые значения — None и GZip.

  • Дополнительные заголовки: дополнительные заголовки HTTP-запроса.

    Снимок экрана: дополнительные заголовки.

Картирование

Для конфигурации вкладки "Сопоставление " перейдите к разделу "Настройка сопоставлений" на вкладке "Сопоставление". Сопоставление не поддерживается, если исходные и целевые данные являются иерархическими данными.

Settings

Для конфигурации вкладки "Параметры " перейдите к разделу "Настройка других параметров" на вкладке "Параметры".

Сводка таблицы

В следующих таблицах содержатся дополнительные сведения о действии копирования в REST.

Исходная информация

Имя Description Ценность Обязательно Свойство скрипта JSON
Подключение Ваше подключение к исходному хранилищу данных. <подключение> Да connection
Тип подключения Тип подключения. Выберите REST. REST Да тип:
RestResource
Относительный URL-адрес Относительный URL-адрес ресурса, содержащего данные. Если это свойство не указано, используется только URL-адрес, указанный в определении подключения. Соединитель HTTP копирует данные из объединенного URL-адреса: [URL specified in connection]/[relative URL specified] <относительный URL-адрес> нет relativeUrl
Метод запроса Метод HTTP. Допустимые значения: GET (по умолчанию) и POST. GET
POST
нет requestMethod
Время ожидания запроса Время ожидания (значение интервала времени) для HTTP-запроса, чтобы получить ответ. Это значение — время ожидания для получения ответа, а не время ожидания для чтения данных ответа. Значение по умолчанию — 00:01:40. временной промежуток нет httpRequestTimeout
Интервал запроса (мс) Интервал между разными запросами для нескольких страниц в миллисекундах. Значение интервала запроса должно быть числом между [10, 60000]. [10, 60000] нет requestInterval
Дополнительные заголовки Дополнительные заголовки HTTP-запроса. <ваши дополнительные заголовки> нет additionalHeaders
Правила разбиения на страницы Правила пагинации для составления последующих запросов страниц. Дополнительные сведения см. в разделе поддержки разбиения на страницы . Перейти на пагинацию нет paginationRules
Дополнительные столбцы Добавьте дополнительные столбцы данных в относительный путь или статическое значение исходных файлов хранилища. Выражение поддерживается для последнего варианта. •Имя
•Ценность
нет дополнительныеКолонки
•имя
•ценность

Сведения о назначении

Имя Description Ценность Обязательно Свойство скрипта JSON
Подключение Ваше подключение к исходному хранилищу данных. <подключение> Да connection
Тип подключения Тип подключения. Выберите REST. REST Да тип:
RestResource
Относительный URL-адрес Относительный URL-адрес ресурса, содержащего данные. Если это свойство не указано, используется только URL-адрес, указанный в определении подключения. Соединитель HTTP копирует данные из объединенного URL-адреса: [URL specified in connection]/[relative URL specified] <относительный URL-адрес> нет relativeUrl
Метод запроса Метод HTTP. Допустимые значения: POST (по умолчанию), PUT и PATCH. POST
GET
ИСПРАВЛЕНИЕ
нет requestMethod
Время ожидания запроса Время ожидания (значение интервала времени) для HTTP-запроса, чтобы получить ответ. Это значение — время ожидания для получения ответа, а не время ожидания для чтения данных ответа. Значение по умолчанию — 00:01:40. временной промежуток нет httpRequestTimeout
Интервал запроса (мс) Интервал между разными запросами для нескольких страниц в миллисекундах. Значение интервала запроса должно быть числом между [10, 60000]. [10, 60000] нет requestInterval
размер пакета записи Количество записей для записи в REST-назначение в одном пакете. Значение по умолчанию — 10000. <количество строк>
(целое число)
нет writeBatchSize (размер батча записи)
Тип сжатия HTTP Тип сжатия HTTP для использования при отправке данных с оптимальным уровнем сжатия. Допустимые значения — None и GZip. Нет
GZip
нет httpCompressionType
Дополнительные заголовки Дополнительные заголовки HTTP-запроса. <ваши дополнительные заголовки> нет additionalHeaders