Namen

  • Artikel
  • 6 minuten om te lezen

Van toepassing op:controleren met ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime

Identificeert verschillende soorten objecten in Azure Databricks.

Catalogusnaam

Identificeert een catalogus. Een catalogus biedt een groepering van objecten die verder kunnen worden onderverdeeld in schema's.

Syntaxis

catalog_identifier

Parameters

Voorbeelden

> USE CATALOG hive_metastore;

> CREATE CATALOG mycatalog;

Schemanaam

Identificeert een schema. Een schema biedt een groepering van objecten in een catalogus.

Syntaxis

[ catalog_name . ] schema_identifier

Parameters

Voorbeelden

> USE SCHEMA default;

> CREATE SCHEMA my_sc;

Databasenaam

Een synoniem voor schemanaam.

Hoewel het gebruik van SCHEMAen uitwisselbaar DATABASE is, SCHEMA heeft de voorkeur.

Tabelnaam

Identificeert een tabelobject. De tabel kan worden gekwalificeerd met een schemanaam of niet-gekwalificeerd met behulp van een eenvoudige id.

Syntaxis

{ [ schema_name . ] table_identifier [ 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 )

Parameters

  • schema_name: een gekwalificeerde of niet-gekwalificeerde schemanaam die de tabel bevat.

  • table_identifier: een id die de naam van de tabel of table_alias aangeeft.

  • file_format: een van json, csv, avro, , parquet, orc, binaryFiletextdelta (niet hoofdlettergevoelig).

  • path_to_table: de locatie van de tabel in het bestandssysteem. U moet gemachtigd ANY_FILE zijn om deze syntaxis te gebruiken.

  • temporal_spec: bij gebruik verwijst naar een Delta-tabel op het opgegeven tijdstip of de opgegeven versie.

    U kunt een tijdelijke specificatie alleen gebruiken binnen de context van een query of een SAMENVOEGEN MET.

    • @ timestamp_encoding: een positieve letterlijke bigint die een tijdstempel in yyyyMMddHHmmssSSS indeling codeert.
    • @V versie: een positief letterlijk geheel getal dat de versie van de Delta-tabel identificeert.
    • timestamp_expression: een eenvoudige expressie die resulteert in een TIMESTAMP. timestamp_expressiommoet een constante expressie zijn, maar kan of current_timestamp()bevattencurrent_date().
    • versie: een letterlijk geheel getal of een letterlijke tekenreeks die de versie van de Delta-tabel aangeeft.

  • credential_spec

    U kunt een toepasselijke referentie gebruiken om toegang te krijgen tot een path_to_table die niet is ingesloten op een externe locatie.

    • credential_name

      De naam van de referentie die wordt gebruikt voor toegang tot de opslaglocatie.

Als de naam niet-gekwalificeerd is en niet verwijst naar een bekende tabelalias, probeert Azure Databricks eerst de tabel in het huidige schema op te lossen.

Als de naam is gekwalificeerd met een schema, probeert Azure Databricks de tabel in de huidige catalogus op te lossen.

Zie Oplossing voor tabellen en weergaven voor meer informatie over naamomzetting.

Azure Databricks genereert een fout als u een temporal_spec gebruikt voor een tabel die geen Delta Lake-indeling heeft.

Voorbeelden

`Employees`

employees

hr.employees

`hr`.`employees`

hive_metastore.default.tab

system.information_schema.columns

delta.`somedir/delta_table`

`csv`.`spreadsheets/data.csv`

`csv`.`spreadsheets/data.csv` WITH (CREDENTIAL some_credential)

Weergavenaam

Hiermee wordt een weergave geïdentificeerd. De weergave kan worden gekwalificeerd met een schemanaam of niet worden gekwalificeerd met behulp van een eenvoudige id.

Syntaxis

[ schema_name . ] view_identifier

Parameters

  • schema_name: de gekwalificeerde of niet-gekwalificeerde naam van het schema dat de weergave bevat.
  • view_identifier: een id die de naam van de weergave of de weergave-id van een CTE aangeeft.

Voorbeelden

`items`

items

hr.items

`hr`.`items`

Kolomnaam

Hiermee wordt een kolom in een tabel of weergave geïdentificeerd. De kolom kan worden gekwalificeerd met een tabel- of weergavenaam, of niet worden gekwalificeerd met behulp van een eenvoudige id.

Syntaxis

[ { table_name | view_name } . ] column_identifier

Parameters

  • table_name: een gekwalificeerde of niet-gekwalificeerde tabelnaam van de tabel die de kolom bevat.
  • view_name: een gekwalificeerde of niet-gekwalificeerde weergavenaam van de weergave die de kolom bevat.
  • column_identifier: een id die de naam van de kolom aangeeft.

De geïdentificeerde kolom moet aanwezig zijn in de tabel of weergave.

Azure Databricks ondersteunt een speciale _metadata kolom. Deze pseudokolom van het type struct maakt deel uit van elke tabel en kan worden gebruikt voor het ophalen van metagegevensinformatie over de rijen in de tabel.

Voorbeelden

-- 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 _matadata to retrieve infromation about rows retrieved from T.
> CREATE TABLE T(c1 INT);
> INSERT INTO T VALUES(1);
> SELECT T._metadata.file_size;
  574

Veldnaam

Identificeert een veld binnen een struct. Het veld moet worden gekwalificeerd met het pad tot aan de struct met het veld.

Syntaxis

expr { . field_identifier [. ...] }

Parameters

  • expr: een expressie van het type STRUCT.
  • field_identifier: een id die de naam van het veld aangeeft.

Naar een diep genest veld kan worden verwezen door de veld-id op te geven langs het pad naar de hoofdstruct.

Voorbeelden

> SELECT addr.address.name
    FROM VALUES (named_struct('address', named_struct('number', 5, 'name', 'Main St'),
                              'city', 'Springfield')) as t(addr);
  Main St

Functienaam

Identificeert een functie. De functie kan worden gekwalificeerd met een schemanaam of niet worden gekwalificeerd met behulp van een eenvoudige id.

Syntaxis

[ schema_name . ] function_identifier

Parameters

  • schema_name: een gekwalificeerde of niet-gekwalificeerde schemanaam die de functie bevat.
  • function_identifier: een id die de naam van de functie aangeeft.

Voorbeelden

`math`.myplus

myplus

math.`myplus`

Parameternaam

Identificeert een parameter in de hoofdtekst van een SQL-functie die door de gebruiker is gedefinieerd (SQL UDF). De functie kan worden gekwalificeerd met een functie-id of niet worden gekwalificeerd met behulp van een eenvoudige id.

Syntaxis

[ function_identifier . ] parameter_identifier

Parameters

Voorbeelden

CREATE FUNCTION area(x INT, y INT) RETURNS INT
RETURN area.x + y;

Tabelalias

Labelt een tabelreferentie, query, tabelfunctie of andere vorm van een relatie.

Syntaxis

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

Parameters

Als u kolom-id's opgeeft, moet het nummer overeenkomen met het aantal kolommen in de overeenkomende relatie.

Als u geen kolom-id's opgeeft, worden hun namen overgenomen van de gelabelde relatie.

Voorbeelden

> SELECT a, b FROM VALUES (1, 2) AS t(a, b);
 a  b
 1  2

> DELETE FROM emp AS e WHERE e.c1 = 5;

Kolomalias

Hiermee wordt het resultaat van een expressie in een SELECT lijst gelabeld ter referentie.

Als de expressie een generatorfunctie met tabelwaarde is, labelt de alias de lijst met geproduceerde kolommen.

Syntaxis

[AS] column_identifier

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

Parameters

Hoewel kolomaliassen niet uniek hoeven te zijn binnen de selectielijst, is uniekheid een vereiste om op naam naar een alias te verwijzen.

Voorbeelden

> SELECT 1 AS a;
 a
 1

> SELECT 1 a, 2 b;
 a b
 1 2

> SELECT 1 AS `a`;
 a
 1

> SELECT posexplode(array(2)) AS (i, a);
 i  a
 0  2

> SELECT a + a FROM (SELECT 1 AS a);
 a
 2

Referentienaam

Identificeert een referentie voor toegang tot opslag op een externe locatie.

Syntaxis

credential_identifier

Parameters

Voorbeelden

Locatienaam

Identificeert een externe opslaglocatie.

Syntaxis

location_identifier

Parameters

Voorbeelden

`s3-json-data`

s3_json_data

Naam van share

Identificeert een share voor toegang tot gegevens die worden gedeeld door een provider.

Syntaxis

share_identifier

Parameters

  • share_identifier: een niet-gekwalificeerde id die de share uniek identificeert.

Voorbeelden

`public info`

`public-info`

public_info

Providernaam

Identificeert een Delta Sharing-provider.

Syntaxis

provider_identifier

Parameters

Voorbeelden

`Good Corp`

`Good-corp`

Good_Corp

Naam van geadresseerde

Identificeert een geadresseerde voor een share.

Syntaxis

recipient_identifier

Parameters

Voorbeelden

`Good Corp`

`Good-corp`

Good_Corp