그postgres_fdw모듈은 외부 데이터 래퍼를 제공합니다postgres_fdw, 외부에 저장된 데이터에 액세스하는 데 사용할 수 있음포스트그레SQL토토 결과.
이 모듈이 제공하는 기능은 이전 모듈의 기능과 실질적으로 겹칩니다.PostgreSQL : 문서 : 14 : F.10. 토토 사이트 순위모듈. 하지만postgres_fdw원격 테이블에 액세스하기 위한 보다 투명하고 표준을 준수하는 구문을 제공하며 많은 경우에 더 나은 성능을 제공할 수 있습니다.
다음을 사용하여 원격 액세스를 준비하려면postgres_fdw:
설치postgres_fdw확장을 사용하여확장 프로그램 만들기.
다음을 사용하여 외부 서버 개체를 생성합니다.토토 결과 생성, 연결하려는 각 원격 데이터베이스를 나타냅니다. 다음을 제외한 연결 정보를 지정하십시오.사용자그리고비밀번호, 토토 결과 개체의 옵션으로.
다음을 사용하여 사용자 매핑을 생성합니다.사용자 매핑 생성, 각 데이터베이스 사용자에 대해 각 외부 서버에 대한 액세스를 허용합니다. 사용할 원격 사용자 이름과 비밀번호를 지정하세요.사용자그리고비밀번호사용자 매핑 옵션.
다음을 사용하여 외부 테이블 생성외부 테이블 생성또는외국 스키마 가져오기, 액세스하려는 각 원격 테이블에 대해. 외부 테이블의 열은 참조된 원격 테이블과 일치해야 합니다. 그러나 외부 테이블 개체의 옵션으로 올바른 원격 이름을 지정하는 경우 원격 테이블과 다른 테이블 및/또는 열 이름을 사용할 수 있습니다.
이제 당신에게 필요한 것은선택외부 테이블에서 기본 원격 테이블에 저장된 데이터에 액세스합니다. 다음을 사용하여 원격 테이블을 수정할 수도 있습니다.삽입, 업데이트, 삭제, 복사, 또는잘라내기. (물론, 사용자 매핑에 지정한 원격 사용자에게는 이러한 작업을 수행할 수 있는 권한이 있어야 합니다.)
참고하세요만옵션이 지정됨선택, 업데이트, 삭제또는잘라내기원격 테이블에 액세스하거나 수정할 때 효과가 없습니다.
참고postgres_fdw현재 다음 항목에 대한 지원이 부족합니다.삽입다음이 포함된 문충돌 시 업데이트를 하세요절. 그러나,충돌 시 아무것도 하지 않음13102_13201postgres_fdw다음에 의해 호출된 행 이동을 지원합니다.업데이트문은 분할된 테이블에서 실행되지만 현재는 이동된 행을 삽입하기 위해 선택한 원격 파티션도 분할된 테이블인 경우를 처리하지 않습니다.업데이트같은 명령의 다른 곳에서 업데이트될 대상 파티션.
일반적으로 외부 테이블의 열은 원격 테이블의 참조 열과 정확히 동일한 데이터 유형 및 해당되는 경우 데이터 정렬로 선언되는 것이 좋습니다. 그래도postgres_fdw현재 필요에 따라 데이터 유형 변환을 수행하는 것에 대해 관대합니다. 원격 서버가 쿼리 조건을 로컬 서버와 다르게 해석하기 때문에 유형이나 대조가 일치하지 않는 경우 놀라운 의미적 이상이 발생할 수 있습니다.
외부 테이블은 기본 원격 테이블보다 더 적은 수의 열 또는 다른 열 순서로 선언될 수 있습니다. 열과 원격 테이블의 일치는 위치가 아닌 이름을 기준으로 이루어집니다.
다음을 사용하는 외부 서버postgres_fdw외부 데이터 래퍼는 다음과 동일한 옵션을 가질 수 있습니다.libpq에 설명된 대로 연결 문자열을 허용합니다.섹션 34.1.2, 단, 다음 옵션은 허용되지 않거나 특별 처리가 있습니다.
사용자, 비밀번호그리고ssl비밀번호(대신 사용자 매핑에서 이를 지정하거나 서비스 파일을 사용하십시오)
client_encoding(로컬 토토 결과 인코딩에서 자동으로 설정됨)
fallback_application_name(항상 다음으로 설정됨postgres_fdw)
sslkey그리고sslcert- 다음 항목에 나타날 수 있습니다.둘 중 하나 또는 둘 다연결 및 사용자 매핑. 둘 다 존재하는 경우 사용자 매핑 설정이 연결 설정보다 우선 적용됩니다.
수퍼유저만이 다음을 사용하여 사용자 매핑을 생성하거나 수정할 수 있습니다.sslcert또는sslkey설정.
수퍼유저만이 비밀번호 인증 없이 외부 서버에 연결할 수 있으므로 항상 다음을 지정하십시오.비밀번호수퍼유저가 아닌 사용자 매핑에 대한 옵션.
수퍼유저는 사용자 매핑 옵션을 설정하여 사용자별 매핑 기준으로 이 검사를 무시할 수 있습니다.password_required 'false'예:
some_non_superuser 서버 loopback_nopw에 대한 사용자 매핑 변경 옵션(추가 비밀번호_필수 'false');
권한이 없는 사용자가 postgres 서버가 실행 중인 unix 사용자의 인증 권한을 수퍼유저 권한으로 승격시키는 것을 방지하기 위해 수퍼유저만 사용자 매핑에서 이 옵션을 설정할 수 있습니다.
이로 인해 매핑된 사용자가 CVE-2007-3278 및 CVE-2007-6601에 따라 매핑된 데이터베이스에 수퍼유저로 연결하는 기능을 허용하지 않도록 주의가 필요합니다. 설정하지 않음password_required=false에공개역할. 매핑된 사용자는 잠재적으로 모든 클라이언트 인증서를 사용할 수 있다는 점을 명심하세요..pgpass, .pg_service.conf17557_17717동료또는ident인증.
이 옵션은 원격으로 전송되는 SQL 문에 사용되는 이름을 제어하는 데 사용할 수 있습니다.포스트그레SQL토토 결과. 이러한 옵션은 기본 원격 테이블 이름과 다른 이름으로 외부 테이블을 생성할 때 필요합니다.
schema_name외부 테이블에 대해 지정할 수 있는 이 옵션은 원격 토토 결과의 외부 테이블에 사용할 스키마 이름을 제공합니다. 이 옵션을 생략하면 외부 테이블의 스키마 이름이 사용됩니다.
테이블_이름외부 테이블에 대해 지정할 수 있는 이 옵션은 원격 토토 결과의 외부 테이블에 사용할 테이블 이름을 제공합니다. 이 옵션을 생략하면 외부 테이블의 이름이 사용됩니다.
열_이름외부 테이블의 열에 대해 지정할 수 있는 이 옵션은 원격 토토 결과의 열에 사용할 열 이름을 제공합니다. 이 옵션을 생략하면 해당 컬럼의 이름이 사용됩니다.
postgres_fdw은 원격 서버에 대해 쿼리를 실행하여 원격 데이터를 검색하므로 이상적으로는 외부 테이블을 스캔하는 데 드는 예상 비용은 원격 서버에서 수행하는 데 드는 비용과 통신을 위한 약간의 오버헤드를 더한 금액이어야 합니다. 이러한 견적을 얻는 가장 신뢰할 수 있는 방법은 원격 서버에 문의한 다음 오버헤드에 대해 무언가를 추가하는 것입니다. 그러나 간단한 쿼리의 경우 비용 견적을 얻기 위해 추가 원격 쿼리 비용을 들일 가치가 없을 수도 있습니다. 그래서postgres_fdw비용 추정 수행 방법을 제어할 수 있는 다음 옵션을 제공합니다.
use_remote_estimate외부 테이블이나 외부 서버에 대해 지정할 수 있는 이 옵션은 다음을 제어합니다.postgres_fdw원격 문제설명비용 견적을 얻는 명령입니다. 외부 테이블에 대한 설정은 해당 토토 결과에 대한 모든 설정을 재정의하지만 해당 테이블에 대해서만 적용됩니다. 기본값은거짓.
fdw_startup_cost외부 서버에 대해 지정할 수 있는 이 옵션은 해당 서버에서 외부 테이블 스캔의 예상 시작 비용에 추가되는 부동 소수점 값입니다. 이는 연결 설정, 원격 측 쿼리 구문 분석 및 계획 등의 추가 오버헤드를 나타냅니다. 기본값은 다음과 같습니다.100.
fdw_tuple_cost외부 토토 결과에 대해 지정할 수 있는 이 옵션은 해당 토토 결과에서 외부 테이블 스캔을 위한 튜플당 추가 비용으로 사용되는 부동 소수점 값입니다. 이는 토토 결과 간 데이터 전송에 따른 추가 오버헤드를 나타냅니다. 원격 토토 결과에 대한 더 높거나 낮은 네트워크 지연을 반영하기 위해 이 숫자를 늘리거나 줄일 수 있습니다. 기본값은0.01.
언제use_remote_estimate사실입니다,postgres_fdw원격 서버에서 행 수와 비용 견적을 얻은 다음 추가합니다fdw_startup_cost그리고fdw_tuple_cost비용 견적에. 언제use_remote_estimate거짓입니다,postgres_fdw로컬 행 개수 및 비용 추정을 수행한 다음 추가합니다fdw_startup_cost그리고fdw_tuple_cost비용 견적에. 원격 테이블 통계의 로컬 복사본을 사용할 수 없으면 이 로컬 추정은 매우 정확하지 않을 수 있습니다. 실행 중분석외부 테이블에서는 로컬 통계를 업데이트하는 방법입니다. 그러면 원격 테이블을 스캔한 다음 테이블이 로컬인 것처럼 통계를 계산하고 저장합니다. 로컬 통계를 유지하는 것은 원격 테이블에 대한 쿼리별 계획 오버헤드를 줄이는 데 유용한 방법이 될 수 있습니다. 그러나 원격 테이블이 자주 업데이트되면 로컬 통계는 곧 쓸모 없게 됩니다.
기본적으로만어디에서23390_23746어디에서원격 실행을 위한 절. 이 동작은 다음 옵션을 사용하여 제어할 수 있습니다.
확장이 옵션은 쉼표로 구분된 이름 목록입니다.포스트그레SQL호환되는 버전으로 로컬 및 원격 서버 모두에 설치된 확장 프로그램입니다. 변경할 수 없고 나열된 확장에 속하는 함수 및 연산자는 원격 서버에 제공 가능한 것으로 간주됩니다. 이 옵션은 테이블 단위가 아닌 외부 서버에만 지정할 수 있습니다.
다음을 사용할 때확장옵션,이것은 사용자의 책임입니다나열된 확장 프로그램이 존재하고 로컬 및 원격 서버 모두에서 동일하게 작동하는지 확인하십시오. 그렇지 않으면 원격 쿼리가 실패하거나 예기치 않게 동작할 수 있습니다.
fetch_size이 옵션은 행 수를 지정합니다postgres_fdw각 가져오기 작업에 참여해야 합니다. 외부 테이블이나 외부 토토 결과에 대해 지정할 수 있습니다. 테이블에 지정된 옵션은 토토 결과에 지정된 옵션보다 우선합니다. 기본값은100.
배치_크기이 옵션은 행 수를 지정합니다.postgres_fdw각 삽입 작업에 삽입해야 합니다. 외부 테이블이나 외부 서버에 대해 지정할 수 있습니다. 테이블에 지정된 옵션은 서버에 지정된 옵션보다 우선합니다. 기본값은1.
실제 행 수 참고postgres_fdw한 번에 삽입하는 것은 열 수와 제공된 항목에 따라 다릅니다.배치_크기값. 배치는 단일 쿼리로 실행되며 libpq 프로토콜(이것은postgres_fdw원격 토토 결과에 연결하는 데 사용)은 단일 쿼리의 매개변수 수를 65535로 제한합니다. 열 수가 *배치_크기한도를 초과했습니다.배치_크기오류를 방지하기 위해 조정됩니다.
postgres_fdw의 여러 부분을 실행하는 비동기 실행을 지원합니다.추가성능 향상을 위해 직렬이 아닌 동시에 노드를 실행합니다. 이 실행은 다음 옵션을 사용하여 제어할 수 있습니다.
async_capable이 옵션은 다음을 제어합니다.postgres_fdw비동기 실행을 위해 외부 테이블을 동시에 스캔할 수 있습니다. 외부 테이블이나 외부 토토 결과에 대해 지정할 수 있습니다. 테이블 수준 옵션은 토토 결과 수준 옵션보다 우선합니다. 기본값은거짓.
외부 토토 결과에서 반환되는 데이터의 일관성을 보장하기 위해,postgres_fdw해당 외부 서버에 대해 하나의 연결만 열고 해당 테이블에 다른 사용자 매핑이 적용되지 않는 한 여러 외부 테이블이 관련되어 있더라도 해당 서버에 대해 모든 쿼리를 순차적으로 실행합니다. 이러한 경우 비동기식 쿼리 실행과 관련된 오버헤드를 제거하려면 이 옵션을 비활성화하는 것이 더 성능이 좋을 수 있습니다.
비동기 실행은 다음과 같은 경우에도 적용됩니다.추가노드에는 동기식으로 실행되는 하위 계획과 비동기식으로 실행되는 하위 계획이 포함되어 있습니다. 이러한 경우 비동기 하위 계획이 다음을 사용하여 처리된 것이라면postgres_fdw, 비동기 하위 계획의 튜플은 하나 이상의 동기 하위 계획이 모든 튜플을 반환할 때까지 반환되지 않습니다. 비동기 하위 계획이 외부 토토 결과로 전송된 비동기 쿼리 결과를 기다리는 동안 해당 하위 계획이 실행되기 때문입니다. 이 동작은 향후 릴리스에서 변경될 수 있습니다.
기본적으로 모든 외부 테이블은 다음을 사용합니다.postgres_fdw업데이트 가능한 것으로 가정됩니다. 이는 다음 옵션을 사용하여 재정의될 수 있습니다.
업데이트 가능이 옵션은 다음을 제어합니다.postgres_fdw다음을 사용하여 외부 테이블을 수정할 수 있습니다.삽입, 업데이트그리고삭제명령. 외부 테이블이나 외부 토토 결과에 대해 지정할 수 있습니다. 테이블 수준 옵션은 토토 결과 수준 옵션보다 우선합니다. 기본값은참.
물론, 원격 테이블이 실제로 업데이트 가능하지 않다면 어쨌든 오류가 발생합니다. 이 옵션을 사용하면 주로 원격 서버에 쿼리하지 않고 로컬로 오류가 발생하도록 할 수 있습니다. 그러나 참고하세요.information_schema조회수가 보고됩니다.postgres_fdw이 옵션의 설정에 따라 원격 서버를 확인하지 않고도 외부 테이블을 업데이트할 수 있습니다.
기본적으로 모든 외부 테이블은 다음을 사용합니다.postgres_fdw잘릴 수 있는 것으로 가정됩니다. 이는 다음 옵션을 사용하여 재정의될 수 있습니다.
잘림 가능이 옵션은 다음을 제어합니다.postgres_fdw다음을 사용하여 외부 테이블을 자를 수 있습니다.잘라내기명령. 외부 테이블이나 외부 토토 결과에 대해 지정할 수 있습니다. 테이블 수준 옵션은 토토 결과 수준 옵션보다 우선합니다. 기본값은참.
물론, 원격 테이블이 실제로 잘릴 수 없다면 어쨌든 오류가 발생합니다. 이 옵션을 사용하면 주로 원격 토토 결과에 쿼리하지 않고 로컬에서 오류가 발생하도록 할 수 있습니다.
postgres_fdw다음을 사용하여 외부 테이블 정의를 가져올 수 있습니다.외국 스키마 가져오기. 이 명령은 원격 서버에 있는 테이블이나 뷰와 일치하는 외부 테이블 정의를 로컬 서버에 생성합니다. 가져올 원격 테이블에 사용자 정의 데이터 유형의 열이 있는 경우 로컬 서버에는 동일한 이름의 호환 가능한 유형이 있어야 합니다.
가져오기 동작은 다음 옵션을 사용하여 사용자 정의할 수 있습니다(다음 옵션에 제공됨외국 스키마 가져오기명령):
import_collate이 옵션은 열 여부를 제어합니다.콜레이트옵션은 외부 토토 결과에서 가져온 외부 테이블의 정의에 포함됩니다. 기본값은참. 원격 토토 결과에 로컬 토토 결과와 다른 데이터 정렬 이름 집합이 있는 경우(다른 운영 체제에서 실행 중인 경우일 가능성이 높음) 이 기능을 꺼야 할 수도 있습니다. 그러나 그렇게 하면 가져온 테이블 열의 데이터 정렬이 기본 데이터와 일치하지 않아 비정상적인 쿼리 동작이 발생할 매우 심각한 위험이 있습니다.
이 매개변수가 다음으로 설정된 경우에도참, 데이터 정렬이 원격 서버의 기본값인 열을 가져오는 것은 위험할 수 있습니다. 다음으로 가져옵니다.콜레이트 "기본값", 이는 로컬 서버의 기본 데이터 정렬을 선택하며 다를 수 있습니다.
import_default이 옵션은 열 여부를 제어합니다.기본값표현식은 외부 서버에서 가져온 외부 테이블의 정의에 포함되어 있습니다. 기본값은거짓. 이 옵션을 활성화하는 경우 로컬 서버에서 원격 서버에서와 다르게 계산될 수 있는 기본값에 주의하세요.다음값()은 문제의 일반적인 원인입니다.가져오기가져온 기본 표현식이 로컬에 존재하지 않는 함수나 연산자를 사용하는 경우 완전히 실패합니다.
import_generated이 옵션은 열 여부를 제어합니다.생성됨표현식은 외부 서버에서 가져온 외부 테이블의 정의에 포함되어 있습니다. 기본값은참.가져오기가져온 생성 표현식이 로컬에 존재하지 않는 함수나 연산자를 사용하는 경우 완전히 실패합니다.
import_not_null이 옵션은 열 여부를 제어합니다.NULL이 아님제약조건은 외부 서버에서 가져온 외부 테이블의 정의에 포함되어 있습니다. 기본값은참.
다음 이외의 제약사항에 유의하세요.NULL이 아님원격 테이블에서는 절대 가져오지 않습니다. 그래도PostgreSQL외부 테이블에 대한 검사 제약 조건을 지원하지만 제약 조건 표현식이 로컬 및 원격 서버에서 다르게 평가될 수 있는 위험 때문에 자동으로 가져올 수 있는 규정은 없습니다. 검사 제약 조건 동작에 이러한 불일치가 있으면 쿼리 최적화에서 감지하기 어려운 오류가 발생할 수 있습니다. 따라서 검사 제약 조건을 가져오려면 수동으로 수행해야 하며 각 항목의 의미를 주의 깊게 확인해야 합니다. 외부 테이블의 검사 제약 조건 처리에 대한 자세한 내용은 다음을 참조하세요.외부 테이블 생성.
다른 테이블의 파티션인 테이블 또는 외부 테이블은 명시적으로 지정된 경우에만 가져옵니다.한도절. 그렇지 않으면 자동으로 제외됩니다.외국 스키마 가져오기. 파티셔닝 계층의 루트인 파티셔닝된 테이블을 통해 모든 데이터에 접근할 수 있으므로, 파티셔닝된 테이블만 임포트하면 별도의 객체 생성 없이 모든 데이터에 접근이 가능해야 합니다.
기본적으로 모든 연결은postgres_fdw외부 토토 결과에 대한 설정은 재사용을 위해 로컬 세션에서 열린 상태로 유지됩니다.
keep_connections이 옵션은 다음을 제어합니다.postgres_fdw다음 쿼리가 이를 재사용할 수 있도록 외부 서버에 대한 연결을 열어 둡니다. 외부 서버에만 지정할 수 있습니다. 기본값은켜짐. 으로 설정된 경우꺼짐, 이 외부 서버에 대한 모든 연결은 각 트랜잭션이 끝나면 삭제됩니다.
postgres_fdw_get_connections(OUT server_name 텍스트, OUT 유효한 부울)이 레코드 세트를 반환합니다.이 함수는 열려 있는 모든 연결의 외부 토토 결과 이름을 반환합니다.postgres_fdw로컬 세션에서 외부 토토 결과로 설정되었습니다. 또한 각 연결이 유효한지 여부도 반환합니다.거짓현재 로컬 트랜잭션에서 외부 서버 연결이 사용되지만 해당 외부 서버 또는 사용자 매핑이 변경되거나 삭제된 경우 반환됩니다. (유효하지 않은 연결의 서버 이름은 다음과 같습니다.NULL서버가 삭제된 경우) 그런 잘못된 연결은 해당 트랜잭션이 끝나면 닫힐 것입니다.참38393_38506
postgres=# SELECT * FROM postgres_fdw_get_connections() ORDER BY 1; 서버_이름 | 유효한 -----------+------- 루프백1 | 티 루프백2 | 에프
postgres_fdw_disconnect(server_name 텍스트)는 부울을 반환합니다.이 함수는 다음에 의해 설정된 열린 연결을 폐기합니다.postgres_fdw로컬 세션에서 주어진 이름을 가진 외부 서버로. 서로 다른 사용자 매핑을 사용하여 특정 서버에 여러 연결이 있을 수 있습니다. 현재 로컬 트랜잭션에서 연결이 사용되는 경우 연결이 끊어지지 않고 경고 메시지가 보고됩니다. 이 함수는 다음을 반환합니다.참적어도 하나의 연결이 끊어진 경우, 그렇지 않은 경우거짓. 해당 이름을 가진 외부 서버가 없으면 오류가 보고됩니다. 함수 사용 예:
postgres=# SELECT postgres_fdw_disconnect('loopback1');
postgres_fdw_disconnect
------------
티
postgres_fdw_disconnect_all()은 부울을 반환합니다.이 함수는 다음에 의해 설정된 모든 열린 연결을 삭제합니다.postgres_fdw로컬 세션에서 외부 서버로. 현재 로컬 트랜잭션에서 연결이 사용되는 경우 연결이 끊어지지 않고 경고 메시지가 보고됩니다. 이 함수는 다음을 반환합니다.참적어도 하나의 연결이 끊어진 경우, 그렇지 않은 경우거짓. 함수 사용 예:
postgres=# SELECT postgres_fdw_disconnect_all(); postgres_fdw_disconnect_all ---------------- 티
postgres_fdw외부 서버와 연결된 외부 테이블을 사용하는 첫 번째 쿼리 중에 외부 서버에 대한 연결을 설정합니다. 기본적으로 이 연결은 유지되며 동일한 세션의 후속 쿼리에 재사용됩니다. 이 동작은 다음을 사용하여 제어할 수 있습니다.keep_connections외부 서버용 옵션. 여러 사용자 ID(사용자 매핑)를 사용하여 외부 서버에 액세스하는 경우 각 사용자 매핑마다 연결이 설정됩니다.
외부 서버 또는 사용자 매핑의 정의를 변경하거나 제거하면 관련 연결이 닫힙니다. 그러나 현재 로컬 트랜잭션에서 연결이 사용 중인 경우 해당 연결은 트랜잭션이 끝날 때까지 유지됩니다. 외래 테이블을 사용하는 향후 쿼리에 필요할 때 닫힌 연결이 다시 설정됩니다.
외부 서버에 대한 연결이 설정되면 기본적으로 로컬 또는 해당 원격 세션이 종료될 때까지 유지됩니다. 명시적으로 연결을 끊으려면,keep_connections외부 서버에 대한 옵션이 비활성화되었을 수 있습니다. 또는postgres_fdw_disconnect그리고postgres_fdw_disconnect_all함수를 사용할 수 있습니다. 예를 들어, 이는 더 이상 필요하지 않은 연결을 종료하여 외부 토토 결과에서 연결을 해제하는 데 유용합니다.
외부 토토 결과의 원격 테이블을 참조하는 쿼리 중,postgres_fdw현재 로컬 트랜잭션에 해당하는 트랜잭션이 아직 열려 있지 않은 경우 원격 서버에서 트랜잭션을 엽니다. 로컬 트랜잭션이 커밋되거나 중단되면 원격 트랜잭션이 커밋되거나 중단됩니다. 저장점은 해당 원격 저장점을 생성하여 유사하게 관리됩니다.
원격 트랜잭션은 다음을 사용합니다.직렬화 가능로컬 트랜잭션의 격리 수준직렬화 가능격리 수준; 그렇지 않으면 다음을 사용합니다반복 가능한 읽기격리 수준. 이렇게 선택하면 쿼리가 원격 서버에서 여러 테이블 스캔을 수행하는 경우 모든 스캔에 대해 스냅샷과 일치하는 결과를 얻을 수 있습니다. 결과적으로 단일 트랜잭션 내의 연속적인 쿼리는 다른 활동으로 인해 원격 서버에서 동시 업데이트가 발생하더라도 원격 서버에서 동일한 데이터를 보게 됩니다. 로컬 트랜잭션이 다음을 사용하는 경우 해당 동작이 예상됩니다.직렬화 가능또는반복 가능한 읽기격리 수준이지만 a에게는 놀랄 수도 있습니다.읽어 커밋됨로컬 트랜잭션. 미래PostgreSQL릴리스에서는 이 규칙을 수정할 수 있습니다.
현재는 지원되지 않습니다.postgres_fdw2단계 커밋을 위한 원격 트랜잭션을 준비합니다.
postgres_fdw외부 토토 결과에서 전송되는 데이터의 양을 줄이기 위해 원격 쿼리를 최적화하려고 시도합니다. 이는 쿼리를 전송하여 수행됩니다.어디절을 원격 서버에 전달하여 실행하고 현재 쿼리에 필요하지 않은 테이블 열을 검색하지 않습니다. 쿼리가 잘못 실행될 위험을 줄이기 위해,어디절은 내장되거나 외부 서버에 나열된 확장에 속하는 데이터 유형, 연산자 및 함수만 사용하지 않는 한 원격 서버로 전송되지 않습니다.확장 프로그램옵션. 해당 절의 연산자와 함수는 다음과 같아야 합니다.불변또한. 에 대한업데이트또는삭제질의,postgres_fdw쿼리가 없는 경우 전체 쿼리를 원격 토토 결과로 전송하여 쿼리 실행을 최적화하려고 시도합니다.어디원격 토토 결과로 보낼 수 없는 절, 쿼리에 대한 로컬 조인 없음, 행 수준 로컬 없음이전또는이후대상 테이블에서 생성된 열을 트리거하거나 저장하며, 아니오옵션 확인상위 뷰의 제약. 에서업데이트, 대상 열에 할당할 표현식은 내장 데이터 유형만 사용해야 합니다.불변연산자 또는불변함수, 쿼리의 잘못된 실행 위험을 줄이기 위한 것입니다.
언제postgres_fdw동일한 외부 서버에 있는 외부 테이블 간의 조인이 발생하면, 어떤 이유로든 각 테이블에서 개별적으로 행을 가져오는 것이 더 효율적이라고 생각하거나 관련된 테이블 참조가 다른 사용자 매핑에 적용되지 않는 한 전체 조인을 외부 서버로 보냅니다. 보내는 동안가입절, 위에서 언급한 것과 동일한 예방 조치를 취합니다.어디절.
실행을 위해 실제로 원격 서버로 전송되는 쿼리는 다음을 사용하여 검사할 수 있습니다.자세한 설명.
다음에 의해 열린 원격 세션에서postgres_fdw, 그검색_경로매개변수가 그냥으로 설정됨pg_catalog, 스키마 한정 없이 내장 객체만 표시됩니다. 이는 다음으로 생성된 쿼리에는 문제가 되지 않습니다.postgres_fdw자체입니다. 항상 그러한 자격을 제공하기 때문입니다. 그러나 이는 원격 테이블의 트리거나 규칙을 통해 원격 토토 결과에서 실행되는 기능에 위험을 초래할 수 있습니다. 예를 들어, 원격 테이블이 실제로 뷰인 경우 해당 뷰에 사용된 모든 기능은 제한된 검색 경로로 실행됩니다. 해당 함수의 모든 이름을 스키마로 한정하거나 첨부하는 것이 좋습니다.검색_경로 설정옵션(참조함수 생성)를 이러한 기능에 추가하여 예상 검색 경로 환경을 설정합니다.
postgres_fdw마찬가지로 다양한 매개변수에 대한 원격 세션 설정을 설정합니다:
시간대다음으로 설정됨UTC
날짜 스타일다음으로 설정됨ISO
간격 스타일다음으로 설정됨포스트그레
extra_float_digits다음으로 설정됨3원격 서버 9.0 이상에 대해 다음으로 설정됨2이전 버전의 경우
이것들은 다음보다 문제가 될 가능성이 적습니다.검색_경로, 그러나 함수로 처리할 수 있음세트필요한 경우 옵션을 선택하세요.
그렇습니다아님이러한 매개변수의 세션 수준 설정을 변경하여 이 동작을 재정의하는 것이 좋습니다. 그로 인해 발생할 가능성이 높습니다.postgres_fdw오작동합니다.
postgres_fdw이전의 원격 서버와 함께 사용할 수 있습니다.PostgreSQL8.3. 읽기 전용 기능은 8.1부터 사용할 수 있습니다. 그러나 제한 사항은 다음과 같습니다.postgres_fdw일반적으로 불변 내장 함수와 연산자가 a에 나타나는 경우 실행을 위해 원격 서버로 보내도 안전하다고 가정합니다.어디외부 테이블에 대한 절. 따라서 원격 서버 릴리스 이후 추가된 내장 함수가 실행을 위해 원격 서버로 전송되어 다음과 같은 결과가 발생할 수 있습니다.“함수가 존재하지 않습니다”또는 유사한 오류. 이러한 유형의 실패는 쿼리를 다시 작성하여 해결할 수 있습니다. 예를 들어 하위 테이블 참조에 외부 테이블 참조를 삽입하면 됩니다.선택와오프셋 0최적화 울타리로 사용하고 문제가 있는 함수나 연산자를 하위 외부에 배치합니다.선택.
다음은 다음을 사용하여 외부 테이블을 생성하는 예입니다.postgres_fdw. 먼저 확장 프로그램을 설치하세요.
확장 프로그램 생성 postgres_fdw;
그런 다음 다음을 사용하여 외부 서버를 생성하십시오.토토 결과 생성. 이 예에서는 a에 연결하려고 합니다.포스트그레SQL호스트의 토토 결과192.83.123.89항구에서 수신 중5432. 연결이 이루어진 데이터베이스의 이름은 다음과 같습니다.외국인_db원격 토토 결과에서:
토토 결과 생성 foreign_server
외부 데이터 래퍼 postgres_fdw
OPTIONS(호스트 '192.83.123.89', 포트 '5432', dbname 'foreign_db');
다음으로 정의된 사용자 매핑사용자 매핑 생성, 원격 토토 결과에서 사용될 역할을 식별하는 데에도 필요합니다.
local_user에 대한 사용자 매핑 생성
서버 foreign_server
OPTIONS(사용자 'foreign_user', 비밀번호 'password');
이제 다음을 사용하여 외부 테이블을 생성할 수 있습니다.외부 테이블 생성. 이 예에서는라는 테이블에 액세스하려고 합니다.some_schema.some_table원격 서버에서. 해당 지역 이름은 다음과 같습니다.외국_테이블:
외부 테이블 생성 foreign_table (
ID 정수는 NULL이 아닙니다.
데이터 텍스트
)
서버 foreign_server
OPTIONS(스키마_이름 'some_schema', 테이블_이름 'some_table');
다음에 선언된 열의 데이터 유형 및 기타 속성이 중요합니다.외부 테이블 생성실제 원격 테이블과 일치합니다. 첨부하지 않는 한 열 이름도 일치해야 합니다.열_이름옵션을 개별 열에 추가하여 원격 테이블에서 이름이 어떻게 지정되는지 보여줍니다. 많은 경우에 다음을 사용합니다.외부 스키마 가져오기외부 테이블 정의를 수동으로 구성하는 것보다 바람직합니다.
하나다 시게루<shigeru.hanada@gmail.com
문서에 올바르지 않은 내용이 있으면 일치하지 않습니다. 특정 기능에 대한 경험이 있거나 추가 설명이 필요한 경우 이용해주세요이 양식문서 문제를 보고합니다.