Fabric SQL (T-SQL)

Uma fonte Fabric SQL se conecta a um Warehouse ou a um ponto de extremidade de análise SQL, inclusive o de um lakehouse, e faz o Fabric executar T-SQL para você, como a pessoa que está vendo o mapa. Não há proxy nem gateway para configurar. Para um banco de dados SQL, escolha o ponto de extremidade de análise SQL dele: a consulta é executada nesse ponto de extremidade, a cópia que o Fabric espelha no OneLake, a menos que você escolha a conexão ao vivo pelo Eventhouse.

Fabric SQL ou Warehouse e SQL?

Fabric SQL Warehouse e SQL
Linguagem de consulta T-SQL DuckDB SQL
Onde as consultas são executadas No Fabric, na sua capacidade No navegador, sobre o OneLake
Exibições Sim Não
Dados ao vivo e colunas espaciais de um banco de dados SQL Sim, com a conexão ao vivo Não

Escolher uma conexão

Um banco de dados SQL oferece duas conexões. Um Warehouse é sempre lido diretamente.

Ponto de extremidade de análise SQL Banco de dados ao vivo via Eventhouse
Configuração Nenhuma Escolher um banco de dados KQL
O que é lido A cópia que o Fabric espelha no OneLake O próprio banco de dados
Quando os novos dados aparecem Em cerca de um minuto com a nova sincronização de metadados; caso contrário, em cerca de 30 segundos se você puder editar o workspace, e em vários minutos ou mais para os demais Imediatamente
Colunas de geografia e geometria Não disponíveis Disponíveis
Exibições do banco de dados Não disponíveis Disponíveis
Segurança em nível de linha e mascaramento do banco de dados Não aplicados Aplicados

Ponto de extremidade de análise SQL. O Fabric espelha novos dados no OneLake em cerca de 20 segundos. Quando o ponto de extremidade os mostra depende da sincronização de metadados que ele usa:

  • Nova sincronização de metadados. Ative a nova sincronização de metadados nas configurações do workspace, em Configurações de warehouse, antes de criar o banco de dados. O ponto de extremidade dele passa a mostrar novos dados em cerca de um minuto, para todos. Pontos de extremidade que já existem mantêm a sincronização original. A configuração está em versão prévia no Fabric.
  • A sincronização original pode levar muitos minutos e para após 15 minutos sem consultas. Por isso, antes de ler, o Icon Map pede ao ponto de extremidade que se atualize. Somente pessoas com a função de Colaborador ou superior no workspace podem fazer isso; para as demais, o mapa mostra o que o ponto de extremidade tem naquele momento.

A diferença de segurança é importante: se você depende da segurança em nível de linha ou do mascaramento no banco de dados, todas as pessoas que podem ler o ponto de extremidade veem as linhas e os valores que estariam ocultos. Use a conexão ao vivo ou defina a segurança no ponto de extremidade.

Banco de dados ao vivo via Eventhouse. Um navegador não pode se conectar diretamente a um banco de dados SQL, então sua consulta é executada por meio de um banco de dados KQL, com sql_request do Eventhouse. Qualquer banco de dados KQL serve, e ele não armazena nenhum dos seus dados. Todas as pessoas que veem o mapa precisam de acesso a esse banco de dados KQL e ao banco de dados SQL, e podem precisar aprovar o acesso ao Azure Data Explorer na primeira vez.

Abrir um mapa pode reativar um banco de dados SQL em pausa.

Tabelas, exibições e consultas

  • Escolha uma tabela ou exibição, ou
  • Escreva uma consulta T-SQL. Ela deve ser um único SELECT somente leitura, que pode começar com WITH.

Uma consulta deve dar nome a cada coluna. Gravações e procedimentos armazenados não são permitidos: uma consulta salva é executada com as permissões de quem abre o mapa, por isso o Icon Map recusa qualquer outra coisa antes do envio. Para reutilizar a lógica de um procedimento armazenado, coloque-a em uma exibição. Se uma coluna tiver o nome de uma palavra-chave do T-SQL, coloque-a entre colchetes, como [update].

Colunas espaciais

Ao escolher uma tabela ou exibição, as colunas geography e geometry chegam como WKT. Em A localização está armazenada como, escolha Uma coluna de geometria, depois a coluna e a codificação WKT.

Na sua própria consulta, converta-as em texto:

SELECT id, name, geom.STAsText() AS wkt
FROM dbo.sites

Se o ponto de extremidade de análise SQL tiver apenas colunas de longitude e latitude, você ainda pode calcular a geometria na consulta, como geography::Point(lat, lon, 4326).STAsText() AS wkt.

Limites

  • Uma consulta pode ser executada por até 100 segundos.
  • Um carregamento pode retornar cerca de 20 MB de dados no ponto de extremidade de análise SQL e cerca de 64 MB na conexão ao vivo. Acima disso, o Icon Map mantém as linhas que chegaram completas. Em tabelas maiores, use o limite de linhas, um filtro ou Carregar apenas dados na exibição atual do mapa.
  • As consultas usam sua capacidade do Fabric, portanto agregar na fonte e filtrar pela exibição também reduz os custos.
  • Os gráficos resumem as linhas carregadas no mapa.
  • Mapas publicados incluem esta fonte como um instantâneo feito na publicação, porque um leitor anônimo não tem uma identidade do Fabric para executar consultas.

Próximas etapas