SQL 标识符

SQL 标识符是用于 Databend 中不同元素的名称，如表、视图和数据库。

未加引号与双引号标识符

未加引号的标识符以字母（A-Z, a-z）或下划线（“_”）开头，可以包含字母、下划线、数字（0-9）或美元符号（“$”）。

示例：

mydatabend
MyDatabend1
My$databend
_my_databend

双引号标识符可以包含广泛的字符，如数字（0-9）、特殊字符（如句点（.）、单引号（'）、感叹号（!）、at 符号（@）、井号（#）、美元符号（$）、百分号（%）、插入符号（^）和和号（&））、扩展 ASCII 和非 ASCII 字符，以及空格。

示例：

"MyDatabend"
"my.databend"
"my databend"
"My 'Databend'"
"1_databend"
"$Databend"

注意，使用双反引号（``）或双引号（"）是等效的：

示例：

`MyDatabend`
`my.databend`
`my databend`
`My 'Databend'`
`1_databend`
`$Databend`

标识符大小写规则

Databend 默认将未加引号的标识符存储为小写，双引号标识符按照输入时的样子存储。换句话说，Databend 将对象名称，如数据库、表和列，视为大小写不敏感。如果你希望 Databend 将它们视为大小写敏感，请使用双引号。

备注

Databend 允许你控制标识符的大小写敏感性。有两个关键设置可用：

• unquoted_ident_case_sensitive：将此选项设置为 1，可以保留未加引号标识符的字符大小写，确保它们是大小写敏感的。如果保留默认值 0，未加引号的标识符保持大小写不敏感，转换为小写。

• quoted_ident_case_sensitive：通过将此选项设置为 0，你可以指示双引号标识符不应保留字符的大小写，使它们大小写不敏感。

此示例演示了 Databend 在创建和列出数据库时如何处理标识符的大小写：

-- 创建一个名为 "databend" 的数据库
CREATE DATABASE databend;

-- 尝试创建一个名为 "Databend" 的数据库
CREATE DATABASE Databend;

>> SQL Error [1105] [HY000]: DatabaseAlreadyExists. Code: 2301, Text = Database 'databend' already exists.

-- 创建一个名为 "Databend" 的数据库
CREATE DATABASE "Databend";

-- 列出所有数据库
SHOW DATABASES;

databases_in_default|
--------------------+
Databend            |
databend            |
default             |
information_schema  |
system              |

此示例演示了 Databend 如何处理表和列名称的标识符大小写，通过默认的大小写敏感性和使用双引号来区分不同大小写的标识符：

-- 创建一个名为 "databend" 的表
CREATE TABLE databend (a INT);
DESC databend;

Field|Type|Null|Default|Extra|
-----+----+----+-------+-----+
a    |INT |YES |NULL   |     |

-- 尝试创建一个名为 "Databend" 的表
CREATE TABLE Databend (a INT);

>> SQL Error [1105] [HY000]: TableAlreadyExists. Code: 2302, Text = Table 'databend' already exists.

-- 尝试创建一个表，其中一个列名为 "a"，另一个列名为 "A"
CREATE TABLE "Databend" (a INT, A INT);

>> SQL Error [1105] [HY000]: BadArguments. Code: 1006, Text = Duplicated column name: a.

-- 双引号列名
CREATE TABLE "Databend" ("a" INT, "A" INT);
DESC "Databend";

Field|Type|Null|Default|Extra|
-----+----+----+-------+-----+
a    |INT |YES |NULL   |     |
A    |INT |YES |NULL   |     |

字符串标识符

在 Databend 中，管理字符串项（如文本和日期）时，将它们用单引号（'）括起来是标准做法。

INSERT INTO weather VALUES ('San Francisco', 46, 50, 0.25, '1994-11-27');

SELECT 'Databend';

'databend'|
----------+
Databend  |

SELECT "Databend";

>> SQL Error [1105] [HY000]: SemanticError. Code: 1065, Text = error:
  --> SQL:1:73
  |
1 | /* ApplicationName=DBeaver 23.2.0 - SQLEditor <Script-12.sql> */ SELECT "Databend"
  |                                                                         ^^^^^^^^^^ column Databend doesn't exist, do you mean 'Databend'?

默认情况下，Databend SQL 方言是 PostgreSQL：

SHOW SETTINGS LIKE '%sql_dialect%';

name       |value     |default   |level  |description                                                                      |type  |
-----------+----------+----------+-------+---------------------------------------------------------------------------------+------+
sql_dialect|PostgreSQL|PostgreSQL|SESSION|设置 SQL 方言。可用值包括 "PostgreSQL"、"MySQL" 和 "Hive"。|String|

你可以将其更改为 MySQL 以启用双引号（"`"）：

SET sql_dialect='MySQL';

SELECT "demo";
+--------+
| 'demo' |
+--------+
| demo   |
+--------+