Tutorial: Conexión de App Service a una base de datos SQL en Fabric mediante Service Connector

En esta guía, aprenderá a conectar un recurso de Azure App Service a una base de datos SQL en Microsoft Fabric mediante Service Connector. Esta configuración permite que la aplicación web interactúe sin problemas con la base de datos SQL en Microsoft Fabric.

Creación de una conexión de servicio entre Azure App Service y una base de datos SQL en Fabric
Concesión de permisos de acceso de base de datos a la aplicación web

Prerrequisitos

Antes de comenzar, asegúrese de que tiene:

Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
Una aplicación hospedada en App Service. Si no tiene una, cree e implemente una aplicación en App Service.
Una base de datos SQL en Microsoft Fabric. Si no tiene una, cree una base de datos SQL en Fabric.

Creación de una conexión de servicio

Cree una nueva conexión de servicio desde App Service a una base de datos SQL en Fabric mediante la CLI de Azure o Azure Portal.

CLI de Azure
Azure Portal

Instale la extensión sin contraseña de Service Connector para la CLI de Azure.
```
az extension add --name serviceconnector-passwordless --upgrade
```
Recopile la información necesaria:
- Identificador de suscripción: se encuentra en la pestaña Información general de App Service.
- Nombre del grupo de recursos: se encuentra en la pestaña Información general de App Service.
- UUID del área de trabajo de Fabric (identificador único universal) y UUID de la base de datos SQL: se encuentra al navegar a su base de datos SQL en el portal de Fabric. La dirección URL del explorador debe tener este aspecto: https://msit.powerbi.com/groups/<fabric_workspace_uuid>/sqldatabases/<fabric_sql_db_uuid>. El primer UUID de la dirección URL es el UUID del área de trabajo de Fabric y el segundo UUID es el UUID de la base de datos SQL.
- Id. de aplicación (solo para la autenticación de identidad administrada asignada por el usuario): se encuentra en el centro de administración de Microsoft Entra en Entra ID > Aplicaciones empresariales. Busque la aplicación y busque el identificador de la aplicación.

Cree la conexión de servicio mediante una identidad administrada asignada por el sistema o una identidad administrada asignada por el usuario. En ambos casos, Service Connector habilita una identidad administrada para la autenticación y agrega una cadena de conexión denominada FABRIC_SQL_CONNECTIONSTRING a App Settings.

Identidad administrada asignada por el sistema:

az webapp connection create fabric-sql \
    --source-id /subscriptions/<subscription-ID>/resourceGroups/<source-resource-group>/providers/Microsoft.Web/sites/<site> \
    --target-id https://api.fabric.microsoft.com/v1/workspaces/<fabric_workspace_uuid>/SqlDatabases/<fabric_sql_db_uuid> \
    --system-identity

Identidad administrada asignada por el usuario:

az webapp connection create fabric-sql \
    --source-id /subscriptions/<subscription-ID>/resourceGroups/<source-resource-group>/providers/Microsoft.Web/sites/<site> \
    --target-id https://api.fabric.microsoft.com/v1/workspaces/<fabric_workspace_uuid>/SqlDatabases/<fabric_sql_db_uuid> \
    --user-identity client-id=<app-ID> "subs-id=<subscription-ID>"

Para obtener más información sobre estos comandos y más opciones, consulte az webapp connection create.

En Azure Portal, abra el recurso de App Service.
En el menú del servicio, seleccione Configuración>Conector de Servicio.

Seleccione Crear y configure las opciones siguientes en el panel Crear conexión que se abre.

Configuración	Ejemplo	Descripción
Tipo de servicio.	Base de datos SQL en Fabric	Tipo de servicio de destino: base de datos SQL en Fabric.
Nombre de la conexión	fabricsql_8293d	Nombre de conexión que identifica la conexión entre su App Service y su base de datos SQL. Opcionalmente, edite el nombre de conexión sugerido de forma predeterminada por Service Connector.
Área de trabajo	Mi área de trabajo	Área de trabajo de Microsoft Fabric que contiene la base de datos SQL.
Base de datos SQL	my_sql_database	Base de datos SQL de destino a la que desea conectarse.
Tipo de cliente	.NET	La pila tecnológica o biblioteca de la aplicación.

Seleccione Siguiente: Autenticación y elija la opción de autenticación de identidad administrada preferida (asignada por el sistema o asignada por el usuario). En ambos casos, Service Connector habilita una identidad administrada para la autenticación y agrega una cadena de conexión a App Settings denominada FABRIC_SQL_CONNECTIONSTRING.
Seleccione Siguiente: Revisión de redes>+ Crear para revisar la configuración de conexión.
Active la casilla que indica que comprende que se requieren pasos manuales adicionales para configurar esta conexión de servicio y seleccione Crear en Cloud Shell. El comando se ejecuta automáticamente en Azure Cloud Shell. Como alternativa, si tiene instalada la CLI de Azure, copie y ejecute los comandos de la CLI proporcionados en el equipo local.
Una vez que el comando termine de ejecutarse, cierre el panel Crear conexión .

Configuración de permisos de acceso a bases de datos

Después de crear la conexión de servicio, debe otorgar a la identidad administrada los permisos necesarios para acceder a la base de datos SQL.

En Azure Portal, vaya al menú de Service Connector de App Service y seleccione Actualizar para ver la nueva conexión.
En Nombre del recurso, seleccione el vínculo sql Database para abrir la base de datos en el portal de Microsoft Fabric.
En el portal de Fabric, vaya a la pestaña Seguridad y seleccione Administrar seguridad de SQL.
Vaya a la interfaz de administración de permisos seleccionando el rol db_datareader y, a continuación, seleccione Administrar acceso. No concede este rol a su identidad administrada; esta es solo la forma de acceder a la configuración de permisos de Fabric.
Busque debajo de Personas, grupos o aplicaciones en este rol el nombre de su identidad administrada. Si ve una opción Compartir base de datos , continúe con el paso siguiente. De lo contrario, los permisos ya están configurados.
Escriba y seleccione el nombre de la identidad administrada tal como aparece en el panel Administrar acceso, active Leer todos los datos usando SQL Database y seleccione Conceder.

Limpieza de recursos

Cuando ya no los necesite, elimine el grupo de recursos y todos los recursos relacionados que se han creado en este tutorial. Para ello, seleccione el grupo de recursos o los recursos individuales que creó y seleccione Eliminar.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-06-28