sp_adddistributiondb (Transact-SQL)

[アーティクル]
07/05/2024

適用対象: 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 で、既定値は 5 (5 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 で、既定値は 48 で、これは 2 日間を意味します。

[ @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_adddistributiondbを実行する前に、sp_adddistributorを実行してディストリビューターを構成する必要があります。

sp_adddistributiondbを実行する前に、sp_adddistributorを実行します。

例

このスクリプトは 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

リターン コードの値

解説

例

アクセス許可

関連するコンテンツ

フィードバック

その他のリソース

リターンコードの値