Id's ophalen voor werkruimteobjecten

In dit artikel wordt uitgelegd hoe u werkruimte, klassieke berekening, dashboard, directory, model, notebook en taak-id's en taak-id'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 URL van de werkruimte is https://adb-5555555555555555.19.azuredatabricks.net/
• De naam van de instantie is .
• De werkruimte-id is 5555555555555555.

URL per werkruimte bepalen

U kunt de URL per werkruimte voor uw werkruimte bepalen:

• In uw browser wanneer u bent aangemeld:

  

• Selecteer in Azure Portal de resource en noteer de waarde in het URL-veld :

  

• De Azure-API gebruiken. Zie Een URL per werkruimte ophalen met behulp van de Azure API.

Verouderde regionale URL

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.

RESOURCE-URL en -id berekenen

Azure Databricks-rekenresources bieden een geïntegreerd platform voor verschillende gebruiksvoorbeelden, zoals het uitvoeren van ETL-pijplijnen voor productie, streaming-analyses, ad-hocanalyses en machine learning. Elke klassieke rekenresource heeft een unieke id met de naam cluster-id. Dit geldt zowel voor alle doeleinden als voor taakclusters, maar niet voor serverloze berekeningen. U hebt de cluster-id nodig om de details van een cluster op te halen met behulp van de REST API.

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

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

In de volgende schermopname is 0130-201722-abcdefghde cluster-id.

Dashboard-URL en -id

Een AI/BI-dashboard is een presentatie van gegevensvisualisaties en commentaar. Elk dashboard heeft een unieke id. U kunt deze id gebruiken om directe koppelingen te maken die vooraf ingestelde filter- en parameterwaarden bevatten, of om toegang te krijgen tot het dashboard met behulp van de REST API.

• Voorbeeld van dashboard-URL:

  https://adb-62800498333851.30.azuredatabricks.net/sql/dashboardsv3/01ef9214fcc7112984a50575bf2b460f
  

• Voorbeeld van dashboard-id: 01ef9214fcc7112984a50575bf2b460f

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 de Werkruimte-API eindpunt gebruiken mlflow/databricks/registered-models/get. 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 taken en pijplijnen op de zijbalk en klikt u op een taaknaam. De taak-id wordt weergegeven na /jobs/ in de URL. Gebruik de taak-URL om naar een taak en de uitvoeringsgeschiedenis te navigeren. Als u rechtstreeks een koppeling wilt maken naar een specifieke uitvoering, bijvoorbeeld om te delen in een ondersteuningsticket, gebruikt u in plaats daarvan de uitvoerings-URL. Zie taakuitvoerings-URL en -id.

In de volgende schermopname is de taak-URL:

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

In dit voorbeeld is 5de taak-id .

URL en id voor taakuitvoering

Eén taak kan veel uitvoeringen hebben. Elke uitvoering heeft een eigen unieke uitvoerings-id en een eigen URL, die verschillen van de taak-id en taak-URL. Wanneer u een koppeling naar een specifieke uitvoering deelt, bijvoorbeeld in een ondersteuningsticket, gebruikt u de uitvoerings-URL in plaats van de taak-URL, zodat de geadresseerde de juiste uitvoering opent.

De uitvoerings-URL heeft de volgende indeling:

https://<databricks-instance>/jobs/<job-id>/runs/<run-id>

De uitvoerings-id of URL zoeken in de gebruikersinterface van de werkruimte:

• Klik op het tabblad Uitvoeringen voor een taak op de koppeling in de kolom Begintijd om de pagina Met taakuitvoeringsgegevens te openen. De uitvoerings-id wordt weergegeven in de adresbalk van de browser na /runs/. Kopieer het adres om de uitvoering te delen.
• Op de pagina Met taakuitvoeringsgegevens bevat de URL in de adresbalk zowel de taak-id als de uitvoerings-id in het formulier /jobs/<job-id>/runs/<run-id>.

De run-id of URL programmatisch ophalen:

• Taken-API: roep het eindpunt voor het ophalen van één taakuitvoering aan. Het antwoord bevat run_id en run_page_url, dit is de directe gebruikersinterfacekoppeling naar de uitvoering.
• Systeemtabellen: de system.lakeflow.job_run_timeline tabel bevat zowel als job_idrun_id kolommen. Zie Jobs-systeemtabelreferentie.