thepostgres_fdw
모듈은 외국 데이터 래퍼를 제공합니다postgres_fdw
, 외부에 저장된 데이터에 액세스하는 데 사용할 수 있습니다PostgreSQL서버.
이 모듈에서 제공하는 기능은 이전의 기능과 실질적으로 겹칩니다범퍼카 토토 : 문서 : 17 : F.11. DBLINK - 다른 범퍼카 토토 데이터베이스에 연결모듈. 하지만postgres_fdw
원격 테이블에 액세스하기위한보다 투명하고 표준 준수 구문을 제공하고 많은 경우 더 나은 성능을 제공 할 수 있습니다.
사용을 사용하여 원격 액세스를 준비하려면postgres_fdw
:
설치postgres_fdw
확장 사용확장 생성.
사용을 사용하여 외국 서버 개체 생성서버 생성, 연결하려는 각 원격 데이터베이스를 나타냅니다. 을 제외하고 연결 정보 지정사용자
and비밀번호
, 서버 객체의 옵션으로
사용 사용자 매핑 생성사용자 매핑 만들기, 각 데이터베이스 사용자에 대해 각 외국 서버에 액세스 할 수 있습니다. as as 원격 사용자 이름과 비밀번호를 지정하십시오.사용자
and비밀번호
사용자 매핑 옵션.
사용 외국 테이블 만들기외국 테이블 만들기또는외국 스키마 가져 오기, 액세스하려는 각 원격 테이블에 대해. 외국 테이블의 열은 참조 된 원격 테이블과 일치해야합니다.
이제 당신은 필요합니다select
기본 원격 테이블에 저장된 데이터에 액세스하기 위해 외래 테이블에서 액세스 할 수 있습니다. 를 사용하여 원격 테이블을 수정할 수도 있습니다.삽입
, 업데이트
, 삭제
, copy
또는Truncate
. (물론, 사용자 매핑에 지정된 원격 사용자는 이러한 작업을 수행 할 권한이 있어야합니다.)
전용
옵션에 지정된select
, 업데이트
, 삭제
또는Truncate
원격 테이블에 액세스하거나 수정할 때 영향을 미치지 않습니다.
참고postgres_fdw
현재 지원 부족삽입
충돌시 업데이트
절. 그러나충돌에 대한 일이 없습니다
조항이 지원되며 고유 한 지수 추론 사양이 생략된다면. 또한postgres_fdw
지원 지원업데이트
분할 된 테이블에서 실행 된 진술이지만 현재 이동식 행을 삽입하기 위해 선택한 원격 파티션이입니다.업데이트
같은 명령에서 다른 곳에서 업데이트 될 대상 파티션.
일반적으로 외국 테이블의 열은 원격 테이블의 참조 된 열과 정확히 동일한 데이터 유형으로 선언하고 해당되는 경우 콜라주를 선언하는 것이 좋습니다. 하지만postgres_fdw
현재 요구에 따라 데이터 유형 변환 수행에 대해 다소 용서하고 있습니다. 원격 서버가 로컬 서버와 다르게 쿼리 조건을 해석하는 원격 서버를 해석하기 때문에 유형이나 콜라주가 일치하지 않을 때 놀라운 의미 론적 이상이 발생할 수 있습니다..
기본 원격 테이블이 가지고있는 것보다 열이 적거나 다른 열 순서로 외국 테이블을 선언 할 수 있습니다. 원격 테이블에 열을 일치시키는 것은 이름이 아닌 위치입니다.
postgres_fdw
외국 데이터 래퍼는와 동일한 옵션을 가질 수 있습니다.libpq연결 문자열에서 수락합니다.섹션 32.1.2,이 옵션이 허용되지 않거나 특별한 취급이 없다는 점을 제외하고 :
사용자
, 비밀번호
andsslpassword
(대신 사용자 맵핑에 이들을 지정하거나 서비스 파일을 사용)
client_encoding
(로컬 서버 인코딩에서 자동으로 설정 됨)
Application_Name
- 이것은에 나타날 수 있습니다.둘 중 하나 또는 둘 다연결 및postgres_fdw.application_name. 둘 다 존재한다면postgres_fdw.application_name
연결 설정을 무시합니다. 같지 않은libpq, postgres_fdw
허용Application_Name
포함 할“탈출 시퀀스”. 보다postgres_fdw.application_name자세한 내용.
fallback_application_name
(항상 설정postgres_fdw
)
sslkey
andSSLCERT
- 이것은에 나타날 수 있습니다.둘 중 하나 또는 둘 다연결 및 사용자 매핑. 둘 다 존재하는 경우 사용자 매핑 설정이 연결 설정을 무시합니다.
슈퍼 사용자만이 사용자 매핑을 생성하거나 수정할 수 있습니다SSLCERT
또는sslkey
설정.
비 슈퍼 사용자는 비밀번호 인증 또는 GSSAPI 위임 자격 증명을 사용하여 외래 서버에 연결할 수 있으므로를 지정하십시오.비밀번호
비밀번호 인증이 필요한 비 슈퍼 사용자에 속하는 사용자 매핑 옵션.
SuperUser는 사용자 매핑 옵션을 설정하여 사용자 당 맵핑 기준 으로이 검사를 무시할 수 있습니다password_required 'false'
, 예 :
some_non_superuser 서버 루프 백 _nopw에 대한 사용자 매핑 변경
비전지없는 사용자가 UNIX 사용자의 인증 권한을 악용하는 것을 방지하려면 Postgres 서버가 슈퍼 사용자 권한으로 에스컬레이션 할 때 실행중인 UNIX 사용자의 인증 권한을 활용하지 못하면 SuperUser만이 옵션을 사용자 매핑에서 설정할 수 있습니다..
이를 통해 매핑 된 사용자가 CVE-2007-3278 및 CVE-2007-6601에 따라 매핑 된 데이터베이스에 슈퍼 사용자로 연결할 수있는 능력을 허용하지 않도록주의해야합니다. 설정하지 마십시오password_required = false
onpublic
역할. 매핑 된 사용자는 잠재적으로 클라이언트 인증서를 사용할 수 있습니다..pgpass
, .pg_service.conf
등. 시스템 사용자의 UNIX 홈 디렉토리에서 Postgres 서버는 다음과 같이 실행됩니다.피어
또는ID
인증.
이 옵션은 원격으로 전송 된 SQL 문에 사용 된 이름을 제어하는 데 사용될 수 있습니다PostgreSQL서버. 이 옵션은 기본 원격 테이블의 이름과 다른 이름으로 외국 테이블을 만들 때 필요합니다.
Schema_Name
(String
)외국 테이블에 지정할 수있는이 옵션은 원격 서버의 외부 테이블에 사용할 스키마 이름을 제공합니다. 이 옵션이 생략되면 외국 테이블 스키마의 이름이 사용됩니다.
table_name
(String
)외국 테이블에 지정할 수있는이 옵션은 원격 서버의 외부 테이블에 사용할 테이블 이름을 제공합니다. 이 옵션이 생략되면 외국 테이블 이름이 사용됩니다.
column_name
(String
)이 옵션은 외국 테이블 열에 지정할 수있는이 옵션은 원격 서버의 열에 사용할 열 이름을 제공합니다. 이 옵션이 생략되면 열 이름이 사용됩니다.
postgres_fdw
원격 서버에 대한 쿼리를 실행하여 원격 데이터를 검색하므로 외국 테이블을 스캔하는 데 드는 예상 비용은 원격 서버에서 수행하는 데 드는 비용과 통신을위한 오버 헤드 여야합니다. 이러한 추정치를 얻는 가장 신뢰할 수있는 방법은 원격 서버를 요청한 다음 오버 헤드를 추가하는 것입니다. 그러나 간단한 쿼리의 경우 비용 추정치를 얻기 위해 추가 원격 쿼리 비용의 가치가 없습니다.postgres_fdw
비용 추정이 수행되는 방법을 제어하기위한 다음 옵션을 제공합니다.
use_remote_estimate
(부울
)이 옵션은 외국 테이블 또는 외국 서버에 지정할 수있는이 옵션이를 제어합니다.postgres_fdw
원격 문제설명
비용 추정치를 얻기위한 명령. 외국 테이블의 설정은 서버의 모든 설정을 대체하지만 해당 테이블에만 해당됩니다.거짓
.
FDW_STARTUP_COST
(플로팅 포인트
)외국 서버에 지정할 수있는이 옵션은 해당 서버의 모든 외국 테이블 스캔의 예상 시작 비용에 추가되는 부동 소수점 값입니다. 이는 원격 측면의 연결, 구문 분석 및 계획 등의 추가 오버 헤드를 나타냅니다. 기본값은입니다.100
.
fdw_tuple_cost
(플로팅 포인트
)외국 서버에 지정할 수있는이 옵션은 해당 서버의 외국 테이블 스캔에 대한 추가 비용으로 사용되는 부동 소수점 값입니다. 이는 서버 간의 데이터 전송의 추가 오버 헤드를 나타냅니다.0.2
.
언제use_remote_estimate
진실,postgres_fdw
원격 서버에서 행 카운트 및 비용 추정치를 얻은 다음 추가FDW_STARTUP_COST
andfdw_tuple_cost
비용 추정치. 언제use_remote_estimate
거짓,postgres_fdw
로컬 행 카운트 및 비용 추정을 수행 한 다음 추가FDW_STARTUP_COST
andfdw_tuple_cost
비용 추정치. 원격 테이블 통계의 로컬 사본을 사용할 수 없다면이 로컬 추정은 매우 정확하지 않을 것입니다.분석외국 표에서 로컬 통계를 업데이트하는 방법입니다. 이것은 원격 테이블의 스캔을 수행 한 다음 테이블이 로컬 인 것처럼 통계를 계산하고 저장합니다.
다음 옵션은 그러한 방법을 제어합니다분석
작동 동작 :
Analyze_Sampling
(String
)이 옵션은 외국 테이블 또는 외국 서버에 지정할 수있는이 옵션을 결정합니다.분석
외국 테이블에서 원격 측면의 데이터를 샘플링하거나 모든 데이터를 읽고 전송하고 로컬로 샘플링을 수행합니다. 지원되는 값은입니다.OFF
, random
, System
, Bernoulli
andauto
. OFF
원격 샘플링을 비활성화하므로 모든 데이터가 로컬로 전송되고 샘플링됩니다.random
를 사용하여 원격 샘플링을 수행합니다random ()
반환 된 행을 선택할 수있는 함수System
andBernoulli
내장에 의존테이블 샘플
그 이름의 방법.random
모든 원격 서버 버전에서 작동하는 동안테이블 샘플
9.5 년 이후에만 지원됩니다.auto
(기본값) 권장 샘플링 방법을 자동으로 선택합니다. 현재는 하나를 의미합니다Bernoulli
또는random
원격 서버 버전에 따라
기본적으로여기서
내장 연산자 및 기능을 사용하는 조항은 원격 서버에서 실행을 위해 고려됩니다. 구축되지 않은 기능과 관련된 조항은 행을 가져온 후에 로컬로 점검됩니다.여기서
원격 실행을위한 조항. 이 동작은 다음 옵션을 사용하여 제어 할 수 있습니다.
확장
(String
)이 옵션은 쉼표로 구분 된 이름 목록입니다PostgreSQL로컬 서버 및 원격 서버 모두에 호환 가능한 버전으로 설치되는 확장. 불변성이고 나열된 확장자에 속하는 기능 및 연산자는 원격 서버에 전환 할 수있는 것으로 간주됩니다.
사용시확장
옵션,사용자의 책임입니다나열된 확장자가 존재하며 로컬 서버와 원격 서버 모두에서 동일하게 작동합니다. 그렇지 않으면 원격 쿼리가 실패하거나 예기치 않게 행동 할 수 있습니다.
fetch_size
(정수
)이 옵션은 행 수를 지정합니다postgres_fdw
각 페치 작업에 들어가야합니다. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다.100
.
batch_size
(정수
)이 옵션은 행 수를 지정합니다postgres_fdw
각 삽입 작업에 삽입해야합니다. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다.1
.
실제 행 수를 참고하십시오postgres_fdw
한 번에 인서트를 한 번에 삽입하는 열 수와 제공된batch_size
값. 배치는 단일 쿼리로 실행되며 LIBPQ 프로토콜 (postgres_fdw
원격 서버에 연결하기 위해 사용) 단일 쿼리의 매개 변수 수를 65535로 제한합니다. 열 횟수 *.batch_size
한도를 초과합니다.batch_size
오류를 피하기 위해 조정됩니다.
이 옵션은 외래 테이블에 복사 할 때도 적용됩니다. 이 경우 실제 행 수postgres_fdw
한 번에 사본은 삽입 케이스와 유사한 방식으로 결정되지만의 구현 제한으로 인해 최대 1000으로 제한됩니다.copy
명령.
postgres_fdw
AN의 여러 부분을 실행하는 비동기 실행을 지원합니다.부록
노드 성능을 향상시키기보다는 동시에 노드. 이 실행은 다음 옵션을 사용하여 제어 할 수 있습니다.
async_capable
(부울
)이 옵션은를 제어합니다.postgres_fdw
비동기 실행을 위해 외래 테이블을 동시에 스캔 할 수 있습니다. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다.거짓
.
외국 서버에서 반환되는 데이터가 일관성이 있는지 확인하기 위해postgres_fdw
주어진 외국 서버에 대해 하나의 연결 만 열고 해당 테이블이 다른 사용자 매핑을받지 않는 한 여러 개의 이물질 테이블이 관련되어 있더라도 해당 서버에 대해 모든 쿼리를 순차적으로 실행합니다. 이 경우 쿼리 실행과 관련된 오버 헤드를 비동기로 제거하기 위해이 옵션을 비활성화하는 것이 더 성능이있을 수 있습니다..
AN에도 비동기 실행이 적용됩니다.부록
노드에는 비동기 적으로 실행 된 서브 플랜뿐만 아니라 동기식으로 실행 된 하위 비행이 포함됩니다. 그러한 경우, 비동기 서브 플랜트가 사용하여 처리 된 경우postgres_fdw
, 비동기 서브 플랜의 튜플은 적어도 하나의 동기 부 서브 플랜이 모든 튜플을 반환 한 후에도 해당 하위 플랜이 실행되므로 외국 서버로 전송되는 비동기 쿼리의 결과를 기다리고 있기 때문에 모든 튜플이 모든 튜플을 반환 할 때까지 반환되지 않습니다. 이 행동은 향후 릴리스에서 변할 수 있습니다.
거래 관리 섹션에 설명 된대로postgres_fdw
트랜잭션은 해당 원격 트랜잭션을 생성하여 관리되며 해당 원격 서브 트랜잭션을 작성하여 하위 트랜잭션을 관리합니다. 여러 원격 트랜잭션이 현재 로컬 트랜잭션에 관여하는 경우 기본적으로postgres_fdw
로컬 거래가 커밋되거나 중단 될 때 원격 트랜잭션을 연속적으로 저지르거나 중단시킵니다. 여러 원격 서브 트랜잭션이 현재 로컬 서브 트랜잭션에 관여하는 경우, 기본적으로postgres_fdw
로컬 서브 트랜잭션이 커밋되거나 중단 될 때 원격 차축 작용을 연속적으로 커밋하거나 중단시킵니다. 다음 옵션으로 성능을 향상시킬 수 있습니다.
Parallel_Commit
(부울
)이 옵션은를 제어합니다.postgres_fdw
지역 거래가 커밋 될 때 로컬 거래에서 외국 서버에서 원격 트랜잭션이 열렸습니다. 이 설정은 원격 및 로컬 서브 트랜잭션에도 적용됩니다.거짓
.
parallel_abort
(부울
)이 옵션은를 제어합니다.postgres_fdw
지역 거래가 중단 될 때 지역 거래에서 외국 서버에서 원격 트랜잭션이 열렸습니다. 이 설정은 원격 및 로컬 서브 트랜잭션에도 적용됩니다.거짓
.
이러한 옵션을 사용하는 여러 외국 서버가 지역 거래에 관여하는 경우 해당 외국 서버의 여러 원격 트랜잭션이 해당 외국 서버에서 지역 거래가 커밋되거나 중단 될 때 외국 서버에 대해 병렬로 중단됩니다..
이러한 옵션이 활성화되면 많은 원격 트랜잭션이있는 외국 서버가 로컬 트랜잭션이 커밋되거나 중단 될 때 부정적인 성능 영향을 볼 수 있습니다.
기본적으로 모든 외국 테이블을 사용하는postgres_fdw
업데이트 가능한 것으로 가정합니다. 다음 옵션을 사용하여 재정의 할 수 있습니다.
업데이트 가능
(부울
)이 옵션은를 제어합니다.postgres_fdw
|삽입
, 업데이트
and삭제
명령. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다.true
.
물론 원격 테이블이 실제로 업데이트되지 않으면 어쨌든 오류가 발생합니다. 이 옵션을 사용하면 주로 원격 서버를 쿼리하지 않고 오류를 로컬로 던질 수 있습니다.Information_Schema
보기가 a를보고합니다.postgres_fdw
원격 서버를 점검하지 않고이 옵션의 설정에 따라 외국 테이블을 업데이트 할 수 있습니다.
기본적으로 모든 외국 테이블을 사용하는postgres_fdw
는 잘린 것으로 가정합니다. 다음 옵션을 사용하여 재정의 할 수 있습니다.
Truncatable
(부울
)이 옵션은를 제어합니다.postgres_fdw
|Truncate
명령. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다.true
.
물론 원격 테이블이 실제로 잘라지지 않으면 오류가 발생합니다. 이 옵션을 사용하면 주로 원격 서버를 쿼리하지 않고 오류를 로컬로 던질 수 있습니다.
postgres_fdw
를 사용하여 외래 테이블 정의를 가져올 수 있습니다외국 스키마 가져 오기. 이 명령은 로컬 서버에서 원격 서버에있는 테이블 또는보기와 일치하는 외국 테이블 정의를 만듭니다.
동작 가져 오기 동작은 다음 옵션으로 사용자 정의 할 수 있습니다 (외국 스키마 가져 오기
명령) :
import_collate
(부울
)이 옵션은 열 여부를 제어합니다Collate
옵션은 외국 서버에서 가져온 외국 테이블의 정의에 포함됩니다. 기본값은true
. 원격 서버가 로컬 서버와 다른 Collation 이름 세트가 있으면이를 끄는 것이 필요할 수 있습니다. 이는 다른 운영 체제에서 실행중인 경우에 해당 될 수 있습니다.
이 매개 변수가 설정된 경우에도true
, Collation의 원격 서버의 기본값을 가져 오는 것은 위험 할 수 있습니다. 그들은로 수입됩니다."기본값"
, 로컬 서버의 기본 콜 레이션을 선택할 수 있습니다.
import_default
(부울
)이 옵션은 열 여부를 제어합니다기본값
표현식은 외국 서버에서 가져온 외국 테이블의 정의에 포함됩니다. 기본값은거짓
. 이 옵션을 활성화하는 경우 원격 서버에서 로컬 서버에서 다르게 계산 될 수있는 기본값에주의하십시오.nextVal ()
는 일반적인 문제의 원천입니다. 그만큼가져 오기
가져 오기 기본 표현식이 로컬로 존재하지 않는 함수 또는 연산자를 사용하는 경우 완전히 실패합니다.
import_generated
(부울
)이 옵션은 열 여부를 제어합니다생성
표현식은 외국 서버에서 가져온 외국 테이블의 정의에 포함됩니다. 기본값은true
. 그만큼가져 오기
수입 된 생성 된 표현식이 로컬로 존재하지 않는 함수 또는 연산자를 사용하면 완전히 실패합니다.
import_not_null
(부울
)이 옵션은 열 여부를 제어합니다NOT NULL
제약 조건은 외국 서버에서 가져온 외래 테이블의 정의에 포함됩니다. 기본값은true
.
이외의 제약 조건에 유의하십시오NOT NULL
원격 테이블에서 가져 오지 않습니다. 하지만PostgreSQL외국 테이블의 확인 제약 조건을 지원합니다. 제약 조건 표현식이 로컬 서버 및 원격 서버에서 다르게 평가할 수 있기 때문에 자동으로 가져 오는 조항이 없습니다. 체크 제약 조건의 동작에서 그러한 불일치는 쿼리 최적화에서 검출하기 어려운 오류로 이어질 수 있습니다.외국 테이블 만들기.
다른 테이블의 파티션 인 테이블 또는 외국 테이블은 명시 적으로 지정된 경우에만 가져옵니다제한
절. 그렇지 않으면 그들은 자동으로 |외국 스키마 가져 오기. 분할 계층 구조의 루트 인 파티션 된 테이블을 통해 모든 데이터에 액세스 할 수 있으므로 파티션 된 테이블 만 가져 오면 추가 객체를 생성하지 않고 모든 데이터에 액세스 할 수 있어야합니다..
기본적으로 모든 연결postgres_fdw
재사용을 위해 로컬 세션에서 외국 서버 설정을 열어 두십시오.
Keep_Connections
(부울
)이 옵션은를 제어합니다.postgres_fdw
후속 쿼리가 재사용 할 수 있도록 외국 서버에 연결을 열어 두십시오. 외국 서버에 대해서만 지정할 수 있습니다.on
. 로 설정된 경우OFF
,이 외국 서버에 대한 모든 연결은 각 트랜잭션의 끝에서 폐기됩니다.
postgres_fdw_get_connections (out server_name 텍스트, 유효한 부울) setof record를 반환합니다
이 함수는 모든 열린 연결의 외부 서버 이름을 반환합니다.postgres_fdw
로컬 세션에서 외국 서버로 설정되었습니다. 또한 각 연결이 유효한지 여부를 반환합니다.거짓
외국 서버 연결이 현재 로컬 트랜잭션에서 사용되지만 해당 외국 서버 또는 사용자 매핑이 변경되거나 삭제 된 경우 리턴됩니다 (유효하지 않은 연결의 서버 이름이입니다.NULL
서버가 삭제 된 경우), 해당 트랜잭션이 끝날 때 그러한 유효하지 않은 연결이 닫힙니다.true
그렇지 않으면 반환됩니다. 열린 연결이 없으면 레코드가 반환되지 않습니다.
postgres =# select * from postgres_fdw_get_connections () 주문 x 1;
postgres_fdw_disconnect (server_name text) 반환 부울
이 함수는에 의해 설정된 열린 연결을 폐기합니다postgres_fdw
로컬 세션에서 주어진 이름을 가진 외국 서버로. 다른 사용자 매핑을 사용하여 주어진 서버에 여러 개의 연결이있을 수 있습니다.true
적어도 하나의 연결을 연결하면거짓
. 주어진 이름이있는 외국 서버가없는 경우 오류 가보고됩니다.
postgres =# postgres_fdw_disconnect ( 'loopback1');
Postgres_FDW_DISCONNECT_ALL () 반환 부울
이 함수는에 의해 설정된 모든 열린 연결을 폐기합니다postgres_fdw
로컬 세션에서 외국 서버로. 연결이 현재 로컬 트랜잭션에서 사용되는 경우 연결이 끊어지지 않으며 경고 메시지 가보고됩니다.true
적어도 하나의 연결을 연결하면거짓
. 기능의 예제 :
postgres =# postgres_fdw_disconnect_all ();
postgres_fdw
외국 서버와 관련된 외국 테이블을 사용하는 첫 번째 쿼리 중에 외국 서버에 대한 연결을 설정합니다. 기본적 으로이 연결은 동일한 세션에서 후속 쿼리에 대해 유지 및 재사용됩니다.Keep_Connections
외국 서버의 옵션. 여러 사용자 ID (사용자 매핑)가 외국 서버에 액세스하는 데 사용되는 경우 각 사용자 매핑마다 연결됩니다.
외국 서버 또는 사용자 매핑의 정의 또는 제거를 변경할 때 관련 연결이 닫힙니다. 그러나 현재 지역 거래에서 연결이 사용되는 경우 거래가 끝날 때까지 유지됩니다.
일단 외국 서버에 연결되면 로컬 또는 해당 원격 세션이 종료 될 때까지 기본적으로 유지됩니다. 연결을 분리하려면 명시 적으로Keep_Connections
외국 서버의 옵션이 비활성화 될 수 있습니다.postgres_fdw_disconnect
andpostgres_fdw_disconnect_all
함수를 사용할 수 있습니다. 예를 들어, 이들은 더 이상 필요하지 않은 연결을 닫는 데 유용하여 외국 서버에서 연결을 공개합니다.
외국 서버에서 원격 테이블을 참조하는 쿼리 중에postgres_fdw
현재 로컬 트랜잭션에 해당하는 아직 열지 않은 경우 원격 서버에서 트랜잭션을 엽니 다. 로컬 거래가 저지르거나 중단 할 때 원격 거래는 커밋되거나 중단됩니다.
원격 트랜잭션이 사용SERIALIZALE
지역 거래가있는 경우 격리 수준SERIALIZALE
분리 레벨; 그렇지 않으면 사용반복 가능한 읽기
분리 레벨. 이 선택을 통해 쿼리가 원격 서버에서 여러 테이블 스캔을 수행하면 모든 스캔에 대한 스냅 샷과 일치하는 결과가 나타납니다.SERIALIZALE
또는반복 가능한 읽기
격리 레벨이지만 A에 놀라운 일이 될 수 있습니다.Commited 읽기
로컬 거래. 미래PostgreSQL릴리스이 규칙을 수정할 수 있습니다.
현재는 지원되지 않습니다postgres_fdw
2 상 커밋을 위해 원격 트랜잭션을 준비하려면
postgres_fdw
외국 서버에서 전송 된 데이터 양을 줄이기 위해 원격 쿼리를 최적화하려고 시도합니다. 이것은 query를 보내어 수행됩니다여기서
실행을 위해 원격 서버로의 조항과 현재 쿼리에 필요하지 않은 테이블 열을 검색하지 않습니다. 쿼리의 미성 침체의 위험을 줄이기 위해여기서
클로스는 데이터 유형, 연산자 및 기능 만 사용하지 않는 한 원격 서버로 전송되지 않습니다.확장
옵션. 그러한 조항의 운영자와 기능은불변
for업데이트
또는삭제
쿼리,postgres_fdw
쿼리가없는 경우 전체 쿼리를 원격 서버로 전송하여 쿼리 실행을 최적화하려고 시도합니다여기서
원격 서버로 보낼 수없는 조항, 쿼리에 대한 로컬 조인, 로컬 로컬전
또는이후
대상 테이블에서 생성 된 열 트리거 또는 저장된 열을옵션 확인
부모보기의 제약. 안에업데이트
36579_36655불변
운영자 또는불변
함수, 쿼리의 미성 침체 위험을 줄입니다.
언제postgres_fdw
동일한 외국 서버의 외국 테이블 사이의 결합을 만나면, 어떤 이유로 든 각 테이블에서 행을 개별적으로 가져 오는 것이 더 효율적이라고 생각하지 않거나 관련된 테이블 참조가 다른 사용자 맵핑에 적용되지 않는 한, 전체 조인을 외국 서버로 보냅니다. 보내는 동안Join
조항, 위에서 언급 한 것과 동일한 예방 조치를 취합니다.여기서
클로즈.
실행을 위해 실제로 원격 서버로 전송 된 쿼리는를 사용하여 검사 할 수 있습니다.Verbose 설명
.
원격 세션에서postgres_fdw
, Thesearch_path매개 변수가 Just로 설정되었습니다PG_CATALOG
, 스키마 자격없이 내장 객체 만 볼 수 있도록합니다. 이것은에 의해 생성 된 쿼리에 대한 문제가 아닙니다.postgres_fdw
자체는 항상 그러한 자격을 공급하기 때문입니다. 그러나 이는 원격 테이블의 트리거 또는 규칙을 통해 원격 서버에서 실행되는 기능에 위험을 초래할 수 있습니다.SET SEARCH_PATH
옵션 (참조함수 만들기) 그러한 함수에 대한 예상 검색 경로 환경을 설정하기 위해.
postgres_fdw
마찬가지로 다양한 매개 변수에 대한 원격 세션 설정을 설정합니다.
TimeZone로 설정되었습니다UTC
Datestyle로 설정되었습니다ISO
IntervalStyle로 설정되었습니다Postgres
extra_float_digits로 설정되었습니다3
원격 서버 9.0 및 최신의 경우2
이전 버전의 경우
이것들은 문제가 적을 가능성이 적습니다search_path
하지만 기능으로 처리 할 수 있습니다SET
필요가 발생하는 경우 옵션.
그것은아님이 매개 변수의 세션 수준 설정을 변경 하여이 동작을 무시할 것을 권장합니다. 그것은 원인 일 가능성이 높습니다postgres_fdw
오작동에.
postgres_fdw
로 돌아가는 원격 서버와 함께 사용할 수 있습니다PostgreSQL8.3. 읽기 전용 기능은 8.1로 다시 사용할 수 있습니다.postgres_fdw
일반적으로 불변의 내장 기능과 운영자가 실행을 위해 원격 서버로 보내기에 안전하다고 가정합니다.여기서
외국 표에 대한 조항. 따라서 원격 서버의 릴리스 이후에 추가 된 내장 기능이 실행을 위해 전송 될 수있어“함수가 존재하지 않습니다”또는 유사한 오류. 이 유형의 실패는 쿼리를 다시 작성하여 해결할 수 있습니다.select
with오프셋 0
최적화 울타리로서, 문제가있는 기능 또는 연산자를 하위 외부에 배치합니다select
.
postgres_fdw
대기 이벤트 유형에서 다음 대기 이벤트를보고 할 수 있습니다Extension
:
postgresfdwcleanupresult
원격 서버에서 트랜잭션 중단 대기 대기.
postgresfdwconnect
원격 서버에 연결하기를 기다리고 있습니다.
postgresfdwgetresult
원격 서버에서 쿼리 결과를 받기를 기다리고 있습니다.
postgres_fdw.application_name
(String
) #값을 지정Application_Nameconfiguration 매개 변수를 사용했을 때postgres_fdw
외국 서버에 대한 연결을 설정합니다. 이것은 무시합니다Application_Name
서버 객체의 옵션. 이 매개 변수의 변경 사항은 다시 설립 될 때까지 기존 연결에 영향을 미치지 않습니다.
postgres_fdw.application_name
길이의 모든 스트링 일 수 있으며 ASCII가 아닌 문자조차 포함합니다. 그러나 전달되고에 사용될 때Application_Name
외국 서버에서는 이하로 잘릴 것입니다.paminatalen
문자. 인쇄 가능한 ASCII 문자 이외의 다른 것은로 대체됩니다.C 스타일의 16 진수 탈출. 보다Application_Name자세한 내용.
%
문자 시작“탈출 시퀀스”는 아래에 요약 된 상태 정보로 대체됩니다. 인식되지 않은 탈출은 무시됩니다.%
옵션 전, 정렬 및 패딩에 대한 옵션.
탈출 | 효과 |
---|---|
%a |
로컬 서버의 응용 프로그램 이름 |
%C |
로컬 서버의 세션 ID (참조log_line_prefix자세한 내용) |
%C |
로컬 서버의 클러스터 이름 (참조cluster_name자세한 내용) |
%U |
로컬 서버의 사용자 이름 |
%d |
로컬 서버의 데이터베이스 이름 |
%p |
로컬 서버에서 백엔드의 프로세스 ID |
%% |
리터럴 % |
예를 들어, 사용자를 가정 해local_user
데이터베이스에서 연결을 설정local_db
toforex_db
사용자외국 _user
, 설정'db =%d, user =%u'
'db = local_db, user = local_user'
.
다음은로 외국 테이블을 만드는 예입니다.postgres_fdw
. 먼저 확장자 설치 :
Extension Create Postgres_fdw;
그런 다음를 사용하여 외국 서버를 만듭니다서버 생성. 이 예에서 우리는 A에 연결하고 싶습니다PostgreSQL호스트의 서버192.83.123.89
포트 듣기5432
. 연결이 이루어진 데이터베이스 이름forex_db
원격 서버에서 :
Server forever_server 생성
사용자 맵핑,사용자 매핑 만들기, 원격 서버에서 사용될 역할을 식별하기 위해 필요합니다 :
local_user에 대한 사용자 매핑 생성
이제로 외국 테이블을 만들 수 있습니다외국 테이블 만들기. 이 예에서는이라는 테이블에 액세스하고자합니다.some_schema.some_table
원격 서버에서. 그것의 로컬 이름은입니다.외국 _table
:
외국 _table 생성 (
에 선언 된 열의 데이터 유형 및 기타 속성이외국 테이블 만들기
실제 원격 테이블과 일치합니다. 첨부하지 않는 한 열 이름도 일치해야합니다column_name
원격 테이블에서 이름이 어떻게 지명되었는지를 보여주기 위해 개별 열의 옵션. 많은 경우 사용외국 스키마 가져 오기
수동으로 외국 테이블 정의를 구성하는 것이 바람직합니다.
Shigeru Hanada<shigeru.hanada@gmail.com
문서에 올바르지 않은 내용이 있으면 일치하지 않습니다.이 양식문서 문제를보고하려면