Inserir um espaço do Genie

Você pode inserir um espaço do Genie como um iframe em um site ou aplicativo externo. Isso permite que os usuários empresariais interajam com o Genie diretamente em suas ferramentas internas ou portais sem navegar para Azure Databricks.

Requisitos

Antes de inserir um espaço Genie, o seguinte deve estar presente:

• Administrador do workspace: deve configurar superfícies de inserção permitidas nas configurações de gerenciamento de acesso do Genie.
• Autor do espaço: deve ter pelo menos a permissão CAN MANAGE no espaço do Genie.
• Usuários finais: deve ter acesso explícito ao espaço do Genie e aos ativos de dados subjacentes que ele usa. Os usuários que não estão conectados ao Azure Databricks são solicitados a autenticar antes que possam interagir com o espaço inserido.

Etapa 1: Habilitar a visualização do recurso

Um administrador do espaço de trabalho deve habilitar a incorporação do Genie como um iframe na página de Pré-visualizações antes que o recurso esteja disponível no espaço de trabalho.

Etapa 2: Configurar superfícies de inserção permitidas

Um administrador do workspace deve configurar as superfícies de incorporação permitidas antes que um espaço do Genie possa ser incorporado. Consulte Gerenciar painel e inserção de espaço do Genie.

Etapa 3: Gerar o código iframe

Depois que um administrador tiver configurado superfícies permitidas, os criadores de espaço poderão gerar o código de inserção iframe.

1. Abra o espaço do Genie que você deseja incorporar.
2. Clique em Compartilhar.
3. Na caixa de diálogo Compartilhar, clique em Inserir espaço.
4. Copie o código iframe gerado.

Etapa 4: Adicionar o iframe ao seu aplicativo

Cole o código iframe em seu site ou aplicativo externo.

Para habilitar a funcionalidade completa, incluindo copiar dados CSV e copiar links de conversa, adicione o allow="clipboard-write" atributo ao elemento iframe:

<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

Práticas recomendadas

• Conceder acesso explícito a dados: verifique se os usuários finais têm acesso ao espaço do Genie e a todos os ativos de dados subjacentes usados pelo espaço. Os usuários só veem dados que têm permissão para acessar.
• Habilitar acesso à área de transferência: Incluir allow="clipboard-write" no elemento iframe para que os usuários possam copiar os resultados das consultas e os links das conversas.
• Limite as superfícies permitidas: adicione apenas domínios à lista de superfícies de inserção permitidas que você confia e controla.