Validar o acesso do PostgreSQL ao Microsoft Fabric HorizonDB

Use a identidade do Microsoft Entra do criador do banco de dados para se conectar ao Fabric HorizonDB. Este artigo ajuda a verificar a identidade e inspecionar seu acesso efetivo sem configurar usuários adicionais.

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 principais não conseguem se conectar, mesmo depois que o item Fabric é compartilhado. Para mais informações, consulte os recursos de pré-visualização do Microsoft Fabric.

Prerequisites

  • Um banco de dados HorizonDB.
  • Faça login como o usuário do Microsoft Entra que criou o banco de dados.
  • Os valores de conexão PostgreSQL do banco de dados HorizonDB mostrados.

Entenda o modelo de acesso da versão prévia pública

O caminho de acesso inclui dois pontos de imposição:

Ponto de controle Purpose
Fabric Controla se o principal pode descobrir e usar o item por meio das experiências Fabric suportadas.
Endpoint Fabric HorizonDB PostgreSQL Autentica o token Microsoft Entra e aplica os privilégios do banco de dados materializados para o principal.

As permissões do espaço de trabalho e dos itens do Fabric não sobrepõem a restrição de conexão PostgreSQL somente do criador da prévia. Não tente adicionar usuários por meio de funções SQL, associação a grupos, principais de serviço ou identidades gerenciadas.

Abra uma conexão de criador

  1. Abra o banco de dados HorizonDB com a conta do criador.
  2. Selecione Nova Consulta ou selecione Visual Studio Code para abrir uma conexão de área de trabalho.
  3. Para uma conexão na área de trabalho, selecione Entra Auth e faça login como criador.
  4. Mantenha o endpoint PostgreSQL e o nome do banco de dados fornecidos pelo item.

Validar acesso

Abra uma nova conexão como criador e execute:

SELECT
    current_database() AS database_name,
    current_user AS current_role,
    session_user AS session_role,
    clock_timestamp() AS checked_at;

Confirme se a função retornada representa o criador ou sua identidade de banco de dados mapeada. Depois, teste a operação pretendida contra uma tabela de prática.

Você pode inspecionar um privilégio efetivo sem alterar os dados:

SELECT
    has_schema_privilege(
        current_user,
        'horizon_sample',
        'USAGE'
    ) AS can_use_schema,
    has_table_privilege(
        current_user,
        'horizon_sample.orders',
        'SELECT'
    ) AS can_read_orders,
    has_table_privilege(
        current_user,
        'horizon_sample.orders',
        'UPDATE'
    ) AS can_update_orders;

Essas funções reportam os privilégios visíveis para a sessão atual.

O gerenciamento de funções SQL não é suportado

Usuários de banco de dados não podem gerenciar usuários ou funções via SQL durante a pré-visualização pública. Não use:

  • CREATE ROLE, ALTER ROLE ou DROP ROLE.
  • GRANT role TO principal ou REVOKE role FROM principal.
  • Funções de login baseadas em senha.
  • Hierarquias de funções personalizadas para permissões de usuário em nível de tabela ou nível de view.

Esses comandos não são uma solução alternativa para a restrição exclusiva do criador.

Alterar ou revogar acesso

Gerencie o acesso a itens e análises via Fabric. Essas permissões não habilitam outra identidade PostgreSQL. Para alterações no acesso do criador ou nas sessões existentes, confirme o procedimento suportado com seu contato de pré-visualização.

Limitações da visualização pública

  • A autenticação Microsoft Entra é obrigatória. A autenticação por senha PostgreSQL não é o modelo de identidade do cliente suportado.
  • Somente o criador do banco de dados pode se conectar.
  • O gerenciamento de permissões de usuários em nível de tabela e de visualização não está disponível.
  • Outros usuários, grupos, principais de serviço e identidades gerenciadas do Microsoft Entra não conseguem se conectar.
  • Os clientes não recebem acesso de superusuário, host ou sistema de arquivos PostgreSQL.

Troubleshoot

Sintoma Resolução
O usuário não pode abrir o item Verifique a área de trabalho e a permissão de itens no Fabric.
O token do PostgreSQL foi rejeitado Faça login como criador, adquira um token novo usando as orientações de autenticação da sua prévia e verifique o locatário, endpoint, configurações TLS e relógio do cliente.
current_user não é a identidade esperada Reconecte-se com a conta Microsoft Entra pretendida. Não tente selecionar outra identidade mudando apenas o nome de usuário PostgreSQL.
O usuário que criou se conecta, mas a consulta SQL é rejeitada Verifique a propriedade do objeto, o privilégio efetivo e se a operação é suportada.
Outro usuário não consegue se conectar depois do compartilhamento Esperado na prévia atual. Compartilhamento não habilita outra identidade PostgreSQL.
CREATE ROLE ou GRANT role falha Não use roles do SQL para contornar a restrição da conexão de visualização.