Partilhar via

Conectividade de armazém

Aplica-se a:✅ ponto de extremidade de análise SQL e Data Warehouse no Microsoft Fabric

No Microsoft Fabric, os utilizadores acedem a um endpoint de análise SQL ou Warehouse através de um endpoint Tabular Data Stream (TDS). Este endpoint é familiar a todas as aplicações web modernas que interagem com um endpoint TDS do SQL Server. Nas definições do Microsoft Fabric, este endpoint é rotulado como a string de ligação SQL.

Sugestão

Para um tutorial sobre como ligar-se a ferramentas comuns, veja Connect to Fabric Data Warehouse.

Autenticação em armazéns no Fabric

No Microsoft Fabric, a cadeia de ligação SQL suporta dois tipos de utilizadores autenticados:

  • Principais de utilizador ou identidades de utilizador do Microsoft Entra ID
  • Entidades de serviço do Microsoft Entra ID

Para obter mais informações, consulte Autenticação do Microsoft Entra como alternativa à 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 de porta padrão do SQL Server. A cadeia de conexão SQL também respeita o modelo de segurança do endpoint de análise SQL do Warehouse ou Lakehouse para acesso a dados. Os utilizadores podem aceder a dados de todos os objetos para os quais têm permissão.

Para mais informações sobre segurança no endpoint de análise SQL, consulte OneLake security para endpoints de análise SQL.

Melhores práticas

Adicione tentativas repetidas às suas aplicações e trabalhos de ETL para os tornar mais resilientes. Para obter mais informações, veja a seguinte documentação:

Permitir tags de serviço do Azure por meio do firewall

Para permitir a conectividade através do firewall, é necessário permitir etiquetas de serviço Power BI e SQL. Para obter mais informações, consulte Marcas de serviço e marcas de serviço do Power BI.

Não pode usar apenas o Nome de Domínio Totalmente Qualificado (FQDN) do endpoint TDS.

Considerações e limitações

  • Autenticação SQL não é suportada.
  • Múltiplos Conjuntos de Resultados Ativos (MARS) não são suportados para o Microsoft Fabric Warehouse. O MARS está desativado por defeito. Se MultipleActiveResultSets estiver incluída na cadeia de ligação, remova-a ou defina-a como falsa.
  • Se receber o erro "Não foi possível completar a operação porque atingimos um limite do sistema", é devido ao tamanho do token do sistema ter atingido o seu limite. Este erro pode ocorrer se o espaço de trabalho tiver demasiados armazéns ou endpoints de análise SQL, se o utilizador fizer parte de demasiados grupos Microsoft Entra, ou uma combinação destes dois fatores. Para evitar este erro, limite o número de armazéns e endpoints de análise SQL por espaço de trabalho a 40 ou menos. Se o erro persistir, contacte o suporte.
  • 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 esta ligação, inicie sessão novamente e tente novamente a operação" ou o código de erro 6005 com a mensagem "SHUTDOWN está em curso. Falha de execução no sql server. Entre em contato com a equipe do SQL Server se precisar de mais suporte.", é devido a perda temporária de conexão, provavelmente devido a uma implantação ou reconfiguração do sistema. Para resolver esse problema, entre novamente e tente novamente. Para saber como criar resiliência e novas tentativas em seu aplicativo, consulte Práticas recomendadas.
  • As ligações de servidores ligados a partir do SQL Server não são suportadas.

Catálogo inicial necessário

Quando se conecta ao Fabric Data Warehouse usando qualquer ferramenta cliente (como SSMS, Visual Studio Code, Visual Studio, clientes JDBC/ODBC/SqlClient, ou aplicações personalizadas), deve fornecer um nome válido do Data Warehouse na propriedade Catálogo Inicial ou Base de Dados da cadeia de conexão.

Se o nome do armazém especificado estiver incorreto, a tentativa de ligação falha mesmo que a autenticação tenha sucesso. Os utilizadores verão o seguinte erro: "Falha de login para o utilizador '<principal identificado por token>'. Razão: A autenticação foi bem-sucedida, mas a base de dados não foi encontrada, ou tens permissões insuficientes para te ligares a ela."

O nome válido do armazém não inclui o <unique identifier>.datawarehouse.fabric.microsoft.com necessário para o nome do servidor. Se o nome do seu armazém for NYC Taxi, o seu Catálogo Inicial é NYC Taxi.

A captura de ecrã seguinte mostra o erro tal como aparece no SSMS quando um nome de armazém inválido é fornecido como Catálogo Inicial:

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

Próximo passo

Conectar-se ao Fabric Data Warehouse

Conteúdo relacionado

  • Last updated on