ROW_ACCESS_POLICIES 뷰
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 뷰에는 지정한 데이터 세트 또는 리전의 각 활성 행 액세스 정책에 대해 하나의 행이 포함됩니다. 이 뷰를 쿼리하여 행 액세스 정책을 감사하고 BigQuery의 테이블에서 필터 조건자를 검사할 수 있습니다. 행 수준 보안에 대한 자세한 내용은 BigQuery 행 수준 보안 소개를 참조하세요.
필요한 역할
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 뷰를 쿼리하는 데 필요한 권한을 얻으려면 관리자에게 데이터 세트 또는 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
- BigQuery 데이터 소유자(
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
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
BigQuery의 IAM 역할과 권한에 대한 자세한 내용은 사전 정의된 역할 및 권한을 참조하세요.
스키마
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 뷰를 쿼리하면 지정한 리소스 범위의 각 활성 행 액세스 정책에 대해 하나의 행이 쿼리 결과에 포함됩니다.
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 뷰에는 다음과 같은 스키마가 있습니다.
| 열 이름 | 데이터 유형 | 값 |
|---|---|---|
table_catalog |
STRING |
행 액세스 정책이 포함된 프로젝트의 ID입니다. |
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 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다. -
REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면`region-us`입니다. -
DATASET_ID: 데이터 세트의 ID입니다. 자세한 내용은 데이터 세트 한정자를 참조하세요.
제한사항
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 뷰에는 다음과 같은 제한사항이 있습니다.
- 행 액세스 정책 수혜자는 BigQuery 카탈로그 메타데이터가 아닌 IAM 정책 바인딩에 저장되므로 뷰에는 수혜자 정보 또는
ddl열이 포함되지 않습니다. 행 액세스 정책에 따라 액세스 권한이 부여된 주 구성원을 보려면 테이블 행 수준 액세스 정책 나열을 참조하세요. - 결과에는 숨겨진 데이터 세트 또는 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_project.my_dataset의 my_table 테이블에서 활성 행 액세스 정책 수를 계산합니다.
SELECT
COUNT(1) AS total_policies
FROM
my_project.my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES
WHERE
table_name = 'my_table';
결과는 다음과 비슷합니다.
+----------------+
| total_policies |
+----------------+
| 2 |
+----------------+