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