Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Fabric HorizonDB utiliza autenticação Microsoft Entra para conexões PostgreSQL. O principal chamador determina a identidade efetiva do PostgreSQL.
Importante
Fabric HorizonDB está em prévia pública. Somente a identidade Microsoft Entra que criou o banco de dados pode se conectar. Outros usuários e entidades de segurança não conseguem se conectar, mesmo que consigam abrir o item Fabric. Use os detalhes de conexão do seu próprio banco de dados. Para mais informações, consulte os recursos de pré-visualização do Microsoft Fabric.
Autenticação e autorização são diferentes
A autenticação verifica a identidade. A autorização determina o que essa identidade pode fazer.
Um login bem-sucedido por si só não concede:
- Acesso ao espaço de trabalho ou item do Fabric.
- Privilégio do PostgreSQL
CONNECT. - Esquema
USAGE. - Privilégios de tabela, sequência, função ou DDL.
- Acesso a uma fonte de federação, origem do trabalho de cópia ou endpoint de análise SQL.
Para autorização, consulte Autorização.
Padrões de identidade suportados
Faça login como o criador do banco de dados para o editor Fabric SQL, Visual Studio Code, exercícios do aplicativo e conexão de destino de tarefa Copiar. Grupos Microsoft Entra, principais de serviço, identidades gerenciadas e outros usuários do Microsoft Entra não são suportados para conexões PostgreSQL na prévia atual.
Clientes interativos
Para o editor SQL do Fabric, o serviço usa o contexto do Fabric em que você iniciou sessão. A entidade de segurança chamadora determina a identidade efetiva do PostgreSQL.
Para Visual Studio Code:
Instale a extensão Microsoft PostgreSQL.
Selecione Visual Studio Code na barra de ferramentas do Fabric HorizonDB e, em seguida, selecione Abrir no VS Code no painel de conexão.
Selecione o Entra Auth.
Faça login no tenant correto como criador do banco de dados.
Verifique o host, banco de dados, formato do usuário e configuração TLS.
Executar:
SELECT current_database(), current_user, clock_timestamp();
Autenticação do aplicativo
Uma aplicação deve:
- Carregue coordenadas de conexão não sensíveis a partir da configuração.
- Use a identidade Microsoft Entra do criador do banco de dados para o exercício de pré-visualização.
- Solicite um token usando o audience ou escopo especificado para sua conexão de visualização.
- Abra uma conexão PostgreSQL protegida por TLS e forneça o token como credencial equivalente à senha.
- Defina um tempo limite de conexão e um nome de aplicativo não sensível.
- Descarte o token quando não for mais necessário.
Não substitua o criador por um principal de serviço ou identidade gerenciada. Para um exercício local de Python, use Psycopg 3 e uma credencial interativa explícita. Veja como conectar com Python.
Ciclo de vida do token e do pool
A validação de token ocorre quando uma conexão física é estabelecida. Uma sessão existente não é automaticamente reautenticada antes de cada instrução.
- Adquira um token novo para cada nova conexão física ou atualização do pool.
- Substitua as conexões agrupadas antes da expiração do token.
- Valide conexões emprestadas após pausa, dimensionamento ou manutenção.
- Limite as tentativas de repetição e nunca tente novamente indefinidamente uma credencial inválida ou expirada.
Alterar permissões de itens Fabric não habilita identidades adicionais do PostgreSQL na pré-visualização atual.
Valide a identidade autenticada
Executar:
SELECT
current_database() AS database_name,
current_user AS current_role,
session_user AS session_role,
pg_backend_pid() AS session_id,
clock_timestamp() AS checked_at;
Confirme se a identidade retornada representa o criador do banco de dados ou a identidade mapeada do banco de dados. Não crie roles de login do PostgreSQL para contornar a restrição da versão prévia.
Solucionar problemas de autenticação
| Sintoma | Verificação |
|---|---|
| Falha na aquisição de token | Configuração de credenciais, seleção do locatário, acesso condicional e estado local de login. |
| PostgreSQL rejeita a credencial | Escopo ou público do token, expiração, locatário, formato de usuário, clock do servidor e endpoint. |
| Portal funciona, mas o aplicativo falha | Compare a identidade, banco de dados, formato do usuário, fluxo de tokens, modo TLS e acesso efetivo ao banco de dados. |
| Outro usuário não consegue se conectar | Esperado na prévia atual. Reconecte-se como criador do banco de dados; compartilhar o item não permite a outra identidade PostgreSQL. |
| A autenticação funciona, mas a consulta é negada | Verifique o banco de dados atual, a propriedade dos objetos e se a operação é suportada. |
| O banco de dados está pausado | Use a retentativa de conexão limitada enquanto uma conexão autorizada retoma. |
Registre a categoria de erro sanitizada, o timestamp UTC, a versão do cliente e do driver, e o ID de correlação. Nunca envie o token ou a cadeia de conexão completa.
Limitations
- A autenticação por senha não é documentada como o modelo de identidade em visualização pública.
- A configuração de superusuário do cliente e de autenticação do host não está disponível.
- Somente o criador do banco de dados pode se conectar; usuários adicionais e entidades de segurança de aplicativo não são compatíveis.
- Compartilhar não é uma solução alternativa para a restrição exclusiva do criador.
- Não presuma que a administração de funções SQL ou o acesso multiusuário granular estejam disponíveis.
- TLS e valores de endpoint não são intercambiáveis com outro serviço.