Lakehouse 对象命名规则

在 Lakehouse 中，为了确保元数据（如数据库、表、视图、用户等）的命名一致性和可读性，避免潜在的问题，制定了一套命名规则。本文档将详细介绍这些规则，帮助你更好地理解和使用 Lakehouse。

标识符类型

Lakehouse支持以下类型的标识符命名：

• 常规标识符：不需要引号，但必须符合特定的命名规则。
• 双引号标识符：需要使用双引号（"）包围起来，允许使用关键字作为标识符名称。默认关闭，需通过

  SET cz.sql.double.quoted.identifiers=true

  SET cz.sql.double.quoted.identifiers=true
  开启（仅会话级别）。注意：开启后双引号不再表示字符串，

  "hello"

  "hello"
  会被解析为标识符而非字符串值。
• 反引号标识符：需要使用反引号（`）包围起来。对于列名，反引号可以包含任何字符（连字符、空格、中文、数字开头等）；对于表名、schema 名等对象名，反引号只能绕过关键字限制和数字开头限制，连字符、空格、中文等特殊字符仍然不被允许。默认使用反引号，可通过设置切换为双引号（

  SET cz.sql.double.quoted.identifiers=true

  SET cz.sql.double.quoted.identifiers=true
  ）。

命名规则

常规标识符的命名规范

1. 开头字符：标识符必须以字母（包括大写A-Z、小写a-z）或下划线（"_"）作为起始字符。不允许以数字或其他特殊字符开始。
2. 字符组成：标识符中只能包含字母、下划线和十进制数字（0-9）。不允许使用其他特殊字符和关键字，如连字符（-）、空格或其他非字母数字字符。
3. 大小写敏感性：元数据在存储时会进行大小写转换。大多数对象（schema、table、view、column 等）存储时转为小写；VCluster 名称例外，存储时转为大写。在引用时不区分大小写，

   MyTable

   MyTable
   和

   mytable

   mytable
   视为相同标识符。反引号也不能保留大小写。注意：SELECT 查询中的列别名（

   AS MyAlias

   AS MyAlias
   ）保留原始大小写，不做转换。
4. 语言限制：不支持中文字符
5. 长度限制： 长度为1～256个字符，WORKSPACE NAME长度限制3～28个字符

以下是几个合法的标识符示例：

my_table table1 table_2

反引号标识符

反引号的作用因对象类型不同而有所区别：

对列名：反引号可以绕过所有命名限制，允许使用连字符、空格、中文、数字开头等任意字符：

CREATE TABLE my_table( `my-col` INT, `my col` STRING, `中文列` DATE, `123col` BIGINT )

对表名、schema 名等对象名：反引号只能绕过关键字限制和数字开头限制，连字符、空格、中文等特殊字符仍然不被允许：

-- 允许数字开头 CREATE SCHEMA `123`; -- 允许使用关键字作为名称 CREATE SCHEMA `select`; -- 列名使用中文（仅列名支持） CREATE TABLE my_table(`中文列` STRING);

`MyTable`

mytable

建议只在必要时才使用反引号。

双引号标识符

开启

SET cz.sql.double.quoted.identifiers=true

• 双引号不再表示字符串，

  "hello"

  "hello"
  会被解析为标识符（列名/对象名）而非字符串值
• 使用双引号创建的关键字对象，引用时必须带双引号

-- 开启双引号标识符模式 SET cz.sql.double.quoted.identifiers=true; -- 使用关键字作为 schema 名 CREATE SCHEMA "select"; -- 引用时必须带双引号 SELECT * FROM "select".my_table;

各个对象的命名规范

实例INSTANCE NAME

WORKSPACE

SCHEMA

TABLE

VIEW

VIRTUAL CLUSTER

COLUMN

`中文列`

VOLUME

FUNCTION

ROLE

USER

INDEX