Condividi tramite

Clausola ROW FILTER

  • Articolo

Si applica a: segno di spunta sì Solo Databricks SQL segno di spunta sì Databricks Runtime 12.2 LTS e versioni successive segno di spunta sì al catalogo Unity

Specifica una funzione applicata come filtro ogni volta che vengono recuperate righe dalla tabella.

È possibile aggiungere filtri di riga quando:

Importante

Il filtro di riga viene applicato non appena la riga viene recuperata dall'origine dati.

Per altre informazioni su come usare i filtri di riga, vedere Filtrare i dati delle tabelle sensibili usando filtri di riga e maschere di colonna.

Sintassi

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

Parametri

  • func_name

    Funzione definita dall'utente scalare di SQL.

    Il tipo restituito della funzione deve essere BOOLEAN. Se la funzione restituisce FALSE o NULL la riga viene filtrata.

  • column_name

    Specifica le colonne della tabella oggetto da passare a func_name. Ogni column_name deve essere assegnabile al parametro corrispondente di func_name. È necessario specificare il numero di colonne richieste dalla firma della funzione. Si noti che questa funzionalità supporta il passaggio di colonne di input zero, nel qual caso la funzione definita dall'utente SQL deve accettare parametri zero e restituire un risultato booleano indipendentemente da uno dei valori delle righe di input.

  • constant_literal

    Specifica un parametro costante con il tipo corrispondente a un parametro di funzione. Sono supportati i seguenti tipi: STRING, numerico (INTEGER, FLOAT, DOUBLE, DECIMAL ...) , BOOLEAN, INTERVAL, NULL.

Esempi

Per altri esempi, vedere Filtrare i dati delle tabelle sensibili usando filtri di riga e mascheramenti di colonna.

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