名稱
適用於：
Databricks SQL Databricks Runtime
識別 Azure Databricks 中不同類型的物件。
下列限制適用於 Unity 目錄中的所有物件名稱：
- 物件名稱不能超過 255 個字元。
- 不允許下列特殊字元：
- 期間 （
.） - 空間 （
- 正斜線 (
/) - 所有 ASCII 控制字元 （00-1F 十六進位）
- DELETE 字元 （7F 十六進位）
- 期間 （
- Unity 目錄會將所有物件名稱儲存為小寫。
- 在 SQL 中參考 UC 名稱時，您必須使用反引號來逸出包含特殊字元的名稱，例如連字元 （
-）。
注意
數據行名稱可以使用特殊字元，但如果使用特殊字元，則必須在所有 SQL 語句中使用反引號來逸出名稱。 Unity 目錄會保留資料行名稱大小寫，但 Unity 目錄數據表的查詢不區分大小寫。
連線名稱
識別外部連線。
外部連線可作為外部系統的連結，例如 PostgreSQL ，然後可用來參考其目錄、架構和數據表。
語法
connection_identifier
參數
範例
> CREATE CONNECTION my_postgresql ...;
目錄名稱
識別目錄。 目錄提供物件群組，這些物件可以進一步細分成架構。
語法
catalog_identifier
參數
範例
> USE CATALOG hive_metastore;
> CREATE CATALOG mycatalog;
-- Creating a catalog with a special character requires back ticks
> CREATE CATALOG `cat-a-log`;
-- Creating a catalog with non ASCII characters requires back ticks
> USE `目录`;
-- space (' '), '/', and '.' are not allowed in catalog names, even with back ticks.
> CREATE CATALOG `cat a log`;
ERROR
結構描述名稱
識別架構。 架構提供目錄中物件的群組。
語法
{ [ catalog_name . ] schema_identifier |
IDENTIFIER clause }
參數
- catalog_name：現有目錄的名稱。
- schema_identifier：可唯一識別架構的標識符。
- IDENTIFIER 子句：常數
STRING與架構名稱的對應。
在 中 hive_metastore 建立的架構只能包含英數位元 ASCII 字元和底線（INVALID_SCHEMA_OR_RELATION_NAME）。
範例
> USE SCHEMA default;
> CREATE SCHEMA my_sc;
-- In Hive Metastore, schema names must only consist of ASCII letters, digits and '_'
> CREATE SCHEMA hive_metastore.`a-b`;
Error: INVALID_SCHEMA_OR_RELATION_NAME
-- In Unity Catalog only space (' '), '/', and '.' are not allowed
> CREATE SCHEMA main.`a-b`;
> CREATE SCHEMA `a b`;
Error
-- Use back-ticks to reference or create schemas in Unity Catalog with non-ASCII characters
> CREATE SCHEMA `数据库架构`;
資料庫名稱
架構名稱的同義字。
雖然 使用 SCHEMA和 DATABASE 是可互換的， SCHEMA 但偏好使用 。
資料表名稱
識別數據表物件。 數據表可以使用 架構名稱限定 ，或使用 簡單的標識碼來限定 。
語法
{ [ schema_name . ] table_identifier [ temporal_spec ] |
IDENTIFIER clause [ temporal_spec ] |
{ file_format | `file_format` } . `path_to_table` [ temporal_spec ] [ credential_spec ] }
temporal_spec
{
@ timestamp_encoding |
@V version |
[ FOR ] { SYSTEM_TIMESTAMP | TIMESTAMP } AS OF timestamp_expression |
[ FOR ] { SYSTEM_VERSION | VERSION } AS OF version
}
credential_spec
WITH ( CREDENTIAL credential_name )
參數
table_identifier：指定數據表或table_alias名稱的識別碼。
file_format：、
csv、、avro、parquetorc、binaryFile、text、delta、（不區分大小寫）的其中一個json。path_to_table：文件系統中數據表的位置。 您必須擁有
ANY_FILE使用此語法的許可權。IDENTIFIER 子句：常數
STRING與數據表名稱的對應。temporal_spec：使用 時，參考指定時間點或版本上的 Delta 數據表。
您只能在查詢或 MERGE USING 的內容中使用時態規格。
credential_spec
您可以使用適用的認證來存取
path_to_table未內嵌於外部位置的 。-
用來存取儲存位置的認證名稱。
-
在 中 hive_metastore 建立的數據表只能包含英數位元 ASCII 字元和底線（INVALID_SCHEMA_OR_RELATION_NAME）。
如果名稱不限定且未參考已知的 數據表別名，Azure Databricks 會先嘗試解析目前架構中的數據表。
如果名稱以架構限定，Azure Databricks 會嘗試解析目前目錄中的數據表。
如需名稱解析的詳細資訊，請參閱 數據表和檢視解析 。
如果您針對不是 Delta Lake 格式的數據表使用 ， temporal_spec Azure Databricks 就會引發錯誤。
範例
-- A back quoted table name
> SELECT * FROM `Employees`;
-- A table name without back quotes
> SELECT * FROM employees;
-- A schema qualified table name
> SELECT * FROM hr.employees;
-- A schema qualified table name with back quotes for schema and table
> SELECT * FROM `hr`.`employees`;
-- A fully qualified table name
> SELECT * FROM hive_metastore.default.tab;
-- A reference to an information schema table.
> SELECT * FROM system.information_schema.columns;
-- Referencing a path as a table requires back ticks
> SELECT * FROM delta.`somedir/delta_table`;
> SELECT * FROM `csv`.`spreadsheets/data.csv`;
> SELECT * FROM `csv`.`spreadsheets/data.csv` WITH (CREDENTIAL some_credential)
-- Tables in `hive_metastore` can only contain alphanumeric ASCII characters and underscores
> CREATE TABLE hive_metastore.default.t1(c1 INT);
> CREATE TABLE hive_metastore.default.`表一`(c1 INT);
Error: INVALID_SCHEMA_OR_RELATION_NAME
-- Use back-ticks to reference or create tables in Unity Catalog with non ASCII characters
> CREATE TABLE main.`瑞赛奇`.`表一`(c1 INT);
檢視表名稱
識別檢視。 檢視可以使用 架構名稱限定 ，或使用 簡單的標識符來限定 。
語法
{ [ schema_name . ] view_identifier |
IDENTIFIER clause }
參數
- schema_name：包含檢視之架構的限定或未限定名稱。
- view_identifier：指定檢視名稱或 CTE 檢視識別碼的識別碼。
- IDENTIFIER 子句：常數
STRING與檢視名稱的對應。
在 中 hive_metastore 建立的檢視只能包含英數位元 ASCII 字元和底線（INVALID_SCHEMA_OR_RELATION_NAME）。
範例
-- A back quoted view name
> SELECT * FROM `Employees`;
-- A view name without back quotes
> SELECT * FROM employees;
-- A schema qualified view name
> SELECT * FROM hr.employees;
-- A schema qualified view name with back quotes for schema and table
> SELECT * FROM `hr`.`employees`;
-- A fully qualified view name
> SELECT * FROM hive_metastore.default.tab;
-- Views in `hive_metastore` can only contain alphanumeric ASCII characters and underscores
> CREATE VIEW hive_metastore.default.v1(c1) AS SELECT 1;
> CREATE VIEW hive_metastore.default.`数据库视图一`(c1 INT);
Error: INVALID_SCHEMA_OR_RELATION_NAME
-- Use back-ticks to reference or create tables in Unity Catalog with non ASCII characters
> CREATE VIEW main.`瑞赛奇`.`数据库视图一`(c1) AS SELECT 1;
資料行名稱
識別數據表或檢視表內的數據行。 數據行可以使用 數據表或檢視名稱限定 ，或使用 簡單的標識符來限定 。
語法
{ [ { table_name | view_name } . ] column_identifier |
IDENTIFIER clause }
參數
- table_name：包含數據行之數據表的限定或未限定數據表名稱。
- view_name：包含數據行之檢視的限定或未限定檢視名稱。
- column_identifier：指定數據行名稱的標識碼。
- IDENTIFIER 子句：常數
STRING與數據行名稱的對應。
識別的數據行必須存在於數據表或檢視表內。
Azure Databricks 支援特殊的 _metadata數據行。 此 結構類型的虛擬數據 行是每個數據表的一部分，可用來擷取數據表中數據列的相關元數據資訊。
警告
如果數據表架構包含名為 _metadata的數據行，查詢會從數據源傳回數據行，而不是檔案元數據。 _metadata無法存取虛擬數據行。
沒有資料行對應屬性 （'delta.columnMapping.mode' = 'name'） 之 Delta Lake 資料表中的數據行名稱不得包含字元' '（空格）、','、、、';'、'}''{'、'('、 ')'。 '\n''\t'和 '='。
數據表中的數據 AVRO 行名稱必須以 '_' 或 Unicode 字母開頭（包括非 ASCII 字母），後面接著 、Unicode 字母和數位的組合 '_'。
範例
-- An unqualified column name
> SELECT c1 FROM VALUES(1) AS T(c1);
c1
1
-- A qualified column name
> SELECT T.c1 FROM VALUES(1) AS T(c1);
c1
1
-- Using _metadata to retrieve information about rows retrieved from T.
> CREATE TABLE T(c1 INT);
> INSERT INTO T VALUES(1);
> SELECT T._metadata.file_size;
574
-- A delimited column name
> CREATE TABLE T(`sütun1`);
欄位名稱
識別結構內的欄位。 欄位必須符合包含欄位之結構的路徑。
語法
{ expr { . field_identifier [. ...] } |
IDENTIFIER clause }
參數
- expr：STRUCT 類型的表達式。
- field_identifier：指定功能變數名稱的識別碼。
- IDENTIFIER 子句：常數
STRING與功能變數名稱的對應。
藉由指定根結構路徑上的字段標識符，即可參考深度巢狀欄位。
Delta Lake 數據表中沒有資料行對應屬性 （'delta.columnMapping.mode' = 'name'） 的功能變數名稱不得包含字元' '（空格）、','、、、'{''}'';'、、'('、 。 ')' '\n''\t'和 '='。
數據表中的 AVRO 功能變數名稱必須以 '_' 或 Unicode 字母開頭（包括非 ASCII 字母），後面接著 、Unicode 字母和數位的組合 '_'。
範例
> SELECT addr.address.name
FROM VALUES (named_struct('address', named_struct('number', 5, 'name', 'Main St'),
'city', 'Springfield')) as t(addr);
Main St
-- Delimited field names with non ASCII letters
> CREATE TABLE T(c1 struct<`атрибут1` INT, `атрибут2`>);
> SELECT c1.`атрибут1` FROM T;
變數名稱
識別暫存（會話）變數。
變數可以使用架構名稱 （system.session或） session限定，或使用簡單的識別符來限定。
語法
{ [ schema_name . ] variable_identifier |
IDENTIFIER clause }
參數
範例
-- Declaring a session variable with a qualified name.
> DECLARE session.myvar = 5;
-- Setting a session variable with an unqualified name.
> SET VAR myvar = 6
-- Declaring a session variable with a fully qualified name an non-ASCII characters.
> DECLARE system.session.`圆周率` = 3.14;
函式名稱
識別函式。 函式可以使用 架構名稱限定 ，或使用 簡單的標識碼來限定 。
語法
{ [ schema_name . ] function_identifier |
IDENTIFIER clause }
參數
- schema_name：包含函式的限定或未限定架構名稱。
- function_identifier：指定函式名稱的標識碼。
- IDENTIFIER 子句：常數
STRING與函式名稱的對應。
在 中 hive_metastore 建立的函式只能包含英數位元 ASCII 字元和底線。
範例
-- Creating a SQL function with a qualified name
> CREATE FUNCTION math.myplus(x INT, y INT) RETURN x + y;
-- Invoking a function with an unqualified name
> SELECT myplus()
-- Creating a SQL function with non-ASCII characters;
> CREATE FUNCTION `圆周率`() RETURN 3.14;
參數名稱
識別 SQL 使用者定義函數主體中的參數（SQL UDF）。 函式可以使用 函式識別碼限定 ，或使用 簡單的標識符來限定 。
語法
[ function_identifier . ] parameter_identifier
參數
範例
-- Create a function with undelimited parameters and reference them as qualified and nonqualified.
> CREATE FUNCTION area(x INT, y INT) RETURNS INT
RETURN area.x + y;
-- Create a function with non-ASCII character parameters
> CREATE FUNCTION full_name(`prénom` STRING, `nom` STRING) RETURNS STRING
RETURN `prénom` + ' ' + `nom`;
數據表別名
標記數據表參考、查詢、數據表函式或其他關聯形式。
語法
[ AS ] table_identifier [ ( column_identifier1 [, ...] ) ]
參數
如果您提供數據行標識碼，其數目必須符合相符關聯性中的數據行數目。
如果您沒有提供數據行標識碼，其名稱會繼承自加上標籤的關聯性。
範例
-- Defining a table alias with column list
> SELECT a, b FROM VALUES (1, 2) AS t(a, b);
a b
1 2
-- Defining a table alias without column list
> DELETE FROM emp AS e WHERE e.c1 = 5;
-- Defining a table alias with non ASCII characters
> SELECT * FROM employee AS `직원`;
資料行別名
在清單中標記表達式SELECT的結果以供參考。
如果表達式是 數據表值產生器函式，則別名會將產生的數據行清單標示為標籤。
語法
[AS] column_identifier
[AS] ( column_identifier [, ...] )
參數
雖然數據行別名在選取清單中不需要是唯一的，但唯一性是依名稱參考別名的需求。
範例
-- An undelimited alias
> SELECT 1 AS a;
a
1
> SELECT 1 a, 2 b;
a b
1 2
-- A delimited alias with non-ASCII characters
> SELECT 3.14 AS `圆周率`;
a
1
-- Referencing a passed column alias
> SELECT a + a FROM (SELECT 1 AS a);
a
2
認證名稱
識別在外部位置存取記憶體的認證。
語法
credential_identifier
參數
範例
位置名稱
識別外部儲存位置。
語法
location_identifier
參數
範例
`s3-json-data`
s3_json_data
共用名稱
識別共用以存取提供者共享的數據。
語法
share_identifier
參數
範例
`public info`
`public-info`
public_info
提供者名稱
識別差異共用提供者。
語法
provider_identifier
參數
-
可唯一識別提供者的非限定標識碼。
範例
`Good Corp`
`Good-corp`
Good_Corp
收件者名稱
識別共用的收件者。
語法
recipient_identifier
參數
範例
`Good Corp`
`Good-corp`
Good_Corp
磁碟區名稱
識別 Unity 目錄磁碟區。 磁碟區可以使用 架構名稱限定 ，或使用 簡單標識符來限定 。
語法
[ schema_name .] volume_identifier
參數
範例
`myVolume`
`my-volume`
myschema.myVolume
my_unity_catalog.my_schema.my_volume
相關
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應