PATH

适用于:勾选标记为是 Databricks SQL 勾选为 Databricks 运行时 19 及以上

PATH配置参数设定模式搜索路径。 当查询或DML语句引用myfunc()对象(无论是否mytable带有目录和模式限定符)时,Azure Databricks会按顺序查找路径上每个模式中的对象,并使用第一个匹配。

新会话继承工作区默认设置。 会话开始后,实时路径即为会话值。 要在会话中恢复工作区默认值,请运行 SET PATH = DEFAULT_PATH。

DDL 语句的未限定目标使用当前的目录和模式,而非路径。 DDL语句查询中的名称,如 CREATE TABLE AS,仍然沿路径出现。 持久视图、SQL用户自定义函数和 SQL SECURITY DEFINER 过程在创建时捕捉路径。 完整规则请参见 表格和查看解析。

你可以在以下级别设置该参数:

系统默认

system.session, system.builtin, system.ai, CURRENT_SCHEMA

Warning

临时函数优先于同名的内置函数,因为 system.session 先于 system.builtin。 不要依赖临时函数来跟踪内置函数。 参见 功能与过程解析。

Examples

以下示例恢复了工作区默认状态并显示会话路径。 SET PATH; 无法打印路径,因此请使用 current_path 检查。

-- Restore the workspace default in the session.
> SET PATH = DEFAULT_PATH;
> SELECT current_path();
  system.session,system.builtin,system.ai,main.default