42.3.1. 데이터 유형 매핑

함수 인수는 토토 핫 유형에서 변환됩니다 해당 Python 유형으로:

• 포스트그레SQL부울다음으로 변환됩니다. 파이썬부울.

• 포스트그레SQLsmallint그리고int파이썬으로 변환됩니다int. 포스트그레SQL비긴트이다 으로 변환됨긴Python 2 및 toint파이썬 3에서.

• 포스트그레SQL진짜, 더블및숫자있습니다 Python으로 변환됨플로트. 참고하세요 에 대한숫자이것은 패배합니다 정보를 제공하여 잘못된 결과를 초래할 수 있습니다. 이것은 아마도 향후 릴리스에서 수정될 예정입니다.

• 토토 핫바이테아다음으로 변환됩니다. 파이썬strPython 2 및 to바이트Python 3에서는. Python 2에서는 문자열은 아무 것도 없이 바이트 시퀀스로 처리되어야 합니다. 문자 인코딩.

• 토토 핫 문자를 포함한 기타 모든 데이터 유형 문자열 유형은 Python으로 변환됩니다.str. Python 2에서 이 문자열은 토토 핫 서버 인코딩; Python 3에서는 모든 문자열과 같은 유니코드 문자열입니다.

• 비스칼라 데이터 유형에 대해서는 아래를 참조하십시오.

함수 반환 값은 선언된 값으로 변환됩니다. 토토 핫은 다음과 같은 데이터 유형을 반환합니다.

• 토토 핫 반환 유형이 다음과 같은 경우부울, 반환 값은 다음에 대해 평가됩니다. 에 따르면 진실파이썬규칙. 즉, 0과 빈 문자열은 false이지만 특히'f'사실입니다.

• 토토 핫 반환 유형이 다음과 같은 경우바이테아, 반환 값은 각각을 사용하는 문자열(Python 2) 또는 바이트(Python 3) 결과가 변환되는 Python 내장바이테아.

• 다른 모든 토토 핫 반환 유형의 경우 반환된 Python 값은 Python을 사용하여 문자열로 변환됩니다. 내장str, 결과는 다음과 같습니다. 토토 핫 데이터의 입력 함수에 전달됨 유형.

  Python 2의 문자열은 토토 핫에 있어야 합니다. 토토 핫로 전달될 때 서버 인코딩. 문자열 현재 서버 인코딩에서 유효하지 않은 것은 오류가 발생하지만 모든 인코딩 불일치가 발생할 수 있는 것은 아닙니다. 감지되지 않았더라도 가비지 데이터가 계속 발생할 수 있습니다. 올바르게 수행되었습니다. 유니코드 문자열은 다음으로 변환됩니다. 인코딩을 자동으로 수정하므로 더 안전하고 더 많은 작업을 수행할 수 있습니다. 그것들을 사용하는 것이 편리합니다. Python 3에서는 모든 문자열이 유니코드 문자열.

• 비스칼라 데이터 유형에 대해서는 아래를 참조하세요.

선언된 토토 핫 간의 논리적 불일치에 유의하세요. 반환 유형과 실제 반환의 Python 데이터 유형 개체에 플래그가 지정되지 않았습니다. 값은 어떤 방식으로든 변환됩니다. 경우.

42.3.2. 널, 없음

SQL null 값이 함수에 전달되면 인수는 값은 다음과 같이 표시됩니다.없음파이썬에서. 예를 들어, 다음의 함수 정의는파이맥스표시됨섹션 42.2잘못된 결과를 반환할 것입니다 null 입력에 대한 답변입니다. 추가할 수도 있습니다STRICT만들 함수 정의에토토 핫뭔가 더 해라 합리적: null 값이 전달되면 함수는 실행되지 않습니다. 전혀 호출되지 않았지만 null 결과만 반환합니다. 자동으로. 또는 다음에서 null 입력을 확인할 수 있습니다. 함수 본문:

CREATE FUNCTION pymax (a 정수, b 정수)
  정수를 반환합니다.
AS $$
  (a가 없음) 또는 (b가 없음)인 경우:
    반환 없음
  a  b인 경우:
    반환하다
  b를 돌려주다
$$ 언어 plpythonu;

위에 표시된 대로 PL/Python에서 SQL null 값을 반환하려면 함수, 값을 반환합니다.없음. 이 기능이 엄격한지 여부에 관계없이 수행될 수 있습니다.

42.3.3. 배열, 목록

SQL 배열 값은 Python 목록으로 PL/Python에 전달됩니다. PL/Python 함수에서 SQL 배열 값을 반환하려면, Python 시퀀스(예: 목록 또는 튜플)를 반환합니다.

함수 생성 return_arr()
  반환 정수[]
AS $$
반환 (1, 2, 3, 4, 5)
$$ 언어 plpythonu;

SELECT return_arr();
 return_arr  
-------------
 1,2,3,4,5

파이썬에서 문자열은 시퀀스이며 다음을 가질 수 있습니다. Python에 익숙할 수 있는 바람직하지 않은 효과 프로그래머:

함수 생성 return_str_arr()
  varchar[]를 반환합니다.
AS $$
"안녕하세요"를 반환
$$ 언어 plpythonu;

SELECT return_str_arr();
 return_str_arr
----------------
 h,e,l,l,o

42.3.4. 복합 유형

복합 유형 인수는 다음과 같이 함수에 전달됩니다. 파이썬 매핑. 매핑의 요소 이름은 다음과 같습니다. 복합 유형의 속성 이름. 다음의 속성인 경우 전달된 행에 null 값이 있고 값이 있습니다.없음매핑에 있습니다. 예는 다음과 같습니다.

CREATE TABLE 직원(
  이름 텍스트,
  급여 정수,
  연령 정수
);

CREATE FUNCTION 초과 지급(e 직원)
  반환 부울
AS $$
  e["salary"]  200000인 경우:
    True를 반환
  if (e["age"] < 30) 및 (e["salary"]  100000):
    True를 반환
  거짓을 반환
$$ 언어 plpythonu;

행 또는 복합 유형을 반환하는 방법에는 여러 가지가 있습니다 Python 함수에서. 다음 예에서는 다음과 같이 가정합니다. 가지고 있는 것:

CREATE TYPE 명명된_값 AS(
  이름 텍스트,
  값 정수
);

복합 결과는 다음과 같이 반환될 수 있습니다:

함수아웃매개변수는 또한 지원됩니다. 예를 들면:

CREATE FUNCTION multiout_simple(OUT i 정수, OUT j 정수) AS $$
반환 (1, 2)
$$ 언어 plpythonu;

SELECT * FROM multiout_simple();

42.3.5. 집합 반환 함수

A PL/파이썬함수는 또한 스칼라 또는 복합 유형 세트를 반환합니다. 있다 반환된 객체는 다음과 같기 때문에 이를 달성하는 여러 가지 방법이 있습니다. 내부적으로 반복자로 바뀌었습니다. 다음 예 복합 유형이 있다고 가정합니다.

다음 유형의 인사말 작성(
  어떻게 텍스트,
  누가 문자를 보내?
);

설정된 결과는 다음에서 반환될 수 있습니다:

설정 반환 함수아웃매개변수(사용SETOF를 반환합니다. 기록)도 지원됩니다. 예를 들면:

CREATE FUNCTION multiout_simple_setof(n 정수, OUT 정수, OUT 정수) SETOF 레코드 AS $$를 반환합니다.
반환 [(1, 2)] * n
$$ 언어 plpythonu;

SELECT * FROM multiout_simple_setof(3);