> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conector Databricks

> Configure um conector Databricks para que o Replit Agent possa criar aplicativos orientados a dados com base no seu workspace do Databricks.

<Info>
  O conector Databricks está disponível exclusivamente no plano **Enterprise**.
</Info>

<Frame>
  <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown-zoom.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=92d2df97ba167b7fd5b9dfe7509e7dfa" alt="Caixa de prompt inicial do Replit com o menu suspenso Templates aberto, mostrando o template de org Databricks App" width="1680" height="300" data-path="images/connectors/databricks/templates-dropdown-zoom.png" />
</Frame>

O conector Databricks permite que o Replit Agent consulte o seu workspace do Databricks. Os desenvolvedores podem criar dashboards, ferramentas de relatórios e aplicativos de dados usando linguagem natural. Nenhum conhecimento de SQL é necessário.

A configuração é um processo único que envolve um administrador do Databricks e um administrador da organização Replit. Uma vez configurado, os desenvolvedores com acesso podem usar o conector a partir do Replit.

Este guia abrange a configuração completa em três funções:

1. **Administrador do Databricks**: cria o service principal e concede permissões no Databricks.
2. **Administrador do Replit**: configura o conector no Replit.
3. **Desenvolvedor**: começa a criar com os dados do Databricks.

## Pré-requisitos

Antes de começar, confirme o seguinte.

**Funções**

* Administrador de conta ou workspace do [Databricks](https://www.databricks.com/)
* Administrador da organização [Replit](https://replit.com/)

## Etapa 1: Criar um service principal no Databricks

<Note>
  Você deve ser um administrador de conta ou workspace do Databricks para concluir esta etapa.
</Note>

O administrador do Databricks cria uma identidade máquina a máquina, chamada service principal, que o Replit usa para se conectar ao Databricks.

<Steps>
  <Step title="Abrir Configurações">
    No Databricks, selecione seu avatar no canto superior direito e, em seguida, selecione **Configurações**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-menu.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4179d36f68585cf88af24ab86d960694" alt="Menu do workspace do Databricks com Configurações selecionado" width="3438" height="1984" data-path="images/connectors/databricks/settings-menu.png" />
    </Frame>
  </Step>

  <Step title="Selecionar Identidade e acesso">
    Na barra lateral de Configurações, selecione **Identidade e acesso**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8e22324831c8804b135a3b5e550e7f45" alt="Página de Configurações do Databricks com Identidade e acesso na barra lateral" width="3438" height="1984" data-path="images/connectors/databricks/settings-page.png" />
    </Frame>
  </Step>

  <Step title="Gerenciar service principals">
    Em **Gerenciamento e permissões**, encontre **Service principals** e selecione **Gerenciar**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/identity-and-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4c502716a573596cbe0550644036654d" alt="Página de configurações de Identidade e acesso mostrando o botão Gerenciar de Service principals" width="3438" height="1984" data-path="images/connectors/databricks/identity-and-access.png" />
    </Frame>
  </Step>

  <Step title="Adicionar um novo service principal">
    Selecione **Adicionar service principal** e, em seguida, selecione **Adicionar novo**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ca1c2ec068049bd48b2c590d9cae4b3f" alt="Caixa de diálogo Adicionar service principal com o botão Adicionar novo" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal.png" />
    </Frame>
  </Step>

  <Step title="Nomear o service principal">
    Insira um nome claro para o service principal e selecione **Adicionar**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal-name.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2490e64e7bb1516e153f7690da5c9a2" alt="Caixa de diálogo Adicionar service principal com um nome de service principal inserido" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal-name.png" />
    </Frame>
  </Step>

  <Step title="Confirmar os detalhes do service principal">
    Após o Databricks criar o service principal, confirme se ele está ativo. Mantenha esta página aberta caso precise dos detalhes do service principal ao configurar o conector do Replit.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/service-principal-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ffdb270b49e7b6a330c3691358b8234b" alt="Página de detalhes do service principal do Databricks" width="3438" height="1984" data-path="images/connectors/databricks/service-principal-details.png" />
    </Frame>
  </Step>

  <Step title="Conceder acesso">
    Abra a aba **Permissões**, selecione **Conceder acesso**, escolha o service principal, defina a permissão como **Gerenciar** e selecione **Salvar**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/grant-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ee85ab8f1741b86f830efcd80427a596" alt="Caixa de diálogo Conceder acesso para um service principal do Databricks com a permissão Gerenciar selecionada" width="3438" height="1984" data-path="images/connectors/databricks/grant-access.png" />
    </Frame>
  </Step>
</Steps>

## Etapa 2: Obter os detalhes de conexão do SQL Warehouse

O conector do Replit precisa dos detalhes de conexão do Databricks SQL Warehouse para direcionar consultas ao recurso de computação correto.

<Steps>
  <Step title="Abrir SQL Warehouses">
    Na barra lateral do Databricks, selecione **SQL Warehouses**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/sql-warehouses.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8610ede28b6a723fd5774fb9e97c7485" alt="Página de SQL Warehouses do Databricks mostrando os warehouses disponíveis" width="3438" height="1984" data-path="images/connectors/databricks/sql-warehouses.png" />
    </Frame>
  </Step>

  <Step title="Selecionar ou criar um warehouse">
    Selecione o SQL Warehouse que você deseja que o Replit Agent use. Se você ainda não tiver um, selecione **Criar SQL warehouse** e crie um novo warehouse.
  </Step>

  <Step title="Copiar os detalhes de conexão">
    Abra o warehouse e selecione **Detalhes de conexão**. Localize os valores de **Nome do host do servidor** e **Caminho HTTP**. Você precisará desses valores ao criar o conector do Databricks no Replit.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connection-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=b2e51207eb945f4e9e939caa093c2b23" alt="Página de detalhes de conexão do SQL Warehouse do Databricks com nome do host do servidor e caminho HTTP" width="3438" height="1984" data-path="images/connectors/databricks/connection-details.png" />
    </Frame>
  </Step>
</Steps>

## Etapa 3: Criar o conector Databricks no Replit

<Note>
  Você deve ser um administrador da organização Replit para configurar conectores.
</Note>

O administrador do Replit adiciona os detalhes de conexão do Databricks ao Replit para que os desenvolvedores possam usar o conector.

<Steps>
  <Step title="Navegar até Integrações">
    Na página inicial da sua organização, abra a página de **Integrações**. Em **Conectores**, encontre **Databricks (Service Principal)** e selecione **Entrar**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-databricks-signin.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f3b1558a4d4afc021fd7b2be96004ea7" alt="Página de Integrações do Replit filtrada para Databricks, mostrando o conector Databricks (Service Principal) com o botão Entrar" width="3436" height="1978" data-path="images/connectors/databricks/integrations-databricks-signin.png" />
    </Frame>
  </Step>

  <Step title="Confirmar a conexão">
    O Replit mostra uma caixa de diálogo de confirmação antes de redirecionar para o Databricks para autenticação. Revise os detalhes e selecione **Continuar para o Databricks**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connect-databricks-intro.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=d1bd23f4bb71d62a555993b106f4596e" alt="Caixa de diálogo Conectar Databricks explicando o redirecionamento OAuth, uso de dados e permissões" width="3436" height="1978" data-path="images/connectors/databricks/connect-databricks-intro.png" />
    </Frame>
  </Step>

  <Step title="Inserir o caminho HTTP do SQL Warehouse">
    Cole o **Caminho HTTP** dos detalhes de conexão do seu Databricks SQL Warehouse (por exemplo, `/sql/1.0/warehouses/abcdef1234567890`) e selecione **Próximo**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-http-path.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=c68fa0868bed7dbd56c46f3be3bbc4b3" alt="Caixa de diálogo Conectar Databricks, etapa 1 de 2, solicitando o caminho HTTP do SQL Warehouse" width="3436" height="1978" data-path="images/connectors/databricks/connector-http-path.png" />
    </Frame>
  </Step>

  <Step title="Inserir o nome do host do servidor do SQL Warehouse">
    Cole o **Nome do host do servidor** dos mesmos detalhes de conexão (por exemplo, `abc-12345678-wxyz.cloud.databricks.com`) e selecione **Continuar para o Databricks** para concluir a autenticação.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-server-hostname.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=0b8210206a0941725aa1eb71a2b1d99e" alt="Caixa de diálogo Conectar Databricks, etapa 2 de 2, solicitando o nome do host do servidor do SQL Warehouse" width="3436" height="1978" data-path="images/connectors/databricks/connector-server-hostname.png" />
    </Frame>
  </Step>

  <Step title="Configurar acesso">
    Use o Controle de Acesso Baseado em Função para escolher quais membros ou grupos da sua organização podem usar este conector.
  </Step>

  <Step title="Verificar se o conector está ativo">
    De volta à página de **Integrações**, confirme que **Databricks (Service Principal)** aparece em **Conectores** com o status de conexão **Ativo**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2bb0eac84b4d08e7d7213f5aa5e1a9f" alt="Página de Integrações do Replit mostrando o conector Databricks (Service Principal) com status de conexão Ativo" width="1680" height="1199" data-path="images/connectors/databricks/integrations-page.png" />
    </Frame>
  </Step>
</Steps>

## Etapa 4: Criar com o Agent

Após a conexão, os desenvolvedores podem criar aplicativos que usam dados do Databricks com o Agent.

<Steps>
  <Step title="Iniciar um projeto">
    Na página inicial do Replit, abra a caixa de prompt para iniciar um novo projeto.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/home-default.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=36baeac209507cbe0cb8a0f5a14a7c5d" alt="Página inicial do Replit com a caixa de prompt e o menu suspenso Templates" width="1680" height="1199" data-path="images/connectors/databricks/home-default.png" />
    </Frame>
  </Step>

  <Step title="Selecionar o template Databricks App">
    Abra o menu suspenso **Templates** e escolha **Databricks App** em **Templates da org**. O prompt é preenchido automaticamente com instruções que informam ao Agent como usar o seu conector Databricks.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=707bf8f7247ef849e1064d33dfa09d3a" alt="Menu suspenso Templates aberto mostrando o template Databricks App em Templates da org" width="1680" height="1199" data-path="images/connectors/databricks/templates-dropdown.png" />
    </Frame>

    Adicione seu próprio prompt após as instruções preenchidas para descrever o que você deseja criar. Para inspiração, navegue pelos [templates do Databricks Dev Hub](https://www.databricks.com/devhub/templates).

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/agent-prompt-filled.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=edc9c3d4e326a265ce3a20dfd5d2bc00" alt="Caixa de prompt com o template Databricks App selecionado e instruções preenchidas automaticamente" width="1680" height="1199" data-path="images/connectors/databricks/agent-prompt-filled.png" />
    </Frame>
  </Step>

  <Step title="Revisar e iterar">
    Revise o SQL que o Agent gera, as tabelas que ele consulta e a estrutura do aplicativo. Itere pedindo alterações em linguagem natural.
  </Step>
</Steps>

## Solução de problemas

<AccordionGroup>
  <Accordion title="A autenticação falha após a criação do service principal">
    Verifique se os detalhes do service principal inseridos no Replit correspondem ao service principal criado no Databricks. Se as credenciais foram alteradas, atualize o conector no Replit.
  </Accordion>

  <Accordion title="O Agent consegue ver os schemas, mas as consultas retornam resultados vazios">
    O service principal pode ter acesso aos metadados, mas sem permissão de leitura nos dados. Conceda as permissões necessárias de tabela, schema ou catálogo no Databricks e tente novamente.
  </Accordion>

  <Accordion title="O conector não consegue alcançar o SQL Warehouse">
    Verifique se os valores de **Nome do host do servidor** e **Caminho HTTP** correspondem aos detalhes de conexão do SQL Warehouse no Databricks.
  </Accordion>
</AccordionGroup>

## Documentação relacionada

* [Visão geral dos conectores de warehouse](/pt/connectors/warehouses/overview): todos os conectores de warehouse suportados.
* [Conectar Snowflake](/pt/connectors/warehouses/snowflake): configuração passo a passo do Snowflake.
* [Gerenciando seus conectores](/pt/replitai/managing-connectors): gerenciamento e configuração de conectores.
* [Service principals do Databricks](https://docs.databricks.com/en/admin/users-groups/service-principals.html): documentação do Databricks sobre service principals.
* [SQL Warehouses do Databricks](https://docs.databricks.com/en/compute/sql-warehouse/index.html): documentação do Databricks sobre computação SQL Warehouse.
