Microsoft.Databricks 작업 영역

Bicep 리소스 정의

작업 영역 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Databricks/workspaces 리소스를 만들려면 템플릿에 다음 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'
  }
}

속성 값

Microsoft.Databricks/workspaces

AutomaticClusterUpdateDefinition

규정 준수보안 프로필정의

작성자

기본 카탈로그 속성

암호화

EncryptionEntities정의

암호화V2

EncryptionV2KeyVault속성

향상된 보안 규정 준수 정의

EnhancedSecurityMonitoringDefinition

관리 디스크 암호화

ManagedDiskEncryptionKeyVault속성

ManagedIdentityConfiguration

SKU (재고 관리 코드)

TrackedResource태그

WorkspaceCustomBooleanParameter (영문)

WorkspaceCustomParameters (작업 공간 사용자 정의 매개 변수)

WorkspaceCustomString매개 변수

WorkspaceEncryption매개 변수

WorkspaceNoPublicIPBoolean매개 변수

작업 공간 속성

WorkspacePropertiesAccess커넥터

WorkspaceProperties암호화

WorkspaceProvider권한 부여

사용 예제

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

ARM 템플릿 리소스 정의

작업 영역 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Databricks/workspaces 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "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"
  }
}

속성 값

Microsoft.Databricks/workspaces

AutomaticClusterUpdateDefinition

규정 준수보안 프로필정의

작성자

기본 카탈로그 속성

암호화

EncryptionEntities정의

암호화V2

EncryptionV2KeyVault속성

향상된 보안 규정 준수 정의

EnhancedSecurityMonitoringDefinition

관리 디스크 암호화

ManagedDiskEncryptionKeyVault속성

ManagedIdentityConfiguration

SKU (재고 관리 코드)

TrackedResource태그

WorkspaceCustomBooleanParameter (영문)

WorkspaceCustomParameters (작업 공간 사용자 정의 매개 변수)

WorkspaceCustomString매개 변수

WorkspaceEncryption매개 변수

WorkspaceNoPublicIPBoolean매개 변수

작업 공간 속성

WorkspacePropertiesAccess커넥터

WorkspaceProperties암호화

WorkspaceProvider권한 부여

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플릿	설명
Azure Databricks 올인원 템플릿 VNetInjection-Pvtendpt	이 템플릿을 사용하면 가상 네트워크 및 프라이빗 엔드포인트를 사용하여 네트워크 보안 그룹, 가상 네트워크 및 Azure Databricks 작업 영역을 만들 수 있습니다.
사용자 지정 주소 범위가 있는 Azure Databricks 작업 영역	이 템플릿을 사용하면 사용자 지정 가상 네트워크 주소 범위를 사용하여 Azure Databricks 작업 영역을 만들 수 있습니다.
VNet 삽입을 사용하는 Azure Databricks 작업 영역	이 템플릿을 사용하면 사용자 지정 가상 네트워크를 사용하여 Azure Databricks 작업 영역을 만들 수 있습니다.
기본 스토리지 방화벽 대한 AzureDatabricks 템플릿	이 템플릿을 사용하면 가상 네트워크 및 시스템 할당 액세스 커넥터를 사용하여 네트워크 보안 그룹, 가상 네트워크, 프라이빗 엔드포인트 및 기본 스토리지 방화벽 사용 Azure Databricks 작업 영역을 만들 수 있습니다.
NAT 게이트웨이 사용하여 VNet 삽입용 AzureDatabricks 템플릿	이 템플릿을 사용하면 가상 네트워크를 사용하여 NAT 게이트웨이, 네트워크 보안 그룹, 가상 네트워크 및 Azure Databricks 작업 영역을 만들 수 있습니다.
VNetInjection 및 Load Balancer 대한 AzureDatabricks 템플릿	이 템플릿을 사용하면 가상 네트워크를 사용하여 부하 분산 장치, 네트워크 보안 그룹, 가상 네트워크 및 Azure Databricks 작업 영역을 만들 수 있습니다.
기본 스토리지 방화벽 사용하여 AzureDatabricks 템플릿	이 템플릿을 사용하면 Privateendpoint, 세 가지 CMK 형식 및 User-Assigned Access Connector를 사용하여 기본 스토리지 방화벽이 설정된 Azure Databricks 작업 영역을 만들 수 있습니다.
Azure Databricks 작업 영역 배포	이 템플릿을 사용하면 Azure Databricks 작업 영역을 만들 수 있습니다.
3가지 CMK 형식으로 Azure Databricks 작업 영역 배포	이 템플릿을 사용하면 DBFS 암호화를 사용하여 관리되는 서비스 및 CMK를 사용하여 Azure Databricks 작업 영역을 만들 수 있습니다.
Managed Disks CMK 사용하여 Azure Databricks 작업 영역 배포	이 템플릿을 사용하면 Managed Disks CMK를 사용하여 Azure Databricks 작업 영역을 만들 수 있습니다.
PE를 사용하여 Azure Databricks 작업 영역 배포, CMK 모든 양식	이 템플릿을 사용하면 PrivateEndpoint 및 관리 서비스 및 DBFS 암호화를 사용하여 CMK를 사용하여 Azure Databricks 작업 영역을 만들 수 있습니다.
DBFS 암호화 CMK를 사용하여 Azure Databricks WS 배포	이 템플릿을 사용하면 DBFS 루트 암호화용 CMK를 사용하여 Azure Databricks 작업 영역을 만들 수 있습니다.
Managed Services CMK를 사용하여 Azure Databricks 작업 영역 배포	이 템플릿을 사용하면 Managed Services CMK를 사용하여 Azure Databricks 작업 영역을 만들 수 있습니다.
Azure 아키텍처 스포츠 분석 배포	ADLS Gen 2를 사용하도록 설정된 Azure Storage 계정, 스토리지 계정에 연결된 서비스가 있는 Azure Data Factory 인스턴스(배포된 경우 Azure SQL Database) 및 Azure Databricks 인스턴스를 만듭니다. 템플릿을 배포하는 사용자의 AAD ID와 ADF 인스턴스의 관리 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 부여됩니다. Azure Key Vault 인스턴스, Azure SQL Database 및 Azure Event Hub(스트리밍 사용 사례용)를 배포하는 옵션도 있습니다. Azure Key Vault가 배포되면 템플릿을 배포하는 사용자의 데이터 팩터리 관리 ID 및 AAD ID에 Key Vault 비밀 사용자 역할이 부여됩니다.

Terraform(AzAPI 공급자) 리소스 정의

작업 영역 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Databricks/workspaces 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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"
    }
  }
}

속성 값

Microsoft.Databricks/workspaces

AutomaticClusterUpdateDefinition

규정 준수보안 프로필정의

작성자

기본 카탈로그 속성

암호화

EncryptionEntities정의

암호화V2

EncryptionV2KeyVault속성

향상된 보안 규정 준수 정의

EnhancedSecurityMonitoringDefinition

관리 디스크 암호화

ManagedDiskEncryptionKeyVault속성

ManagedIdentityConfiguration

SKU (재고 관리 코드)

TrackedResource태그

WorkspaceCustomBooleanParameter (영문)

WorkspaceCustomParameters (작업 공간 사용자 정의 매개 변수)

WorkspaceCustomString매개 변수

WorkspaceEncryption매개 변수

WorkspaceNoPublicIPBoolean매개 변수

작업 공간 속성

WorkspacePropertiesAccess커넥터

WorkspaceProperties암호화

WorkspaceProvider권한 부여

사용 예제

Terraform 샘플

Databricks 작업 영역 배포의 기본 예입니다.

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    = ["*"]
}

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.