次の方法で共有

名前

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

Azure Databricks 内のさまざまな種類のオブジェクトを識別します。

Unity Catalogのすべてのオブジェクト名には、次の制限が適用されます。

  • オブジェクト名は、255 文字以内である必要があります。
  • 次の特殊文字は使用できません:
    • ピリオド (.)
    • 空白 ( )
    • スラッシュ (/)
    • すべての ASCII 制御文字 (16 進数 00 から 1F)
    • DELETE 文字 (16 進数 7F)
  • Unity Catalog では、すべてのオブジェクト名が小文字で格納されます。
  • SQL で UC 名を参照する場合は、バッククォートを使用して、ハイフン (-) などの特殊文字を含む名前をエスケープする必要があります。

Note

Column 名には特殊文字を使用できますが、特殊文字を使用する場合は、すべての SQL ステートメントでバックティックを使用して名前をエスケープする必要があります。 Unity Catalog では column の名前における大文字と小文字が保持されますが、Unity Catalogtables に対するクエリは大文字と小文字を区別しません。

[接続名]

外部接続を特定します。 外部接続は、PostgreSQL などの外部システムへのリンクとして機能し、その catalogs、スキーマ、および tablesを参照するために使用できます。

構文

connection_identifier

Parameters

例

> CREATE CONNECTION my_postgresql ...;

Catalog 名前

catalogを識別します。 catalog は、さらにスキーマに分割できるオブジェクトのグループ化を提供します。

構文

catalog_identifier

Parameters

例

> 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

Schema 名前

schemaを識別します。 schema は、catalog内のオブジェクトのグループ化を提供します。

構文

{ [ catalog_name . ] schema_identifier |
  IDENTIFIER clause }

Parameters

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 名の同意語。

SCHEMA と DATABASE 交換して使用できますが、SCHEMA をお勧めします。

Table 名前

table オブジェクトを識別します。 table は schema 名で "修飾" することや、単純な identifier を使用して "非修飾" にすることができます。

構文

{ [ schema_name . ] table_identifier |
  IDENTIFIER clause |
  { file_format | `file_format` } . `path_to_table` } [ temporal_spec ] [ options_spec ] }

temporal_spec
{
  @ timestamp_encoding |
  @V version |
  [ FOR ] { SYSTEM_TIMESTAMP | TIMESTAMP } AS OF timestamp_expression |
  [ FOR ] { SYSTEM_VERSION | VERSION } AS OF version
}

options_spec
  WITH ( { option_key [ = ] option_val } [, ...] )

option_key
  { identifier [. ...] | string_literal }

Parameters

  • schema_name: tableを含む修飾または非修飾の schema 名。

  • table_identifier: table または table_alias の名前を指定する identifier。

  • file_format: json、csv、avro、parquet、orc、binaryFile、text、delta のいずれか (大文字と小文字は区別されません)。

  • path_to_table: ファイル システム内の table の場所。 この構文を使用するには ANY_FILE アクセス許可が必要です。

  • IDENTIFIER 条項: 定数 STRING を table 名にマップします。

  • temporal_spec: 使用すると、指定した時点またはバージョンでデルタ table が参照されます。

    テンポラル仕様は、クエリまたは MERGE USING のコンテキスト内でのみ使用できます。

    • @ timestamp_encoding: yyyyMMddHHmmssSSS 形式でタイムスタンプをエンコードする正の BIGINT リテラル。
    • @V バージョン: デルタ tableのバージョンを識別する正の整数リテラル。
    • timestamp_expression: TIMESTAMP に評価される単純な式。 timestamp_expressiom は定数式である必要がありますが、current_date() または current_timestamp() を含めることができます。
    • バージョン: デルタ tableのバージョンを識別する整数リテラルまたは文字列リテラル。

  • option_spec: 使用すると、ストレージの場所にアクセスするための資格情報や、'write.split-size'の動作を制御するためのINSERTなどのデータ ソースに渡されるディレクティブを定義します。

    • option_key

      オプション キー。 キーは、ドットで区切られた 1 つまたは複数の識別子、あるいは文字列リテラルで構成できます。

      オプション キーは一意である必要があり、大文字と小文字が区別されます。

    • option_val

      オプションの値。 BOOLEAN、STRING、INTEGER、またはDECIMALの定数式。

hive_metastore で作成された Tables には、英数字の ASCII 文字とアンダースコア (INVALID_SCHEMA_OR_RELATION_NAME) のみを含めることができます。

名前が修飾されておらず、既知の table エイリアスを参照していない場合、Azure Databricks は最初に現在の schemaの table の解決を試みます。

名前が schemaで修飾されている場合、Azure Databricks は現在の catalogの table の解決を試みます。

名前解決の詳細について知るには、Table を参照し、解決策については をご覧ください。

Delta Lake 形式ではない table に 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)

> INSERT INTO t WITH ('write.split-size' 10) SELECT * FROM s;

-- 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 名で "修飾" することや、単純な identifier を使用して "非修飾" にすることができます。

構文

{ [ schema_name . ] view_identifier |
  IDENTIFIER clause }

Parameters

  • schema_name: ビューを含む schema の修飾名または非修飾名。
  • view_identifier: ビューの名前または CTE のビューの identifier を指定する identifier。
  • IDENTIFIER 句: ビュー名への定数 STRING のマッピング。

hive_metastore で作成された Views には、英数字の 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;

Column 名前

column を table またはビュー内で識別します。 column は、table またはビュー名で "修飾" することや、単純な identifier を使用して "非修飾" にすることができます。

構文

{ [ { table_name | view_name } . ] column_identifier |
  IDENTIFIER clause }

Parameters

  • table_name: column を含む table の修飾または非修飾の table 名。
  • view_name: columnを含むビューの修飾ありまたは修飾なしのビュー名。
  • column_identifier: column の名前を指定する identifier。
  • IDENTIFIER 句: 定数 STRING の column 名へのマッピング。

識別された column は、table またはビュー内に存在する必要があります。

Azure Databricks では、特別な _metadata columnがサポートされています。 この 構造体型の擬似 column はすべての table の一部であり、table内の行に関するメタデータ情報を取得するために使用できます。

警告

tableschema に _metadataという名前の column が含まれている場合、クエリはファイル メタデータではなく、データ ソースから column を返します。 _metadata 擬似 column にはアクセスできません。

マッピング プロパティ ('delta.columnMapping.mode' = 'name') column のない Delta Lake tables の Column 名には、文字 ' ' (スペース)、','、';'、'{'、'}'、'('、')'を含めてはなりません。 '\n'、 '\t'、および '='。

AVROtables の Column 名は、'_' または 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 }

Parameters

  • expr: STRUCT 型の式。
  • field_identifier: フィールドの名前を指定する identifier。
  • IDENTIFIER 句: 定数 STRING のフィールド名へのマッピング。

深く入れ子になったフィールドは、ルート構造体へのパスに沿って identifier フィールドを指定することで参照できます。

column マッピング プロパティ ('delta.columnMapping.mode' = 'name') のない Delta Lake tables のフィールド名には、文字 ' ' (スペース)、','、';'、'{'、'}'、'('、')' を含めてはなりません。 '\n'、 '\t'、および '='。

AVROtables のフィールド名は、'_' または 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;

変数名

一時 (セッション) 変数を識別します。 変数は、schema 名 (system.session または session) で "修飾" することや、単純な identifier を使用して "非修飾" にすることができます。

構文

{ [ schema_name . ] variable_identifier |
  IDENTIFIER clause }

Parameters

  • schema_name: すべての一時変数を含む system.session または session。
  • variable_identifier: 変数の名前を指定する identifier。

例


-- 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 名で "修飾" することや、単純な identifier を使用して "非修飾" にすることができます。

構文

{ [ schema_name . ] function_identifier |
  IDENTIFIER clause }

Parameters

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) の本文のパラメーターを識別します。 関数は、関数 identifier で "修飾" することや、単純な identifier で "非修飾" にすることができます。

構文

[ function_identifier . ] parameter_identifier

Parameters

例

-- 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`;

Table エイリアス

table 参照、クエリ、table 関数、またはその他の形式のリレーションにラベルを付けます。

構文

[ AS ] table_identifier [ ( column_identifier1 [, ...] ) ]

Parameters

column 識別子を指定する場合、その数は一致するリレーションシップ内の columns の数と一致する必要があります。

column 識別子を指定しない場合、その名前はラベル付きリレーションシップから継承されます。

例

-- 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 `직원`;

Column エイリアス

参照用に SELECTlist 内の式の結果にラベルを付けます。

式が 値ジェネレーター関数である場合、エイリアスは生成された の にラベルを付けます。

構文

[AS] column_identifier

[AS] ( column_identifier [, ...] )

Parameters

column エイリアスは selectlist内で一意である必要はありませんが、一意性はエイリアスを名前で参照する必要があります。

例

-- 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

照合順序名

column または式の照合順序を識別します。

構文

collation_identifier

Parameters

サポートされている照合順序の list については、「サポートされている照合順序 」を参照してください。 照合順序の詳細については、「照合順序」を参照してください。

例

> SELECT 'hello' COLLATE UNICODE_CI;
  hello

Credential name (資格情報名)

プロバイダー SDK を使用して、外部の場所またはクラウド サービスのストレージにアクセスするための資格情報を識別します。

構文

credential_identifier

Parameters

例

`my_storage_cred`

my_storage_cred

場所の名前

外部の保存場所を識別します。

構文

location_identifier

Parameters

例

`s3-json-data`

s3_json_data

共有名

プロバイダーによって共有されるデータにアクセスするための共有を識別します。

構文

share_identifier

Parameters

例

`public info`

`public-info`

public_info

プロバイダー名

Delta 共有プロバイダーを識別します。

構文

provider_identifier

Parameters

例

`Good Corp`

`Good-corp`

Good_Corp

受信者名

共有の受信者を識別します。

構文

recipient_identifier

Parameters

例

`Good Corp`

`Good-corp`

Good_Corp

クリーン ルーム名

コラボレーターの set に対応するクリーンルームを識別します。

構文

clean_room_identifier

Parameters

  • clean_room_identifier: コラボレーターの metastores のクリーン ルームを一意に指定する非修飾の identifier。

例

`Clean-Room`

Clean_Room

ボリューム名

Unity Catalog ボリュームを識別します。 ボリュームは、schema 名で "修飾" することや、単純な identifier を使用して "非修飾" にすることができます。

構文

[ schema_name .] volume_identifier

Parameters

  • schema_name: ボリュームを含む修飾または非修飾の schema 名。
  • volume_identifier: schema内でボリュームを一意に識別する無条件の identifier。

例

`myVolume`

`my-volume`

myschema.myVolume

my_unity_catalog.my_schema.my_volume