Id's ophalen voor werkruimteobjecten

  • Artikel

In dit artikel wordt uitgelegd hoe u werkruimte-, cluster-, directory-, model-, notebook- en taak-id's en -URL's in Azure Databricks kunt ophalen.

Namen, URL's en id's van werkruimte-exemplaren

Een unieke instantienaam, ook wel een URL per werkruimte genoemd, wordt toegewezen aan elke Azure Databricks-implementatie. Dit is de volledig gekwalificeerde domeinnaam die wordt gebruikt om u aan te melden bij uw Azure Databricks-implementatie en API-aanvragen te doen.

Een Azure Databricks-werkruimte is waar het Azure Databricks-platform wordt uitgevoerd en waar u Spark-clusters kunt maken en workloads kunt plannen. Een werkruimte heeft een unieke numerieke werkruimte-id.

URL per werkruimte

De unieke URL per werkruimte heeft de indeling adb-<workspace-id>.<random-number>.azuredatabricks.net. De werkruimte-id wordt direct na adb- en vóór de punt (.) weergegeven. Voor de URL https://adb-5555555555555555.19.azuredatabricks.net/per werkruimte:

  • De naam van het exemplaar is adb-5555555555555555.19.azuredatabricks.net.
  • De werkruimte-id is 5555555555555555.

URL per werkruimte bepalen

U kunt de URL per werkruimte voor uw werkruimte bepalen:

Verouderde regionale URL

Belangrijk

Vermijd het gebruik van verouderde regionale URL's. Ze werken mogelijk niet voor nieuwe werkruimten, zijn minder betrouwbaar en vertonen lagere prestaties dan URL's per werkruimte.

De verouderde regionale URL bestaat uit de regio waar de Azure Databricks-werkruimte wordt geïmplementeerd plus het domein azuredatabricks.net, bijvoorbeeld https://westus.azuredatabricks.net/.

  • Als u zich aanmeldt bij een verouderde regionale URL, zoals https://westus.azuredatabricks.net/, is westus.azuredatabricks.netde naam van het exemplaar .
  • De werkruimte-id wordt pas weergegeven in de URL nadat u zich hebt aangemeld met een verouderde regionale URL. Het verschijnt na de o=. In de URL https://<databricks-instance>/?o=6280049833385130is 6280049833385130de werkruimte-id.

Cluster-URL en ID

Een Azure Databricks-cluster biedt een geïntegreerd platform voor verschillende gebruiksvoorbeelden, zoals het uitvoeren van ETL-pijplijnen voor productie, streaminganalyse, ad-hocanalyse en machine learning. Elk cluster heeft een unieke id met de naam cluster-id. Dit geldt zowel voor alle doeleinden als voor taakclusters. Voor het ophalen van de details van een cluster met behulp van de REST API is de cluster-id essentieel.

Als u de cluster-id wilt ophalen, klikt u op het tabblad Clusters in de zijbalk en selecteert u een clusternaam. De cluster-id is het nummer na het /clusters/ onderdeel in de URL van deze pagina

https://<databricks-instance>/#/setting/clusters/<cluster-id>

In de volgende schermopname is 0831-211914-clean632de cluster-id.

Cluster URL

Notebook-URL en -id

Een notebook is een webinterface voor een document dat uitvoerbare code, visualisaties en verhaaltekst bevat. Notebooks zijn één interface voor interactie met Azure Databricks. Elk notitieblok heeft een unieke id. De URL van het notitieblok heeft de notebook-id, waardoor de URL van het notitieblok uniek is voor een notitieblok. Het kan worden gedeeld met iedereen op het Azure Databricks-platform met toestemming om het notebook weer te geven en te bewerken. Daarnaast heeft elke notebookopdracht (cel) een andere URL.

Als u een URL of id van een notitieblok wilt zoeken, opent u een notitieblok. Als u een cel-URL wilt zoeken, klikt u op de inhoud van de opdracht.

  • Voorbeeld van notebook-URL:

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

  • Voorbeeld van notebook-id: 1940481404050342.

  • Voorbeeldopdracht-URL (cel):

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

Map-id

Een map is een map die wordt gebruikt voor het opslaan van bestanden die kunnen worden gebruikt in de Azure Databricks-werkruimte. Deze bestanden kunnen notebooks, bibliotheken of submappen zijn. Er is een specifieke id gekoppeld aan elke map en elke afzonderlijke submap. De Machtigingen-API verwijst naar deze id als een directory_id en wordt gebruikt bij het instellen en bijwerken van machtigingen voor een map.

Gebruik de Werkruimte-API om de directory_id op te halen:

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

Dit is een voorbeeld van het antwoord van de API-aanroep:

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

Model-id

Een model verwijst naar een geregistreerd MLflow-model, waarmee u MLflow-modellen in productie kunt beheren via faseovergangen en versiebeheer. De geregistreerde model-id is vereist voor het programmatisch wijzigen van de machtigingen voor het model via de Machtigingen-API.

Als u de id van een geregistreerd model wilt ophalen, kunt u het eindpunt van de werkruimte-APImlflow/databricks/registered-models/getgebruiken. De volgende code retourneert bijvoorbeeld het geregistreerde modelobject met de eigenschappen, inclusief de 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

De geretourneerde waarde heeft de notatie:

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

Taak-URL en ID

Een taak is een manier om een notebook of JAR direct of op geplande basis uit te voeren.

Als u een taak-URL wilt ophalen, klikt u op Jobs IconWerkstromen in de zijbalk en klikt u op een taaknaam. De taak-id is na de tekst #job/ in de URL. De taak-URL is vereist om de hoofdoorzaak van mislukte taakuitvoeringen op te lossen.

In de volgende schermopname is de taak-URL:

https://westus.azuredatabricks.net/?o=6280049833385130#job/1

In dit voorbeeld is 1de taak-id .

Job URL