Partager via

Obtenir des identificateurs pour les objets de l’espace de travail

Cet article explique comment obtenir l’espace de travail, le calcul classique, le tableau de bord, le répertoire, le modèle, le notebook et les IDENTIFICATEURs de travail et les URL dans Azure Databricks.

Noms d’instance, URL et ID d’espace de travail

Un nom d’instanceunique, également appelé URL par espace de travail, est attribué à chaque déploiement Azure Databricks. Il s’agit du nom de domaine complet utilisé pour se connecter à votre déploiement Azure Databricks et effectuer des demandes d’API.

Un espace de travail Azure Databricks est l’emplacement où la plateforme Azure Databricks s’exécute et où vous pouvez créer des clusters Spark et planifier des charges de travail. Un espace de travail possède un identifiant numérique unique.

URL par espace de travail

L’URL par espace de travail unique a le format adb-<workspace-id>.<random-number>.azuredatabricks.net. L’ID de l’espace de travail apparaît immédiatement après adb- et avant le « point » (.). Pour l’URL par espace de travail https://adb-5555555555555555.19.azuredatabricks.net/ :

  • L’URL de l’espace de travail esthttps://adb-5555555555555555.19.azuredatabricks.net/
  • Le nom de l’instance est adb-5555555555555555.19.azuredatabricks.net.
  • L’ID de l’espace de travail est 5555555555555555.

Déterminer l’URL par espace de travail

Vous pouvez déterminer l’URL par espace de travail de votre espace de travail :

URL régionale héritée

Importante

Évitez les URL régionales héritées. Voici ces restrictions :

  • Peut ne pas fonctionner avec de nouveaux espaces de travail.
  • Sont moins fiables et plus lentes que les URL par espace de travail.
  • Peut interrompre les fonctionnalités qui nécessitent des ID d’espace de travail.

L’URL régionale héritée est composée de la région dans laquelle l’espace de travail Azure Databricks est déployé et du domaine azuredatabricks.net, par exemple, https://westus.azuredatabricks.net/.

  • Si vous vous connectez à une URL régionale héritée telle que https://westus.azuredatabricks.net/, le nom de l’instance est westus.azuredatabricks.net.
  • L’ID de l’espace de travail s’affiche dans l’URL uniquement après vous être connecté à l’aide d’une URL régionale héritée. Il apparaît après le o=. Dans l’URL https://<databricks-instance>/?o=6280049833385130, l’ID de l’espace de travail est 6280049833385130.

URL et ID des ressources de calcul

Les ressources de calcul Azure Databricks fournissent une plateforme unifiée pour différents cas d’usage tels que l’exécution de pipelines ETL de production, l’analytique de streaming, l’analytique ad hoc et le Machine Learning. Chaque ressource de calcul classique a un ID unique appelé ID de cluster. Cela s’applique à la fois aux clusters à usage unique et aux clusters de travaux, mais pas au calcul serverless. Vous avez besoin de l’ID de cluster pour obtenir les détails d’un cluster à l’aide de l’API REST.

Pour obtenir l’ID de cluster, cliquez sur l’icône de calculCalcul dans la barre latérale, puis sélectionnez un nom de cluster. L’ID de cluster est le numéro après le /clusters/ composant dans l’URL de cette page.

https://<databricks-instance>/compute/clusters/<cluster-id>

Dans la capture d’écran suivante, l’ID de cluster est 0130-201722-abcdefgh.

URL du cluster

URL et ID du tableau de bord

Un tableau de bord IA/BI est une présentation des visualisations de données et des commentaires. Chaque tableau de bord a un ID unique. Vous pouvez utiliser cet ID pour construire des liens directs qui incluent des valeurs de filtre et de paramètre prédéfinis, ou accéder au tableau de bord à l’aide de l’API REST.

  • Exemple d’URL du tableau de bord :

    https://adb-62800498333851.30.azuredatabricks.net/sql/dashboardsv3/01ef9214fcc7112984a50575bf2b460f
  • Exemple d’ID de tableau de bord : 01ef9214fcc7112984a50575bf2b460f

URL et ID du notebook

Un notebook est une interface web pour un document qui contient du code exécutable, des visualisations et du texte narratif. Les notebooks constituent une interface permettant d’interagir avec Azure Databricks. Chaque notebook possède un identifiant unique. L’URL du notebook contient l’ID du notebook, et l’URL du notebook est donc propre à un notebook. Elle peut être partagée avec toute personne sur la plateforme Azure Databricks ayant l’autorisation de visualiser et de modifier le notebook. En outre, chaque commande de notebook (cellule) a une URL différente.

Pour rechercher l’URL ou l’ID d’un notebook, ouvrez un notebook. Pour trouver une URL de cellule, cliquez sur le contenu de la commande.

  • Exemple d’URL de notebook :

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342`

  • Exemple d’ID de notebook : 1940481404050342.

  • Exemple d’URL de commande (cellule) :

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342/command/2432220274659491

ID du dossier

Un dossier est un répertoire utilisé pour stocker des fichiers qui peuvent être utilisés dans l’espace de travail Azure Databricks. Ces fichiers peuvent être des notebooks, des bibliothèques ou des sous-dossiers. Un ID spécifique est associé à chaque dossier et à chaque sous-dossier individuel. L’API Autorisations fait référence à cet ID en tant que directory_id, et est utilisée dans la définition et la mise à jour des autorisations pour un dossier.

Pour récupérer le directory_id, utilisez l’API Espace de travail :

curl -n -X GET -H 'Content-Type: application/json' -d '{"path": "/Users/me@example.com/MyFolder"}' \
https://<databricks-instance>/api/2.0/workspace/get-status

Voici un exemple de réponse à l’appel de l’API :

{
  "object_type": "DIRECTORY",
  "path": "/Users/me@example.com/MyFolder",
  "object_id": 123456789012345
}

ID de modèle

Un modèle fait référence à un modèle inscrit MLflow, qui vous permet de gérer les modèles MLflow en production par le biais de transitions de phase et de contrôle de version. L’ID de modèle inscrit est requis pour modifier les autorisations sur le modèle de manière programmatique via l’API Autorisations.

Pour obtenir l’ID d’un modèle inscrit, vous pouvez utiliser le point de terminaison de l’API REST (la plus récente) mlflow/databricks/registered-models/get. Par exemple, le code suivant renvoie l’objet de modèle inscrit avec ses propriétés, y compris son ID :

curl -n -X GET -H 'Content-Type: application/json' -d '{"name": "model_name"}' \
https://<databricks-instance>/api/2.0/mlflow/databricks/registered-models/get

La valeur renvoyée est au format suivant :

{
  "registered_model_databricks": {
    "name": "model_name",
    "id": "ceb0477eba94418e973f170e626f4471"
  }
}

URL et ID du travail

Un travail est un moyen d’exécuter un notebook ou un JAR immédiatement ou de manière planifiée.

Pour obtenir une URL de travail, cliquez sur Travaux icôneTravaux et pipelines dans la barre latérale, puis cliquez sur un nom de travail. L’ID de travail se trouve après le texte #job/ dans l’URL. L’URL du travail est nécessaire pour résoudre les problèmes liés à la cause racine des exécutions de travaux ayant échoué.

Dans la capture d’écran suivante, l’URL du travail est :

https://adb-westus.18.azuredatabricks.net/jobs/5?o=1248852073749208

Dans cet exemple, l’ID de travail est 5.

URL du travail

  • Last updated on