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. 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.

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.
  • 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

Conexión a Fabric Data Warehouse

Contenido relacionado

  • Last updated on