Pular para o conteúdo principal
Última atualização em

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 Databricks como fonte de conhecimento ou conecte 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:

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

  1. Na barra de navegação mais à esquerda do Power Automate, clique em Criar .

  2. Crie um fluxo e adicione qualquer tipo de gatilho.

  3. No seu novo fluxo, clique em + e pesquise por "Databricks" para ver as ações disponíveis.

  4. 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 os parâmetros avançados, consulte aqui.

    • 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 mais informações sobre o parâmetro, veja aqui.

    • 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 mais informações sobre o parâmetro, veja aqui.

    • 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 mais informações sobre os parâmetros, consulte aqui.

  5. Para interagir com um Job existente do Databricks, selecione uma das seguintes ações:

    • Listar Empregos: Recupera uma lista de empregos. Para mais informação, veja aqui.
    • Aciona uma nova execução de Job: executa um Job e retorna o run_id da execução acionada. Para mais informação, veja aqui.
    • 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ção, veja aqui.
    • Cancelar uma execução: Cancela uma execução de Job ou uma execução de tarefa. Para mais informação, veja aqui.
    • 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ção, veja aqui.

Conecte-se aos Genie spaces no Copilot Studio.​

importante

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

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

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

  1. Na barra lateral do Copilot Studio, clique em Agente .

  2. Selecione um agente existente ou crie um novo agente clicando em + Criar agente em branco .

    • Descreva o agente inserindo uma mensagem e clique em Criar .
    • Ou clique em Ignorar para especificar manualmente as informações do agente.

  3. Na tab Ferramentas , clique em + Adicionar uma ferramenta .

  4. Pesquise por "Databricks" ou selecione Protocolo de Contexto do Modelo .

  5. Selecione Databricks Genie e escolha sua conexão com o Databricks.

  6. Configure a conexão:

    1. Dê um nome à ferramenta. Um nome de ferramenta mais descritivo ajuda o agente do Copilot Studio a orquestrar as solicitações.

    2. Insira o ID Genie Space ou selecione o Genie Space no menu dropdown .

    3. Para usar o fluxo "em nome de" (OBO), selecione "Credenciais do usuário final" como " Credenciais a serem usadas" . Para usar uma identidade única, selecione Credenciais fornecidas pela Maker .

    4. Salve a ferramenta.

    5. (Opcional) Atualize a seção de ferramentas na tela de configuração para confirmar se o espaço Genie está conectado.

  7. 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.

  8. (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.

nota

Se a integração retornar repetidamente "ainda em processamento", mesmo que o agente indique que está consultando o espaço Genie, adicione esta instrução ao seu agente: "Continue consultando o espaço Genie até receber uma resposta."

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:

  1. Na barra lateral do Copilot Studio, clique em Agente .

  2. 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.

  3. Na tab Conhecimento , clique em + Conhecimento .

  4. Clique em Avançado .

  5. Clique em Databricks como fonte de conhecimento.

  6. Insira o nome do catálogo onde seus dados estão armazenados.

  7. Clique em Conectar .

  8. 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:

  1. Crie um aplicativo de tela usando sua conexão com o Databricks no Power Apps.

  2. Crie um fluxo do Power Automate usando a conexão com o Databricks e utilize o Power Apps como gatilho.

  3. No gatilho do Power Automate, adicione os campos de entrada que você deseja passar do Power Apps para o Power Automate.

  4. Crie um objeto de coleção no Power Apps para reunir todas as suas alterações.

  5. Adicione o fluxo do Power Automate ao seu aplicativo de tela.

  6. 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 no Databricks.

Limitações​

Limitações do Copilot Studio​

  • Genie spaces no Copilot Studio suportam até cinco perguntas por minuto devido aos limites de taxa API Genie .

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