התצוגה ROW_ACCESS_POLICIES
התצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES מכילה שורה אחת לכל מדיניות גישה פעילה ברמת השורה בקבוצת הנתונים או באזור שציינתם. אתם יכולים לשלוח שאילתות לתצוגה הזו כדי לבדוק את מדיניות הגישה לשורות ואת הפרדיקטים של המסננים בטבלאות ב-BigQuery. למידע נוסף על אבטחה ברמת השורה, קראו את המאמר מבוא לאבטחה ברמת השורה ב-BigQuery.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לשליחת שאילתות לתצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM ברמת מערך הנתונים או הפרויקט:
- BigQuery Data Owner (
roles/bigquery.dataOwner) - אדמין ב-BigQuery (
roles/bigquery.admin) - אדמין אבטחה ב-BigQuery (
roles/bigquery.securityAdmin)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לשלוח שאילתות לתצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לשלוח שאילתות לתצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, צריך את ההרשאות הבאות:
-
bigquery.rowAccessPolicies.get -
bigquery.rowAccessPolicies.list
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
במאמר תפקידים והרשאות מוגדרים מראש תוכלו לקרוא מידע נוסף על תפקידים והרשאות של IAM ב-BigQuery.
סכימה
כששולחים שאילתה לתצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, תוצאות השאילתה מכילות שורה אחת לכל מדיניות פעילה של גישה לשורות בהיקף המשאב שציינתם.
הסכימה של התצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES היא:
| שם העמודה | סוג נתונים | ערך |
|---|---|---|
table_catalog |
STRING |
מזהה הפרויקט שמכיל את מדיניות הגישה לשורות. |
table_schema |
STRING |
שם מערך הנתונים שמכיל את מדיניות הגישה לשורות. |
table_name |
STRING |
שם הטבלה שמכילה את מדיניות הגישה לשורות. |
row_access_policy_name |
STRING |
שם מדיניות הגישה לשורות. |
filter_predicate |
STRING |
ביטוי בוליאני ב-SQL שמגדיר לאילו שורות אפשר לגשת באמצעות מדיניות הגישה הזו ברמת השורה. |
creation_time |
TIMESTAMP |
השעה שבה נוצרה מדיניות הגישה לשורות. |
last_modified_time |
TIMESTAMP |
המועד שבו מדיניות הגישה לשורות שונתה לאחרונה. |
כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כללי לחיפוש (SELECT *). ציון מפורש של העמודות מונע את קריסת השאילתות אם הסכימה הבסיסית משתנה.
היקף ותחביר
שאילתות בתצוגה הזו חייבות לכלול מזהה של מערך נתונים או של אזור. כדי להריץ שאילתות עם מזהה של מערך נתונים, אתם צריכים הרשאות למערך הנתונים. כדי להריץ שאילתות עם מגדיר אזור, אתם צריכים הרשאות לפרויקט. למידע נוסף על תחביר של תצוגות, ראו תחביר. בטבלה הבאה מוסברים היקפי האזור והמשאבים של התצוגה הזו:
| הצגת השם | היקף המשאבים | היקף האזור |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
רמת הפרויקט | REGION |
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
רמת מערך הנתונים | המיקום של קבוצת הנתונים |
-
PROJECT_ID: אופציונלי, מזהה הפרויקט ב- Google Cloud . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל. -
REGION: כל שם של אזור של מערך נתונים. לדוגמה,`region-us`. -
DATASET_ID: המזהה של מערך הנתונים. מידע נוסף זמין במאמר מזהה קבוצת נתונים.
מגבלות
לתצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES יש את המגבלות הבאות:
- התצוגה לא כוללת מידע על מקבלי המענק או עמודה של
ddl, כי מקבלי המענק של מדיניות הגישה לשורות מאוחסנים בקישורי מדיניות IAM ולא במטא-נתונים של קטלוג BigQuery. כדי לראות את חשבונות המשתמשים שקיבלו גישה באמצעות מדיניות גישה לשורות, עיינו במאמר הצגת רשימה של כללי מדיניות גישה ברמת השורה בטבלה. - התוצאות לא כוללות כללי מדיניות גישה ברמת השורה במערכי נתונים מוסתרים או במערכי נתונים של BigLake.
דוגמאות
בדוגמאות הבאות מוסבר איך לשלוח שאילתות לתצוגה INFORMATION_SCHEMA.ROW_ACCESS_POLICIES.
שליחת שאילתות לגבי כללי מדיניות הגישה לשורות באזור מסוים
בדוגמה הבאה מאחזרים מטא-נתונים של כל כללי מדיניות הגישה הפעילים ברמת השורה באזור us בפרויקט ברירת המחדל:
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;
התוצאה אמורה להיראות כך:
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
שליחת שאילתות לגבי מדיניות גישה ברמת השורה במערך נתונים
בדוגמה הבאה מאחזרים מטא-נתונים של כל כללי מדיניות הגישה הפעילים לשורות במערך נתונים ספציפי בשם my_dataset:
SELECT
table_name,
row_access_policy_name,
filter_predicate,
creation_time,
last_modified_time
FROM
my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;
התוצאה אמורה להיראות כך:
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
ספירת כללי מדיניות הגישה לשורות בטבלה
בדוגמה הבאה נספר מספר כללי מדיניות הגישה הפעילים ברמת השורה בטבלה my_table ב-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';
התוצאה אמורה להיראות כך:
+----------------+
| total_policies |
+----------------+
| 2 |
+----------------+