Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőkre vonatkozik:
Databricks SQL
Databricks Runtime
A névfeloldás az a folyamat, amellyel az azonosítók adott oszlop-, mező-, paraméter- vagy táblahivatkozásokra lesznek feloldva.
Oszlop, mező, paraméter és változófelbontás
A kifejezések azonosítói az alábbiak bármelyikére hivatkozhatnak:
- Oszlopnév nézet, táblázat, közös táblakifejezés (CTE) vagy oszlop_alias alapján.
- Mezőnév vagy térképkulcs egy struccban vagy térképen belül. A mezőknek és kulcsoknak mindig meg kell jelölniük a hovatartozásukat.
- Egy SQL-felhasználó által definiált függvény vagy SQL-eljárásparaméterneve.
- Munkamenet- vagy SQL-szkript helyi változónév.
- Egy speciális függvény, például
current_uservagycurrent_date, amely nem követeli meg()használatát. - A(z)
DEFAULTkulcsszó olyan kontextusokban használatos, mint aINSERT,UPDATE,MERGEvagySET VARIABLE, hogy egy oszlop vagy változó értékét alapértelmezettként állítsa be.
A névfeloldás a következő alapelveket alkalmazza:
- A legközelebbi egyező hivatkozás nyer, és
- Oszlopok és paraméterek nyernek a mezők és kulcsok felett.
Az azonosítók egy adott hivatkozásra történő feloldása a következő szabályok szerint történik:
Helyi hivatkozások
Oszlop hivatkozás
Egyeztesse az azonosítót, amely minősíthető, a táblahivatkozás oszlopnevével.
Ha egynél több ilyen egyezés van, AMBIGUOUS_COLUMN_OR_FIELD hibát jelez.
Paraméter nélküli függvényhivatkozás
Ha az azonosító nem minősített, és megegyezik
current_user,current_datevagycurrent_timestamp: Oldja fel a függvények egyikeként.Oszlop ALAPÉRTELMEZETT specifikáció
Ha az azonosító nincs minősítve, megegyezik
default-val/vel, és az egész kifejezést alkotja aUPDATE SET,INSERT VALUESvagyMERGE WHEN [NOT] MATCHEDkontextusában: Oldja fel a céltábla megfelelőDEFAULTértékeként aINSERT,UPDATEvagyMERGEesetében.Strukturálási mező vagy térképkulcs referenciája
Ha az azonosító minősített, az alábbi lépéseknek megfelelően törekedjen egy mező vagy térképkulcs egyeztetésére:
Egy. Távolítsa el az utolsó azonosítót, és kezelje mezőként vagy kulcsként. B. A fennmaradó részt egyeztesse a táblahivatkozás egy oszlopával
FROM clause.Ha egynél több ilyen egyezés van, AMBIGUOUS_COLUMN_OR_FIELD hibát jelez.
Ha van egyezés, és az oszlop a következő:
STRUCT: Egyezzen a mezővel.Ha a mező nem feleltethető meg, FIELD_NOT_FOUND hibát jelez.
Ha egynél több mező van, AMBIGUOUS_COLUMN_OR_FIELD hibát jelez.
MAP: Hibát jelez, ha a kulcs meg van jelölve.Futásidejű hiba akkor fordulhat elő, ha a kulcs valójában nem szerepel a térképen.
Bármilyen más típus: Hiba felmerülése. C. Ismételje meg az előző lépést, hogy eltávolítsa az utolsó azonosítót, mint mezőt. Alkalmazza a szabályokat (A) és (B), amíg van egy azonosító, amelyet oszlopként kell értelmezni.
Oldalirányú oszlop aliasolása
A következőkre vonatkozik:
Databricks SQL
Databricks Runtime 12.2 LTS és újabbHa a kifejezés egy
SELECTlistában található, a vezető azonosító feleljen meg egy előző oszlop alias-nak azon aSELECTlistán.Ha egynél több ilyen egyezés van, AMBIGUOUS_LATERAL_COLUMN_ALIAS hibát jelez.
Hasonlítsa össze minden fennmaradó azonosítót mezőként vagy térképkulcsként, és adjon ki FIELD_NOT_FOUND vagy AMBIGUOUS_COLUMN_OR_FIELD hibát, ha nem lehet őket azonosítani.
Korreláció
OLDALSÓ
Ha a lekérdezést egy
LATERALkulcsszó előzi meg, alkalmazza az 1.a és az 1.d szabályt, figyelembe véve a lekérdezést tartalmazó és a lekérdezést megelőzőFROMtáblahivatkozásokatLATERAL.Rendszeres
Ha a lekérdezés egy skaláris al-lekérdezés,
INvagyEXISTSal-lekérdezés, akkor alkalmazza az 1.a, 1.d és 2 szabályt, figyelembe véve a táblahivatkozásokat a lekérdezésFROMzáradékában.
Beágyazott korreláció
Vonatkozik:
, Databricks SQL,
Databricks Runtime 20.0 és annál magasabbAlkalmazzuk újra a 3. szabályt, és áthaladjuk a lekérdezés fészkelési szintjeit, hogy egy azonosító bármely záróban korrelált hivatkozásra oszlathatjon, ne csak a közvetlenül bezáróban.
-
Ha az utasítás egy
FORciklusban található:Egy. Párosítsa az azonosítót a
FORciklus lekérdezés egyik oszlopával. Ha az azonosító minősített, a minősítőnek meg kell egyeznie a FOR hurokváltozó nevével, ha meg van adva. B. Ha az azonosító minősített, egyeznie kell egy paraméter mező- vagy térképkulcsával az 1.c szabályt követve -
Ha az utasítás összetett utasításban található:
Egy. Rendelje az azonosítót az összetett utasításban deklarált változóhoz. Ha az azonosító meg van határozva, a minősítőnek meg kell egyeznie az összetett utasítás címkéjével, ha meg lett határozva. B. Ha az azonosító minősített, egy változó mezőjéhez vagy térképkulcsához illeszkedik az 1.c szabály szerint.
beágyazott összetett utasítás vagy
FORhurokIsmét alkalmazza az 5. és 6. szabályt, ismételve az összetett utasítás beágyazási szintjein.
Rutinparaméterek
Ha a kifejezés egy CREATE FUNCTIONCREATE PROCEDURE utasítás része:
- Rendelje hozzá az azonosítót egy paraméternévhez. Ha az azonosító minősített, a minősítőnek meg kell egyeznie a rutin nevével.
- Ha az azonosító minősített, egyeznie kell egy paraméter mező- vagy térképkulcsával az 1.c szabályt követve
munkamenet-változók
- Párosítsa az azonosítót egy változónévhez. Ha az azonosító minősített, a minősítőnek
session-nak vagysystem.session-nek kell lennie. A Databricks SQL-ben és a Databricks Runtime 19-ben és annál magasabb verziókban egy nem minősített azonosító csak akkor egyezik meg egy session változóval, hasystem.sessiona PATH-en van. - Ha az azonosító minősített, egy változó mezőjéhez vagy térképkulcsához illeszkedik az 1.c szabály szerint.
- Párosítsa az azonosítót egy változónévhez. Ha az azonosító minősített, a minősítőnek
Névfeloldás a következőben: HAVING, ORDER BYés QUALIFY
A HAVING, ORDER BYés QUALIFY záradékok hivatkozhatnak a SELECT listából származó nevekre, valamint az alapul szolgáló táblák oszlopaira. Ha az egyik záradékban szereplő név megegyezik a lista és a SELECT tábla oszlopában lévő oszlop aliasával, a záradékok másképp oldják fel a kétértelműséget:
-
ORDER BYA lista aliasátSELECTrészesíti előnyben a táblázat oszlopában. -
HAVINGa táblázat oszlopát részesíti előnyben a lista aliasaSELECThelyett. -
QUALIFYA táblázat oszlopát részesíti előnyben aSELECTlista aliasával szemben (ugyanaz, mintHAVING).
Példák
> CREATE OR REPLACE TEMPORARY VIEW t(a, b) AS VALUES (1, 10), (2, 20), (3, 30);
-- ORDER BY prefers the alias over the column.
-- 'a' in ORDER BY refers to the alias (-a), not column 'a',
-- so the row with the largest column 'a' comes first.
> SELECT -a AS a FROM t ORDER BY a LIMIT 1;
-3
-- HAVING prefers the column over the alias.
-- 'a' in HAVING refers to column 'a', not the alias sum(b).
> SELECT sum(b) AS a FROM t GROUP BY a HAVING a > 1;
20
30
-- QUALIFY prefers the column over the alias (same as HAVING).
-- 'a' in QUALIFY refers to column 'a', not the alias -row_number().
> SELECT -row_number() OVER (ORDER BY b) AS a FROM t QUALIFY a > 1;
-2
-3
Mező kinyerési és névfeloldási prioritása
Ha egy minősített név , például a.b használt HAVING vagy ORDER BY, a fenti prioritási szabályok továbbra is érvényesek, de egy további szempont: az előnyben részesített jelöltnek támogatnia kell a strukturált mező vagy a térképkulcs kinyerésének támogatását. Ha nem, akkor helyette a másik jelöltet használja a rendszer.
Ha például az alias a egyszerűINT, de a tábla oszlopa aSTRUCT mezővel rendelkezőx, akkor az oszlopot azért választja ORDER BY ki, STRUCT mert egy mező nem nyerhető ki az INT aliasból. Ezzel szemben, ha a tábla oszlopa egyszerű INT , és az alias egy STRUCT, HAVING akkor a mező kinyeréséhez visszakerül az aliasra.
Példák
-- ORDER BY fallback: the table column is a STRUCT, the alias is an INT.
-- ORDER BY normally prefers the alias, but the alias (INT) cannot have
-- field 'x' extracted, so the struct column wins.
> CREATE OR REPLACE TEMPORARY VIEW s1(a) AS VALUES (named_struct('x', 1)), (named_struct('x', 2));
> SELECT -a.x AS a FROM s1 ORDER BY a.x LIMIT 1;
-1
-- HAVING fallback: the table column is an INT, the alias is a STRUCT.
-- HAVING normally prefers the table column, but the column (INT) cannot have
-- field 'x' extracted, so the alias wins.
> CREATE OR REPLACE TEMPORARY VIEW s2(a) AS VALUES (1), (2);
> SELECT named_struct('x', 2) AS a FROM s2 GROUP BY a HAVING a.x > 1;
{"x":2}
{"x":2}
-- Map key extraction follows the same rules.
-- ORDER BY fallback: alias (INT) cannot have key extracted, map column wins.
> CREATE OR REPLACE TEMPORARY VIEW s3(a) AS VALUES (map('key', 100)), (map('key', 200));
> SELECT -a['key'] AS a FROM s3 ORDER BY a['key'] LIMIT 1;
-100
-- HAVING fallback: column (INT) cannot have key extracted, map alias wins.
> CREATE OR REPLACE TEMPORARY VIEW s4(a) AS VALUES (100), (200);
> SELECT map('key', 200) AS a FROM s4 GROUP BY a HAVING a['key'] > 100;
{"key":200}
{"key":200}
Korlátozások
A Databricks SQL és Databricks Runtime 20.0 és annál magasabb verziókban az ágyazott korreláció (egy allekérdezés, amely a közvetlen szülőn túl lévő lekérdezés oszlopaira hivatkozik) támogatott, a következő korlátozásokkal:
- A beágyazott korreláció nem támogatott egy klauzula
HAVINGallekérdezéseihez. - Egy
LATERALallekérdezés nem lehet beágyazott-korrelálható. Külső hivatkozásainak a közvetlenül csatolt lekérdezésre kell feloldaniuk.
A Databricks Runtime verzióiban 20.0 alatti verziókban a korreláció egyetlen szintre korlátozódik: egy allekérdezés csak az a lekérdezés oszlopaira hivatkozhat, amely közvetlenül bezárja.
Példák
-- Differentiating columns and fields
> SELECT a FROM VALUES(1) AS t(a);
1
> SELECT t.a FROM VALUES(1) AS t(a);
1
> SELECT t.a FROM VALUES(named_struct('a', 1)) AS t(t);
1
-- A column takes precedence over a field
> SELECT t.a FROM VALUES(named_struct('a', 1), 2) AS t(t, a);
2
-- Implict lateral column alias
> SELECT c1 AS a, a + c1 FROM VALUES(2) AS T(c1);
2 4
-- A local column reference takes precedence, over a lateral column alias
> SELECT c1 AS a, a + c1 FROM VALUES(2, 3) AS T(c1, a);
2 5
-- A scalar subquery correlation to S.c3
> SELECT (SELECT c1 FROM VALUES(1, 2) AS t(c1, c2)
WHERE t.c2 * 2 = c3)
FROM VALUES(4) AS s(c3);
1
-- A local reference takes precedence over correlation
> SELECT (SELECT c1 FROM VALUES(1, 2, 2) AS t(c1, c2, c3)
WHERE t.c2 * 2 = c3)
FROM VALUES(4) AS s(c3);
NULL
-- An explicit scalar subquery correlation to s.c3
> SELECT (SELECT c1 FROM VALUES(1, 2, 2) AS t(c1, c2, c3)
WHERE t.c2 * 2 = s.c3)
FROM VALUES(4) AS s(c3);
1
-- Correlation from an EXISTS predicate to t.c2
> SELECT c1 FROM VALUES(1, 2) AS T(c1, c2)
WHERE EXISTS(SELECT 1 FROM VALUES(2) AS S(c2)
WHERE S.c2 = T.c2);
1
-- Nested correlation: the innermost EXISTS references t1.a from the outermost query
> CREATE OR REPLACE TEMPORARY VIEW t1(a) AS VALUES(1), (2), (3);
> CREATE OR REPLACE TEMPORARY VIEW t2(b) AS VALUES(1), (2);
> CREATE OR REPLACE TEMPORARY VIEW t3(c) AS VALUES(2), (3);
> SELECT a FROM t1
WHERE EXISTS(SELECT 1 FROM t2
WHERE t2.b = t1.a
AND EXISTS(SELECT 1 FROM t3
WHERE t3.c = t1.a));
2
-- Attempt a lateral correlation to t.c2
> SELECT c1, c2, c3
FROM VALUES(1, 2) AS t(c1, c2),
(SELECT c3 FROM VALUES(3, 4) AS s(c3, c4)
WHERE c4 = c2 * 2);
[UNRESOLVED_COLUMN] `c2`
-- Successsful usage of lateral correlation with keyword LATERAL
> SELECT c1, c2, c3
FROM VALUES(1, 2) AS t(c1, c2),
LATERAL(SELECT c3 FROM VALUES(3, 4) AS s(c3, c4)
WHERE c4 = c2 * 2);
1 2 3
-- Referencing a parameter of a SQL function
> CREATE OR REPLACE TEMPORARY FUNCTION func(a INT) RETURNS INT
RETURN (SELECT c1 FROM VALUES(1) AS T(c1) WHERE c1 = a);
> SELECT func(1), func(2);
1 NULL
-- A column takes precedence over a parameter
> CREATE OR REPLACE TEMPORARY FUNCTION func(a INT) RETURNS INT
RETURN (SELECT a FROM VALUES(1) AS T(a) WHERE t.a = a);
> SELECT func(1), func(2);
1 1
-- Qualify the parameter with the function name
> CREATE OR REPLACE TEMPORARY FUNCTION func(a INT) RETURNS INT
RETURN (SELECT a FROM VALUES(1) AS T(a) WHERE t.a = func.a);
> SELECT func(1), func(2);
1 NULL
-- Lateral alias takes precedence over correlated reference
> SELECT (SELECT c2 FROM (SELECT 1 AS c1, c1 AS c2) WHERE c2 > 5)
FROM VALUES(6) AS t(c1)
NULL
-- Lateral alias takes precedence over function parameters
> CREATE OR REPLACE TEMPORARY FUNCTION func(x INT)
RETURNS TABLE (a INT, b INT, c DOUBLE)
RETURN SELECT x + 1 AS x, x
> SELECT * FROM func(1)
2 2
-- All together now
> CREATE OR REPLACE TEMPORARY VIEW lat(a, b) AS VALUES('lat.a', 'lat.b');
> CREATE OR REPLACE TEMPORARY VIEW frm(a) AS VALUES('frm.a');
> CREATE OR REPLACE TEMPORARY FUNCTION func(a INT, b int, c int)
RETURNS TABLE
RETURN SELECT t.*
FROM lat,
LATERAL(SELECT a, b, c
FROM frm) AS t;
> VALUES func('func.a', 'func.b', 'func.c');
a b c
----- ----- ------
frm.a lat.b func.c
Táblázat- és nézetfeloldás
A táblahivatkozásban szereplő azonosító az alábbiak bármelyike lehet:
- Állandó tábla vagy nézet a Unity Katalógusban vagy a Hive Metastore-ban
- Gyakori táblakifejezés (CTE)
- Ideiglenes nézet vagy ideiglenes tábla
Az azonosító feloldása attól függ, hogy van-e minősítése:
Képesített
Ha az azonosító három részből áll:
catalog.schema.relation, akkor egyedi.Ha az azonosító két részből áll:
schema.relationakkor az egyedivé tétele továbbiSELECT current_catalog()minősítést eredményez.Ha a séma ,
sessiontovább minősítjük éssystemértelmezzük ideiglenes nézetként vagy ideiglenes táblaként. Ha a séma ,global_temptovább kvalifikálják éssystemértelmezik globális ideiglenes nézetként a Databricks Runtime-ban.Képzetlen
Gyakori táblakifejezés
Ha a hivatkozás egy
WITHzáradék hatókörébe esik, rendelje hozzá az azonosítót egy CTE-hez, kezdve a közvetlenül tartalmazóWITHzáradékkal, majd haladjon kifelé.Séma keresési útvonal
A Databricks SQL-ben és a Databricks Runtime 19-ben és annál magasabb, az egyes sémák közötti relációt sorrendben minősítik, amíg nem találnak egyezést.
- Hiányzó katalógusok vagy sémák: Az úton hiányzó katalógusok vagy sémák kihagyásra kerülnek. Egy olyan objektum, amelyhez a felhasználónak nincs elegendő jogosultsága, nem kerül kihagyásra; az Azure Databricks a megfelelő hibát hozza létre.
-
Ideiglenes nézetek és táblázatok: Ideiglenes nézetek és ideiglenes táblázatok találhatók
system.session, így bármikorsystem.sessionelérhetők őket, amikor aPATH. -
Állandó táblák és nézetek az aktuális sémában: A tartós táblák és nézetek az aktuális sémában a virtuális
CURRENT_SCHEMAbejegyzésen keresztül érhetők el.
Az út érvényes a lekérdezésekben és a DML-ben szereplő minősítetlen relációnevekre, valamint a lekérdezés nem minősített neveire, amelyek egy DDL utasítás részei.
Ahol az út érvényes:
Context Használt útvonal Lekérdezések és DML ( SELECT,INSERT,UPDATE,DELETE, )MERGESZAKASZ szekció AS lekérdezése CREATE TABLE SZAKASZ szekció Egy állandó lekérdezés CREATE VIEW PATH rögzítve a létrehozási időben A , DROP,ALTER, és hasonló alkuCREATEcurrent_catalog.current_schema(nem útkeresés)Korábbi kiadások: A Databricks Runtime 18 és alatti verzióban egy nem feltételes reláció, amely nem CTE, fix sorrendben oldódik meg.
Ideiglenes nézet vagy ideiglenes tábla
Egyezzen az azonosítóval az aktuális munkamenetben definiált bármely ideiglenes nézethez vagy ideiglenes táblához.
Megőrzött tábla
Az azonosítót teljesen minősítse úgy, hogy előre hozzáfűzi a
SELECT current_catalog()ésSELECT current_schema()eredményét, és állandó kapcsolatként keresse meg.
Ha a reláció nem oldható fel egyetlen táblához, nézethez vagy CTE-hez sem, a Databricks TABLE_OR_VIEW_NOT_FOUND hibát jelez.
Elfoglalt útvonal
Egy állandó nézet rögzíti a session PATH-ját a létrehozási időben. A nézet későbbi lekérdezései a képtelen neveket a lefogott útra fordítják, nem pedig a hívó session útvonalára.
current_path() és current_schema() ebben a lekérdezésben még mindig visszaadja az invoker session értékeit.
Példák
-- Setting up a scenario
> USE CATALOG spark_catalog;
> USE SCHEMA default;
> CREATE TABLE rel(c1 int);
> INSERT INTO rel VALUES(1);
-- An fully qualified reference to rel:
> SELECT c1 FROM spark_catalog.default.rel;
1
-- A partially qualified reference to rel:
> SELECT c1 FROM default.rel;
1
-- An unqualified reference to rel:
> SELECT c1 FROM rel;
1
-- Add a temporary view with a conflicting name:
> CREATE TEMPORARY VIEW rel(c1) AS VALUES(2);
-- For unqualified references the temporary view takes precedence over the persisted table:
> SELECT c1 FROM rel;
2
-- Temporary views cannot be qualified, so qualifiecation resolved to the table:
> SELECT c1 FROM default.rel;
1
-- An unqualified reference to a common table expression wins even over a temporary view:
> WITH rel(c1) AS (VALUES(3))
SELECT * FROM rel;
3
-- If CTEs are nested, the match nearest to the table reference takes precedence.
> WITH rel(c1) AS (VALUES(3))
(WITH rel(c1) AS (VALUES(4))
SELECT * FROM rel);
4
-- To resolve the table instead of the CTE, qualify it:
> WITH rel(c1) AS (VALUES(3))
(WITH rel(c1) AS (VALUES(4))
SELECT * FROM default.rel);
1
-- For a CTE to be visible it must contain the query
> SELECT * FROM (WITH cte(c1) AS (VALUES(1))
SELECT 1),
cte;
[TABLE_OR_VIEW_NOT_FOUND] The table or view `cte` cannot be found.
Funkciók és eljárás feloldása
Egy rutinhivatkozást (függvényhívást vagy eljáráshívást) a kötelező zárójelek halmaza ismeri fel.
Az alábbiakat oldhatja fel:
- Az Azure Databricks által biztosított beépített függvény
- Az aktuális munkamenetre hatókörrel rendelkező ideiglenes felhasználó által definiált függvény , vagy
- Egy tartós, felhasználó által definiált függvény vagy eljárás, amely a Hive Metastore-ban vagy Unity Catalog-ban tárolt.
Egy rutinnév feloldása attól függ, hogy jogosult-e:
Képesített
Ha a név három részből áll:
catalog.schema.routine, akkor egyedi.Ha a név két részből áll:
schema.routine, akkor aSELECT current_catalog()eredményével tovább minősítik, hogy egyedi legyen.Ha a séma ,
sessiontovább minősítjük éssystemértelmezzük ideiglenes függvényként.A rutint ezután megkeresik a katalógusban.
Képzetlen
- Séma keresési útvonal: A Databricks SQL-ben és a Databricks Runtime 19-ben és annál magasabb rendszerekben minden sémával a PATH-on sorrendben határozzuk meg a rutin nevet, és válaszd ki az első egyezést.
- Hiányzó katalógusok vagy sémák: Az úton hiányzó katalógusok vagy sémák kihagyásra kerülnek. Egy olyan objektum, amelyhez a felhasználónak nincs elegendő jogosultsága, nem kerül kihagyásra; az Azure Databricks a megfelelő hibát hozza létre.
-
Ahol a rutinok élnek: beépített skalár- és tábfüggvények élnek
system.builtinbent, AI függvények ,system.aiés ideiglenes függvények .system.session -
Alapértelmezett út: Az alapértelmezett
PATH,system.sessionakkorsystem.builtin, aztánsystem.ai, akkorCURRENT_SCHEMA.
Warning
Az azonos nevű ideiglenes függvények elsőbbséget élveznek, mert
system.sessionaz alapértelmezett úton előződneksystem.builtin. Az útvonalat át lehet rendezni a SET PATH-val. Ne támaszkodjon ideiglenes funkciókra, árnyékoló beépített funkciókra.Ahol az út érvényes:
Context Használt útvonal Minősítetlen rutinnevek lekérdezésekben és DML-ben SZAKASZ szekció SQL felhasználó által definiált függvény teste PATH rögzítve a létrehozási időben Eljárás SQL SECURITY DEFINERtestePATH rögzítve a létrehozási időnél, nélkül. system.sessionEljárás SQL SECURITY INVOKERtesteA hívó élő PATH A , DROP FUNCTION,CREATE PROCEDURE, és hasonló alkuCREATE FUNCTIONAktuális séma (nem útkeresés) Korábbi kiadások: A Databricks Runtime 18 és alatti verziókban az Azure Databricks egy fix prioritási sorrendet követ.
Beépített függvény
Ha egy ilyen nevű függvény létezik a beépített függvények halmaza között, akkor ezt a függvényt választja ki.
Ideiglenes függvény
Ha egy ilyen nevű függvény szerepel az ideiglenes függvények halmazában, akkor a függvény lesz kiválasztva.
Perzisztált függvény
Teljes mértékben kvalifikálja a függvény nevét, azáltal, hogy előtte hozzáadja a
SELECT current_catalog()ésSELECT current_schema()eredményét, majd keresse meg perzisztens függvényként.
Ha a rutin nem oldható meg, az Azure Databricks hibát jelezUNRESOLVED_ROUTINE.
Elfoglalt útvonal
-
SQL felhasználó-definiált függvény: A test nem minősített nevei a PATH ellen oldódnak meg, amelyet a CREATE FUNCTION-nél rögzítenek, nem pedig a hívó munkamenet útjára.
current_path()éscurrent_schema()ebben a testben még mindig visszaadja az invoker session értékeit. -
Eljárás :
SQL SECURITY DEFINERA minősítetlen neveket a CREATE PROCEDURE során rögzített PATH ellen oldják meg, kihagyvasystem.session.current_path()abban a testben visszatér ugyanaz az elfoglalt út. -
Eljárás a következőkkel
SQL SECURITY INVOKER: Nem minősített nevek használják a hívó élő útját.
Példák
> USE CATALOG spark_catalog;
> USE SCHEMA default;
-- Create a function with the same name as a builtin
> CREATE FUNCTION concat(a STRING, b STRING) RETURNS STRING
RETURN b || a;
-- unqualified reference resolves to the builtin CONCAT
> SELECT concat('hello', 'world');
helloworld
-- Qualified reference resolves to the persistent function
> SELECT default.concat('hello', 'world');
worldhello
-- Create a persistent function
> CREATE FUNCTION func(a INT, b INT) RETURNS INT
RETURN a + b;
-- The persistent function is resolved without qualifying it
> SELECT func(4, 2);
6
-- Create a conflicting temporary function
> CREATE FUNCTION func(a INT, b INT) RETURNS INT
RETURN a / b;
-- The temporary function takes precedent
> SELECT func(4, 2);
2
-- To resolve the persistent function it now needs qualification
> SELECT spark_catalog.default.func(4, 3);
6