스냅샷 속성 구성(복제 Transact-SQL 프로그래밍)
적용 대상: 
SQL Server Azure SQL Managed Instance
복제 저장 프로시저를 사용하여 스냅샷 속성을 프로그래밍 방식으로 정의 및 수정할 수 있습니다. 사용되는 저장 프로시저는 게시 유형에 따라 달라집니다.
스냅샷 또는 트랜잭션 게시를 만들 때 스냅샷 속성을 구성하려면
게시자에서 sp_addpublication을 실행합니다.
@publication에 대한 게시 이름,@repl_freq에 대한 스냅샷 또는 연속의 값 및 다음 스냅샷 관련 매개 변수 중 하나 이상을 지정합니다:@alt_snapshot_folder- 이 게시의 스냅샷을 스냅샷 기본 폴더 대신 또는 추가로 액세스하는 위치의 경로를 지정합니다.@compress_snapshot- 대체 스냅샷 폴더의 스냅샷 파일이 Microsoft CAB 파일 형식으로 압축되는 경우 true 값을 지정합니다.@pre_snapshot_script- 초기 스냅샷을 적용하기 전에 초기화 시 구독자에서 실행할 .sql 파일 이름 및 전체 경로를 지정합니다.@post_snapshot_script- 초기 스냅샷을 적용한 후에 초기화 시 구독자에서 실행할 .sql 파일 이름 및 전체 경로를 지정합니다.@snapshot_in_defaultfolder- 기본이 아닌 위치에서만 스냅샷을 사용할 수 있는 경우 false 값을 지정합니다.
게시를 만드는 방법은 Create a Publication를 참조하세요.
병합 게시를 만들 때 스냅샷 속성을 구성하려면
게시자에서 sp_addmergepublication을 실행합니다.
@publication에 대한 게시 이름,@repl_freq에 대한 스냅샷 또는 연속의 값 및 다음 스냅샷 관련 매개 변수 중 하나 이상을 지정합니다:- \@alt_snapshot_folder - 이 게시의 스냅샷을 스냅샷 기본 폴더 대신 또는 추가로 액세스하는 위치의 경로를 지정합니다.
@compress_snapshot- 대체 스냅샷 폴더의 스냅샷 파일이 CAB 파일 형식으로 압축되는 경우 true 값을 지정합니다.@pre_snapshot_script- 초기 스냅샷을 적용하기 전에 초기화 시 구독자에서 실행할 .sql 파일 이름 및 전체 경로를 지정합니다.@post_snapshot_script- 초기 스냅샷을 적용한 후에 초기화 시 구독자에서 실행할 .sql 파일 이름 및 전체 경로를 지정합니다.@snapshot_in_defaultfolder- 기본이 아닌 위치에서만 스냅샷을 사용할 수 있는 경우 false 값을 지정합니다.
게시를 만드는 방법은 Create a Publication를 참조하세요.
기존 스냅샷 또는 트랜잭션 게시의 스냅샷 속성을 수정하려면
게시 데이터베이스의 게시자에서 sp_changepublication을 실행합니다.
@force_invalidate_snapshot에는1의 값을 지정하고@property에 다음 값 중 하나를 지정합니다:- alt_snapshot_folder -
@value에 대한 대체 스냅샷 폴더에 대한 새 경로도 지정합니다. - compress_snapshot - 대체 스냅샷 폴더의 스냅샷 파일이 CAB 파일 형식으로 압축되는지 여부를 나타내기 위해
@value에 true 또는 false 값을 지정합니다. - pre_snapshot_script -
@value에도 초기 스냅샷을 적용하기 전에 초기화 시 구독자에서 실행할 .sql 파일 이름 및 전체 경로를 지정합니다. - post_snapshot_script -
@value에도 마찬가지로 초기 스냅샷을 적용하기 전에 초기화하는 동안 구독자에서 실행할 .sql 파일의 이름 및 전체 경로를 지정합니다. - snapshot_in_defaultfolder - 기본이 아닌 위치에서만 스냅샷을 사용할 수 있는지 여부를 나타내기 위해 true 또는 false 값을 지정합니다.
- alt_snapshot_folder -
(선택적 옵션)게시 데이터베이스의 게시자에서 sp_changepublication_snapshot을 실행합니다.
@publication및 변경할 예약 또는 보안 자격 증명 매개 변수를 하나 이상을 지정합니다.Important
가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다. 스크립트 파일에 자격 증명을 저장하는 경우에는 무단으로 액세스하지 못하도록 파일에 보안을 설정해야 합니다.
명령 프롬프트에서 복제 스냅샷 에이전트를 실행하거나 스냅샷 에이전트 작업을 시작하여 새 스냅샷을 생성합니다. 자세한 내용은 초기 스냅샷 만들기 및 적용을 참조하세요.
기존 병합 게시의 스냅샷 속성을 수정하려면
게시 데이터베이스의 게시자에서 sp_changemergepublication을 실행합니다.
@force_invalidate_snapshot에는1의 값을 지정하고@property**에 다음 값 중 하나를 지정합니다:- alt_snapshot_folder -
@value에 대한 대체 스냅샷 폴더에 대한 새 경로도 지정합니다. - compress_snapshot - 대체 스냅샷 폴더의 스냅샷 파일이 CAB 파일 형식으로 압축되는지 여부를 나타내기 위해
@value에 true 또는 false 값을 지정합니다. - pre_snapshot_script -
@value에도 초기 스냅샷을 적용하기 전에 초기화 시 구독자에서 실행할 .sql 파일 이름 및 전체 경로를 지정합니다. - post_snapshot_script -
@value에도 마찬가지로 초기 스냅샷을 적용하기 전에 초기화하는 동안 구독자에서 실행할 .sql 파일의 이름 및 전체 경로를 지정합니다. - snapshot_in_defaultfolder - 기본이 아닌 위치에서만 스냅샷을 사용할 수 있는지 여부를 나타내기 위해 true 또는 false 값을 지정합니다.
- alt_snapshot_folder -
명령 프롬프트에서 복제 스냅샷 에이전트를 실행하거나 스냅샷 에이전트 작업을 시작하여 새 스냅샷을 생성합니다. 자세한 내용은 초기 스냅샷 만들기 및 적용을 참조하세요.
예시
이 예제에서는 대체 스냅샷 폴더 및 압축 스냅샷을 사용하는 게시를 만듭니다.
-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables
-- on the command line and in SQL Server Management Studio, see the
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".
--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @owner AS sysname;
DECLARE @snapshot_share AS sysname;
SET @publicationDB = N'AdventureWorks2022';
SET @publication = N'AdvWorksSalesOrdersMergeAltSnapshot';
SET @article = N'SpecialOffer';
SET @owner = N'Sales';
SET @snapshot_share = '\\' + $(InstanceName) + '\AltSnapshotFolder';
-- Enable merge replication on the publication database, using defaults.
USE master
EXEC sp_replicationdboption
@dbname = @publicationDB,
@optname=N'merge publish',
@value = N'true';
-- Create new merge publication with an alternate snapshot location.
USE [AdventureWorks]
EXEC sp_addmergepublication
-- required parameters
@publication = @publication,
@snapshot_in_defaultfolder = N'false',
@alt_snapshot_folder = @snapshot_share,
@compress_snapshot = N'true';
-- Create the snapshot job for the publication.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = $(Login),
@job_password = $(Password);
-- Add an article.
EXEC sp_addmergearticle
@publication = @publication,
@article = @article,
@source_object = @article,
@type = N'table',
@source_owner = @owner,
@destination_owner = @owner;
-- Start the snapshot job.
EXEC sp_startpublication_snapshot
@publication = @publication;
GO