Saltar para o conteúdo principal

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.

O conector Databricks está disponível exclusivamente no plano Enterprise.
Caixa de prompt inicial do Replit com o menu suspenso Templates aberto, mostrando o template de org Databricks App
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. Algumas dessas restrições poderão ser relaxadas no futuro à medida que o Replit e o Databricks adicionem funcionalidades. Funções
  • Administrador de conta ou workspace do Databricks
  • Administrador da organização Replit
Restrições do workspace do Databricks
  • Sem perfil de segurança de conformidade (CSP), como HIPAA, FedRAMP ou PCI.
  • Ingresso aberto, sem listas de acesso por IP ou controles de ingresso baseados em contexto.
  • Egresso aberto, sem Secure Egress Gateway (SEG) ou firewalls.
  • Sem PrivateLink.

​
Etapa 1: Criar um service principal no Databricks

Você deve ser um administrador de conta ou workspace do Databricks para concluir esta etapa.
O administrador do Databricks cria uma identidade máquina a máquina, chamada service principal, que o Replit usa para se conectar ao Databricks.
1

Abrir Configurações

No Databricks, selecione seu avatar no canto superior direito e, em seguida, selecione Configurações.
Menu do workspace do Databricks com Configurações selecionado
2

Selecionar Identidade e acesso

Na barra lateral de Configurações, selecione Identidade e acesso.
Página de Configurações do Databricks com Identidade e acesso na barra lateral
3

Gerenciar service principals

Em Gerenciamento e permissões, encontre Service principals e selecione Gerenciar.
Página de configurações de Identidade e acesso mostrando o botão Gerenciar de Service principals
4

Adicionar um novo service principal

Selecione Adicionar service principal e, em seguida, selecione Adicionar novo.
Caixa de diálogo Adicionar service principal com o botão Adicionar novo
5

Nomear o service principal

Insira um nome claro para o service principal e selecione Adicionar.
Caixa de diálogo Adicionar service principal com um nome de service principal inserido
6

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.
Página de detalhes do service principal do Databricks
7

Conceder acesso

Abra a aba Permissões, selecione Conceder acesso, escolha o service principal, defina a permissão como Gerenciar e selecione Salvar.
Caixa de diálogo Conceder acesso para um service principal do Databricks com a permissão Gerenciar selecionada

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

Abrir SQL Warehouses

Na barra lateral do Databricks, selecione SQL Warehouses.
Página de SQL Warehouses do Databricks mostrando os warehouses disponíveis
2

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

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.
Página de detalhes de conexão do SQL Warehouse do Databricks com nome do host do servidor e caminho HTTP

​
Etapa 3: Criar o conector Databricks no Replit

Você deve ser um administrador da organização Replit para configurar conectores.
O administrador do Replit adiciona os detalhes de conexão do Databricks ao Replit para que os desenvolvedores possam usar o conector.
1

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.
Página de Integrações do Replit filtrada para Databricks, mostrando o conector Databricks (Service Principal) com o botão Entrar
2

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.
Caixa de diálogo Conectar Databricks explicando o redirecionamento OAuth, uso de dados e permissões
3

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.
Caixa de diálogo Conectar Databricks, etapa 1 de 2, solicitando o caminho HTTP do SQL Warehouse
4

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.
Caixa de diálogo Conectar Databricks, etapa 2 de 2, solicitando o nome do host do servidor do SQL Warehouse
5

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

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.
Página de Integrações do Replit mostrando o conector Databricks (Service Principal) com status de conexão Ativo

​
Etapa 4: Criar com o Agent

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

Iniciar um projeto

Na página inicial do Replit, abra a caixa de prompt para iniciar um novo projeto.
Página inicial do Replit com a caixa de prompt e o menu suspenso Templates
2

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.
Menu suspenso Templates aberto mostrando o template Databricks App em Templates da org
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.
Caixa de prompt com o template Databricks App selecionado e instruções preenchidas automaticamente
3

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.

​
Solução de problemas

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.
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.
Confirme se o workspace atende aos pré-requisitos: sem perfil de segurança de conformidade, sem listas de acesso por IP, sem Secure Egress Gateway e sem PrivateLink. Essas restrições poderão ser relaxadas no futuro.
Verifique se os valores de Nome do host do servidor e Caminho HTTP correspondem aos detalhes de conexão do SQL Warehouse no Databricks.

​
Documentação relacionada