윈 토토 : 문서 : 9.4 : 윈 토토 | |||
---|---|---|---|
PostgreSQL : 문서 : 9.4 : 토토 꽁 머니 구조 | 와이즈 토토 : 문서 : 9.4 : PL/PGSQL -SQL 절차 언어 | 40 장pl/pgsql - SQL절차 언어 | 다음 |
한 번에 전체 쿼리를 실행하는 대신 A를 설정할 수 있습니다.와이즈 토토10328_10525pl/pgsql사용자는 일반적으로 그것에 대해 걱정할 필요가 없습니다.for루프는 메모리 문제를 피하기 위해 내부적으로 와이즈 토토를 자동으로 사용합니다.) 더 흥미로운 사용법은 함수가 만든 와이즈 토토에 대한 참조를 반환하여 발신자가 행을 읽을 수 있도록하는 것입니다. 이것은 기능에서 큰 행 세트를 반환하는 효율적인 방법을 제공합니다.
와이즈 토토에 대한 모든 액세스pl/pgsql항상 특수 데이터 유형 인 와이즈 토토 변수를 통과합니다Refcursor. 와이즈 토토 변수를 생성하는 한 가지 방법은 유형 변수로 선언하는 것입니다Refcursor. 또 다른 방법은 와이즈 토토 선언 구문을 사용하는 것입니다. 일반적으로 :
이름[[아니오] 스크롤] 와이즈 토토 [(인수)] for쿼리;
(for로 대체 할 수 있습니다isforOracle호환성.) if스크롤지정되어 있으면 와이즈 토토는 뒤로 스크롤 할 수 있습니다. 만약에스크롤 없음지정되어 있으면 뒤로 페치가 거부됩니다. 사양이 나타나지 않으면 뒤로 페치가 허용되는지 여부는 쿼리 의존적입니다.인수지정된 경우 쉼표로 구분 된 쌍의 목록이름 DataType주어진 쿼리의 매개 변수 값으로 대체 할 이름을 정의하는 것. 이 이름을 대체 할 실제 값은 와이즈 토토가 열리면 나중에 지정됩니다.
일부 예 :
선언 CURS1 Refcursor; select * from tenk1에 대한 curs2 cursor; select * from tenk1에 대한 curs3 cursor (키 정수).
이 세 가지 변수 모두 데이터 유형이 있습니다Refcursor, 그러나 첫 번째는 쿼리와 함께 사용할 수 있지만 두 번째는 완전히 지정된 쿼리가 있습니다bound그것에, 그리고 마지막에는 매개 변수화 된 쿼리가 있습니다. (키와이즈 토토가 열리면 정수 매개 변수 값으로 대체됩니다.) 변수13123_13130Unbound특정 쿼리에 바인딩되지 않기 때문에
와이즈 토토를 사용하기 전에 행을 검색하기 전에오픈. (이것은 SQL 명령과 동등한 조치입니다와이즈 토토 선언.)pl/pgsql세 가지 형태의Open명령문은 두 개의 와이즈 토토 변수를 사용하고 세 번째는 바운드 와이즈 토토 변수를 사용합니다.
참고 :바운드 와이즈 토토 변수는 와이즈 토토를 명시 적으로 열지 않고도 사용할 수 있습니다.for진술서에 설명 된섹션 40.7.4.
OpenUnbound_cursorvar[[아니오] 스크롤] for쿼리;
와이즈 토토 변수가 열리고 지정된 쿼리가 제공됩니다. 와이즈 토토는 이미 열 수 없으며, 결합되지 않은 와이즈 토토 변수로 선언되었을 것입니다 (즉, 간단하게Refcursor변수). 쿼리는 여야합니다.select또는 행을 반환하는 다른 것 (예 :설명). 쿼리는 다른 SQL 명령과 같은 방식으로 처리됩니다.pl/pgsql: PL/PGSQL가변 이름을 대체하고 쿼리 계획은 재사용 가능한 재사용을 위해 캐시됩니다. Apl/pgsql변수가 와이즈 토토 쿼리로 대체되며, 대체 된 값은입니다.Open; 변수에 대한 후속 변경은 와이즈 토토의 동작에 영향을 미치지 않습니다. 그만큼스크롤및스크롤 없음옵션은 바운드 와이즈 토토와 동일한 의미를 갖습니다.
예 :
select * from foo where key = mykey;의 curs1을 엽니 다.
Openunbound_cursorvar[[아니오] 스크롤] executequery_string[사용표현[, ... ]];
와이즈 토토 변수가 열리고 지정된 쿼리가 제공됩니다. 와이즈 토토는 이미 열 수 없으며, 결합되지 않은 와이즈 토토 변수로 선언되었을 것입니다 (즉, 간단하게Refcursor변수). 쿼리는와 같은 방식으로 문자열 표현식으로 지정됩니다.execute명령. 평소와 같이, 이것은 유연성을 제공하므로 쿼리 계획은 한 번에서 다음 실행마다 다를 수 있습니다 (참조섹션 40.10.2), 또한 명령 문자열에서 변수 대체가 수행되지 않았 음을 의미합니다. 와 마찬가지로execute, 매개 변수 값을 동적 명령에 삽입 할 수 있습니다사용. 그만큼스크롤and스크롤 없음옵션은 바운드 와이즈 토토와 동일한 의미를 갖습니다.
예 :
execute 'select * from'|| quote_ident (tabname) || '여기서 col1 = $ 1'KeyValue를 사용하여;
이 예에서 테이블 이름은 쿼리에 텍스트에 삽입되므로 사용quote_ident ()
SQL 주입을 보호하는 것이 좋습니다. 에 대한 비교 값col1a사용매개 변수이므로 인용이 필요하지 않습니다.
Openbound_cursorvar[([ argument_name: =]argument_value[, ...])];
이 형태의Open쿼리가 선언 될 때 쿼리가 묶인 와이즈 토토 변수를 열는 데 사용됩니다. 와이즈 토토는 이미 열 수 없습니다. 와이즈 토토가 인수를 받으라고 선언 된 경우에만 실제 인수 값 표현 목록이 나타나야합니다. 이 값은 쿼리에서 대체됩니다.
바운드 와이즈 토토에 대한 쿼리 계획은 항상 캐시 가능한 것으로 간주됩니다. 에 해당하지 않습니다.execute이 경우. 주석스크롤and스크롤 없음에서 지정할 수 없습니다Open, 와이즈 토토의 스크롤 행동이 이미 결정되었으므로
인수 값은 하나를 사용하여 전달 될 수 있습니다위치또는이름표기법. 위치 표기법에서는 모든 인수가 순서대로 지정됩니다. 명명 된 표기법에서 각 인수의 이름은를 사용하여 지정됩니다.: =인수 표현에서 그것을 분리하려면. 에 설명 된 함수 호출과 유사합니다PostgreSQL : 문서 : 9.4 : 토토 사이트 호출, 또한 위치와 명명 된 표기법을 혼합 할 수 있습니다.
예제 (위의 와이즈 토토 선언 예제를 사용) :
Open Curs2; 열린 curs3 (42); CURS3 열기 (키 : = 42);
19172_19333Openpl/pgsql쿼리의 변수. 그러나 바운드 와이즈 토토가 선언되기 전에 선언 된 변수만이 대체 될 것입니다. 두 경우 모두 통과 할 값은 당시 결정됩니다.Open. 예를 들어, 또 다른 방법은와 같은 효과를 얻는다.CURS3위의 예는
선언 키 정수; select * from tenk1에 대한 curs4 cursor where ightorian1 = key; 시작하다 키 : = 42; 오픈 커스 4;
와이즈 토토가 열리면 여기에 설명 된 진술로 조작 할 수 있습니다.
이러한 조작은 와이즈 토토를 열었던 것과 동일한 함수에서 발생할 필요가 없습니다. 당신은 a를 반환 할 수 있습니다.Refcursor함수에서 값을 벗어나 발신자가 와이즈 토토에서 작동하도록합니다. (내부적으로 ARefcursor값은 단순히 와이즈 토토의 활성 쿼리를 포함하는 소위 포털의 문자열 이름입니다. 이 이름은 주변을 지나갈 수 있으며 다른 사람에게 할당Refcursor포털을 방해하지 않고 변수 등.)
모든 포털은 트랜잭션 종료시 암시 적으로 닫힙니다. 따라서 aRefcursor값은 거래가 끝날 때까지 열린 와이즈 토토를 참조하는 데 사용할 수 있습니다.
Fetch [ 방향From | 안에]와이즈 토토in대상;
fetch와이즈 토토에서 대상으로 다음 행을 검색합니다.이 행은 행 변수, 레코드 변수 또는 쉼표로 구분 된 간단한 변수 목록이 될 수 있습니다.선택. 다음 행이 없으면 대상이 NULL로 설정됩니다. 와 마찬가지로선택, 특별 변수발견행이 얻어 졌는지 여부를 확인할 수 있습니다.
the방향조항은 SQL에서 허용되는 변형 중 하나 일 수 있습니다PostgreSQL : 문서 : 9.4 : 와이즈 토토하나 이상의 행을 가져올 수있는 명령을 제외하고; 즉,다음, 이전, 첫 번째, Last, 절대 count, 상대 count, Forward또는뒤로. 생략방향지정과 동일합니다다음. a를 사용하여 형식으로count, ThecountSQL과 달리 정수 값 표현이 될 수 있습니다.fetch명령, 정수 만 상수 만 허용).방향뒤로 이동 해야하는 값은 와이즈 토토가 선언되거나 열려 있지 않으면스크롤옵션.
와이즈 토토A의 이름이어야합니다Refcursor열린 와이즈 토토 포털을 참조하는 변수.
예 :
curs1을 Rowvar로 가져옵니다. curs2를 foo, bar, baz로 가져옵니다. Curs3에서 x, y로 마지막으로 가져 오십시오. CURS4에서 X 로의 상대적 -2를 가져옵니다.
이동 [ 방향from | 안에]와이즈 토토;
움직임데이터를 검색하지 않고 와이즈 토토를 재배치합니다.움직임똑같은 일fetch명령 - 와이즈 토토 만 재배치하고 이동 한 행을 반환하지 않는 경우를 제외하고. 와 마찬가지로선택, 특별 변수발견로 이동할 다음 행이 있는지 확인할 수 있습니다.
예 :
Move Curs1; CURS3에서 마지막으로 이동; CURS4에서 상대적 -2를 이동; Curs4에서 2를 앞으로 이동;
업데이트테이블세트 ...와이즈 토토;테이블전류의 위치와이즈 토토;
와이즈 토토가 테이블 행에 배치되면 해당 행을 와이즈 토토를 사용하여 업데이트하거나 삭제하여 행을 식별 할 수 있습니다. 와이즈 토토의 쿼리가 무엇인지 (특히 그룹화 없음)에 대한 제한이 있으며 사용하는 것이 가장 좋습니다업데이트와이즈 토토에서. 자세한 내용은를 참조하십시오.토토 사이트 PostgreSQL : 문서 : 9.4 : 선언참조 페이지.
예 :
업데이트 foo set dataval = myval where curs1;
닫기와이즈 토토;
닫기열린 와이즈 토토의 기본 포털을 닫습니다. 이것은 트랜잭션 종료 전에 일찍 리소스를 릴리스하거나 와이즈 토토 변수를 다시 열 수있는 데 사용될 수 있습니다.
예 :
Close Curs1;
PL/PGSQL함수는 와이즈 토토를 발신자에게 반환 할 수 있습니다. 이것은 여러 행이나 열, 특히 매우 큰 결과 세트에서 반환하는 데 유용합니다. 이를 위해 함수는 와이즈 토토를 열고 와이즈 토토 이름을 발신자에게 반환합니다 (또는 발신자에게 지정된 또는 다른 것으로 알려진 포털 이름을 사용하여 와이즈 토토를 엽니 다). 그런 다음 발신자는 와이즈 토토에서 행을 가져올 수 있습니다. 발신자가 와이즈 토토를 닫을 수 있거나 트랜잭션이 닫히면 자동으로 닫힙니다.
와이즈 토토에 사용되는 포털 이름은 프로그래머가 지정하거나 자동으로 생성 될 수 있습니다. 포털 이름을 지정하려면에 문자열을 할당합니다.Refcursor열기 전에 변수. 의 문자열 값Refcursor변수는 사용합니다.Open기본 포털의 이름으로. 그러나이면Refcursor변수는 null,Open기존 포털과 충돌하지 않는 이름을 자동으로 생성하고에 할당합니다.Refcursor가변.
참고 :바운드 와이즈 토토 변수는 이름을 나타내는 문자열 값으로 초기화되므로 포털 이름은 와이즈 토토를 열기 전에 할당하여 프로그래머가 할당을 비난하지 않는 한 포털 이름이 와이즈 토토 변수 이름과 동일합니다. 그러나 처음에는 unull 값에 대한 부정확 한 와이즈 토토 변수 기본값이 있으므로 재정의하지 않는 한 자동으로 생성 된 고유 이름을 받게됩니다.
다음 예제는 발신자가 와이즈 토토 이름을 제공 할 수있는 한 가지 방법을 보여줍니다.
테이블 테스트 생성 (col 텍스트); 테스트 값에 삽입 ( '123'); 기능 reffunc (refcursor) 생성 refcursor를 다시 반환합니다. 시작하다 Test에서 COL SELECT COL에 대해 $ 1을 엽니 다; $ 1의 반환; 끝; '언어 plpgsql; 시작하다; Reffunc ( 'funccursor')을 선택하십시오. funccursor에서 모두 가져 오십시오. 저지르다;
다음 예제는 자동 와이즈 토토 이름 생성을 사용합니다 :
함수 만들기 reffunc2 () refcursor를 반환합니다. 선언하다 refcursor; 시작하다 테스트에서 COL SELECT COL에 대한 공개 심판; 반환 심판; 끝; '언어 plpgsql; - 와이즈 토토를 사용하려면 거래에 있어야합니다. 시작하다; 선택 reffunc2 (); Reffunc2 ------------------- <이름이없는 와이즈 토토 1 (1 줄) "<이름없는 와이즈 토토 1"에서 모두 가져 오십시오. 저지르다;
다음 예제는 단일 함수에서 여러 와이즈 토토를 반환하는 한 가지 방법을 보여줍니다.
함수 생성 myfunc (refcursor, refcursor)는 refcursor를 $$로 반환합니다 시작하다 table_1에서 선택 *에 대해 $ 1을 엽니 다; 다음 $ 1; table_2에서 select *에 대해 $ 2를 엽니 다; 다음 $ 2를 반환합니다. 끝; $$ 언어 plpgsql; - 와이즈 토토를 사용하려면 거래에 있어야합니다. 시작하다; myfunc ( 'a', 'b')에서 *를 선택하십시오. a에서 모두 가져 오십시오. b에서 모두 가져 오십시오. 저지르다;
의 변형이 있습니다for와이즈 토토에 의해 반환 된 행을 반복 할 수있는 명령문. 구문은 다음과 같습니다.
[ <<레이블 ] 을 위한RecordVarinbound_cursorvar[([ argument_name: =]argument_value[, ...])] loop진술엔드 루프 [ 레이블 ];
와이즈 토토 변수가 선언 될 때 쿼리에 바인딩되었을 것입니다.할 수 없음이미 열려 있습니다. 그만큼for명령문은 자동으로 와이즈 토토를 열고 루프가 종료 될 때 와이즈 토토를 다시 닫습니다. 와이즈 토토가 인수를 받으라고 선언 된 경우에만 실제 인수 값 표현 목록이 나타나야합니다. 이 값은 쿼리에서 |Open(참조섹션 40.7.2.3).
변수RecordVar자동으로 유형으로 정의레코드루프 안에만 존재합니다 (변수 이름의 기존 정의는 루프 내에서 무시됩니다). 와이즈 토토가 반환 한 각 행은이 레코드 변수에 연속적으로 할당되며 루프 본체가 실행됩니다.