설명

롤 토토다음 사이에 데이터 이동포스트그레SQL테이블 및 표준 파일 시스템 파일.롤 토토 대상테이블의 내용을 롤 토토합니다에파일, 동안롤 토토본:데이터 롤 토토에서테이블에 파일을 추가합니다(이미 테이블에 있는 모든 항목에 데이터를 추가합니다).롤 토토 대상또한 a의 결과를 롤 토토할 수 있습니다선택질의.

열 목록이 지정되면,롤 토토 대상지정된 열의 데이터만 파일에 롤 토토합니다. 을 위한롤 토토본:, 파일의 각 필드가 지정된 열에 순서대로 삽입됩니다. 에 지정되지 않은 테이블 열다음에서 롤 토토열 목록은 기본값을 받게 됩니다.

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

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

기본적으로,롤 토토처리 중 오류가 발생하면 실패합니다. 전체 파일을 로드하기 위해 최선을 다하는 시도가 필요한 사용 사례의 경우,ON_ERROR절을 사용하여 다른 동작을 지정할 수 있습니다.

매개변수

출력

성공적으로 완료되면, a롤 토토명령은 다음 형식의 명령 태그를 반환합니다.

롤 토토개수

그개수롤 토토된 행 수입니다.

참고

롤 토토 대상일반 테이블 및 채워진 구체화된 뷰와 함께 사용할 수 있습니다. 예를 들어,롤 토토테이블대상으로다음과 동일한 행을 롤 토토합니다SELECT * FROM ONLY테이블. 그러나 분할된 테이블, 상속 하위 테이블 또는 뷰와 같은 다른 관계 유형은 직접 지원하지 않습니다. 그러한 관계에서 모든 행을 롤 토토하려면 다음을 사용하십시오.롤 토토(SELECT * FROM테이블) 받는 사람.

다음에서 롤 토토일반, 외부 또는 분할된 테이블이나 다음과 같은 뷰와 함께 사용할 수 있습니다.삽입 대신트리거.

귀하는 값을 읽는 테이블에 대한 선택 권한이 있어야 합니다.롤 토토 대상, 값이 삽입된 테이블에 대한 삽입 권한다음에서 롤 토토. 명령에 나열된 열에 대한 열 권한만 있으면 충분합니다.

테이블에 대해 행 수준 보안이 활성화된 경우 관련선택정책이 적용됩니다롤 토토테이블받는 사람문장. 현재,롤 토토본:행 수준 보안이 적용된 테이블에는 지원되지 않습니다. 동등한 것을 사용하십시오.삽입문 대신.

a에 이름이 지정된 파일롤 토토명령은 클라이언트 응용프로그램이 아닌 서버에서 직접 읽거나 씁니다. 따라서 클라이언트가 아닌 데이터베이스 서버 시스템에 상주하거나 액세스할 수 있어야 합니다. 해당 파일은 다음에서 액세스할 수 있고 읽거나 쓸 수 있어야 합니다.PostgreSQL클라이언트가 아닌 사용자(서버가 실행되는 사용자 ID). 마찬가지로, 다음과 같이 지정된 명령은프로그램클라이언트 응용프로그램이 아닌 서버에서 직접 실행되며 다음에서 실행 가능해야 합니다.PostgreSQL사용자.롤 토토파일 또는 명령 이름 지정은 데이터베이스 수퍼유저 또는 역할 중 하나가 부여된 사용자에게만 허용됩니다.pg_read_server_files, pg_write_server_files, 또는pg_execute_server_program, 서버가 액세스할 수 있는 권한이 있는 파일을 읽거나 쓰거나 프로그램을 실행할 수 있기 때문입니다.

혼란하지 마십시오.롤 토토와 함께psql지시\롤 토토. \롤 토토호출STDIN에서 롤 토토또는STDOUT에 롤 토토, 그런 다음에 액세스할 수 있는 파일에 데이터를 가져오거나 저장합니다.psql클라이언트. 따라서 파일 접근성 및 액세스 권한은 다음과 같은 경우 서버가 아닌 클라이언트에 따라 달라집니다.\롤 토토사용됩니다.

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

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

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

ID 열의 경우,롤 토토본:명령은 항상 입력 데이터에 제공된 열 값을 작성합니다.삽입옵션시스템 값 재정의.

롤 토토입력 및 출력은 다음에 영향을 받습니다.날짜 스타일. 다른 사람에게 이식성을 보장하기 위해포스트그레SQL기본값이 아닌 것을 사용할 수 있는 설치날짜 스타일설정,날짜 스타일다음으로 설정되어야 합니다ISO사용하기 전롤 토토 대상. 다음을 사용하여 데이터를 덤프하지 않는 것도 좋은 생각입니다.간격 스타일다음으로 설정됨sql_standard, 음의 간격 값은 다른 설정을 가진 서버에 의해 잘못 해석될 수 있기 때문입니다.간격 스타일.

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

그다음에서 롤 토토명령은 진행되면서 입력 행을 테이블에 물리적으로 삽입합니다. 명령이 실패하면 해당 행은 삭제된 상태로 남습니다. 이러한 행은 표시되지 않지만 여전히 디스크 공간을 차지합니다. 대규모 롤 토토 작업에서 오류가 발생한 경우 디스크 공간이 상당히 낭비될 수 있습니다.진공낭비된 공간을 복구하는 데 사용해야 합니다.

FORCE_NULL그리고FORCE_NOT_NULL동일한 열에서 동시에 사용할 수 있습니다. 이로 인해 인용된 Null 문자열은 Null 값으로 변환되고 인용되지 않은 Null 문자열은 빈 문자열로 변환됩니다.

파일 형식

예

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

국가를 STDOUT으로 롤 토토(구분자 '|');

파일의 데이터를 다음으로 롤 토토하려면국가테이블:

'/usr1/proj/bray/sql/country_data'에서 국가 롤 토토;

이름이 'A'로 시작하는 국가만 파일에 롤 토토하려면:

롤 토토(선택 * FROM 국가 WHERE country_name LIKE 'A%') TO '/usr1/proj/bray/sql/a_list_countries.copy';

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

'gzip  /usr1/proj/bray/sql/country_data.gz' 프로그램에 국가 롤 토토;

여기에서 테이블로 롤 토토하기에 적합한 데이터 샘플이 있습니다.STDIN:

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

각 줄의 공백은 실제로 탭 문자라는 점에 유의하세요.

다음은 동일한 데이터이며 바이너리 형식으로 출력됩니다. Unix 유틸리티를 통해 필터링한 후 데이터가 표시됩니다.od -c. 테이블에는 세 개의 열이 있습니다. 첫 번째 유형은 다음과 같습니다.문자(2), 두 번째에는 유형이 있습니다.텍스트, 세 번째에는 유형이 있습니다.정수. 모든 행의 세 번째 열에는 null 값이 있습니다.

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 \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
0000100A 377 377 377 377 \0 003 \0 \0 \0 002 DZ \0 \0 \0
0000120 007 알제리 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이며 계속 지원됩니다.

롤 토토테이블_이름 [ ( 열_이름[, ...] ) ]
    에서  '파일 이름' | 표준 
    [ [ 와 함께 ]
          [ 바이너리 ]
          [ 구분 기호 [ AS ] 'delimiter_character' ]
          [ NULL [ 그대로 ] 'null_string' ]
          [ CSV [ 헤더 ]
                [ 견적 [ 그대로 ] 'quote_character' ]
                [ 탈출 [ AS ] 'escape_character' ]
                [ 강제는 NULL이 아님열_이름[, ...] ] ] ]

롤 토토테이블_이름 [ ( 열_이름 [, ...] ) ] | ( 질의) 
    에게  '파일 이름' | 표준 출력 
    [ [ 와 함께 ]
          [ 바이너리 ]
          [ 구분 기호 [ AS ] 'delimiter_character' ]
          [ NULL [ 그대로 ] 'null_string' ]
          [ CSV [ 헤더 ]
                [ 견적 [ 그대로 ] 'quote_character' ]
                [ 탈출 [ AS ] 'escape_character' ]
                [ 강제 인용문열_이름 [, ...] | * } ] ] ]

이 구문에서 참고하세요.바이너리그리고CSVa의 인수가 아닌 독립적인 키워드로 처리됩니다.형식옵션.

다음 구문은 이전에 사용되었습니다.PostgreSQL버전 7.3이며 계속 지원됩니다.

롤 토토 [ 바이너리 ]테이블_이름발신:  '파일 이름' | 표준 
    [ [사용] 구분 기호 'delimiter_character' ]
    [ NULL로 'null_string' ]

롤 토토 [ 바이너리 ]테이블_이름대상으로  '파일 이름' | 표준 출력 
    [ [사용] 구분 기호 'delimiter_character' ]
    [ NULL로 'null_string' ]

또한 참조