Varsayılan paket depolarını yapılandırma

Önemli

Varsayılan Python paket depolarını yapılandırma, sunucusuz not defterleri ve işler için genel olarak kullanılabilir. Lakeflow işlem hatları ve kullanıcı arabirimi ve API aracılığıyla oluşturulan klasik işlem için Genel Önizleme aşamasındadır. Databricks Uygulamaları için beta sürümündedir. Çalışma alanı yöneticileri, aşağıdaki önizlemeleri etkinleştirerek Önizlemeler sayfasından bu özelliklere erişimi denetleyebilir:

• Spark Bildirimli İşlem Hatlarında varsayılan Python paket depoları (Genel Önizleme)
• API aracılığıyla oluşturulan kümelerdeki varsayılan Python paket depoları (Genel Önizleme)
• Kullanıcı arabirimi (Genel Önizleme) aracılığıyla oluşturulan kümelerdeki varsayılan Python paket depoları
• Databricks Uygulamaları için Çalışma Alanı Deposu Yapılandırmasını Etkinleştirme (Beta)

Çalışma alanı yöneticileri, çalışma alanları içindeki özel veya kimliği doğrulanmış paket depolarını not defterleri, işler, Lakeflow işlem hatları ve Databricks Uygulamaları için varsayılan paket depoları olarak yapılandırabilir. Python depoları bu iş yüklerinin tümü için geçerlidir, ancak npm kayıt defterleri yalnızca Databricks Uygulamaları için geçerlidir.

Bir çalışma alanı varsayılan bir paket deposuyla yapılandırılmışsa, çalışma alanındaki kullanıcılar Python için index-url veya extra-index-url değerlerini ya da npm için bir kayıt defterini açıkça tanımlamadan iç depolardan paket yükleyebilir. Bu değerler kodda, not defterinde veya uygulamanın app.yaml dosyasında belirtilirse, çalışma alanı varsayılanlarından önceliklidir. Databricks Uygulamaları için önceliğin nasıl çalıştığı için bkz. Çalışma alanı düzeyinde varsayılan paket depolarını kullanma .

Bu yapılandırma, depo URL'lerini ve kimlik bilgilerini güvenli bir şekilde depolamak ve yönetmek için Databricks gizli dizilerinden yararlanır. Çalışma alanı yöneticileri, çalışma alanı yönetici ayarları sayfasını veya önceden tanımlanmış gizli dizi kapsamını ve Databricks CLI gizli dizi komutlarını veya REST API'yi kullanarak kurulumu yapılandırabilir.

Çalışma alanı için varsayılan bağımlılıkları ayarlama

Çalışma alanı yöneticileri, çalışma alanı yönetici ayarları sayfasını kullanarak varsayılan paket depolarını ekleyebilir veya kaldırabilir.

1. Çalışma alanı yöneticisi olarak Databricks çalışma alanında oturum açın.
2. Databricks çalışma alanının üst çubuğunda kullanıcı adınızı tıklayın ve Ayarlarseçeneğini seçin.
3. Hesaplama sekmesine tıklayın.
4. "Varsayılan Paket Depoları yanındaki Yönetöğesine tıklayın."
5. (İsteğe bağlı) Python dizin URL'si, ek dizin URL'leri, özel SSL sertifikası veya npm kayıt defteri yapılandırması ekleyin veya kaldırın.
6. Değişiklikleri kaydetmek için Kaydet’e tıklayın.

Not

Gizli bilgilerde yapılan değişiklikler veya silme işlemleri, iş yükü türüne bağlı olarak farklı şekilde uygulanır. Sunucusuz not defterleri ve işler için, işlem kaynağı not defterine yeniden bağlandıktan veya iş yeniden çalıştırıldıktan sonra değişiklikler uygulanır. Klasik not defterleri ve işler için, işlem kaynağı yeniden başlatıldıktan sonra değişiklikler uygulanır. Lakeflow işlem hatları için değişiklikler yeni işlem hattı çalıştırmalarına uygulanır. Databricks Uygulamalarında değişiklikler, uygulama bir sonraki kez derlenip dağıtıldığında uygulanır.

Secrets CLI veya REST API kullanarak kurulum yapın

CLI veya REST API kullanarak varsayılan paket depolarını yapılandırmak için önceden tanımlanmış bir gizli dizi kapsamı oluşturun ve erişim izinlerini yapılandırın, ardından paket deposu gizli dizilerini ekleyin.

Önceden tanımlanmış gizli kapsam adı

Çalışma alanı yöneticileri varsayılan pip dizini URL'leri, ek dizin URL'leri, ssl sertifikası ve npm yapılandırmasının yanı sıra kimlik doğrulama belirteçleri ve gizli dizileri önceden tanımlanmış anahtarlar altında belirlenmiş bir gizli dizi kapsamında ayarlayabilir:

• Gizli kapsam adı: databricks-package-management
• Dizin url'si için gizli anahtar: pip-index-url
• Ek dizin url'leri için gizli anahtar: pip-extra-index-urls
• SSL sertifika içeriği için gizli anahtar: pip-cert
• npm yapılandırması için gizli anahtar: npm-rc (Yalnızca Databricks Uygulamaları)

Gizli kapsamı oluştur

Gizli dizi kapsamı, Databricks CLI gizli dizi komutları veya REST APIkullanılarak oluşturulabilir. Gizli alanı oluşturduktan sonra, çalışma alanındaki tüm kullanıcılara okuma erişimi vermek için erişim denetimi listelerini yapılandırın. Bu, deponun güvenli kalmasını ve tek tek kullanıcılar tarafından değiştirilememesini sağlar. Gizli kapsam, önceden tanımlanmış gizli kapsam adı databricks-package-management'u kullanmalıdır.

databricks secrets create-scope databricks-package-management
databricks secrets put-acl databricks-package-management admins MANAGE
databricks secrets put-acl databricks-package-management users READ

Paket deposu gizli anahtarları ekleme

Önceden tanımlanmış gizli anahtar adlarını kullanarak paket deposu ayrıntılarını ekleyin. Python depoları not defterleri, işler, Lakeflow işlem hatları ve Databricks Uygulamaları için geçerlidir, ancak npm kayıt defterleri yalnızca Databricks Uygulamaları için geçerlidir.

Python

Üç alanın da isteğe bağlı olduğu önceden tanımlanmış gizli anahtar adlarını kullanarak Python paketi deposu ayrıntılarını ekleyin.

# Add index URL.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-index-url", "string_value":"<index-url-value>"}'

# Add extra index URLs. If you have multiple extra index URLs, separate them using white space.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-extra-index-urls", "string_value":"<extra-index-url-1 extra-index-url-2>"}'

# Add cert content. If you want to pip configure a custom SSL certificate, put the cert file content here.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-cert", "string_value":"<cert-content>"}'

Not

Deponuz kimlik doğrulaması gerektiriyorsa dizin URL'si için aşağıdaki biçimlerden birini kullanın:

• Kullanıcı adı ve parola: https://<username>:<password>@<index_url>
• Token: https://<token>@<index_url>

Node.js

Databricks Uygulamaları için, uygulamaların çalışma alanı tarafından yapılandırılan kayıt defterinden özel paketler de dahil olmak üzere Node.js paketleri yüklemesi için varsayılan bir npm kayıt defteri de yapılandırabilirsiniz. Kayıt defteri URL'si ve herhangi bir kimlik doğrulama belirteci dahil olmak üzere tam .npmrc dosya içeriğini gizli anahtar altında depolayın npm-rc :

databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "npm-rc", "string_value":"registry=https://npm.example.com/\n//npm.example.com/:_authToken=<token>\n"}'

Çalışma alanındaki bir uygulama oluşturulduğunda Azure Databricks bu içeriği uygulamanın .npmrc dosyasına yazar. Önceliğin nasıl çalıştığı ve belirli bir uygulama için nasıl geçersiz kılındığını öğrenmek için bkz. Node.js paketleri.

Paket deposu gizli anahtarlarını değiştirin veya silin

Paket deposu gizli dizilerini değiştirmek için komutunu kullanın put-secret . Paket deposu gizli anahtarlarını silmek için, aşağıda gösterildiği gibi delete-secret kullanın:

# delete secret
databricks secrets delete-secret databricks-package-management pip-index-url

databricks secrets delete-secret databricks-package-management pip-extra-index-urls

databricks secrets delete-secret databricks-package-management pip-cert

# delete the npm configuration secret (Databricks Apps only)
databricks secrets delete-secret databricks-package-management npm-rc

# delete scope
databricks secrets delete-scope databricks-package-management