sp_adddistributor (Transact-SQL)

[アーティクル]
12/15/2008

sys.sysservers テーブル内にエントリがない場合、エントリを作成し、そのサーバーエントリにディストリビュータのマークを付けて、プロパティ情報を格納します。このストアドプロシージャは、ディストリビュータ側で master データベースについて実行され、サーバーをディストリビュータとして登録し、サーバーにディストリビュータのマークを付けます。リモートディストリビュータの場合、このストアドプロシージャは、master データベースからパブリッシャ側でも実行され、リモートディストリビュータを登録します。

トピックリンクアイコン Transact-SQL 構文表記規則

構文

sp_adddistributor [ @distributor= ] 'distributor' 
    [ , [ @heartbeat_interval= ] heartbeat_interval ] 
    [ , [ @password= ] 'password' ] 
    [ , [ @from_scripting= ] from_scripting ]

引数

[ @distributor=] 'distributor'
ディストリビューションサーバー名です。distributor は sysname であり、既定値はありません。このパラメータは、リモートディストリビュータを設定する場合にのみ使用します。このパラメータは、msdb..MSdistributor テーブルにディストリビュータプロパティのエントリを追加します。

[ @heartbeat_interval=] heartbeat_interval
エージェントが進捗状況を示すメッセージをログに記録しなくてもよい最大時間を分単位で示します。heartbeat_interval は int であり、既定値は 10 分です。この間隔で実行され、実行中のレプリケーションエージェントの状態を確認する SQL Server エージェントジョブが作成されます。

[ @password=] 'password']
distributor_admin ログインのパスワードです。password は sysname であり、既定値は NULL です。NULL または空の文字列である場合、パスワードはランダムな値に再設定されます。パスワードは最初のリモートディストリビュータを追加するときに構成する必要があります。distributor_admin ログインと password は、ローカル接続を含む distributor の RPC 接続に使用されるリンクサーバーエントリ用に格納されます。distributor がローカルの場合、distributor_admin のパスワードは新しい値に設定されます。リモートディストリビュータを持つパブリッシャの場合、パブリッシャとディストリビュータの両方で sp_adddistributor を実行するときに、password に同じ値を指定する必要があります。sp_changedistributor_password を使用すると、ディストリビュータのパスワードを変更できます。

セキュリティメモ :
可能であれば、実行時にセキュリティ資格情報の入力を求めるメッセージをユーザーに対して表示します。スクリプトファイルに資格情報を格納する場合は、不正アクセスを防ぐために、そのファイルをセキュリティで保護する必要があります。

[ @from_scripting= ] from_scripting
内部使用のみです。

解説

sp_adddistributor は、スナップショットレプリケーション、トランザクションレプリケーション、およびマージレプリケーションで使用します。

権限

sp_adddistributor を実行できるのは、固定サーバーロール sysadmin のメンバだけです。

戻り値

成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。

使用例

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

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

参照

その他の技術情報

パブリッシングとディストリビューションを構成する方法 (レプリケーション Transact-SQL プログラミング)
ディストリビューションの構成

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

次の方法で共有

sp_adddistributor (Transact-SQL)

構文

引数

解説

権限

戻り値

使用例

参照

関連項目

その他の技術情報

ヘルプおよび情報

その他のリソース