Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
SE APLICA A:
Azure Data Factory
Azure Synapse Analytics
Sugerencia
Data Factory en Microsoft Fabric es la próxima generación de Azure Data Factory, con una arquitectura más sencilla, inteligencia artificial integrada y nuevas características. Si no está familiarizado con la integración de datos, comience con Fabric Data Factory. Las cargas de trabajo de ADF existentes pueden actualizarse a Fabric para acceder a nuevas funcionalidades en ciencia de datos, análisis en tiempo real e informes.
En este artículo se describe cómo usar la actividad de copia en canalizaciones de Azure Data Factory y Synapse Analytics para copiar datos de un almacén de datos de Microsoft Access. 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
Este conector Microsoft Access se admite para las siguientes funcionalidades:
| Funcionalidades admitidas | IR |
|---|---|
| Actividad de copia (origen/receptor) | ② |
| Actividad de búsqueda | ② |
① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado
Consulte la tabla de almacenes de datos compatibles para ver una lista de almacenes de datos que la actividad de copia admite como orígenes o receptores.
Requisitos previos
Para usar este conector de Microsoft Access, debe:
- Configure un Integration Runtime autohospedado. Consulte el artículo sobre Integration Runtime autohospedado para más información.
- Instale el controlador ODBC Microsoft Access para el almacén de datos en la máquina Integration Runtime.
Nota:
Este conector funciona con Microsoft Access 2016 versión del controlador ODBC. La versión del controlador recomendada es 16.00.5378.1000 o superior.
Introducción
Para realizar la actividad de copia con una canalización, puede usar una de las siguientes herramientas o SDK:
- Herramienta Copiar datos
- Azure portal
- SDK de .NET
- SDK de Python
- Azure PowerShell
- REST API
- plantilla Azure Resource Manager
Creación de un servicio vinculado para Microsoft Access mediante la interfaz de usuario
Siga estos pasos para crear un servicio vinculado para Microsoft Access en la interfaz de usuario del portal de Azure.
Vaya a la pestaña Administrar del área de trabajo de Azure Data Factory o Synapse y seleccione Servicios vinculados y haga clic en Nuevo:
Busque Access (Acceso) y seleccione el conector Microsoft Access.
Configure los detalles del servicio, pruebe la conexión y cree el 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 de Microsoft Access conector.
Propiedades del servicio vinculado
Se admiten las siguientes propiedades para el servicio vinculado de Microsoft Access:
| Propiedad | Descripción | Obligatorio |
|---|---|---|
| type | La propiedad type debe establecerse en: MicrosoftAccess | Sí |
| connectionString | La cadena de conexión ODBC que excluye la parte de la credencial. Puede especificar la cadena de conexión o usar el DSN del sistema (nombre del origen de datos) que configuró en la máquina de tiempo de ejecución de integración (aún necesita especificar la sección de credenciales en el servicio vinculado en consecuencia). También puede establecer una contraseña en Azure Key Vault y extraer la configuración de password de la cadena de conexión. Consulte las credenciales de Store en Azure Key Vault con más detalles. |
Sí |
| authenticationType | Tipo de autenticación que se usa para conectarse al almacén de datos de Microsoft Access. Los valores permitidos son: Básica y Anónima. |
Sí |
| userName | Especifique el nombre de usuario si usa la autenticación básica. | No |
| password | Especifique la contraseña de la cuenta de usuario que se especificó para el nombre de usuario. Marque este campo como SecureString para almacenarlo de forma segura o referenciar un secreto almacenado en Azure Key Vault. | No |
| credencial | La parte de la credencial de acceso de la cadena de conexión especificada en formato de valor de propiedad específico del controlador. Marque este campo como SecureString. | No |
| connectVia | El Integration Runtime que se utilizará para establecer conexión con el almacén de datos. Se requiere un Integration Runtime autohospedado, como se mencionó en Prerequisites. | Sí |
Ejemplo:
{
"name": "MicrosoftAccessLinkedService",
"properties": {
"type": "MicrosoftAccess",
"typeProperties": {
"connectionString": "Driver={Microsoft Access Driver (*.mdb, *.accdb)};Dbq=<path to your DB file e.g. C:\\mydatabase.accdb>;",
"authenticationType": "Basic",
"userName": "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
},
"connectVia": {
"referenceName": "<name of Integration Runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
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 admitidas por el conjunto de datos de Microsoft Access.
Para copiar datos de Microsoft Access, se admiten las siguientes propiedades:
| Propiedad | Descripción | Obligatorio |
|---|---|---|
| type | La propiedad type del conjunto de datos debe establecerse en: MicrosoftAccessTable | Sí |
| tableName | Nombre de la tabla en el Microsoft Access. | No (si se especifica "query" en el origen de la actividad) Sí para el receptor |
Ejemplo
{
"name": "MicrosoftAccessDataset",
"properties": {
"type": "MicrosoftAccessTable",
"linkedServiceName": {
"referenceName": "<Microsoft Access linked service name>",
"type": "LinkedServiceReference"
},
"typeProperties": {
"tableName": "<table name>"
}
}
}
Las 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 admitidas por el origen de Microsoft Access.
Microsoft Access como origen
Para copiar datos de Microsoft Access, se admiten las siguientes propiedades en la sección source:
| Propiedad | Descripción | Obligatorio |
|---|---|---|
| type | La propiedad type del origen de la actividad de copia debe establecerse en: MicrosoftAccessSource | Sí |
| Query | Utilice la consulta personalizada para leer los datos. Por ejemplo: "SELECT * FROM MyTable". |
No (si se especifica "tableName" en el conjunto de datos) |
Ejemplo:
"activities":[
{
"name": "CopyFromMicrosoftAccess",
"type": "Copy",
"inputs": [
{
"referenceName": "<Microsoft Access input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "MicrosoftAccessSource",
"query": "SELECT * FROM MyTable"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Microsoft Access como receptor
Para realizar la copia de datos en Microsoft Access, se admiten las siguientes propiedades en la sección sink:
| Propiedad | Descripción | Obligatorio |
|---|---|---|
| type | La propiedad type del receptor de la actividad de copia debe establecerse en: MicrosoftAccessSink | Sí |
| writeBatchTimeout | Tiempo de espera para que la operación de inserción por lotes se complete antes de que se agote el tiempo de espera. Los valores permitidos son: intervalos de tiempo. Ejemplo: "00:30:00" (30 minutos). |
No |
| writeBatchSize | Inserta datos en la tabla SQL cuando el tamaño del búfer alcanza el valor writeBatchSize. Los valores permitidos son: enteros (número de filas). |
No (el valor predeterminado es 0, detectado automáticamente) |
| preCopyScript | Especifique una consulta SQL para que la actividad de copia se ejecute antes de escribir datos en el almacén de datos en cada ejecución. Puede usar esta propiedad para limpiar los datos cargados previamente. | No |
| maxConcurrentConnections | Número máximo de conexiones simultáneas establecido para el almacén de datos durante la ejecución de la actividad. Especifique un valor solo cuando quiera limitar las conexiones simultáneas. | No |
Ejemplo:
"activities":[
{
"name": "CopyToMicrosoftAccess",
"type": "Copy",
"inputs": [
{
"referenceName": "<input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<Microsoft Access output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "<source type>"
},
"sink": {
"type": "MicrosoftAccessSink"
}
}
}
]
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 los almacenes de datos que admite la actividad de copia como orígenes y receptores, consulte Almacenes de datos compatibles.