Configuración de REST en una actividad de copia
En este artículo, se describe cómo usar la actividad de copia en la canalización de datos para copiar datos desde y hacia un punto de conexión de REST.
En concreto, este conector REST genérico admite lo siguiente:
- La copia de datos desde un punto de conexión de REST mediante los métodos GET o POST y la copia de datos hacia un punto de conexión de REST mediante los métodos POST, PUT o PATCH.
- Paginación en las API REST.
- En el caso de REST como origen, copie la respuesta JSON de REST tal cual o analícela mediante la asignación de esquemas. Solo se admite la carga de respuesta en JSON.
Configuración admitida
Para la configuración de cada pestaña en una actividad de copia, vaya a las secciones siguientes respectivamente.
General
Para la configuración de la ficha General, vaya a General.
Source
Las siguientes propiedades son compatibles con REST en la pestañaOrigen de una actividad de copia.
Se requieren las primeras tres propiedades siguientes:
- Tipo de almacén de datos: seleccione Externo.
- Conexión: seleccione una conexión REST en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de REST al seleccionar Nuevo.
- Tipo de conexión: seleccione REST.
- Dirección URL relativa: una dirección URL relativa al recurso que contiene los datos. Si no se especifica esta propiedad, solo se usará la dirección URL especificada en la definición de la conexión. El conector HTTP copia los datos de la dirección URL combinada:
[URL specified in connection]/[relative URL specified].
En Avanzado, puede especificar los campos siguientes:
Método de solicitud: Método HTTP. Los valores permitidos son GET (valor predeterminado) y POST.
Tiempo de espera de la solicitud : El tiempo de espera (el valor de timespan) para que la solicitud HTTP obtenga una respuesta. Este valor es el tiempo de espera para obtener una respuesta, no para leer los datos de la respuesta. El valor predeterminado es 00:01:40.
Intervalo de solicitud (ms): tiempo de intervalo entre diferentes solicitudes para varias páginas en milisegundos. El valor del intervalo de solicitudes debe ser un número entre [10, 60000].
Encabezados adicionales: Encabezados de solicitud HTTP adicionales.
Reglas de paginación: las reglas de paginación para componer las solicitudes de página siguiente. Vea la sección de compatibilidad con la paginación para obtener más información.
Columnas adicionales: agregue más columnas de datos a la ruta de acceso relativa o al valor estático de los archivos de origen. Si usa un valor estático, puede usar expresiones personalizadas para generarlo.
Destino
Las siguientes propiedades son compatibles con REST en la pestaña Destino de una actividad de copia.
Se requieren las primeras tres propiedades siguientes:
- Tipo de almacén de datos: seleccione Externo.
- Conexión: seleccione una conexión REST en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de REST al seleccionar Nuevo.
- Tipo de conexión: seleccione REST.
- Dirección URL relativa: una dirección URL relativa al recurso que contiene los datos. Si no se especifica esta propiedad, solo se usará la dirección URL especificada en la definición de la conexión. El conector HTTP copia los datos de la dirección URL combinada:
[URL specified in connection]/[relative URL specified].
En Avanzado, puede especificar los campos siguientes:
Método de solicitud: Método HTTP. Los valores permitidos son POST (valor predeterminado), PUT y PATCH.
Tiempo de espera de la solicitud : El tiempo de espera (el valor de timespan) para que la solicitud HTTP obtenga una respuesta. Este valor es el tiempo de espera para obtener una respuesta, no para escribir los datos. El valor predeterminado es 00:01:40.
Intervalo de solicitud (ms): tiempo de intervalo entre diferentes solicitudes para varias páginas en milisegundos. El valor del intervalo de solicitudes debe ser un número entre [10, 60000].
Tamaño del lote de escritura: número de registros por escribir en el destino de REST por lote. El valor predeterminado es 10000.
Tipo de compresión HTTP: tipo de compresión HTTP que se va a usar al enviar datos con un nivel de compresión óptimo. Los valores permitidos son ninguno y GZip.
Encabezados adicionales: encabezados de solicitud HTTP adicionales.
Asignación
Para la configuración de la pestaña Asignación, vaya a Configuración de las asignaciones en la pestaña asignación. No se admite la asignación cuando tanto el origen como el destino son datos jerárquicos.
Configuración
Para la configuración de la pestaña Parámetros, vaya a Configurar los otros parámetros en parámetros de pestaña.
Resumen de tabla
Las tablas siguientes contienen más información sobre la actividad de copia en REST.
Información de origen
| Nombre | Descripción | Value | Obligatorio | Propiedad de script JSON |
|---|---|---|---|---|
| Tipo de almacén de datos | El tipo de almacén de datos. | • Área de trabajo • Externo • Conjunto de datos de ejemplo |
Sí | type |
| Connection | La conexión al almacén de datos de origen. | <su conexión> | Sí | conexión |
| Tipo de conexión | El tipo de conexión. Seleccione REST. | REST | Sí | type: RestResource |
| Dirección URL relativa | Dirección URL relativa al recurso que contiene los datos. Si no se especifica esta propiedad, solo se usará la dirección URL especificada en la definición de la conexión. El conector HTTP copia los datos de la dirección URL combinada: [URL specified in connection]/[relative URL specified]. |
<dirección URL relativa> | No | relativeUrl |
| Método de solicitud | Método HTTP. Los valores permitidos son GET (valor predeterminado) y POST. | • GET • POST |
No | requestMethod |
| Tiempo de espera de solicitud | El tiempo de espera (el valor de timespan) para que la solicitud HTTP obtenga una respuesta. Este valor es el tiempo de espera para obtener una respuesta, no para leer los datos de la respuesta. El valor predeterminado es 00:01:40. | timespan | No | httpRequestTimeout |
| Intervalo de solicitud (ms) | Tiempo de intervalo entre diferentes solicitudes de varias páginas en milisegundos. El valor del intervalo de solicitudes debe ser un número entre [10, 60000]. | [10, 60000] | No | requestInterval |
| Encabezados adicionales | Encabezados de solicitud HTTP adicionales. | <encabezados adicionales> | No | additionalHeaders |
| Reglas de paginación | Las reglas de paginación para componer las solicitudes de página siguiente. Vea la sección de compatibilidad con la paginación para obtener más información. | Ir a paginación | No | paginationRules |
| Columnas adicionales | Agregue más columnas de datos a la ruta de acceso relativa o al valor estático de los archivos de origen. La expresión se admite para este último. | • Name • Valor |
No | additionalColumns: • nombre • valor |
Información de destino
| Nombre | Descripción | Value | Obligatorio | Propiedad de script JSON |
|---|---|---|---|---|
| Tipo de almacén de datos | El tipo de almacén de datos. | • Área de trabajo • Externo |
Sí | type |
| Connection | La conexión al almacén de datos de origen. | <su conexión> | Sí | conexión |
| Tipo de conexión | El tipo de conexión. Seleccione REST. | REST | Sí | type: RestResource |
| Dirección URL relativa | Dirección URL relativa al recurso que contiene los datos. Si no se especifica esta propiedad, solo se usará la dirección URL especificada en la definición de la conexión. El conector HTTP copia los datos de la dirección URL combinada: [URL specified in connection]/[relative URL specified]. |
<dirección URL relativa> | No | relativeUrl |
| Método de solicitud | Método HTTP. Los valores permitidos son POST (valor predeterminado), PUT y PATCH. | • POST • GET • PATCH |
No | requestMethod |
| Tiempo de espera de solicitud | El tiempo de espera (el valor de timespan) para que la solicitud HTTP obtenga una respuesta. Este valor es el tiempo de espera para obtener una respuesta, no para leer los datos de la respuesta. El valor predeterminado es 00:01:40. | timespan | No | httpRequestTimeout |
| Intervalo de solicitud (ms) | Tiempo de intervalo entre diferentes solicitudes de varias páginas en milisegundos. El valor del intervalo de solicitudes debe ser un número entre [10, 60000]. | [10, 60000] | No | requestInterval |
| Tamaño del lote de escritura | Número de registros por escribir en el destino de REST por lote. El valor predeterminado es 10000. | <número de filas > (entero) |
No | writeBatchSize |
| Tipo de compresión HTTP | Tipo de compresión HTTP que se va a usar al enviar datos con un nivel de compresión óptimo. Los valores permitidos son ninguno y GZip. | • Ninguno • GZip |
No | httpCompressionType |
| Encabezados adicionales | Encabezados de solicitud HTTP adicionales. | <encabezados adicionales> | No | additionalHeaders |