이 문서는 지원되지 않는 버전의 PostgreSQL을위한 것입니다.
당신은에 대해 같은 페이지를 볼 수 있습니다PostgreSQL : 문서 : 17 : F.36. Postgres_FDW - 외부 PostgreSQL 범퍼카 토토 저장된 액세스 데이터버전 또는 위에 나열된 다른 지원 버전 중 하나입니다.

F.34. postgres_fdw

thepostgres_fdw모듈은 외국 데이터 래퍼를 제공합니다postgres_fdw, 외부에 저장된 데이터에 액세스하는 데 사용할 수 있습니다PostgreSQL서버.

이 모듈에서 제공하는 기능은 이전의 기능과 실질적으로 겹칩니다토토 사이트 추천 : 문서 : 10 : F.11. DBLINK모듈. 하지만postgres_fdw원격 사설 토토 사이트에 액세스하기위한보다 투명하고 표준 준수 구문을 제공하고 많은 경우 더 나은 성능을 제공 할 수 있습니다.

사용을 사용하여 원격 액세스를 준비하려면postgres_fdw:

  1. 설치postgres_fdw확장 사용확장 생성.

  2. 사용를 사용하여 외국 서버 개체 생성서버 생성, 연결하려는 각 원격 데이터베이스를 나타냅니다. 을 제외하고 연결 정보 지정사용자and비밀번호, 서버 객체의 옵션으로

  3. 사용 사용자 매핑 생성PostgreSQL, 각 데이터베이스 사용자에 대해 각 외국 서버에 액세스 할 수 있습니다. as as 원격 사용자 이름과 비밀번호를 지정하십시오.사용자비밀번호사용자 매핑 옵션.

  4. 사용 외국 사설 토토 사이트 만들기PostgreSQL : 문서 :또는PostgreSQL :, 액세스하려는 각 원격 테이블에 대해. 외국 테이블의 열은 참조 된 원격 테이블과 일치해야합니다. 그러나 원격 테이블 객체의 옵션으로 올바른 원격 이름을 지정하면 원격 테이블과 다른 테이블 및/또는 열 이름을 사용할 수 있습니다..

이제 당신은 필요합니다select외래 사설 토토 사이트에서 기본 원격 사설 토토 사이트에 저장된 데이터에 액세스하기 위해. 를 사용하여 원격 사설 토토 사이트을 수정할 수도 있습니다.삽입, 업데이트또는삭제. (물론, 사용자 매핑에 지정된 원격 사용자는 이러한 작업을 수행 할 권한이 있어야합니다.)

참고Postgres_FDW현재 지원이 부족삽입충돌에 대한 업데이트절. 그러나충돌에 대한 일이 없습니다조항이 지원되며 고유 한 지수 추론 사양이 생략된다면

일반적으로 외국 사설 토토 사이트의 열은 원격 사설 토토 사이트의 참조 된 열과 정확히 동일한 데이터 유형으로 선언되며 해당되는 경우 적용 가능한 경우 Collations가 권장됩니다. 하지만postgres_fdw현재 필요에 따라 데이터 유형 변환을 수행하는 것에 대해 다소 용서하고 있습니다. 원격 서버가 로컬 서버와 다르게 쿼리 조건을 해석하기 때문에 유형이나 콜라주가 일치하지 않을 때 놀라운 의미 론적 이상이 발생할 수 있습니다..

기본 원격 사설 토토 사이트이 가지고있는 것보다 열이 적거나 다른 열 순서로 외국 사설 토토 사이트을 선언 할 수 있습니다. 원격 사설 토토 사이트에 열을 일치시키는 것은 이름이 아닌 위치입니다.

F.34.1. Postgres_FDW의 FDW 옵션

F.34.1.1. 연결 옵션

를 사용하는 외국 서버Postgres_FDW외국 데이터 래퍼는와 동일한 옵션을 가질 수 있습니다.libpq연결 문자열에서 수락합니다.섹션 33.1.2,이 옵션이 허용되지 않는 경우를 제외하고 :

  • 사용자and암호(대신 사용자 맵핑에서 이들을 지정)

  • client_encoding(로컬 서버 인코딩에서 자동으로 설정 됨)

  • fallback_application_name(항상 설정Postgres_FDW)

슈퍼 사용자 만 암호 인증없이 외국 서버에 연결할 수 있으므로 항상를 지정하십시오.암호비 슈퍼 사용자에 속하는 사용자 매핑 옵션.

F.34.1.2. 객체 이름 옵션

이 옵션은 원격으로 전송 된 SQL 문에 사용 된 이름을 제어하는 ​​데 사용될 수 있습니다postgresql서버. 이 옵션은 기본 원격 테이블의 이름과 다른 이름으로 외국 테이블을 만들 때 필요합니다.

Schema_Name

외국 사설 토토 사이트에 지정할 수있는이 옵션은 원격 서버의 외부 사설 토토 사이트에 사용할 스키마 이름을 제공합니다. 이 옵션이 생략되면 외국 사설 토토 사이트 스키마의 이름이 사용됩니다.

table_name

외국 사설 토토 사이트에 지정할 수있는이 옵션은 원격 서버의 외부 사설 토토 사이트에 사용할 사설 토토 사이트 이름을 제공합니다. 이 옵션이 생략되면 외국 사설 토토 사이트 이름이 사용됩니다.

column_name

이 옵션은 외국 사설 토토 사이트 열에 지정할 수있는이 옵션은 원격 서버의 열에 사용할 열 이름을 제공합니다. 이 옵션이 생략되면 열 이름이 사용됩니다.

F.34.1.3. 비용 추정 옵션

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_COSTandfdw_tuple_cost비용 추정치. 언제use_remote_estimate거짓,Postgres_FDW로컬 행 카운트 및 비용 추정을 수행 한 다음 추가FDW_STARTUP_COSTandfdw_tuple_cost비용 추정치. 원격 사설 토토 사이트 통계의 로컬 사본을 사용할 수 없다면이 로컬 추정은 매우 정확하지 않을 것입니다. 달리기분석외국 표에서 로컬 통계를 업데이트하는 방법입니다. 이것은 원격 테이블의 스캔을 수행 한 다음 테이블이 로컬 인 것처럼 통계를 계산하고 저장합니다. 로컬 통계를 유지하는 것이 원격 테이블에 대한 쿼리 계획 간의 오버 헤드를 줄이는 유용한 방법이 될 수 있습니다. 그러나 원격 테이블이 자주 업데이트되면 로컬 통계는 곧 쓸모 없게됩니다.

F.34.1.4. 원격 실행 옵션

기본적으로여기서내장 연산자 및 기능을 사용하는 클로스는 원격 서버에서 실행을 위해 고려됩니다. 구축되지 않은 기능과 관련된 조항은 행을 가져온 후에 로컬로 점검됩니다. 원격 서버에서 이러한 기능을 사용할 수 있고 로컬에서 동일한 결과를 생성하기 위해 의존 할 수있는 경우, 그러한 것을 보내면 성능을 향상시킬 수 있습니다.여기서원격 실행을위한 조항. 이 동작은 다음 옵션을 사용하여 제어 할 수 있습니다.

확장

이 옵션은 쉼표로 구분 된 이름 목록입니다PostgreSQL로컬 서버 및 원격 서버 모두에 호환 가능한 버전으로 설치되는 확장. 불변성이고 나열된 확장자에 속하는 기능 및 연산자는 원격 서버에 전환 할 수있는 것으로 간주됩니다. 이 옵션은 테이블 당 이외의 외국 서버에만 지정할 수 있습니다.

사용시확장옵션,사용자의 책임입니다나열된 확장자가 존재하며 로컬 서버와 원격 서버 모두에서 동일하게 작동합니다. 그렇지 않으면 원격 쿼리가 실패하거나 예기치 않게 행동 할 수 있습니다.

fetch_size

이 옵션은 행 수를 지정합니다Postgres_FDW각 페치 작업에서 가져와야합니다. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다. 테이블에 지정된 옵션은 서버에 지정된 옵션을 대체합니다. 기본값은100.

F.34.1.5. 업데이트 가능성 옵션

기본적으로 모든 외국 테이블을 사용하여postgres_fdw업데이트 가능한 것으로 가정합니다. 다음 옵션을 사용하여 재정의 할 수 있습니다.

업데이트 가능

이 옵션은를 제어합니다.postgres_fdw|삽입, 업데이트and삭제명령. 외국 테이블 또는 외국 서버에 대해 지정할 수 있습니다. 테이블 레벨 옵션은 서버 레벨 옵션을 대체합니다. 기본값은true.

물론 원격 테이블이 실제로 업데이트되지 않으면 어쨌든 오류가 발생합니다. 이 옵션을 사용하면 주로 원격 서버를 쿼리하지 않고 오류를 로컬로 던질 수 있습니다. 그러나Information_Schema보기가 a보고됩니다.postgres_fdw원격 서버의 점검 없이이 옵션의 설정에 따라 외국 테이블을 업데이트 할 수 있습니다.

F.34.1.6. 옵션 가져 오기

postgres_fdw를 사용하여 외래 사설 토토 사이트 정의를 가져올 수 있습니다PostgreSQL :. 이 명령은 로컬 서버에서 원격 서버에있는 테이블 또는보기와 일치하는 외국 테이블 정의를 만듭니다. 가져올 원격 테이블에 사용자 정의 데이터 유형의 열이있는 경우 로컬 서버에는 동일한 이름의 호환 유형이 있어야합니다.

동작 가져 오기는 다음 옵션으로 사용자 정의 할 수 있습니다 (외국 스키마 가져 오기명령) :

import_collate

이 옵션은 열 여부를 제어합니다Collate옵션은 외국 서버에서 가져온 외래 사설 토토 사이트의 정의에 포함됩니다. 기본값은true. 원격 서버가 로컬 서버와 다른 Collation 이름 세트가 있으면이를 끄는 것이 필요할 수 있습니다. 이는 다른 운영 체제에서 실행중인 경우에 해당 될 수 있습니다. 그러나 그렇게한다면, 가져온 사설 토토 사이트 열의 콜라이트가 기본 데이터와 일치하지 않아서 변칙적 인 쿼리 동작이 발생할 위험이 매우 심각합니다..

이 매개 변수가 설정된 경우에도true, Collation의 원격 서버의 기본값을 가져 오는 것은 위험 할 수 있습니다. 그들은로 수입됩니다."기본값", 로컬 서버의 기본 콜 레이션을 선택할 수 있습니다.

import_default

이 옵션은 열을 제어합니다기본값표현식은 외국 서버에서 가져온 외국 테이블의 정의에 포함됩니다. 기본값은거짓. 이 옵션을 활성화하는 경우 원격 서버에서 로컬 서버에서 다르게 계산 될 수있는 기본값에주의하십시오.nextVal ()는 일반적인 문제의 원천입니다. 그만큼가져 오기가져 오기 기본 표현식이 로컬로 존재하지 않는 함수 또는 연산자를 사용하는 경우 완전히 실패합니다.

import_not_null

이 옵션은 열 여부를 제어합니다NOT NULL제약 조건은 외국 서버에서 가져온 외국 테이블의 정의에 포함됩니다. 기본값은True.

이외의 제약 조건에 유의하십시오NOT NULL원격 사설 토토 사이트에서 가져 오지 않습니다. 하지만PostgreSQL지원check외국 사설 토토 사이트의 제약 조건은 제약 조건 표현이 로컬 서버 및 원격 서버에서 다르게 평가할 수 있기 때문에 자동으로 가져 오는 조항이 없습니다. a의 행동에 대한 그러한 불일치check제약 조건은 쿼리 최적화에서 감지하기 어려운 오류로 이어질 수 있습니다. 수입하고 싶다면check제약 조건, 수동으로 수행해야하며 각각의 의미를 신중하게 확인해야합니다. 치료에 대한 자세한 내용은check외국 사설 토토 사이트의 제약 조건, 참조PostgreSQL : 문서 :.

다른 테이블의 파티션 인 테이블 또는 외국 테이블은 자동으로 제외됩니다. 분할 된 테이블은 다른 테이블의 파티션이 아니라면 가져옵니다. 분할 계층 구조의 루트 인 파티션 된 테이블을 통해 모든 데이터에 액세스 할 수 있으므로이 접근 방식은 추가 객체를 생성하지 않고 모든 데이터에 액세스 할 수 있어야합니다..

F.34.2. 연결 관리

Postgres_FDW외국 서버와 관련된 외국 테이블을 사용하는 첫 번째 쿼리 중에 외국 서버에 대한 연결을 설정합니다. 이 연결은 동일한 세션에서 후속 쿼리에 대해 유지 및 재사용됩니다. 그러나 여러 사용자 ID (사용자 매핑)가 외국 서버에 액세스하는 데 사용되는 경우 각 사용자 매핑마다 연결됩니다.

F.34.3. 거래 관리

외국 서버에서 원격 사설 토토 사이트을 참조하는 쿼리 중에postgres_fdw원격 서버에서 현재 로컬 트랜잭션에 해당하지 않은 경우 원격 서버에서 트랜잭션을 엽니 다. 로컬 거래가 저지르거나 중단 할 때 원격 거래는 커밋되거나 중단됩니다. SavePoints는 해당 원격 저장 포인트를 작성하여 유사하게 관리됩니다.

원격 트랜잭션이 사용SERIALIZABLE지역 거래가있는 경우 격리 수준SERIALIZABLE분리 레벨; 그렇지 않으면 사용반복 가능한 읽기분리 레벨. 이 선택을 통해 쿼리가 원격 서버에서 여러 테이블 스캔을 수행하면 모든 스캔에 대한 스냅 샷과 일치하는 결과가 나타납니다. 결과적으로 단일 트랜잭션 내에서 연속적인 쿼리는 다른 활동으로 인해 원격 서버에서 동시 업데이트가 발생하더라도 원격 서버에서 동일한 데이터를 볼 수 있습니다. 지역 거래가 사용하면 어쨌든 그 행동이 예상 될 것입니다SERIALIZABLE또는반복 가능한 읽기격리 레벨이지만 A에 놀라운 일이 될 수 있습니다.Committed 읽기로컬 거래. 미래PostgreSQL릴리스 가이 규칙을 수정할 수 있습니다.

현재는 지원되지 않습니다postgres_fdw2 상 커밋을 위해 원격 트랜잭션을 준비하려면

F.34.4. 원격 쿼리 최적화

postgres_fdw외국 서버에서 전송 된 데이터 양을 줄이기 위해 원격 쿼리를 최적화하려고 시도합니다. 이것은 query를 보내어 수행됩니다여기서실행을 위해 원격 서버로의 조항과 현재 쿼리에 필요하지 않은 사설 토토 사이트 열을 검색하지 않습니다. 쿼리의 미성 침체의 위험을 줄이기 위해여기서클로스는 데이터 유형, 운영자 및 외국 서버에 나열된 확장자에 속하는 데이터 유형, 연산자 및 기능 만 사용하지 않는 한 원격 서버로 전송되지 않습니다확장옵션. 그러한 조항의 운영자와 기능은불변for업데이트또는삭제쿼리,postgres_fdw쿼리가없는 경우 전체 쿼리를 원격 서버로 전송하여 쿼리 실행을 최적화하려고 시도합니다여기서원격 서버로 보낼 수없는 클로스, 쿼리에 대한 로컬 조인, 로컬 로컬 없음또는이후대상 사설 토토 사이트의 트리거 및 아니요옵션 확인부모의 견해에서 제한. 안에업데이트, 대상 열에 할당하는 표현식은 내장 데이터 유형 만 사용해야합니다.불변운영자 또는불변함수, 쿼리의 미성분의 위험을 줄이기위한 기능.

언제Postgres_FDW동일한 외국 서버의 외국 테이블 사이의 결합을 만나면, 어떤 이유로 든 각 테이블의 행을 개별적으로 가져 오거나 관련된 테이블 참조가 다른 사용자 맵핑에 적용되지 않는 한, 어떤 이유로 든 외국 서버로 전체 조인을 보냅니다. 보내는 동안Join조항, 위에서 언급 한 것과 동일한 예방 조치를 취합니다.여기서클로즈.

실행을 위해 실제로 원격 서버로 전송 된 쿼리를 사용하여 검사 할 수 있습니다Verbose 설명.

F.34.5. 원격 쿼리 실행 환경

|postgres_fdw,search_path매개 변수가 정당하게 설정되었습니다PG_CATALOG, 스키마 자격없이 내장 객체 만 볼 수 있도록합니다. 이것은에 의해 생성 된 쿼리에 대한 문제가 아닙니다.​​postgres_fdw자체는 항상 그러한 자격을 제공하기 때문입니다. 그러나 이는 원격 테이블의 트리거 또는 규칙을 통해 원격 서버에서 실행되는 기능에 위험을 초래할 수 있습니다. 예를 들어, 원격 테이블이 실제로보기 인 경우 해당보기에 사용 된 기능은 제한된 검색 경로로 실행됩니다. 그러한 함수의 모든 이름을 스키마 자격으로 평가하거나 첨부하는 것이 좋습니다set search_path옵션 (참조함수 만들기) 예상되는 검색 경로 환경을 설정하기 위해 그러한 함수에.

postgres_fdw마찬가지로 다양한 매개 변수에 대한 원격 세션 설정을 설정합니다.

이것들은 문제가 적을 가능성이 적습니다search_path하지만 기능으로 처리 할 수 ​​있습니다SET필요가 발생하는 경우 옵션.

그것은아님이 매개 변수의 세션 수준 설정을 변경 하여이 동작을 무시할 것을 권장합니다. 그것은 원인 일 가능성이 높습니다postgres_fdw오작동에.

F.34.6. 교차 버전 호환성

Postgres_FDW원격 서버와 함께 사용될 수 있습니다PostgreSQL8.3. 읽기 전용 기능은 8.1로 다시 사용할 수 있습니다. 그러나 한계는Postgres_FDW일반적으로 불변의 내장 기능과 운영자가 실행을 위해 원격 서버로 보내기에 안전하다고 가정합니다.어디외국 표에 대한 조항. 따라서 원격 서버의 릴리스 이후에 추가 된 내장 기능이 실행을 위해 전송 될 수있어함수가 존재하지 않습니다또는 유사한 오류. 이 유형의 실패는 쿼리를 다시 작성하여 해결할 수 있습니다.selectwith오프셋 0최적화 울타리로서, 문제가있는 기능 또는 연산자를 하위 외부에 배치합니다select.

F.34.7. 예

다음은로 외국 사설 토토 사이트을 만드는 예입니다.postgres_fdw. 먼저 확장자 설치 :

Extension Create Postgres_fdw;

그런 다음를 사용하여 외래 서버를 만듭니다.서버 생성. 이 예에서 우리는 A에 연결하고 싶습니다PostgreSQL호스트의 서버192.83.123.89포트 듣기5432. 연결이 이루어진 데이터베이스 이름외국_DB원격 서버에서 :

Server forever_server 생성
        외국 데이터 포장 Postgres_FDW
        옵션 (호스트 '192.83.123.89', 포트 '5432', dbname 'forex_db');

사용자 맵핑,PostgreSQL, 원격 서버에서 사용될 역할을 식별하기 위해 필요합니다 :

local_user에 대한 사용자 매핑 생성
        서버 외국_server
        옵션 (사용자 '외국_user', 비밀번호 '비밀번호');

이제로 외국 사설 토토 사이트을 만들 수 있습니다PostgreSQL : 문서 :. 이 예에서는이라는 사설 토토 사이트에 액세스하고자합니다.some_schema.some_table원격 서버에서. 그것의 로컬 이름은입니다.외국 _table:

외국 _table 생성 (
        ID 정수가 NULL,
        데이터 텍스트
))
        서버 외국_server
        옵션 (schema_name 'some_schema', table_name 'some_table');

선언 된 열의 데이터 유형 및 기타 속성이외국 사설 토토 사이트 만들기실제 원격 사설 토토 사이트과 일치하십시오. 첨부하지 않는 한 열 이름도 일치해야합니다column_name원격 사설 토토 사이트에서 이름이 어떻게 지명되었는지를 보여주기 위해 개별 열의 옵션. 많은 경우 사용PostgreSQL :수동으로 외국 사설 토토 사이트 정의를 구성하는 것이 바람직합니다.

F.34.8. 작가

Shigeru Hanada