시스템 프로시져 참조

BigQuery는 다음 시스템 프로시져를 지원하며, 이는 사용자가 만든 저장 프로시져와 유사하게 사용할 수 있습니다.

BQ.ABORT_SESSION

구문

CALL BQ.ABORT_SESSION([session_id]);

설명

현재 세션을 종료합니다.

원하는 경우 세션 ID를 지정하여 해당 세션에서 시스템 프로시져를 호출하지 않은 경우 세션을 종료할 수 있습니다.

자세한 내용은 세션 종료를 참조하세요.

BQ.JOBS.CANCEL

구문

CALL BQ.JOBS.CANCEL(job);

설명

실행 중인 작업 취소

작업을 '[project_id.]job_id' 형식의 문자열로 지정합니다. 이 시스템 프로시져를 작업과 다른 프로젝트에서 실행하는 경우 프로젝트 ID가 포함되어야 합니다. 작업과 동일한 위치에서 프로시져를 실행해야 합니다.

자세한 내용은 작업 취소를 참조하세요.

BQ.REFRESH_EXTERNAL_METADATA_CACHE

구문

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE(table_name [, [subdirectory_uri, …]]);

설명

BigLake 테이블 또는 객체 테이블의 메타데이터 캐시를 새로고침합니다. 메타데이터 캐싱 모드가 AUTOMATIC으로 설정된 테이블에서 실행하면 이 프로시져가 실패합니다.

이 시스템 프로시져를 실행하려면 bigquery.tables.update 및 bigquery.tables.updateData 권한이 필요합니다.

테이블 이름을 '[project_id.]dataset.table' 형식의 문자열로 지정합니다. 이 시스템 프로시져를 테이블과 다른 프로젝트에서 실행하는 경우 프로젝트 ID가 포함되어야 합니다.

BigLake 테이블의 경우 Cloud Storage에서 테이블 데이터 디렉터리의 하나 이상의 하위 디렉터리를 'gs://table_data_directory/subdirectory/.../' 형식으로 선택적으로 지정할 수 있습니다. 이렇게 하면 이러한 하위 디렉터리의 테이블 메타데이터만 새로고침하여 불필요한 메타데이터 처리를 방지할 수 있습니다.

예시

테이블의 모든 메타데이터를 새로고침하려면 다음 단계를 따르세요.

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table')

BigLake 테이블의 메타데이터를 선택적으로 새로고침하려면 다음 단계를 따르세요.

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table', ['gs://source/uri/sub/path/d1/*', 'gs://source/uri/sub/path/d2/*'])

제한사항

• 외부 데이터 세트를 통해 연결된 데이터 세트에서 참조하는 테이블에 대해서는 메타데이터 캐시 새로고침이 지원되지 않습니다.
• 메타데이터 캐시 새로고침은 멀티 문 트랜잭션에 사용하면 안 됩니다.

BQ.REFRESH_MATERIALIZED_VIEW

구문

CALL BQ.REFRESH_MATERIALIZED_VIEW(view_name);

설명

구체화된 뷰를 새로고칩니다.

구체화된 뷰 이름을 '[project_id.]dataset.table' 형식의 문자열로 지정합니다. 이 시스템 프로시져를 구체화된 뷰와 다른 프로젝트에서 실행하는 경우 프로젝트 ID가 포함되어야 합니다.

자세한 내용은 수동 새로고침을 참조하세요.