Ayarlar API anahtarları referansı

Bu sayfa, genel Azure Databricks Settings API'si üzerinden erişilebilir olan ayarları kapsama göre gruplanmış olarak listeler. Her ayar, kararlı bir ayar adı (anahtar) ile tanımlanır. Bu ayarların nasıl keşfedileceği, okunacağı ve güncelleneceği için Ayarlar API'si üzerinden Ayarları Yönet'e bakınız.

Özellik önizlemeleri de Settings API üzerinden yönetilir ancak burada listelenmezler, çünkü geçici ve sonunda ömrünün sonuna ulaşırlar. Şu anda size sunulan ayarlar-metadata uç noktası üzerinden sunulan önizlemeleri keşfedin.

Kullanılabilir ayarlar

Aşağıdaki ayarlar, kapsama göre gruplanmış olarak kamuya açık Ayarlar API'si üzerinden erişilebilirdir. Bu liste periyodik olarak oluşturulur; Otoriter ve her zaman güncel olan ayar seti ve dokümantasyon bağlantıları için, her ayarın , name, description, ve type'ni döndüren docs_link çağırın.

Hesap ayarları

Hesap genelinde geçerli olan ayarlar.

Setting Anahtar adı Açıklama
Eski özellikleri devre dışı bırak disable_legacy_features Yeni Databricks çalışma alanları için eski özellikleri devre dışı bırakın. Yeni oluşturulan çalışma alanları için: 1. DBFS kök ve montaj kullanımını devre dışı bırakır. 2. Hive Metastore sunulmayacak. 3. 'İzolasyon Yok kümeleri' kullanımını devre dışı bırakır. 4. 13.3LTS'den önceki Databricks Çalışma Zamanı sürümlerini devre dışı bırakır.
Birlik Geçidi'ni Zorla Uygula enforce_ai_gateway_v3_only Tüm temel model erişimlerinin Unity Gateway üzerinden mı geçtiğini kontrol eder. Etkinleştirildiğinde, model erişim izinleri, yapay zeka bütçeleri ve güvenlik politikaları Unity Gateway ile merkezi olarak yönetilir ve tüm temel model trafiğinin bu sistemden geçmesi gerekir. Unity Gateway'i atlayan uç noktalara hizmet veren eski temel modeli, trafik reddediyor.
İş ortağı destekli yapay zeka özellikleri llm_proxy_partner_powered Partner powered modellerin etkin olup olmadığını belirler. Bu ayar hem hesap hem de çalışma alanı seviyesinde mevcuttur
Ortak destekli yapay zeka özelliklerini zorunlu kılın llm_proxy_partner_powered_enforce Partner tarafından güçlendirilmiş zorunluluk ayarının açık olup olmadığını belirler. Etkinleştirildiğinde, hesap düzeyinde ortak destekli değer, herhangi bir çalışma alanı seviyesindeki geçersiz kalanı geçersiz kılanmayı geçersiz kılar.
Restrict Workspace Admins restrict_workspace_admins Çalışma Alanı Yöneticilerini Kısıtla ayarı, çalışma alanı yöneticilerinin özelliklerini denetlemenize olanak tanır. Ayar durumu ALLOW_ALL olarak ayarlandığında, workspace yöneticileri çalışma alanlarındaki herhangi bir hizmet yöneticisi adına hizmet yöneticisi kişisel erişim tokenları oluşturabilir. Çalışma alanı yöneticileri, bir iş sahibini çalışma alanlarındaki herhangi bir kullanıcı olarak da değiştirebilir. Ve iş run_as ayarını çalışma alanlarındaki herhangi bir kullanıcıya veya Hizmet Ana Kullanıcı rolünü üstlendikleri bir hizmet yöneticisine değiştirebilirler. Ayar durumu RESTRICT_TOKENS_AND_JOB_RUN_AS olarak ayarlandığında, çalışma alanı yöneticileri yalnızca Hizmet Başlıca Kullanıcı rolünü kullandıkları hizmet yöneticileri adına kişisel erişim tokenları oluşturabilirler. Ayrıca yalnızca iş sahibini kendi kendilerine değiştirebilirler. Ve iş run_as ayarını kendilerine veya Hizmet Ana Kullanıcısı rolünü üstledikleri bir hizmet yöneticisine değiştirebilirler.

Çalışma alanı ayarları

Tek bir çalışma alanı için geçerli olan ayarlar.

Setting Anahtar adı Açıklama
AI/BI Dashboard Gömüleme Erişim Politikası aibi_dash_embed_ws_acc_policy AI/BI yayımlanmış dashboard gömülmesinin çalışma alanı seviyesinde etkin, koşullu olarak etkinleştirilmiş veya devre dışı bırakıldığını kontrol eder. Varsayılan olarak, bu ayar koşullu olarak etkinleştirilir (ALLOW_APPROVED_DOMAINS).
AI/BI Dashboard Onaylı Alan Alanlarının Gömülülüşü aibi_dash_embed_ws_apprvd_domains Gömülü AI/BI panellerini barındırmak için onaylanan alan alanlarının listesini kontrol eder. Onaylanan alan adları listesi, mevcut erişim politikası ALLOW_APPROVED_DOMAINS olarak ayarlanmadığında mutasyona uğratılamaz.
Uygulamalar için OAuth kapsamlarını seçilmiş değerlerle sınırlayın allowedAppsUserApiScopes Kullanıcılar adına hareket ederken uygulama geliştiricilerinin talep edebileceği OAuth kapsamlarını kısıtlayın. İzin verilen kapsamların listesini belirtin veya desteklenen tüm dürbünlere izin vermek için "*" kullanın. Boş bir liste, uygulamalar için kullanıcı yetkilendirmesini fiilen devre dışı bırakır.
Otomatik küme güncelleştirmesi automatic_cluster_update Otomatik küme güncelleştirmesi, bir çalışma alanı içindeki tüm kümelerin düzenli aralıklarla en son ana bilgisayar işletim sistemi görüntüsüne ve güvenlik güncelleştirmelerine güncelleştirilmesini sağlar. Hesap yöneticileri bakım penceresi sıklığını, başlangıç tarihini ve başlangıç saatini zamanlayabilir. Klasik hesaplama için geçerlidir (kümeler, havuzlar, klasik SQL depoları, eski Model Serving); sunucusuz hesaplama için geçerli değildir. Bu özelliğin etkinleştirilmesi Gelişmiş Güvenlik ve Uyum eklentisini ekliyor ve Premium fiyatlandırma katmanını gerektiriyor.
İzin verilen iş birliği platformları collaboration_platform_connectivity Bu çalışma alanına hangi harici iş birliği platformlarının (Slack ve/veya Microsoft Teams) bağlanabileceğini kontrol eder. Varsayılan olarak ALLOW_ALL.
İş birliği platformlarında halka açık mesajlara izin verin collaboration_platform_message_visibility Etkinleştirildiğinde, kullanıcılar Slack'teki Databricks uygulamasından veya Microsoft Teams'ten gelen yanıtların kanalda görülebilir olup olmadığını seçebilirler. Devre dışı bırakıldığında, tüm yanıtlar talep eden kullanıcıya özel olarak kalmak zorundadır.
Databricks personeli için çalışma alanı erişimi customerApprovedWSLoginExpirationTime Databricks personelinin artık çalışma alanınıza giriş yapamayacağı belirli bir zaman. Zaman olarak biçimlendirilmiştir YYYY-MM-DDTHH:MM:SSZ. Geçmişte bir zaman damgası ayarlayarak erişimi tamamen devre dışı bırakabilirsiniz, örneğin 1998-01-01T00:00:00.000Z. Boş bir dizi veya özel değer indefinitekullanarak süresiz erişimi etkinleştirin.
Varsayılan İsim Alanı default_namespace_ws Varsayılan isim alanı ayarı API, kullanıcıların bir Databricks çalışma alanı için varsayılan isim alanını yapılandırmasına olanak tanır.
Eski erişimi devre dışı bırak disable_legacy_access 'Miras erişimini devre dışı bırakmak' aşağıdaki etkileri taşır: 1. Çalışma alanından Hive Metastore'a doğrudan erişimi devre dışı bırakır (Hive Metastore federasyonu üzerinden erişim etkilenmez). 2. Çalışma alanından dış konum erişiminde geri dönüş modunu devre dışı bırakır. 3. 13.3LTS'den önceki Databricks Çalışma Zamanı sürümlerini devre dışı bırakır. Önemli: bu ayar, çalışma alanı varsayılan kataloğu eski katalog (hive_metastore veya spark_catalog) olarak ayarlandığında etkinleştirilemez. Varsayılan kataloğu önce Unity Kataloğu kataloğuna değiştirin.
DBFS kökünü ve bağlamalarını devre dışı bırakma disable_legacy_dbfs Eski DBFS'nin devre dışı bırakılması aşağıdaki iki sonucu getirir: 1. DBFS kök ve DBFS montajlarına erişim yasaktır (ayrıca yeni montajların oluşturulması da yasaklanır). 2. 13.3LTS'den önceki Databricks Çalışma Zamanı sürümlerini devre dışı bırakır. Ayar kapalı olduğunda, tüm DBFS işlevleri etkinleştirilir ve Databricks Çalışma Zamanı sürümlerine herhangi bir kısıtlama uygulanmaz. Bu ayarın etkisi 20 dakikaya kadar sürebilir ve her amaçlı hesaplama kümeleri ile SQL depolarının manuel yeniden başlatılmasını gerektirir.
Otomatik esnek düğüm türlerini etkinleştir enableAutoNodeTypeFlexibility Etkinleştirildiğinde, bu çalışma alanındaki kümeler, istenen düğüm tipi mevcut olmadığında alternatif düğüm tiplerinde otomatik olarak başlatılabilir ve kapasite kıtlığı sırasında başlatma güvenilirliğini artırır.
Birlik Geçidi'ni Zorla Uygula enforce_ai_gateway_v3_only Tüm temel model erişimlerinin Unity Gateway üzerinden mı geçtiğini kontrol eder. Etkinleştirildiğinde, model erişim izinleri, yapay zeka bütçeleri ve güvenlik politikaları Unity Gateway ile merkezi olarak yönetilir ve tüm temel model trafiğinin bu sistemden geçmesi gerekir. Unity Gateway'i atlayan uç noktalara hizmet veren eski temel modeli, trafik reddediyor.
Sadece Git'ten uygulama dağıtımlarına izin verin enforceGitAppDeployments Etkinleştirildiğinde, bu çalışma alanındaki uygulamalar yalnızca Git'ten dağıtılabilir.
İş ortağı destekli yapay zeka özellikleri llm_proxy_partner_powered Partner powered modellerin etkin olup olmadığını belirler. Bu ayar hem hesap hem de çalışma alanı seviyesinde mevcuttur
Kritik Görev mission_critical Kritik iş yükleri için en yüksek operasyonel dayanıklılık ve güvenlik seviyelerini sunar. Felaket kurtarma ve geliştirilmiş güvenlik ile uyum içerir.
Depoların IPYNB çıktısını dışa aktarmasına izin ver reposIpynbResultsExportPermissions Kullanıcıların .ipynb notebook çıktılarını çalışma alanındaki uzak Git depolarına commit edip edemeyeceğini kontrol eder.
Restrict Workspace Admins restrict_workspace_admins Çalışma Alanı Yöneticilerini Kısıtla ayarı, çalışma alanı yöneticilerinin özelliklerini denetlemenize olanak tanır. Ayar durumu ALLOW_ALL olarak ayarlandığında, workspace yöneticileri çalışma alanlarındaki herhangi bir hizmet yöneticisi adına hizmet yöneticisi kişisel erişim tokenları oluşturabilir. Çalışma alanı yöneticileri, bir iş sahibini çalışma alanlarındaki herhangi bir kullanıcı olarak da değiştirebilir. Ve iş run_as ayarını çalışma alanlarındaki herhangi bir kullanıcıya veya Hizmet Ana Kullanıcı rolünü üstlendikleri bir hizmet yöneticisine değiştirebilirler. Ayar durumu RESTRICT_TOKENS_AND_JOB_RUN_AS olarak ayarlandığında, çalışma alanı yöneticileri yalnızca Hizmet Başlıca Kullanıcı rolünü kullandıkları hizmet yöneticileri adına kişisel erişim tokenları oluşturabilirler. Ayrıca yalnızca iş sahibini kendi kendilerine değiştirebilirler. Ve iş run_as ayarını kendilerine veya Hizmet Ana Kullanıcısı rolünü üstledikleri bir hizmet yöneticisine değiştirebilirler.
Uyum güvenlik profili shield_csp_enablement_ws_db Bu çalışma alanı için uyum güvenlik profilinin etkin olup olmadığını kontrol eder. Uyumluluk güvenlik profili, geçerli uyumluluk standartlarını karşılamayı ve yönetmeyi kolaylaştıran son derece güvenli bir temel (ek izleme, sertleştirilmiş hesaplama görüntüsü, düğümler arası şifreleme için zorunlu örnek türleri ve diğer kontroller) sağlar. Etkinleştirilmesi ayrıca kalıcı olarak geliştirilmiş güvenlik izleme ve çalışma alanında otomatik küme güncellemesi sağlar ve Gelişmiş Güvenlik ve Uyum eklentisini ekler.
Gelişmiş güvenlik izleme shield_esm_enablement_ws_db Bu çalışma alanı için geliştirilmiş güvenlik izlemesinin etkinleştirilip etkinleştirilmediğini kontrol eder. Gelişmiş güvenlik izleme, sertleştirilmiş bir hesaplama görüntüsü ve ek güvenlik izleme ajanları (dosya bütünlüğü izleme, antivirüs ve güvenlik açığı taraması) sağlayarak incelenebilir log satırları oluşturur. Bu sadece klasik hesaplama düzlemi kaynakları için geçerlidir, sunucusuz değil. Çalışma alanında uyumluluk güvenlik profili etkinleştirilmişse, bu ayar kalıcı olarak uygulanır.
Çalışma Alanı Etiketi workspace_label Databricks konsol üst navigasyonunda çalışma alanı adının yanında özel bir etiket ve renk rozeti gösteriliyor. Çalışma alanı yöneticileri, bu ayarı kullanarak çalışma alanlarını ortamlar arasında görsel olarak ayırt edebilir. Değer, bir label alan (metin dizisi) ve bir color alan (biri: coral, lemon, lime, turquoiseindigo, purple, ). pinkiçeren bir nesnedir. Her iki alan da etiket ayarlanmadığında boş dizelerdir.

Kullanıcı tercihleri

Bir hesaptaki kullanıcıya uygulanan ayarlar.

Setting Anahtar adı Açıklama
Düzenleyici etkileşiminde otomatik oturum oluştur autoCreateSessionOnEditorInteraction Editörle etkileşimde bulunduğunda oturumun otomatik olarak oluşturulup oluşturulmadığını kontrol eder.
Otomatik Fırlatma ve Takma autoLaunchAndAttach Dizüstü bilgisayarların otomatik olarak açılıp kümelere bağlanıp bağlanmadığını kontrol eder.
Komut Silme Onayı confirmCommandDelete Bir komutu silmeden önce onay gerekip gerekmediğini kontrol eder.
Taslaklar klasöründe yeni varlıklar oluştur createNewAssetsInDraftsFolder Taslaklar klasöründe yeni varlıkların oluşturulup oluşturulmayacağını kontrol eder.
Databricks Unified SQL Editor Open Pref'te Sorgular Oluştur ve Dönüştür databricks-unified-sql-editor-create-and-convert-queries-on-open-pref Birleşik SQL düzenleyicide sorgu oluşturma ve dönüştürme davranışını kontrol eder.
Varsayılan Python Girinti Birimi defaultPythonIndentUnit Varsayılan Python girinti birimini kontrol eder. İzin verilen değerler: 2, 4, veya '' (varsayılan için boş dize).
Editör Özel Karanlık Tema editorCustomDarkTheme Editör için özel koyu temayı kontrol ediyor. İzin verilen değerler: defaultTheme, Atom-One-Dark, Ayu-Dark, Blackboard, DraculaGitHub-DarkMonokaiOne-Dark-ProWinter-is-Coming-Dark.
Editör Özel Işık Teması editorCustomLightTheme Editör için özel ışık temasını kontrol eder. İzin verilen değerler: defaultTheme, Active4D, Atom-One-Light, Ayu-Light, , GitHub-Light, TomorrowWinter-is-Coming-Light.
Düzenleyici yazı tipi boyutu editorFontSize Düzenleyicide font boyutunu kontrol eder. İzin verilen değerler: 10 ile 30 arasında tam sayı aralığı.
Otomatik Hat Girişi Hızlı Çözümünü Etkinleştir enableAutoInlineQuickFix Hızlı çözümlerin otomatik olarak önerilip önerilmediğini kontrol eder.
Otomatik Inline Hızlı Çözüm Çıkışı Etkinleştir enableAutoInlineQuickFixOptOut Otomatik hat içi hızlı çözümler için opt-out kontrolü.
Otomatik Tetik Teşhisini Etkinleştir enableAutoTriggerDiagnose Teşhisin otomatik tetiklenip tetiklenmediğini kontrol eder.
Otomatik tetik Tetik Tanı Çıkışı Etkinleştir enableAutoTriggerDiagnoseOptOut Otomatik tanı için opt-out kontrolü.
Merkezli Düzeni Etkinleştir enableCenteredLayout Editörün merkezlenmiş bir düzen kullanıp kullanmadığını kontrol eder.
Klasik Kısayolları Etkinleştir enableClassicShortcuts Klavye kısayolları modunu kontrol eder. İzin verilen değerler: default, classic.
Komut Numaralarını Etkinleştir enableCommandNumbers Komut numaralarının defterlerde görüntülenip gösterilmediğini kontrol eder.
Yazdıkça Tamamlamaları Etkinleştirin enableCompletionsAsYouType Yazırken otomatik tamamlama önerilerinin görünüp görünmediğini kontrol eder.
İmleç Blink'i etkinleştir enableCursorBlink Düzenleyicide imlecin yanıp sönmediğini kontrol eder.
Karanlık Modu Etkinleştir enableDarkMode Tema modunu kontrol eder. İzin verilen değerler: light, dark, system.
Girişi Etkinleştir Önerileri Kabul Ediyor enableEnterAcceptsSuggestions Enter tuşuna basılmasına bastığı otomatik tamamlama önerilerini kabul edip etmediğini kontrol eder.
Hover For Editor Etkinleştir enableHoverForEditor Düzenleyicide hover araç ipuçlarının gösterilip gösterilmediğini kontrol eder.
Yazırken Inline Öneriyi Etkinleştirin Opt Out enableInlineSuggestionAsYouTypeOptOut Yazarken hat içi öneriler için çıkış kontrolünü tercih edin.
Hat Numaralarını Etkinleştir enableLineNumbers Editörün satır numaralarının görüntülenip gösterilmediğini kontrol eder.
Hat Numaraları V2'yi Etkinleştir enableLineNumbersV2 Düzenleyicide satır numaralarının gösterilip gösterilmediğini kontrol eder (v2).
Satır Sarmayı Etkinleştir enableLineWrap Metnin düzenleyicide bir sonraki satıra sarılıp geçmediğini kontrol eder.
Monaco Çok İmleci Etkinleştir enableMonacoMultiCursor Çok imleçli modifikatör tuşunu kontrol eder. İzin verilen değerler: alt, ctrlCmd.
Not Defteri Hata Hatalarını Etkinleştir Opt Out enableNotebookDebuggerOptOut Notebook hata ayıklayıcısı için çıkış kontrolü.
Sunucusuz Gözlemlenebilirlik Anahtarını Etkinleştir enableServerlessObservabilityToggle İş alanı önizlemesi etkin olduğunda İşler'de Geliştirilmiş Sunucusuz Gözlemlenebilirlik için kullanıcı seçimi.
Yeni Hücre Arayüzünde Komut İstatistiklerini Göster İstatistiklerini Etkinleştir enableShowCommandStatsInNewCellUi Yeni hücre arayüzünde komut istatistiklerinin gösterilip gösterilmediğini kontrol eder.
Gösteri Tanıtımlı Hücre Başlıklarını Etkinleştir enableShowPromotedCellTitles Yükseltilmiş hücre başlıklarının görüntülenip gösterilmediğini kontrol eder.
Akıllı Teklifleri Etkinleştirin enableSmartQuotes Düzenleyicide akıllı tırnak girişimlerinin etkinleştirilip etkinleştirilmediğini kontrol eder.
Defterler ve Dosyalar İçin Soft Tabs'ı Etkinleştirin enableSoftTabsForNotebooksAndFiles Sekmelerin defterlerde ve dosyalarda boşluklara dönüştürülüp dönüştürülmediğini kontrol eder.
SQL Sözdizimi Hata Vurgulamasını Etkinleştir enableSqlSyntaxErrorHighlighting SQL sözdizimi hatalarının vurgulanıp vurgulanmadığını kontrol eder.
Çalıştırmadan Sonra Komut Moduna Geçmeyi Etkinleştir enableSwitchToCommandModeAfterExecution Hücre çalıştırıldıktan sonra editörün komut moduna geçip geçmediğini kontrol eder.
Birleşik Dosya Ağacı Exploreri'ni etkinleştir enableUnifiedFileTreeExplorer Birleşik dosya ağacı gezgininin etkin olup olmadığını kontrol eder.
Odak enableUnifiedSchemaBrowserTreeExplorer Birleşik şema tarayıcı ağacı gezicisinin etkin olup olmadığını kontrol eder.
Vega Lite Renderer'ı Etkinleştir enableVegaLiteRenderer Vega-Lite render cihazının görselleştirmeler için etkin olup olmadığını kontrol eder.
Vega Lite Renderer'ı etkinleştir Opt Out enableVegaLiteRendererOptOut Vega-Lite render cihazı için çıkış kontrolü.
Vega Lite Renderer Önizleme Etiketini etkinleştir enableVegaLiteRendererPreviewTag Vega-Lite renderer önizleme etiketinin gösterilip gösterilmediğini kontrol eder.
Genişletilmiş alt panel extendedBottomPanel Genişletilmiş alt panelin gösterilip gösterilmediğini kontrol eder.
Lakeflow Yeni Boru Hatları İzleme Arayüzü lakeflowNewPipelinesMonitoringUi Yeni Lakeflow boru hatları izleme arayüzünün etkin olup olmadığını kontrol eder.
Notebook Varsayılan İxracat Formatı notebookDefaultExportFormat Notebooklar için varsayılan dışa aktarma formatını kontrol eder. İzin verilen değerler: SOURCE, JUPYTER.
Seçenek Oku Kısayolu Modu optionArrowShortcutMode Option+Arrow klavye kısayollarının davranışını kontrol eder. İzin verilen değerler: navigate, move.
Pipelines Çok Dosya Yazarlığı pipelinesMultifileAuthoring Boru hatları için çoklu dosya yazarlığının etkin olup olmadığını kontrol eder.
Yorum E-posta Bildirimleri Gönder sendCommentEmailNotifications Yorumlar için e-posta bildirimlerinin gönderilip gönderilmediğini kontrol eder.
Hücre yürütme mini haritasını göster showCellExecutionMinimap Hücre yürütme minimapinin görüntülenip gösterilmediğini kontrol eder.
Pip'i Ortama Panel Komutu Göster showPipToEnvironmentPanelPrompt Pip'in ortam paneline gösterip gösterilmeyeceğini kontrol eder.
Show Spark Advisor showSparkAdvisor Spark optimizasyon önerilerinin görüntülenip gösterilmediğini kontrol eder.
Kıvılcım Hata İpuçlarını Göster showSparkErrorTips Spark hataları için faydalı ipuçlarının gösterilip gösterilmediğini kontrol eder.
Kullanıcı Python Format Hata Vurgulamasını Etkinleştiriyor userActivatesPythonFormatErrorHighlighting Python formatlama hatalarının vurgulanıp vurgulanmadığını kontrol eder.
Kullanıcı Python Sözdizimi Hata Vurgulamasını Etkinleştirdi Opt Out userActivatesPythonSyntaxErrorHighlightingOptOut Python sözdizimi hata vurgulama için ip-out kontrolü.
Kullanıcı Python Tip Doğrulamasını Etkinleştiriyor userActivatesPythonTypeChecking Python tip kontrolü etkin olup olmadığını kontrol eder.
Kullanıcı Anlık Görüntü Geri Yüklemeyi Etkinleştiriyor userActivatesSnapshotRestore Snapshot geri yükleme işlevinin etkin olup olmadığını kontrol eder.
Yeni sorgular için varsayılan limit 1000 usqleDefaultQueryAutoLimit Düzenleyicide SQL sorguları için varsayılan otomatik sınırı kontrol eder.

Ek kaynaklar

  • Son güncelleştirme: