sp_helpmergepublication(Transact-SQL)

적용 대상:SQL Server

병합 게시에 대한 정보를 반환합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

sp_helpmergepublication
    [ [ @publication = ] N'publication' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] N'reserved' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

인수

[ @publication = ] N'publication'

게시의 이름입니다. @publication 현재 데이터베이스의 %모든 병합 게시에 대한 정보를 반환하는 기본값인 sysname입니다.

[ @found = ] 찾은 출력

반환 행을 나타내는 플래그입니다. @found int 형식의 OUTPUT 매개 변수입니다.

  • 1 는 게시가 발견되었음을 나타냅니다.
  • 0 는 게시를 찾을 수 없음을 나타냅니다.

[ @publication_id = ] 'publication_id' OUTPUT

발행물 식별 번호입니다. @publication_id uniqueidentifier 형식의 OUTPUT 매개 변수입니다.

[ @reserved = ] N'reserved'

정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.

[ @publisher = ] N'publisher'

게시자의 이름입니다. @publisher sysname이며 기본값은 .입니다NULL.

[ @publisher_db = ] N'publisher_db'

게시 데이터베이스의 이름입니다. @publisher_db sysname이며 기본값은 .입니다NULL.

결과 집합

열 이름 데이터 형식 설명
id int 결과 집합 목록에서 게시의 순차적 순서입니다.
name sysname 게시의 이름입니다.
description nvarchar(255) 게시에 대한 설명입니다.
status tinyint 게시 데이터를 언제 사용할 수 있는지 나타냅니다.
retention int 게시에 있는 아티클의 변경 내용에 대한 메타데이터를 저장하는 데 걸린 시간입니다. 이 기간의 단위는 일, 주, 월 또는 연도일 수 있습니다. 단위에 대한 자세한 내용은 retention_period_unit 열을 참조하세요.
sync_mode tinyint 이 게시의 동기화 모드:

0 = 네이티브 대량 복사 프로그램(bcp 유틸리티)

1 = 문자 대량 복사
allow_push int 지정된 게시에 대해 밀어넣기 구독을 만들 수 있는지 여부를 나타냅니다. 0 는 밀어넣기 구독이 허용되지 않음을 의미합니다.
allow_pull int 지정된 게시에 대한 끌어오기 구독을 만들 수 있는지 여부를 결정합니다. 0 는 끌어오기 구독이 허용되지 않음을 의미합니다.
allow_anonymous int 지정된 게시에 대해 익명 구독을 만들 수 있는지 여부를 나타냅니다. 0 는 익명 구독이 허용되지 않음을 의미합니다.
centralized_conflicts int 지정한 게시자에 충돌 레코드가 저장되는지 여부를 나타냅니다.

0 = 충돌 레코드는 게시자와 충돌을 일으킨 구독자 모두에 저장됩니다.

1 = 모든 충돌 레코드가 게시자에 저장됩니다.
priority float(8) 루프백 구독의 우선 순위입니다.
snapshot_ready tinyint 이 게시의 스냅샷 준비가 되었는지 여부를 나타냅니다.

0 = 스냅샷을 사용할 준비가 완료되었습니다.

1 = 스냅샷을 사용할 준비가 되지 않았습니다.
publication_type int 게시 유형:

0 = 스냅샷.

1 = 트랜잭션입니다.

2 = 병합.
pubid uniqueidentifier 이 게시의 고유 식별자입니다.
snapshot_jobid binary(16) 스냅샷 에이전트 작업 ID입니다. sysjobs 시스템 테이블에서 스냅샷 작업에 대한 항목을 가져오려면 이 16진수 값을 uniqueidentifier변환해야 합니다.
enabled_for_internet int 인터넷에서 게시를 사용할 수 있는지 여부를 나타냅니다. 이 경우 1게시의 동기화 파일이 디렉터리에 배치 C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp 됩니다. 사용자는 FTP(파일 전송 프로토콜) 디렉터리를 만들어야 합니다. 이 경우 0게시를 인터넷 액세스에 사용할 수 없습니다.
dynamic_filter int 매개 변수가 있는 행 필터가 사용되는지 여부를 나타냅니다. 0 는 매개 변수가 있는 행 필터가 사용되지 않음을 의미합니다.
has_subscription bit 게시에 구독이 있는지 여부를 나타냅니다. 0 는 현재 이 게시에 대한 구독이 없음을 의미합니다.
snapshot_in_default_folder bit 스냅샷 파일을 기본 폴더에 저장하는지 여부를 지정합니다.

이 경우 1기본 폴더에서 스냅샷 파일을 찾을 수 있습니다.

경우 0스냅샷 파일이 지정한 대체 위치에 저장됩니다alt_snapshot_folder. 대체 위치는 다른 서버, 네트워크 드라이브 또는 이동식 미디어(예: CD-ROM 또는 이동식 디스크)에 있을 수 있습니다. 구독자가 나중에 검색할 수 있도록 스냅샷 파일을 FTP 사이트에 저장할 수도 있습니다.

참고: 이 매개 변수는 true일 수 있으며 매개 변수에 위치가 alt_snapshot_folder 있습니다. 이 조합은 스냅샷 파일이 기본 위치와 대체 위치 모두에 저장되도록 지정합니다.
alt_snapshot_folder nvarchar(255) 스냅샷 대체 폴더의 위치를 지정합니다.
pre_snapshot_script nvarchar(255) 구독자에서 스냅샷 적용할 때 복제본(replica)ted 개체 스크립트 앞에 병합 에이전트 실행되는 .sql 파일에 대한 포인터를 지정합니다.
post_snapshot_script nvarchar(255) 초기 동기화 중에 다른 모든 복제본(replica)ted 개체 스크립트와 데이터가 적용된 후 병합 에이전트 실행되는 .sql 파일에 대한 포인터를 지정합니다.
compress_snapshot bit 위치에 기록 alt_snapshot_folder 된 스냅샷 Microsoft CAB 형식으로 압축되도록 지정합니다.
ftp_address sysname 배포자에 대한 FTP 서비스의 네트워크 주소입니다. 병합 에이전트가 선택할 게시 스냅샷 파일의 위치를 지정합니다.
ftp_port int 배포자에 대한 FTP 서비스의 포트 번호입니다. ftp_port 의 기본값 21이 있습니다. 병합 에이전트가 선택할 게시 스냅샷 파일의 위치를 지정합니다.
ftp_subdirectory nvarchar(255) FTP를 사용하여 스냅샷 배달될 때 병합 에이전트 스냅샷 파일을 선택할 수 있는 위치를 지정합니다.
ftp_login sysname FTP 서비스에 연결하는 데 사용되는 사용자 이름입니다.
conflict_retention int 충돌이 유지되는 보존 기간(일)을 지정합니다. 지정된 일 수가 경과하면 충돌 행이 충돌 테이블에서 제거됩니다.
keep_partition_changes int 해당 게시에 대해 동기화가 최적화되는지 여부를 지정합니다. keep_partition_changes 의 기본값 0이 있습니다. 값 0 은 동기화가 최적화되지 않고 파티션의 데이터가 변경될 때 모든 구독자에게 전송되는 파티션을 확인한다는 의미입니다.

1 는 동기화가 최적화되고 변경된 파티션에 행이 있는 구독자만 영향을 받습니다.

참고: 기본적으로 병합 게시는 이 옵션보다 더 높은 수준의 최적화를 제공하는 미리 계산된 파티션을 사용합니다. 자세한 내용은 매개 변수가 있는 필터 - 매개 변수가 있는 행 필터매개 변수가 있는 필터 - 미리 계산된 파티션에 최적화를 참조하세요.
allow_subscription_copy int 해당 게시를 구독하는 구독 데이터베이스를 복사하는 기능이 활성화되었는지 여부를 지정합니다. 값은 0 복사가 허용되지 않음을 의미합니다.
allow_synctoalternate int 대체 동기화 파트너가 해당 게시자와 동기화될 수 있는지 여부를 지정합니다. 값은 0 동기화 파트너가 허용되지 않음을 의미합니다.
validate_subscriber_info nvarchar(500) 구독자 정보를 검색하고 구독자에서 매개 변수가 있는 행 필터링 조건의 유효성을 검사하는 데 사용되는 함수를 나열합니다. 정보가 각 병합과 일관되게 분할되는지 확인하는 데 도움이 됩니다.
backward_comp_level int 데이터베이스 호환성 수준이며 다음 값 중 하나일 수 있습니다.

90 = SQL Server 2005(9.x)

90 = SQL Server 2005(9.x) SP1

90 = SQL Server 2005(9.x) SP2

100 = SQL Server 2008(10.0.x)
publish_to_activedirectory bit 게시 정보가 Active Directory에 게시되는지 여부를 지정합니다. 값 0 은 Active Directory에서 게시 정보를 사용할 수 없음을 의미합니다.

이 매개 변수는 더 이상 사용되지 않으며 스크립트의 이전 버전과의 호환성을 위해 기본. Active Directory에 게시 정보를 더 이상 추가할 수 없습니다.
max_concurrent_merge int 동시 병합 프로세스의 수입니다. 이 경우 0지정된 시간에 실행되는 동시 병합 프로세스의 수에 제한이 없습니다.
max_concurrent_dynamic_snapshots int 병합 게시에 대해 실행할 수 있는 동시 필터링된 데이터 스냅샷 세션의 최대 수입니다. 이 경우 0지정된 시간에 게시에 대해 동시에 실행할 수 있는 동시 필터링된 데이터 스냅샷 세션의 최대 수에 제한이 없습니다.
use_partition_groups int 사전 계산 파티션이 사용되는지 여부를 확인합니다. 미리 계산된 파티션이 사용된다는 의미의 1 값입니다.
num_of_articles int 발행물의 아티클 수입니다.
replicate_ddl int 게시된 테이블에 대한 스키마 변경 내용이 복제본(replica). 스키마 변경 내용이 복제본(replica) 의미의 값 1 입니다.
publication_number smallint 이 발행물에 할당된 번호입니다.
allow_subscriber_initiated_snapshot bit 구독자가 필터링된 데이터 스냅샷 생성 프로세스를 시작할 수 있는지 여부를 결정합니다. 1 값은 구독자가 스냅샷 프로세스를 시작할 수 있음을 의미합니다.
allow_web_synchronization bit 웹 동기화에 게시를 사용할 수 있는지 여부를 나타냅니다. 1 값은 웹 동기화를 사용하도록 설정되었음을 의미합니다.
web_synchronization_url nvarchar(500) 웹 동기화에 사용되는 인터넷 URL입니다.
allow_partition_realignment bit 게시자의 행을 수정하여 파티션을 변경할 때 삭제가 구독자에게 전송되는지 여부를 결정합니다. 삭제가 구독자에게 전송된다는 의미의 값 1 입니다. 자세한 내용은 sp_addmergepublication(Transact-SQL)를 참조하세요.
retention_period_unit tinyint 보존을 정의할 때 사용되는 단위를 정의합니다. 다음 값 중 하나일 수 있습니다.

0 = day

1 = 주

2 = 월

3 = 연도
has_downloadonly_articles bit 게시에 속하는 아티클이 다운로드 전용 문서인지를 나타냅니다. 값은 1 다운로드 전용 문서가 있음을 나타냅니다.
decentralized_conflicts int 충돌을 일으킨 구독자에 충돌 레코드가 저장되는지 여부를 나타냅니다. 값은 0 충돌 레코드가 구독자에 저장되지 않음을 나타냅니다. 값은 1 충돌 레코드가 구독자에 저장됨을 나타냅니다.
generation_leveling_threshold int 하나의 생성에 포함되는 변경 내용 수를 지정합니다. 세대는 게시자 또는 구독자에게 전달되는 변경 내용의 컬렉션입니다.
automatic_reinitialization_policy bit 자동 다시 초기화가 발생하기 전에 구독자에서 변경 내용이 업로드되는지 여부를 나타냅니다. 값 1 은 자동 다시 초기화가 발생하기 전에 구독자에서 변경 내용이 업로드됨을 나타냅니다. 값이 0이면 자동 다시 초기화 전에 변경 내용이 업로드되지 않음을 나타냅니다.

반환 코드 값

0 (성공) 또는 1 (실패).

설명

sp_helpmergepublication는 병합 복제본(replica)에 사용됩니다.

사용 권한

게시에 대한 게시 액세스 목록의 멤버는 해당 게시에 대해 실행할 sp_helpmergepublication 수 있습니다. 게시 데이터베이스에서 db_owner 고정 데이터베이스 역할의 멤버는 모든 게시에 대한 정보를 위해 실행할 sp_helpmergepublication 수 있습니다.

예제

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2022]
EXEC sp_helpmergepublication @publication = @publication;
GO