Compartir a través de


Origen OData

Se aplica a: SQL Server SSIS Integration Runtime en Azure Data Factory

Use el componente de origen OData en un paquete SSIS para consumir datos de un servicio de Open Data Protocol (OData).

Protocolos y formatos de datos admitidos

El componente admite los protocolos OData v3 y v4.

  • Protocolo OData V3: el componente admite los formatos de datos JSON y ATOM.

  • Protocolo OData V4: el componente admite el formato de datos JSON.

Orígenes de datos admitidos

El origen OData incluye compatibilidad con los orígenes de datos siguientes:

  • Microsoft Dynamics AX Online y Microsoft Dynamics CRM Online
  • Listas de SharePoint. Para ver todas las listas en un servidor de SharePoint, use la dirección URL siguiente: https://<server>/_vti_bin/ListData.svc. Para obtener más información sobre las convenciones de direcciones URL de SharePoint, vea Interfaz de REST de SharePoint Foundation.

Tipos de datos admitidos

El origen OData admite los siguientes tipos de datos simples: int, byte[], bool, byte, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string y TimeSpan.

Para detectar los tipos de datos de las columnas del origen de datos, vea la página https://<OData feed endpoint>/$metadata.

En el caso del tipo de datos decimal, los metadatos de origen determinan la precisión y la escala. Si los metadatos de origen no especifican las propiedades Precisión y Escala, los datos se podrían truncar.

Importante

El componente de origen de OData no admite tipos complejos, como los elementos de opción múltiple, en las listas de SharePoint.

Nota

Si el origen solo permite la conexión TLS 1.2, debe aplicar TLS 1.2 en el equipo a través de la configuración del Registro. En un símbolo del sistema con privilegios elevados, ejecute los comandos siguientes:

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

Formato y rendimiento de OData

La mayoría de los servicios de OData puede devolver resultados en varios formatos. Puede especificar el formato del conjunto de resultados mediante la opción de consulta $format. Los formatos como JSON y JSON Light son más eficaces que ATOM o XML, y pueden conseguir mejor rendimiento cuando se transfieren grandes cantidades de datos. En la tabla siguiente se muestran resultados de pruebas de ejemplo. Como puede ver, hubo una mejora del rendimiento del 30-53 % al cambiar de ATOM a JSON y del 67 % cuando se cambió de ATOM al nuevo formato JSON Light (disponible en WCF Data Services 5.1).

Filas ATOM JSON JSON (Light)
10000 113 segundos 74 segundos 68 segundos
1000000 1110 segundos 853 segundos 665 segundos

Editor de origen OData (página Conexión)

Use la página Conexión del cuadro de diálogo Editor de origen OData para seleccionar el administrador de conexiones OData para el origen OData. Esta página también permite especificar una ruta de acceso de colección o a recursos y las opciones de consulta deseadas para indicar qué datos hay que recuperar del origen OData.

Opciones estáticas

Administrador de conexiones OData
Seleccione un administrador de conexiones de la lista o cree una conexión haciendo clic en Nuevo.

Después de seleccionar o crear un administrador de conexiones, el cuadro de diálogo muestra la versión del Protocolo OData que está utilizando el Administrador de conexiones.

Nuevo
Cree un administrador de conexiones mediante el cuadro de diálogo Editor del administrador de conexiones OData .

Usar ruta de acceso de colección o a recursos
Especifique el método para seleccionar datos del origen.

Opción Descripción
Colección Recupera datos del origen OData mediante un nombre de colección.
Ruta de acceso a recursos Recupera datos del origen OData mediante una ruta de acceso a recursos.

Opciones de consulta
Especifique las opciones de consulta. Por ejemplo: $top=5

Dirección URL de fuente
Muestra la dirección URL de la fuente de solo lectura según las opciones que ha seleccionado en este cuadro de diálogo.

Versión preliminar
Muestra una vista previa de los resultados mediante el cuadro de diálogo Vista previa . Vista previa puede mostrar hasta 20 filas.

Opciones dinámicas

Usar ruta de acceso de colección o de recurso = Colección

Colección
Seleccione una colección de la lista desplegable.

Usar ruta de acceso de colección o de recurso = Ruta de acceso a recursos

Resource path
Escriba una ruta de acceso a recursos. Por ejemplo: Empleados

Editor de origen OData (página Columnas)

Use la página Columnas del cuadro de diálogo Editor de origen OData para seleccionar las columnas externas (origen) que se van a incluir en la salida y asignarlas a columnas de salida.

Opciones

Columnas externas disponibles
Muestra la lista de columnas de origen disponibles en el origen de datos. Use las casillas de la lista para agregar o quitar columnas a la tabla en la parte inferior de la página. Las columnas seleccionadas se agregan a la salida.

Columna externa
Muestra las columnas de origen que eligió incluir en la salida.

Columna de salida
Permite proporcionar un nombre único para cada columna de salida. El nombre predeterminado es el nombre de la columna externa (origen) seleccionada; sin embargo, puede elegir un nombre único y descriptivo.

Editor de origen OData (página Salida de error)

Use la página Salida de error del cuadro de diálogo Editor de origen OData para seleccionar opciones de control de errores y establecer las propiedades en las columnas de salida de errores.

Opciones

Entrada/salida
Muestra el nombre del origen de datos.

Columna
Muestra las columnas externas (origen) que se han seleccionado en la página Administrador de conexiones del cuadro de diálogo Editor de origen OData .

Error
Permite especificar qué debe ocurrir cuando se produce un error: omitir el error, redirigir la fila o hacer que el componente no funcione.

Temas relacionados: Control de errores en los datos

Truncamiento
Permite especificar qué debe ocurrir cuando se produce un truncamiento: omitir el error, redirigir la fila o hacer que el componente no funcione.

Descripción
Muestra la descripción del error.

Establecer este valor en las celdas seleccionadas
Permite especificar qué debe ocurrir en todas las celdas seleccionadas cuando se produce un error o un truncamiento: omitir el error, redirigir la fila o hacer que el componente no funcione.

Aplicar
Aplica la opción de control de errores a las celdas seleccionadas.

Consulte también

Administrador de conexiones OData