ROW FILTER Klausul

  • Artikel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 12.2 LTS dan di atas centang ditandai ya Unity Catalog saja

Penting

Fitur ini ada di Pratinjau Publik.

Menentukan fungsi yang diterapkan sebagai filter setiap kali baris diambil dari tabel.

Anda dapat menambahkan filter baris saat Anda:

Penting

Filter baris diterapkan segera setelah baris diambil dari sumber data.

Untuk informasi selengkapnya tentang cara menggunakan filter baris, lihat Memfilter data tabel sensitif menggunakan filter baris dan masker kolom.

Sintaks

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

Parameter

  • func_name

    SQL UDF skalar.

    Jenis pengembalian fungsi harus BOOLEAN. Jika fungsi kembali FALSE atau NULL baris difilter.

  • column_name

    Menentukan kolom tabel subjek untuk diteruskan ke func_name. Masing-masing column_name harus dicor ke parameter yang sesuai dari func_name. Anda harus menyediakan kolom sebanyak yang diperlukan oleh tanda tangan fungsi. Perhatikan bahwa fitur ini mendukung melewati kolom input nol, dalam hal ini SQL UDF harus menerima parameter nol dan mengembalikan hasil boolean yang independen dari salah satu nilai baris input.

Contoh

Anda dapat menemukan contoh lainnya di Memfilter data tabel sensitif menggunakan filter baris dan masker kolom.

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