ROW FILTER Klauzula

Dotyczy: Databricks SQL Databricks Runtime 12.2 LTS i nowszy tylko wykaz aparatu Unity

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

Określa funkcję, która jest stosowana jako filtr za każdym razem, gdy wiersze są pobierane z tabeli.

Filtry wierszy można dodawać, gdy:

• Utwórz tabelę przy użyciu polecenia CREATE TABLE.
• Alter a table using ALTER TABLE (Zmienianie tabeli przy użyciu funkcji ALTER TABLE).

Ważne

Filtr wierszy jest stosowany zaraz po pobraniu wiersza ze źródła danych.

Aby uzyskać więcej informacji na temat używania filtrów wierszy, zobacz Filtrowanie poufnych danych tabeli przy użyciu filtrów wierszy i masek kolumn.

Składnia

ROW FILTER func_name ON ( [ column_name [, ...] ] ) } [...]

Parametry

• func_name

  Skalarna funkcja zdefiniowanej przez użytkownika SQL.

  Zwracany typ funkcji musi mieć wartość BOOLEAN. Jeśli funkcja zwraca FALSE wartość lub NULL wiersz jest filtrowany.

• Column_name

  Określa kolumny tabeli podmiotu, które mają być przekazywane do func_name. Każdy column_name element musi być rzutowalny do odpowiedniego parametru .func_name Należy podać tyle kolumn, ile jest wymaganych przez podpis funkcji. Należy pamiętać, że ta funkcja obsługuje przekazywanie zerowych kolumn wejściowych, w takim przypadku funkcja zdefiniowana przez użytkownika SQL musi akceptować parametry zerowe i zwracać wynik logiczny niezależnie od wartości wierszy wejściowych.

Przykłady

Więcej przykładów można znaleźć w temacie Filtrowanie poufnych danych tabeli przy użyciu filtrów wierszy i masek kolumn.

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

Powiązane artykuły

• KLAUZULA MASK
• ALTER TABLE
• CREATE TABLE