ROW FILTER-Klausel

Gilt für: Databricks SQL Databricks Runtime 12.2 LTS und höher Nur Unity Catalog

Gibt eine Funktion an, die als Filter angewendet wird, wenn Zeilen aus der Beziehung abgerufen werden.

Sie können Zeilenfilter hinzufügen, indem Sie:

• Erstellen Sie eine Tabelle mit CREATE TABLE.
• Ändern einer Tabelle mithilfe von ALTER TABLE.
• Erstellen einer materialisierten Ansicht mithilfe von CREATE MATERIALIZED VIEW.
• Ändern einer materialisierten Ansicht mithilfe von ALTER MATERIALIZED VIEW.
• Erstellen Sie mithilfe von CREATE STREAMING TABLE eine Streamingtabelle.
• Ändern einer Streamingtabelle mithilfe von ALTER STREAMING TABLE.

Wichtig

Der Zeilenfilter wird angewendet, sobald die Zeile aus der Datenquelle abgerufen wird.

Weitere Informationen zur Verwendung von Zeilenfiltern finden Sie unter Zeilenfilter und Spaltenmasken.

Syntax

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

Parameter

• func_name

  Eine skalare SQL-UDF.

  Der Rückgabetyp der Funktion muss BOOLEAN sein. Wenn die Funktion FALSE oder NULL zurückgibt, wird die Zeile herausgefiltert wird.

• Spaltenname

  Gibt Spalten der Antragstellerbeziehung an, die an func_name übergeben werden sollen. Jede column_name muss in den entsprechenden Parameter von func_name konvertiert werden können. Sie müssen so viele Spalten liefern, wie die von der Signatur der Funktion erfordert werden. Beachten Sie, dass dieses Feature das Übergeben von Nulleingabespalten unterstützt. In diesem Fall muss die SQL-UDF null Parameter akzeptieren und ein boolesches Ergebnis unabhängig von den Werten der Eingabezeilen zurückgeben.

• constant_literal

  Gibt einen Konstantenparameter an, dessen Typ einem Funktionsparameter entspricht. Die folgenden Typen werden unterstützt: STRING, numerisch (INTEGER, FLOAT,DOUBLE, DECIMAL …), BOOLEAN, INTERVAL, NULL.

Beispiele

Weitere Beispiele finden Sie in Zeilenfiltern und Spaltenmasken.

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

Verwandte Artikel

• MASK-Klausel
• ALTER MATERIALIZED VIEW
• ALTER STREAMING TABLE
• ALTER TABLE
• CREATE MATERIALIZED VIEW
• CREATE STREAMING TABLE
• CREATE TABLE