Azure Databricks 配置文件(有时简称为配置文件或 )包含 Azure Databricks 进行身份验证所需的设置和其他信息profile
。 Azure Databricks 配置文件存储在 Azure Databricks “配置文件”文件 () 中,供工具、SDK、脚本和应用使用。.databrickscfg
若要了解你的工具、SDK、脚本和应用是否支持 Azure Databricks 配置文件,请参阅提供程序的文档。 所有参与实现 Databricks 客户端同一身份验证的工具和 SDK 均支持 Azure Databricks 配置文件。
创建 Azure Databricks 配置文件文件
若要创建 Azure Databricks 配置文件的文件,请运行 Databricks CLIdatabricks configure
命令,或按照以下步骤操作:
使用你偏好的文本编辑器在 Unix、Linux 或 macOS 上的
.databrickscfg
(用户主目录)文件夹或者 Windows 上的~
(用户主目录)文件夹中创建名为%USERPROFILE%
的文件(如果还没有此文件)。 不要忘记在文件名开头添加句点 (.
)。 将以下内容添加到此文件:[<some-unique-name-for-this-configuration-profile>] <field-name> = <field-value>
在上述内容中替换以下值,然后保存文件:
- 将
<some-unique-name-for-this-configuration-profile>
替换为配置文件的唯一名称,例如DEFAULT
、DEVELOPMENT
、PRODUCTION
或类似名称。 可在同一.databrickscfg
文件中具有多个配置文件,但每个配置文件的名称在此文件中必须是唯一的。 -
<field-name>
和<field-value>
,其中包含目标 Databricks 身份验证类型的必填字段之一的名称和值。 有关要提供的特定信息,请参阅本文前面有关该身份验证类型的部分。 - 为目标 Databricks 身份验证类型的每个其他必填字段添加
<field-name>
和<field-value>
对。
- 将
例如,对于 Azure Databricks 个人访问令牌身份验证,.databrickscfg
文件外观可能如下:
[DEFAULT]
host = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...
若要创建其他配置文件,请在同一 .databrickscfg
文件中指定不同的配置文件名称。 例如,若要指定单独的 Azure Databricks 工作区,则每个工作区应有自己的 Azure Databricks 个人访问令牌:
[DEFAULT]
host = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...
[DEVELOPMENT]
host = https://adb-2345678901234567.8.azuredatabricks.net
token = dapi234...
还可在 Azure Databricks 帐户的 .databrickscfg
文件中指定不同的配置文件名称和不同的 Databricks 身份验证类型,例如:
[DEFAULT]
host = https://adb-1234567890123456.7.azuredatabricks.net
token = dapi123...
[DEVELOPMENT]
azure_workspace_resource_id = /subscriptions/bc0cd1.../resourceGroups/my-resource-group/providers/Microsoft.Databricks/workspaces/my-workspace
azure_tenant_id = bc0cd1...
azure_client_id = fa0cd1...
azure_client_secret = aBC1D~...
小窍门
可以使用 Databricks CLI 测试配置文件。 请参阅测试配置文件。