이 페이지는 공개된 Azure Databricks 설정 API를 통해 제공되는 설정을 범위별로 그룹화하여 나열합니다. 각 설정은 안정적인 설정 이름 (키)으로 식별됩니다. 이 설정을 발견하고, 읽고, 업데이트하는 방법은 '설정 API를 통한 설정 관리'를 참고하세요.
기능 미리보기도 설정 API를 통해 관리되지만, 일시적이며 결국 수명이 종료되기 때문에 여기에는 나열되지 않습니다. settings-metadata 엔드포인트를 통해 현재 이용 가능한 미리보기를 확인하세요.
사용 가능한 설정
다음 설정들은 공개 설정 API를 통해 범위별로 그룹화되어 제공됩니다. 이 목록은 주기적으로 생성되며; 권위 있고 항상 최신 설정 집합과 그 문서 링크에 대해서는 settings-metadata 엔드포인트를 호출하여 각 설정의 name, description, , type를 docs_link반환합니다.
계정 설정
계정 전반에 적용되는 설정들.
| 설정 | 키 이름 | Description |
|---|---|---|
| 레거시 기능을 비활성화하기 | disable_legacy_features |
새로운 Databricks 작업 공간에 대한 레거시 기능을 비활성화하세요. 새로 생성된 작업 공간에 대해: 1. DBFS 루트와 마운트 사용을 비활성화합니다. 2. Hive Metastore는 프로비저닝되지 않습니다. 3. '무격리 클러스터' 사용을 금지합니다. 4. 13.3LTS 이전 Databricks 런타임 버전을 비활성화합니다. |
| 통합 게이트웨이 강제 | enforce_ai_gateway_v3_only |
모든 기초 모델 접근이 Unity 게이트웨이를 거쳐야 하는지 제어합니다. 활성화되면 모델 접근 권한, AI 예산, 보안 정책이 Unity Gateway를 통해 중앙에서 관리되며, 모든 기초 모델 트래픽이 이를 통과해야 합니다. Unity Gateway를 우회하는 엔드포인트를 지원하는 레거시 파운데이션 모델은 트래픽을 거부합니다. |
| 파트너 기반 AI 기능 | llm_proxy_partner_powered |
파트너 기반 모델이 활성화되었는지 여부를 결정합니다. 이 설정은 계정 레벨과 작업 공간 모두에서 사용할 수 있습니다 |
| 파트너 기반 AI 기능 강제 | llm_proxy_partner_powered_enforce |
파트너 파워 집행 설정이 켜져 있는지 결정합니다. 활성화되면 계정 수준의 파트너 기반 가치가 어떤 작업 공간 차원의 오버라이드보다 우선합니다. |
| 작업 공간 관리자 제한 | restrict_workspace_admins |
작업 영역 관리자 제한 설정을 사용하면 작업 영역 관리자의 기능을 제어할 수 있습니다. 설정을 ALLOW_ALL로 설정하면, 워크스페이스 관리자는 자신의 워크스페이스 내 모든 서비스 프린시펄을 대신해 서비스 프린시펄 개인 액세스 토큰을 생성할 수 있습니다. 작업 영역 관리자는 작업 소유자를 작업 영역의 모든 사용자로 변경할 수도 있습니다. 그리고 작업 run_as 설정을 작업 공간 내 어떤 사용자나 서비스 주체(Service Principal User) 역할이 있는 서비스 주체로 변경할 수도 있습니다. 설정 상태가 RESTRICT_TOKENS_AND_JOB_RUN_AS로 설정되어 있으면, 작업 공간 관리자는 서비스 주체인 사용자 역할을 가진 서비스 주체를 대신해 개인 접근 토큰을 생성할 수 있습니다. 또한 작업 소유자를 자신에게만 변경할 수 있습니다. 그리고 작업 run_as 설정을 자신이나 서비스 주체로 변경할 수도 있고, 서비스 주체로서 서비스 주체(Service Principal User) 역할을 맡게 됩니다. |
작업 영역 설정
하나의 작업 공간에 적용되는 설정들.
| 설정 | 키 이름 | Description |
|---|---|---|
| AI/BI 대시보드 임베딩 접근 정책 | aibi_dash_embed_ws_acc_policy |
AI/BI가 공개한 대시보드 임베딩이 작업 공간 수준에서 활성화, 조건부 활성화, 비활성화 여부를 제어합니다. 기본적으로 이 설정은 조건부 활성화(ALLOW_APPROVED_DOMAINS)로 되어 있습니다. |
| AI/BI 대시보드 승인된 도메인 임베딩 | aibi_dash_embed_ws_apprvd_domains |
임베디드 AI/BI 대시보드를 호스팅할 수 있도록 승인된 도메인 목록을 제어합니다. 현재 접근 정책이 ALLOW_APPROVED_DOMAINS로 설정되어 있지 않으면 승인된 도메인 목록은 변형될 수 없습니다. |
| 앱의 OAuth 범위를 선택한 값으로 제한하세요 | allowedAppsUserApiScopes |
앱 개발자가 사용자를 대신해 행동할 때 요청할 수 있는 OAuth 범위를 제한하세요. 허용된 범위 목록을 지정하거나, "*"를 사용해 모든 지원되는 범위를 허용하세요. 빈 목록은 사실상 앱에 대한 사용자 권한을 비활성화합니다. |
| 자동 클러스터 업데이트 | automatic_cluster_update |
자동 클러스터 업데이트를 사용하면 작업 영역의 모든 클러스터가 정기적으로 최신 호스트 OS 이미지 및 보안 업데이트로 업데이트됩니다. 계정 관리자는 유지 관리 기간 빈도, 시작 날짜 및 시작 시간을 예약할 수 있습니다. 클래식 컴퓨트(클러스터, 풀, 클래식 SQL 웨어하우스, 레거시 모델 서빙)에 적용됩니다; 서버리스 컴퓨트에는 적용되지 않습니다. 이 기능을 활성화하면 향상된 보안 및 컴플라이언스 추가 기능이 추가되며, 프리미엄 가격 등급이 필요합니다. |
| 허용된 협업 플랫폼 | collaboration_platform_connectivity |
외부 협업 플랫폼(Slack 및/또는 Microsoft Teams)이 이 작업 공간에 연결할 수 있는 것을 제어합니다. 기본값은 ALLOW_ALL입니다. |
| 협업 플랫폼에서 공개 메시지 허용 | collaboration_platform_message_visibility |
활성화되면 사용자는 슬랙의 Databricks 앱이나 Microsoft Teams에서 받은 응답이 채널에 보이는지 선택할 수 있습니다. 비활성화되면 모든 응답은 요청자에게 비공개로 유지됩니다. |
| Databricks 직원의 작업 공간 접근 권한 | customerApprovedWSLoginExpirationTime |
Databricks 직원이 더 이상 귀하의 작업 공간에 로그인할 수 없는 특정 시간입니다. 시간은 로 YYYY-MM-DDTHH:MM:SSZ포맷되어 있습니다. 과거의 타임스탬프(예: 1998-01-01T00:00:00.000Z.)로 설정하면 접근 권한을 완전히 비활성화할 수 있습니다. 빈 문자열이나 특수 값을 indefinite사용하여 무한정 접근 권한을 활성화합니다. |
| 기본 네임스페이스 | default_namespace_ws |
기본 네임스페이스 설정 API는 사용자가 Databricks 작업 공간의 기본 네임스페이스를 구성할 수 있게 합니다. |
| 레거시 접근 권한을 비활성화하세요 | disable_legacy_access |
'레거시 접근 비활성화'는 다음과 같은 영향을 가집니다: 1. 작업 공간에서 Hive Metastore에 직접 접근할 수 없게 합니다(Hive Metastore 연합을 통한 접근은 영향을 받지 않음). 2. 작업 영역에서 외부 위치 액세스에 대한 대체 모드를 사용하지 않도록 설정합니다. 3. 13.3LTS 이전 Databricks 런타임 버전을 비활성화합니다. 중요: 작업 공간 기본 카탈로그가 레거시 카탈로그(hive_metastore 또는 spark_catalog)로 설정되어 있을 때는 이 설정을 활성화할 수 없습니다. 먼저 기본 카탈로그를 Unity 카탈로그로 변경하세요. |
| DBFS 루트 및 탑재 사용 안 함 | disable_legacy_dbfs |
레거시 DBFS를 비활성화하는 것은 다음과 같은 두 가지 함의를 가집니다: 1. DBFS 루트 마운트 및 DBFS 마운트에 대한 접근은 금지되며(새로운 마운트 생성도 금지됩니다). 2. 13.3LTS 이전 Databricks 런타임 버전을 비활성화합니다. 설정이 꺼져 있으면 모든 DBFS 기능이 활성화되며 Databricks 런타임 버전에는 제한이 부과되지 않습니다. 이 설정은 효과가 나타나기까지 최대 20분이 걸릴 수 있으며, 다목적 컴퓨트 클러스터와 SQL 웨어하우스를 수동으로 재시작해야 합니다. |
| 자동 유연한 노드 유형 활성화 | enableAutoNodeTypeFlexibility |
활성화되면 요청된 노드 유형이 사용 불가능할 때 이 작업 공간의 클러스터가 자동으로 대체 노드 유형으로 런칭되어 용량 부족 시 런치 신뢰성을 향상시킵니다. |
| 통합 게이트웨이 강제 | enforce_ai_gateway_v3_only |
모든 기초 모델 접근이 Unity 게이트웨이를 거쳐야 하는지 제어합니다. 활성화되면 모델 접근 권한, AI 예산, 보안 정책이 Unity Gateway를 통해 중앙에서 관리되며, 모든 기초 모델 트래픽이 이를 통과해야 합니다. Unity Gateway를 우회하는 엔드포인트를 지원하는 레거시 파운데이션 모델은 트래픽을 거부합니다. |
| 앱 배포는 Git에서만 허용됩니다 | enforceGitAppDeployments |
활성화되면 이 작업 공간의 앱은 Git에서만 배포할 수 있습니다. |
| 파트너 기반 AI 기능 | llm_proxy_partner_powered |
파트너 기반 모델이 활성화되었는지 여부를 결정합니다. 이 설정은 계정 레벨과 작업 공간 모두에서 사용할 수 있습니다 |
| 임무 중요 | mission_critical |
중요한 업무 부하에 대해 최고 수준의 운영 복원력과 보안을 제공합니다. 재해 복구와 향상된 보안 및 준수를 포함합니다. |
| 저장소가 IPYNB 출력을 내보낼 수 있도록 허용하세요 | reposIpynbResultsExportPermissions |
사용자가 .ipynb 노트북 출력을 작업 공간 내 원격 Git 저장소에 커밋할 수 있는지 제어합니다. |
| 작업 공간 관리자 제한 | restrict_workspace_admins |
작업 영역 관리자 제한 설정을 사용하면 작업 영역 관리자의 기능을 제어할 수 있습니다. 설정을 ALLOW_ALL로 설정하면, 워크스페이스 관리자는 자신의 워크스페이스 내 모든 서비스 프린시펄을 대신해 서비스 프린시펄 개인 액세스 토큰을 생성할 수 있습니다. 작업 영역 관리자는 작업 소유자를 작업 영역의 모든 사용자로 변경할 수도 있습니다. 그리고 작업 run_as 설정을 작업 공간 내 어떤 사용자나 서비스 주체(Service Principal User) 역할이 있는 서비스 주체로 변경할 수도 있습니다. 설정 상태가 RESTRICT_TOKENS_AND_JOB_RUN_AS로 설정되어 있으면, 작업 공간 관리자는 서비스 주체인 사용자 역할을 가진 서비스 주체를 대신해 개인 접근 토큰을 생성할 수 있습니다. 또한 작업 소유자를 자신에게만 변경할 수 있습니다. 그리고 작업 run_as 설정을 자신이나 서비스 주체로 변경할 수도 있고, 서비스 주체로서 서비스 주체(Service Principal User) 역할을 맡게 됩니다. |
| 준수 보안 프로필 | shield_csp_enablement_ws_db |
이 작업 공간에서 컴플라이언스 보안 프로필이 활성화되었는지 제어합니다. 컴플라이언스 보안 프로필은 추가 모니터링, 강화된 컴퓨팅 이미지, 노드 간 암호화를 위한 인스턴스 유형 강제 및 기타 제어 등 매우 안전한 기준을 제공하여 적용 가능한 컴플라이언스 기준을 충족하고 관리하기 쉽게 만듭니다. 활성화하면 보안 모니터링과 작업 공간의 자동 클러스터 업데이트가 영구적으로 가능해지고, 향상된 보안 및 준수 애드온도 추가됩니다. |
| 강화된 보안 모니터링 | shield_esm_enablement_ws_db |
이 작업 공간에서 강화된 보안 모니터링이 활성화되었는지 제어합니다. 향상된 보안 모니터링은 강화된 컴퓨팅 이미지와 추가 보안 모니터링 에이전트(파일 무결성 모니터링, 안티바이러스, 취약점 스캔)를 제공하여 검토 가능한 로그 행을 생성합니다. 이 규칙은 서버리스가 아닌 클래식 컴퓨트 플레인 자원에만 적용됩니다. 작업 공간에서 컴플라이언스 보안 프로필이 활성화되어 있으면 이 설정이 영구적으로 적용됩니다. |
| 작업 공간 라벨 | workspace_label |
Databricks 콘솔 상단 내비게이션에서 작업 공간 이름 옆에 커스텀 라벨과 색상 배지가 표시되어 있습니다. 작업 공간 관리자는 이 설정을 사용해 환경 간 작업 공간을 시각적으로 구분할 수 있습니다. 값은 필드(텍스트 문자열)와 color 필드(다음 중 coral하나인 , , limeturquoiselemon, indigo, , purple)pink를 가진 label 객체입니다. 라벨이 설정되지 않은 경우 두 필드 모두 빈 문자열입니다. |
사용자 기본 설정
계정 내 사용자에게 적용되는 설정들.
| 설정 | 키 이름 | Description |
|---|---|---|
| 에디터 상호작용 시 자동으로 세션 생성 | autoCreateSessionOnEditorInteraction |
에디터와 상호작용할 때 세션이 자동으로 생성되는지 여부를 제어합니다. |
| 자동 발사 및 부착 | autoLaunchAndAttach |
노트북이 자동으로 실행되고 클러스터에 연결되는지 제어합니다. |
| 확인 명령 삭제 | confirmCommandDelete |
명령을 삭제하기 전에 확인이 필요한지 여부를 제어합니다. |
| Drafts 폴더에서 새 자산 생성 | createNewAssetsInDraftsFolder |
초안 폴더에 새로운 자산이 생성되는지 여부를 제어합니다. |
| Databricks 통합 SQL 편집기: Open Pref에서 쿼리 생성 및 변환 | databricks-unified-sql-editor-create-and-convert-queries-on-open-pref |
통합 SQL 편집기에서 쿼리 생성 및 변환 동작을 제어합니다. |
| 기본 Python 들여쓰기 유닛 | defaultPythonIndentUnit |
기본 Python 들여쓰기 유닛을 제어합니다. 허용되는 값: 2, 4, 또는 ''(기본값은 빈 문자열). |
| 에디터 커스텀 다크 테마 | editorCustomDarkTheme |
에디터용 커스텀 다크 테마를 제어합니다. 허용 값: , , , , , , , defaultTheme, Atom-One-Dark, . Ayu-DarkBlackboardDraculaGitHub-DarkMonokaiOne-Dark-ProWinter-is-Coming-Dark |
| 에디터 커스텀 라이트 테마 | editorCustomLightTheme |
에디터의 커스텀 라이트 테마를 제어합니다. 허용되는 값: defaultTheme,, Active4DAtom-One-Light, Ayu-LightGitHub-Light, TomorrowWinter-is-Coming-Light. |
| 편집기 글꼴 크기 | editorFontSize |
에디터에서 글꼴 크기를 제어합니다. 허용 값: 정수 범위는 10에서 30까지입니다. |
| 자동 인라인 빠른 수정 활성화 | enableAutoInlineQuickFix |
인라인 신속 해결책이 자동으로 제안되는지 제어합니다. |
| 자동 인라인 신속 수정 활성화 옵트아웃 | enableAutoInlineQuickFixOptOut |
자동 인라인 신속 해결책을 위한 옵트아웃 제어. |
| 자동 트리거 진단 활성화 | enableAutoTriggerDiagnose |
진단이 자동으로 실행되는지 제어합니다. |
| 자동 트리거 진단 활성화 옵트아웃 | enableAutoTriggerDiagnoseOptOut |
자동 진단을 위한 옵트아웃 컨트롤. |
| 중앙 배치 활성화 | enableCenteredLayout |
에디터가 중앙 레이아웃을 사용하는지 제어합니다. |
| 클래식 단축어 활성화하기 | enableClassicShortcuts |
키보드 단축키 모드를 제어합니다. 허용되는 값: default, classic. |
| 명령 번호 활성화 | enableCommandNumbers |
노트북에 명령 번호가 표시되는지 여부를 제어합니다. |
| 타이핑하면서 완성 활성화 | enableCompletionsAsYouType |
자동 완성 제안이 입력 중에 나타나는지 조절합니다. |
| 커서 깜빡임 활성화 | enableCursorBlink |
에디터에서 커서가 깜빡이는지 제어합니다. |
| 다크 모드 활성화 | enableDarkMode |
테마 모드를 조작합니다. 허용되는 값: light, dark, system. |
| Enable Enter Accepts Suggestions | enableEnterAcceptsSuggestions |
엔터 버튼을 눌러도 자동 완성 제안을 받는지 여부를 제어합니다. |
| 편집기용 호버 활성화 | enableHoverForEditor |
에디터에서 호버 툴팁이 표시되는지 제어합니다. |
| 타이핑하면서 인라인 제안을 활성화하세요 옵트아웃 | enableInlineSuggestionAsYouTypeOptOut |
타이핑 중 인라인 제안에 대한 옵트아웃 컨트롤. |
| 라인 번호 활성화 | enableLineNumbers |
에디터에서 줄 번호가 표시되는지 제어합니다. |
| 라인 번호 V2 활성화 | enableLineNumbersV2 |
에디터(v2)에서 줄 번호가 표시되는지 제어합니다. |
| 라인 감싸기 활성화 | enableLineWrap |
에디터에서 텍스트가 다음 줄로 감기는지 여부를 제어합니다. |
| 모나코 멀티 커서 활성화하기 | enableMonacoMultiCursor |
멀티커서 모디파이어 키를 조작합니다. 허용되는 값: alt, ctrlCmd. |
| 노트북 디버거 옵트아웃 활성화 | enableNotebookDebuggerOptOut |
노트북 디버거에 대한 옵트아웃 제어. |
| 서버리스 관측성 토글 활성화 | enableServerlessObservabilityToggle |
작업 공간 미리보기가 활성화되었을 때 사용자 옵트인으로 작업에서 향상된 서버리스 관찰 가능성에 대해 선택했습니다. |
| 새 셀 UI에서 명령어 통계 표시 활성화 | enableShowCommandStatsInNewCellUi |
명령 통계가 새 셀 UI에 표시되는지 여부를 제어합니다. |
| 프로그램 프로모션 셀 타이틀 활성화 | enableShowPromotedCellTitles |
프로모션된 셀 타이틀이 표시되는지 제어합니다. |
| 스마트 인용 활성화 | enableSmartQuotes |
편집기에서 스마트 인용표가 활성화되어 있는지 제어합니다. |
| 노트북과 파일용 소프트 탭 활성화 | enableSoftTabsForNotebooksAndFiles |
노트북과 파일 내 탭이 공간으로 변환되는지 여부를 제어합니다. |
| SQL 문법 오류 강조 활성화 | enableSqlSyntaxErrorHighlighting |
SQL 문법 오류가 강조 표시되는지 제어합니다. |
| 실행 후 Switch to command mode 활성화 | enableSwitchToCommandModeAfterExecution |
셀 실행 후 에디터가 명령 모드로 전환되는지 여부를 제어합니다. |
| 통합 파일 트리 탐색기 활성화 | enableUnifiedFileTreeExplorer |
통합 파일 트리 탐색기가 활성화되었는지 제어합니다. |
| 포커스 | enableUnifiedSchemaBrowserTreeExplorer |
통합 스키마 브라우저 트리 탐색기가 활성화되었는지 제어합니다. |
| Vega Lite 렌더러 활성화하기 | enableVegaLiteRenderer |
시각화 시 Vega-Lite 렌더러가 활성화되어 있는지 제어합니다. |
| Vega Lite 렌더러 옵트아웃 활성화하기 | enableVegaLiteRendererOptOut |
Vega-Lite 렌더러의 옵트아웃 제어. |
| Vega Lite 렌더러 미리보기 태그 활성화하기 | enableVegaLiteRendererPreviewTag |
Vega-Lite 렌더러 미리보기 태그가 표시되는지 여부를 제어합니다. |
| 확장된 하단 패널 | extendedBottomPanel |
확장된 하단 패널이 표시되는지 여부를 제어합니다. |
| 레이크플로우 신규 파이프라인 모니터링 UI | lakeflowNewPipelinesMonitoringUi |
새로운 Lakeflow 파이프라인 모니터링 UI가 활성화되었는지 제어합니다. |
| 노트북 기본 내보내기 형식 | notebookDefaultExportFormat |
노트북의 기본 내보내기 형식을 제어합니다. 허용되는 값: SOURCE, JUPYTER. |
| 옵션 화살표 단축키 모드 | optionArrowShortcutMode |
Option+Arrow 키보드 단축키의 동작을 제어합니다. 허용되는 값: navigate, move. |
| 파이프라인 멀티파일 저작 | pipelinesMultifileAuthoring |
파이프라인에서 다중 파일 작성이 활성화되었는지 제어합니다. |
| 댓글 이메일 알림 보내기 | sendCommentEmailNotifications |
댓글을 위한 이메일 알림 발송 여부를 통제합니다. |
| 셀 실행 미니맵 표시 | showCellExecutionMinimap |
셀 실행 미니맵이 표시되는지 여부를 제어합니다. |
| 환경 패널로 핍 표시 프롬프트 | showPipToEnvironmentPanelPrompt |
환경 패널 프롬프트에 PIP를 보일지 여부를 제어합니다. |
| 쇼 스파크 어드바이저 | showSparkAdvisor |
Spark 최적화 제안이 표시되는지 여부를 제어합니다. |
| Show Spark 오류 팁 | showSparkErrorTips |
스파크 오류에 대한 유용한 팁이 표시되는지 제어합니다. |
| 사용자가 Python 형식 오류 강조 활성화 | userActivatesPythonFormatErrorHighlighting |
Python 포맷 오류가 강조 표시되는지 제어합니다. |
| 사용자가 Python 문법 오류를 활성화하며 옵트아웃을 강조합니다 | userActivatesPythonSyntaxErrorHighlightingOptOut |
Python 문법 오류 강조 표시에 대한 옵트아웃 제어. |
| 사용자가 Python 타입 검사를 활성화합니다 | userActivatesPythonTypeChecking |
Python 타입 검사가 활성화되었는지 제어합니다. |
| 사용자가 스냅샷 복원을 활성화함 | userActivatesSnapshotRestore |
스냅샷 복원 기능이 활성화되었는지 제어합니다. |
| 새 쿼리에 대한 기본 제한 1000 | usqleDefaultQueryAutoLimit |
편집기에서 SQL 쿼리의 기본 자동 제한을 제어합니다. |