Conexões e Gateways
Para que o Microsoft Fabric acesse dados de fontes externas, é necessário configurar Conexões. Dependendo de onde os dados estão localizados, pode ser necessário também um Gateway para estabelecer a comunicação.
O que são Conexões?
Uma Conexão é uma configuração que armazena as informações necessárias para acessar uma fonte de dados: servidor, banco de dados, credenciais e método de autenticação.
As conexões são criadas uma vez e podem ser reutilizadas por múltiplos artefatos (Pipelines, Dataflows, Notebooks).
Tipos de Conexão por Localização
| Localização | Gateway Necessário? | Exemplo |
|---|---|---|
| Nuvem pública | ❌ Não | Azure SQL, SharePoint Online, APIs REST públicas |
| Rede privada / On-premises | ✅ Sim | SQL Server local, Oracle on-premises, arquivos em rede |
| Nuvem privada (VNet) | ✅ Sim (VNet Gateway) | Azure SQL com Private Endpoint |
O que é um Gateway?
O On-premises Data Gateway é um software instalado em um servidor dentro da rede da organização. Ele atua como uma "ponte" segura entre o Fabric (nuvem) e as fontes de dados locais (on-premises).
Fluxo de Comunicação
☁️MICROSOFT FABRICNuvem
HTTPS⟷Criptografado
🖥️GATEWAYServidor On-premises
SQL/ODBC⟷Rede local
🗄️FONTE DE DADOSSQL Server Local
🔒 Conexão SeguraGateway inicia conexão de SAÍDA
🚫 Sem Portas AbertasNão requer firewall de entrada
🔐 CriptografadoDados protegidos em trânsito
Características do Gateway
- Comunicação criptografada (HTTPS/TLS)
- Conexão de saída apenas (não requer abrir portas no firewall)
- Instalado em servidor Windows dentro da rede corporativa
- Gerenciado centralmente no portal do Fabric/Power BI
Tipos de Gateway
| Tipo | Uso | Compartilhamento | Instalação |
|---|---|---|---|
| Gateway Corporativo (Standard) | Produção, múltiplos usuários | Compartilhado entre toda a organização | Servidor dedicado |
| Gateway Pessoal | Desenvolvimento, testes | Apenas para o usuário que instalou | Máquina do desenvolvedor |
Comparativo
🏢GATEWAY CORPORATIVO
👥Múltiplos usuários
🖥️Servidor dedicado
🔄Sempre disponível (24/7)
🔧Gerenciado pela TI
📊Suporta agendamentos
🔐Fontes compartilhadas
✅ Recomendado para PRODUÇÃO
👤GATEWAY PESSOAL
👤Usuário único
💻Máquina pessoal
⚠️Depende da máquina ligada
🙋Gerenciado pelo usuário
📊Suporta agendamentos
🔒Fontes privadas
✅ Recomendado para DEV/TESTE
Quando usar Gateway?
| Cenário | Gateway Necessário? | Motivo |
|---|---|---|
| Conectar ao SharePoint Online | ❌ Não | Serviço na nuvem Microsoft |
| Conectar ao Azure SQL Database | ❌ Não | Serviço na nuvem pública |
| Conectar ao Protheus (SQL Server local) | ✅ Sim | Banco de dados on-premises |
| Conectar a arquivo Excel em pasta de rede | ✅ Sim | Arquivo em rede local |
| Conectar a API REST pública | ❌ Não | Endpoint acessível pela internet |
| Conectar a Oracle on-premises | ✅ Sim | Banco de dados on-premises |
| Conectar ao Azure SQL com Private Endpoint | ✅ Sim | Rede privada (VNet) |
Configuração na Química Anastácio
A Anastácio utiliza um Gateway Corporativo instalado em servidor dedicado para acessar o Protheus e outras fontes on-premises.
| Item | Configuração |
|---|---|
| Nome do Gateway | gw_qan_corp_prod |
| Servidor | Servidor Windows dedicado na rede corporativa |
| Fontes conectadas | Protheus (SQL Server), Arquivos de rede |
| Administradores | Time de Transformação Digital (TD) |
Arquitetura de Conexões
☁️ MICROSOFT FABRICqan_br_td_data_prod
lh_corp_bronzelh_corp_silverlh_corp_gold
↓
↓
↓
CONEXÃO DIRETA(Sem Gateway)
VIA GATEWAY(Com Gateway)
CONEXÃO DIRETA(Sem Gateway)
↓
↓
↓
📁SharePoint OnlineArquivos Excel
Metas, Preços
Metas, Preços
🖥️gw_qan_corp_prod
↓🗄️ProtheusSQL Server
🌐API BCBInternet
Cotação Dólar
Cotação Dólar
🏢 Rede Corporativa (Gateway necessário)☁️ Nuvem/Internet (Conexão direta)
Criando uma Conexão
Passo a Passo
- No Fabric, acesse Settings (⚙️) → Manage connections and gateways
- Clique em + New connection
- Selecione o tipo de fonte (SQL Server, SharePoint, etc.)
- Preencha os dados de conexão:
- Servidor / URL
- Banco de dados (se aplicável)
- Método de autenticação
- Credenciais
- Selecione o Gateway (se necessário)
- Teste a conexão
- Salve
Boas Práticas
- Nomeie conexões de forma descritiva:
conn_protheus_prod,conn_sharepoint_goals - Use contas de serviço (não pessoais) para conexões de produção
- Documente as conexões e seus responsáveis
- Revise periodicamente conexões não utilizadas
Gerenciando o Gateway
Acesso
- Portal Fabric: Settings → Manage connections and gateways → aba "On-premises data gateways"
- Portal Power BI: Settings → Manage gateways
Ações Disponíveis
| Ação | Descrição |
|---|---|
| Adicionar administradores | Definir quem pode gerenciar o gateway |
| Adicionar fontes de dados | Configurar conexões via gateway |
| Monitorar status | Verificar se o gateway está online |
| Atualizar gateway | Instalar novas versões |
| Configurar balanceamento | Distribuir carga entre múltiplos gateways |
Troubleshooting
| Problema | Causa Provável | Solução |
|---|---|---|
| "Gateway offline" | Servidor desligado ou serviço parado | Verificar servidor e reiniciar serviço |
| "Unable to connect" | Credenciais inválidas | Atualizar credenciais na conexão |
| "Firewall blocking" | Portas bloqueadas | Gateway usa apenas saída HTTPS (443) |
| "Data source not found" | Fonte não configurada no gateway | Adicionar fonte de dados no gateway |
| Lentidão na extração | Gateway sobrecarregado | Considerar cluster de gateways |
Dúvidas?
Entre em contato com o Time de Transformação Digital (TD) para solicitar novas conexões ou reportar problemas com o Gateway.