thepostgres_fdw
모듈은 외국 데이터 래퍼를 제공합니다postgres_fdw
, 외부에 저장된 데이터에 액세스하는 데 사용할 수 있습니다PostgreSQL배트맨 토토.
이 모듈에서 제공하는 기능은 이전의 기능과 실질적으로 겹칩니다PostgreSQL : 문서 : 13 : F.10. 토토 사이트 추천모듈. 하지만postgres_fdw
원격 테이블에 액세스하기위한보다 투명하고 표준 준수 구문을 제공하며 많은 경우 더 나은 성능을 제공 할 수 있습니다.
사용을 사용하여 원격 액세스를 준비하려면postgres_fdw
:
설치postgres_fdw
확장 사용확장 생성.
사용을 사용하여 외국 배트맨 토토 개체 생성배트맨 토토 생성, 연결하려는 각 원격 데이터베이스를 나타냅니다. 을 제외하고 연결 정보 지정사용자
and비밀번호
, 배트맨 토토 객체의 옵션으로
사용 사용자 매핑 만들기사용자 매핑 만들기, 각 데이터베이스 사용자에 대해 각 외국 서버에 액세스 할 수 있습니다. as as 원격 사용자 이름과 비밀번호를 지정하십시오.사용자
and비밀번호
사용자 매핑 옵션.
사용 외국 테이블 만들기외국 테이블 만들기또는외국 스키마 가져 오기, 액세스하려는 각 원격 테이블에 대해. 외국 테이블의 열은 참조 된 원격 테이블과 일치해야합니다.
이제 필요select
기본 원격 테이블에 저장된 데이터에 액세스하기 위해 외래 테이블에서. 를 사용하여 원격 테이블을 수정할 수도 있습니다.삽입
, 업데이트
, 삭제
또는COPY
. (물론, 사용자 매핑에 지정된 원격 사용자는 이러한 작업을 수행 할 권한이 있어야합니다.)
참고postgres_fdw
현재 지원 부족삽입
충돌에서 업데이트
절. 그러나충돌에 대한 일이 없습니다
조항이 지원되며 고유 한 지수 추론 사양이 생략된다면. 또한postgres_fdw
지원 지원업데이트
분할 된 테이블에서 실행 된 진술이지만 현재 이동식 행을 삽입하기 위해 선택한 원격 파티션이 인 경우를 처리하지 않습니다.업데이트
나중에 업데이트 될 대상 파티션.
일반적으로 외국 테이블의 열은 원격 테이블의 참조 된 열과 정확히 동일한 데이터 유형으로 선언되고 해당되는 경우 콜라주를 표시하는 것이 좋습니다. 하지만postgres_fdw
현재 요구에 따라 데이터 유형 변환을 수행하는 것에 대해 다소 용서하고 있습니다. 원격 서버가 로컬 서버와 다르게 쿼리 조건을 해석하기 때문에 유형이나 콜로레이션이 일치하지 않을 때 놀라운 의미 론적 이상이 발생할 수 있습니다..
기본 원격 테이블이 가지고있는 것보다 열이 적거나 열 순서가 다른 외부 테이블을 선언 할 수 있습니다. 원격 테이블에 열을 일치시키는 것은 이름이 아닌 위치입니다.
postgres_fdw
외국 데이터 래퍼는와 동일한 옵션을 가질 수 있습니다.libpq연결 문자열에서 수락합니다.섹션 33.1.2,이 옵션이 허용되지 않거나 특별한 취급이 없다는 점을 제외하고 :
사용자
, 비밀번호
andsslpassword
(대신 사용자 매핑에 이들을 지정하거나 서비스 파일을 사용)
client_encoding
(로컬 배트맨 토토 인코딩에서 자동으로 설정 됨)
fallback_application_name
(항상 설정postgres_fdw
)
sslkey
andSSLCERT
- 이것은에 나타날 수 있습니다.둘 중 하나 또는 둘 다연결 및 사용자 매핑. 둘 다 존재하는 경우 사용자 매핑 설정이 연결 설정을 무시합니다.
슈퍼 사용자만이 사용자 매핑을 생성하거나 수정할 수 있습니다SSLCERT
또는sslkey
설정.
슈퍼 사용자 만 비밀번호 인증없이 외국 서버에 연결할 수 있으므로 항상를 지정하십시오.비밀번호
비 슈퍼 사용자에 속하는 사용자 매핑 옵션.
SuperUser는 사용자 매핑 옵션을 설정하여 사용자 당 맵핑 기준 으로이 검사를 무시할 수 있습니다password_required 'false'
, 예 :
some_non_superuser 서버 루프 백 _nopw에 대한 사용자 매핑 변경
비전지없는 사용자가 UNIX 사용자의 인증 권한을 악용하는 것을 방지하려면 Postgres 서버가 수퍼 유행기 권한으로 에스컬레이션하여 실행 중이며, 슈퍼 사용자만이 사용자 매핑 에서이 옵션을 설정할 수 있습니다..
이를 통해 매핑 된 사용자가 CVE-2007-3278 및 CVE-2007-6601 당 맵핑 된 데이터베이스에 슈퍼 사용자로 연결할 수있는 능력을 허용하지 않도록주의해야합니다. 설정하지 마십시오password_required = false
onpublic
역할. 매핑 된 사용자는 잠재적으로 클라이언트 인증서를 사용할 수 있습니다..pgpass
, .pg_service.conf
ETC 시스템 사용자의 UNIX 홈 디렉토리에서 Postgres 서버는 다음과 같이 실행됩니다. 또한 인증 모드와 같은 신뢰 관계를 사용할 수 있습니다.피어
또는ID
인증.
이 옵션은 원격으로 전송 된 SQL 문에 사용 된 이름을 제어하는 데 사용될 수 있습니다PostgreSQL배트맨 토토. 이 옵션은 기본 원격 테이블의 이름과 다른 이름으로 외국 테이블을 만들 때 필요합니다.
Schema_Name
외국 테이블에 지정할 수있는이 옵션은 원격 배트맨 토토의 외부 테이블에 사용할 스키마 이름을 제공합니다. 이 옵션이 생략되면 외국 테이블 스키마의 이름이 사용됩니다.
table_name
외국 테이블에 지정할 수있는이 옵션은 원격 배트맨 토토의 외부 테이블에 사용할 테이블 이름을 제공합니다. 이 옵션이 생략되면 외국 테이블 이름이 사용됩니다.
column_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
andfdw_tuple_cost
15509_15536use_remote_estimate
거짓,postgres_fdw
로컬 행 카운트 및 비용 추정을 수행 한 다음 추가FDW_STARTUP_COST
andfdw_tuple_cost
비용 추정치. 원격 테이블 통계의 로컬 사본을 사용할 수 없다면이 로컬 추정은 매우 정확하지 않을 것입니다.분석외국 테이블에서 로컬 통계를 업데이트하는 방법입니다. 이것은 원격 테이블의 스캔을 수행 한 다음 테이블이 로컬 인 것처럼 통계를 계산하고 저장합니다.
기본적으로 만여기서
내장 연산자 및 기능을 사용하는 클로스는 원격 배트맨 토토에서 실행을 위해 고려됩니다. 구축되지 않은 기능과 관련된 조항은 행을 가져온 후에 로컬로 점검됩니다.여기서
원격 실행을위한 조항. 이 동작은 다음 옵션을 사용하여 제어 할 수 있습니다.
확장
이 옵션은 쉼표로 구분 된 이름 목록입니다.PostgreSQL로컬 서버 및 원격 서버 모두에 호환 가능한 버전으로 설치되는 확장. 불변성이고 나열된 확장자에 속하는 기능 및 연산자는 원격 서버에 전환 할 수있는 것으로 간주됩니다.
사용시확장
옵션,사용자의 책임입니다나열된 확장자가 존재하며 로컬 서버와 원격 서버 모두에서 동일하게 행동합니다. 그렇지 않으면 원격 쿼리가 실패하거나 예기치 않게 행동 할 수 있습니다.
fetch_size
이 옵션은 행 수를 지정합니다postgres_fdw
각 페치 작업을 수행해야합니다. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다.100
.
기본적으로 모든 외국 테이블을 사용하여postgres_fdw
는 업데이트 가능한 것으로 가정합니다. 다음 옵션을 사용하여 재정의 할 수 있습니다.
업데이트 가능
이 옵션은를 제어합니다.postgres_fdw
|삽입
, 업데이트
and삭제
명령. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다.True
.
물론 원격 테이블이 실제로 업데이트되지 않으면 어쨌든 오류가 발생합니다. 이 옵션을 사용하면 주로 원격 서버를 쿼리하지 않고 오류를 로컬로 던질 수 있습니다.Information_Schema
보기가 a를보고합니다.postgres_fdw
원격 서버를 확인하지 않고이 옵션의 설정에 따라 외국 테이블을 업데이트 할 수 있습니다.
postgres_fdw
를 사용하여 외래 테이블 정의를 가져올 수 있습니다외국 스키마 가져 오기. 이 명령은 로컬 서버에서 원격 서버에있는 테이블 또는보기와 일치하는 외국 테이블 정의를 만듭니다.
동작 가져 오기 동작은 다음 옵션으로 사용자 정의 할 수 있습니다 (외국 스키마 가져 오기
명령) :
import_collate
이 옵션은 열 여부를 제어합니다Collate
옵션은 외국 배트맨 토토에서 가져온 외래 테이블의 정의에 포함됩니다. 기본값은True
. 원격 서버가 로컬 서버와 다른 Collation 이름 세트가 있으면이를 끄는 것이 필요할 수 있습니다. 이는 다른 운영 체제에서 실행중인 경우에 해당 될 수 있습니다.
이 매개 변수가 설정된 경우에도True
, Collation의 원격 서버의 기본값을 가져 오는 것은 위험 할 수 있습니다. 그들은로 수입됩니다."기본값"
, 로컬 배트맨 토토의 기본 콜 레이션을 선택할 수 있습니다.
import_default
이 옵션은 열 여부를 제어합니다기본값
표현식은 외국 서버에서 가져온 외국 테이블의 정의에 포함됩니다. 기본값은거짓
. 이 옵션을 활성화하는 경우 원격 서버에서 로컬 서버에서 다르게 계산 될 수있는 기본값에주의하십시오.nextVal ()
는 일반적인 문제의 원천입니다. 그만큼가져 오기
가져 오기 기본 표현식이 로컬로 존재하지 않는 함수 또는 연산자를 사용하는 경우 완전히 실패합니다.
import_generated
이 옵션은 열 여부를 제어합니다생성
표현식은 외국 서버에서 가져온 외국 테이블의 정의에 포함됩니다. 기본값은True
. 그만큼가져 오기
수입 된 생성 된 표현식이 로컬로 존재하지 않는 함수 또는 연산자를 사용하면 완전히 실패합니다.
import_not_null
이 옵션은 열 여부를 제어합니다NOT NULL
제약 조건은 외국 서버에서 가져온 외래 테이블의 정의에 포함됩니다. 기본값은True
.
이외의 제약 조건에 유의하십시오.NOT NULL
원격 테이블에서 가져 오지 않습니다. 하지만PostgreSQL지원check
외국 테이블에 대한 제약 조건은 제약 조건 표현이 로컬 배트맨 토토 및 원격 배트맨 토토에서 다르게 평가할 수 있기 때문에 자동으로 가져 오는 조항이 없습니다. a의 행동에 대한 그러한 불일치check
제약 조건은 쿼리 최적화에서 감지하기 어려운 오류로 이어질 수 있습니다. 수입하고 싶다면check
제약 조건, 수동으로 수행해야하며 각각의 의미를 신중하게 확인해야합니다. 치료에 대한 자세한 내용은check
외국 테이블의 제약 조건, 참조외국 테이블 만들기.
다른 테이블의 파티션 인 테이블 또는 외국 테이블은 자동으로 제외됩니다. 분할 된 테이블은 다른 테이블의 파티션이 아니라면 가져옵니다.
postgres_fdw
외국 배트맨 토토와 관련된 외국 테이블을 사용하는 첫 번째 쿼리 중에 외국 배트맨 토토에 대한 연결을 설정합니다. 이 연결은 동일한 세션에서 후속 쿼리에 대해 유지 및 재사용됩니다.
외국 배트맨 토토에서 원격 테이블을 참조하는 쿼리 중에postgres_fdw
현재 로컬 트랜잭션에 해당하는 것을 아직 열지 않은 경우 원격 서버에서 트랜잭션을 엽니 다. 로컬 거래가 저지르거나 중단 할 때 원격 거래는 커밋되거나 중단됩니다.
원격 트랜잭션이 사용SERIALIZABLE
지역 거래가있는 경우 격리 수준SERIALIZABLE
분리 레벨; 그렇지 않으면 사용반복 가능한 읽기
분리 레벨. 이 선택을 통해 쿼리가 원격 배트맨 토토에서 여러 테이블 스캔을 수행하면 모든 스캔에 대한 스냅 샷과 일치하는 결과가 나타납니다.SERIALIZABLE
또는반복 가능한 읽기
격리 수준이지만 A에 놀라운 일이 될 수 있습니다.저지른 읽기
로컬 거래. 미래PostgreSQL릴리스이 규칙을 수정할 수 있습니다.
현재는 지원되지 않습니다postgres_fdw
2 상 커밋을위한 원격 트랜잭션을 준비하려면
postgres_fdw
외국 배트맨 토토에서 전송 된 데이터 양을 줄이기 위해 원격 쿼리를 최적화하려고 시도합니다. 이것은 query를 보내어 수행됩니다여기서
실행을 위해 원격 서버로의 조항과 현재 쿼리에 필요하지 않은 테이블 열을 검색하지 않습니다. 쿼리의 미성 침체의 위험을 줄이기 위해여기서
클로스는 데이터 유형, 운영자 및 기능 만 사용하지 않는 한 원격 배트맨 토토로 전송되지 않습니다.확장
옵션. 그러한 조항의 운영자와 기능은불변
for업데이트
또는삭제
쿼리,postgres_fdw
쿼리가없는 경우 전체 쿼리를 원격 배트맨 토토로 전송하여 쿼리 실행을 최적화하려고 시도합니다여기서
원격 배트맨 토토로 보낼 수없는 조항, 쿼리에 대한 로컬 조인, 로컬 로컬전
또는이후
대상 테이블에 생성 된 열 트리거 또는 저장된 열을옵션 확인
부모보기의 제약. 안에업데이트
, 대상 열에 할당하는 표현식은 내장 데이터 유형 만 사용해야합니다.불변
운영자 또는불변
함수, 쿼리의 미성분의 위험을 줄입니다.
언제postgres_fdw
동일한 외국 서버의 외국 테이블간에 결합 된 경우, 어떤 이유로 든 각 테이블의 행을 개별적으로 가져 오는 것이 더 효율적이라고 생각하지 않는 한, 또는 관련된 테이블 참조가 다른 사용자 매핑에 적용되지 않는 한, 모든 원인을 외국 서버로 보냅니다. 보내는 동안Join
조항, 위에서 언급 한 것과 동일한 예방 조치를 취합니다.여기서
클로즈.
실행을 위해 실제로 원격 배트맨 토토로 전송 된 쿼리를 사용하여 검사 할 수 있습니다Verbose 설명
.
|postgres_fdw
, Thesearch_path매개 변수가 정당하게 설정되었습니다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 Create Postgres_fdw;
그런 다음를 사용하여 외국 서버를 만듭니다.배트맨 토토 생성. 이 예에서 우리는 A에 연결하고 싶습니다PostgreSQL호스트의 배트맨 토토192.83.123.89
포트 듣기5432
. 연결이 이루어진 데이터베이스 이름외국_DB
원격 배트맨 토토에서 :
Server forever_server 생성
사용자 맵핑,사용자 매핑 만들기, 원격 배트맨 토토에서 사용될 역할을 식별하기 위해 필요합니다 :
local_user에 대한 사용자 매핑 생성
이제로 외국 테이블을 만들 수 있습니다외국 테이블 만들기. 이 예에서는이라는 테이블에 액세스하고자합니다.some_schema.some_table
원격 배트맨 토토에서. 그것의 로컬 이름은입니다.외국 _table
:
외국 _table 생성 (
선언 된 열의 데이터 유형 및 기타 속성이외국 테이블 만들기
실제 원격 테이블과 일치합니다. 첨부하지 않는 한 열 이름도 일치해야합니다column_name
원격 테이블에서 이름이 어떻게 지명되었는지를 보여주기 위해 개별 열의 옵션. 많은 경우 사용외국 스키마 가져 오기수동으로 외국 테이블 정의를 구성하는 것이 바람직합니다.
Shigeru Hanada<shigeru.hanada@gmail.com
문서에 맞지 않는 내용이 있으면 일치하지 않습니다.이 양식문서 문제를보고하려면