SQL 저장 프로시져 작업

저장 프로시져는 다른 쿼리 또는 다른 저장 프로시져에서 호출할 수 있는 문 모음입니다. 프로시져는 입력 인수를 사용하고 값을 출력으로 반환할 수 있습니다. BigQuery 데이터 세트에 프로시져의 이름을 지정하고 저장합니다. 저장 프로시져는 여러 사용자가 여러 데이터 세트에서 데이터에 액세스하거나 수정할 수 있습니다. 멀티 문 쿼리도 포함할 수 있습니다.

일부 저장 프로시져는 BigQuery에 내장되어 있으므로 만들 필요가 없습니다. 이것을 시스템 프로시져라고 하며, 시스템 프로시져 참조에서 자세히 알아볼 수 있습니다.

저장 프로시져는 절차적 언어 문을 지원하므로 변수를 정의하고 제어 흐름을 구현할 수 있습니다. 절차적 언어 문에 대한 자세한 내용은 절차적 언어 참조를 참조하세요.

저장 프로시져 만들기

프로시져를 만들려면 CREATE PROCEDURE 문을 사용합니다.

다음의 개념적 예시에서 procedure_name은 프로시져를 나타내며 프로시져의 본문은 BEGIN과 END 문 사이에 나타납니다.

CREATE PROCEDURE dataset_name.procedure_name()
BEGIN
-- statements here
END

다음 예시에서는 멀티 문 쿼리가 포함된 프로시져를 보여줍니다. 멀티 문 쿼리는 변수를 설정하고, INSERT 문을 실행하고, 결과를 형식이 지정된 텍스트 문자열로 표시합니다.

CREATE OR REPLACE PROCEDURE mydataset.create_customer()
BEGIN
  DECLARE id STRING;
  SET id = GENERATE_UUID();
  INSERT INTO mydataset.customers (customer_id)
    VALUES(id);
  SELECT FORMAT("Created customer %s", id);
END

앞의 예시에서 프로시져의 이름은 mydataset.create_customer이고 프로시져 본문은 BEGIN과 END 문 사이에 나타납니다.

프로시져를 호출하려면 CALL 문을 사용하세요.

CALL mydataset.create_customer();

입력 매개변수로 값 입력

프로시져에는 입력 매개변수가 있을 수 있습니다. 입력 매개변수는 프로시져에 대한 입력을 허용하지만 출력을 허용하지 않습니다.

CREATE OR REPLACE PROCEDURE mydataset.create_customer(name STRING)
BEGIN
DECLARE id STRING;
SET id = GENERATE_UUID();
INSERT INTO mydataset.customers (customer_id, name)
  VALUES(id, name);
SELECT FORMAT("Created customer %s (%s)", id, name);
END

출력 매개변수로 값 출력

프로시져에는 출력 매개변수가 있을 수 있습니다. 출력 매개변수는 프로시져에서 값을 반환하지만 프로시져의 입력을 허용하지 않습니다. 출력 매개변수를 만들려면 매개변수 이름 앞에 OUT 키워드를 사용합니다.

예를 들어 이 프로시져 버전에서는 id 매개변수를 통해 새 고객 ID를 반환합니다.

CREATE OR REPLACE PROCEDURE mydataset.create_customer(name STRING, OUT id STRING)
BEGIN
SET id = GENERATE_UUID();
INSERT INTO mydataset.customers (customer_id, name)
  VALUES(id, name);
SELECT FORMAT("Created customer %s (%s)", id, name);
END

이 프로시져를 호출하려면 변수를 사용하여 출력 값을 수신해야 합니다.

--- Create a new customer record.
DECLARE id STRING;
CALL mydataset.create_customer("alice",id);

--- Display the record.
SELECT * FROM mydataset.customers
WHERE customer_id = id;

입력/출력 매개변수로 값 입력 및 출력

프로시져에는 입력/출력 매개변수도 있을 수 있습니다. 입력/출력 매개변수는 프로시져에서 값을 반환하고 프로시져의 입력도 허용합니다. 입력/출력 매개변수를 만들려면 매개변수 이름 앞에 INOUT 키워드를 사용합니다. 자세한 내용은 인수 모드를 참조하세요.

루틴 승인

저장 프로시져를 루틴으로 승인할 수 있습니다. 승인된 루틴을 사용하면 결과를 생성한 기본 테이블에 대해 액세스 권한을 부여하지 않고도 특정 사용자 또는 그룹에 쿼리 결과를 공유할 수 있습니다. 예를 들어 승인된 루틴은 데이터에 대한 집계를 계산하거나 테이블 값을 조회하고 이 값을 계산에 사용할 수 있습니다.

승인된 루틴은 테이블 만들기, 삭제, 테이블 조작은 물론 기본 테이블에서 다른 저장 프로시져를 호출합니다.

자세한 내용은 승인된 루틴을 참조하세요.

저장 프로시져 호출

저장 프로시져가 생성된 후 호출하려면 CALL 문을 사용합니다. 예를 들어 다음 문은 저장 프로시져 create_customer를 호출합니다.

CALL mydataset.create_customer();

참고: 프러시저의 SQL 문을 쿼리에 직접 포함하지 않고 저장 프로시져를 호출하면 약간의 성능 오버헤드가 발생합니다.

시스템 프로시져 호출

기본 제공 시스템 프로시져를 호출하려면 CALL 문을 사용합니다. 예를 들어 다음 문은 시스템 프로시져 BQ.REFRESH_MATERIALIZED_VIEW를 호출합니다.

CALL BQ.REFRESH_MATERIALIZED_VIEW;