Tampilan ROW_ACCESS_POLICIES

Tampilan INFORMATION_SCHEMA.ROW_ACCESS_POLICIES berisi satu baris untuk setiap kebijakan akses baris aktif dalam set data atau region yang Anda tentukan. Anda dapat membuat kueri tampilan ini untuk mengaudit kebijakan akses baris dan memeriksa predikat filter di seluruh tabel di BigQuery. Untuk mengetahui informasi selengkapnya tentang keamanan tingkat baris, lihat Pengantar keamanan tingkat baris BigQuery.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengkueri tampilan INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, minta administrator untuk memberi Anda peran IAM berikut pada set data atau project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk membuat kueri tampilan INFORMATION_SCHEMA.ROW_ACCESS_POLICIES. Untuk melihat izin yang pasti diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat kueri tampilan INFORMATION_SCHEMA.ROW_ACCESS_POLICIES:

  • bigquery.rowAccessPolicies.get
  • bigquery.rowAccessPolicies.list

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi lebih lanjut tentang peran dan izin IAM di BigQuery, baca Peran dan izin bawaan.

Skema

Saat Anda membuat kueri tabel virtual INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, hasil kueri akan berisi satu baris untuk setiap kebijakan akses baris aktif dalam cakupan resource yang Anda tentukan.

Tampilan INFORMATION_SCHEMA.ROW_ACCESS_POLICIES memiliki skema berikut:

Nama kolom Jenis data Nilai
table_catalog STRING ID project yang berisi kebijakan akses baris.
table_schema STRING Nama set data yang berisi kebijakan akses baris.
table_name STRING Nama tabel yang berisi kebijakan akses baris.
row_access_policy_name STRING Nama kebijakan akses baris.
filter_predicate STRING Ekspresi boolean SQL yang menentukan baris mana yang dapat diakses oleh kebijakan akses baris ini.
creation_time TIMESTAMP Waktu saat kebijakan akses baris dibuat.
last_modified_time TIMESTAMP Waktu saat kebijakan akses baris terakhir diubah.

Untuk stabilitas, sebaiknya cantumkan kolom secara eksplisit dalam kueri skema informasi, bukan menggunakan karakter pengganti (SELECT *). Mencantumkan kolom secara eksplisit akan mencegah kueri rusak jika skema yang mendasarinya berubah.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan set data atau penentu region. Untuk kueri dengan penentu set data, Anda harus memiliki izin untuk set data. Untuk kueri dengan penentu region, Anda harus memiliki izin untuk project. Untuk mengetahui informasi selengkapnya tentang sintaksis tampilan, lihat Sintaksis. Tabel berikut menjelaskan cakupan region dan resource untuk tabel virtual ini:

Nama tampilan Cakupan resource Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES Level project REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES Level set data Lokasi set data
Ganti kode berikut:
  • Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.
  • REGION: nama region set data apa pun. Misalnya, `region-us`.
  • DATASET_ID: ID set data Anda. Untuk mengetahui informasi selengkapnya, lihat Penentu set data.

Batasan

Tampilan INFORMATION_SCHEMA.ROW_ACCESS_POLICIES memiliki batasan berikut:

  • Tabel virtual tidak menyertakan informasi penerima atau kolom ddl karena penerima kebijakan akses baris disimpan dalam binding kebijakan IAM, bukan metadata katalog BigQuery. Untuk melihat akun utama yang diberi akses oleh kebijakan akses baris, lihat Mencantumkan kebijakan akses tingkat baris tabel.
  • Hasil tidak menyertakan kebijakan akses baris dalam set data tersembunyi atau set data BigLake.

Contoh

Contoh berikut menunjukkan cara membuat kueri tabel virtual INFORMATION_SCHEMA.ROW_ACCESS_POLICIES.

Mengkueri kebijakan akses baris di suatu region

Contoh berikut mengambil metadata untuk semua kebijakan akses baris aktif di region us untuk project default Anda:

SELECT
  table_catalog,
  table_schema,
  table_name,
  row_access_policy_name,
  filter_predicate,
  creation_time,
  last_modified_time
FROM
  `region-us`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;

Hasilnya mirip dengan berikut ini:

+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| table_catalog | table_schema | table_name | row_access_policy_name | filter_predicate   | creation_time               | last_modified_time          |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| my_project    | my_dataset   | my_table   | apac_filter            | region = 'APAC'    | 2026-03-10 14:22:05.123 UTC | 2026-03-10 14:22:05.123 UTC |
| my_project    | my_dataset   | my_table   | us_filter              | region = 'US'      | 2026-03-10 14:25:18.456 UTC | 2026-03-12 09:15:42.789 UTC |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+

Membuat kueri kebijakan akses baris dalam set data

Contoh berikut mengambil metadata untuk semua kebijakan akses baris aktif dalam set data tertentu bernama my_dataset:

SELECT
  table_name,
  row_access_policy_name,
  filter_predicate,
  creation_time,
  last_modified_time
FROM
  my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;

Hasilnya mirip dengan berikut ini:

+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| table_name | row_access_policy_name | filter_predicate   | creation_time               | last_modified_time          |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| my_table   | apac_filter            | region = 'APAC'    | 2026-03-10 14:22:05.123 UTC | 2026-03-10 14:22:05.123 UTC |
| my_table   | us_filter              | region = 'US'      | 2026-03-10 14:25:18.456 UTC | 2026-03-12 09:15:42.789 UTC |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+

Menghitung kebijakan akses baris pada tabel

Contoh berikut menghitung jumlah kebijakan akses baris aktif pada tabel my_table di my_project.my_dataset:

SELECT
  COUNT(1) AS total_policies
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES
WHERE
  table_name = 'my_table';

Hasilnya mirip dengan berikut ini:

+----------------+
| total_policies |
+----------------+
| 2              |
+----------------+