# Microsoft Fabric Puede utilizar Microsoft Fabric como plataforma de datos de destino en una canalización de datos o en una tarea de replicación. En una canalización de datos, se pueden realizar varias operaciones ELT en la plataforma de destino, incluido el almacenamiento de datos, la transformación de datos, la creación de mercados de datos y el registro de datos. Una tarea de replicación, por otro lado, implica la replicación de datos directamente desde un sistema de origen a un sistema de destino con capacidades de transformación básicas, pero sin soporte para operaciones ELT. Nota informativaRequiere Pasarela de datos de movimiento de datos 2023.5.15 o posterior. Configurar Microsoft Fabric como destino implica: * [Cumplir los requisitos previos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/fabric-target.htm#Prerequi2) * Configurar una conexión a una zona de preparación en la nube (Azure Data Lake Storage). Esto no es necesario si está [registrando datos existentes](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm). * Configurar una conexión a Microsoft Fabric ## Creación de una zona de preparación en la nube Nota informativaSi está [registrando datos existentes](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm), no necesita crear un área de preparación en la nube. También necesita un área de preparación en la nube de Azure Data Lake Storage donde los datos y los cambios se almacenen allí antes de aplicarlos y guardarlos. Para obtener información sobre la configuración de una conexión con Azure Data Lake Storage, vea [Azure Data Lake Storage](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/adls-target.htm). ## Configurar las propiedades de la conexión de Microsoft Fabric Una vez que haya proporcionado la configuración de destino de Azure Data Lake Storage, haga lo siguiente: 1. En Conexiones, haga clic en Crear conexión. 2. Seleccione el conector de destino Microsoft Fabric y luego proporcione la siguiente configuración: ### Destino de datos #### Pasarela de datos Nota informativaEste campo no está disponible con la suscripción Qlik Talend Cloud Starter porque Pasarela de datos de movimiento de datos no se admite con este nivel de suscripción. Solo se requiere una Pasarela de datos de movimiento de datos si la base de datos de destino no está accesible desde Qlik Cloud y solo se puede acceder a ella mediante un vínculo privado (por ejemplo, si está ubicada o en una nube privada virtual). En tal caso, seleccione la Pasarela de datos de movimiento de datos a través de la cual desea acceder a la base de datos de destino. En función del caso de uso que precise, será la misma Pasarela de datos de movimiento de datos implementada para transferir los datos desde la fuente de datos u otra distinta. Para obtener información sobre casos de uso de Pasarela de datos de movimiento de datos, consulte [¿Cuándo es obligatorio Pasarela de datos de movimiento de datos?](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#top) y [Casos de uso habituales](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common). Si es posible acceder directamente a la base de datos de destino desde Qlik Cloud, seleccione Ninguno. Nota informativaAl acceder a la base de datos de destino mediante Pasarela de datos de movimiento de datos, también necesita instalar el controlador adecuado en el equipo de Pasarela de datos de movimiento de datos. Para más detalles, vea [Microsoft Fabric](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/fabric-target.htm#Driver) a continuación. ### Propiedades de la conexión * Servidor: El nombre del servidor Microsoft Fabric Data Warehouse que está utilizando. ### Propiedades de la cuenta Método de autenticación: Seleccione una de las siguientes opciones: * Azure Active Directory Service Principal Luego proporcione su ID de cliente y Secreto de cliente en los campos designados. * Azure Active Directory User Principal Luego proporcione un Nombre de usuario y Contraseña en los campos designados. ### Propiedades de la base de datos * Nombre de la base de datos: hay dos métodos que puede utilizar para especificar una base de datos: * Método 1 - Seleccionarlo de una lista: haga clic en Cargar bases de datos y, a continuación, seleccione una base de datos. * Método 2 - Manualmente: Seleccione Insertar el nombre de la base de datos manualmente e indique el nombre de la base de datos. ### Carga de datos * Token SAS: El token de SAS que utilizará Microsoft Fabric para acceder a la cuenta de almacenamiento ADLS. Esto no es necesario si está [registrando datos existentes](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm). ### Nombre El nombre que mostrará la conexión. ## Requisitos previos ### Permisos en la base de datos Al usuario/principal de servicio de Azure Active Directory especificado en la sección ODBC Access de la configuración de Microsoft Fabric conector se le debe otorgar el rol de Colaborador. ### Configuración del controlador Solo se requiere un controlador si accede a la base de datos a través de Pasarela de datos de movimiento de datos. En tal caso, es necesario instalar el controlador en la máquina de la Pasarela de datos de movimiento de datos. Puede instalar el driver usando la utilidad de instalación del driver (recomendado) o manualmente. La instalación manual solo debe intentarse en el improbable caso de que encuentre un problema con la utilidad de instalación del driver. #### Uso de la utilidad de instalación del driver para instalar el driver/controlador Esta sección describe cómo instalar el driver necesario. El proceso implica ejecutar un script que descargará, instalará y configurará automáticamente el driver requerido. También puede ejecutar secuencias de script para actualizar y desinstalar el driver según sea necesario. Preparar la instalación * Asegúrese de que Python 3.6 o posterior esté instalado en el servidor de la pasarela de Movimiento de datos. Python viene preinstalado en la mayoría de las distribuciones de Linux. Puede verificar qué versión de Python está instalada en su sistema ejecutando el siguiente comando: python3 --version Instalar driver Para descargar e instalar el driver: 1. Detenga el servicio Data Movement gateway: sudo systemctl stop repagent 2. Opcionalmente, confirme que el servicio se ha detenido: sudo systemctl status repagent El estado debería ser el siguiente: Active: inactive (dead) since <timestamp> ago 3. En la máquina de la puerta de enlace de Movimiento de datos, cambie el directorio de trabajo a: opt/qlik/gateway/movement/drivers/bin 4. Ejecute el siguiente comando: Sintaxis: ./install fabric Si no logra descargar el driver (debido a restricciones de acceso o problemas técnicos), aparecerá un mensaje indicándole dónde puede descargar el driver y dónde copiarlo en la máquina de la puerta de enlace de Movimiento de datos. Una vez que haya hecho eso, ejecute nuevamente el comando install fabric. De lo contrario, se mostrará el EULA del driver. 5. Tome una de las opciones siguientes: * Pulse [Intro] repetidamente para desplazarse por el EULA. * Pulse la barra espaciadora repetidamente para desplazarse rápidamente por el EULA. * Pulse q para salir del texto de la licencia y ver las opciones de aceptación del EULA. 6. Tome una de las opciones siguientes: * Escriba "y" y pulse [Intro] para aceptar el EULA y comenzar la instalación. * Escriba "n" y pulse [Intro] para rechazar el EULA y salir de la instalación. * Escriba "v" y pulse [Intro] para ver el EULA de nuevo. Se instalará el driver. 7. Espere a que termine la instalación (indicado mediante la palabra "Completado") y luego inicie el servicio de Data Movement gateway: sudo systemctl start repagent 8. Opcionalmente, confirme que el servicio se ha iniciado: sudo systemctl status repagent El estado debería ser el siguiente: Active: active (running) since <timestamp> ago Actualizar el driver Ejecute el comando de actualización si desea desinstalar versiones anteriores del driver antes de instalar el driver provisto. Para descargar y actualizar el driver: 1. Detenga el servicio Data Movement gateway: sudo systemctl stop repagent 2. Opcionalmente, confirme que el servicio se ha detenido: sudo systemctl status repagent El estado debería ser el siguiente: Active: inactive (dead) since <timestamp> ago 3. En la máquina de la puerta de enlace de Movimiento de datos, cambie el directorio de trabajo a: opt/qlik/gateway/movement/drivers/bin 4. Ejecute el siguiente comando: Sintaxis: ./update fabric Si no logra descargar el driver (debido a restricciones de acceso o problemas técnicos), aparecerá un mensaje indicándole dónde puede descargar el driver y dónde copiarlo en la máquina de la puerta de enlace de Movimiento de datos. Una vez que haya hecho eso, ejecute nuevamente el comando update fabric. De lo contrario, se mostrará el EULA del driver. 5. Tome una de las opciones siguientes: * Pulse [Intro] repetidamente para desplazarse por el EULA. * Pulse la barra espaciadora repetidamente para desplazarse rápidamente por el EULA. * Pulse q para salir del texto de la licencia y ver las opciones de aceptación del EULA. 6. Tome una de las opciones siguientes: * Escriba "y" y pulse [Intro] para aceptar el EULA y comenzar la instalación. * Escriba "n" y pulse [Intro] para rechazar el EULA y salir de la instalación. * Escriba "v" y pulse [Intro] para ver el EULA desde el principio. El driver anterior se desinstalará y se instalará el nuevo driver. 7. Espere a que termine la instalación (indicado mediante la palabra "Completado") y luego inicie el servicio de Data Movement gateway: sudo systemctl start repagent 8. Opcionalmente, confirme que el servicio se ha iniciado: sudo systemctl status repagent El estado debería ser el siguiente: Active: active (running) since <timestamp> ago Desinstalar el driver Ejecute el comando de desinstalación si desea desinstalar el driver. Para desinstalar el driver: 1. Detenga todas las tareas configuradas para utilizar este conector. 2. En la máquina de la puerta de enlace de Movimiento de datos, cambie el directorio de trabajo a: opt/qlik/gateway/movement/drivers/bin 3. Ejecute el siguiente comando: Sintaxis: ./uninstall fabric Se desinstalará el driver. #### Instalar el controlador manualmente Solo debe intentar instalar el driver manualmente si la instalación automática del driver no se realizó correctamente. Debe instalar tanto un controlador ODBC como un controlador JDBC. Instalación del controlador ODBC Una vez que haya instalado Pasarela de datos de movimiento de datos, descargue el controlador msodbcsql<versión>.x86\_64.rpm. Encontrará un enlace de descarga directa a la versión compatible en binary-artifacts, en /opt/qlik/gateway/movement/drivers/manifests/fabric.yaml. Una vez completada la descarga, copie el RPM a la máquina de Pasarela de datos de movimiento de datos. 1. Detenga el servicio Data Movement gateway: sudo systemctl stop repagent 2. Opcionalmente, confirme que el servicio se ha detenido: sudo systemctl status repagent El estado debería ser el siguiente: Active: inactive (dead) since <timestamp> ago 3. Instale el controlador en la máquina de Data Movement gateway. 4. Copie la ubicación del controlador en el archivo `site_arep_login.sh` de la siguiente manera: ``` echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql/lib64/" >> site_arep_login.sh ``` Ejemplo: ``` echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql17/lib64/" >> site_arep_login.sh ``` Esto agregará el controlador a "LD\_LIBRARY\_PATH" y actualizará la ubicación del controlador en el archivo **site\_arep\_login.sh** . 5. Opcionalmente, confirme que se copió la ubicación del controlador: ``` cat site_arep_login.sh ``` 6. Inicie el servicio Data Movement gateway: sudo systemctl start repagent 7. Opcionalmente, confirme que el servicio se ha iniciado: sudo systemctl status repagent El estado debería ser el siguiente: Active: active (running) since <timestamp> ago Instalación del controlador JDBC 1. Descargue los archivos JAR disponibles en binary-artifacts, en /opt/qlik/gateway/movement/drivers/manifests/fabric.yaml: Luego copie los archivos a la siguiente carpeta en la máquina de Pasarela de datos de movimiento de datos: /opt/qlik/gateway/movement/qcs\_agents/qdi-db-commands/lib 2. Reinicie el servicio de Pasarela de datos de movimiento de datos ejecutando el comando descrito en [Reiniciar el servicio](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm#Restarti2) Nota de avisoSi está utilizando una fuente de datos de Microsoft SQL Server (basada en CDC o en registros), la desinstalación del controlador Fabric también interrumpirá la conectividad con SQL Server, ya que comparten el mismo controlador. ### Puertos Abra el puerto 1433 para la comunicación saliente. ## Limitaciones y consideraciones * Las siguientes operaciones no se admiten y no se aplicarán al destino: * Renombrar columna (RENAME column) * DROP/ALTER column * Las columnas recién añadidas (ADD COLUMN) deben ser anulables. Nota informativa A partir de Pasarela de datos de movimiento de datosy 2026.5.1, los tipos de datos de destino se asocian a la longitud de `MAX` en lugar de a `8000`. Para aplicar la asociación a las columnas existentes en tareas de datos registrados, almacenamiento, transformación, data mart y almacén de conocimiento, ejecute `ALTER TABLE` para cambiar el tipo de datos de la columna o volver a crear las tablas. Para otros tipos de tareas, vuelva a crear las tablas. ## Tipos de datos La tabla siguiente muestra los tipos de datos de Microsoft Fabric que ese admiten al utilizar Qlik Cloud y la asignación predeterminada de tipos de datos de Qlik Cloud. La información del tipo de datos nativo se conserva y se muestra en la columna Tipo de datos nativo en las vistas de conjuntos de datos. Si la columna no está visible, debe abrir el selector de columnas de la vista del conjunto de datos y seleccionar la columna Tipo de datos nativo. Tipos de datos que admite | Tipos de datos en Qlik Talend Data Integration | Tipos de datos de Microsoft Fabric | | --- | --- | | BOOL | BIT | | BYTES | Si la longitud es 1-8000, entonces:

VARBINARY (longitud en Bytes)

BYTES se asocian a VARBINARY (MAX) si la longitud supera los 8000 bytes. | | DATE | DATE | | TIME | Si la escala es de 0-6, entonces:

TIME (Scale)

Si la escala excede 6, entonces:

TIME (6) | | TIMESTAMP | Si la escala es de 0-6, entonces:

DATETIME2 (Scale)

Si la escala excede 6, entonces:

DATETIME2 (6) | | INT1 | SMALLINT | | INT2 | SMALLINT | | INT4 | INT | | INT8 | BIGINT | | NUMERIC | DECIMAL (p,s) | | REAL4 | FLOAT(24) | | REAL8 | FLOAT(53) | | STRING | Si la longitud es 1-8000, entonces:

VARCHAR (longitud en Bytes)

STRING se asocia a VARCHAR (MAX) si la longitud en bytes supera los 8000. | | UINT1 | SMALLINT | | UINT2 | INT | | UINT4 | BIGINT | | UINT8 | DECIMAL (20,0) | | WSTRING | Si la longitud es 1-8000, entonces:

VARCHAR (longitud en Bytes)

WSTRING se asocia a VARCHAR (MAX) si la longitud en bytes supera los 8000. | | BLOB | VARBINARY (MAX) | | NCLOB | VARCHAR (MAX) | | CLOB | VARCHAR (MAX) | | JSON | VARCHAR (MAX) | Nota informativaNo se admiten tipos de datos LOB completos. Para obtener información sobre cómo incluir tipos de datos LOB de tamaño limitado en el trasladar, vea [Transferir datos desde fuentes de datos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Landing-data-data-sources.htm#Runtime).