Dê à sua conta de Azure Databricks uma URL personalizada

Importante

Esse recurso está em Visualização Pública.

Um URL personalizado fornece à sua conta do Azure Databricks um único ponto de entrada com marca (por exemplo: acme.databricks.com) que substitui a coleção de URLs por workspace que os usuários da conta navegam hoje. Depois de habilitar uma URL personalizada, os usuários podem fazer logon em sua conta Azure Databricks e mover-se livremente entre workspaces e o Genie One sem autenticar novamente.

Eligibility

Os administradores de conta qualificados podem reivindicar e habilitar uma URL personalizada diretamente do console da conta. Os seguintes requisitos de qualificação se aplicam:

  • Sua conta deve ser uma conta de cliente paga e verificada.
  • O administrador da conta que habilita a URL personalizada deve ter um endereço de email de domínio não reservado.

Se você tiver recebido anteriormente uma URL personalizada, ela será exibida automaticamente nas configurações da sua conta. Para renomear sua URL personalizada, entre em contato com sua equipe de conta do Azure Databricks.

Note

Azure Databricks reserva o direito de alterar, recuperar ou revogar uma URL personalizada a qualquer momento. Sempre que possível, fornecemos aviso prévio e ajuda a coordenar uma substituição.

Requisitos

Atualmente, os conectores de parceiro a seguir não dão suporte a URLs personalizadas. Configure essas conexões usando a URL herdada da sua conta. Todos os outros conectores têm suporte.

Atribuir uma URL personalizada

Note

Se você tiver recebido anteriormente uma URL personalizada, ela será exibida automaticamente nas configurações da sua conta. Se você quiser renomear sua URL personalizada existente, entre em contato com sua equipe de conta do Azure Databricks.

  1. No console da conta, acesse as Configurações > da conta.
  2. Clique no botão Solicitar sua URL para habilitar a URL personalizada.
  3. Opcionalmente, habilite a configuração de redirecionamento automático para redirecionar automaticamente todas as URLs de workspace herdadas para sua URL Personalizada.

Depois de habilitar a URL personalizada, navegue até o Genie One em acme.azuredatabricks.net/one. Os usuários em sua conta agora podem acessar ativos em qualquer workspace ao qual têm acesso sem serem solicitados a fazer logon novamente.

Suporte a ferramentas para desenvolvedores

As ferramentas de desenvolvedor Azure Databricks a seguir dão suporte a URLs personalizadas. Atualize para pelo menos a versão mínima listada para garantir a compatibilidade.

Tool Versão mínima
CLI/DABs 1.0.0
Terraform 1.114.0
SDK do Go 0.130.0
SDK do Python 0.103.0
SDK do Java 0.105.0
Extensão do VS Code 2.11.0

O que muda quando você usa uma URL personalizada

A maioria das funcionalidades do Azure Databricks funciona sem alterações ao começar a usar uma URL personalizada. As seguintes aplicações e integrações exigem configurações adicionais.

Dashboards embarcados para usuários externos

Para usar sua URL personalizada para dashboards embutidos para usuários externos, atualize seu aplicativo de incorporação:

  1. Substitua a URL da instância específica do workspace pela sua URL personalizada.
  2. Adicione o ID do workspace de destino às solicitações /oidc/v1/token e /api/2.0/lakeview/dashboards/<dashboard-id>/published/tokeninfo usando o parâmetro de consulta o=<workspace-id>. Use ?o=<workspace-id> quando for o primeiro parâmetro de consulta, ou &o=<workspace-id> quando a URL já tiver parâmetros de consulta.

Veja Use o aplicativo de exemplo para autenticar e gerar tokens para exemplos completos de Python e JavaScript.