ROW_ACCESS_POLICIES 뷰

INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 뷰에는 지정한 데이터 세트 또는 리전의 각 활성 행 액세스 정책에 대해 하나의 행이 포함됩니다. 이 뷰를 쿼리하여 행 액세스 정책을 감사하고 BigQuery의 테이블에서 필터 조건자를 검사할 수 있습니다. 행 수준 보안에 대한 자세한 내용은 BigQuery 행 수준 보안 소개를 참조하세요.

필요한 역할

INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 뷰를 쿼리하는 데 필요한 권한을 얻으려면 관리자에게 데이터 세트 또는 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 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              |
+----------------+