Arquivos no OneLake
Novo na 1.1.0.12
Um arquivo guardado em um lakehouse do Microsoft Fabric pode ser usado em qualquer lugar em que o Icon Map Pro aceita um link de arquivo ou de imagem, da mesma forma que os visuais do próprio Power BI aceitam arquivos do OneLake. Cole a URL do OneLake do arquivo ou escolha-o com Escolher do OneLake. Cada visualizador lê o arquivo diretamente do OneLake, com o próprio acesso a ele.
Onde os arquivos do OneLake funcionam
| Onde | O que você pode usar |
|---|---|
| Camadas de referência de Arquivos e feeds (mecanismos Moderno e Herdado) | Um arquivo GeoJSON, TopoJSON, KML, KMZ ou CSV, por link. Qualquer arquivo que a janela de carregamento aceite, como cópia importada. |
| Formas de arquivos | Um arquivo GeoJSON por link. Qualquer arquivo que a janela de carregamento aceite, incluindo arquivos PMTiles, como cópia importada. |
| Imagens e ícones, as imagens de Formas dos dados e de Linhas, e as imagens de pontos nas camadas de referência (mecanismo Moderno) | Uma URL de imagem nos seus dados ou no painel Formato. |
| Tiles vetoriais | Um arquivo PMTiles, com Usar PMTiles ativado. |
| Modelos 3D | Um arquivo .glb, escolhido no seletor de modelos ou indicado como link de modelo nos seus dados. |
Só podem ser usados arquivos da seção Files de um lakehouse, e apenas arquivos de mapa, imagens e modelos .glb.
Antes de começar
Os arquivos do OneLake precisam de algumas coisas configuradas. Os administradores as definem uma vez para a organização.
| O quê | Quem | Onde |
|---|---|---|
| O OneLake permite que o visual leia arquivos com um link assinado | Administrador do Fabric | Portal de administração > Configurações de locatário > Configurações do OneLake > Authenticate with OneLake user-delegated SAS tokens. A alteração pode levar 15 minutos para ser aplicada. |
| Os visuais personalizados podem entrar em nome do visualizador | Administrador do Power BI | As configurações de locatário de visuais do Power BI. |
| A organização aprovou o acesso do aplicativo Icon Map ao OneLake | Administrador do Microsoft Entra | Consentimento do administrador para o aplicativo Icon Map. As organizações que usam o Icon Map for Fabric normalmente já o têm. |
| Cada visualizador pode ler o arquivo | Proprietário do lakehouse | Acesso de leitura (Read) ao lakehouse e à pasta que contém o arquivo. Não é necessário para uma cópia importada. |
O visual só pede ao visualizador que entre quando o mapa carrega um arquivo do OneLake ou quando Escolher do OneLake é selecionado. Um relatório sem arquivos do OneLake nunca pede.
Usar uma URL do OneLake
- No Fabric, abra o lakehouse, localize o arquivo em Files e abra o painel Propriedades dele.
- Copie a URL. Ela tem este formato:
https://onelake.dfs.fabric.microsoft.com/<workspace-id>/<lakehouse-id>/Files/<folder>/<file>. - Cole-a onde o visual aceita um link: o link de uma camada no Gestor de camadas ou no painel Formato, uma URL de imagem nos seus dados ou a guia A partir de uma ligação do seletor de modelos.
O formato com nomes, https://onelake.dfs.fabric.microsoft.com/<workspace name>/<lakehouse name>.Lakehouse/Files/..., também funciona, assim como o host onelake.blob.fabric.microsoft.com, os hosts regionais do OneLake e os caminhos abfss://.
O Gestor de camadas não lê um link do OneLake quando você o adiciona. A verificação do link indica "Um arquivo no OneLake" e que o arquivo é lido quando o mapa carrega.
Escolher do OneLake
A janela de carregamento de Arquivos e feeds, de Formas de arquivos e das formas personalizadas de Células tem um botão Escolher do OneLake sob a área de soltar.
- Selecione Escolher do OneLake. Na primeira vez, a janela se fecha enquanto você entra e depois se abre novamente no navegador do OneLake.
- Escolha um workspace, um lakehouse e depois uma pasta. Só são listados os workspaces que têm um lakehouse. Só são listados os arquivos que a camada pode usar, e Filtrar restringe uma lista longa.
- Selecione um arquivo e depois Vincular a este arquivo ou Importar uma cópia.
| Opção | O que faz |
|---|---|
| Vincular a este arquivo | Os visualizadores carregam o arquivo do OneLake com o próprio acesso, então as alterações no arquivo aparecem no relatório. |
| Importar uma cópia | O arquivo é lido uma vez e salvo no relatório, exatamente como um arquivo carregado do seu computador. Os visualizadores não precisam de acesso ao OneLake. |
Vincular a este arquivo é oferecido para os formatos que a camada lê a partir de um link: GeoJSON, TopoJSON, KML e KMZ nas camadas de referência, e GeoJSON em Formas de arquivos. As formas personalizadas só podem ser importadas. Voltar para o carregamento volta à área de soltar.
Imagens no painel Formato
Abaixo dos campos de URL de imagem do painel Formato (mecanismo Modern), uma opção Escolher do OneLake abre o navegador do OneLake para imagens. Escolha um workspace, um lakehouse, uma pasta e uma imagem e depois Vincular a este arquivo: a URL do OneLake vai para o campo, e cada visualizador carrega a imagem com o próprio acesso. A opção se desativa sozinha, e Cancelar deixa o campo como estava.
Os campos são URL da imagem em Imagens e ícones, URL da imagem no início e URL da imagem no fim em Linhas, URL da imagem, URL da imagem no início da linestring e URL da imagem no fim da linestring em Formas dos dados, e a URL da imagem dos pontos de cada camada de referência. Uma imagem escolhida é um valor fixo, então substitui a formatação condicional desse campo.
Modelos 3D do OneLake
No seletor de modelos, selecione Adicionar modelos e depois A partir de uma ligação. Cole a URL do OneLake de um arquivo .glb ou selecione Escolher do OneLake em Um arquivo .glb em um lakehouse do Fabric para procurar um. Cada visualizador carrega o modelo do OneLake com o próprio acesso ao lakehouse. Um link de modelo nos seus dados, por meio de formatação condicional em Modelo, também pode ser uma URL do OneLake.
Só funcionam arquivos .glb autocontidos. Um arquivo .gltf carrega as outras partes sem o acesso do visualizador, por isso empacote-o primeiro em um arquivo .glb. Consulte Modelos 3D.
Como o arquivo é lido
- O serviço do Icon Map assina, para o visualizador, um link somente leitura para o arquivo, válido por cerca de uma hora, usando a entrada do próprio visualizador. O navegador então lê o arquivo diretamente do OneLake.
- O arquivo nunca passa pelos servidores do Icon Map. O OneLake verifica o acesso de cada visualizador, de modo que um visualizador que não consegue abrir o lakehouse não consegue carregar o arquivo.
- Os links são assinados novamente antes de expirar. Um arquivo PMTiles é assinado a cada leitura, de modo que continua funcionando por mais tempo que o relatório fique aberto.
Quando um arquivo não carrega
O painel de mensagens do mapa explica uma única vez a falha de um arquivo do OneLake:
| Mensagem | O que fazer |
|---|---|
| O OneLake recusou que este visual lesse o arquivo | Um administrador do Fabric ativa Authenticate with OneLake user-delegated SAS tokens (Portal de administração > Configurações de locatário > Configurações do OneLake). A alteração pode levar 15 minutos para ser aplicada. |
| Você não tem permissão para ler o arquivo | Peça ao proprietário do lakehouse acesso de leitura (Read) ao lakehouse e à pasta que contém o arquivo. |
| O arquivo não foi encontrado, ou você não pode abrir o workspace ou o lakehouse dele | Verifique a URL e se você consegue abrir o workspace. |
| Sua organização ainda não aprovou o acesso do Icon Map ao OneLake | Um administrador do Microsoft Entra concede consentimento ao aplicativo Icon Map. |
| O administrador do Power BI desativou a entrada para visuais personalizados | Ela é permitida nas configurações de locatário de visuais do Power BI. |
| A entrada não está disponível aqui | A entrada não funciona em todos os lugares, por exemplo em Publicar na Web. Em vez disso, importe uma cópia do arquivo. |
| O arquivo não pode ser carregado do OneLake | Use um arquivo de mapa, uma imagem ou um modelo .glb na seção Files de um lakehouse, com a URL do painel Propriedades. |
O que não é abrangido
As URLs do OneLake não são lidas para:
- Imagens desenhadas pelas camadas Leaflet do mecanismo Herdado.
- Imagens nos cartões de rótulos de dados.
- Links de mapas base, de estilos e de terreno.
Para esses casos, use um arquivo em um servidor Web.