ROW FILTER
Záradék
A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és a Unity Catalog felett csak
Fontos
Ez a funkció a nyilvános előzetes verzióban érhető el.
Olyan függvényt ad meg, amely szűrőként lesz alkalmazva, amikor sorokat hív le a táblázatból.
Sorszűrőket akkor adhat hozzá, ha:
- Tábla létrehozása a CREATE TABLE használatával.
- Táblázat módosítása ALTER TABLE használatával.
Fontos
A sorszűrőt a rendszer azonnal alkalmazza, amint a sor lekéri az adatforrásból.
A sorszűrők használatáról további információt a bizalmas táblázatadatok szűrése sorszűrők és oszlopmaszkok használatával című témakörben talál.
Syntax
ROW FILTER func_name ON ( [ column_name [, ...] ] ) } [...]
Paraméterek
-
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érFALSE
, vagyNULL
a sor ki van szűrve. -
A tárgytábla azon oszlopait adja meg, amelyeknek át kell adni.
func_name
Mindegyiknekcolumn_name
a megfelelő paraméterrefunc_name
öntöttnek kell lennie. Annyi oszlopot kell megadnia, amennyit a függvény aláírása megkövetel. Vegye figyelembe, hogy 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.
Példák
A bizalmas táblaadatok szűrése sorszűrőkkel és oszlopmaszkokkal további példákat is találhat.
-- Create a table with a row filter column
> CREATE FUNCTION filter_emps(dept STRING) RETURN is_member(dept);
> CREATE TABLE employees(emp_name STRING, dept STRING) WITH ROW FILTER filter_emps ON (dept);
> INSERT INTO employees('Jones', 'Engineering'), ('Smith', 'Sales');
-- As a member of engineering
> SELECT * FROM employees;
Jones Engineering
-- As a member of sales
> SELECT * FROM employees;
Smith Sales