40.6. 토토 꽁 머니 구조

40.6.1.1. 반환

반환표현;

반환표현식을 사용하면 함수를 종료하고 값을 반환합니다.표현발신자에게. 이 양식은 다음 용도로 사용됩니다.PL/pgSQL세트를 반환하지 않는 함수.

스칼라 유형을 반환하는 함수에서 표현식의 결과는 할당에 대해 설명한 대로 자동으로 함수의 반환 유형으로 캐스팅됩니다. 그러나 복합(행) 값을 반환하려면 요청된 열 집합을 정확하게 전달하는 식을 작성해야 합니다. 명시적 캐스팅을 사용해야 할 수도 있습니다.

출력 매개변수를 사용하여 함수를 선언한 경우 다음과 같이 작성하세요.반환표현이 없습니다. 출력 매개변수 변수의 현재 값이 반환됩니다.

반환할 함수를 선언한 경우무효, 아반환문을 사용하여 함수를 일찍 종료할 수 있습니다. 하지만 다음과 같은 표현은 쓰지 마세요.반환.

함수의 반환 값은 정의되지 않은 상태로 둘 수 없습니다. 컨트롤이 a를 누르지 않고 함수의 최상위 블록 끝에 도달한 경우반환문을 작성하면 런타임 오류가 발생합니다. 이 제한은 출력 매개변수가 있는 함수와 반환하는 함수에는 적용되지 않습니다.공허13003_13033반환최상위 블록이 완료되면 문이 자동으로 실행됩니다.

일부 예:

-- 스칼라 유형을 반환하는 함수
1 + 2를 반환합니다.
반환 scalar_var;

-- 복합 유형을 반환하는 함수
RETURN 복합_유형_var;
RETURN (1, 2, '3'::텍스트);  -- 올바른 유형으로 열을 캐스팅해야 합니다.

40.6.1.2. 다음으로 돌아가기그리고반환 쿼리

다음으로 돌아가기표현;
반환 쿼리질의;
쿼리 실행 반환명령어-문자열 [사용 중표현 [, ... ] ];

때PL/pgSQL함수가 반환되도록 선언되었습니다.SETOF어떤 종류, 따라야 할 절차가 약간 다릅니다. 이 경우 반환할 개별 항목은 다음 순서로 지정됩니다.다음으로 돌아가기또는반환 쿼리명령, 그리고 마지막반환인수가 없는 명령은 함수 실행이 완료되었음을 나타내는 데 사용됩니다.다음으로 돌아가기스칼라 및 복합 데이터 유형 모두에 사용할 수 있습니다. 복합 결과 유형, 전체"테이블"의 결과가 반환됩니다.반환 쿼리쿼리 실행 결과를 함수의 결과 세트에 추가합니다.다음으로 돌아가기그리고반환 쿼리은 단일 집합 반환 함수에서 자유롭게 혼합될 수 있으며, 이 경우 해당 결과는 연결됩니다.

다음으로 돌아가기그리고반환 쿼리실제로 함수에서 반환하지 않습니다. 단순히 함수의 결과 집합에 0개 이상의 행을 추가하기만 하면 됩니다. 그런 다음 실행은의 다음 문으로 계속됩니다.PL/pgSQL함수. 연속적으로다음으로 돌아가기또는반환 쿼리명령이 실행되면 결과 세트가 구축됩니다. 결승전반환15385_15516

반환 쿼리변형 있음반환 쿼리 실행, 동적으로 실행될 쿼리를 지정합니다. 매개변수 표현식은 다음을 통해 계산된 쿼리 문자열에 삽입될 수 있습니다.사용 중, 마찬가지로실행명령.

출력 매개변수를 사용하여 함수를 선언한 경우 다음과 같이 작성하세요.다음으로 돌아가기표현이 없습니다. 각 실행 시 출력 매개변수 변수의 현재 값은 최종 반환을 위해 결과 행으로 저장됩니다. 함수를 반환하도록 선언해야 합니다.SETOF 레코드여러 출력 매개변수가 있는 경우 또는SETOF어떤 유형유형의 출력 매개변수가 하나만 있는 경우어떤 유형, 출력 매개변수를 사용하여 집합 반환 함수를 생성하기 위해.

다음은 다음을 사용하는 함수의 예입니다.다음으로 돌아가기:

CREATE TABLE foo(foid INT, foosubid INT, fooname TEXT);
INSERT INTO foo VALUES (1, 2, '3');
foo 값에 삽입(4, 5, '6');

함수 생성 또는 교체 get_all_foo()는 SETOF foo AS를 반환합니다.
$BODY$
선언
    r foo%행유형;
시작
    r IN의 경우
        SELECT * FROM foo WHERE fooid  0
    토토 꽁 머니
        -- 여기에서 일부 처리를 수행할 수 있습니다.
        다음으로 돌아가기 r; -- SELECT의 현재 행을 반환합니다.
    엔드 토토 꽁 머니;
    반품;
종료
$BODY$
언어 plpgsql;

SELECT * FROM get_all_foo();

다음은 다음을 사용하는 함수의 예입니다.반환 쿼리:

CREATE FUNCTION get_available_flightid(date) SETOF 정수 AS를 반환합니다.
$BODY$
시작
    반환 쿼리 선택 항공편 ID
                   항공편 출발
                  비행 날짜 = $1인 곳
                    AND 항공편 날짜 < ($1 + 1);

    -- 실행이 완료되지 않았으므로 행이 반환되었는지 확인할 수 있습니다.
    -- 그렇지 않은 경우 예외를 발생시킵니다.
    발견되지 않은 경우
        RAISE EXEPTION '%.에 항공편 없음', $1;
    종료하면;

    반품;
 종료
$BODY$
언어 plpgsql;

-- 이용 가능한 항공편을 반환하거나 항공편이 없는 경우 예외 발생
-- 이용 가능한 항공편.
SELECT * FROM get_available_flightid(CURRENT_DATE);

40.6.2.1. IF-THEN

IF부울 표현식그때진술END IF;

IF-THEN문은 가장 간단한 형식입니다.IF. 사이의 진술그때그리고END IF조건이 true일 경우 실행됩니다. 그렇지 않으면 건너뜁니다.

예:

IF v_user_id < 0 THEN
    사용자 업데이트 SET email = v_email WHERE user_id = v_user_id;
종료하면;

40.6.2.2. IF-THEN-ELSE

IF부울 표현식그때문장ELSE문장END IF;

IF-THEN-ELSE문 추가IF-THEN조건이 참이 아닌 경우 실행되어야 하는 대체 명령문 세트를 지정할 수 있게 합니다. (여기에는 조건이 NULL로 평가되는 경우도 포함됩니다.)

예:

IF parentid가 NULL이거나 parentid = ''
그런 다음
    RETURN 전체 이름;
그 외
    RETURN hp_true_filename(부모 ID) || '/' || 성명;
종료하면;

IF v_count  0 THEN
    INSERT INTO users_count(개수) VALUES(v_count);
    't'를 반환합니다.
그 외
    'f'를 반환합니다.
종료하면;

40.6.2.3. IF-THEN-ELSIF

IF부울 표현식그때문장
[ELSIF부울 표현식그때문장
[ELSIF부울 표현식그때문장
    ...]]
[ELSE문장 ]
종료하면;

때때로 두 가지 이상의 대안이 있을 수 있습니다.IF-THEN-ELSIF여러 대안을 차례로 확인하는 편리한 방법을 제공합니다.IF조건은 참인 첫 번째 조건이 발견될 때까지 연속적으로 테스트됩니다. 그런 다음 관련 문이 실행되고 그 후 제어는 다음 문으로 전달됩니다.END IF. (모든 후속IF조건은아님테스트했습니다.) 다음 중 어느 것도 해당되지 않는 경우IF조건이 참이면ELSE블록(있는 경우)이 실행됩니다.

다음은 예입니다:

IF 숫자 = 0 THEN
    결과 := '0';
ELSIF 번호  0 THEN
    결과 := '긍정적';
ELSIF 숫자 < 0 THEN
    결과 := '부정';
그 외
    -- 흠, 유일한 다른 가능성은 숫자가 null이라는 것입니다.
    결과 := 'NULL';
종료하면;

핵심 단어ELSIF철자도 가능함ELSEIF.

동일한 작업을 수행하는 또 다른 방법은 중첩하는 것입니다.IF-THEN-ELSE문, 다음 예와 같이:

IF deco_row.sex = 'm' THEN
    Pretty_sex := '남자';
그 외
    IF deco_row.sex = 'f' 그러면
        Pretty_sex := '여자';
    종료하면;
종료하면;

그러나 이 방법은 일치하는 항목을 작성해야 합니다.END IF각각IF이므로 를 사용하는 것보다 훨씬 번거롭습니다.ELSIF대안이 많을 때.

40.6.2.4. 단순사례

사례검색 표현언제표현 [, 표현 [ ... ]] 그러면문장
  [언제표현 [, 표현 [ ... ]] 그러면문장
    ... ]
  [ELSE문장 ]
종료 사례;

간단한 형식사례피연산자의 동일성을 기반으로 조건부 실행을 제공합니다.검색 표현평가(한 번)되고 연속적으로 각각 비교됩니다.표현에서언제절. 일치하는 항목이 발견되면 해당하는문장실행된 후 제어는 다음 명령문으로 넘어갑니다.END CASE. (다음에)언제표현식은 평가되지 않습니다.) 일치하는 항목이 없으면ELSE 문장실행됩니다; 하지만 만약에ELSE존재하지 않는 경우 aCASE_NOT_FOUND예외가 발생했습니다.

다음은 간단한 예입니다:

사례 x
    1, 2일 때
        msg := '하나 또는 둘';
    그 외
        msg := '1 또는 2 이외의 값';
종료 사례;

40.6.2.5. 검색됨사례

사례
    언제부울 표현식그때문장
  [언제부울 표현식그때문장
    ... ]
  [ELSE문장 ]
종료 사례;

검색된 형태사례부울 표현식의 진실성을 기반으로 조건부 실행을 제공합니다. 각각언제절의부울 표현식결과가 나올 때까지 차례로 평가됩니다.참. 그러면 해당문장실행된 후 제어는 다음 명령문으로 넘어갑니다.END CASE. (다음에)언제표현식은 평가되지 않습니다.) 참 결과가 발견되지 않으면,ELSE 문장실행됩니다. 하지만 만약에ELSE존재하지 않는 경우 aCASE_NOT_FOUND예외가 발생했습니다.

다음은 예입니다:

사례
    WHEN x 0과 10 사이 THEN
        msg := '값은 0과 10 사이입니다.';
    언제 x 11시와 20시 사이
        msg := '값은 11에서 20 사이입니다';
종료 사례;

이 형식은사례완전히 다음과 같습니다.IF-THEN-ELSIF, 생략된 도달 규칙 제외ELSE절은 아무것도 하지 않는 대신 오류를 발생시킵니다.

40.6.3.1. 토토 꽁 머니

[ <<라벨 ]
토토 꽁 머니문장END 토토 꽁 머니 [ 라벨 ];

토토 꽁 머니에 의해 종료될 때까지 무기한 반복되는 무조건 토토 꽁 머니를 정의합니다.종료또는반환문장. 선택사항라벨다음에서 사용할 수 있습니다종료그리고계속중첩 토토 꽁 머니 내의 명령문을 사용하여 해당 명령문이 참조하는 토토 꽁 머니를 지정합니다.

40.6.3.2. 종료

종료 [ 라벨 ] [언제부울 표현식 ];

아니면라벨이 주어지면 가장 안쪽 토토 꽁 머니가 종료되고 다음 명령문이 나옵니다.END LOOP다음에 실행됩니다. 만일라벨이 주어지면 현재 또는 중첩 토토 꽁 머니나 블록의 일부 외부 수준의 레이블이어야 합니다. 그런 다음 명명된 토토 꽁 머니 또는 블록이 종료되고 토토 꽁 머니/블록의 해당 명령문 뒤의 명령문으로 제어가 계속됩니다.END.

만약언제이 지정되면 토토 꽁 머니 종료는 다음 경우에만 발생합니다.부울 표현식사실입니다. 그렇지 않으면 제어는 다음 문으로 전달됩니다.종료.

종료모든 유형의 토토 꽁 머니와 함께 사용할 수 있습니다. 무조건 토토 꽁 머니와 함께 사용하는 것으로 제한되지 않습니다.

a와 함께 사용하는 경우시작차단,종료블록 끝 이후의 다음 문으로 제어를 전달합니다. 이 목적을 위해서는 라벨을 사용해야 합니다. 라벨이 없는종료a와 일치하는 것으로 간주되지 않습니다.시작차단. (이는 8.4 이전 릴리스에서 변경된 사항입니다.PostgreSQL, 이는 라벨이 지정되지 않은종료a와 일치시키다시작차단합니다.)

예:

토토 꽁 머니
    -- 일부 계산
    IF 개수  0 그러면
        종료;  -- 토토 꽁 머니 종료
    종료하면;
엔드 토토 꽁 머니;

토토 꽁 머니
    -- 일부 계산
    개수  0일 때 종료합니다.  -- 이전 예제와 동일한 결과
엔드 토토 꽁 머니;

<<차단
시작
    -- 일부 계산
    IF 주식  100000 THEN
        EXIT 블록;  -- BEGIN 블록을 종료합니다.
    종료하면;
    -- 주식  100000인 경우 여기 계산은 건너뜁니다.
끝;

40.6.3.3. 계속

계속 [ 라벨 ] [언제부울 표현식 ];

아니면라벨이 주어지면 가장 안쪽 토토 꽁 머니의 다음 반복이 시작됩니다. 즉, 토토 꽁 머니 본문에 남아 있는 모든 문을 건너뛰고 제어가 토토 꽁 머니 제어 표현식(있는 경우)으로 반환되어 다른 토토 꽁 머니 반복이 필요한지 여부를 결정합니다. 만일라벨이 있으면 실행이 계속될 토토 꽁 머니의 레이블을 지정합니다.

만약언제이 지정되면 토토 꽁 머니의 다음 반복은 다음 경우에만 시작됩니다.부울 표현식사실입니다. 그렇지 않으면 제어는 다음 문으로 전달됩니다.계속.

계속모든 유형의 토토 꽁 머니와 함께 사용할 수 있습니다. 무조건 토토 꽁 머니와 함께 사용하는 것으로 제한되지 않습니다.

예:

토토 꽁 머니
    -- 일부 계산
    개수가 100보다 크면 종료합니다.
    개수가 50 미만일 때 계속하세요.
    -- 개수 IN [50 .. 100]에 대한 일부 계산
끝 토토 꽁 머니;

40.6.3.4. 동안

[ <<라벨 ]
동안부울 표현식토토 꽁 머니문장END 토토 꽁 머니 [ 라벨 ];

그동안문은 다음과 같은 경우 일련의 문을 반복합니다.부울 표현식참으로 평가됩니다. 토토 꽁 머니 본문에 대한 각 항목 직전에 표현식이 검사됩니다.

예:

채무 금액  0 AND 선물_증명서 잔액  0 LOOP인 동안
    -- 여기에 몇 가지 계산이 있습니다.
엔드 토토 꽁 머니;

토토 꽁 머니가 완료되지 않은 동안
    -- 여기에 몇 가지 계산이 있습니다.
끝 토토 꽁 머니;

40.6.3.5. for(정수 변형)

[ <<라벨 ]
에 대한이름IN [반전] 표현 .. 표현 [BY표현 ] 토토 꽁 머니문장END 토토 꽁 머니 [ 라벨 ];

이 형태는for정수 값 범위를 반복하는 토토 꽁 머니를 생성합니다. 변수이름자동으로 유형으로 정의됩니다.정수그리고 토토 꽁 머니 내부에만 존재합니다(변수 이름의 기존 정의는 토토 꽁 머니 내에서 무시됩니다). 범위의 하한과 상한을 제공하는 두 표현식은 토토 꽁 머니에 들어갈 때 한 번 평가됩니다. 만약BY절이 지정되지 않았습니다. 반복 단계는 1입니다. 그렇지 않으면에 지정된 값입니다.BY절, 토토 꽁 머니 진입 시 다시 한 번 평가됩니다. 만일반전이 지정되면 각 반복 후에 단계 값이 더해지는 것이 아니라 빼집니다.

정수의 몇 가지 예for토토 꽁 머니:

i IN 1..10 토토 꽁 머니용
    -- 토토 꽁 머니 내에서 1,2,3,4,5,6,7,8,9,10 값을 사용하겠습니다.
엔드 토토 꽁 머니;

역방향 10..1 토토 꽁 머니의 i용
    -- 토토 꽁 머니 내에서 10,9,8,7,6,5,4,3,2,1 값을 사용하겠습니다.
엔드 토토 꽁 머니;

i에 대한 역방향 10..1 BY 2 토토 꽁 머니
    -- 토토 꽁 머니 내에서 10,8,6,4,2 값을 사용하겠습니다.
끝 토토 꽁 머니;

하한이 상한보다 큰 경우(또는 다음보다 작으면반전case), 토토 꽁 머니 본문이 전혀 실행되지 않습니다. 오류가 발생하지 않습니다.

만약에라벨다음에 첨부되어 있습니다.forloop 그러면 정수 토토 꽁 머니 변수는 이를 사용하여 정규화된 이름으로 참조될 수 있습니다.라벨.

40.6.6.1. 오류에 대한 정보 얻기

예외 핸들러는 발생한 특정 오류를 식별해야 하는 경우가 많습니다. 현재 예외에 대한 정보를 얻는 방법에는 두 가지가 있습니다.PL/pgSQL: 특수 변수 및스택 진단 받기명령.

예외 핸들러 내에서 특수 변수SQLSTATE발생한 예외에 해당하는 오류 코드를 포함합니다(참조표 A-1가능한 오류 코드 목록 참조). 특수 변수SQLERRM예외와 관련된 오류 메시지가 포함되어 있습니다. 이러한 변수는 예외 처리기 외부에서 정의되지 않습니다.

예외 처리기 내에서 다음을 사용하여 현재 예외에 대한 정보를 검색할 수도 있습니다.스택 진단 받기다음 형식의 명령:

스택 진단 받기변수 { = | := } 항목 [ , ... ];

각각항목지정된 항목에 할당될 상태 값을 식별하는 키워드입니다.변수(수신하려면 올바른 데이터 유형이어야 함). 현재 사용 가능한 상태 항목은 다음과 같습니다.표 40-2.

예외가 항목에 대한 값을 설정하지 않은 경우 빈 문자열이 반환됩니다.

다음은 예입니다:

선언하다
  text_var1 텍스트;
  text_var2 텍스트;
  text_var3 텍스트;
시작
  -- 예외가 발생할 수 있는 일부 처리
  ...
그 외의 경우에는 예외
  스택 진단 받기 text_var1 = MESSAGE_TEXT,
                          text_var2 = PG_EXCEPTION_DETAIL,
                          text_var3 = PG_EXCEPTION_HINT;
끝;