ROW FILTER záradék

A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és újabb kizárólag a Unity Catalog

Olyan függvényt ad meg, amely szűrőként lesz alkalmazva, amikor sorokat hív le a relációból.

Sorszűrőket akkor adhat hozzá, ha:

• Tábla létrehozása CREATE TABLEhasználatával.
• Táblázat módosítása ALTER TABLEhasználatával.
• Materializált nézet létrehozása a következővel CREATE MATERIALIZED VIEW: .
• Materializált nézet módosítása a következővel ALTER MATERIALIZED VIEW.
• Egy streamelési tábla létrehozása CREATE STREAMING TABLEhasználatával.
• Streaming tábla módosítása ALTER STREAMING TABLE használatával.

Fontos

A sorszűrőt azonnal alkalmazzák, amint a sort lekérik az adatforrásból.

További információ a sorszűrők használatáról: Sorszűrők és oszlopmaszkok.

Szükséges jogosultságok

Ha olyan függvényt szeretne hozzárendelni, amely sorszűrőt ad hozzá egy táblához, rendelkeznie kell a EXECUTE jogosultsággal a függvényen, USE SCHEMA a sémán és USE CATALOG a szülőkatalóguson.

Ha új tábla létrehozásakor sorszűrőt ad hozzá, akkor a CREATE TABLE sémán jogosultsággal kell rendelkeznie.

Ha egy meglévő táblán sorszűrőt vesz fel vagy távolít el, akkor önnek kell a tábla tulajdonosának lennie, vagy rendelkeznie kell a MANAGE táblában lévő jogosultságokkal és SELECT jogosultságokkal.

Ha ugyanez az utasítás a táblasémát is módosítja, a táblán lévő jogosultságra is szüksége lesz MODIFY .

Szintaxis

ROW FILTER func_name ON ( [ column_name | constant_literal [, ...] ] ) [...]

Paraméterek

• func_name

  Skaláris SQL UDF.

  A függvény visszatérési típusának a következőnek kell lennie BOOLEAN: . Ha a függvény visszatér FALSE , vagy NULL a sor ki van szűrve.

• column_name

  Megadja azokat a tárgykapcsolat oszlopait, amelyeket át kell adni a func_name-nek. Minden column_name alakíthatónak kell lennie a megfelelő func_name paraméterre. Annyi oszlopot kell megadnia, amennyit a függvény aláírása megkövetel. Ez a funkció támogatja a nulla bemeneti oszlopok átadását, ebben az esetben az SQL UDF-nek nulla paramétert kell elfogadnia, és logikai eredményt kell visszaadnia a bemeneti sorok értékétől függetlenül.

  Fontos

  Ha egy oszlop adattípusa nem egyezik meg pontosan a megfelelő függvényparaméter-típussal, az oszlop értéke implicit módon lesz leadva. A ANSI_MODE letiltott értékeket a rendszer csendesen átalakítja a nem leadható értékekre NULL, ami váratlan szűrőeredményeket eredményezhet. Az UDF-paramétertípusoknak meg kell egyezniük a nekik átadott oszlopok adattípusával. Lásd az adattípus eltérési viselkedését.

• constant_literal

  Állandó paramétert ad meg egy függvényparaméternek megfelelő típussal. A következő típusok támogatottak: STRING, numerikus (INTEGER, FLOAT,DOUBLE, DECIMAL ...), BOOLEAN, INTERVAL, NULL.

Példák

További példákat a sorszűrőkben és az oszlopmaszkokban találhat.

-- Create a table with a row filter column
> CREATE FUNCTION filter_emps(dept STRING) RETURN is_account_group_member(dept);
> CREATE TABLE employees(emp_name STRING, dept STRING) WITH ROW FILTER filter_emps ON (dept);
> INSERT INTO employees VALUES ('Jones', 'Engineering'), ('Smith', 'Sales');

-- As a member of engineering
> SELECT * FROM employees;
  Jones Engineering

-- As a member of sales
> SELECT * FROM employees;
  Smith Sales

Kapcsolódó cikkek

• MASZK záradék
• ALTER MATERIALIZED VIEW
• ALTER STREAMING TABLE
• ALTER TABLE
• CREATE MATERIALIZED VIEW
• CREATE STREAMING TABLE
• CREATE TABLE