Inställningar API-nycklarreferens

Den här sidan listar de inställningar som finns tillgängliga via det publika Azure Databricks Settings API, grupperade efter omfattning. Varje inställning identifieras med ett stabilt inställningsnamn (nyckel). För hur du upptäcker, läser och uppdaterar dessa inställningar, se Hantera inställningar via Settings API.

Funktionsförhandsvisningar hanteras också via Settings API men listas inte här, eftersom de är tillfälliga och så småningom når slutet av sin livslängd. Upptäck de förhandsvisningar som för närvarande finns tillgängliga för dig via inställnings-metadata-endpointen.

Tillgängliga inställningar

Följande inställningar finns tillgängliga via det publika Settings API, grupperade efter omfattning. Denna lista genereras periodiskt; För den auktoritativa, alltid-aktuella uppsättningen inställningar och deras dokumentationslänkar, anropa Settings-metadata-endpoint, som returnerar namevarje inställnings , description, type, och docs_link.

Kontoinställningar

Inställningar som gäller över hela kontot.

Inställningen Nyckelnamn Description
Inaktivera äldre funktioner disable_legacy_features Inaktivera äldre funktioner för nya Databricks-arbetsytor. För nyskapade arbetsytor: 1. Inaktiverar användningen av DBFS-root och mounts. 2. Hive Metastore kommer inte att provisioneras. 3. Inaktiverar användningen av 'No-isolation clusters'. 4. Inaktiverar Databricks Runtime-versioner före 13.3LTS.
Enforce Unity Gateway enforce_ai_gateway_v3_only Styr om all åtkomst till grundmodellen måste gå via Unity Gateway. När det är aktiverat hanteras åtkomstbehörigheter för modeller, AI-budgetar och säkerhetspolicyer centralt med Unity Gateway, och all trafik från Foundation Model måste passera genom den. Legacy Foundation-modellen som betjänar ändpunkter som kringgår Unity Gateway och avvisar trafik.
Partnerdrivna AI-funktioner llm_proxy_partner_powered Avgör om partnerdrivna modeller är aktiverade eller inte. Denna inställning finns både på konto- och arbetsytsnivå
Upprätthåll partnerdrivna AI-funktioner llm_proxy_partner_powered_enforce Avgör om den partnerdrivna enforce-inställningen är på. När det är aktiverat åsidosätter det kontonivå-partnerdrivna värdet alla arbetsytnivå-överskridningar.
Begränsa administratörer för arbetsytor restrict_workspace_admins Med inställningen Begränsa arbetsyteadministratörer kan du styra funktionerna för arbetsyteadministratörer. Med inställningsstatusen satt till ALLOW_ALL kan workspace-administratörer skapa personliga åtkomsttokens för tjänstehuvudpersoner på uppdrag av vilken tjänstehuvudperson som helst i deras arbetsområde. Arbetsyteadministratörer kan också ändra en jobbägare till vilken användare som helst i deras arbetsyta. Och de kan ändra inställningen för jobb run_as vilken användare som helst i deras arbetsområde eller till en tjänstehuvudperson där de har rollen som Tjänstehuvudanvändare. Med inställningsstatusen satt till RESTRICT_TOKENS_AND_JOB_RUN_AS kan arbetsplatsadministratörer endast skapa personliga åtkomsttokens för tjänsteprincipaler som de har Service Principal User roll på. De kan också bara ändra en jobbägare till sig själva. Och de kan ändra jobbets inställning run_as sig själva eller till en tjänstehuvudperson där de har rollen som tjänstehuvudanvändare.

Inställningar för arbetsytan

Inställningar som gäller för en enda arbetsplats.

Inställningen Nyckelnamn Description
AI/BI-dashboards inbäddningspolicy för åtkomst aibi_dash_embed_ws_acc_policy Styr om AI/BI-publicerad dashboard-inbäddning är aktiverad, villkorligt aktiverad eller inaktiverad på arbetsytnivå. Som standard är denna inställning villkorligt aktiverad (ALLOW_APPROVED_DOMAINS).
AI/BI-dashboard bäddar in godkända domäner aibi_dash_embed_ws_apprvd_domains Kontrollerar listan över domäner som godkänts för att vara värd för de inbyggda AI/BI-dashboards. Listan över godkända domäner kan inte muteras när den aktuella åtkomstpolicyn inte är inställd på ALLOW_APPROVED_DOMAINS.
Begränsa OAuth-scopes för appar till valda värden allowedAppsUserApiScopes Begränsa vilka OAuth scopes-apputvecklare kan begära när de agerar på användarnas vägnar. Ange en lista över tillåtna scopes, eller använd "*" för att tillåta alla stödda scopes. En tom lista inaktiverar effektivt användarbehörighet för appar.
Automatisk klusteruppdatering automatic_cluster_update Automatisk klusteruppdatering säkerställer att alla kluster på en arbetsyta uppdateras regelbundet till den senaste avbildningen och säkerhetsuppdateringarna för värdoperativsystemet. Kontoadministratörer kan schemalägga underhållsfönstrets frekvens, startdatum och starttid. Gäller för klassisk beräkning (kluster, pooler, klassiska SQL-lager, äldre Model Serving); Det gäller inte serverless beräkning. Att aktivera denna funktion lägger till tillägget Enhanced Security and Compliance och kräver Premium-prisklassen.
Tillåtna samarbetsplattformar collaboration_platform_connectivity Kontroller som externa samarbetsplattformar (Slack och/eller Microsoft Teams) kan ansluta till detta arbetsområde. Ställs till ALLOW_ALL.
Tillåt offentliga meddelanden i samarbetsplattformar collaboration_platform_message_visibility När det är aktiverat kan användare välja om svar från Databricks-appen i Slack eller Microsoft Teams ska vara synliga för kanalen. När det är inaktiverat tvingas alla svar vara privata för den begärande användaren.
Åtkomst till arbetsytan för Databricks-personal customerApprovedWSLoginExpirationTime En specifik tid efter vilken Databricks-personal kanske inte längre loggar in på din arbetsplats. Tiden är formaterad som YYYY-MM-DDTHH:MM:SSZ. Du kan helt inaktivera åtkomsten genom att sätta den till en tidsstämpel i det förflutna, till exempel 1998-01-01T00:00:00.000Z. Aktivera åtkomst obegränsat genom att använda en tom sträng eller det speciella värdet indefinite.
Standardnamnrymd default_namespace_ws Standard-namnrymdsinställnings-API:et tillåter användare att konfigurera standardnamnrymden för ett Databricks-arbetsområde.
Inaktivera äldre åtkomst disable_legacy_access 'Inaktivera legacy access' har följande konsekvenser: 1. Inaktiverar direkt åtkomst till Hive Metastores från arbetsytan (åtkomst via Hive Metastore-federationen påverkas inte). 2. Inaktiverar reservläge för åtkomst till extern plats från arbetsytan. 3. Inaktiverar Databricks Runtime-versioner före 13.3LTS. Viktigt: denna inställning kan inte aktiveras medan arbetsytans standardkatalog är inställd på en äldre katalog (hive_metastore eller spark_catalog). Byt standardkatalogen till en Unity-katalogkatalog först.
Inaktivera DBFS-rot och -monteringar disable_legacy_dbfs Att inaktivera äldre DBFS har följande två konsekvenser: 1. Åtkomst till DBFS-root- och DBFS-mounts är förbjuden (liksom skapandet av nya mounts). 2. Inaktiverar Databricks Runtime-versioner före 13.3LTS. När inställningen är avstängd är all DBFS-funktionalitet aktiverad och inga begränsningar införs på Databricks runtime-versioner. Denna inställning kan ta upp till 20 minuter att träda i kraft och kräver manuell omstart av allround-beräkningskluster och SQL-lager.
Aktivera autoflexibla nodtyper enableAutoNodeTypeFlexibility När kluster i denna arbetsyta är aktiverade kan kluster automatiskt starta alternativa nodtyper när den begärda nodtypen inte är tillgänglig, vilket förbättrar starttillförlitligheten vid kapacitetsbrist.
Enforce Unity Gateway enforce_ai_gateway_v3_only Styr om all åtkomst till grundmodellen måste gå via Unity Gateway. När det är aktiverat hanteras åtkomstbehörigheter för modeller, AI-budgetar och säkerhetspolicyer centralt med Unity Gateway, och all trafik från Foundation Model måste passera genom den. Legacy Foundation-modellen som betjänar ändpunkter som kringgår Unity Gateway och avvisar trafik.
Tillåt endast appdistributioner från Git enforceGitAppDeployments När det är aktiverat kan appar i denna arbetsyta endast distribueras från Git.
Partnerdrivna AI-funktioner llm_proxy_partner_powered Avgör om partnerdrivna modeller är aktiverade eller inte. Denna inställning finns både på konto- och arbetsytsnivå
Uppdragskritisk mission_critical Levererar högsta nivåer av operativ motståndskraft och säkerhet för kritiska arbetsbelastningar. Inkluderar katastrofåterställning samt förbättrad säkerhet och efterlevnad.
Tillåt repos att exportera IPYNB-utdata reposIpynbResultsExportPermissions Styr om användare kan committa .ipynb-notebook-utdata till fjärr-Git-repositorier i arbetsytan.
Begränsa administratörer för arbetsytor restrict_workspace_admins Med inställningen Begränsa arbetsyteadministratörer kan du styra funktionerna för arbetsyteadministratörer. Med inställningsstatusen satt till ALLOW_ALL kan workspace-administratörer skapa personliga åtkomsttokens för tjänstehuvudpersoner på uppdrag av vilken tjänstehuvudperson som helst i deras arbetsområde. Arbetsyteadministratörer kan också ändra en jobbägare till vilken användare som helst i deras arbetsyta. Och de kan ändra inställningen för jobb run_as vilken användare som helst i deras arbetsområde eller till en tjänstehuvudperson där de har rollen som Tjänstehuvudanvändare. Med inställningsstatusen satt till RESTRICT_TOKENS_AND_JOB_RUN_AS kan arbetsplatsadministratörer endast skapa personliga åtkomsttokens för tjänsteprincipaler som de har Service Principal User roll på. De kan också bara ändra en jobbägare till sig själva. Och de kan ändra jobbets inställning run_as sig själva eller till en tjänstehuvudperson där de har rollen som tjänstehuvudanvändare.
Efterlevnadsprofil shield_csp_enablement_ws_db Styr om efterlevnadssäkerhetsprofilen är aktiverad för detta arbetsområde. Efterlevnadssäkerhetsprofilen ger en mycket säker baslinje (ytterligare övervakning, en härdad beräkningsbild, påtvingade instanstyper för kryptering mellan noder och andra kontroller) som gör det enklare att uppfylla och hantera tillämpliga efterlevnadsstandarder. Att aktivera den permanent möjliggör också förbättrad säkerhetsövervakning och automatisk klusteruppdatering på arbetsytan, samt tillägget Enhanced Security and Compliance.
Förbättrad säkerhetsövervakning shield_esm_enablement_ws_db Styr om förbättrad säkerhetsövervakning är aktiverad för denna arbetsplats. Förbättrad säkerhetsövervakning ger en härdad beräkningsbild och ytterligare säkerhetsövervakningsagenter (filintegritetsövervakning, antivirus och sårbarhetsskanning) som genererar granskningsbara loggrader. Det gäller endast för resurser för klassiska beräkningsplanet, inte serverless. Om efterlevnadssäkerhetsprofilen är aktiverad på arbetsytan är denna inställning permanent upprätthållen.
Arbetsyteetikett workspace_label En anpassad etikett och färgbricka visas bredvid arbetsytans namn i Databricks konsoltoppsnavigering. Arbetsytadministratörer kan använda denna inställning för att visuellt skilja arbetsytor mellan miljöer. Värdet är ett objekt med ett label fält (textsträng) och ett color fält (ett av: coral, lemon, lime, turquoise, indigo, purple, ). pink Båda fälten är tomma strängar när ingen etikett är satt.

Användarinställningar

Inställningar som gäller en användare i ett konto.

Inställningen Nyckelnamn Description
Skapa automatiskt en session vid redigerarens interaktion autoCreateSessionOnEditorInteraction Styr om en session automatiskt skapas när man interagerar med editorn.
Automatisk start och anslutning autoLaunchAndAttach Styr om anteckningsböcker automatiskt startar och kopplas till kluster.
Bekräfta Kommando Ta bort confirmCommandDelete Styr om bekräftelse krävs innan ett kommando tas bort.
Skapa nya tillgångar i mappen Drafts createNewAssetsInDraftsFolder Styr om nya tillgångar skapas i utkastmappen.
Databricks Unified SQL-redigerare skapar och konverterar frågor på öppet pref databricks-unified-sql-editor-create-and-convert-queries-on-open-pref Styr skapande och konverteringsbeteende för frågor i den enhetliga SQL-redigeraren.
Standard Python-indrag-enhet defaultPythonIndentUnit Styr standard-Python-indragenheten. Tillåtna värden: 2, 4, eller '' (tomt sträng för standard).
Redaktör Custom Dark Theme editorCustomDarkTheme Styr det anpassade mörka temat för editorn. Tillåtna värden: defaultTheme, Atom-One-Dark, , Ayu-DarkBlackboard, , DraculaGitHub-Dark, MonokaiOne-Dark-ProWinter-is-Coming-Dark.
Redaktör Anpassad ljustema editorCustomLightTheme Styr det anpassade ljustemat för editorn. Tillåtna värden: defaultTheme, Active4D, Atom-One-Light, Ayu-Light, GitHub-Light, Tomorrow, Winter-is-Coming-Light.
Editorns teckenstorlek editorFontSize Styr teckenstorleken i redigeraren. Tillåtna värden: heltal varierar från 10 till 30.
Aktivera automatisk snabbfix i lina enableAutoInlineQuickFix Kontrollerar om snabba lösningar automatiskt föreslås i inline.
Aktivera automatisk snabb inline-lösning och avanmäl enableAutoInlineQuickFixOptOut Opt-out-kontroll för automatiska snabba inline-lösningar.
Aktivera automatisk triggerdiagnos enableAutoTriggerDiagnose Styr om diagnostik triggas automatiskt.
Aktivera automatisk triggerdiagnos och avregistrera dig enableAutoTriggerDiagnoseOptOut Opt-out-kontroll för automatisk diagnostik.
Aktivera centrerad layout enableCenteredLayout Styr om editorn använder en centrerad layout.
Aktivera klassiska genvägar enableClassicShortcuts Styr tangentbordsgenvägsläget. Tillåtna värden: default, classic.
Aktivera kommandonummer enableCommandNumbers Styr om kommandonummer visas i anteckningsböcker.
Aktivera kompletteringar medan du skriver enableCompletionsAsYouType Styr om autokompletteringsförslag visas medan du skriver.
Aktivera markörblinkning enableCursorBlink Styr om markören blinkar i editorn.
Aktivera mörkt läge enableDarkMode Styr temaläget. Tillåtna värden: light, dark, system.
Aktivera Enter Accepterar förslag enableEnterAcceptsSuggestions Styr om Enter godkänner autokompletteringsförslag.
Aktivera Hover för redigerare enableHoverForEditor Styr om hoververktygstips visas i editorn.
Aktivera inline-förslag medan du skriver avtrösta enableInlineSuggestionAsYouTypeOptOut Opt-out-kontroll för inline-förslag medan du skriver.
Aktivera radnummer enableLineNumbers Styr om radnummer visas i editorn.
Aktivera radnummer V2 enableLineNumbersV2 Styr om radnummer visas i editorn (v2).
Aktivera linjeomslagning enableLineWrap Styr om text går vidare till nästa rad i editorn.
Aktivera Monaco Multicursor enableMonacoMultiCursor Styr multi-cursor-modifieringsknappen. Tillåtna värden: alt, ctrlCmd.
Aktivera Notebook Debugger Opt-out enableNotebookDebuggerOptOut Opt-out-kontroll för notebook-felsökaren.
Aktivera serverless observability-vippen enableServerlessObservabilityToggle Användaren kan välja förbättrad serverless observability i jobb när arbetsytsförhandsvisningen är aktiverad.
Aktivera Visa kommandostatistik i det nya cellgränssnittet enableShowCommandStatsInNewCellUi Styr om kommandostatistik visas i det nya cellgränssnittet.
Aktivera Visa marknadsförda celltitlar enableShowPromotedCellTitles Styr om befordrade celltitlar visas.
Aktivera smarta offerter enableSmartQuotes Styr om smarta citat är aktiverade i editorn.
Aktivera mjuka flikar för anteckningsböcker och filer enableSoftTabsForNotebooksAndFiles Styr om flikar konverteras till mellanslag i anteckningsböcker och filer.
Aktivera felmarkering av SQL-syntax enableSqlSyntaxErrorHighlighting Styr om SQL-syntaxfel markeras.
Aktivera Switch To Command Mode efter körning enableSwitchToCommandModeAfterExecution Styr om editorn byter till kommandoläge efter cellexekvering.
Aktivera Unified File Tree Explorer enableUnifiedFileTreeExplorer Styr om den enhetliga filträdsutforskaren är aktiverad.
Fokus enableUnifiedSchemaBrowserTreeExplorer Styr om den enhetliga schema-webbläsarens trädutforskare är aktiverad.
Aktivera Vega Lite Renderer enableVegaLiteRenderer Styr om Vega-Lite-renderaren är aktiverad för visualiseringar.
Aktivera Vega Lite Renderer opt-out enableVegaLiteRendererOptOut Opt-out-kontroll för Vega-Lite-renderaren.
Aktivera Vega Lite Renderer Preview Tag enableVegaLiteRendererPreviewTag Styr om förhandsvisningstaggen för Vega-Lite renderare visas.
Förlängd bottenpanel extendedBottomPanel Styr om den utvidgade bottenpanelen visas.
Lakeflow Nya Pipelines Övervakningsgränssnitt lakeflowNewPipelinesMonitoringUi Styr om det nya övervakningsgränssnittet för Lakeflow-pipelines är aktiverat.
Anteckningsbokens standardexportformat notebookDefaultExportFormat Styr standardexportformatet för anteckningsböcker. Tillåtna värden: SOURCE, JUPYTER.
Alternativ pilgenvägsläge optionArrowShortcutMode Styr beteendet för Alternativ+pil-tangentbordsgenvägar. Tillåtna värden: navigate, move.
Pipelines Multifile Authoring pipelinesMultifileAuthoring Styr om multifile authoring är aktiverat för pipelines.
Skicka kommentarsmeddelanden via e-post sendCommentEmailNotifications Styr om e-postnotiser skickas för kommentarer.
Visa cellexekveringsminimap showCellExecutionMinimap Styr om cellexekveringsminimappen visas.
Visa Pip Till miljöpanelprompt showPipToEnvironmentPanelPrompt Styr om pip visas till miljöpanelens prompt.
Show Spark-rådgivare showSparkAdvisor Styr om Spark-optimeringsförslag visas.
Tips för fel i Show Spark showSparkErrorTips Styr om hjälpsamma tips visas för Spark-fel.
Användaraktivering av Python-formatets felmarkering userActivatesPythonFormatErrorHighlighting Styr om Python-formateringsfel markeras.
Användaraktiverar Python-syntaxfelmarkering avvinkning userActivatesPythonSyntaxErrorHighlightingOptOut Opt-out-kontroll för felmarkering av Python-syntax.
Användaraktiverar Python-typkontroll userActivatesPythonTypeChecking Styr om Python-typkontroll är aktiverad.
Användaren aktiverar snapshotåterställning userActivatesSnapshotRestore Styr om funktionen för snapshotåterställning är aktiverad.
Standardgräns 1000 för nya frågor usqleDefaultQueryAutoLimit Styr standardautolimiten för SQL-frågor i editorn.

Ytterligare resurser

  • Uppdaterades senast