Conectividad de almacenamiento

Se aplica a:✅ punto de conexión de análisis de SQL y almacén de datos en Microsoft Fabric

En Microsoft Fabric, los usuarios acceden a un endpoint de análisis SQL o almacén de datos a través de un punto de conexión de flujo de datos tabular (TDS). Las aplicaciones web modernas interactúan con un extremo de TDS de SQL Server. En la configuración de Microsoft Fabric, este punto de conexión se etiqueta como cadena de conexión SQL.

Sugerencia

Para ver un tutorial sobre cómo conectarse con herramientas comunes, consulte Conexión a Fabric Data Warehouse.

Autenticación en almacenes en Fabric

En Microsoft Fabric, la cadena de conexión sql admite dos tipos de usuarios autenticados:

  • Identidades principales de usuario, o identidades de usuario de Microsoft Entra ID
  • Principales de servicio de ID de Microsoft Entra

Para más información, vea Autenticación de Microsoft Entra como alternativa a la autenticación de SQL en Microsoft Fabric.

La cadena de conexión SQL requiere que el puerto TCP 1433 esté abierto. TCP 1433 es el número de puerto estándar SQL Server. Warehouse utiliza el protocolo Microsoft SQL Server Tabular Data Stream (TDS) sobre el puerto TCP 1433. En entornos que utilizan cortafuegos con reconocimiento de protocolo o inspección de capa de aplicación, configura e inspecciona el tráfico SQL como tráfico de Microsoft SQL Server (MSSQL/TDS) en lugar de como tráfico HTTPS.

Algunos cortafuegos distinguen entre acceso a puertos TCP e inspección de protocolos de aplicación. En estos entornos, permitir solo el puerto TCP 1433 puede no ser suficiente si el cortafuegos está configurado para esperar tráfico HTTPS en ese puerto.

La cadena de conexión SQL también respeta el modelo de seguridad de los puntos de conexión SQL del almacén o del lakehouse para el acceso a datos. Los usuarios pueden acceder a los datos de todos los objetos a los que tienen permiso.

Para más información sobre la seguridad en el punto de conexión de SQL Analytics, consulte OneLake security for SQL analytics endpoints (Seguridad de OneLake para puntos de conexión de análisis de SQL).

procedimientos recomendados

Añade reintentos en tus aplicaciones y trabajos de ETL para hacerlos más resilientes. Para más información, consulte la siguiente documentación:

Permitir etiquetas de servicio de Azure a través del firewall

Para habilitar la conectividad a través del firewall, debe permitir etiquetas de servicio de Power BI y etiquetas de servicio SQL. Para obtener más información, consulte Etiquetas de servicio yetiquetas de servicio de Power BI.

No puede usar solo el nombre de dominio completo (FQDN) del punto de conexión de TDS.

Importante

Si tu organización utiliza reglas de aplicación de Azure Firewall u otros cortafuegos compatibles con protocolos, configura el tráfico de Warehouse como tráfico MSSQL/TDS. Configurar el tráfico SQL como tráfico HTTPS en el puerto 1433 puede impedir una conectividad exitosa incluso cuando se permite el acceso de red al puerto.

Consideraciones sobre el cortafuegos y la inspección de la capa de aplicación

Algunas soluciones de cortafuegos empresariales realizan inspecciones a nivel de aplicación además del filtrado tradicional de IP y puertos.

Cuando configuras las políticas de cortafuegos para Warehouse:

  • Permitir conectividad TCP saliente en el puerto 1433.
  • Asegúrate de que el tráfico SQL se trate como tráfico de Microsoft SQL Server (MSSQL/TDS).
  • No configures conexiones SQL a Warehouse como tráfico HTTPS en el puerto 1433.
  • Validar la conectividad después de que se desplieguen los cambios en la política del cortafuegos.

Note

Los clientes que utilizan las reglas de aplicación de Azure Firewall deben configurar el filtrado con reconocimiento de SQL para el tráfico SQL. Azure Firewall soporta manejo de protocolos MSSQL y filtrado SQL FQDN para cargas de trabajo SQL.

Filtrado de cortafuegos basado en FQDN

Las organizaciones que restringen el acceso saliente usando nombres de dominio totalmente cualificados (FQDN) pueden emplear reglas de cortafuegos que solo permiten destinos SQL aprobados.

Para entornos que usan Azure Firewall:

  • Se admite el filtrado de FQDN basado en SQL mediante reglas de aplicación de MSSQL.
  • El filtrado FQDN puede usarse junto con restricciones del puerto 1433 para limitar la conectividad SQL saliente.
  • Asegúrate de que todos los endpoints de Warehouse documentados en este artículo estén incluidos en la lista de permisos de firewall.

Para detalles de implementación, consulte Configurar reglas de aplicación de Azure Firewall con FQDNs SQL.

Consideraciones y limitaciones

  • No se admite la autenticación de SQL.
  • No se admiten varios conjuntos de resultados activos (MARS) para Microsoft Fabric Warehouse. MARS está deshabilitado de forma predeterminada. Si MultipleActiveResultSets se incluye en la cadena de conexión, quítelo o establézcalo en false.
  • Si recibe el código de error 24804 con el mensaje "No se pudo completar la operación debido a una actualización del sistema. Cierre esta conexión, vuelva a iniciar sesión y vuelva a intentar la operación" o el "código de error 6005 con el mensaje 'APAGADO en curso'". Error de ejecución en SQL Server. Póngase en contacto con el equipo de SQL Server si necesita soporte técnico adicional." Esto se debe a una pérdida temporal de conexión, probablemente debido a una implementación o reconfiguración del sistema. Para resolver este problema, vuelva a iniciar sesión y vuelva a intentarlo. Para obtener información sobre cómo crear resistencia y reintentos en la aplicación, consulte Procedimientos recomendados.
  • Si recibe el código de error 6008 con el mensaje "El área de trabajo no está disponible temporalmente. Esto puede deberse al mantenimiento del sistema o a una operación interna. Restablezca la conexión". Este error indica una interrupción temporal de la conexión. Para resolver este problema, restablezca la conexión, vuelva a iniciar sesión y vuelva a intentar la operación. Esta condición es transitoria y no indica un error en la consulta o aplicación.
  • No se admiten las conexiones de servidor vinculado desde SQL Server.

Comportamiento de conexión para InitialCatalog

En mayo de 2026, Microsoft actualizó el comportamiento de la conexión para Fabric Data Warehouse y el punto de conexión de análisis de SQL para que la propiedad InitialCatalog de cadena de conexión sea opcional. Actualmente, los usuarios se conectan a la base de datos del sistema master cuando no se proporciona la propiedad InitialCatalog. En Fabric Data Warehouse, solo puede conectarse a la base de datos master, no puede modificar la base de datos master y no puede crear, modificar ni quitar objetos de usuario en la base de datos master.

Puede usar la sintaxis de USE Transact-SQL para cambiar el contexto de almacenamiento de conexión una vez conectado a master y la función DB_NAME() para determinar el almacenamiento actual. Por ejemplo:

SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO

En la tabla siguiente se describe el comportamiento de conexión actualizado para Fabric Data Warehouse y el punto de conexión de SQL Analytics al especificar o omitir la propiedad InitialCatalog en las cadenas de conexión.

Escenario de entrada Antes de mayo de 2026 Comportamiento actual
Se proporcionó un nombre de almacén existente Se conecta al almacén especificado. Sin cambio : se conecta al almacén especificado.
Se proporcionó un identificador de almacén existente Se conecta al almacén especificado. Sin cambio : se conecta al almacén especificado.
InitialCatalog propiedad no especificada Se conecta a un almacén no determinante en el área de trabajo Se conecta a master
InitialCatalog = master Se conecta a un almacén no determinante en el área de trabajo Se conecta a master
El almacén de la propiedad InitialCatalog no existe Se conecta a un almacén no determinante en el área de trabajo Produce un error que indica que no existe ningún almacén.

Gestión de errores

Si no existen almacenes de datos en el área de trabajo y se intenta establecer una conexión sin especificar un almacén de datos válido, los usuarios verán el siguiente error: "Error de inicio de sesión del usuario '<principal identificado por token>'." Motivo: la autenticación se realizó correctamente, pero no se encontró la base de datos o no tiene permisos suficientes para conectarse a ella".

En la captura de pantalla siguiente se muestra el error tal como aparece en SSMS cuando se proporciona un nombre de almacenamiento no válido como InitialCatalog:

Captura de pantalla del mensaje de error de SSMS cuando no se proporciona un catálogo inicial válido.

Paso siguiente