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
SELECTsomente leitura, que pode começar comWITH.
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
- Visão geral das fontes de dados - configuração comum.
- Segurança e permissões - o acesso que suas fontes exigem.