ROUTINE_OPTIONS 뷰

INFORMATION_SCHEMA.ROUTINE_OPTIONS 뷰에는 데이터 세트에 있는 각 루틴의 옵션마다 행이 한 개씩 포함됩니다.

필수 권한

INFORMATION_SCHEMA.ROUTINE_OPTIONS 뷰를 쿼리하려면 다음 Identity and Access Management(IAM) 권한이 필요합니다.

  • bigquery.routines.get
  • bigquery.routines.list

다음과 같이 사전 정의된 각 IAM 역할에는 루틴 메타데이터를 가져오는 데 필요한 권한이 포함되어 있습니다.

  • roles/bigquery.admin
  • roles/bigquery.metadataViewer
  • roles/bigquery.dataViewer

BigQuery 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

스키마

INFORMATION_SCHEMA.ROUTINE_OPTIONS 뷰를 쿼리하면 데이터세트에 있는 각 루틴의 옵션마다 행이 한 개씩 쿼리 결과에 포함됩니다.

INFORMATION_SCHEMA.ROUTINE_OPTIONS 뷰에는 다음과 같은 스키마가 있습니다.

열 이름 데이터 유형 값
SPECIFIC_CATALOG STRING 옵션이 정의된 루틴이 포함된 프로젝트의 이름
SPECIFIC_SCHEMA STRING 옵션이 정의된 루틴이 포함된 데이터 세트의 이름
SPECIFIC_NAME STRING 루틴의 이름
OPTION_NAME STRING 옵션 표의 이름 값 중 하나
OPTION_TYPE STRING 옵션 표의 데이터 유형 값 중 하나
OPTION_VALUE STRING 옵션 표의 값 옵션 중 하나
옵션 테이블
OPTION_NAME OPTION_TYPE OPTION_VALUE
description STRING 루틴 설명(정의된 경우)
library ARRAY 루틴에서 참조되는 라이브러리의 이름. 자바스크립트 UDF에만 적용됨
data_governance_type DataGovernanceType 지원되는 데이터 거버넌스 유형의 이름. 예를 들면 DATA_MASKING입니다.

범위 및 구문

이 뷰에 대한 쿼리에는 데이터 세트나 리전 한정자가 포함되어야 합니다. 자세한 내용은 구문을 참조하세요. 다음 표에서는 이 뷰의 리전 범위와 리소스 범위를 설명합니다.

뷰 이름 리소스 범위 리전 범위
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS 프로젝트 수준 REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS 데이터 세트 수준 데이터 세트 위치
다음을 바꿉니다.

  • (선택사항) PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.
  • REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 region-us입니다.
  • DATASET_ID: 데이터 세트의 ID입니다. 자세한 내용은 데이터 세트 한정자를 참조하세요.

예시

-- Returns metadata for routines in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

-- Returns metadata for routines in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

예시

예 1:

다음 예시에서는 INFORMATION_SCHEMA.ROUTINE_OPTIONS 뷰를 쿼리하여 기본 프로젝트(myproject)에 있는 mydataset의 모든 루틴에서 루틴 옵션을 검색합니다.

SELECT
  *
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

결과는 다음과 비슷합니다.

+-------------------+------------------+---------------+----------------------+---------------+------------------+
| specific_catalog  | specific_schema  | specific_name |     option_name      | option_type   | option_value     |
+-------------------+------------------+---------------+----------------------+---------------+------------------+
| myproject         | mydataset        | myroutine1    | description          | STRING        | "a description"  |
| myproject         | mydataset        | myroutine2    | library              | ARRAY<STRING> | ["a.js", "b.js"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+