sp_adddistributiondb (Transact-SQL)

Создает новую базу данных распространителя и устанавливает схему Distributor. В базе данных распространителя хранятся процедуры, схема и метаданные, используемые при репликации. С помощью этой хранимой процедуры на стороне распространителя в базе данных master создается база данных распространителя и устанавливаются необходимые таблицы и хранимые процедуры, которые требуются для включения распространения репликации.

Синтаксические обозначения в Transact-SQL

Синтаксис

sp_adddistributiondb [ @database= ] 'database' 
    [ , [ @data_folder= ] 'data_folder' ] 
    [ , [ @data_file= ] 'data_file' ] 
    [ , [ @data_file_size= ] data_file_size ] 
    [ , [ @log_folder= ] 'log_folder' ] 
    [ , [ @log_file= ] 'log_file' ] 
    [ , [ @log_file_size= ] log_file_size ] 
    [ , [ @min_distretention= ] min_distretention ] 
    [ , [ @max_distretention= ] max_distretention ] 
    [ , [ @history_retention= ] history_retention ] 
    [ , [ @security_mode= ] security_mode ] 
    [ , [ @login= ] 'login' ] 
    [ , [ @password= ] 'password' ] 
    [ , [ @createmode= ] createmode ]
    [ , [ @from_scripting = ] from_scripting ]

Аргументы

• [@database=] database'
  Имя создаваемой базы данных распространителя. Аргумент database имеет тип sysname и не имеет значения по умолчанию. Если указанная база данных существует и не помечена как база данных распространителя, то устанавливаются объекты, необходимые для включения распространения, и база данных помечается как база данных распространителя. Если указанная база данных уже включена как база данных распространителя, то возвращается сообщение об ошибке.

• [@data_folder =] **'**data_folder'
  Имя каталога для хранения файла данных в базе данных распространителя. Аргумент data_folder имеет тип nvarchar(255) и значение по умолчанию NULL. Если аргумент имеет значение NULL, то используется каталог данных для текущего экземпляра Microsoft SQL Server (например, «C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Data»).

• [@data_file =] 'data_file'
  Имя файла базы данных. Аргумент data_file имеет тип nvarchar(255) и значение по умолчанию database. Если аргумент имеет значение NULL, хранимая процедура формирует имя файла, используя имя базы данных.

• [@data_file_size =] data_file_size
  Первоначальный размер файла данных в мегабайтах (Мб). Аргумент data_file_size i имеет тип int и значение по умолчанию 5 Мб.

• [@log_folder =] 'log_folder'
  Имя каталога для файла журнала базы данных. Аргумент log_folder имеет тип nvarchar(255) и значение по умолчанию NULL. Если аргумент имеет значение NULL, то используется каталог данных для текущего экземпляра SQL Server, например: «C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Data».

• [@log_file =] 'log_file'
  Имя файла журнала. Аргумент log_file имеет тип nvarchar(255) и значение по умолчанию NULL. Если аргумент имеет значение NULL, то хранимая процедура создает имя файла на основе имени базы данных.

• [@log_file_size =] log_file_size
  Начальный размер файла журнала в мегабайтах (Мб). Аргумент log_file_size имеет тип int и значение по умолчанию 0 Мб, то есть минимальный размер файла журнала, допустимый SQL Server.

• [@min_distretention =] min_distretention
  Минимальный срок хранения до удаления транзакций из базы данных распространителя (в часах). Аргумент min_distretention имеет тип int и значение по умолчанию 0 часов.

• [@max_distretention =] max_distretention
  Максимальный срок хранения до удаления транзакций (в часах). Аргумент max_distretention имеет тип int и значение по умолчанию 72 часа. Подписки, не получившие реплицируемые команды и хранящиеся дольше, чем позволяет значение максимального срока хранения, помечаются как неактивные; их необходимо повторно инициализировать. Для каждой неактивной подписки выполняется инструкция RAISERROR 21011. 0 означает, что реплицируемые транзакции не хранятся в базе данных распространителя.

• [@history_retention =] history_retention
  Время хранения журнала (в часах). Аргумент history_retention имеет тип int и значение по умолчанию 48 часов.

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

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

• [@password =] 'password'
  Пароль, используемый при подключении к распространителю. Является обязательным, если параметр security_mode имеет значение 0. Параметр password имеет тип sysname и значение по умолчанию NULL.

• [@createmode =] createmode
  Аргумент createmode имеет тип int и значение по умолчанию 1 и может принимать одно из следующих значений:

  Значение	Описание
  0	Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.
  1 (по умолчанию)	CREATE DATABASE или использование существующей базы данных и последующее применение файлов instdist.sql для создания объектов репликации в базе данных распространителя.
  2	Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

• [@from_scripting =] from_scripting
  Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

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

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Хранимая процедура sp_adddistributiondb используется при репликации любого типа. Однако эта хранимая процедура может выполняться только на стороне распространителя.

Перед запуском хранимой процедуры sp_adddistributiondb следует настроить распространителя с помощью хранимой процедуры sp_adddistributor.

Хранимую процедуру sp_adddistributor следует запускать до sp_adddistributiondb.

Пример

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

-- 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 AdventureWorks2008R2 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_adddistributiondb могут выполнять только члены предопределенной роли сервера sysadmin.

См. также

Задания

Как настроить публикацию и распространение (программирование репликации на языке Transact-SQL)

Справочник

sp_changedistributiondb (Transact-SQL)

sp_dropdistributiondb (Transact-SQL)

sp_helpdistributiondb (Transact-SQL)

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

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

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