Gerenciamento de fonte de dados

O Microsoft Fabric funciona com muitas fontes de dados, tanto locais quanto na nuvem. Cada fonte de dados tem requisitos de instalação específicos. Este artigo mostra como adicionar um SQL Server do Azure como uma fonte de dados de nuvem como exemplo e o processo é semelhante para outras fontes. Se você precisar de ajuda com fontes de dados locais, consulte Adicionar ou remover uma fonte de dados do gateway.

Adicionar uma fonte de dados

Veja como adicionar uma nova fonte de dados:

1. Abra o serviço Microsoft Fabric e selecione o ícone Configurações no cabeçalho. Em seguida, selecione Gerenciar conexões e gateways.

   

2. Na guia Conexões , selecione Novo na parte superior da tela.

3. Na tela Nova conexão :

   • Selecionar Nuvem
   • Inserir um nome de conexão descritiva
   • Escolha o tipo de conexão (usamos o SQL Server neste exemplo)

4. Preencha os detalhes da fonte de dados. Para o SQL Server, você precisa:

   • Nome do servidor
   • Nome do banco de dados

   

5. Escolha seu método de Autenticação:

   • Basic
   • OAuth2
   • Entidade de Serviço

   

   Observação

   Se você usar o OAuth2:

   • Consultas de execução longa poderão falhar se excederem a expiração do token OAuth
   • Não há suporte para contas do Microsoft Entra entre locatários

6. Opcional: configurar um nível de privacidade nonível de Privacidade>. Essa configuração não afeta as conexões do DirectQuery .

   

7. Selecione Criar. Você verá uma nova mensagem de conexão criada em Configurações quando tiver êxito.

   

Depois de criado, você pode usar essa fonte de dados para trabalhar com dados SQL do Azure em itens do Microsoft Fabric com suporte.

Permitir o uso da conexão de nuvem no gateway

Ao criar uma conexão, você verá uma configuração rotulada Essa conexão pode ser usada com gateways de dados locais e gateways de dados VNet. Essa configuração controla se sua conexão pode funcionar com gateways:

• Quando desmarcada: a conexão não pode ser usada com avaliações baseadas em gateway
• Quando marcada: a conexão pode funcionar com avaliações baseadas em gateway

Remover uma fonte de dados

Para remover uma fonte de dados que não é mais necessária, siga estas etapas:

1. Vá para a tela Dados em Gerenciar conexões e gateways
2. Selecione sua fonte de dados
3. Selecione Remover da faixa de opções superior

Obter uma ID de conexão de fonte de dados

Para recuperar uma ID de conexão para uso em itens do Microsoft Fabric ou APIs REST, use um destes métodos:

• Usar a interface de serviço
• Usar a API REST

Usar a interface de serviço

1. Vá para Gerenciar conexões e gateways

   

2. Na tela Configurações de conexão, copie a ID de conexão da fonte de dados.

   

Usar a API REST

Use o ponto de extremidade de Conexões de Lista para recuperar suas informações de conexão:

1. Envie um HTTP GET para a API de Conexões do Fabric, incluindo o token no cabeçalho Authorization.

   curl -X GET https://api.fabric.microsoft.com/v1/connections \
   -H "Authorization: Bearer $ACCESS_TOKEN"
   

2. Uma resposta bem-sucedida retorna uma carga JSON semelhante a:

    {
    "value": [
       {
          "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "displayName": "ContosoConnection1",
          …
       },
       {
          "id": "cccccccc-2222-3333-4444-dddddddddddd",
          "displayName": "ContosoConnection2",
          …
       }
    ],
    "continuationToken": "…",
    "continuationUri": "…"
    }
   

3. A propriedade de cada objeto id na matriz value é a ID da conexão. Extraia a propriedade id da resposta conforme necessário.

   Observação

   Se você tiver mais de 100 conexões, use o continuationToken parâmetro de consulta em solicitações subsequentes para analisar todos os resultados.

Aqui está um snippet de exemplo do Python que usa requests e a Biblioteca de Autenticação da Microsoft (msal) para chamar o GET /v1/connections ponto de extremidade e analisar IDs de conexão:

import requests
import msal

# 1. Acquire token
app = msal.ConfidentialClientApplication(
   client_id="YOUR_CLIENT_ID",
   client_credential="YOUR_CLIENT_SECRET",
   authority="https://login.microsoftonline.com/YOUR_TENANT_ID"
)
result = app.acquire_token_for_client(scopes=["https://api.fabric.microsoft.com/.default"])
token = result["access_token"]

# 2. Call API
headers = {"Authorization": f"Bearer {token}"}
resp = requests.get("https://api.fabric.microsoft.com/v1/connections", headers=headers)
resp.raise_for_status()

# 3. Parse IDs
for conn in resp.json().get("value", []):
   print(f"{conn['displayName']}: {conn['id']}")

Gerenciar usuários

Depois de adicionar uma fonte de dados na nuvem, você dá acesso aos usuários e grupos de segurança à fonte de dados específica. A lista de acesso para a fonte de dados controla apenas quem tem permissão para usar a fonte de dados em itens que incluem dados da fonte de dados.

Adicionar usuários a uma fonte de dados

1. Selecione o ícone Configurações e abra Gerenciar conexões e gateways

2. Localize sua fonte de dados na lista. Use o filtro ou pesquise na faixa de opções superior para localizar conexões de nuvem rapidamente.

   

3. Selecione Gerenciar usuários na faixa de opções superior

4. Na tela Gerenciar usuários :

   • Adicionar usuários ou grupos de segurança de sua organização
   • Selecione o novo nome de usuário
   • Escolha sua função: Usuário, Usuário com recompartilhamento ou Proprietário

5. Selecione Compartilhar para conceder-lhes acesso

   

Remover usuários de uma fonte de dados

Para remover o acesso, acesse a guia Gerenciar Usuários e remova o usuário ou grupo de segurança da lista.

Gerenciar permissões de compartilhamento

Controlar quem pode compartilhar conexões em sua organização. Por padrão, os usuários poderão compartilhar conexões se forem:

• Proprietários ou administradores de conexão
• Usuários com permissões de compartilhamento

O compartilhamento de conexões ajuda as equipes a colaborar mantendo as credenciais seguras. As conexões compartilhadas funcionam apenas no Fabric.

Restringir o compartilhamento de conexão

Como administrador de locatários, você pode limitar quem pode compartilhar conexões:

1. Você precisa de privilégios de Administrador de Serviços do Power BI

2. Abra as configurações do Power BI ou do Fabric e vá para Gerenciar conexões e gateways

3. Ativar a alternância de administração de locatário no canto superior direito

   

4. Selecione Bloquear conexões de nuvem compartilháveis e ativá-la.

   • Quando desativado (padrão): qualquer usuário pode compartilhar conexões
   • Quando estiver ativado: o compartilhamento é bloqueado em todo o locatário

   

5. Opcional: adicionar usuários específicos a uma lista de permissões:

   • Pesquisar usuários e selecionar Adicionar
   • Os usuários listados ainda podem compartilhar conexões
   • Todos os outros estão impedidos de compartilhar

   

Conteúdo relacionado

• Visão geral dos conectores