Çalışma alanı nesneleri için tanımlayıcıları alma

Bu makalede Azure Databricks'te çalışma alanı, klasik işlem, pano, dizin, model, not defteri ve iş tanımlayıcılarını ve URL'leri alma işlemi açıklanmaktadır.

Çalışma alanı örneği adları, URL'ler ve kimlikler

Her Azure Databricks dağıtımına çalışma alanı başına URL olarak da bilinen benzersiz örnek adı atanır. Azure Databricks dağıtımınızda oturum açmak ve API isteklerinde bulunmak için kullanılan tam etki alanı adıdır.

Azure Databricks çalışma alanı , Azure Databricks platformunun çalıştığı ve Spark kümeleri oluşturabileceğiniz ve iş yüklerini zamanlayabileceğiniz yerdir. Çalışma alanının benzersiz bir sayısal çalışma alanı kimliği vardır.

Çalışma alanı başına URL

Çalışma alanı başına benzersiz URL biçimindedir adb-<workspace-id>.<random-number>.azuredatabricks.net. Çalışma alanı kimliği , "nokta" (.) öğesinin hemen ardından adb- ve öncesinde görünür. Çalışma alanı başına URL https://adb-5555555555555555.19.azuredatabricks.net/için:

  • Çalışma alanı URL'sihttps://adb-5555555555555555.19.azuredatabricks.net/
  • Örnek adı şeklindediradb-5555555555555555.19.azuredatabricks.net.
  • Çalışma alanı kimliği şeklindedir5555555555555555.

Çalışma alanı başına URL'yi belirleme

Çalışma alanınızın çalışma alanı başına URL'sini belirleyebilirsiniz:

  • Oturum açtığınızda tarayıcınızda:

    Çalışma alanı

  • Azure portalında, kaynağı seçip URL alanındaki değere dikkat ederek:

    Çalışma Alanı URL'si

  • Azure API'sini kullanma. Bkz . Azure API'sini kullanarak çalışma alanı başına URL alma.

Eski bölgesel URL

Önemli

Eski bölgesel URL'lerden kaçının. Onlar:

  • Yeni çalışma alanlarıyla çalışmayabilir.
  • Çalışma alanı başına URL'lerden daha az güvenilir ve yavaştır.
  • Çalışma alanı kimlikleri gerektiren özellikleri bozabilir.

Eski bölgesel URL, Azure Databricks çalışma alanının dağıtıldığı bölgeden ve örneğin azuredatabricks.netetki alanından https://westus.azuredatabricks.net/oluşur.

  • gibi https://westus.azuredatabricks.net/eski bir bölgesel URL'de oturum açarsanız örnek adı olur westus.azuredatabricks.net.
  • Çalışma alanı kimliği URL'de yalnızca eski bir bölgesel URL kullanarak oturum açtıktan sonra görünür. öğesinin o=ardından görünür. URL'sinde https://<databricks-instance>/?o=6280049833385130çalışma alanı kimliği şeklindedir 6280049833385130.

İşlem kaynağı URL'si ve kimliği

Azure Databricks işlem kaynakları , üretim ETL işlem hatlarını çalıştırma, akış analizi, geçici analiz ve makine öğrenmesi gibi çeşitli kullanım örnekleri için birleşik bir platform sağlar. Her klasik işlem kaynağının küme kimliği adlı benzersiz bir kimliği vardır. Bu, hem çok amaçlı hem de iş kümeleri için geçerlidir, ancak sunucusuz işlem için geçerli değildir. REST API kullanarak bir kümenin ayrıntılarını almak için küme kimliğine ihtiyacınız vardır.

Küme kimliğini almak için kenar çubuğunda işlem simgesiİşlem'e tıklayın ve bir küme adı seçin. Küme kimliği, bu sayfanın URL'sindeki bileşenden sonraki /clusters/ sayıdır.

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

Aşağıdaki ekran görüntüsünde küme kimliği şeklindedir 0130-201722-abcdefgh.

Küme URL'si

Pano URL'si ve kimliği

Yapay zeka/BI panosu , veri görselleştirmeleri ve yorumlardan oluşan bir sunudur. Her panonun benzersiz bir kimliği vardır. Önceden ayarlanmış filtre ve parametre değerleri içeren doğrudan bağlantılar oluşturmak veya REST API'yi kullanarak panoya erişmek için bu kimliği kullanabilirsiniz.

  • Örnek pano URL'si:

    https://adb-62800498333851.30.azuredatabricks.net/sql/dashboardsv3/01ef9214fcc7112984a50575bf2b460f
  • Örnek pano kimliği: 01ef9214fcc7112984a50575bf2b460f

Not Defteri URL'si ve Kimliği

Not defteri, çalıştırılabilir kod, görselleştirmeler ve anlatı metni içeren bir belgenin web tabanlı arabirimidir. Not defterleri, Azure Databricks ile etkileşime yönelik bir arabirimdir. Her not defterinin benzersiz bir kimliği vardır. Not defteri URL'si not defteri kimliğine sahiptir, bu nedenle not defteri URL'si bir not defteri için benzersizdir. Not defterini görüntüleme ve düzenleme izni olan Azure Databricks platformundaki herkesle paylaşılabilir. Ayrıca, her not defteri komutunun (hücre) farklı bir URL'si vardır.

Not defteri URL'sini veya kimliğini bulmak için bir not defteri açın. Hücre URL'sini bulmak için komutun içeriğine tıklayın.

  • Örnek not defteri URL'si:

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

  • Örnek not defteri kimliği: 1940481404050342.

  • Örnek komut (hücre) URL'si:

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

Klasör Kimliği

Klasör, Azure Databricks çalışma alanında kullanılabilecek dosyaları depolamak için kullanılan bir dizindir. Bu dosyalar not defterleri, kitaplıklar veya alt klasörler olabilir. Her klasör ve her bir alt klasörle ilişkili belirli bir kimlik vardır. İzinler API'si bu kimliği bir directory_id olarak ifade eder ve bir klasörün izinlerini ayarlamak ve güncelleştirmek için kullanılır.

directory_id almak için Çalışma Alanı API'sini kullanın:

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

Bu, API çağrısı yanıtının bir örneğidir:

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

Model Kimliği

Model, üretimdeki MLflow Modellerini aşama geçişleri ve sürüm oluşturma aracılığıyla yönetmenizi sağlayan MLflow kayıtlı modeli anlamına gelir. İzinler API'si aracılığıyla program aracılığıyla model üzerindeki izinleri değiştirmek için kayıtlı model kimliği gereklidir.

Kayıtlı modelin kimliğini almak için Çalışma Alanı API'si uç noktasını mlflow/databricks/registered-models/getkullanabilirsiniz. Örneğin, aşağıdaki kod, kimliği de dahil olmak üzere özellikleriyle birlikte kayıtlı model nesnesini döndürür:

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

Döndürülen değer şu biçimdedir:

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

İş URL'si ve kimliği

İş, bir not defterini veya JAR'ı hemen veya zamanlanmış olarak çalıştırmanın bir yoludur.

İş URL'sini almak için kenar çubuğunda İşler Simgesiİşler ve İşlem Hatları'na tıklayın ve bir iş adına tıklayın. İş kimliği URL'nin sonunda görünür /jobs/ . bir işe ve çalıştırma geçmişine gitmek için iş URL'sini kullanın. Örneğin destek biletinde paylaşmak üzere belirli bir çalıştırmaya doğrudan bağlantı vermek için bunun yerine çalıştırma URL'sini kullanın. Bkz . İş çalıştırma URL'si ve kimliği.

Aşağıdaki ekran görüntüsünde iş URL'si şöyledir:

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

Bu örnekte, iş kimliği şeklindedir 5.

İş URL'si

İş çalıştırma URL'si ve kimliği

Tek bir işin birçok çalıştırması olabilir. Her çalıştırmanın, iş kimliğinden ve iş URL'sinden ayrı olan kendi benzersiz çalıştırma kimliği ve kendi URL'si vardır. Örneğin destek biletinde belirli bir çalıştırmanın bağlantısını paylaştığınızda, alıcının doğru çalıştırmayı açması için iş URL'si yerine çalıştırma URL'sini kullanın.

Çalıştırma URL'si şu biçimdedir:

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

Çalışma alanı kullanıcı arabiriminde çalıştırma kimliğini veya URL'sini bulmak için:

  • bir işin Çalıştırmalar sekmesinde Başlangıç zamanı sütunundaki bağlantıya tıklayarak İş çalıştırma ayrıntıları sayfasını açın. Çalıştırma kimliği tarayıcı adres çubuğunda öğesinin ardından /runs/görünür. Çalıştırmayı paylaşmak için adresi kopyalayın.
  • İş çalıştırma ayrıntıları sayfasında, adres çubuğundaki URL formda /jobs/<job-id>/runs/<run-id>hem iş kimliğini hem de çalıştırma kimliğini içerir.

Çalıştırma kimliğini veya URL'yi program aracılığıyla almak için:

  • İşler API'si: Tek bir iş çalıştırması alma uç noktasını çağırın. Yanıt, çalıştırmaya yönelik doğrudan kullanıcı arabirimi bağlantısı olan ve run_page_urlöğesini içerirrun_id.
  • Sistem tabloları: Tablo system.lakeflow.job_run_timeline hem hem de job_idrun_id sütunları içerir. Bkz. İşler sistem tablosu referansı.

Note

Başka bir iş tarafından tetiklenen çalıştırmalar (örneğin , İşi Çalıştır görev türünü kullanan bir görev) için, parent_run_id alan üst çalıştırmayı tanımlar. Bkz. Bir işe bildirim ekleme.

  • Last updated on