복원 설정(Restore Settings)

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가 됩니다.

`structure_only`	`restore_*` 미설정	`restore_* = true`	`restore_* = false`
`false`	복원됨	복원됨	건너뜀
`true`	건너뜀	복원됨	건너뜀

이것은 완전히 하위 호환이 됩니다. 새 설정 중 어떤 것도 설정하지 않는 RESTORE 쿼리는 정확히 이전처럼 동작합니다.

예시

데이터를 복사하지 않고 테스트나 쿼리 재생 환경을 구성하기 위해 테이블 정의와 접근 엔티티는 복원하되 테이블 데이터는 복원하지 않기:

RESTORE ALL FROM backup_name
SETTINGS structure_only = true, restore_access_entities = true

접근 엔티티나 사용자 정의 함수를 다시 만들지 않고 테이블 데이터만 복원하기:

RESTORE ALL FROM backup_name
SETTINGS structure_only = true, restore_table_data = true

사용자 정의 함수를 제외한 모든 것을 복원하기:

RESTORE ALL FROM backup_name
SETTINGS restore_functions = false

복원 설정(Restore Settings)