sp_adddistributiondb (Transact-SQL)
创建新的分发数据库并安装分发服务器架构。 分发数据库存储过程、架构以及用于复制的元数据。 此存储过程在数据库的分发服务器上 master 执行，以便创建分发数据库，并安装启用复制分发所需的表和存储过程。
语法
sp_adddistributiondb
[ @database = ] N'database'
[ , [ @data_folder = ] N'data_folder' ]
[ , [ @data_file = ] N'data_file' ]
[ , [ @data_file_size = ] data_file_size ]
[ , [ @log_folder = ] N'log_folder' ]
[ , [ @log_file = ] N'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 = ] N'login' ]
[ , [ @password = ] N'password' ]
[ , [ @createmode = ] createmode ]
[ , [ @from_scripting = ] from_scripting ]
[ , [ @deletebatchsize_xact = ] deletebatchsize_xact ]
[ , [ @deletebatchsize_cmd = ] deletebatchsize_cmd ]
[ ; ]
参数
[ @database = ] N'database'
要创建的分发数据库的名称。 @database 为 sysname，无默认值。 如果指定的数据库已存在且尚未标记为分发数据库，则安装启用分发所需的对象，并将该数据库标记为分发数据库。 如果指定的数据库已经作为分发数据库启用，则返回错误。
[ @data_folder = ] N'data_folder'
用于存储分发数据库数据文件的目录的名称。 @data_folder为 nvarchar（255），默认值为 NULL. 如果 NULL使用该 SQL Server 实例的数据目录， C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\Data例如。
[ @data_file = ] N'data_file'
数据库文件的名称。 @data_file为 nvarchar（255），默认值为 NULL. 如果 NULL，存储过程使用数据库名称构造文件名。
[ @data_file_size = ] data_file_size
初始数据文件大小（MB）。 @data_file_size为 int，默认值5为 5 MB。
[ @log_folder = ] N'log_folder'
数据库日志文件的目录的名称。 @log_folder为 nvarchar（255），默认值为 NULL. 如果使用 NULLSQL Server 实例的数据目录（例如 C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\Data）。
[ @log_file = ] N'log_file'
日志文件名。 @log_file为 nvarchar（255），默认值为 NULL. 如果 NULL，存储过程使用数据库名称构造文件名。
[ @log_file_size = ] log_file_size
初始日志文件大小（MB）。 @log_file_size为 int，默认值0为 ，它使用数据库引擎允许的最小日志文件大小创建文件。
[ @min_distretention = ] min_distretention
从分发数据库中删除事务之前，最短保持期（以小时为单位）。 @min_distretention为 int，默认值为 0.
[ @max_distretention = ] max_distretention
事务被删除前的最大保持期（小时）。 @max_distretention为 int，默认值为 72. 未收到复制命令且早于最大分发保留期的订阅被标记为非活动，需要重新初始化。 为每个非活动订阅颁发错误号 21011。 0值意味着复制的事务不会存储在分发数据库中。
[ @history_retention = ] history_retention
保留历史记录的小时数。 @history_retention为 int，默认值48为 2 天。
[ @security_mode = ] security_mode
连接到分发服务器时要使用的安全模式。 @security_mode为 int，默认值为 1.
0指定 SQL Server 身份验证1指定Windows 身份验证
[ @login = ] N'login'
连接到分发服务器以创建分发数据库时使用的登录名。 @login为 sysname，默认值为 NULL. 如果@security_mode设置为0@login，则需要@login。
[ @password = ] N'password'
连接到分发服务器时使用的密码。 @password为 sysname，默认值为 NULL. 如果@security_mode设置为 0，则需要@password。
[ @createmode = ] createmode
@createmode为 int，可以是以下值之一。
| 值 | 说明 |
|---|---|
0 |
标识为仅供参考。 不支持。 不保证以后的兼容性。 |
1（默认值） |
CREATE DATABASE 或使用现有数据库，然后应用 instdist.sql 该文件在分发数据库中创建复制对象。 |
2 |
标识为仅供参考。 不支持。 不保证以后的兼容性。 |
[ @from_scripting = ] from_scripting
标识为仅供参考。 不支持。 不保证以后的兼容性。
[ @deletebatchsize_xact = ] deletebatchsize_xact
指定要在清理 MSRepl_Transactions 表中过期事务期间使用的批大小。 @deletebatchsize_xact为 int，默认值为 5000.
适用于： Service Pack 4、SQL Server 2016（13.x）和 Service Pack 2、SQL Server 2017（14.x）及更高版本 SQL Server 2012（14.x）。
[ @deletebatchsize_cmd = ] deletebatchsize_cmd
指定要在清理 MSRepl_Commands 表中过期命令期间使用的批大小。 @deletebatchsize_cmd为 int，默认值为 2000.
适用于： Service Pack 4、SQL Server 2016（13.x）和 Service Pack 2、SQL Server 2017（14.x）及更高版本 SQL Server 2012（14.x）。
返回代码值
0（成功）或 1（失败）。
注解
sp_adddistributiondb 用于所有类型的复制。 但是，此存储过程只在分发服务器上运行。
在执行之前sp_adddistributiondb，必须先执行sp_adddistributor来配置分发服务器。
在运行之前运行sp_adddistributorsp_adddistributiondb。
示例
此脚本使用 SQLCMD 脚本变量，必须在 SQLCMD 模式下运行。 变量采用格式 $(MyVariable)。 有关如何在命令行和 SQL Server Management Studio 中使用脚本变量的信息，请参阅 执行复制脚本。
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_adddistributiondb。