sp_adddistpublisher(Transact-SQL)
적용 대상: 
SQL Server Azure SQL Managed Instance
지정된 배포 데이터베이스를 사용하도록 게시자를 구성합니다. 이 저장 프로시저는 모든 데이터베이스의 배포자에서 실행됩니다. 저장 프로시저 sp_adddistributor 및 sp_adddistributiondb 이 저장 프로시저를 사용하기 전에 실행해야 합니다.
구문
sp_adddistpublisher
[ @publisher = ] N'publisher'
, [ @distribution_db = ] N'distribution_db'
[ , [ @security_mode = ] security_mode ]
[ , [ @login = ] N'login' ]
[ , [ @password = ] N'password' ]
[ , [ @working_directory = ] N'working_directory' ]
[ , [ @trusted = ] N'trusted' ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @thirdparty_flag = ] thirdparty_flag ]
[ , [ @publisher_type = ] N'publisher_type' ]
[ , [ @storage_connection_string = ] N'storage_connection_string' ]
[ ; ]
인수
[ @publisher = ] N'publisher'
게시자 이름입니다. @publisher 기본값이 없는 sysname입니다.
참고 항목
서버 이름은 기본 인스턴스 또는 <Hostname>\<InstanceName>,<PortNumber> 명명된 <Hostname>,<PortNumber> 인스턴스에 대해 지정할 수 있습니다. SQL Server가 사용자 지정 포트를 사용하여 Linux 또는 Windows에 배포되고 브라우저 서비스를 사용할 수 없는 경우 연결의 포트 번호를 지정합니다. 원격 배포자에 대한 사용자 지정 포트 번호의 사용은 SQL Server 2019(15.x) 이상 버전에 적용됩니다.
[ @distribution_db = ] N'distribution_db'
배포 데이터베이스의 이름입니다. @distribution_db sysname이며 기본값은 없습니다. 이 매개 변수는 복제 에이전트에서 게시자에 연결하는 데 사용됩니다.
[ @security_mode = ] security_mode
구현된 보안 모드입니다. 이 매개 변수는 복제 에이전트가 지연 업데이트 구독 또는 SQL Server 이외 게시자를 사용하여 게시자에 연결하는 데만 사용됩니다. @security_mode int이며 이러한 값 중 하나일 수 있습니다.
| 값 | 설명 |
|---|---|
0 |
배포자의 복제 에이전트는 SQL Server 인증을 사용하여 게시자에 연결합니다. |
1(기본값) |
배포자의 복제 에이전트는 Windows 인증을 사용하여 게시자에 연결합니다. |
[ @login = ] N'login'
로그인입니다. 이 매개 변수는 security_mode 0경우 필요합니다. @login sysname이며 기본값은 .입니다NULL. 이 매개 변수는 복제 에이전트에서 게시자에 연결하는 데 사용됩니다.
[ @password = ] N'password'
암호입니다. @password sysname이며 기본값은 .입니다NULL. 이 매개 변수는 복제 에이전트에서 게시자에 연결하는 데 사용됩니다.
Important
빈 암호를 사용하지 마세요. 강력한 비밀번호를 사용하세요.
[ @working_directory = ] N'working_directory'
게시할 데이터 및 스키마 파일을 저장하기 위해 사용하는 작업 디렉터리의 이름입니다. @working_directory nvarchar(255)이며, 기본적으로 이 SQL Server 인스턴스의 폴더로 설정 ReplData 됩니다. 예들 들어 C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.1\ReplData입니다. 이름은 UNC 형식으로 지정해야 합니다.
Azure SQL Database의 경우 .\\<storage_account>.file.core.windows.net\<share>
[ @trusted = ] N'trusted'
@trusted 사용되지 않으며 이전 버전과의 호환성을 위해서만 제공됩니다. @trusted 기본값false인 nvarchar(5)입니다. 이 매개 변수를 오류로만 설정하면 오류가 false 발생합니다.
[ @encrypted_password = ] encrypted_password
이 매개 변수 설정은 더 이상 지원되지 않습니다. @encrypted_password 비트이며 기본값은 .입니다0. 이 매개 변수를 설정하면 1 오류가 발생합니다.
[ @thirdparty_flag = ] thirdparty_flag
게시자가 SQL Server인 경우를 지정합니다. @thirdparty_flag 비트이며 다음 값 중 하나일 수 있습니다.
| 값 | 설명 |
|---|---|
0(기본값) |
SQL Server 데이터베이스. |
1 |
SQL Server 이외의 데이터베이스입니다. |
[ @publisher_type = ] N'publisher_type'
게시자가 SQL Server가 아닌 경우 게시자 유형을 지정합니다. @publisher_type sysname이며 다음 값 중 하나일 수 있습니다.
| 값 | 설명 |
|---|---|
MSSQLSERVER(기본값) |
SQL Server 게시자를 지정합니다. |
ORACLE |
표준 Oracle 게시자를 지정합니다. |
ORACLE GATEWAY |
Oracle Gateway 게시자를 지정합니다. |
Oracle 게시자와 Oracle 게이트웨이 게시자의 차이점에 대한 자세한 내용은 Oracle 게시자 구성을 참조하세요.
[ @storage_connection_string = ] N'storage_connection_string'
Azure SQL Database에 필요합니다. @storage_connection_string 기본값NULL인 nvarchar(255)입니다. Azure Portal의 스토리지 > 설정 아래에 있는 액세스 키를 사용합니다.
참고 항목
Azure SQL Database의 게시자 및 배포자 데이터베이스에는 SQL Managed Instance가 필요합니다. 자세한 내용은 Azure SQL Database를 사용한 복제를 참조 하세요.
반환 코드 값
0(성공) 또는 1(실패).
설명
sp_adddistpublisher 는 스냅샷 복제, 트랜잭션 복제 및 병합 복제에서 사용됩니다.
예제
-- 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".
-- Install the Distributor and the distribution database.
DECLARE @distributor AS sysname;
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @directory AS nvarchar(500);
DECLARE @publicationDB AS sysname;
-- Specify the Distributor name.
SET @distributor = $(DistPubServer);
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
-- Specify the replication working directory.
SET @directory = N'\\' + $(DistPubServer) + '\repldata';
-- Specify the publication database.
SET @publicationDB = N'AdventureWorks2022';
-- Install the server MYDISTPUB as a Distributor using the defaults,
-- including autogenerating the distributor password.
USE master
EXEC sp_adddistributor @distributor = @distributor;
-- Create a new distribution database using the defaults, including
-- using Windows Authentication.
USE master
EXEC sp_adddistributiondb @database = @distributionDB,
@security_mode = 1;
GO
-- Create a Publisher and enable AdventureWorks2022 for replication.
-- Add MYDISTPUB as a publisher with MYDISTPUB as a local distributor
-- and use Windows Authentication.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
USE [distribution]
EXEC sp_adddistpublisher @publisher=@publisher,
@distribution_db=@distributionDB,
@security_mode = 1;
GO
사용 권한
sysadmin 고정 서버 역할의 멤버만 실행할 sp_adddistpublisher수 있습니다.