Dê à sua conta Databricks uma URL personalizada
Visualização
Este recurso está em Pré-visualização Pública.
Um URL personalizado fornece à sua conta Databricks um ponto de entrada único e de marca (por exemplo: acme.databricks.com) que substitui a coleção de URLs por espaço de trabalho que os usuários da conta precisam navegar atualmente. Após habilitar uma URL personalizada, os usuários podem iniciar sessão na conta Databricks e navegar livremente entre workspaces e o Genie One sem precisar se autenticar novamente.
Elegibilidade
Os administradores de account elegíveis podem reivindicar e habilitar um URL personalizado diretamente do console da account. Os seguintes requisitos de elegibilidade se aplicam:
- Sua account deve ser uma account de cliente pagante e verificada.
- O administrador account que habilita o URL personalizado deve ter um endereço de email de domínio não reservado.
Se você foi atribuído anteriormente a um URL personalizado, ele aparecerá automaticamente nas configurações da sua conta. Para renomear seu URL personalizado, entre em contato com sua equipe de conta da Databricks.
A Databricks reserva-se o direito de alterar, reivindicar ou revogar um URL personalizado a qualquer momento. Sempre que possível, fornecemos aviso prévio e ajudamos a coordenar uma substituição.
Requisitos
- Sua account precisa estar habilitada para login unificado. Contas criadas após 21 de junho de 2023 e aquelas que configuraram SSO após 12 de dezembro de 2024 terão essa funcionalidade ativada automaticamente.
- Seu espaço de trabalho não deve usar o recurso Private Link Inbound (front-end). Os URLs para espaços de trabalho protegidos por Link Privado de entrada voltam a usar os URLs legados porworkspace .
- O Private Link de entrada para recursos de nível de conta (como o console da conta e o Genie One de nível de conta) é compatível na versão Beta.
Atribua um URL personalizado
Se um URL personalizado já tiver sido atribuído a você, ele aparecerá automaticamente nas configurações da sua account. Se desejar renomear seu URL personalizado existente, entre em contato com a equipe da sua conta Databricks.
- No console account , acesse Configurações > configurações da conta .
- Clique no botão **Reivindicar sua URL** para habilitar a URL personalizada.
- Opcionalmente, ative a configuração de redirecionamento automático para redirecionar todos os URLs de workspace legados para seu URL Personalizado.
Após ativar o URL personalizado, acesse o Genie One em acme.databricks.com/one. Usuários em sua conta agora podem acessar ativos em qualquer workspace a que tenham acesso sem que seja solicitado que façam log in novamente.
Suporte a ferramentas para desenvolvedores
As seguintes ferramentas para desenvolvedores da Databricks oferecem suporte a URLs personalizadas. Atualize para pelo menos a versão mínima listada para garantir a compatibilidade.
Ferramenta | Versão mínima |
|---|---|
CLI/DABs | 1.0.0 |
Terraform | 1.114.0 |
SDK Go | 0.130.0 |
SDK Python | 0.103.0 |
SDK Java | 0.105.0 |
Extensão do VS Code | 2.11.0 |
O que muda quando você usa um URL personalizado
A maioria das funcionalidades do Databricks funciona como está quando você começa a usar um URL personalizado. Os seguintes aplicativos e integrações exigem configuração adicional.
Dashboards incorporados para usuários externos
Para usar sua URL personalizada para painéis incorporados para usuários externos, atualize seu aplicativo de incorporação:
- Substitua a URL da instância específica do workspace pela sua URL personalizada.
- Adicione o ID do workspace de destino às solicitações
/oidc/v1/tokene/api/2.0/lakeview/dashboards/<dashboard-id>/published/tokeninfousando o parâmetro de queryo=<workspace-id>. Use?o=<workspace-id>quando for o primeiro parâmetro de query, ou&o=<workspace-id>quando a URL já tiver parâmetros de query.
Consulte Usar o aplicativo de exemplo para autenticar e gerar tokens para obter exemplos completos em Python e JavaScript.