Idioma
Português

Configurar a publicação e a incorporação

Quando você publica um mapa para visualização fora do Fabric, o visualizador incorporado público lê os arquivos publicados e congelados de volta do seu OneLake. Ele faz isso usando uma entidade de serviço de incorporação dedicada do Icon Map (Tekantis.IconMap-Embed), uma identidade somente leitura sem permissões de API próprias.

Você não concede a essa entidade de serviço acesso ao seu workspace. A publicação grava os seus mapas publicados em um Lakehouse do seu workspace e concede à entidade de serviço de incorporação uma função de acesso a dados do OneLake somente leitura apenas nesse Lakehouse, automaticamente, com a sua própria identidade, como parte da publicação. O resultado: o serviço de incorporação pode ler o que você publica e nada mais, sem acesso de gravação ao seu workspace.

Conclua primeiro as configurações de locatário para publicação. Para a maioria dos mapas, não há mais nada a fazer: publique e funciona.

O que acontece automaticamente

Na primeira vez que você publica em um workspace, o Icon Map cria um Lakehouse chamado IconMap_Published para guardar os mapas publicados e adiciona a entidade de serviço de incorporação a uma função de acesso a dados somente leitura (IconMapEmbedReaders) nele. Todas as publicações seguintes os reutilizam. Isso não exige nenhuma ação de administrador, desde que o usuário que publica possa criar itens e gerenciar o acesso a dados do OneLake no workspace (um Membro ou Administrador do workspace pode).

Os tilesets raster grandes (PMTiles/COG) não são copiados: eles são lidos no local, a partir do próprio Lakehouse, para continuarem atualizados. A publicação concede à entidade de serviço de incorporação leitura também nesses Lakehouses de origem, da mesma forma.

Quando outra pessoa precisa agir

Camadas compartilhadas de catálogo organizacional. Se o seu mapa usa camadas raster de um Catálogo Organizacional cujo Lakehouse você não administra, você não pode conceder leitura à entidade de serviço de incorporação ali. O proprietário do catálogo faz isso uma vez, concedendo a Tekantis.IconMap-Embed uma função de acesso a dados somente leitura no Lakehouse do catálogo, e a partir daí todos os mapas que usam esse catálogo simplesmente funcionam. Se isso não tiver sido feito, a caixa de diálogo de publicação informa qual camada é afetada; o restante do mapa é publicado mesmo assim.

Workspaces restritos. Se a sua organização não permite que os usuários criem itens, um administrador pode criar antecipadamente o Lakehouse IconMap_Published e conceder uma vez à entidade de serviço de incorporação leitura nele; os autores então publicam nele. Em qualquer caso, a permissão é somente leitura, nunca de Colaborador do workspace.

Permissões adicionais para mapas com dados ao vivo

Uma publicação de snapshot não precisa de mais nada. Se um mapa publicado fornece dados ao vivo, a entidade de serviço de incorporação também precisa acessar essas fontes de consulta:

  • Eventhouse / KQL: conceda à entidade de serviço a função Visualizador no banco de dados KQL específico (Eventhouse → banco de dados → Gerenciar permissões).
  • Modelos semânticos do Power BI: habilite As entidades de serviço podem usar as APIs do Power BI (nas configurações de locatário).
  • Lakehouse / Warehouse: nenhuma permissão extra é necessária; a função de acesso a dados somente leitura acima cobre as leituras das tabelas Delta.

Verificar

Publique um mapa de teste, abra o link de incorporação e confirme que ele carrega. Se faltar uma camada raster, verifique na caixa de diálogo de publicação se há um aviso de incorporação de catálogo (veja acima). Se o mapa inteiro mostrar "this map needs to be re-published", publique-o novamente a partir do editor atual. Os links publicados podem ser revogados a qualquer momento no gerenciamento de publicações.

Próximas etapas