Compartilhar via

Nomes

  • Artigo

Aplica-se a: marca de seleção positiva Databricks SQL marca de seleção positiva Azure Databricks Runtime

Identifica diferentes tipos de objetos no Azure Databricks.

As seguintes limitações se aplicam a todos os nomes de objeto no Catálogo do Unity:

  • Os nomes de objetos não podem exceder 255 caracteres.
  • Os seguintes caracteres especiais não são permitidos:
    • Período (.)
    • Space ( )
    • Barra (/)
    • Todos os caracteres de controle ASCII (00-1F hex)
    • O caractere DELETE (7F hex)
  • O Catálogo do Unity armazena todos os nomes de objeto como minúsculas.
  • Ao referenciar nomes UC no SQL, você deve usar backticks para escapar de nomes que contêm caracteres especiais, como hifens (-).

Observação

Os nomes de coluna podem usar caracteres especiais, mas o nome deve ser escapado com backticks em todas as instruções SQL se caracteres especiais forem usados. O Catálogo do Unity preserva o uso de maiúsculas e minúsculas de nome de coluna, mas as consultas em tabelas do Catálogo do Unity não diferenciam maiúsculas de minúsculas.

Nome da conexão

Identifica uma conexão estrangeira. Uma conexão estrangeira serve como um link para um sistema estrangeiro, como PostgreSQL e pode ser usada para referenciar seus catálogos, esquemas e tabelas.

Sintaxe

connection_identifier

Parâmetros

Exemplos

> CREATE CONNECTION my_postgresql ...;

Nome do catálogo

Identifica um catálogo. Um catálogo fornece um agrupamento de objetos que podem ser subdivididos em esquemas.

Sintaxe

catalog_identifier

Parâmetros

Exemplos

> 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

Nome do esquema

Identifica um esquema. Um esquema fornece um agrupamento de objetos em um catálogo.

Sintaxe

{ [ catalog_name . ] schema_identifier |
  IDENTIFIER clause }

Parâmetros

Esquemas criados em hive_metastore só podem conter caracteres alfanuméricos ASCII e sublinhados (INVALID_SCHEMA_OR_RELATION_NAME).

Exemplos

> 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 `数据库架构`;

Nome do banco de dados

Um sinônimo de nome de esquema.

Embora o uso de SCHEMA e DATABASE seja intercambiável, SCHEMA é preferencial.

Nome da tabela

Identifica um objeto de tabela. A tabela pode ser qualificada com um nome de esquema ou não qualificada usando um identificador simples.

Sintaxe

{ [ 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 }

Parâmetros

  • schema_name: um nome de esquema qualificado ou não qualificado que contém a tabela.

  • table_identifier: um identificador que especifica o nome da tabela ou table_alias.

  • file_format: um de json, csv, avro, parquet, orc, binaryFile, text, delta (não diferencia maiúsculas de minúsculas).

  • path_to_table: o local da tabela no sistema de arquivos. Você deve ter a permissão ANY_FILE para usar essa sintaxe.

  • Cláusula IDENTIFIER: um mapeamento de STRING constante para um nome de tabela.

  • temporal_spec: quando usado faz referência a uma tabela Delta no ponto ou versão especificado.

    Você pode usar uma especificação temporal somente dentro do contexto de uma consulta ou um MERGE USING.

    • @ timestamp_encoding: um literal BIGINT positivo que codifica um carimbo de data/hora no formato yyyyMMddHHmmssSSS.
    • @V version: um literal Inteiro positivo que identifica a versão da tabela Delta.
    • timestamp_expression: uma expressão simples que é avaliada como um TIMESTAMP. timestamp_expressiom deve ser uma expressão constante, mas pode conter current_date() ou current_timestamp().
    • version: um literal ou literal de cadeia de caracteres Inteiro que identifica a versão da tabela Delta.

  • option_spec: Quando usado, define diretivas a serem passadas para uma fonte de dados, como uma credencial para acessar um local de armazenamento ou 'write.split-size' para controlar INSERT o comportamento.

    • option_key

      A chave de opção. A chave pode consistir em um ou mais identificadores separados por um ponto ou um literal de cadeia de caracteres.

      As chaves de opção devem ser exclusivas e diferenciar maiúsculas de minúsculas.

    • option_val

      O valor para a opção. Uma expressão constante do tipo BOOLEAN, STRING, INTEGER, ou DECIMAL.

Tabelas criadas em hive_metastore só podem conter caracteres alfanuméricos ASCII e sublinhados (INVALID_SCHEMA_OR_RELATION_NAME).

Se o nome for não qualificado e não fizer referência a um alias de tabela conhecido, o Azure Databricks primeiro tentará resolver a tabela no esquema atual.

Se o nome for qualificado com um esquema, o Azure Databricks tentará resolver a tabela no catálogo atual.

Consulte Resolução de tabela e exibição para obter mais informações sobre a resolução de nomes.

O Azure Databricks gera um erro se você usar um temporal_spec para uma tabela que não está no formato Delta Lake.

Exemplos

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

Nome da exibição

Identifica uma exibição. A exibição pode ser qualificada com um nome de esquema ou não qualificada usando um identificador simples.

Sintaxe

{ [ schema_name . ] view_identifier |
  IDENTIFIER clause }

Parâmetros

  • schema_name: o nome qualificado ou não qualificado do esquema que contém a exibição.
  • view_identifier: um identificador que especifica o nome da exibição ou o identificador de exibição de uma CTE.
  • Cláusula IDENTIFIER: um mapeamento de constante STRING para um nome de exibição.

As exibições criadas em hive_metastore podem conter apenas caracteres ASCII alfanuméricos e sublinhados (INVALID_SCHEMA_OR_RELATION_NAME).

Exemplos

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

Nome da coluna

Identifica uma coluna em uma tabela ou exibição. A coluna pode ser qualificada com um nome de tabela ou exibição, ou não qualificada usando um identificador simples.

Sintaxe

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

Parâmetros

  • table_name: um nome qualificado ou não qualificado da tabela que contém a coluna.
  • view_name: um nome qualificado ou não qualificado da exibição que contém a coluna.
  • column_identifier: um identificador que especifica o nome da coluna.
  • Cláusula IDENTIFIER: um mapeamento de constante STRING para um nome de coluna.

A coluna identificada deve existir dentro da tabela ou exibição.

O Azure Databricks dá suporte a uma coluna _metadata especial. Essa pseudocoluna do tipo struct faz parte de cada tabela e pode ser usada para recuperar informações de metadados sobre as linhas na tabela.

Aviso

Se o esquema de tabela contiver uma coluna chamada _metadata, as consultas retornarão a coluna da fonte de dados, e não os metadados do arquivo. A pseudo-coluna _metadata não estará acessível.

Os nomes de coluna das tabelas Delta Lake sem propriedade de mapeamento de coluna ('delta.columnMapping.mode' = 'name') não devem conter os caracteres ' ' (espaço), ',', ';', '{', '}', '(', ')'. '\n', '\t'e '='.

O nome de coluna na tabela AVRO devem começar com '_' ou uma letra Unicode (incluindo letras não-ASCII) e ser seguidos por uma combinação de '_', letras e dígitos Unicode.

Exemplos

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

Nome do campo

Identifica um campo dentro de um struct. O campo precisa ser qualificado com o caminho até o struct que contém o campo.

Sintaxe

{ expr { . field_identifier [. ...] } |
  IDENTIFIER clause }

Parâmetros

Um campo profundamente aninhado pode ser referenciado especificando o identificador de campo ao longo do caminho para o struct raiz.

Os nomes de campo das tabelas Delta Lake sem propriedade de mapeamento de coluna ('delta.columnMapping.mode' = 'name') não devem conter os caracteres ' ' (espaço), ',', ';', '{', '}', '(', ')'. '\n', '\t'e '='.

O nome de campo na tabela AVRO devem começar com '_' ou uma letra Unicode (incluindo letras não ASCII) e ser seguidos por uma combinação de '_', letras e dígitos Unicode.

Exemplos

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

Nome da variável

Identifica uma variável temporária (sessão). A variável pode estar qualificada com um nome de esquema (system.session ou session) ou não qualificada utilizando um identificador simples.

Sintaxe

{ [ schema_name . ] variable_identifier |
  IDENTIFIER clause }

Parâmetros

  • schema_name: system.session ou session que contém todas as variáveis temporárias.
  • variable_identifier: um identificador que especifica o nome da variável.

Exemplos


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

Nome da função

Identifica uma função. A função pode ser qualificada com um nome de esquema ou não qualificada usando um identificador simples.

Sintaxe

{ [ schema_name . ] function_identifier |
  IDENTIFIER clause }

Parâmetros

As funções criadas em hive_metastore só podem conter caracteres ASCII alfanuméricos e sublinhados.

Exemplos

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

Nome do parâmetro

Identifica um parâmetro no corpo de uma função SQL definida pelo usuário (SQL UDF). A função pode ser qualificada com um identificador de função ou não qualificada usando um identificador simples.

Sintaxe

[ function_identifier . ] parameter_identifier

Parâmetros

Exemplos

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

Alias de tabela

Rotula uma referência de tabela, consulta, função de tabela ou outra forma de uma relação.

Sintaxe

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

Parâmetros

Se você fornecer identificadores de coluna, seu número deverá corresponder ao número de colunas na relação de combinação.

Se você não fornecer identificadores de coluna, seus nomes serão herdados da relação rotulada.

Exemplos

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

Alias de coluna

Rotula o resultado de uma expressão em uma lista SELECT para referência.

Se a expressão for uma função de gerador com valor de tabela, o alias rotulará a lista de colunas produzida.

Sintaxe

[AS] column_identifier

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

Parâmetros

Embora os aliases de coluna não precisem ser exclusivos na lista de seleção, a exclusividade é um requisito para referenciar um alias por nome.

Exemplos

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

Nome da credencial

Identifica uma credencial para acessar o armazenamento em um local externo ou serviços de nuvem com SDKs de provedor.

Sintaxe

credential_identifier

Parâmetros

  • credential_identifier: um identificador não qualificado que identifica a credencial de modo exclusivo.

Exemplos

`my_storage_cred`

my_storage_cred

Nome da localização

Identifica um local de armazenamento externo.

Sintaxe

location_identifier

Parâmetros

  • location_identifier: um identificador não qualificado que identifica o local de modo exclusivo.

Exemplos

`s3-json-data`

s3_json_data

Nome do compartilhamento

Identifica um compartilhamento para acessar os dados compartilhados por um provedor.

Sintaxe

share_identifier

Parâmetros

  • share_identifier: um identificador não qualificado que identifica o compartilhamento de modo exclusivo.

Exemplos

`public info`

`public-info`

public_info

Nome do provedor

Identifica um provedor do Delta Sharing.

Sintaxe

provider_identifier

Parâmetros

  • provider_identifier

    Um identificador não qualificado que identifica o provedor de modo exclusivo.

Exemplos

`Good Corp`

`Good-corp`

Good_Corp

Nome do destinatário

Identifica um destinatário para um compartilhamento.

Sintaxe

recipient_identifier

Parâmetros

  • recipient_identifier: um identificador não qualificado que identifica o destinatário de modo exclusivo.

Exemplos

`Good Corp`

`Good-corp`

Good_Corp

Nome da Sala Limpa

Identifica uma sala limpa para um conjunto de colaboradores.

Sintaxe

clean_room_identifier

Parâmetros

  • clean_room_identifier: Um identificador não qualificado que especifica exclusivamente a sala limpa nos metastores dos colaboradores.

Exemplos

`Clean-Room`

Clean_Room

Nome do volume

Identifica um volume do Catálogo do Unity. A tabela pode ser qualificada com um nome de esquema ou não qualificada usando um identificador simples.

Sintaxe

[ schema_name .] volume_identifier

Parâmetros

  • schema_name: um nome de esquema qualificado ou não qualificado que contém o volume.
  • share_identifier: um identificador não qualificado que identifica o volume dentro do esquema.

Exemplos

`myVolume`

`my-volume`

myschema.myVolume

my_unity_catalog.my_schema.my_volume