Compartir a través de


Áreas de trabajo de Microsoft.Databricks 2025-10-01-preview

Definición de recursos de Bicep

El tipo de recurso workspaces se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Databricks/workspaces, agregue lo siguiente a la plantilla de Bicep.

resource symbolicname 'Microsoft.Databricks/workspaces@2025-10-01-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    accessConnector: {
      id: 'string'
      identityType: 'string'
      userAssignedIdentityId: 'string'
    }
    authorizations: [
      {
        principalId: 'string'
        roleDefinitionId: 'string'
      }
    ]
    computeMode: 'string'
    createdBy: {}
    defaultCatalog: {
      initialName: 'string'
      initialType: 'string'
    }
    defaultStorageFirewall: 'string'
    encryption: {
      entities: {
        managedDisk: {
          keySource: 'string'
          keyVaultProperties: {
            keyName: 'string'
            keyVaultUri: 'string'
            keyVersion: 'string'
          }
          rotationToLatestKeyVersionEnabled: bool
        }
        managedServices: {
          keySource: 'string'
          keyVaultProperties: {
            keyName: 'string'
            keyVaultUri: 'string'
            keyVersion: 'string'
          }
        }
      }
    }
    enhancedSecurityCompliance: {
      automaticClusterUpdate: {
        value: 'string'
      }
      complianceSecurityProfile: {
        complianceStandards: [
          'string'
        ]
        value: 'string'
      }
      enhancedSecurityMonitoring: {
        value: 'string'
      }
    }
    managedDiskIdentity: {}
    managedResourceGroupId: 'string'
    parameters: {
      amlWorkspaceId: {
        type: 'string'
        value: 'string'
      }
      customPrivateSubnetName: {
        type: 'string'
        value: 'string'
      }
      customPublicSubnetName: {
        type: 'string'
        value: 'string'
      }
      customVirtualNetworkId: {
        type: 'string'
        value: 'string'
      }
      enableNoPublicIp: {
        type: 'string'
        value: bool
      }
      encryption: {
        type: 'string'
        value: {
          KeyName: 'string'
          keySource: 'string'
          keyvaulturi: 'string'
          keyversion: 'string'
        }
      }
      loadBalancerBackendPoolName: {
        type: 'string'
        value: 'string'
      }
      loadBalancerId: {
        type: 'string'
        value: 'string'
      }
      natGatewayName: {
        type: 'string'
        value: 'string'
      }
      prepareEncryption: {
        type: 'string'
        value: bool
      }
      publicIpName: {
        type: 'string'
        value: 'string'
      }
      requireInfrastructureEncryption: {
        type: 'string'
        value: bool
      }
      storageAccountName: {
        type: 'string'
        value: 'string'
      }
      storageAccountSkuName: {
        type: 'string'
        value: 'string'
      }
      vnetAddressPrefix: {
        type: 'string'
        value: 'string'
      }
    }
    publicNetworkAccess: 'string'
    requiredNsgRules: 'string'
    storageAccountIdentity: {}
    uiDefinitionUri: 'string'
    updatedBy: {}
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Microsoft.Databricks/workspaces

Nombre Description Importancia
location Ubicación geográfica donde reside el recurso cadena (obligatoria)
nombre El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 64 (obligatorio)
Propiedades Propiedades del área de trabajo. WorkspaceProperties (obligatorio)
scope Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
sku SKU del recurso. Sku
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas

AutomaticClusterUpdateDefinition

Nombre Description Importancia
value 'Disabled'
'Enabled'

ComplianceSecurityProfileDefinition

Nombre Description Importancia
Normas de cumplimiento Estándares de cumplimiento asociados al área de trabajo. string[]
value 'Disabled'
'Enabled'

CreatedBy

Nombre Description Importancia

DefaultCatalogProperties

Nombre Description Importancia
initialName Especifica el nombre inicial del catálogo predeterminado. Si no se especifica, se usará el nombre del área de trabajo. cuerda / cadena
initialType Define el tipo inicial del catálogo predeterminado. Valores posibles (sin distinción entre mayúsculas y minúsculas): HiveMetastore, UnityCatalog 'HiveMetastore'
'Catálogo de Unidad'

Encryption

Nombre Description Importancia
Nombre de clave Nombre de la clave KeyVault. cuerda / cadena
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Predeterminado, Microsoft.Keyvault 'Default'
"Microsoft.Keyvault"
keyvaulturi Uri de KeyVault. cuerda / cadena
keyversion Versión de la clave KeyVault. cuerda / cadena

EncryptionEntitiesDefinition

Nombre Description Importancia
managedDisk Propiedades de cifrado de los discos administrados de Databricks. No se permite en el área de trabajo Serverless ComputeMode. ManagedDiskEncryption
Servicios gestionados Propiedades de cifrado para los servicios administrados de Databricks. Compatible con ComputeMode híbrido y sin servidor. encryptionV2

CifradoV2

Nombre Description Importancia
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault 'Microsoft.Keyvault' (obligatorio)
keyVaultProperties Propiedades de entrada de Key Vault para el cifrado. CifradoV2KeyVaultProperties

CifradoV2KeyVaultProperties

Nombre Description Importancia
keyName Nombre de la clave KeyVault. cadena (obligatoria)
keyVaultUri Uri de KeyVault. cadena (obligatoria)
keyVersion Versión de la clave KeyVault. cadena (obligatoria)

EnhancedSecurityComplianceDefinition

Nombre Description Importancia
automaticClusterUpdate Estado de la característica de actualizaciones automatizadas del clúster. AutomaticClusterUpdateDefinition
complianceSecurityProfile Estado de la característica Perfil de seguridad de cumplimiento. complianceSecurityProfileDefinition
enhancedSecurityMonitoring Estado de la característica Supervisión de seguridad mejorada. enhancedSecurityMonitoringDefinition

EnhancedSecurityMonitoringDefinition

Nombre Description Importancia
value 'Disabled'
'Enabled'

ManagedDiskEncryption

Nombre Description Importancia
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault. No se permite en el área de trabajo Serverless ComputeMode. 'Microsoft.Keyvault' (obligatorio)
keyVaultProperties Propiedades de entrada de Key Vault para el cifrado. managedDiskEncryptionKeyVaultProperties (obligatorio)
rotationToLatestKeyVersionEnabled Indique si la versión de clave más reciente se debe usar automáticamente para Managed Disk Encryption. bool

ManagedDiskEncryptionKeyVaultProperties

Nombre Description Importancia
keyName Nombre de la clave KeyVault. cadena (obligatoria)
keyVaultUri Identificador URI de KeyVault. cadena (obligatoria)
keyVersion Versión de la clave KeyVault. cadena (obligatoria)

ManagedIdentityConfiguration

Nombre Description Importancia

Sku

Nombre Description Importancia
nombre Nombre de la SKU. cadena (obligatoria)
nivel Nivel de SKU. cuerda / cadena

TrackedResourceTags

Nombre Description Importancia

WorkspaceCustomBooleanParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. bool (obligatorio)

WorkspaceCustomParameters

Nombre Description Importancia
amlWorkspaceId Identificador de un área de trabajo de Azure Machine Learning que se va a vincular con el área de trabajo de Databricks. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customPrivateSubnetName Nombre de la subred privada dentro de la red virtual. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customPublicSubnetName Nombre de una subred pública dentro de la red virtual. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customVirtualNetworkId Identificador de una red virtual en la que se debe crear este clúster de Databricks. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
enableNoPublicIp Boolean que indica si se debe deshabilitar la dirección IP pública. El valor predeterminado es true. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceNoPublicIPBooleanParameter
encryption Contiene los detalles de cifrado del área de trabajo habilitada para Customer-Managed Key (CMK). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceEncryptionParameter
loadBalancerBackendPoolName Nombre del grupo de back-end del equilibrador de carga saliente para la conectividad segura del clúster (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
loadBalancerId URI de recursos del equilibrador de carga saliente para el área de trabajo Conectividad de clúster segura (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
natGatewayName Nombre de la puerta de enlace NAT para las subredes del área de trabajo conectividad de clúster segura (sin ip pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
prepareEncryption Prepare el área de trabajo para el cifrado. Habilita la identidad administrada para la cuenta de almacenamiento administrada. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomBooleanParameter
publicIpName Nombre de la dirección IP pública para el área de trabajo Sin dirección IP pública con red virtual administrada. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
requireInfrastructureEncryption Valor booleano que indica si el sistema de archivos raíz de DBFS se habilitará o no con la capa secundaria de cifrado con claves administradas por la plataforma para los datos en reposo. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomBooleanParameter
storageAccountName Nombre predeterminado de la cuenta de almacenamiento de DBFS. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
storageAccountSkuName Nombre de la SKU de la cuenta de almacenamiento, por ejemplo: Standard_GRS, Standard_LRS. Consulte https://aka.ms/storageskus para obtener entradas válidas. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
vnetAddressPrefix Prefijo de dirección de la red virtual administrada. El valor predeterminado de esta entrada es 10.139. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter

WorkspaceCustomStringParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. cadena (obligatoria)

WorkspaceEncryptionParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. Cifrado

WorkspaceNoPublicIPBooleanParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. bool (obligatorio)

WorkspaceProperties (Propiedades del espacio de trabajo)

Nombre Description Importancia
accessConnector Recurso de conector de acceso que se va a asociar a Databricks Workspace. No se permite en el área de trabajo Serverless ComputeMode. WorkspacePropertiesAccessConnector
authorizations Las autorizaciones del proveedor del área de trabajo. workspaceProviderAuthorization[]
computeMode El modo de proceso del área de trabajo. Obligatorio en la creación, no se puede cambiar. Los valores posibles incluyen: 'Sin servidor', 'Híbrido' "Híbrido"
'Sin servidor' (obligatorio)
createdBy Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que creó el área de trabajo. CreatedBy
defaultCatalog Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo. No se permite en el área de trabajo Serverless ComputeMode. DefaultCatalogProperties
defaultStorageFirewall Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento. No se permite en el área de trabajo Serverless ComputeMode. 'Disabled'
'Enabled'
encryption Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode. WorkspacePropertiesEncryption
enhancedSecurityCompliance Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode. enhancedSecurityComplianceDefinition
managedDiskIdentity Los detalles de la identidad administrada del conjunto de cifrado de disco utilizado para el cifrado de disco administrado. Solo se devuelve en el área de trabajo Hybrid ComputeMode. managedIdentityConfiguration
managedResourceGroupId Id. de grupo de recursos administrado. Requerido en el área de trabajo Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. cuerda / cadena
parameters Parámetros personalizados del área de trabajo. WorkspaceCustomParameters
publicNetworkAccess Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link. Se usa para configurar el vínculo privado solo front-end para el área de trabajo ComputeMode sin servidor. 'Disabled'
'Enabled'
requiredNsgRules Obtiene o establece un valor que indica si el plano de datos (clústeres) para controlar la comunicación del plano se produce a través del punto de conexión privado. Los valores admitidos son "AllRules" y "NoAzureDatabricksRules". El valor "NoAzureServiceRules" es solo para uso interno. No se permite en el área de trabajo Serverless ComputeMode. 'Todas las reglas'
'NoAzureDatabricksRules'
'NoAzureServiceRules'
storageAccountIdentity Los detalles de la identidad administrada de la cuenta de almacenamiento. Solo se devuelve en el área de trabajo Hybrid ComputeMode. managedIdentityConfiguration
uiDefinitionUri Identificador URI del blob donde se encuentra el archivo de definición de la interfaz de usuario. cuerda / cadena
actualizadoPor Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que actualizaron por última vez el área de trabajo. CreatedBy

WorkspacePropertiesAccessConnector

Nombre Description Importancia
id El identificador de recurso del recurso del conector de Azure Databricks Access. cadena (obligatoria)
identityType Tipo de identidad del recurso del conector de Access. 'SystemAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentityId Identificador de recurso de la identidad asignada por el usuario asociada al recurso del conector de Access. Esto es necesario para el tipo "UserAssigned" y no es válido para el tipo "SystemAssigned". cuerda / cadena

WorkspacePropertiesEncryption

Nombre Description Importancia
entidades Definición de entidades de cifrado para el área de trabajo. EncryptionEntitiesDefinition (obligatorio)

WorkspaceProviderAuthorization

Nombre Description Importancia
principalId Identificador principal del proveedor. Esta es la identidad que usará el proveedor para llamar a ARM para administrar los recursos del área de trabajo. string

Constraints:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (obligatorio)
roleDefinitionId Identificador de definición de rol del proveedor. Este rol definirá todos los permisos que el proveedor debe tener en el grupo de recursos de contenedor del área de trabajo. Esta definición de rol no puede tener permiso para eliminar el grupo de recursos. string

Constraints:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (obligatorio)

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Description
área de trabajo de Azure Databricks Módulo de recursos de AVM para el área de trabajo de Azure Databricks

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Description
azure Databricks All-in-one Templat VNetInjection-Pvtendpt Esta plantilla le permite crear un grupo de seguridad de red, una red virtual y un área de trabajo de Azure Databricks con la red virtual y un punto de conexión privado.
área de trabajo de Azure Databricks con de intervalo de direcciones personalizados Esta plantilla le permite crear un área de trabajo de Azure Databricks con un intervalo de direcciones de red virtual personalizado.
área de trabajo de Azure Databricks con de inyección de red virtual Esta plantilla permite crear un área de trabajo de Azure Databricks con una red virtual personalizada.
plantilla de AzureDatabricks para el firewall de almacenamiento predeterminado Esta plantilla permite crear un grupo de seguridad de red, una red virtual, un punto de conexión privado y un firewall de almacenamiento predeterminado habilitado para el área de trabajo de Azure Databricks con la red virtual y el conector de acceso asignado por el sistema.
plantilla de AzureDatabricks para la inyección de red virtual con nat Gateway Esta plantilla le permite crear una puerta de enlace NAT, un grupo de seguridad de red, una red virtual y un área de trabajo de Azure Databricks con la red virtual.
plantilla de AzureDatabricks para VNetInjection y Load Balancer Esta plantilla permite crear un equilibrador de carga, un grupo de seguridad de red, una red virtual y un área de trabajo de Azure Databricks con la red virtual.
Implementación de un área de trabajo de Azure Databricks Esta plantilla le permite crear un área de trabajo de Azure Databricks.
Implementación de un área de trabajo de Azure Databricks con todas las tres formas de CMK Esta plantilla permite crear un área de trabajo de Azure Databricks con servicios administrados y CMK con cifrado DBFS.
Implementación de un área de trabajo de Azure Databricks con Managed Disks CMK Esta plantilla le permite crear un área de trabajo de Azure Databricks con Managed Disks CMK.
Implementación de un WS de Azure Databricks con CMK para el cifrado DBFS Esta plantilla le permite crear un área de trabajo de Azure Databricks con CMK para el cifrado raíz de DBFS.
Implementación del área de trabajo de Azure Databricks con managed Services CMK Esta plantilla le permite crear un área de trabajo de Azure Databricks con Managed Services CMK.
Implementación de Sports Analytics en la arquitectura de Azure Crea una cuenta de Azure Storage con ADLS Gen 2 habilitado, una instancia de Azure Data Factory con servicios vinculados para la cuenta de almacenamiento (una instancia de Azure SQL Database si se implementa) y una instancia de Azure Databricks. AAD identity for the user deploying the template and the managed identity for the ADF instance will be granted the Storage Blob Data Contributor role on the storage account. También hay opciones para implementar una instancia de Azure Key Vault, una instancia de Azure SQL Database y un centro de eventos de Azure (para casos de uso de streaming). Cuando se implementa una instancia de Azure Key Vault, a la identidad administrada de Data Factory y a la identidad de AAD para el usuario que implementa la plantilla se le concederá el rol De usuario secretos de Key Vault.

Definición de recursos de plantilla de ARM

El tipo de recurso workspaces se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Databricks/workspaces, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Databricks/workspaces",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "accessConnector": {
      "id": "string",
      "identityType": "string",
      "userAssignedIdentityId": "string"
    },
    "authorizations": [
      {
        "principalId": "string",
        "roleDefinitionId": "string"
      }
    ],
    "computeMode": "string",
    "createdBy": {
    },
    "defaultCatalog": {
      "initialName": "string",
      "initialType": "string"
    },
    "defaultStorageFirewall": "string",
    "encryption": {
      "entities": {
        "managedDisk": {
          "keySource": "string",
          "keyVaultProperties": {
            "keyName": "string",
            "keyVaultUri": "string",
            "keyVersion": "string"
          },
          "rotationToLatestKeyVersionEnabled": "bool"
        },
        "managedServices": {
          "keySource": "string",
          "keyVaultProperties": {
            "keyName": "string",
            "keyVaultUri": "string",
            "keyVersion": "string"
          }
        }
      }
    },
    "enhancedSecurityCompliance": {
      "automaticClusterUpdate": {
        "value": "string"
      },
      "complianceSecurityProfile": {
        "complianceStandards": [ "string" ],
        "value": "string"
      },
      "enhancedSecurityMonitoring": {
        "value": "string"
      }
    },
    "managedDiskIdentity": {
    },
    "managedResourceGroupId": "string",
    "parameters": {
      "amlWorkspaceId": {
        "type": "string",
        "value": "string"
      },
      "customPrivateSubnetName": {
        "type": "string",
        "value": "string"
      },
      "customPublicSubnetName": {
        "type": "string",
        "value": "string"
      },
      "customVirtualNetworkId": {
        "type": "string",
        "value": "string"
      },
      "enableNoPublicIp": {
        "type": "string",
        "value": "bool"
      },
      "encryption": {
        "type": "string",
        "value": {
          "KeyName": "string",
          "keySource": "string",
          "keyvaulturi": "string",
          "keyversion": "string"
        }
      },
      "loadBalancerBackendPoolName": {
        "type": "string",
        "value": "string"
      },
      "loadBalancerId": {
        "type": "string",
        "value": "string"
      },
      "natGatewayName": {
        "type": "string",
        "value": "string"
      },
      "prepareEncryption": {
        "type": "string",
        "value": "bool"
      },
      "publicIpName": {
        "type": "string",
        "value": "string"
      },
      "requireInfrastructureEncryption": {
        "type": "string",
        "value": "bool"
      },
      "storageAccountName": {
        "type": "string",
        "value": "string"
      },
      "storageAccountSkuName": {
        "type": "string",
        "value": "string"
      },
      "vnetAddressPrefix": {
        "type": "string",
        "value": "string"
      }
    },
    "publicNetworkAccess": "string",
    "requiredNsgRules": "string",
    "storageAccountIdentity": {
    },
    "uiDefinitionUri": "string",
    "updatedBy": {
    }
  },
  "sku": {
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Microsoft.Databricks/workspaces

Nombre Description Importancia
apiVersion La versión de api '2025-10-01-preview'
location Ubicación geográfica donde reside el recurso cadena (obligatoria)
nombre El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 64 (obligatorio)
Propiedades Propiedades del área de trabajo. WorkspaceProperties (obligatorio)
sku SKU del recurso. Sku
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas
type El tipo de recurso "Microsoft.Databricks/workspaces"

AutomaticClusterUpdateDefinition

Nombre Description Importancia
value 'Disabled'
'Enabled'

ComplianceSecurityProfileDefinition

Nombre Description Importancia
Normas de cumplimiento Estándares de cumplimiento asociados al área de trabajo. string[]
value 'Disabled'
'Enabled'

CreatedBy

Nombre Description Importancia

DefaultCatalogProperties

Nombre Description Importancia
initialName Especifica el nombre inicial del catálogo predeterminado. Si no se especifica, se usará el nombre del área de trabajo. cuerda / cadena
initialType Define el tipo inicial del catálogo predeterminado. Valores posibles (sin distinción entre mayúsculas y minúsculas): HiveMetastore, UnityCatalog 'HiveMetastore'
'Catálogo de Unidad'

Encryption

Nombre Description Importancia
Nombre de clave Nombre de la clave KeyVault. cuerda / cadena
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Predeterminado, Microsoft.Keyvault 'Default'
"Microsoft.Keyvault"
keyvaulturi Uri de KeyVault. cuerda / cadena
keyversion Versión de la clave KeyVault. cuerda / cadena

EncryptionEntitiesDefinition

Nombre Description Importancia
managedDisk Propiedades de cifrado de los discos administrados de Databricks. No se permite en el área de trabajo Serverless ComputeMode. ManagedDiskEncryption
Servicios gestionados Propiedades de cifrado para los servicios administrados de Databricks. Compatible con ComputeMode híbrido y sin servidor. encryptionV2

CifradoV2

Nombre Description Importancia
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault 'Microsoft.Keyvault' (obligatorio)
keyVaultProperties Propiedades de entrada de Key Vault para el cifrado. CifradoV2KeyVaultProperties

CifradoV2KeyVaultProperties

Nombre Description Importancia
keyName Nombre de la clave KeyVault. cadena (obligatoria)
keyVaultUri Uri de KeyVault. cadena (obligatoria)
keyVersion Versión de la clave KeyVault. cadena (obligatoria)

EnhancedSecurityComplianceDefinition

Nombre Description Importancia
automaticClusterUpdate Estado de la característica de actualizaciones automatizadas del clúster. AutomaticClusterUpdateDefinition
complianceSecurityProfile Estado de la característica Perfil de seguridad de cumplimiento. complianceSecurityProfileDefinition
enhancedSecurityMonitoring Estado de la característica Supervisión de seguridad mejorada. enhancedSecurityMonitoringDefinition

EnhancedSecurityMonitoringDefinition

Nombre Description Importancia
value 'Disabled'
'Enabled'

ManagedDiskEncryption

Nombre Description Importancia
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault. No se permite en el área de trabajo Serverless ComputeMode. 'Microsoft.Keyvault' (obligatorio)
keyVaultProperties Propiedades de entrada de Key Vault para el cifrado. managedDiskEncryptionKeyVaultProperties (obligatorio)
rotationToLatestKeyVersionEnabled Indique si la versión de clave más reciente se debe usar automáticamente para Managed Disk Encryption. bool

ManagedDiskEncryptionKeyVaultProperties

Nombre Description Importancia
keyName Nombre de la clave KeyVault. cadena (obligatoria)
keyVaultUri Identificador URI de KeyVault. cadena (obligatoria)
keyVersion Versión de la clave KeyVault. cadena (obligatoria)

ManagedIdentityConfiguration

Nombre Description Importancia

Sku

Nombre Description Importancia
nombre Nombre de la SKU. cadena (obligatoria)
nivel Nivel de SKU. cuerda / cadena

TrackedResourceTags

Nombre Description Importancia

WorkspaceCustomBooleanParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. bool (obligatorio)

WorkspaceCustomParameters

Nombre Description Importancia
amlWorkspaceId Identificador de un área de trabajo de Azure Machine Learning que se va a vincular con el área de trabajo de Databricks. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customPrivateSubnetName Nombre de la subred privada dentro de la red virtual. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customPublicSubnetName Nombre de una subred pública dentro de la red virtual. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customVirtualNetworkId Identificador de una red virtual en la que se debe crear este clúster de Databricks. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
enableNoPublicIp Boolean que indica si se debe deshabilitar la dirección IP pública. El valor predeterminado es true. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceNoPublicIPBooleanParameter
encryption Contiene los detalles de cifrado del área de trabajo habilitada para Customer-Managed Key (CMK). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceEncryptionParameter
loadBalancerBackendPoolName Nombre del grupo de back-end del equilibrador de carga saliente para la conectividad segura del clúster (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
loadBalancerId URI de recursos del equilibrador de carga saliente para el área de trabajo Conectividad de clúster segura (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
natGatewayName Nombre de la puerta de enlace NAT para las subredes del área de trabajo conectividad de clúster segura (sin ip pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
prepareEncryption Prepare el área de trabajo para el cifrado. Habilita la identidad administrada para la cuenta de almacenamiento administrada. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomBooleanParameter
publicIpName Nombre de la dirección IP pública para el área de trabajo Sin dirección IP pública con red virtual administrada. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
requireInfrastructureEncryption Valor booleano que indica si el sistema de archivos raíz de DBFS se habilitará o no con la capa secundaria de cifrado con claves administradas por la plataforma para los datos en reposo. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomBooleanParameter
storageAccountName Nombre predeterminado de la cuenta de almacenamiento de DBFS. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
storageAccountSkuName Nombre de la SKU de la cuenta de almacenamiento, por ejemplo: Standard_GRS, Standard_LRS. Consulte https://aka.ms/storageskus para obtener entradas válidas. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
vnetAddressPrefix Prefijo de dirección de la red virtual administrada. El valor predeterminado de esta entrada es 10.139. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter

WorkspaceCustomStringParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. cadena (obligatoria)

WorkspaceEncryptionParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. Cifrado

WorkspaceNoPublicIPBooleanParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. bool (obligatorio)

WorkspaceProperties (Propiedades del espacio de trabajo)

Nombre Description Importancia
accessConnector Recurso de conector de acceso que se va a asociar a Databricks Workspace. No se permite en el área de trabajo Serverless ComputeMode. WorkspacePropertiesAccessConnector
authorizations Las autorizaciones del proveedor del área de trabajo. workspaceProviderAuthorization[]
computeMode El modo de proceso del área de trabajo. Obligatorio en la creación, no se puede cambiar. Los valores posibles incluyen: 'Sin servidor', 'Híbrido' "Híbrido"
'Sin servidor' (obligatorio)
createdBy Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que creó el área de trabajo. CreatedBy
defaultCatalog Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo. No se permite en el área de trabajo Serverless ComputeMode. DefaultCatalogProperties
defaultStorageFirewall Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento. No se permite en el área de trabajo Serverless ComputeMode. 'Disabled'
'Enabled'
encryption Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode. WorkspacePropertiesEncryption
enhancedSecurityCompliance Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode. enhancedSecurityComplianceDefinition
managedDiskIdentity Los detalles de la identidad administrada del conjunto de cifrado de disco utilizado para el cifrado de disco administrado. Solo se devuelve en el área de trabajo Hybrid ComputeMode. managedIdentityConfiguration
managedResourceGroupId Id. de grupo de recursos administrado. Requerido en el área de trabajo Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. cuerda / cadena
parameters Parámetros personalizados del área de trabajo. WorkspaceCustomParameters
publicNetworkAccess Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link. Se usa para configurar el vínculo privado solo front-end para el área de trabajo ComputeMode sin servidor. 'Disabled'
'Enabled'
requiredNsgRules Obtiene o establece un valor que indica si el plano de datos (clústeres) para controlar la comunicación del plano se produce a través del punto de conexión privado. Los valores admitidos son "AllRules" y "NoAzureDatabricksRules". El valor "NoAzureServiceRules" es solo para uso interno. No se permite en el área de trabajo Serverless ComputeMode. 'Todas las reglas'
'NoAzureDatabricksRules'
'NoAzureServiceRules'
storageAccountIdentity Los detalles de la identidad administrada de la cuenta de almacenamiento. Solo se devuelve en el área de trabajo Hybrid ComputeMode. managedIdentityConfiguration
uiDefinitionUri Identificador URI del blob donde se encuentra el archivo de definición de la interfaz de usuario. cuerda / cadena
actualizadoPor Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que actualizaron por última vez el área de trabajo. CreatedBy

WorkspacePropertiesAccessConnector

Nombre Description Importancia
id El identificador de recurso del recurso del conector de Azure Databricks Access. cadena (obligatoria)
identityType Tipo de identidad del recurso del conector de Access. 'SystemAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentityId Identificador de recurso de la identidad asignada por el usuario asociada al recurso del conector de Access. Esto es necesario para el tipo "UserAssigned" y no es válido para el tipo "SystemAssigned". cuerda / cadena

WorkspacePropertiesEncryption

Nombre Description Importancia
entidades Definición de entidades de cifrado para el área de trabajo. EncryptionEntitiesDefinition (obligatorio)

WorkspaceProviderAuthorization

Nombre Description Importancia
principalId Identificador principal del proveedor. Esta es la identidad que usará el proveedor para llamar a ARM para administrar los recursos del área de trabajo. string

Constraints:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (obligatorio)
roleDefinitionId Identificador de definición de rol del proveedor. Este rol definirá todos los permisos que el proveedor debe tener en el grupo de recursos de contenedor del área de trabajo. Esta definición de rol no puede tener permiso para eliminar el grupo de recursos. string

Constraints:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (obligatorio)

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template Description
azure Databricks All-in-one Templat VNetInjection-Pvtendpt

Implementación en Azure
Esta plantilla le permite crear un grupo de seguridad de red, una red virtual y un área de trabajo de Azure Databricks con la red virtual y un punto de conexión privado.
área de trabajo de Azure Databricks con de intervalo de direcciones personalizados

Implementación en Azure
Esta plantilla le permite crear un área de trabajo de Azure Databricks con un intervalo de direcciones de red virtual personalizado.
área de trabajo de Azure Databricks con de inyección de red virtual

Implementación en Azure
Esta plantilla permite crear un área de trabajo de Azure Databricks con una red virtual personalizada.
plantilla de AzureDatabricks para el firewall de almacenamiento predeterminado

Implementación en Azure
Esta plantilla permite crear un grupo de seguridad de red, una red virtual, un punto de conexión privado y un firewall de almacenamiento predeterminado habilitado para el área de trabajo de Azure Databricks con la red virtual y el conector de acceso asignado por el sistema.
plantilla de AzureDatabricks para la inyección de red virtual con nat Gateway

Implementación en Azure
Esta plantilla le permite crear una puerta de enlace NAT, un grupo de seguridad de red, una red virtual y un área de trabajo de Azure Databricks con la red virtual.
plantilla de AzureDatabricks para VNetInjection y Load Balancer

Implementación en Azure
Esta plantilla permite crear un equilibrador de carga, un grupo de seguridad de red, una red virtual y un área de trabajo de Azure Databricks con la red virtual.
plantilla de AzureDatabricks con el firewall de almacenamiento predeterminado

Implementación en Azure
Esta plantilla le permite crear un área de trabajo de Azure Databricks habilitada para el firewall de almacenamiento predeterminado con Privateendpoint, las tres formas de CMK y User-Assigned Access Connector.
Implementación de un área de trabajo de Azure Databricks

Implementación en Azure
Esta plantilla le permite crear un área de trabajo de Azure Databricks.
Implementación de un área de trabajo de Azure Databricks con todas las tres formas de CMK

Implementación en Azure
Esta plantilla permite crear un área de trabajo de Azure Databricks con servicios administrados y CMK con cifrado DBFS.
Implementación de un área de trabajo de Azure Databricks con Managed Disks CMK

Implementación en Azure
Esta plantilla le permite crear un área de trabajo de Azure Databricks con Managed Disks CMK.
Implementación de un área de trabajo de Azure Databricks con PE,CMK todos los formularios

Implementación en Azure
Esta plantilla le permite crear un área de trabajo de Azure Databricks con PrivateEndpoint y servicios administrados y CMK con cifrado DBFS.
Implementación de un WS de Azure Databricks con CMK para el cifrado DBFS

Implementación en Azure
Esta plantilla le permite crear un área de trabajo de Azure Databricks con CMK para el cifrado raíz de DBFS.
Implementación del área de trabajo de Azure Databricks con managed Services CMK

Implementación en Azure
Esta plantilla le permite crear un área de trabajo de Azure Databricks con Managed Services CMK.
Implementación de Sports Analytics en la arquitectura de Azure

Implementación en Azure
Crea una cuenta de Azure Storage con ADLS Gen 2 habilitado, una instancia de Azure Data Factory con servicios vinculados para la cuenta de almacenamiento (una instancia de Azure SQL Database si se implementa) y una instancia de Azure Databricks. AAD identity for the user deploying the template and the managed identity for the ADF instance will be granted the Storage Blob Data Contributor role on the storage account. También hay opciones para implementar una instancia de Azure Key Vault, una instancia de Azure SQL Database y un centro de eventos de Azure (para casos de uso de streaming). Cuando se implementa una instancia de Azure Key Vault, a la identidad administrada de Data Factory y a la identidad de AAD para el usuario que implementa la plantilla se le concederá el rol De usuario secretos de Key Vault.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso workspaces se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Databricks/workspaces, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Databricks/workspaces@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      accessConnector = {
        id = "string"
        identityType = "string"
        userAssignedIdentityId = "string"
      }
      authorizations = [
        {
          principalId = "string"
          roleDefinitionId = "string"
        }
      ]
      computeMode = "string"
      createdBy = {
      }
      defaultCatalog = {
        initialName = "string"
        initialType = "string"
      }
      defaultStorageFirewall = "string"
      encryption = {
        entities = {
          managedDisk = {
            keySource = "string"
            keyVaultProperties = {
              keyName = "string"
              keyVaultUri = "string"
              keyVersion = "string"
            }
            rotationToLatestKeyVersionEnabled = bool
          }
          managedServices = {
            keySource = "string"
            keyVaultProperties = {
              keyName = "string"
              keyVaultUri = "string"
              keyVersion = "string"
            }
          }
        }
      }
      enhancedSecurityCompliance = {
        automaticClusterUpdate = {
          value = "string"
        }
        complianceSecurityProfile = {
          complianceStandards = [
            "string"
          ]
          value = "string"
        }
        enhancedSecurityMonitoring = {
          value = "string"
        }
      }
      managedDiskIdentity = {
      }
      managedResourceGroupId = "string"
      parameters = {
        amlWorkspaceId = {
          type = "string"
          value = "string"
        }
        customPrivateSubnetName = {
          type = "string"
          value = "string"
        }
        customPublicSubnetName = {
          type = "string"
          value = "string"
        }
        customVirtualNetworkId = {
          type = "string"
          value = "string"
        }
        enableNoPublicIp = {
          type = "string"
          value = bool
        }
        encryption = {
          type = "string"
          value = {
            KeyName = "string"
            keySource = "string"
            keyvaulturi = "string"
            keyversion = "string"
          }
        }
        loadBalancerBackendPoolName = {
          type = "string"
          value = "string"
        }
        loadBalancerId = {
          type = "string"
          value = "string"
        }
        natGatewayName = {
          type = "string"
          value = "string"
        }
        prepareEncryption = {
          type = "string"
          value = bool
        }
        publicIpName = {
          type = "string"
          value = "string"
        }
        requireInfrastructureEncryption = {
          type = "string"
          value = bool
        }
        storageAccountName = {
          type = "string"
          value = "string"
        }
        storageAccountSkuName = {
          type = "string"
          value = "string"
        }
        vnetAddressPrefix = {
          type = "string"
          value = "string"
        }
      }
      publicNetworkAccess = "string"
      requiredNsgRules = "string"
      storageAccountIdentity = {
      }
      uiDefinitionUri = "string"
      updatedBy = {
      }
    }
    sku = {
      name = "string"
      tier = "string"
    }
  }
}

Valores de propiedad

Microsoft.Databricks/workspaces

Nombre Description Importancia
location Ubicación geográfica donde reside el recurso cadena (obligatoria)
nombre El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 64 (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. cadena (obligatoria)
Propiedades Propiedades del área de trabajo. WorkspaceProperties (obligatorio)
sku SKU del recurso. Sku
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
type El tipo de recurso "Microsoft.Databricks/workspaces@2025-10-01-preview"

AutomaticClusterUpdateDefinition

Nombre Description Importancia
value 'Disabled'
'Enabled'

ComplianceSecurityProfileDefinition

Nombre Description Importancia
Normas de cumplimiento Estándares de cumplimiento asociados al área de trabajo. string[]
value 'Disabled'
'Enabled'

CreatedBy

Nombre Description Importancia

DefaultCatalogProperties

Nombre Description Importancia
initialName Especifica el nombre inicial del catálogo predeterminado. Si no se especifica, se usará el nombre del área de trabajo. cuerda / cadena
initialType Define el tipo inicial del catálogo predeterminado. Valores posibles (sin distinción entre mayúsculas y minúsculas): HiveMetastore, UnityCatalog 'HiveMetastore'
'Catálogo de Unidad'

Encryption

Nombre Description Importancia
Nombre de clave Nombre de la clave KeyVault. cuerda / cadena
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Predeterminado, Microsoft.Keyvault 'Default'
"Microsoft.Keyvault"
keyvaulturi Uri de KeyVault. cuerda / cadena
keyversion Versión de la clave KeyVault. cuerda / cadena

EncryptionEntitiesDefinition

Nombre Description Importancia
managedDisk Propiedades de cifrado de los discos administrados de Databricks. No se permite en el área de trabajo Serverless ComputeMode. ManagedDiskEncryption
Servicios gestionados Propiedades de cifrado para los servicios administrados de Databricks. Compatible con ComputeMode híbrido y sin servidor. encryptionV2

CifradoV2

Nombre Description Importancia
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault 'Microsoft.Keyvault' (obligatorio)
keyVaultProperties Propiedades de entrada de Key Vault para el cifrado. CifradoV2KeyVaultProperties

CifradoV2KeyVaultProperties

Nombre Description Importancia
keyName Nombre de la clave KeyVault. cadena (obligatoria)
keyVaultUri Uri de KeyVault. cadena (obligatoria)
keyVersion Versión de la clave KeyVault. cadena (obligatoria)

EnhancedSecurityComplianceDefinition

Nombre Description Importancia
automaticClusterUpdate Estado de la característica de actualizaciones automatizadas del clúster. AutomaticClusterUpdateDefinition
complianceSecurityProfile Estado de la característica Perfil de seguridad de cumplimiento. complianceSecurityProfileDefinition
enhancedSecurityMonitoring Estado de la característica Supervisión de seguridad mejorada. enhancedSecurityMonitoringDefinition

EnhancedSecurityMonitoringDefinition

Nombre Description Importancia
value 'Disabled'
'Enabled'

ManagedDiskEncryption

Nombre Description Importancia
keySource (Fuente) KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault. No se permite en el área de trabajo Serverless ComputeMode. 'Microsoft.Keyvault' (obligatorio)
keyVaultProperties Propiedades de entrada de Key Vault para el cifrado. managedDiskEncryptionKeyVaultProperties (obligatorio)
rotationToLatestKeyVersionEnabled Indique si la versión de clave más reciente se debe usar automáticamente para Managed Disk Encryption. bool

ManagedDiskEncryptionKeyVaultProperties

Nombre Description Importancia
keyName Nombre de la clave KeyVault. cadena (obligatoria)
keyVaultUri Identificador URI de KeyVault. cadena (obligatoria)
keyVersion Versión de la clave KeyVault. cadena (obligatoria)

ManagedIdentityConfiguration

Nombre Description Importancia

Sku

Nombre Description Importancia
nombre Nombre de la SKU. cadena (obligatoria)
nivel Nivel de SKU. cuerda / cadena

TrackedResourceTags

Nombre Description Importancia

WorkspaceCustomBooleanParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. bool (obligatorio)

WorkspaceCustomParameters

Nombre Description Importancia
amlWorkspaceId Identificador de un área de trabajo de Azure Machine Learning que se va a vincular con el área de trabajo de Databricks. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customPrivateSubnetName Nombre de la subred privada dentro de la red virtual. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customPublicSubnetName Nombre de una subred pública dentro de la red virtual. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
customVirtualNetworkId Identificador de una red virtual en la que se debe crear este clúster de Databricks. Obligatorio en Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
enableNoPublicIp Boolean que indica si se debe deshabilitar la dirección IP pública. El valor predeterminado es true. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceNoPublicIPBooleanParameter
encryption Contiene los detalles de cifrado del área de trabajo habilitada para Customer-Managed Key (CMK). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceEncryptionParameter
loadBalancerBackendPoolName Nombre del grupo de back-end del equilibrador de carga saliente para la conectividad segura del clúster (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
loadBalancerId URI de recursos del equilibrador de carga saliente para el área de trabajo Conectividad de clúster segura (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
natGatewayName Nombre de la puerta de enlace NAT para las subredes del área de trabajo conectividad de clúster segura (sin ip pública). No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
prepareEncryption Prepare el área de trabajo para el cifrado. Habilita la identidad administrada para la cuenta de almacenamiento administrada. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomBooleanParameter
publicIpName Nombre de la dirección IP pública para el área de trabajo Sin dirección IP pública con red virtual administrada. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
requireInfrastructureEncryption Valor booleano que indica si el sistema de archivos raíz de DBFS se habilitará o no con la capa secundaria de cifrado con claves administradas por la plataforma para los datos en reposo. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomBooleanParameter
storageAccountName Nombre predeterminado de la cuenta de almacenamiento de DBFS. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
storageAccountSkuName Nombre de la SKU de la cuenta de almacenamiento, por ejemplo: Standard_GRS, Standard_LRS. Consulte https://aka.ms/storageskus para obtener entradas válidas. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter
vnetAddressPrefix Prefijo de dirección de la red virtual administrada. El valor predeterminado de esta entrada es 10.139. No se permite en el área de trabajo Serverless ComputeMode. WorkspaceCustomStringParameter

WorkspaceCustomStringParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. cadena (obligatoria)

WorkspaceEncryptionParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. Cifrado

WorkspaceNoPublicIPBooleanParameter

Nombre Description Importancia
type El tipo de variable que es 'Bool'
'Object'
'String'
value Valor que se debe usar para este campo. bool (obligatorio)

WorkspaceProperties (Propiedades del espacio de trabajo)

Nombre Description Importancia
accessConnector Recurso de conector de acceso que se va a asociar a Databricks Workspace. No se permite en el área de trabajo Serverless ComputeMode. WorkspacePropertiesAccessConnector
authorizations Las autorizaciones del proveedor del área de trabajo. workspaceProviderAuthorization[]
computeMode El modo de proceso del área de trabajo. Obligatorio en la creación, no se puede cambiar. Los valores posibles incluyen: 'Sin servidor', 'Híbrido' "Híbrido"
'Sin servidor' (obligatorio)
createdBy Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que creó el área de trabajo. CreatedBy
defaultCatalog Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo. No se permite en el área de trabajo Serverless ComputeMode. DefaultCatalogProperties
defaultStorageFirewall Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento. No se permite en el área de trabajo Serverless ComputeMode. 'Disabled'
'Enabled'
encryption Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode. WorkspacePropertiesEncryption
enhancedSecurityCompliance Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode. enhancedSecurityComplianceDefinition
managedDiskIdentity Los detalles de la identidad administrada del conjunto de cifrado de disco utilizado para el cifrado de disco administrado. Solo se devuelve en el área de trabajo Hybrid ComputeMode. managedIdentityConfiguration
managedResourceGroupId Id. de grupo de recursos administrado. Requerido en el área de trabajo Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode. cuerda / cadena
parameters Parámetros personalizados del área de trabajo. WorkspaceCustomParameters
publicNetworkAccess Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link. Se usa para configurar el vínculo privado solo front-end para el área de trabajo ComputeMode sin servidor. 'Disabled'
'Enabled'
requiredNsgRules Obtiene o establece un valor que indica si el plano de datos (clústeres) para controlar la comunicación del plano se produce a través del punto de conexión privado. Los valores admitidos son "AllRules" y "NoAzureDatabricksRules". El valor "NoAzureServiceRules" es solo para uso interno. No se permite en el área de trabajo Serverless ComputeMode. 'Todas las reglas'
'NoAzureDatabricksRules'
'NoAzureServiceRules'
storageAccountIdentity Los detalles de la identidad administrada de la cuenta de almacenamiento. Solo se devuelve en el área de trabajo Hybrid ComputeMode. managedIdentityConfiguration
uiDefinitionUri Identificador URI del blob donde se encuentra el archivo de definición de la interfaz de usuario. cuerda / cadena
actualizadoPor Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que actualizaron por última vez el área de trabajo. CreatedBy

WorkspacePropertiesAccessConnector

Nombre Description Importancia
id El identificador de recurso del recurso del conector de Azure Databricks Access. cadena (obligatoria)
identityType Tipo de identidad del recurso del conector de Access. 'SystemAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentityId Identificador de recurso de la identidad asignada por el usuario asociada al recurso del conector de Access. Esto es necesario para el tipo "UserAssigned" y no es válido para el tipo "SystemAssigned". cuerda / cadena

WorkspacePropertiesEncryption

Nombre Description Importancia
entidades Definición de entidades de cifrado para el área de trabajo. EncryptionEntitiesDefinition (obligatorio)

WorkspaceProviderAuthorization

Nombre Description Importancia
principalId Identificador principal del proveedor. Esta es la identidad que usará el proveedor para llamar a ARM para administrar los recursos del área de trabajo. string

Constraints:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (obligatorio)
roleDefinitionId Identificador de definición de rol del proveedor. Este rol definirá todos los permisos que el proveedor debe tener en el grupo de recursos de contenedor del área de trabajo. Esta definición de rol no puede tener permiso para eliminar el grupo de recursos. string

Constraints:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (obligatorio)

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de Databricks Workspace.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "eastus2"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

data "azapi_resource_id" "workspace_resource_group" {
  type      = "Microsoft.Resources/resourceGroups@2020-06-01"
  parent_id = azapi_resource.resourceGroup.parent_id
  name      = "databricks-rg-${var.resource_name}"
}

resource "azapi_resource" "workspace" {
  type      = "Microsoft.Databricks/workspaces@2023-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      managedResourceGroupId = data.azapi_resource_id.workspace_resource_group.id
      parameters = {
        prepareEncryption = {
          value = true
        }
        requireInfrastructureEncryption = {
          value = true
        }
      }
      publicNetworkAccess = "Enabled"
    }
    sku = {
      name = "premium"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Description
área de trabajo de Azure Databricks Módulo de recursos de AVM para el área de trabajo de Azure Databricks