Skip to main content
RESTORE 쿼리는 SETTINGS 절에서 백업에서 읽어올 객체 카테고리를 제어하는 설정을 지원합니다. 이 페이지에서는 테이블 데이터, 액세스 엔터티, 사용자 정의 함수 등 복원할 항목을 선택하는 설정을 설명합니다.

structure_only

유형: Bool. 기본값: false. true로 설정하면 복원할 객체의 내용은 제외하고 백업에서 CREATE 쿼리만 읽습니다. 이는 아래 세 가지 범주 설정의 유효 기본값을 모두 false로 설정하는 편리한 단축 설정입니다.
  • restore_table_data
  • restore_access_entities
  • restore_functions

restore_table_data

유형: Bool. 선택 사항이며, 설정하지 않으면 기본값은 !structure_only입니다(즉, structure_only가 설정되지 않은 경우 true). 테이블 데이터를 복원할지 여부입니다. 명시적으로 설정하면 structure_only를 재정의합니다. structure_only=true인 경우에도 테이블 데이터를 복원하려면 true로 설정하고, structure_only가 설정되지 않은 경우에도 테이블 데이터를 건너뛰려면 false로 설정하십시오.

restore_access_entities

유형: Bool. 선택 사항이며, 설정하지 않으면 기본값은 !structure_only입니다. 사용자, 역할, 설정 프로필, 행 정책 및 쿼터 등 액세스 엔터티를 복원할지 여부를 지정합니다. 명시적으로 설정하면 structure_only를 재정의합니다.

restore_functions

유형: Bool. 선택 사항이며, 설정하지 않으면 기본값은 !structure_only입니다. 사용자 정의 함수를 복원할지 여부를 지정합니다. 명시적으로 설정하면 structure_only를 재정의합니다.

실제 동작

각 범주는 해당 설정이 true일 때 복원됩니다. 범주별 설정을 지정하지 않으면 해당 값은 structure_only에 따라 결정됩니다. 기본적으로 세 가지 설정은 모두 true이며, structure_only=true이면 모두 false가 됩니다. 이 변경 사항은 완전히 이전 버전과 호환됩니다. 새로운 설정을 하나도 지정하지 않은 RESTORE 쿼리는 이전과 정확히 동일하게 동작합니다.

예시

테이블 정의와 액세스 엔터티는 복원하되 테이블 데이터는 복원하지 않습니다. 예를 들어, 데이터를 복사하지 않고 테스트 환경을 구성하거나 쿼리를 재실행할 수 있습니다:
액세스 엔터티나 사용자 정의 함수를 다시 생성하지 않고 테이블 데이터만 복원합니다:
사용자 정의 함수를 제외한 모든 항목 복원:
마지막 수정일 2026년 8월 17일