설명

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

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

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

각 백엔드 실행롤 토토PG_STAT_PROGRESS_롤 토토보기. 보다섹션 27.4.3자세한 내용.

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

매개 변수

출력

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

롤 토토count

thecount복사 된 행 수입니다.

노트

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

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

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

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

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

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

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

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

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

신원 열,롤 토토 from명령은 항상 입력 데이터에 제공된 열 값을 작성합니다.삽입옵션시스템 값을 지키는.

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

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

the복사명령 입력 행이 진행될 때 입력 행을 물리적으로 삽입합니다. 명령이 실패하면이 행은 삭제 된 상태로 남겨집니다. 이 행은 보이지 않지만 여전히 디스크 공간을 차지합니다. 고장이 큰 복사 작업에 잘 발생하면 상당한 낭비 디스크 공간에 해당 할 수 있습니다.진공낭비 된 공간을 복구하는 데 사용해야합니다.

Force_nullandforce_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.롤 토토';

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

'GZIP /usr1/proj/bray/sql/country_data.gz'; 프로그램에 대한 국가 복사 국가.

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

AF 아프가니스탄
알 알바니아
DZ 알제리
ZM 잠비아
ZW 짐바브웨

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

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

0000000 p g c o p y \ n 377 \ r \ n \ 0 \ 0 \ 0 \ 0 \ 0 \ 0
0000020 \ 0 \ 0 \ 0 \ 0 003 \ 0 \ 0 \ 0 002 A F \ 0 \ 0 \ 013 A
0000040 F G H A N I S T A N 377 377 377 377 \ 0 003
0000060 \ 0 \ 0 \ 0 002 A L \ 0 \ 0 \ 0 007 A L B A N I
0000100 A 377 377 377 377 \ 0 003 \ 0 \ 0 \ 0 002 D Z \ 0 \ 0 \ 0 \ 0
0000120 007 A L G E R I A 377 377 377 377 \ 0 003 \ 0 \ 0
0000140 \ 0 002 Z M \ 0 \ 0 \ 0 006 Z A M B I A 377 377
0000160 377 377 \ 0 003 \ 0 \ 0 \ 0 002 Z W \ 0 \ 0 \ 0 \ B Z I
0000200 M B A B W E 377 377 377 377 377 377

호환성

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

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

롤 토토table_name[(column_name[, ...])]
    에서  'filename' | stdin
    [ [ 와 함께 ]
          [바이너리]
          [Delimiter [as] 'delimiter_character' ]]
          [null [as] 'null_string' ]]
          [CSV [헤더]
                [인용 [as] 'QUOTE_CHARACTER' ]]
                [탈출 [AS] 'Escape_character' ]]
                [힘이 아님column_name[, ...]]]]

복사table_name[(column_name[, ...]) | (쿼리)
    에게  'filename' | stdout
    [ [ 와 함께 ]
          [바이너리]
          [Delimiter [as] 'delimiter_character' ]]
          [null [as] 'null_string' ]]
          [CSV [헤더]
                [인용 [as] 'QUOTE_CHARACTER' ]]
                [탈출 [AS] 'Escape_character' ]]
                [힘 견적column_name[, ...] | *]]]

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

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

복사 [BANIAR]table_name'filename' | stdin
    [[사용] Delimiters 'delimiter_character' ]]
    [NULL으로 'null_string' ]]

복사 [binary]table_nameto  '56453_56463' | stdout
    [[사용] Delimiters 'delimiter_character' ]]
    [NULL으로 'null_string' ]

참조