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:
- BigQuery Data Owner (
roles/bigquery.dataOwner) - BigQuery Admin (
roles/bigquery.admin) - BigQuery Security Admin (
roles/bigquery.securityAdmin)
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 |
-
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
ddlkarena 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 |
+----------------+