Tutorial: Conectar o Serviço de Aplicativo a um banco de dados SQL no Fabric usando o Service Connector

1. Instale a extensão sem senha do Conector de Serviço para a CLI do Azure.

   az extension add --name serviceconnector-passwordless --upgrade
   

2. Reúna as informações necessárias:

   • ID da assinatura: encontrada na guia Visão geral do Serviço de Aplicativo
   • Nome do grupo de recursos: encontrado na guia Visão geral do Serviço de Aplicativo
   • UUID do workspace do Fabric (identificador universalmente exclusivo) e UUID do banco de dados SQL: encontrado navegando até o banco de dados SQL no portal do Fabric. A URL do navegador deve ter esta aparência: https://msit.powerbi.com/groups/<fabric_workspace_uuid>/sqldatabases/<fabric_sql_db_uuid>. A primeira UUID na URL é a UUID do workspace do Fabric e a segunda UUID é a UUID do banco de dados SQL.
   • ID do aplicativo (somente para autenticação de identidade gerenciada atribuída pelo usuário): encontrada no Centro de administração do Microsoft Entra em Entra ID > aplicativos corporativos. Pesquise seu aplicativo e localize a ID do aplicativo.

3. Crie a conexão de serviço usando uma identidade gerenciada atribuída pelo sistema ou uma identidade gerenciada atribuída pelo usuário. Em ambos os casos, o Service Connector habilita uma identidade gerenciada para autenticação e adiciona uma cadeia de conexão nomeada FABRIC_SQL_CONNECTIONSTRING às Configurações do Aplicativo.

   Identidade gerenciada atribuída pelo 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
   

   Identidade gerenciada atribuída pelo usuário:

   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 obter mais informações sobre esses comandos e mais opções, consulte az webapp connection create.

1. No portal do Azure, abra o recurso do Serviço de Aplicativo.

2. No menu de serviço, selecione Configurações>Conector de Serviço.

3. Selecione Criar e defina as seguintes configurações no painel Criar conexão que é aberto.

   Configurações	Exemplo	Descrição
   Tipo de serviço	Banco de dados SQL no Fabric	O tipo de serviço de destino: banco de dados SQL no Fabric.
   Nome da conexão	fabricsql_8293d	Um nome de conexão que identifica a conexão entre o Serviço de Aplicativo e o Banco de Dados SQL. Opcionalmente, edite o nome da conexão sugerido por padrão pelo Service Connector.
   Área de trabalho	Meu Workspace	O Microsoft Fabric Workspace que abriga seu banco de dados SQL.
   Banco de dados SQL	my_sql_database	O banco de dados SQL de destino ao qual você deseja se conectar.
   Tipo de cliente	.NET	O stack de tecnologia ou biblioteca do aplicativo.

   

4. Selecione Avançar: Autenticação e escolha sua opção de autenticação de identidade gerenciada preferencial (atribuída pelo sistema ou atribuída pelo usuário). Em ambos os casos, o Service Connector habilita uma identidade gerenciada para autenticação e adiciona uma cadeia de conexão às Configurações do Aplicativo chamada FABRIC_SQL_CONNECTIONSTRING.

5. Selecione Avançar: Rede>Revisar + Criar para examinar sua configuração de conexão.

6. Marque a caixa informando que você entende que etapas manuais adicionais são necessárias para configurar essa conexão de serviço e selecione Criar no Cloud Shell. O comando é executado automaticamente no Azure Cloud Shell. Como alternativa, se você tiver a CLI do Azure instalada, copie e execute os comandos da CLI fornecidos em seu computador local.

   

7. Depois que o comando terminar de ser executado, feche o painel Criar conexão .