Conecte-se ao Databricks a partir do Microsoft Power Platform

info

Visualização

Esse recurso está em Public Preview.

Esta página explica como se conectar ao Databricks a partir do Microsoft Power Platform, adicionando o Databricks como uma conexão de dados. Quando conectado, o senhor pode usar os dados do Databricks nas seguintes plataformas:

• Power Apps : Crie aplicativos que possam ler e gravar no Databricks, preservando os controles de governança do Databricks.
• Power Automate : Crie fluxos e adicione ações que permitam a execução do SQL personalizado ou de um Job existente e obtenha os resultados.
• Copilot Studio : Crie agentes personalizados usando os dados do Databricks como fonte de conhecimento.

Antes de começar

Antes de se conectar ao Databricks a partir do Power Platform, o senhor deve atender aos seguintes requisitos:

• O senhor tem um access token (PAT) pessoal para o seu Databricks workspace. Para gerar um PAT, consulte Databricks personal access token authentication.

• Você tem uma licença premium do Power Apps.

• O senhor tem um Databricks account.

• O senhor tem acesso a um SQL warehouse em Databricks.

o passo 1: Adicionar uma conexão Databricks ao Power Platform

nota

Se o senhor estiver usando o Copilot Studio, o conector do Databricks deverá ser definido usando o Power Apps ou o Power Automate. Em seguida, ele pode ser usado no Copilot Studio.

Para adicionar uma conexão Databricks, faça o seguinte:

1. Em Power Apps ou Power Automate, na barra lateral, clique em Conexões.

   Se você não ver Conexões na barra lateral, clique em Mais > Conexões .

2. Clique em + Nova conexão no canto superior esquerdo.

3. Procure por "Databricks" usando a barra de pesquisa no canto superior direito.

4. Clique no bloco Databricks .

   Não clique no bloco "Azure Databricks".

5. Digite suas informações de autenticação.

   • Para a chaveAPI , digite seu PAT no formato "Bearer <personal-access-token>". Para gerar um PAT, consulte Databricks personal access token authentication.
   • Em Server hostname (Nome do host do servidor ), digite o servidor do warehouse Databricks SQL hostname.
   • Em HTTP Path (Caminho HTTP), digite o caminho HTTP do SQL warehouse.

   Para encontrar o depósito Databricks SQL e os detalhes da conexão do caminho HTTP, consulte Obter detalhes da conexão para um recurso Databricks compute.

6. Clique em Criar .

o passo 2: Usar a conexão Databricks

Depois de criar uma conexão com o Databricks no Power Apps ou no Power Automate, o senhor pode usar os dados do Databricks para criar aplicativos do Power Canvas, fluxos do Power Automate e agentes do Copilot Studio.

Use seus dados do Databricks para criar aplicativos do Power Canvas

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

1. Na barra de navegação mais à esquerda, 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. Em seu aplicativo, clique em Add data (Adicionar dados) > Connectors (Conectores) > Databricks (Tecidos de dados ). Clique na conexão Databricks que o senhor criou.
4. Selecione um catálogo na barra lateral Choose a dataset (Escolha um conjunto de dados ).
5. Na barra lateral Choose a dataset (Escolher um conjunto de dados ), selecione todas as tabelas às quais deseja conectar seu aplicativo canvas.
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 somente para tabelas que tenham um key primário definido. Ao realizar operações de criação, o senhor deve sempre especificar o endereço primário key.

O Databricks oferece suporte a colunas de identidade geradas. Nesse caso, os valores primários de key 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

A API de execução de instruções e a API de trabalhos da Databricks são expostas no Power Automate, permitindo que o senhor escreva instruções SQL e execute trabalhos 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, clique em Criar.

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

3. Em 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 declaração SQL: Escreva e execute a declaração SQL. Digite o seguinte:

     • Para Body/warehouse_id , digite o ID do depósito no qual a instrução SQL será executada.
     • Em Body/statement_id , digite o ID da instrução SQL a ser executada.

     Para saber mais sobre os parâmetros avançados, veja aqui.

   • Verificar o status e obter resultados : Verificar o status de uma instrução SQL e obter resultados. Digite o seguinte:

     • Em Statement ID , digite o ID retornado quando o comando SQL foi executado.

     Para obter mais informações sobre o parâmetro, consulte aqui.

   • Cancelar a execução de uma instrução: Encerrar a execução de uma instrução SQL. Digite o seguinte:

     • Em Statement ID , digite o ID da instrução SQL a ser encerrada.

     Para obter mais informações sobre o parâmetro, consulte aqui.

   • Obtenha resultados por índice de partes: obtenha resultados por índice de partes, o que é adequado para grandes conjuntos de resultados. Digite o seguinte:

     • Em Statement ID , digite o ID da instrução SQL cujos resultados o senhor deseja recuperar.
     • Em Índice de partes, insira o índice de partes de destino.

     Para saber mais sobre os parâmetros, veja aqui.

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

   • Listar trabalho: Recupera uma lista de trabalhos. Para obter mais informações, consulte aqui.
   • Acionar a execução de um novo trabalho: executa um trabalho e retorna o endereço run_id da execução acionada. Para obter mais informações, consulte aqui.
   • Obtém a execução de um único trabalho: Retorna metadados sobre uma execução, incluindo o status da execução (por exemplo, RUNNING, SUCCESS, FAILED), horário de início e término, duração da execução, cluster informações e assim por diante. Para obter mais informações, consulte aqui.
   • Cancelar a execução: Cancela a execução de um trabalho ou de uma tarefa. Para obter mais informações, consulte aqui.
   • Obter a saída de uma única execução: Recupera a saída e os metadados de um único trabalho ou execução de tarefa. Para obter mais informações, consulte aqui.

Usar o Databricks como uma 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, clique em Agente .

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

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

3. Em Knowledge tab, clique em + Knowledge .

4. Clique em Avançado .

5. Clique em Databricks como a fonte de conhecimento.

6. Insira o nome do catálogo em que seus dados estão.

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 o senhor precisar executar operações de criação, atualização ou exclusão em massa em resposta às entradas do Power Apps, a Databricks recomenda a implementação de um fluxo do Power Automate. Para fazer isso, faça o seguinte:

1. Crie um aplicativo canvas usando sua conexão Databricks no Power Apps.

2. Crie um fluxo do Power Automate usando a conexão do Databricks e use o Power Apps como acionador.

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 coletar 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 canvas 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 simultaneidade no nível da linha reduz os conflitos entre as operações de gravação da concorrente, detectando alterações no nível da linha e resolvendo automaticamente os conflitos que ocorrem quando as gravações da concorrente atualizam ou excluem linhas diferentes no mesmo arquivo de dados.

A simultaneidade em nível de linha está incluída em Databricks Runtime 14.2 ou acima. A simultaneidade em nível de linha é suportada pelo site default para os seguintes tipos de tabelas:

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

Para ativar os 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 gravação concorrente em Databricks, consulte Níveis de isolamento e conflitos de gravação em Databricks.

Adicionar Databricks a uma política de dados

Ao adicionar o Databricks a uma política de dados comerciais, o Databricks não pode compartilhar dados com conectores de outros grupos. Isso protege seus dados e evita que sejam compartilhados com aqueles que não deveriam ter acesso a eles. Para obter mais informações, consulte gerenciar políticas de dados.

Para adicionar o conector Databricks a uma política de dados do Power Platform:

1. Em qualquer aplicativo do Power Platform, clique na engrenagem de configurações no canto superior direito e clique em Central de administração .

2. Na barra lateral, clique em Políticas > Políticas de dados .

   • Se você estiver usando o novo centro de administração, clique em Segurança > Dados e Privacidade > Política de Dados .

3. Clique em + Nova política ou em uma política existente.

4. Se estiver criando uma nova política, insira um nome.

5. Selecione um ambiente para adicionar à sua política e clique em + Adicionar à política acima.

6. Clique em Avançar .

7. Procure e clique no conector Databricks.

8. Clique em Mover para negócios e clique em Avançar .

9. Revise sua política e clique em Criar política .

Limitações

• O conector da Power Platform não é compatível com o governo clouds.

Limitações do Power App

As seguintes fórmulas PowerFX calculam valores usando somente os dados que foram recuperados localmente:

Categoria	Fórmula
Função de tabela	Agrupar por Distinto
Agregação	Contagem de linhas StDevP STDevs