Nomes

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime

Identifica diferentes tipos de objetos no Azure Databricks.

As limitações a seguir se aplicam a todos os nomes de objetos no Unity Catalog:

  • Os nomes de objeto não podem exceder 255 caracteres.
  • Não são permitidos os seguintes caracteres especiais:
    • Período (.)
    • Espaço ( )
    • Barra (/)
    • Todos os caracteres de controle ASCII (00-1F hex)
    • O caractere DELETE (7F hex)
  • O Unity Catalog armazena todos os nomes de objetos em minúsculas.
  • Ao fazer referência a nomes de UC em SQL, você deve usar backticks para escapar de nomes que contenham caracteres especiais, como hífenes (-).

Nota

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

Nome da ligaçã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 fazer referência a 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

  • catalog_name: O nome de um catálogo existente.
  • schema_identifier: Um identificador que identifica exclusivamente o esquema.
  • Cláusula IDENTIFIER: Um mapeamento de constante STRING para um nome de esquema.

Os esquemas criados em hive_metastore só podem conter caracteres ASCII alfanuméricos 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 da base de dados

Um sinônimo para nome do esquema.

Enquanto o uso de SCHEMA, e DATABASE é intercambiável, SCHEMA é preferível.

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

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 dos json, csv, , avro, parquet, binaryFileorc, , text( delta sem distinção entre maiúsculas e minúsculas).

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

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

  • temporal_spec: Quando usado faz referência a uma tabela Delta no ponto no tempo ou versão especificados.

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

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

  • credential_spec

    Você pode usar uma credencial aplicável para obter acesso a um path_to_table que não esteja incorporado em um local externo.

    • credential_name

      O nome da credencial usada para acessar o local de armazenamento.

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

Se o nome não for 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 resolução de nomes.

O Azure Databricks gera um erro se você usar um temporal_spec para uma tabela que não esteja 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)

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

View name

Identifica um modo de 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 o modo de exibição.
  • view_identifier: Um identificador que especifica o nome do modo de exibição ou o identificador de exibição de um CTE.
  • Cláusula IDENTIFIER: Um mapeamento de constante STRING para um nome de exibição.

As vistas criadas em hive_metastore só podem conter carateres 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 dentro de 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 de tabela qualificado ou não qualificado da tabela que contém a coluna.
  • view_name: Um nome de modo de exibição qualificado ou não qualificado do modo de 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. Esta pseudo coluna do tipo struct faz parte de todas as tabelas 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 _metadata pseudocoluna não estará acessível.

Os nomes de colunas em 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 da coluna nas AVRO tabelas deve começar com '_' ou uma letra Unicode (incluindo letras não-ASCII) e ser seguido 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 uma estrutura. O campo deve ser qualificado com o caminho até a estrutura que contém o campo.

Sintaxe

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

Parâmetros

  • expr: Uma expressão do tipo STRUCT.
  • field_identifier: Um identificador que especifica o nome do campo.
  • Cláusula IDENTIFIER: Um mapeamento de constante STRING para um nome de campo.

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

Os nomes de campo em 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 do campo nas AVRO tabelas deve começar com '_' ou uma letra Unicode (incluindo letras não-ASCII) e ser seguido 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 ser qualificada com um nome de esquema (system.session ou session), ou não qualificada usando 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

  • schema_name: Um nome de esquema qualificado ou não qualificado que contém a função.
  • function_identifier: Um identificador que especifica o nome da função.
  • Cláusula IDENTIFIER: Um mapeamento de constante STRING para um nome de função.

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

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 SELECT lista para referência.

Se a expressão for uma função geradora de valores de tabela, o alias rotula a lista de colunas produzidas.

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 fazer referência a um alias pelo 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.

Sintaxe

credential_identifier

Parâmetros

Exemplos

Nome do local

Identifica um local de armazenamento externo.

Sintaxe

location_identifier

Parâmetros

  • location_identifier: Um identificador não qualificado que identifica exclusivamente o local.

Exemplos

`s3-json-data`

s3_json_data

Nome da partilha

Identifica um compartilhamento para acessar dados compartilhados por um provedor.

Sintaxe

share_identifier

Parâmetros

  • share_identifier: Um identificador não qualificado que identifica exclusivamente o compartilhamento.

Exemplos

`public info`

`public-info`

public_info

Nome do fornecedor

Identifica um provedor de compartilhamento Delta.

Sintaxe

provider_identifier

Parâmetros

  • provider_identifier

    Um identificador não qualificado que identifica exclusivamente o provedor.

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 exclusivamente o destinatário.

Exemplos

`Good Corp`

`Good-corp`

Good_Corp

Nome do volume

Identifica um volume do Catálogo Unity. O volume pode ser qualificado com um nome de esquema ou não qualificado 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.
  • volume_identifier: Um identificador não qualificado que identifica exclusivamente o volume dentro do esquema.

Exemplos

`myVolume`

`my-volume`

myschema.myVolume

my_unity_catalog.my_schema.my_volume