sp_adddistpublisher (Transact-SQL)

  • Статья

Настраивает издатель для использования указанной базы данных распространителя. Эта хранимая процедура выполняется на распространителе в любой базе данных. Имейте в виду, что до запуска этой хранимой процедуры необходимо выполнить хранимые процедуры sp_adddistributor (Transact-SQL) и sp_adddistributiondb (Transact-SQL).

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sp_adddistpublisher [ @publisher= ] 'publisher'  
        , [ @distribution_db= ] 'distribution_db' 
    [ , [ @security_mode= ] security_mode ] 
    [ , [ @login= ] 'login' ] 
    [ , [ @password= ] 'password' ] 
    [ , [ @working_directory= ] 'working_directory' ] 
    [ , [ @trusted= ] 'trusted' ] 
    [ , [ @encrypted_password= ] encrypted_password ] 
    [ , [ @thirdparty_flag = ] thirdparty_flag ]
    [ , [ @publisher_type = ] 'publisher_type' ]

Аргументы

  • [ @publisher=] 'publisher'
    Имя издателя. Аргумент publisher имеет тип sysname и не имеет значения по умолчанию.

  • [ @distribution_db=] 'distribution_db'
    Имя базы данных распространителя. Аргумент distributor_db имеет тип sysname и не имеет значения по умолчанию. Он используется агентами репликации для подключения к издателю.

  • [ @security_mode=] security_mode
    Реализованный режим обеспечения безопасности. Этот параметр используется только агентами репликации для подключения к издателю обновляемых посредством очередей подписок или к издателю, не являющемуся SQL Server. Аргумент security_mode имеет тип int и может принимать одно из следующих значений.

    Значение

    Описание

    0

    Агенты репликации на распространителе используют для подключения к издателю проверку подлинности SQL Server.

    1 (по умолчанию)

    Агенты репликации на распространителе используют для подключения к издателю проверку подлинности Windows.

  • [ @login=] 'login'
    Имя входа. Параметр является обязательным, если аргумент security_mode имеет значение 0. Аргумент login имеет тип sysname и значение по умолчанию NULL. Он используется агентами репликации для подключения к издателю.

  • [ @password=] 'password']
    Пароль. Аргумент password имеет тип sysname и значение по умолчанию NULL. Он используется агентами репликации для подключения к издателю.

    Примечание по безопасностиПримечание по безопасности

    Не используйте пустые пароли. Выбирайте надежные пароли.

  • [ @working_directory=] 'working_directory'
    Имя рабочего каталога, используемого для хранения файлов данных и схем для публикации. Аргумент working_directory имеет тип nvarchar(255) и соответствует по умолчанию папке ReplData текущего экземпляра SQL Server — например «C:\Program Files\Microsoft SQL Server\MSSQL\MSSQ.1\ReplData». Имя должно быть задано в формате UNC.

  • [ @trusted=] 'trusted'
    Этот параметр устарел и поддерживается только для обеспечения обратной совместимости. Аргумент trusted имеет тип nvarchar(5) и может иметь только значение false. При любом другом значении возникает ошибка.

  • [ @encrypted_password=] encrypted_password
    Аргумент encrypted_password больше не поддерживается. Попытка присвоить этому аргументу типа bit значение 1 приведет к ошибке.

  • [ @thirdparty_flag =] thirdparty_flag
    Этот аргумент показывает, является ли SQL Server издателем. Аргумент thirdparty_flag имеет тип bit и может принимать одно из следующих значений.

    Значение

    Описание

    0 (по умолчанию)

    База данных SQL Server.

    1

    База данных, отличная от базы данных SQL Server.

  • [ @publisher_type= ] 'publisher_type'
    Указывает тип издателя, если издатель не является SQL Server. Аргумент publisher_type имеет тип sysname и может принимать одно из следующих значений.

    Значение

    Описание

    MSSQLSERVER 

    (по умолчанию)

    Используется издатель SQL Server.

    ORACLE

    Задает стандартный издатель Oracle.

    ORACLE GATEWAY

    Используется издатель Oracle Gateway.

    Дополнительные сведения о различиях между издателями Oracle и Oracle Gateway см. в разделе Настройка издателя Oracle.

Значения кодов возврата

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'AdventureWorks2012'; 

-- 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 AdventureWorks2012 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

Разрешения

Хранимую процедуру sp_adddistpublisher могут выполнять только члены предопределенной роли сервера sysadmin.

См. также

Справочник

sp_changedistpublisher (Transact-SQL)

sp_dropdistpublisher (Transact-SQL)

Хранимая процедура sp_helpdistpublisher (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)

Основные понятия

Настройка публикации и распространения

Настройка распространителя