Utilize dados do Databricks na plataforma Microsoft Power Platform.

info

Visualização

Este recurso está em Pré-visualização Pública.

Esta página explica como usar seus dados do Databricks nas seguintes plataformas após criar uma conexão:

Power Apps : Crie aplicativos que podem ler e gravar dados no Databricks, mantendo seus controles de governança do Databricks.
Power Automate : Crie fluxos e adicione ações que permitam executar SQL personalizado ou um Job existente e obter os resultados.
Copilot Studio : Crie agentes personalizados usando seus dados do Databricks como fonte de conhecimento ou conecte o Genie Spaces como ferramentas.

Pré-requisitos

Antes de se conectar ao Databricks a partir do Power Platform, você precisa criar uma conexão com o Databricks no Microsoft Power Platform.

Use seus dados do Databricks para criar aplicativos do Power Canvas.

Para adicionar seus dados do Databricks ao seu aplicativo, faça o seguinte:

Na barra de navegação mais à esquerda do Power Apps, clique em Criar .
Clique em "Começar com uma tela em branco" e escolha o tamanho de tela desejado para criar um novo aplicativo de tela.
Na sua aplicação, clique em Adicionar dados > Conectores > Databricks . Clique na conexão do Databricks que você criou.
Selecione um catálogo na barra lateral " Escolher um dataset .
Na barra lateral " Escolher um dataset , selecione todas as tabelas às quais deseja conectar seu aplicativo de tela.
Clique em Conectar .

operações de dados no Power Apps:

O conector suporta operações de criação, atualização e exclusão, mas apenas para tabelas que possuem uma key primária definida. Ao realizar operações de criação, você deve sempre especificar a key primária.

O Databricks suporta colunas de identidade geradas automaticamente. Neste caso, os valores key primária são gerados automaticamente no servidor durante a criação da linha e não podem ser especificados manualmente.

Use seus dados do Databricks para criar fluxos do Power Automate.

As APIde Execução de Instruções e APITarefas Databricks estão disponíveis no Power Automate, permitindo que você escreva instruções SQL e execute tarefas existentes. Para criar um fluxo do Power Automate usando o Databricks como uma ação, faça o seguinte:

Na barra de navegação mais à esquerda do Power Automate, clique em Criar .
Crie um fluxo e adicione qualquer tipo de gatilho.
No seu novo fluxo, clique em + e pesquise por "Databricks" para ver as ações disponíveis.
Para escrever uma consulta SQL, selecione uma das seguintes ações:
- Executar uma instrução SQL : Escreva e execute uma instrução SQL . Digite o seguinte:
  - No campo Body/warehouse_id , insira o ID do armazém no qual a instrução SQL será executada.
  - No campo Body/statement_id , insira o ID da instrução SQL a ser executada.
  Para obter mais informações sobre parâmetros avançados, consulte a documentação da API.
- Verificar status e obter resultados : Verifique o status de uma instrução SQL e colete os resultados. Digite o seguinte:
  - No campo ID da instrução , insira o ID retornado quando a instrução SQL foi executada.
  Para obter mais informações sobre o parâmetro, consulte a documentação da API.
- Cancelar a execução de uma instrução: Encerra a execução de uma instrução SQL. Digite o seguinte:
  - No campo ID da instrução , insira o ID da instrução SQL que deseja encerrar.
  Para obter mais informações sobre o parâmetro, consulte a documentação da API.
- Obter resultados por índice de bloco: Obtém resultados por índice de bloco, o que é adequado para grandes conjuntos de resultados. Digite o seguinte:
  - No campo ID da instrução , insira o ID da instrução SQL cujos resultados você deseja recuperar.
  - Em Índice do bloco , insira o índice do bloco desejado.
  Para obter mais informações sobre os parâmetros, consulte a documentação da API.
Para interagir com um Job existente do Databricks, selecione uma das seguintes ações:
- Listar Empregos: Recupera uma lista de empregos. Para mais informações, consulte a documentação API.
- Aciona uma nova execução de Job: executa um Job e retorna o run_id da execução acionada. Para mais informações, consulte a documentação API.
- Obtenha uma única execução de Job: Retorna metadados sobre uma execução, incluindo status de execução (por exemplo, RUNNING, SUCCESS, FAILED), horário de início e término, duração da execução, informações cluster e assim por diante. Para mais informações, consulte a documentação API.
- Cancelar uma execução: Cancela uma execução de Job ou uma execução de tarefa. Para mais informações, consulte a documentação API.
- Obtenha a saída para uma única execução: recupera a saída e os metadados de uma única execução de trabalho ou tarefa. Para mais informações, consulte a documentação API.

Conecte-se aos Espaços Genie no Copilot Studio.

importante

Antes de usar este recurso, faça o seguinte:

Ative a pré-visualização do gerenciamento de servidores MCP em seu workspace. Veja as prévias do Gerenciador Databricks.
Crie uma conexão com o Databricks no Power Apps. Consulte Criar uma conexão Databricks na Microsoft Power Platform.

Genie é um recurso Databricks que permite que equipes de negócios interajam com seu uso de dados em linguagem natural. Para obter mais informações sobre como configurar espaços Genie no Databricks, consulte O que é um espaço Genie. Certifique-se de dar um nome e uma descrição claros ao seu espaço no Databricks Genie.

Para adicionar um Genie Space como ferramenta em um agente do Copilot Studio, faça o seguinte:

Na barra lateral do Copilot Studio, clique em Agente .
Selecione um agente existente ou crie um novo agente clicando em + Criar agente em branco .
Selecione o modelo do seu agente. A Databricks recomenda selecionar o Sonnet 4.5 como modelo do seu agente.
Na seção "Instruções" , descreva as funcionalidades do seu agente e como ele deve se comportar.
- A Databricks recomenda incluir o seguinte nas instruções: “Continue sempre consultando o Genie Space até receber uma resposta. Não pare depois de alguns segundos.” Isso impede que a integração envie repetidamente uma mensagem de "ainda em processamento" enquanto o agente está consultando o Genie Space.
Em Ferramentas , clique em + Adicionar uma ferramenta .
Pesquise por "Databricks" ou selecione Protocolo de Contexto do Modelo .
Selecione Databricks Genie , escolha sua conexão com o Databricks ao lado de Conexão e clique em Adicionar e configurar .
Configure a ferramenta Databricks Genie:
1. Dê um nome à ferramenta. Um nome de ferramenta mais descritivo ajuda o agente do Copilot Studio a orquestrar as solicitações.
2. Em "Entradas" , insira o ID Genie Space ou selecione o Genie Space no menu dropdown .
3. Salve a ferramenta.
4. (Opcional) Atualize a seção de ferramentas na tela de configuração para confirmar se o Genie Space está conectado.
No canto superior direito, clique em Configurações . Na seção orquestração , clique em Sim para usar orquestração generativa AI para as respostas do seu agente.
Para publicar seu agente, clique em Publicar no canto superior direito.
(Opcional) Publique o agente do Copilot Studio habilitado para Genieno Microsoft Teams ou Microsoft 365 para distribuir as informações do Genie para outros usuários. Para aprender como publicar seu agente, consulte a documentação da Microsoft.

Você pode adicionar seu agente a um Power App. Para configurar um Power App, consulte Usar seus dados do Databricks para criar aplicativos Power Canvas. Para adicionar seu agente do Copilot Studio a um Power App, consulte a documentação da Microsoft.

Para usar o agente no seu aplicativo publicado, abra o aplicativo, clique no ícone do Copiloto no canto superior direito e faça uma pergunta.

Utilize o Databricks como fonte de conhecimento no Copilot Studio.

Para adicionar seus dados do Databricks como uma fonte de conhecimento a um agente do Copilot Studio, faça o seguinte:

Na barra lateral do Copilot Studio, clique em Agente .
Selecione um agente existente ou crie um novo agente clicando em + Novo agente .
- Descreva o agente inserindo uma mensagem e clique em Criar .
- Ou clique em Ignorar para especificar manualmente as informações do agente.
Na tab Conhecimento , clique em + Conhecimento .
Clique em Avançado .
Clique em Databricks como fonte de conhecimento.
Insira o nome do catálogo onde seus dados estão armazenados.
Clique em Conectar .
Selecione as tabelas que você deseja que seu agente use como fonte de conhecimento e clique em Adicionar .

Realizar atualizações de lotes

Se você precisar executar operações em massa de criação, atualização ou exclusão em resposta a entradas do Power Apps, a Databricks recomenda implementar um fluxo do Power Automate. Para isso, faça o seguinte:

Crie um aplicativo de tela usando sua conexão com o Databricks no Power Apps.
Crie um fluxo do Power Automate usando a conexão com o Databricks e utilize o Power Apps como gatilho.
No gatilho do Power Automate, adicione os campos de entrada que você deseja passar do Power Apps para o Power Automate.
Crie um objeto de coleção no Power Apps para reunir todas as suas alterações.
Adicione o fluxo do Power Automate ao seu aplicativo de tela.
Chame o fluxo do Power Automate do seu aplicativo de tela e itere sobre a coleção usando um comando ForAll .
SQL
```
ForAll(collectionName, FlowName.Run(input field 1, input field 2, input field 3, …)
```

concorrente escreve

A concorrência em nível de linha reduz conflitos entre operações de escrita concorrentes, detectando alterações em nível de linha e resolvendo automaticamente conflitos que ocorrem quando escritas concorrentes atualizam ou excluem linhas diferentes no mesmo arquivo de dados.

A concorrência em nível de linha está incluída no Databricks Runtime 14.2 ou superior. A concorrência em nível de linha é suportada por default para os seguintes tipos de tabelas:

Tabelas com vetores de exclusão ativados e sem particionamento.
Tabelas com clustering líquido, a menos que os vetores de exclusão estejam desativados.

Para habilitar vetores de exclusão, execute o seguinte comando SQL .

SQL
ALTER TABLE table_name SET TBLPROPERTIES ('delta.enableDeletionVectors' = true);

Para obter mais informações sobre conflitos de escrita simultâneos no Databricks, consulte Níveis de isolamento e conflitos de escrita.

Limitações

Limitações do Copilot Studio

O Genie Spaces no Copilot Studio suporta até cinco perguntas por minuto devido aos limites de taxa da API do Genie. Os limites da versão gratuita existem para evitar abusos. Para obter ajuda adicional, entre em contato com a equipe da sua account Databricks .

Limitações do Power Apps

As seguintes fórmulas do PowerFx calculam valores usando apenas os dados recuperados localmente:

Categoria	Fórmula
Função de tabela	Agrupar por Distinto
Agregação	ContarLinhas StdevP Desvio padrão

Pré-requisitos​

Use seus dados do Databricks para criar aplicativos do Power Canvas.​

Use seus dados do Databricks para criar fluxos do Power Automate.​

Conecte-se aos Espaços Genie no Copilot Studio.​

Utilize o Databricks como fonte de conhecimento no Copilot Studio.​

Realizar atualizações de lotes​

concorrente escreve​

Limitações​

Limitações do Copilot Studio​

Limitações do Power Apps​