sp_adddistributiondb (Transact-SQL)

[アーティクル]
12/22/2023

適用対象: SQL Server Azure SQL Managed Instance

新しいディストリビューションデータベースを作成し、ディストリビュータースキーマをインストールします。ディストリビューションデータベースには、レプリケーションで使用されるプロシージャ、スキーマ、およびメタデータが格納されます。このストアドプロシージャは、ディストリビューションデータベースを作成し、レプリケーションディストリビューションを有効にするために必要なテーブルとストアドプロシージャをインストールするために、データベースのディストリビューター master で実行されます。

Transact-SQL 構文表記規則

構文

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 で、既定値は 55 MB (メガバイト)です。

[ @log_folder = ] N'log_folder'

データベースログファイルのディレクトリの名前。 @log_folderは nvarchar(255) で、既定値は NULL. 場合NULLは、SQL 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 で、既定値は 482 日間を意味します。

[ @security_mode = ] security_mode

ディストリビューターに接続するときに使用するセキュリティモード。 @security_modeは int で、既定値は 1.

0 は SQL Server 認証を指定します
1Windows 認証を指定します

[ @login = ] N'login'

ディストリビューションデータベースを作成するためにディストリビューターに接続するときに使用されるログイン名。 @loginは sysname で、既定値は NULL. @security_modeがに0設定されている場合は、@loginが必要です。

[ @password = ] N'password'

ディストリビューターに接続するときに使用されるパスワード。 @passwordは sysname で、既定値は NULL. @security_modeがに設定0されている場合は、@passwordが必要です。

[ @createmode = ] createmode

@createmodeは int であり、次のいずれかの値を指定できます。

Value	説明
`0`	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。
`1` (既定値)	`CREATE DATABASE` または既存のデータベースを使用し、ファイルを `instdist.sql` 適用してディストリビューションデータベースにレプリケーションオブジェクトを作成します。
`2`	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。

[ @from_scripting = ] from_scripting

単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。

[ @deletebatchsize_xact = ] deletebatchsize_xact

テーブルから期限切れのトランザクションをクリーンアップする際に使用するバッチサイズをMSRepl_Transactions指定します。 @deletebatchsize_xactは int で、既定値は 5000.

適用対象: SQL Server 2012 (11.x) Service Pack 4、SQL Server 2016 (13.x) Service Pack 2、SQL Server 2017 (14.x)、およびそれ以降のバージョン。

[ @deletebatchsize_cmd = ] deletebatchsize_cmd

テーブルから期限切れのコマンドをクリーンに使用するバッチサイズをMSRepl_Commands指定します。 @deletebatchsize_cmdは int で、既定値は 2000.

適用対象: SQL Server 2012 (11.x) Service Pack 4、SQL Server 2016 (13.x) Service Pack 2、SQL Server 2017 (14.x)、およびそれ以降のバージョン。

リターンコードの値

0 (成功) または 1 (失敗)。

解説

sp_adddistributiondb は、すべての種類のレプリケーションで使用されます。ただし、このストアドプロシージャは、ディストリビューター側でのみ動作します。

を実行する前に、sp_adddistributorを実行してディストリビューターを構成するsp_adddistributiondb必要があります。

実行する前に実行 sp_adddistributor します sp_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できます。

sp_adddistributiondb (Transact-SQL)

構文

引数

[ @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

リターンコードの値

解説

例

アクセス許可

フィードバック

フィードバック

その他のリソース

sp_adddistributiondb (Transact-SQL)

構文

引数

[ @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

リターン コードの値

解説

例

アクセス許可

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

リターンコードの値