砖CLI的迁移

卸载遗留CLI

如果你有你想要的遗留CLI安装和卸载它,使用皮普(或pip3,这取决于您的Python版本)运行卸载命令,如下所示:

皮普卸载databricks-cli

安装新的CLI

如果你不已经有了新的CLI安装,安装它,明白了设置CLI。

验证CLI安装

如果你不确定你是否使用新的CLI,按照说明在本节中,根据需要来验证和调整。你遵循这些指令之前,确保退出任何Python虚拟环境,conda环境,或类似的环境。

检查默认安装CLI的版本,运行以下命令:

砖- v

如果版本号不是你期望什么,做以下之一:

• 如果你想使用CLI的只有一个版本:卸载以前版本的CLI不再需要使用。您可能需要更新您的操作系统的路径这剩余的版本的CLI的路径,你想用上市。

• 如果你想继续使用CLI的多个版本:预谋的完整路径CLI的版本,您想要使用每个调用CLI。

• 如果你想继续使用CLI的多个版本,但你不想保持将完整路径CLI是你最经常使用的版本:确保完整路径,首先列出在你的操作系统的版本路径。请注意,您必须预先考虑的完整路径中未列出的第一个版本的CLI您的操作系统路径。

更新操作系统的路径,请执行以下操作:

使用额外的身份验证类型

遗留CLI和新的CLI都支持砖个人访问令牌的身份验证。然而,砖建议你使用其他的砖的身份验证类型如果可能,只有新的CLI支持。

个人访问令牌认证,如果你必须使用砖砖建议你使用一个相关的服务主体而不是砖帐户或用户工作区。看到提供一个服务主体为砖自动化UI -砖。

新的CLI支持OAuth标记除了砖个人访问令牌。这些额外的标记是更安全的,因为他们通常在一小时内到期,而砖个人访问令牌可以无限期有效从一天到。这一点尤其重要,如果令牌是不小心签入到版本控制系统,由其他人可以访问。此外,新的CLI可以到期时自动刷新这些额外的令牌,而刷新数据砖个人访问令牌是一个手动过程或很难自动化。

有关更多信息,请参见设置身份验证。

命令组和命令的比较

下表列出了遗留CLI命令组和他们的新CLI命令组的等价物。综合领先指标之间存在显著差异,额外的表遗留CLI命令或选项列表及其新的CLI命令或选项的等价物。

违约和位置参数

大多数新的CLI命令至少有一个默认参数没有一篇选项。一些新的CLI命令有两个或两个以上的位置参数,必须指定一个特定的顺序,没有相应的选项。这不同于遗留CLI,大多数命令对所有参数需要指定选项。例如,新的CLI集群得到命令以一个集群ID作为默认参数。然而,遗留CLIclusers得到命令要求您指定一个——cluster-id随着集群ID选项。例如:

遗留CLI:

#这是遗留CLI。砖集群——cluster-id1234年567890 - a1b23c4d#这* *不* *处理遗留CLI——“错误:#失踪。之一(“cluster-id”、“集群名称”)必须提供。”砖集群获得1234年567890 - a1b23c4d

新的CLI:

#这是新的CLI。砖集群获得1234年567890 - a1b23c4d#这* *不* *使用新的CLI -“错误:未知的国旗:——cluster-id”砖集群——cluster-id1234年567890 - a1b23c4d

另外一个例子,新的CLI奖助金得到命令有两个默认参数:可获得的类型可到手的的全名紧随其后。然而,遗留CLIunity-catalog权限得到命令要求您指定一个——< securable-type >选择以及可获得的的全名。例如:

遗留CLI:

砖unity-catalog main.default权限得到——模式

新的CLI:

#这是新的CLI。砖拨款模式main.default#这* *不* *使用新的CLI -“错误:未知的国旗:——模式”砖main.default赠款,模式

调试模式

遗留CLI提供了一个——调试选择显示整个堆栈跟踪错误。新的CLI,——调试选择是不认可。相反,使用以下选项:

• 使用——日志文件<路径>写日志信息到文件中指定<路径>。如果不提供这个选项,日志信息输出到stderr。指定——日志文件还没有指定——进行日志级别导致没有日志信息被写入到文件中。

• 使用——日志格式<类型>指定的格式记录的信息。<类型>可以文本(默认,如果未指定)json。

• 使用——进行日志级别<格式>指定级别的信息记录。允许的值是禁用(默认,如果未指定)跟踪,调试,信息,警告,错误。

遗留CLI,下面的例子显示了完整的堆栈跟踪误差:

砖fs ls /调试#输出:## HTTP调试启用# NoneType:没有#错误:路径/必须从“dbfs: /

新的CLI,下面的例子完整的堆栈跟踪记录到一个文件中命名new-cli-errors.log在当前工作目录中。堆栈跟踪写入JSON格式的文件:

砖fs ls /日志文件new-cli-errors。日志,日志格式json,进行日志级别跟踪#输出:##错误:预期dbfs路径(dbfs: /前缀):/##(完整的堆栈跟踪也写入new-cli-errors。日志文件)。

常见问题

本节列出了常见问题从遗留迁移到新的CLI。

砖CLI的<新版本号>在<新路径>当前路径找到喜欢跑步CLI < old-version-number > <旧路>因为安装和可用的路径,我假设你试图运行新版本。如果你想禁用此行为可以设置DATABRICKS_CLI_DO_NOT_EXECUTE_NEWER_VERSION = 1。执行CLI <新版本号>…- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -砖CLI的<新版本号>

得到帮助

得到帮助从遗留CLI迁移到新的CLI,看到以下资源:

• 砖帮助中心

• 砖的办公时间

• 砖的支持