Copia de datos de Concur con Azure Data Factory o Synapse Analytics (versión preliminar)
SE APLICA A: 
Azure Data Factory Azure Synapse Analytics
Sugerencia
Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.
Importante
Este conector quedará en desuso el 31 de diciembre de 2024. Se recomienda migrar al Conector ODBC mediante la instalación de un controlador antes de esa fecha.
En este artículo se explica cómo usar la actividad de copia en una canalización de Azure Data Factory o Synapse Analytics para copiar datos de Concur. El documento se basa en el artículo de introducción a la actividad de copia que describe información general de la actividad de copia.
Funcionalidades admitidas
El conector Concur es compatible para las siguientes funcionalidades:
| Funcionalidades admitidas | IR |
|---|---|
| Actividad de copia (origen/-) | ① ② |
| Actividad de búsqueda | ① ② |
① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado
Para obtener una lista de los almacenes de datos que se admiten como orígenes y receptores, consulte la tabla de almacenes de datos admitidos.
El conector admite las versiones de Windows de este artículo.
Nota:
La cuenta del asociado no es compatible actualmente.
Introducción
Para realizar la actividad de copia con una canalización, puede usar una de los siguientes herramientas o SDK:
- La herramienta Copiar datos
- Azure Portal
- El SDK de .NET
- El SDK de Python
- Azure PowerShell
- API REST
- La plantilla de Azure Resource Manager
Creación de un servicio vinculado a Concur mediante la interfaz de usuario
Siga estos pasos para crear un servicio vinculado a Concur en la interfaz de usuario de Azure Portal.
Vaya a la pestaña Administrar del área de trabajo de Azure Data Factory o Synapse y seleccione Servicios vinculados; luego haga clic en Nuevo:
Busque Concur y seleccione el conector de Concur.
Configure los detalles del servicio, pruebe la conexión y cree el nuevo servicio vinculado.
Detalles de configuración del conector
En las secciones siguientes se proporcionan detalles sobre las propiedades que se usan para definir entidades de Data Factory específicas del conector de Concur.
Propiedades del servicio vinculado
Las siguientes propiedades son compatibles con el servicio vinculado de Concur:
| Propiedad | Descripción | Obligatorio |
|---|---|---|
| type | La propiedad type debe establecerse en: Concur | Sí |
| connectionProperties | Grupo de propiedades que define cómo conectarse a Concur. | Sí |
En connectionProperties: |
||
| authenticationType | Los valores permitidos son OAuth_2.0_Bearer y OAuth_2.0 (heredado). La opción de autenticación OAuth 2.0 funciona con la antigua API de Concur que está en desuso desde febrero de 2017. |
Sí |
| host | El punto de conexión del servidor de Concur, por ejemplo, implementation.concursolutions.com. |
Sí |
| baseUrl | Dirección URL base de su dirección URL de autorización de Concur. | Sí para la autenticación OAuth_2.0_Bearer |
| clientId | Id. de cliente de la aplicación proporcionado por la administración de aplicaciones de Concur. | Sí |
| clientSecret | Secreto de cliente correspondiente al Id. de cliente. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault. | Sí para la autenticación OAuth_2.0_Bearer |
| username | Nombre de usuario que utiliza para acceder al servicio de Concur. | Sí |
| password | Contraseña correspondiente al nombre de usuario que ha proporcionado en el campo de nombre de usuario. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault. | Sí |
| useEncryptedEndpoints | Especifica si los puntos de conexión de origen de datos se cifran mediante HTTPS. El valor predeterminado es true. | No |
| useHostVerification | Especifica si se requiere que el nombre de host del certificado del servidor coincida con el nombre de host del servidor al conectarse a través de TLS. El valor predeterminado es true. | No |
| usePeerVerification | Especifica si se debe verificar la identidad del servidor al conectarse a través de TLS. El valor predeterminado es true. | No |
Ejemplo:
{
"name": "ConcurLinkedService",
"properties": {
"type": "Concur",
"typeProperties": {
"connectionProperties": {
"host":"<host e.g. implementation.concursolutions.com>",
"baseUrl": "<base URL for authorization e.g. us-impl.api.concursolutions.com>",
"authenticationType": "OAuth_2.0_Bearer",
"clientId": "<client id>",
"clientSecret": {
"type": "SecureString",
"value": "<client secret>"
},
"username": "fakeUserName",
"password": {
"type": "SecureString",
"value": "<password>"
},
"useEncryptedEndpoints": true,
"useHostVerification": true,
"usePeerVerification": true
}
}
}
}
Ejemplo (heredado):
Tenga en cuenta que el siguiente es un modelo de servicio vinculado heredado sin connectionProperties y que usa la autenticación OAuth_2.0.
{
"name": "ConcurLinkedService",
"properties": {
"type": "Concur",
"typeProperties": {
"clientId" : "<clientId>",
"username" : "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
Propiedades del conjunto de datos
Si desea ver una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte el artículo sobre conjuntos de datos. En esta sección se proporciona una lista de las propiedades compatibles con el conjunto de datos de Concur.
Para copiar datos de Concur, establezca la propiedad type del conjunto de datos en ConcurObject. No hay ninguna propiedad específica de tipo adicional en este tipo de conjunto de datos. Se admiten las siguientes propiedades:
| Propiedad | Descripción | Obligatorio |
|---|---|---|
| type | La propiedad type del conjunto de datos debe establecerse en: ConcurObject | Sí |
| tableName | Nombre de la tabla. | No (si se especifica "query" en el origen de la actividad) |
Ejemplo
{
"name": "ConcurDataset",
"properties": {
"type": "ConcurObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<Concur linked service name>",
"type": "LinkedServiceReference"
}
}
}
Propiedades de la actividad de copia
Si desea ver una lista completa de las secciones y propiedades disponibles para definir actividades, consulte el artículo sobre canalizaciones. En esta sección se proporciona una lista de las propiedades compatibles con el origen de Concur.
ConcurSource como origen
Para copiar datos de Concur, establezca el tipo de origen de la actividad de copia en ConcurSource. Se admiten las siguientes propiedades en la sección source de la actividad de copia:
| Propiedad | Descripción | Obligatorio |
|---|---|---|
| type | La propiedad type del origen de la actividad de copia debe establecerse en: ConcurSource | Sí |
| Query | Use la consulta SQL personalizada para leer los datos. Por ejemplo: "SELECT * FROM Opportunities where Id = xxx ". |
No (si se especifica "tableName" en el conjunto de datos) |
Ejemplo:
"activities":[
{
"name": "CopyFromConcur",
"type": "Copy",
"inputs": [
{
"referenceName": "<Concur input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "ConcurSource",
"query": "SELECT * FROM Opportunities where Id = xxx"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Propiedades de la actividad de búsqueda
Para obtener información detallada sobre las propiedades, consulte Actividad de búsqueda.
Contenido relacionado
Para obtener una lista de almacenes de datos que la actividad de copia admite como orígenes y receptores, vea Almacenes de datos que se admiten.