SET PATH

适用于:检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 19 及更高版本

路径是 Azure Databricks 在查询或 DML 语句引用没有目录和模式限定符的表、视图或函数时搜索的有序模式列表。 DDL语句的无限定主语是 current_catalog.current_schema,不是路径查找,因此 CREATE TABLE t 在当前模式中创建 t 。 关于该路径如何应用于DDL语句中的查询和持久视图,请参见 表和视图解析。 关于例行实体,请参见 功能与过程解析。

Syntax

SET PATH = path_element [, ...]

path_element
  { DEFAULT_PATH |
    SYSTEM_PATH |
    CURRENT_SCHEMA |
    PATH |
    schema_name }

参数

  • DEFAULT_PATH

    一个关键词,可以扩展到 PATH 配置参数,这是新会话继承的工作区默认参数。 如果参数未被覆盖,则展开为 system.session, system.builtin, system.ai, CURRENT_SCHEMA。

  • SYSTEM_PATH

    一个扩展到系统提供的模式的关键词: system.builtin, system.ai。

  • CURRENT_SCHEMA

    一个虚拟模式引用,在使用时会解析到当前目录和当前模式(current_catalog().current_schema())。 扩展遵循 USE CATALOG 和 USE SCHEMA 在会话期间所做的更改。

  • PATH

    一个关键词,可以扩展到当前会话路径。 用它来延长路径,而不重述内容。

  • schema_name

    需要一个两部分的名称(catalog.schema)。 允许使用超过两个部分的名字。 一个单部分的名字就提升 了INVALID_SQL_PATH_SCHEMA_REFERENCE。

    目录和模式在运行 SET PATH时不必存在。 名称解析跳过缺失的条目,继续使用下一个路径元素。

Description

以下规则决定了哪些路径元素 SET PATH 接受,以及最终路径如何影响名称解析。

  • 重复项:不允许重复路径元素。 关键词扩展后,重复的数字会提升 DUPLICATE_SQL_PATH_ENTRY。

  • 系统架构: system.builtin 并 system.ai 保存内置标量、表和 AI 函数。 system.session 保存会话范围的对象,例如临时变量、临时函数和临时视图。 通常不建议离开 system.builtin 小径。

  • 省略的架构:未限定的名称仅针对路径上的架构解析。 如果省略 CURRENT_SCHEMA,则在当前模式中限定持久对象。 如果你省略 system.builtin 或 system.ai,则对这些函数进行了限定,例如 system.builtin.abs。 如果省略 system.session,则找不到未限定的临时视图、临时函数和会话变量。

  • 视图和例程:持久视图、SQL 用户定义的函数和 SQL SECURITY DEFINER 过程捕获路径, CREATE 并针对捕获的路径(而不是调用程序的会话路径)在其正文中解析不限定的名称。 捕获 SQL SECURITY DEFINER 路径中会省略 system.session 一个过程。 过程 SQL SECURITY INVOKER 使用呼叫者的实时路径。 参见 “捕获路径”。

  • 检查路径: SET PATH; 不打印路径。 用 上current_path。

Examples

按顺序运行以下语句,因为后续语句会在之前语句设定的路径上构建。

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

-- Restrict the PATH to only the system-provided schemas.
> SET PATH = SYSTEM_PATH;
> SELECT current_path();
  system.builtin,system.ai

-- Append a schema to the existing PATH without restating it.
> SET PATH = PATH, libraries.pgsql;
> SELECT current_path();
  system.builtin,system.ai,libraries.pgsql

-- Put the current schema ahead of the system schemas so that user-defined
-- functions shadow built-in functions of the same name.
> SET PATH = CURRENT_SCHEMA, PATH;
> SELECT current_path();
  main.default,system.builtin,system.ai,libraries.pgsql

以下语句失败且不会改变路径。

-- A single-part schema name is rejected.
> SET PATH = my_schema;
  [INVALID_SQL_PATH_SCHEMA_REFERENCE]

-- A duplicate path element raises an error after expansion.
> SET PATH = SYSTEM_PATH, system.builtin;
  [DUPLICATE_SQL_PATH_ENTRY]