Donnez à votre compte Azure Databricks une URL personnalisée

Important

Cette fonctionnalité est disponible en préversion publique.

Une URL personnalisée donne à votre compte Azure Databricks un point d’entrée unique marqué (par exemple : acme.databricks.com) qui remplace la collection d’URL par espace de travail auxquelles les utilisateurs accèdent aujourd’hui. Après avoir activé une URL personnalisée, les utilisateurs peuvent se connecter à leur compte Azure Databricks et se déplacer librement entre les espaces de travail et Genie One sans réauthentification.

Eligibility

Les administrateurs de compte éligibles peuvent revendiquer et activer une URL personnalisée directement à partir de la console de compte. Les conditions d’éligibilité suivantes s’appliquent :

  • Votre compte doit être un compte client payant et vérifié.
  • L’administrateur de compte qui active l’URL personnalisée doit avoir une adresse e-mail de domaine non réservée.

Si vous avez déjà reçu une URL personnalisée, elle apparaît automatiquement dans les paramètres de votre compte. Pour renommer votre URL personnalisée, contactez votre équipe de compte Azure Databricks.

Note

Azure Databricks se réserve le droit de modifier, récupérer ou révoquer une URL personnalisée à tout moment. Dans la mesure du possible, nous fournissons un avis préalable et nous aidons à coordonner un remplacement.

Exigences

Les connecteurs partenaires suivants ne prennent actuellement pas en charge les URL personnalisées. Configurez ces connexions à l’aide de l’URL héritée de votre compte. Tous les autres connecteurs sont pris en charge.

Attribuer une URL personnalisée

Note

Si vous avez déjà reçu une URL personnalisée, elle apparaît automatiquement dans les paramètres de votre compte. Si vous souhaitez renommer votre URL personnalisée existante, contactez votre équipe de compte Azure Databricks.

  1. Dans la console de compte, accédez aux > paramètres du compte.
  2. Cliquez sur le bouton Réclamer votre URL pour activer l’URL personnalisée.
  3. Si vous le souhaitez, activez le paramètre de redirection automatique pour rediriger automatiquement toutes les URL d’espace de travail héritées vers votre URL personnalisée.

Après avoir activé l’URL personnalisée, accédez à Genie One à l’adresse acme.azuredatabricks.net/one. Les utilisateurs de votre compte peuvent désormais accéder aux ressources dans n’importe quel espace de travail auquel ils ont accès sans être invités à se reconnecter.

Prise en charge des outils de développement

Les outils de développement Azure Databricks suivants prennent en charge les URL personnalisées. Effectuez une mise à niveau vers au moins la version minimale répertoriée pour garantir la compatibilité.

Outil Version minimale
CLI / DABs 1.0.0
Terraform 1.114.0
Kit de développement logiciel (SDK) Go 0.130.0
Kit de développement logiciel (SDK) Python 0.103.0
Kit de développement logiciel (SDK) Java 0.105.0
Extension VS Code 2.11.0

Que change-t-il lorsque vous utilisez une URL personnalisée

La plupart des fonctionnalités Azure Databricks fonctionnent as-is lorsque vous commencez à utiliser une URL personnalisée. Les applications et intégrations suivantes nécessitent une configuration supplémentaire.

Tableaux de bord intégrés pour utilisateurs externes

Pour utiliser votre URL personnalisée pour des tableaux de bord intégrés aux utilisateurs externes, mettez à jour votre application d’intégration :

  1. Remplacez l’URL de l’instance propre à l’espace de travail par votre URL personnalisée.
  2. Ajoutez l’identifiant de l’espace de travail cible aux requêtes /oidc/v1/token et /api/2.0/lakeview/dashboards/<dashboard-id>/published/tokeninfo à l’aide du paramètre de requête o=<workspace-id>. À utiliser ?o=<workspace-id> lorsqu’il s’agit du premier paramètre de requête, ou &o=<workspace-id> lorsque l’URL possède déjà des paramètres de requête.

Voir : Utilisez l’application d’exemple pour authentifier et générer des jetons pour des exemples complets en Python et JavaScript.