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

Makale
10/31/2024

Bu makalede Azure Databricks'te çalışma alanı, küme, pano, dizin, model, not defteri ve iş tanımlayıcıları ile URL'leri alma işlemi açıklanı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:

Örnek adı şeklindedir adb-5555555555555555.19.azuredatabricks.net.
Çalışma alanı kimliği şeklindedir 5555555555555555.

Ç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:
Azure portalında, kaynağı seçip URL alanındaki değere dikkat ederek:
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'leri kullanmaktan kaçının. Yeni çalışma alanları için çalışmayabilir, daha az güvenilirdir ve çalışma alanı başına URL'lere göre daha düşük performans sergiler.

Eski bölgesel URL, Azure Databricks çalışma alanının dağıtıldığı bölgeden ve örneğin https://westus.azuredatabricks.net/etki alanından azuredatabricks.netoluş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.

Küme URL'si ve Kimliği

Azure Databricks kümesi , ü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 kümenin, 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. REST API kullanarak bir kümenin ayrıntılarını almak için küme kimliği gereklidir.

Küme kimliğini almak için kenar çubuğundaki Kümeler sekmesine 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>/#/setting/clusters/<cluster-id>

Aşağıdaki ekran görüntüsünde küme kimliği şeklindedir 0831-211914-clean632.

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'si almak için kenar çubuğunda İş Akışları'na tıklayın ve bir iş adına tıklayın. İş kimliği URL'deki metnin #job/ ardındandır. Başarısız iş çalıştırmalarının kök nedenini gidermek için iş URL'si gereklidir.

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

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

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

İş URL'si

Aracılığıyla paylaş