您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Microsoft.Databricks workspaces

Template format

To create a Microsoft.Databricks/workspaces resource, add the following JSON to the resources section of your template.

{
  "name": "string",
  "type": "Microsoft.Databricks/workspaces",
  "apiVersion": "2018-04-01",
  "tags": {},
  "location": "string",
  "properties": {
    "managedResourceGroupId": "string",
    "parameters": {
      "amlWorkspaceId": {
        "type": "string",
        "value": "string"
      },
      "customVirtualNetworkId": {
        "type": "string",
        "value": "string"
      },
      "customPublicSubnetName": {
        "type": "string",
        "value": "string"
      },
      "customPrivateSubnetName": {
        "type": "string",
        "value": "string"
      },
      "enableNoPublicIp": {
        "type": "string",
        "value": "boolean"
      },
      "loadBalancerBackendPoolName": {
        "type": "string",
        "value": "string"
      },
      "loadBalancerId": {
        "type": "string",
        "value": "string"
      },
      "natGatewayName": {
        "type": "string",
        "value": "string"
      },
      "publicIpName": {
        "type": "string",
        "value": "string"
      },
      "prepareEncryption": {
        "type": "string",
        "value": "boolean"
      },
      "encryption": {
        "type": "string",
        "value": {
          "keySource": "string",
          "KeyName": "string",
          "keyversion": "string",
          "keyvaulturi": "string"
        }
      },
      "requireInfrastructureEncryption": {
        "type": "string",
        "value": "boolean"
      },
      "storageAccountName": {
        "type": "string",
        "value": "string"
      },
      "storageAccountSkuName": {
        "type": "string",
        "value": "string"
      },
      "vnetAddressPrefix": {
        "type": "string",
        "value": "string"
      }
    },
    "uiDefinitionUri": "string",
    "authorizations": [
      {
        "principalId": "string",
        "roleDefinitionId": "string"
      }
    ]
  },
  "sku": {
    "name": "string",
    "tier": "string"
  },
  "resources": []
}

Property values

The following tables describe the values you need to set in the schema.

Microsoft.Databricks/workspaces object

Note

In Bicep, type and apiVersion are specified in the first line of the resource declaration. Use the format <type>@<apiVersion>. Don't set those properties in the resource body.

Name Type Required Value
name string Yes The name of the workspace.
type enum Yes For JSON - Microsoft.Databricks/workspaces
apiVersion enum Yes For JSON - 2018-04-01
tags object No Resource tags.
location string Yes The geo-location where the resource lives
properties object Yes The workspace properties. - WorkspaceProperties object
sku object No The SKU of the resource. - Sku object
resources array No virtualNetworkPeerings

WorkspaceProperties object

Name Type Required Value
managedResourceGroupId string Yes The managed resource group Id.
parameters object No The workspace's custom parameters. - WorkspaceCustomParameters object
uiDefinitionUri string No The blob URI where the UI definition file is located.
authorizations array No The workspace provider authorizations. - WorkspaceProviderAuthorization object

Sku object

Name Type Required Value
name string Yes The SKU name.
tier string No The SKU tier.

WorkspaceCustomParameters object

Name Type Required Value
amlWorkspaceId object No The ID of a Azure Machine Learning workspace to link with Databricks workspace - WorkspaceCustomStringParameter object
customVirtualNetworkId object No The ID of a Virtual Network where this Databricks Cluster should be created - WorkspaceCustomStringParameter object
customPublicSubnetName object No The name of a Public Subnet within the Virtual Network - WorkspaceCustomStringParameter object
customPrivateSubnetName object No The name of the Private Subnet within the Virtual Network - WorkspaceCustomStringParameter object
enableNoPublicIp object No Should the Public IP be Disabled? - WorkspaceCustomBooleanParameter object
loadBalancerBackendPoolName object No Name of the outbound Load Balancer Backend Pool for Secure Cluster Connectivity (No Public IP). - WorkspaceCustomStringParameter object
loadBalancerId object No Resource URI of Outbound Load balancer for Secure Cluster Connectivity (No Public IP) workspace. - WorkspaceCustomStringParameter object
natGatewayName object No Name of the NAT gateway for Secure Cluster Connectivity (No Public IP) workspace subnets. - WorkspaceCustomStringParameter object
publicIpName object No Name of the Public IP for No Public IP workspace with managed vNet. - WorkspaceCustomStringParameter object
prepareEncryption object No Prepare the workspace for encryption. Enables the Managed Identity for managed storage account. - WorkspaceCustomBooleanParameter object
encryption object No Contains the encryption details for Customer-Managed Key (CMK) enabled workspace. - WorkspaceEncryptionParameter object
requireInfrastructureEncryption object No A boolean indicating whether or not the DBFS root file system will be enabled with secondary layer of encryption with platform managed keys for data at rest. - WorkspaceCustomBooleanParameter object
storageAccountName object No Default DBFS storage account name. - WorkspaceCustomStringParameter object
storageAccountSkuName object No Storage account SKU name, ex: Standard_GRS, Standard_LRS. Refer https://aka.ms/storageskus for valid inputs. - WorkspaceCustomStringParameter object
vnetAddressPrefix object No Address prefix for Managed virtual network. Default value for this input is 10.139. - WorkspaceCustomStringParameter object

WorkspaceProviderAuthorization object

Name Type Required Value
principalId string Yes The provider's principal identifier. This is the identity that the provider will use to call ARM to manage the workspace resources. - globally unique identifier
roleDefinitionId string Yes The provider's role definition identifier. This role will define all the permissions that the provider must have on the workspace's container resource group. This role definition cannot have permission to delete the resource group. - globally unique identifier

WorkspaceCustomStringParameter object

Name Type Required Value
type enum No The type of variable that this is. - Bool, Object, String
value string Yes The value which should be used for this field.

WorkspaceCustomBooleanParameter object

Name Type Required Value
type enum No The type of variable that this is. - Bool, Object, String
value boolean Yes The value which should be used for this field.

WorkspaceEncryptionParameter object

Name Type Required Value
type enum No The type of variable that this is. - Bool, Object, String
value object No The value which should be used for this field. - Encryption object

Encryption object

Name Type Required Value
keySource enum No The encryption keySource (provider). Possible values (case-insensitive): Default, Microsoft.Keyvault. - Default or Microsoft.Keyvault
KeyName string No The name of KeyVault key.
keyversion string No The version of KeyVault key.
keyvaulturi string No The Uri of KeyVault.

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Azure Databricks All-in-one Template for VNet Injection

Deploy to Azure
This template allows you to create a network security group, a virtual network and an Azure Databricks workspace with the virtual network.
AzureDatabricks Template for VNetInjection and Load Balancer

Deploy to Azure
This template allows you to create a a load balancer, network security group, a virtual network and an Azure Databricks workspace with the virtual network.
AzureDatabricks Template for VNet Injection with NAT Gateway

Deploy to Azure
This template allows you to create a NAT gateway, network security group, a virtual network and an Azure Databricks workspace with the virtual network.
Deploy an Azure Databricks Workspace

Deploy to Azure
This template allows you to create an Azure Databricks workspace.
Azure Databricks Workspace with custom Address Range

Deploy to Azure
This template allows you to create an Azure Databricks workspace with a custom virtual network address range.
Deploy an Azure Databricks Workspace and configure CMK

Deploy to Azure
This template allows you to create an Azure Databricks workspace and configure CMK.
Azure Databricks Workspace with VNet Injection

Deploy to Azure
This template allows you to create an Azure Databricks workspace with a custom virtual network.