Referencia de claves API de configuración

Esta página enumera los ajustes disponibles a través de la API pública de Configuración de Azure Databricks, agrupados por alcance. Cada configuración se identifica por un nombre estable (clave). Para saber cómo descubrir, leer y actualizar estos ajustes, consulta Gestionar ajustes a través de la API de Configuración.

Las previsualizaciones de funciones también se gestionan a través de la API de Configuración, pero no se listan aquí, porque son transitorias y finalmente llegan al final de su vida útil. Descubre las vistas previas disponibles actualmente a través del endpoint de configuración y metadatos.

Configuración disponible

Las siguientes configuraciones están disponibles a través de la API pública de Configuración, agrupadas por alcance. Esta lista se genera periódicamente; Para el conjunto autoritativo y siempre vigente de configuraciones y sus enlaces de documentación, llama al endpoint de metadatos de configuración, que devuelve los nameajustes , description, type, y docs_link.

Configuración de la cuenta

Configuraciones que se aplican a toda la cuenta.

Setting Nombre de clave Description
Desactivar funciones heredadas disable_legacy_features Desactiva las funciones heredadas para los nuevos espacios de trabajo de Databricks. Para espacios de trabajo recién creados: 1. Desactiva el uso de la raíz y montajes de DBFS. 2. La Metastore de Colmena no será provisionada. 3. Desactiva el uso de 'clústeres sin aislamiento'. 4. Desactiva Databricks Versiones de ejecución anteriores a 13.3LTS.
Hacer cumplir Unity Gateway enforce_ai_gateway_v3_only Controla si todo el acceso a los modelos de fundación debe pasar por Unity Gateway. Cuando está habilitado, los permisos de acceso al modelo, los presupuestos de IA y las políticas de seguridad se gestionan de forma centralizada con Unity Gateway, y todo el tráfico del modelo de fundación debe pasar a través de él. El modelo de fundación heredado que sirve a los endpoints que evitan Unity Gateway rechaza el tráfico.
Características de IA impulsadas por socios llm_proxy_partner_powered Determina si los modelos impulsados por socios están habilitados o no. Esta configuración está disponible tanto a nivel de cuenta como de espacio de trabajo
Hacer cumplir funciones de IA impulsadas por socios llm_proxy_partner_powered_enforce Determina si la configuración de aplicación potenciada por el compañero está activada. Cuando está habilitado, el valor potenciado por el socio a nivel de cuenta anula cualquier anulación a nivel de espacio de trabajo.
Restringir administradores de espacios de trabajo restrict_workspace_admins La configuración Restringir administradores del área de trabajo le permite controlar las funcionalidades de los administradores del área de trabajo. Con el estado de configuración configurado en ALLOW_ALL, los administradores del espacio de trabajo pueden crear tokens de acceso personales para el principal de servicio en nombre de cualquier principal de servicio en su espacio de trabajo. Los administradores del área de trabajo también pueden cambiar el propietario de una tarea a cualquier usuario de su área de trabajo. Y pueden cambiar la configuración run_as el trabajo a cualquier usuario en su espacio de trabajo o a un principal de servicio en el que tengan el rol de Usuario Principal de Servicio. Con el estado de configuración configurado en RESTRICT_TOKENS_AND_JOB_RUN_AS, los administradores de espacio de trabajo solo pueden crear tokens de acceso personales en nombre de los responsables de servicio en los que tienen el rol de Usuario Principal de Servicio. Solo pueden cambiar el propietario de un trabajo a sí mismos. Y pueden cambiar el puesto run_as la configuración para ellos mismos o para un principal de servicio en el que tengan el rol de Usuario Principal del Servicio.

Configuración del área de trabajo

Configuraciones que se aplican a un único espacio de trabajo.

Setting Nombre de clave Description
Política de Acceso de Integración de Paneles de IA/BI aibi_dash_embed_ws_acc_policy Controla si la incrustación de paneles publicados por IA/BI está habilitada, condicionalmente o deshabilitada a nivel de espacio de trabajo. Por defecto, esta configuración está habilitada condicionalmente (ALLOW_APPROVED_DOMAINS).
Incrustación de dominios aprobados en paneles de control de IA/BI aibi_dash_embed_ws_apprvd_domains Controla la lista de dominios aprobados para alojar los paneles de control de IA/BI embebidos. La lista de dominios aprobados no puede modificarse cuando la política de acceso actual no está configurada como ALLOW_APPROVED_DOMAINS.
Restringir los ámbitos OAuth de las aplicaciones a valores seleccionados allowedAppsUserApiScopes Restringir qué ámbitos OAuth pueden solicitar los desarrolladores de aplicaciones cuando actúan en nombre de los usuarios. Especifica una lista de osciloscopios permitidos, o usa "*" para permitir todos los ámbitos soportados. Una lista vacía desactiva efectivamente la autorización del usuario para las aplicaciones.
Actualización automática del clúster automatic_cluster_update La actualización automática del clúster garantiza que todos los clústeres de un área de trabajo se actualicen periódicamente con la imagen del sistema operativo host y las actualizaciones de seguridad más recientes. Los administradores de cuentas pueden programar la frecuencia de la ventana de mantenimiento, la fecha de inicio y la hora de inicio. Aplica a la computación clásica (clústeres, pools, almacenes SQL clásicos, servidor de modelos heredado); No se aplica a la computación sin servidor. Activar esta función añade el complemento de Seguridad y Cumplimiento Mejorado y requiere el nivel de precios Premium.
Plataformas de colaboración permitidas collaboration_platform_connectivity Controla qué plataformas de colaboración externas (Slack y/o Microsoft Teams) pueden conectarse a este espacio de trabajo. Por defecto es ALLOW_ALL.
Permitir mensajes públicos en plataformas de colaboración collaboration_platform_message_visibility Cuando está activado, los usuarios pueden elegir si las respuestas de la app Databricks en Slack o Microsoft Teams son visibles para el canal. Cuando se desactiva, todas las respuestas se obligan a ser privadas para el usuario que solicita.
Acceso al espacio de trabajo para el personal de Databricks customerApprovedWSLoginExpirationTime Un momento específico tras el cual el personal de Databricks puede dejar de iniciar sesión en tu espacio de trabajo. El tiempo se formatea como YYYY-MM-DDTHH:MM:SSZ. Puedes desactivar completamente el acceso configurándolo con una marca de tiempo en el pasado, como 1998-01-01T00:00:00.000Z. Habilitar el acceso indefinidamente usando una cadena vacía o el valor indefiniteespecial .
Espacio de nombres predeterminado default_namespace_ws La API predeterminada de configuración de espacio de nombres permite a los usuarios configurar el espacio de nombres predeterminado para un espacio de trabajo de Databricks.
Desactivar el acceso heredado disable_legacy_access 'Desactivar el acceso heredado' tiene los siguientes impactos: 1. Desactiva el acceso directo a las Metastores Colmena desde el espacio de trabajo (el acceso a través de la federación de Metastores Colmena no se ve afectado). 2. Deshabilita el modo de respaldo en el acceso a ubicaciones externas desde el área de trabajo. 3. Desactiva Databricks Versiones de ejecución anteriores a 13.3LTS. Importante: esta opción no puede activarse mientras el catálogo predeterminado del espacio de trabajo esté configurado como catálogo heredado (hive_metastore o spark_catalog). Cambia primero el catálogo predeterminado a un catálogo de Unity Catalog.
Deshabilitar la raíz y los montajes de DBFS disable_legacy_dbfs Desactivar el DBFS heredado tiene las siguientes dos implicaciones: 1. No se permite el acceso a las monturas raíz y DBFS de DBFS (así como la creación de nuevas monturas). 2. Desactiva Databricks Versiones de ejecución anteriores a 13.3LTS. Cuando la configuración está desactivada, toda la funcionalidad de DBFS está habilitada y no se imponen restricciones en las versiones de tiempo de ejecución de Databricks. Esta configuración puede tardar hasta 20 minutos en hacer efecto y requiere reiniciar manualmente los clústeres de cómputo multiusos y los almacenes SQL.
Habilitar tipos de nodos autoflexibles enableAutoNodeTypeFlexibility Cuando está habilitado, los clústeres de este espacio de trabajo pueden lanzarse automáticamente en tipos de nodos alternativos cuando el tipo solicitado no está disponible, mejorando la fiabilidad del lanzamiento durante la escasez de capacidad.
Hacer cumplir Unity Gateway enforce_ai_gateway_v3_only Controla si todo el acceso a los modelos de fundación debe pasar por Unity Gateway. Cuando está habilitado, los permisos de acceso al modelo, los presupuestos de IA y las políticas de seguridad se gestionan de forma centralizada con Unity Gateway, y todo el tráfico del modelo de fundación debe pasar a través de él. El modelo de fundación heredado que sirve a los endpoints que evitan Unity Gateway rechaza el tráfico.
Solo permitir despliegues de aplicaciones desde Git enforceGitAppDeployments Cuando están habilitadas, las aplicaciones en este espacio de trabajo solo pueden desplegarse desde Git.
Características de IA impulsadas por socios llm_proxy_partner_powered Determina si los modelos impulsados por socios están habilitados o no. Esta configuración está disponible tanto a nivel de cuenta como de espacio de trabajo
Misión Crítica mission_critical Ofrece los más altos niveles de resiliencia operativa y seguridad para cargas de trabajo críticas. Incluye recuperación ante desastres y mejora de la seguridad y el cumplimiento.
Permitir que los repositorios exporten la salida de IPYNB reposIpynbResultsExportPermissions Controla si los usuarios pueden comprometer las salidas de notebooks .ipynb en repositorios Git remotos en el espacio de trabajo.
Restringir administradores de espacios de trabajo restrict_workspace_admins La configuración Restringir administradores del área de trabajo le permite controlar las funcionalidades de los administradores del área de trabajo. Con el estado de configuración configurado en ALLOW_ALL, los administradores del espacio de trabajo pueden crear tokens de acceso personales para el principal de servicio en nombre de cualquier principal de servicio en su espacio de trabajo. Los administradores del área de trabajo también pueden cambiar el propietario de una tarea a cualquier usuario de su área de trabajo. Y pueden cambiar la configuración run_as el trabajo a cualquier usuario en su espacio de trabajo o a un principal de servicio en el que tengan el rol de Usuario Principal de Servicio. Con el estado de configuración configurado en RESTRICT_TOKENS_AND_JOB_RUN_AS, los administradores de espacio de trabajo solo pueden crear tokens de acceso personales en nombre de los responsables de servicio en los que tienen el rol de Usuario Principal de Servicio. Solo pueden cambiar el propietario de un trabajo a sí mismos. Y pueden cambiar el puesto run_as la configuración para ellos mismos o para un principal de servicio en el que tengan el rol de Usuario Principal del Servicio.
Perfil de seguridad de cumplimiento shield_csp_enablement_ws_db Controla si el perfil de seguridad de cumplimiento está habilitado para este espacio de trabajo. El perfil de seguridad de cumplimiento proporciona una línea base altamente segura (monitorización adicional, una imagen de cómputo reforzada, tipos de instancias reforzados para cifrado entre nodos y otros controles) que facilita el cumplimiento y la gestión de los estándares de cumplimiento aplicables. Activarlo también permite de forma permanente una monitorización de seguridad mejorada y la actualización automática del clúster en el espacio de trabajo, además de añadir el complemento de Seguridad y Cumplimiento Mejorados.
Supervisión de seguridad mejorada shield_esm_enablement_ws_db Controla si la monitorización de seguridad mejorada está habilitada para este espacio de trabajo. La monitorización de seguridad mejorada proporciona una imagen de cómputo reforzada y agentes adicionales de monitorización de seguridad (monitorización de la integridad de archivos, antivirus y escaneo de vulnerabilidades) que generan filas de registro revisables. Se aplica solo a recursos clásicos de plano de cálculo, no a serverless. Si el perfil de seguridad de cumplimiento está activado en el espacio de trabajo, esta configuración se aplica de forma permanente.
Etiqueta del espacio de trabajo workspace_label Una etiqueta personalizada y una insignia de color se muestran junto al nombre del espacio de trabajo en la navegación superior de la consola de Databricks. Los administradores de espacios de trabajo pueden usar esta configuración para distinguir visualmente los espacios de trabajo entre entornos. El valor es un objeto con un label campo (cadena de texto) y un color campo (uno de: coral, lemon, lime, turquoise, indigopurple, , ). pink Ambos campos son cadenas vacías cuando no se establece ninguna etiqueta.

Preferencias de usuario

Configuraciones que se aplican a un usuario dentro de una cuenta.

Setting Nombre de clave Description
Crear automáticamente la interacción de sesión en el editor autoCreateSessionOnEditorInteraction Controla si una sesión se crea automáticamente al interactuar con el editor.
Lanzamiento y acoplamiento automáticos autoLaunchAndAttach Controla si los portátiles se inician y conectan automáticamente a los clústeres.
Confirmar eliminación de comandos confirmCommandDelete Controla si es necesaria confirmación antes de eliminar un comando.
Crear nuevos recursos en la carpeta Borradores createNewAssetsInDraftsFolder Controla si se crean nuevos recursos en la carpeta de borradores.
Databricks Unified SQL Editor crea y convierte consultas en Open Pref databricks-unified-sql-editor-create-and-convert-queries-on-open-pref Controla el comportamiento de creación y conversión de consultas en el editor SQL unificado.
Unidad de sangría de Python por defecto defaultPythonIndentUnit Controla la unidad de sangría de Python por defecto. Valores permitidos: 2, 4, o '' (cadena vacía por defecto).
Tema oscuro personalizado del editor editorCustomDarkTheme Controla el tema oscuro personalizado del editor. Valores permitidos: defaultTheme, Atom-One-Dark, Ayu-Dark, Blackboard, Dracula, GitHub-DarkMonokai, , One-Dark-Pro, , . Winter-is-Coming-Dark
Tema de luces personalizado del editor editorCustomLightTheme Controla el tema de luces personalizado para el editor. Valores permitidos: defaultTheme, Active4D, Atom-One-Light, Ayu-LightGitHub-Light, , Tomorrow, . Winter-is-Coming-Light
Tamaño de fuente del editor editorFontSize Controla el tamaño de la fuente en el editor. Valores permitidos: rango entero de 10 a 30.
Activar la Solución Rápida Automática en Línea enableAutoInlineQuickFix Se sugieren automáticamente si se sugieren soluciones rápidas en línea.
Activar la solución rápida automática en línea Optar por no enableAutoInlineQuickFixOptOut Control de exclusión para soluciones rápidas automáticas en línea.
Activar el diagnóstico automático de desencadenantes enableAutoTriggerDiagnose Controla si los diagnósticos se activan automáticamente.
Activar el diagnóstico automático de desencadenantes Excluir enableAutoTriggerDiagnoseOptOut Control de exclusión para diagnósticos automáticos.
Habilitar disposición centrada enableCenteredLayout Controla si el editor utiliza un diseño centrado.
Activar accesos directos clásicos enableClassicShortcuts Controla el modo de atajos de teclado. Valores permitidos: default, classic.
Activar los números de comando enableCommandNumbers Controla si los números de comando se muestran en los cuadernos.
Activa las finalizaciones mientras escribes enableCompletionsAsYouType Controla si aparecen sugerencias de autocompletado mientras escribes.
Activar el parpadeo del cursor enableCursorBlink Controla si el cursor parpadea en el editor.
Activar el modo oscuro enableDarkMode Controla el modo temático. Valores permitidos: light, dark y system.
Activar Enter acepta sugerencias enableEnterAcceptsSuggestions Controla si pulsar Enter acepta sugerencias de autocompletado.
Activar el paso del cursor para el editor enableHoverForEditor Controla si se muestra en el editor si se muestra una descripción emergente al pasar el cursor.
Activa la sugerencia en línea mientras escribes Optar por no enableInlineSuggestionAsYouTypeOptOut Elimina el control para sugerencias en línea mientras escribes.
Habilitar números de línea enableLineNumbers Controla si los números de línea se muestran en el editor.
Habilitar números de línea v2 enableLineNumbersV2 Controla si los números de línea se muestran en el editor (v2).
Habilitar Line Wrap enableLineWrap Determina si el texto se envuelve a la siguiente línea en el editor.
Activar el cursor múltiple de Mónaco enableMonacoMultiCursor Controla la tecla modificadora multicursor. Valores permitidos: alt, ctrlCmd.
Activar la Exclusión del Depurador de Notebook enableNotebookDebuggerOptOut Control de exclusión para el depurador de notebook.
Activar el interruptor de observabilidad sin servidor enableServerlessObservabilityToggle El usuario opta por Mejorada Observabilidad Serverless en los Trabajos cuando la vista previa del espacio de trabajo está activada.
Activar estadísticas de Mostrar comandos en la nueva interfaz de celda enableShowCommandStatsInNewCellUi Controla si las estadísticas de comandos se muestran en la nueva interfaz de celdas.
Habilitar títulos de celdas promocionadas para mostrar enableShowPromotedCellTitles Controla si se muestran los títulos de celdas promovidos.
Habilitar presupuestos inteligentes enableSmartQuotes Controla si las cotizaciones inteligentes están activadas en el editor.
Activar pestañas suaves para cuadernos y archivos enableSoftTabsForNotebooksAndFiles Controla si las tabulaciones se convierten en espacios en cuadernos y archivos.
Activar el resaltado de errores de sintaxis SQL enableSqlSyntaxErrorHighlighting Controla si los errores de sintaxis SQL están resaltados.
Activar el cambio al modo comando tras la ejecución enableSwitchToCommandModeAfterExecution Controla si el editor cambia a modo comando tras la ejecución de la celda.
Activar el Explorador Unificado de Árbol de Archivos enableUnifiedFileTreeExplorer Controla si el explorador unificado del árbol de archivos está habilitado.
Enfoque enableUnifiedSchemaBrowserTreeExplorer Controla si el explorador unificado del navegador de esquemas está habilitado.
Habilitar el Vega Lite Renderer enableVegaLiteRenderer Controla si el renderizador de Vega-Lite está habilitado para visualizaciones.
Activar la opción de desactivación del renderizador Vega Lite enableVegaLiteRendererOptOut Control de exclusión para el renderizador de Vega-Lite.
Activar la etiqueta de vista previa del renderizador Vega Lite enableVegaLiteRendererPreviewTag Controla si se muestra la etiqueta de vista previa del Vega-Lite renderizador.
Panel inferior extendido extendedBottomPanel Controla si se muestra el panel inferior extendido.
Nuevo oleoductos de Lakeflow Monitorizando la interfaz lakeflowNewPipelinesMonitoringUi Controla si la nueva interfaz de monitorización de las tuberías Lakeflow está activada.
Formato de exportación predeterminado del cuaderno notebookDefaultExportFormat Controla el formato de exportación predeterminado para los cuadernos. Valores permitidos: SOURCE, JUPYTER.
Modo de acceso directo de flecha de opción optionArrowShortcutMode Controla el comportamiento de los atajos de teclado Opción+flecha. Valores permitidos: navigate, move.
Autoría multiarchivo en canaletas pipelinesMultifileAuthoring Controla si la autoría multiarchivo está habilitada para las canalizaciones.
Enviar comentarios Notificaciones por correo electrónico sendCommentEmailNotifications Controla si se envían notificaciones por correo electrónico para los comentarios.
Minimapa de ejecución de celda de mostrar showCellExecutionMinimap Controla si se muestra el minimapa de ejecución de celdas.
Prompt de mostrar pip al panel de entorno showPipToEnvironmentPanelPrompt Controla si mostrar pip al indicador del panel de entorno.
Asesor de Show Spark showSparkAdvisor Controla si se muestran sugerencias de optimización de Spark.
Consejos para mostrar error de chispa showSparkErrorTips Controla si se muestran consejos útiles para errores de Spark.
El usuario activa el resaltado de errores en formato Python userActivatesPythonFormatErrorHighlighting Controla si se resaltan los errores de formato en Python.
El usuario activa error de sintaxis de Python Resalta Optar por no userActivatesPythonSyntaxErrorHighlightingOptOut Control de exclusión para el resaltado de errores de sintaxis en Python.
El usuario activa la comprobación de tipos de Python userActivatesPythonTypeChecking Controla si la comprobación de tipos de Python está habilitada.
El usuario activa la restauración de instantáneas userActivatesSnapshotRestore Controla si la funcionalidad de restauración de instantáneas está activada.
Límite predeterminado 1000 para consultas nuevas usqleDefaultQueryAutoLimit Controla el límite automático por defecto para consultas SQL en el editor.

Recursos adicionales

  • Se actualizó por última vez el