Share via

ROW FILTER Component

  • Artikel

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 12.2 LTS en hoger vinkje als ja aan dan Unity Catalog

Belangrijk

Deze functie is beschikbaar als openbare preview.

Hiermee geeft u een functie op die wordt toegepast als een filter wanneer rijen worden opgehaald uit de tabel.

U kunt rijfilters toevoegen wanneer u:

Belangrijk

Het rijfilter wordt toegepast zodra de rij wordt opgehaald uit de gegevensbron.

Zie Gevoelige tabelgegevens filteren met rijfilters en kolommaskers voor meer informatie over het gebruik van rijfilters.

Syntaxis

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

Parameters

  • func_name

    Een scalaire SQL UDF.

    Het retourtype van de functie moet zijn BOOLEAN. Als de functie retourneert FALSE of NULL de rij wordt uitgefilterd.

  • column_name

    Hiermee geeft u kolommen van de onderwerptabel die moeten worden doorgegeven aan func_name. Elk column_name moet worden castable naar de bijbehorende parameter van func_name. U moet zoveel kolommen opgeven als vereist is door de handtekening van de functie. Houd er rekening mee dat deze functie ondersteuning biedt voor het doorgeven van kolommen zonder invoer. In dat geval moet de SQL UDF nulparameters accepteren en een booleaans resultaat retourneren onafhankelijk van een van de waarden van de invoerrijen.

Voorbeelden

Meer voorbeelden vindt u in Filter gevoelige tabelgegevens met behulp van rijfilters en kolommaskers.

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