설명

롤 토토간에 ​​데이터 이동postgresql표 및 표준 파일 시스템 파일.복사테이블의 내용을 복사합니다to파일, while롤 토토 from데이터 사본From테이블에 파일 (이미 테이블에있는 모든 것에 데이터를 추가).복사a의 결과도 복사 할 수 있습니다.select쿼리.

열 목록이 지정된 경우복사지정된 열의 데이터 만 파일에 복사합니다. 을 위한롤 토토 from, 파일의 각 필드는 순서대로 지정된 열에 삽입됩니다. 표에 지정되지 않은 표 열롤 토토 from열 목록은 기본값을받습니다.

롤 토토파일 이름으로 지시postgresql서버 파일에서 직접 읽거나 쓸 수 있습니다. 파일은에 의해 액세스 할 수 있어야합니다.postgresqluser (사용자 ID 서버가 실행되는 사용자 ID)이며 이름은 서버의 관점에서 지정되어야합니다. 언제프로그램지정되고 서버는 주어진 명령을 실행하고 프로그램의 표준 출력에서 ​​읽거나 프로그램의 표준 입력에 씁니다. 명령은 서버의 관점에서 지정되어야하며에 의해 실행 될 수 있어야합니다.postgresql사용자. 언제Stdin또는stdout지정되어 있고, 데이터는 클라이언트와 서버 간의 연결을 통해 전송됩니다.

각 백엔드 실행롤 토토진행 상황을보고합니다PG_STAT_PROGRESS_롤 토토보기. 보다섹션 27.4.3자세한 내용.

기본적으로롤 토토처리 중에 오류가 발생하면 실패합니다. 전체 파일을로드하는 최상의 효과가 필요한 사용 사례의 경우on_error조항을 사용하여 다른 동작을 지정할 수 있습니다.

매개 변수

출력

성공적인 완료시 A롤 토토명령은 양식의 명령 태그를 반환

롤 토토count

thecount복사 된 행 수입니다.

노트

복사보기가 아닌 일반 테이블에서만 사용할 수 있으며 자식 테이블이나 하위 파티션에서 행을 복사하지 않습니다. 예를 들어,롤 토토테이블to동일한 행과 같은 행을 복사합니다선택 * From Only테이블. 구문롤 토토 (select * from테이블) to ...상속 계층, 분할 된 테이블 또는보기에 모든 행을 덤프하는 데 사용할 수 있습니다.

롤 토토 from평범한, 외국 또는 분할 된 테이블 또는 뷰와 함께 사용할 수 있습니다삽입 대신트리거.

값을 읽는 테이블에 선택된 권한이 있어야합니다복사, 그리고 값이 삽입되는 테이블에 권한을 삽입하십시오롤 토토 from. 명령에 열거 된 열에 열 권한을 갖는 것으로 충분합니다.

테이블에 대한로드 레벨 보안이 활성화 된 경우 관련select정책이 적용됩니다롤 토토테이블to진술. 현재,롤 토토 from는로드 레벨 보안이있는 테이블에 대해 지원되지 않습니다. 동등한 사용삽입대신 진술.

a에 명명 된 파일롤 토토명령은 클라이언트 응용 프로그램이 아닌 서버에서 직접 읽거나 작성합니다. 따라서 클라이언트가 아닌 데이터베이스 서버 시스템에 상주하거나 액세스 할 수 있어야합니다.postgresql사용자 (사용자는 서버가 실행되는 사용자 ID)가 아니라 클라이언트가 아닙니다. 마찬가지로 명령은프로그램클라이언트 응용 프로그램이 아닌 서버에서 직접 실행됩니다.postgresqluser.롤 토토파일 또는 명령 이름은 데이터베이스 슈퍼 사용자 또는 역할 중 하나가 부여 된 사용자에게만 허용됩니다PG_READ_SERVER_FILES, pg_write_server_files또는pg_execute_server_program, 서버가 액세스 할 권한이있는 프로그램을 읽거나 쓰거나 프로그램을 실행할 수 있으므로

혼동하지 마십시오롤 토토withPSQL교육\ 롤 토토. \ 롤 토토호출stdin에서 복사또는stdout에 복사PSQL클라이언트. 따라서 파일 접근성 및 액세스 권한은 서버가 아닌 클라이언트에 따라\ 롤 토토사용됩니다.

사용 된 파일 이름이 권장됩니다.롤 토토항상 절대 경로로 지정됩니다. 이것은의 경우 서버에 의해 시행됩니다.복사하지만롤 토토 from상대 경로로 지정된 파일에서 읽을 수있는 옵션이 있습니다. 이 경로는 클라이언트의 작업 디렉토리가 아닌 서버 프로세스의 작업 디렉토리 (일반적으로 클러스터의 데이터 디렉토리)에 비해 해석됩니다.

명령 실행프로그램Selinux와 같은 운영 체제의 액세스 제어 메커니즘에 의해 제한 될 수 있습니다.

롤 토토 from대상 테이블에서 트리거를 호출하고 제약 조건을 확인합니다. 그러나 규칙을 호출하지 않습니다.

신원 열,롤 토토 from명령은 항상 입력 데이터에 제공된 열 값을와 같이 작성합니다.삽입옵션시스템 가치 재정의.

롤 토토입력 및 출력에 의해 영향을받습니다Datestyle. 다른 사람에 대한 이식성을 보장하려면postgresql비 디폴트를 사용할 수있는 설치Datestyle설정,Datestyle로 설정해야합니다ISO사용 전복사. 또한 데이터를 덤프하지 않도록하는 것도 좋은 생각입니다.IntervalStyle설정sql_standard, 음의 간격 값이 다른 설정이 다른 서버에 의해 잘못 해석 될 수 있기 때문에IntervalStyle.

입력 데이터는에 따라 해석됩니다.인코딩옵션 또는 현재 클라이언트 인코딩 및 출력 데이터가 인코딩되어인코딩또는 현재 클라이언트 인코딩, 데이터가 클라이언트를 통과하지 않고 서버에서 직접 파일에서 읽거나 기록됩니다.

the롤 토토 from명령은 입력 행이 진행될 때 테이블에 물리적으로 삽입됩니다. 명령이 실패하면이 행은 삭제 된 상태로 남겨집니다.진공낭비 된 공간을 복구하는 데 사용해야합니다.

Force_null및force_not_null동시에 동시에 사용할 수 있습니다. 이로 인해 인용 된 널 문자열을 널 값으로 변환하고 인용되지 않은 널 문자열을 빈 문자로 변환합니다.

파일 형식

예

다음 예제는 수직 막대를 사용하여 클라이언트에게 테이블을 복사합니다 (|) 필드 구분 기호로서 :

Country Country to Stdout (Delimiter '|');

파일의 데이터를에 복사하려면Country테이블 :

'/usr1/proj/bray/sql/country_data'에서 컨트리를 복사합니다.

이름이 'a'로 시작하는 국가 만 파일에 복사하려면 :

롤 토토 (Country_Name이 'A%'와 같은 국가에서 선택 *)에서 '/usr1/proj/bray/sql/a_list_countries.copy';

압축 파일로 복사하려면 외부 압축 프로그램을 통해 출력을 파이프 할 수 있습니다.

롤 토토 COPIT CONITY 'GZIP> /usr1/proj/bray/sql/country_data.gz';

여기 테이블에 복사하는 데 적합한 데이터 샘플이 있습니다.Stdin:

AF 아프가니스탄

각 라인의 공백은 실제로 탭 문자입니다.

다음은 동일한 데이터이며 이진 형식의 출력입니다. UNIX 유틸리티를 통해 필터링 한 후 데이터가 표시됩니다.OD -C. 테이블에는 세 개의 열이 있습니다.char (2), 두 번째는 유형이 있습니다텍스트그리고 세 번째는 유형이 있습니다Integer. 모든 행은 세 번째 열에 널 값이 있습니다.

0000000 p g c o p y \ n 377 \ r \ n \ 0 \ 0 \ 0 \ 0 \ 0 \ 0

호환성

없음롤 토토SQL 표준의 명령문.

다음 구문이 전에 사용되었습니다postgresql버전 9.0 및 여전히 지원됩니다 :

롤 토토table_name[(column_name[, ...])]filename' |delimiter_character' ]]null_string' ]]QUOTE_CHARACTER' ]]Escape_character' ]]column_name[, ...]]]]table_name[(column_name[, ...]) | (쿼리)filename' |delimiter_character' ]]null_string' ]]QUOTE_CHARACTER' ]]Escape_character' ]]column_name[, ...] | *]]]

이 구문에서BINAGE및CSVa가 아니라 독립적 인 키워드로 취급됩니다형식옵션.

다음 구문이 전에 사용되었습니다postgresql버전 7.3 및 여전히 지원됩니다 :

복사 [binary]table_namefrom  'filename' |delimiter_character' ]]null_string' ]]table_nameto  'filename' |delimiter_character' ]]null_string' ]

참조