sp_helppublication(Transact-SQL)

적용 대상:SQL ServerAzure SQL Managed Instance

게시에 관한 정보를 반환합니다. Microsoft SQL Server 게시의 경우 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다. Oracle 게시의 경우 이 저장 프로시저는 모든 데이터베이스의 배포자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

  
sp_helppublication [ [ @publication = ] 'publication' ]  
    [ , [ @found=] found OUTPUT]  
    [ , [ @publisher = ] 'publisher' ]  

인수

[ @publication = ] 'publication' 볼 발행물의 이름입니다. 게시 는 sysname이며 기본값 %은 모든 게시에 대한 정보를 반환합니다.

[ @found = ] 'found' OUTPUT 반환 행을 나타내는 플래그입니다. found 는 int 이고 OUTPUT 매개 변수이며 기본값 은 23456입니다. 1 은 발행물이 발견되었음을 나타냅니다. 0 은 게시를 찾을 수 없음을 나타냅니다.

[ @publisher = ] 'publisher' SQL Server가 아닌 게시자를 지정합니다. 게시 자는 sysname이며 기본값은 NULL입니다.

참고 항목

SQL Server 게시자 에서 게시 정보를 요청할 때 게시자를 지정하면 안 됩니다.

결과 집합

열 이름	데이터 형식	설명
pubid	int	게시의 ID입니다.
이름	sysname	게시의 이름입니다.
restricted	int	정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.
status	tinyint	게시의 현재 상태입니다. 0 = 비활성입니다. 1 = 활성입니다.
task		이전 버전과의 호환성을 위해서 사용됩니다.
복제 빈도	tinyint	복제 빈도 유형: 0 = 트랜잭션 1 = 스냅샷
동기화 방법	tinyint	동기화 모드: 0 = 네이티브 대량 복사 프로그램(bcp 유틸리티) 1 = 문자 대량 복사 3 = 동시- 네이티브 대량 복사(bcp유틸리티)가 사용되지만 스냅샷 중에 테이블이 잠기지 않음을 의미합니다. 4 = Concurrent_c. 즉, 문자 대량 복사가 사용되지만 스냅샷 중에 테이블이 잠기지 않음을 의미합니다.
description	nvarchar(255)	게시에 대한 선택적 설명입니다.
immediate_sync	bit	스냅샷 에이전트가 실행될 때마다 동기화 파일이 생성 또는 다시 생성되는지 여부를 나타냅니다.
enabled_for_internet	bit	게시의 동기화 파일이 FTP(파일 전송 프로토콜) 및 기타 서비스를 통해 인터넷에 노출되는지 여부입니다.
allow_push	bit	게시에서 밀어넣기 구독이 허용되는지 여부입니다.
allow_pull	bit	게시에서 끌어오기 구독이 허용되는지 여부입니다.
allow_anonymous	bit	게시에서 익명 구독이 허용되는지 여부입니다.
independent_agent	bit	이 게시에 대한 독립 실행형 배포 에이전트가 있는지 여부입니다.
immediate_sync_ready	bit	스냅샷 에이전트가 새 구독에서 사용할 준비가 된 스냅샷을 생성했는지 여부입니다. 이 매개 변수는 게시가 항상 새 구독 또는 다시 초기화된 구독에 대해 스냅샷을 사용할 수 있도록 설정된 경우에만 정의됩니다.
allow_sync_tran	bit	게시에서 즉시 업데이트 구독이 허용되는지 여부입니다.
autogen_sync_procs	bit	즉시 업데이트 구독을 지원하기 위해 저장 프로시저를 자동으로 생성할지 여부입니다.
snapshot_jobid	binary(16)	예약된 태스크 ID입니다.
retention	int	지정한 게시에 대해 저장할 변경 내용의 양을 시간으로 나타낸 것입니다.
has subscription	bit	게시에 활성 구독이 있는 경우 1 은 게시에 활성 구독이 있음을 의미하고 0 은 게시에 구독이 없음을 의미합니다.
allow_queued_tran	bit	게시자에서 적용할 수 있을 때까지 구독자에서 변경 내용의 큐를 사용하지 않도록 설정할지 여부를 지정합니다. 0이면 구독자의 변경 내용이 큐에 대기되지 않습니다.
snapshot_in_defaultfolder	bit	스냅샷 파일이 기본 폴더에 저장되는지 여부를 지정합니다. 0이면 스냅샷 파일이 alternate_snapshot_folder 지정된 대체 위치에 저장됩니다. 1이면 기본 폴더에서 스냅샷 파일을 찾을 수 있습니다.
alt_snapshot_folder	nvarchar(255)	스냅샷에 대한 대체 폴더의 위치를 지정합니다.
pre_snapshot_script	nvarchar(255)	.sql 파일 위치에 대한 포인터를 지정합니다. 배포 에이전트는 구독자에서 스냅샷을 적용할 때 복제된 개체 스크립트를 실행하기 전에 사전 스냅샷 스크립트를 실행합니다.
post_snapshot_script	nvarchar(255)	.sql 파일 위치에 대한 포인터를 지정합니다. 배포 에이전트는 초기 동기화 중 복제된 다른 모든 개체 스크립트 및 데이터가 적용된 후 포스트 스냅샷 스크립트를 실행합니다.
compress_snapshot	bit	alt_snapshot_folder 위치에 기록되는 스냅샷을 Microsoft CAB 형식으로 압축하도록 지정합니다. 0 은 스냅샷이 압축되지 않도록 지정합니다.
ftp_address	sysname	배포자에 대한 FTP 서비스의 네트워크 주소입니다. 구독자의 배포 에이전트 또는 병합 에이전트를 선택할 게시 스냅샷 파일이 있는 위치를 지정합니다.
ftp_port	int	배포자에 대한 FTP 서비스의 포트 번호입니다.
ftp_subdirectory	nvarchar(255)	게시가 FTP를 사용하여 스냅샷 전파를 지원하는 경우 구독자의 배포 에이전트 또는 병합 에이전트가 선택할 스냅샷 파일을 사용할 수 있는 위치를 지정합니다.
ftp_login	sysname	FTP 서비스에 연결하는 데 사용되는 사용자 이름입니다.
allow_dts	bit	게시에서 데이터 변환을 허용하도록 지정합니다. 0 은 DTS 변환이 허용되지 않도록 지정합니다.
allow_subscription_copy	bit	해당 게시를 구독하는 구독 데이터베이스를 복사하는 기능이 활성화되었는지 여부를 지정합니다. 0 은 복사가 허용되지 않음을 의미합니다.
centralized_conflicts	bit	게시자에 충돌 레코드를 저장하는지 여부를 지정합니다. 0 = 충돌 레코드는 게시자와 충돌을 일으킨 구독자 모두에 저장됩니다. 1 = 충돌 레코드가 게시자에 저장됩니다.
conflict_retention	int	충돌 보존 기간을 일 단위로 지정합니다.
conflict_policy	int	대기 중인 업데이트 구독자 옵션을 사용할 때 다음에 발생하는 충돌 해결 정책을 지정합니다. 다음 값 중 하나일 수 있습니다. 1 = 게시자가 충돌을 이깁니다. 2 = 구독자가 충돌을 이깁니다. 3 = 구독이 다시 초기화됩니다.
queue_type		사용되는 큐 유형을 지정합니다. 다음 값 중 하나일 수 있습니다. msmq = Microsoft 메시지 큐를 사용하여 트랜잭션을 저장합니다. sql = SQL Server를 사용하여 트랜잭션을 저장합니다. 참고: 메시지 큐에 대한 지원이 중단되었습니다.
backward_comp_level		데이터베이스 호환성 수준이며 다음 중 하나일 수 있습니다. 90 = Microsoft SQL Server 2005(9.x) 100 = Microsoft SQL Server 2008(10.0.x)
publish_to_AD	bit	게시가 Microsoft Active Directory에 게시되는지 여부를 지정합니다. 값 1 은 게시됨을 나타내고 값 0 은 게시되지 않음을 나타냅니다.
allow_initialize_from_backup	bit	구독자가 초기 스냅샷이 아닌 백업에서 이 게시에 대한 구독을 초기화할 수 있는지를 나타냅니다. 1 은 백업에서 구독을 초기화할 수 있음을 의미하고 0 은 구독을 초기화할 수 없음을 의미합니다. 자세한 내용은 스냅샷 없이 트랜잭션 구독을 스냅샷 없이 트랜잭션 구독자 초기화를 참조하세요.
replicate_ddl	int	게시에 대해 스키마 복제가 지원되는지를 나타냅니다. 1 은 게시자에서 실행되는 DDL(데이터 정의 언어) 문이 복제됨을 나타내고 0 은 DDL 문이 복제되지 않음을 나타냅니다. 자세한 내용은 게시 데이터베이스의 스키마 변경을 참조하세요.
enabled_for_p2p	int	피어 투 피어 복제 토폴로지에서 게시가 사용될 수 있는지 여부를 나타냅니다. 1 은 게시가 피어 투 피어 복제를 지원한다는 것을 나타냅니다. 자세한 내용은 피어 투 피어 트랜잭션 복제를 참조 하세요.
publish_local_changes_only	int	정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.
enabled_for_het_sub	int	게시에서 SQL Server 이외 구독자를 지원하는지 여부를 지정합니다. 값 이 1 이면 SQL Server 이외 구독자가 지원됩니다. 값 이 0 이면 SQL Server 구독자만 지원됩니다. 자세한 내용은 SQL Server 이외 구독자를 참조 하세요.
enabled_for_p2p_conflictdetection	int	배포 에이전트가 피어 투 피어 복제를 사용하도록 설정된 게시에 대한 충돌을 검색할지 여부를 지정합니다. 값 이 1 이면 충돌이 검색됩니다. 자세한 내용은 Conflict Detection in Peer-to-Peer Replication을 참조하세요.
originator_id	int	피어 투 피어 토폴로지에 있는 노드의 ID를 지정합니다. 이 ID는 enabled_for_p2p_conflictdetection 1로 설정된 경우 충돌 검색에 사용됩니다. 이미 사용된 ID 목록은 Mspeer_originatorid_history 시스템 테이블을 쿼리합니다.
p2p_continue_onconflict	int	충돌이 감지될 때 배포 에이전트가 변경 내용을 계속 처리할지 여부를 지정합니다. 값 이 1 이면 에이전트가 변경 내용을 계속 처리합니다. ** 주의 ** 기본값 인 0을 사용하는 것이 좋습니다. 이 옵션을 1로 설정하면 배포 에이전트는 가장 높은 발신기 ID가 있는 노드에서 충돌하는 행을 적용하여 토폴로지의 데이터를 수렴하려고 합니다. 이 메서드는 수렴을 보장하지 않습니다. 충돌이 감지된 후 토폴로지의 일관성을 확인해야 합니다. 자세한 내용은 피어 투 피어 복제의 충돌 검색에서 "충돌 처리"를 참조하세요.
allow_partition_switch	int	Specifies whether ALTER TABLE... SWITCH 문은 게시된 데이터베이스에 대해 실행할 수 있습니다. 자세한 내용은 분할된 테이블 및 인덱스 복제를 참조 하세요.
replicate_partition_switch	int	Specifies whether ALTER TABLE... 게시된 데이터베이스에 대해 실행되는 SWITCH 문을 구독자에 복제해야 합니다. 이 옵션은 allow_partition_switch 1로 설정된 경우에만 유효합니다.
enabled_for_p2p_lastwriter_conflictdetection	int	SQL Server 2019(15.x) CU 13부터 배포 에이전트가 피어 투 피어 복제를 사용하도록 설정된 게시에 대한 마지막 기록기 충돌을 검색하는지 여부를 지정합니다. 값 이 1 이면 마지막 기록기 충돌이 검색됩니다.

반환 코드 값

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

설명

sp_helppublication 스냅샷 및 트랜잭션 복제에 사용됩니다.

sp_helppublication은 이 프로시저를 실행하는 사용자가 소유하는 모든 게시에 대한 정보를 반환합니다.

예

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks2022]
EXEC sp_helppublication @publication = @myTranPub
GO

사용 권한

게시자에서 sysadmin 고정 서버 역할의 멤버 또는 게시 데이터베이스에 대한 db_owner 고정 데이터베이스 역할의 멤버 또는 PAL(게시 액세스 목록)의 사용자만 sp_helppublication 실행할 수 있습니다.

SQL Server가 아닌 게시자의 경우 배포자에서 sysadmin 고정 서버 역할의 멤버 또는 배포 데이터베이스에 대한 db_owner 고정 데이터베이스 역할의 멤버 또는 PAL의 사용자만 sp_helppublication 실행할 수 있습니다.

참고 항목

게시 속성 보기 및 수정
sp_addpublication(Transact-SQL)
sp_changepublication(Transact-SQL)
sp_droppublication(Transact-SQL)
복제 저장 프로시저(Transact-SQL)