Conectividade do warehouse

Aplica-se a:✅ endpoint de análise SQL e Armazém de dados no Microsoft Fabric

No Microsoft Fabric, os usuários acessam um ponto de extremidade de análise de SQL ou warehouse por meio de um ponto de extremidade do TDS (Fluxo de Dados Tabular). Aplicações web modernas interagem com o ponto de extremidade TDS do SQL Server. Dentro das configurações do Microsoft Fabric, esse ponto de extremidade é chamado de cadeia de conexão SQL.

Dica

Para obter um tutorial sobre como se conectar com ferramentas comuns, consulte Conectar-se ao Fabric Data Warehouse.

Autenticação em armazéns no Fabric

No Microsoft Fabric, a cadeia de conexão SQL dá suporte a dois tipos de usuários autenticados:

  • Entidades de usuário do Microsoft Entra ID ou identidades de usuário
  • Principais de serviço do Microsoft Entra ID

Para obter mais informações, confira Autenticação do Microsoft Entra como uma alternativa para a autenticação SQL no Microsoft Fabric.

A cadeia de conexão SQL requer que a porta TCP 1433 esteja aberta. TCP 1433 é o número padrão da porta SQL Server. A cadeia de conexão SQL também respeita o modelo de segurança do ponto de extremidade de análise SQL do Warehouse ou do Lakehouse para acesso a dados. Os usuários podem acessar dados de todos os objetos aos quais têm permissão.

Para obter mais informações sobre segurança no ponto de extremidade de análise de SQL, consulte a segurança do OneLake para pontos de extremidade de análise de SQL.

Práticas recomendadas

Adicione novas tentativas aos seus aplicativos e trabalhos ETL para torná-los mais resilientes. Para saber mais, confira a seguinte documentação:

Permitir service tags do Azure por meio do firewall

Para habilitar a conectividade por meio do firewall, você precisa permitir tags de serviço do Power BI e tags de serviço SQL. Para obter mais informações, consulte Power BI Service Tags e Marcas de Serviço.

Você não pode usar o FQDN (Nome de Domínio Totalmente Qualificado) do endpoint do TDS isoladamente.

Considerações e limitações

  • Não há suporte para a Autenticação sql.
  • Não há suporte para MARS (Vários Conjuntos de Resultados Ativos) no Microsoft Fabric Warehouse. O MARS está desabilitado por padrão. Se MultipleActiveResultSets estiver incluído na cadeia de conexão, remova-a ou defina-a como false.
  • Se você receber o código de erro 24804 com a mensagem "Não foi possível concluir a operação devido a uma atualização do sistema. Feche essa conexão, inicie sessão novamente e repita a operação" ou o código de erro 6005 com a mensagem "SHUTDOWN está em andamento. Falha na execução contra o SQL Server. Entre em contato com a equipe do SQL Server se precisar de mais suporte.", isso indica perda temporária de conexão, provavelmente devido a uma implantação ou reconfiguração do sistema. Para resolver esse problema, inicie sessão novamente e repita a tentativa. Para saber como impor resiliência e repetições em seu aplicativo, consulte Melhores práticas.
  • Não há suporte para conexões de servidor vinculadas do SQL Server.

Comportamento de conexão para InitialCatalog

Em maio de 2026, a Microsoft atualizou o comportamento de conexão do Fabric Data Warehouse e do ponto de extremidade de análise SQL para tornar a propriedade InitialCatalog de cadeia de conexão opcional. Atualmente, os usuários se conectam ao banco de dados do sistema master quando a propriedade InitialCatalog não é fornecida. Em Fabric Data Warehouse, você só pode se conectar ao banco de dados master, não é possível modificar o banco de dados master e não é possível criar, alterar ou soltar objetos de usuário no banco de dados master.

Você pode usar a sintaxe Transact-SQL USE para alterar o contexto do warehouse da sua conexão depois de se conectar ao master, e a função DB_NAME() para determinar seu warehouse atual. Por exemplo:

SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO

A tabela a seguir apresenta o comportamento de conexão atualizado para o Fabric Data Warehouse e o ponto de extremidade de análise SQL quando você especifica ou omite a propriedade InitialCatalog nas strings de conexão.

Cenário de entrada Antes de maio de 2026 Comportamento atual
Nome do armazém existente fornecido Conecta-se ao armazém especificado Nenhuma alteração - conecta-se ao depósito especificado
ID do armazém existente informado Conecta-se ao armazém especificado Nenhuma alteração - conecta-se ao depósito especificado
InitialCatalog propriedade não fornecida Conecta-se a um warehouse não determinístico no espaço de trabalho Conecta-se a master
InitialCatalog = master Conecta-se a um warehouse não determinístico no espaço de trabalho Conecta-se a master
O depósito na propriedade InitialCatalog não existe Conecta-se a um warehouse não determinístico no espaço de trabalho Lança um erro indicando que não existe nenhum armazém

Tratamento de erros

Se não existir nenhum warehouse no espaço de trabalho e for feita uma tentativa de conexão sem especificar um warehouse válido, os usuários verão o seguinte erro: "Falha no logon do usuário '<principal identificado por token>'". Motivo: a autenticação foi bem-sucedida, mas o banco de dados não foi encontrado ou você não tem permissões suficientes para se conectar a ele."

A captura de tela a seguir mostra o erro como ele aparece no SSMS quando um nome de warehouse inválido é fornecido como :InitialCatalog

Captura de tela da mensagem de erro do SSMS quando um catálogo inicial válido não é fornecido.

Próxima etapa

Conectar-se ao Fabric Data Warehouse

Conteúdo relacionado

  • Last updated on