パブリケーションの作成

[アーティクル]
09/25/2024

適用対象: SQL Server Azure SQL Managed Instance

このアーティクルは、SQL Server Management Studio、Transact-SQL、またはレプリケーション管理オブジェクト (RMO) を使用して SQL Server のパブリケーションを作成する方法について説明します。

制限事項と制約事項

パブリケーション名およびアーティクル名には、 %、 *、 [、 ]、 |、 :、 "、 ?、 '、 \、 /、 <、または >を使用できません。データベースのオブジェクトにこれらの文字が含まれ、これらをレプリケートする場合は、[アーティクルのプロパティ - <アーティクル> ダイアログボックスで、オブジェクト名と異なるアーティクル名を指定する必要があります。このダイアログボックスは、ウィザードの [アーティクル] ページより利用可能です。

セキュリティ

可能であれば、実行時、ユーザーに対してセキュリティ資格情報の入力を要求します。資格情報を保存する必要がある場合は、Microsoft Windows .NET Framework に用意されている暗号化サービスを使用します。

SQL Server Management Studio を使用します。

パブリケーションの新規作成ウィザードにより、パブリケーションを作成し、アーティクルを定義します。パブリケーションを作成したら、[パブリケーションのプロパティ - <パブリケーション]> ダイアログボックスでパブリケーションのプロパティを表示および変更します。 Oracle データベースからパブリケーションを作成する方法については、「Create a Publication from an Oracle Database」(Oracle データベースからパブリケーションを作成する) をご覧ください。

パブリケーションを作成し、アーティクルを定義する

Microsoft SQL Server Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを右クリックします。
[新しいパブリケーション] を選択します。
パブリケーションの新規作成ウィザードのページに従い、以下の操作を実行します。
- サーバーでディストリビューションが構成されていない場合は、ディストリビューターを指定します。ディストリビューションの構成の詳細については、「Configure Publishing and Distribution」(パブリッシュとディストリビューションの構成) をご覧ください。
  
  [ディストリビューター] ページで、パブリッシャーサーバーが独自のディストリビューター (ローカルディストリビューター) として機能するように指定した場合、このサーバーはディストリビューターとして構成されていないため、パブリケーションの新規作成ウィザードでサーバーを構成します。 [スナップショットフォルダー] ページで、ディストリビューターの既定のスナップショットフォルダーを指定します。スナップショットフォルダーは、共有として指定したディレクトリです。このフォルダーの読み取りと書き込みをするエージェントには、このフォルダーへのアクセスを可能にする十分な権限が必要です。フォルダーの適切なセキュリティ保護の詳細については、「Secure the Snapshot Folder」(スナップショットフォルダーのセキュリティ保護) をご覧ください。
  
  別のサーバーがディストリビューターとして機能するように指定する場合は、パブリッシャーからディストリビューターへの接続のため、 [管理パスワード] ページでパスワードを入力する必要があります。このパスワードは、リモートディストリビューターでパブリッシャーを有効にしたときに指定したパスワードと一致する必要があります。
  
  詳しくは、「 Configure Distribution」を参照してください。
- パブリケーションデータベースを選択します。
- パブリケーションの種類を選択します。詳細については、「Types of Replication」(レプリケーションの種類) をご覧ください。
- パブリッシュするデータおよびデータベースオブジェクトを指定します。必要に応じて、テーブルアーティクルから列をフィルター選択し、アーティクルのプロパティを設定します。
- 必要に応じて、テーブルアーティクルから行をフィルター選択します。詳細については、「パブリッシュされたデータのフィルター選択」を参照してください。
- スナップショットエージェントのスケジュールを設定します。
- 以下のレプリケーションエージェントの実行および接続に使用される資格情報を指定します。
  - すべてのパブリケーション用のスナップショットエージェント。
  - すべてのトランザクショナルパブリケーション用のログリーダーエージェント。
  - 更新サブスクリプションを許可するトランザクショナルパブリケーションのキューリーダーエージェント。
    
    詳細については、「 Replication Agent Security Model 」および「 Replication Security Best Practices」を参照してください。
- 必要に応じて、パブリケーションのスクリプトを作成します。詳細については、「レプリケーションのスクリプト作成」を参照してください。
- パブリケーションの名前を指定します。

Transact-SQL の使用

パブリケーションは、レプリケーションのストアドプロシージャを使用してプログラムから作成できます。どのストアドプロシージャを使用するかは、作成するパブリケーションの種類によって異なります。

スナップショットパブリケーションまたはトランザクショナルパブリケーションを作成するには

パブリッシャーのパブリケーションデータベースで sp_replicationdboption (Transact-SQL) を実行し、スナップショットレプリケーションまたはトランザクションレプリケーションを使用して現在のデータベースのパブリケーションを有効にします。
トランザクションパブリケーションの場合は、パブリケーションデータベースのログリーダーエージェントジョブが存在するかどうかを確認します。 (スナップショットパブリケーションの場合、この手順は不要です。)
- パブリケーションデータベースのログリーダーエージェントジョブが存在する場合は、手順 3. に進みます。
- パブリッシュされたデータベース用のログリーダーエージェントジョブが存在するかどうかわからない場合は、パブリッシャー側のパブリケーションデータベースに対して sp_helplogreader_agent (Transact-SQL) を実行します。
- 結果セットが空の場合は、ログリーダーエージェントジョブを作成します。パブリッシャーで、sp_addlogreader_agent (Transact-SQL) を実行します。エージェントの実行に使用される Microsoft Windows 資格情報を @job_name と @passwordを使用して、トランザクションパブリケーションに対するサブスクリプションの更新を有効にする方法について説明します。エージェントがパブリッシャーに接続する際に SQL Server 認証を使用する場合、さらに @publisher_security_mode に 0 の値を指定し、 @publisher_login と @publisher_password のSQL Server ログイン情報を指定してください。手順 3. に進みます。
パブリッシャーで、sp_addpublication (Transact-SQL) を実行します。 @publication にパブリケーション名を指定し、@repl_freq パラメーターを指定し、snapshot (スナップショットパブリケーションの場合)の snapshot または continuous (トランザクションパブリケーションの場合)の continuous の値を指定します。必要に応じて、その他のパブリケーションオプションを指定してください。これにより、パブリケーションが定義されます。

Note

パブリケーション名に、次の文字を含めることはできません。

%、*、[、]、|、:、"、?、\、/、<、または >。
パブリッシャーで sp_addpublication_snapshot (Transact-SQL) を実行します。手順 3. で使用したパブリケーション名を @publication に指定し、スナップショットエージェントを実行するときに使用される Windows 資格情報を @snapshot_job_name と @passwordを使用して、トランザクションパブリケーションに対するサブスクリプションの更新を有効にする方法について説明します。エージェントがパブリッシャーに接続する際に SQL Server 認証を使用する場合、さらに @publisher_security_mode に 0 の値を指定し、 @publisher_login と publisher_password のSQL Server ログイン情報を指定してください。これにより、パブリケーション用のスナップショットエージェントジョブが作成されます。

重要

リモートディストリビューターを使用するパブリッシャーを構成する場合は、 job_login および job_passwordを含むすべてのパラメーターに指定された値がディストリビューターにプレーンテキストとして送信されます。このストアドプロシージャを実行する前に、パブリッシャーとリモートディストリビューターの間の接続を暗号化する必要があります。詳細については、「データベースエンジンへの暗号化接続の有効化 (SQL Server 構成マネージャー)」を参照してください。
パブリケーションにアーティクルを追加します。詳しくは、「アーティクルを定義」をご覧ください。
スナップショットエージェントジョブを起動して、このパブリケーションの初期スナップショットを生成します。詳しくは、「初期スナップショットの作成および適用」をご覧ください。

統合パブリケーションを作成するには

パブリッシャーで sp_replicationdboption (Transact-SQL) を実行し、マージレプリケーションを使用して現在のデータベースのパブリケーションを有効にします。
パブリッシャー側のパブリケーションデータベースに対して、sp_addmergepublication (Transact-SQL) を実行します。 @publication にパブリケーションの名前を指定し、必要に応じて他のパブリケーションオプションを指定します。これにより、パブリケーションが定義されます。

Note

パブリケーション名に、次の文字を含めることはできません。

%、*、[、]、|、:、"、?、\、/、<、または >。
パブリッシャーで sp_addpublication_snapshot (Transact-SQL) を実行します。手順 2. で使用したパブリケーション名を @publication に指定し、スナップショットエージェントを実行するときに使用される Windows 資格情報を @snapshot_job_name と @passwordを使用して、トランザクションパブリケーションに対するサブスクリプションの更新を有効にする方法について説明します。エージェントがパブリッシャーに接続する際に SQL Server 認証を使用する場合、さらに @publisher_security_mode に 0 の値を指定し、 @publisher_login と @publisher_password のSQL Server ログイン情報を指定してください。これにより、パブリケーション用のスナップショットエージェントジョブが作成されます。

重要

リモートディストリビューターを使用するパブリッシャーを構成する場合は、 job_login および job_passwordを含むすべてのパラメーターに指定された値がディストリビューターにプレーンテキストとして送信されます。このストアドプロシージャを実行する前に、パブリッシャーとリモートディストリビューターの間の接続を暗号化する必要があります。詳細については、「データベースエンジンへの暗号化接続の有効化 (SQL Server 構成マネージャー)」を参照してください。
パブリケーションにアーティクルを追加します。詳しくは、「アーティクルを定義」をご覧ください。
スナップショットエージェントジョブを起動して、このパブリケーションの初期スナップショットを生成します。詳しくは、「初期スナップショットの作成および適用」をご覧ください。

例 (Transact-SQL)

この例では、トランザクションパブリケーションを作成します。スナップショットエージェントジョブおよびログリーダーエージェントジョブの作成に必要な Windows 資格情報は、スクリプト変数を使用して渡しています。

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. 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".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks'; 
SET @publication = N'AdvWorksProductTran'; 
-- Windows account used to run the Log Reader and Snapshot Agents.
SET @login = $(Login); 
-- This should be passed at runtime.
SET @password = $(Password); 

-- Enable transactional or snapshot replication on the publication database.
EXEC sp_replicationdboption 
    @dbname=@publicationDB, 
    @optname=N'publish',
    @value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;

-- Create a new transactional publication with the required properties. 
EXEC sp_addpublication 
    @publication = @publication, 
    @status = N'active',
    @allow_push = N'true',
    @allow_pull = N'true',
    @independent_agent = N'true';

-- Create a new snapshot job for the publication, using a default schedule.
EXEC sp_addpublication_snapshot 
    @publication = @publication, 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;
GO

この例では、マージパブリケーションを作成します。スナップショットエージェントジョブの作成に必要な Windows 資格情報は、スクリプト変数を使用して渡しています。

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. 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".

--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2022'; 
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @login = $(Login);
SET @password = $(Password);

-- Enable merge replication on the publication database, using defaults.
USE master
EXEC sp_replicationdboption 
  @dbname=@publicationDB, 
  @optname=N'merge publish',
  @value = N'true' 

-- Create a new merge publication, explicitly setting the defaults. 
USE [AdventureWorks2022]
EXEC sp_addmergepublication 
-- These parameters are optional.
  @publication = @publication,
  -- optional parameters 
  @description = N'Merge publication of AdventureWorks2022.',
  @publication_compatibility_level  = N'120RTM';

-- Create a new snapshot job for the publication.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = @login, 
  @job_password = @password;
GO

レプリケーション管理オブジェクト (RMO) の使用

レプリケーション管理オブジェクト (RMO) を使用することで、プログラムによってパブリケーションを作成できます。パブリケーションの作成に使用する RMO クラスは、作成するパブリケーションの種類によって異なります。

スナップショットパブリケーションまたはトランザクショナルパブリケーションを作成するには

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
パブリケーションデータベースに ReplicationDatabase クラスのインスタンスを作成するには、 ConnectionContext プロパティに手順 1. の ServerConnection インスタンスを設定し、 LoadProperties メソッドを呼び出します。 LoadProperties が false を返す場合、データベースが存在するかどうか確認してください。
EnabledTransPublishing プロパティが false の場合、これを true に設定します。
トランザクションパブリケーションの場合は、LogReaderAgentExists プロパティの値を確認します。このプロパティが true の場合、このデータベースに対するログリーダーエージェントジョブが既に存在しています。このプロパティが false の場合、次の操作を実行してください。
- LogReaderAgentProcessSecurity の Login フィールドおよび Password フィールドを設定して、ログリーダーエージェントを実行するときに使用される Microsoft Windows アカウントの資格情報を指定します。
  
  Note
  
  パブリケーションが sysadmin 固定サーバーロールのメンバーにより作成される場合、LogReaderAgentProcessSecurity の設定は不要です。この場合、エージェントは SQL Server エージェントのアカウントを借用します。詳細については、「レプリケーションエージェントセキュリティモデル」を参照してください。
- (省略可) SQL Server 認証を使用してパブリッシャーに接続する場合、 SqlStandardLogin の SqlStandardPassword フィールドおよび SecureSqlStandardPassword (または LogReaderAgentPublisherSecurity ) フィールドを設定します。
- CreateLogReaderAgent メソッドを呼び出して、データベースに対するログリーダーエージェントジョブを作成します。
TransPublication クラスのインスタンスを作成し、このオブジェクトに次のプロパティを設定します。
- 手順 1. の ServerConnection を ConnectionContextに指定します。
- パブリッシュするデータベースの名前を DatabaseNameに指定します。
- Nameにパブリケーションの名前を指定します。
- Transactional か SnapshotのいずれかのType (型 PublicationType である)。
- SnapshotGenerationAgentProcessSecurity の Login フィールドおよび Password フィールドに、スナップショットエージェントの実行に使用する Windows アカウントの資格情報を指定します。このアカウントは、Windows 認証を使用している場合に、スナップショットエージェントがローカルディストリビューターへの接続や任意のリモート接続を行うときにも使用されます。
  
  Note
  
  パブリケーションが sysadmin 固定サーバーロールのメンバーにより作成される場合、SnapshotGenerationAgentProcessSecurity の設定は不要です。この場合、エージェントは SQL Server エージェントのアカウントを借用します。詳細については、「レプリケーションエージェントセキュリティモデル」を参照してください。
- (省略可) SQL Server 認証を使用してパブリッシャーに接続する場合、 SqlStandardLogin の SqlStandardPassword フィールドおよび SecureSqlStandardPassword (または SnapshotGenerationAgentPublisherSecurity ) フィールドを設定します。
- (省略可) 包括的論理和演算子 (Visual C# では |、Visual Basic では Or) および排他的論理和演算子 (Visual C# では ^、Visual Basic では Xor) を使用して、PublicationAttributes プロパティに Attributes の値を設定します。
- (省略可) パブリッシャーが SQL Server パブリッシャーでない場合、パブリッシャーの名前を PublisherName に指定します。
Create メソッドを呼び出して、パブリケーションを作成します。

重要

リモートディストリビューターを使用するパブリッシャーを構成する場合は、 SnapshotGenerationAgentProcessSecurityを含むすべてのプロパティに指定された値がディストリビューターにプレーンテキストとして送信されます。 Create メソッドを呼び出す前に、パブリッシャーとリモートディストリビューター間の接続を暗号化する必要があります。詳細については、「データベースエンジンへの暗号化接続の有効化 (SQL Server 構成マネージャー)」を参照してください。
CreateSnapshotAgent メソッドを呼び出して、パブリケーションに対するスナップショットエージェントジョブを作成します。

統合パブリケーションを作成するには

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
パブリケーションデータベースに ReplicationDatabase クラスのインスタンスを作成するには、 ConnectionContext プロパティに手順 1. の ServerConnection インスタンスを設定し、 LoadProperties メソッドを呼び出します。 LoadProperties が false を返す場合、データベースが存在するかどうか確認してください。
EnabledMergePublishing プロパティが false の場合、このプロパティを true に設定し、CommitPropertyChanges を呼び出します。
MergePublication クラスのインスタンスを作成し、このオブジェクトに次のプロパティを設定します。
- 手順 1. の ServerConnection を ConnectionContextに指定します。
- パブリッシュするデータベースの名前を DatabaseNameに指定します。
- Nameにパブリケーションの名前を指定します。
- SnapshotGenerationAgentProcessSecurity の Login フィールドおよび Password フィールドに、スナップショットエージェントの実行に使用する Windows アカウントの資格情報を指定します。このアカウントは、Windows 認証を使用している場合に、スナップショットエージェントがローカルディストリビューターへの接続や任意のリモート接続を行うときにも使用されます。
  
  Note
  
  パブリケーションが sysadmin 固定サーバーロールのメンバーにより作成される場合、SnapshotGenerationAgentProcessSecurity の設定は不要です。詳細については、「レプリケーションエージェントセキュリティモデル」を参照してください。
- (省略可) 包括的論理和演算子 (Visual C# では |、Visual Basic では Or) および排他的論理和演算子 (Visual C# では ^、Visual Basic では Xor) を使用して、PublicationAttributes プロパティに Attributes の値を設定します。
Create メソッドを呼び出して、パブリケーションを作成します。

重要

リモートディストリビューターを使用するパブリッシャーを構成する場合は、 SnapshotGenerationAgentProcessSecurityを含むすべてのプロパティに指定された値がディストリビューターにプレーンテキストとして送信されます。 Create メソッドを呼び出す前に、パブリッシャーとリモートディストリビューター間の接続を暗号化する必要があります。詳細については、「データベースエンジンへの暗号化接続の有効化 (SQL Server 構成マネージャー)」を参照してください。
CreateSnapshotAgent メソッドを呼び出して、パブリケーションに対するスナップショットエージェントジョブを作成します。

例 (RMO)

次の例では、AdventureWorks データベースでトランザクションパブリッシュを有効にして、ログリーダーエージェントジョブを定義し、AdvWorksProductTran パブリケーションを作成します。このパブリケーションには、アーティクルを定義する必要があります。ログリーダーエージェントジョブとスナップショットエージェントジョブの作成に必要な Windows アカウントの資格情報は、実行時に渡されます。 RMO を使用してスナップショットアーティクルとトランザクションアーティクルを定義する方法については、「 Define an Article」を参照してください。

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2022";
string publisherName = publisherInstance;

ReplicationDatabase publicationDb;
TransPublication publication;

// Create a connection to the Publisher using Windows Authentication.
ServerConnection conn;
conn = new ServerConnection(publisherName);


try
{
    // Connect to the Publisher.
    conn.Connect();

    // Enable the AdventureWorks2022 database for transactional publishing.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);

    // If the database exists and is not already enabled, 
    // enable it for transactional publishing.
    if (publicationDb.LoadProperties())
    {
        if (!publicationDb.EnabledTransPublishing)
        {
            publicationDb.EnabledTransPublishing = true;
        }

        // If the Log Reader Agent does not exist, create it.
        if (!publicationDb.LogReaderAgentExists)
        {
            // Specify the Windows account under which the agent job runs.
            // This account will be used for the local connection to the 
            // Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin;
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword;

            // Explicitly set authentication mode for the Publisher connection
            // to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = true;

            // Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent();
        }
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The {0} database does not exist at {1}.",
            publicationDb, publisherName));
    }

    // Set the required properties for the transactional publication.
    publication = new TransPublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    // Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional;

    // Activate the publication so that we can add subscriptions.
    publication.Status = State.Active;

    // Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes |= PublicationAttributes.AllowPull;
    publication.Attributes |= PublicationAttributes.AllowPush;
    publication.Attributes |= PublicationAttributes.IndependentAgent;

    // Specify the Windows account under which the Snapshot Agent job runs.
    // This account will be used for the local connection to the 
    // Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

    // Explicitly set the security mode for the Publisher connection
    // Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

    if (!publication.IsExistingObject)
    {
        // Create the transactional publication.
        publication.Create();

        // Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The {0} publication already exists.", publicationName));
    }
}

catch (Exception ex)
{
    // Implement custom application error handling here.
    throw new ApplicationException(String.Format(
        "The publication {0} could not be created.", publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"
Dim publisherName As String = publisherInstance

Dim publicationDb As ReplicationDatabase
Dim publication As TransPublication

' Create a connection to the Publisher using Windows Authentication.
Dim conn As ServerConnection
conn = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Enable the AdventureWorks2022 database for transactional publishing.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    ' If the database exists and is not already enabled, 
    ' enable it for transactional publishing.
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = True
        End If

        ' If the Log Reader Agent does not exist, create it.
        If Not publicationDb.LogReaderAgentExists Then
            ' Specify the Windows account under which the agent job runs.
            ' This account will be used for the local connection to the 
            ' Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword

            ' Explicitly set authentication mode for the Publisher connection
            ' to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = True

            ' Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent()
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist at {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the transactional publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional

    'Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPull
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPush
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.IndependentAgent

    ' Activate the publication so that we can add subscriptions.
    publication.Status = State.Active

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    If Not publication.IsExistingObject Then
        ' Create the transactional publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

次の例では、AdventureWorks データベースでマージパブリッシュを有効にし、AdvWorksSalesOrdersMerge パブリケーションを作成します。このパブリケーションには、アーティクルを定義する必要があります。スナップショットエージェントジョブの作成に必要な Windows アカウントの資格情報は、実行時に渡されます。 RMO を使用してマージアーティクルを定義する方法については、「 Define an Article」を参照してください。

// Set the Publisher, publication database, and publication names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2022";

ReplicationDatabase publicationDb;
MergePublication publication;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Enable the database for merge publication.				
    publicationDb = new ReplicationDatabase(publicationDbName, conn);
    if (publicationDb.LoadProperties())
    {
        if (!publicationDb.EnabledMergePublishing)
        {
            publicationDb.EnabledMergePublishing = true;
        }
    }
    else
    {
        // Do something here if the database does not exist. 
        throw new ApplicationException(String.Format(
            "The {0} database does not exist on {1}.",
            publicationDb, publisherName));
    }

    // Set the required properties for the merge publication.
    publication = new MergePublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    // Enable precomputed partitions.
    publication.PartitionGroupsOption = PartitionGroupsOption.True;

    // Specify the Windows account under which the Snapshot Agent job runs.
    // This account will be used for the local connection to the 
    // Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

    // Explicitly set the security mode for the Publisher connection
    // Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

    // Enable Subscribers to request snapshot generation and filtering.
    publication.Attributes |= PublicationAttributes.AllowSubscriberInitiatedSnapshot;
    publication.Attributes |= PublicationAttributes.DynamicFilters;

    // Enable pull and push subscriptions.
    publication.Attributes |= PublicationAttributes.AllowPull;
    publication.Attributes |= PublicationAttributes.AllowPush;

    if (!publication.IsExistingObject)
    {
        // Create the merge publication.
        publication.Create();
        
        // Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The {0} publication already exists.", publicationName));
    }
}

catch (Exception ex)
{
    // Implement custom application error handling here.
    throw new ApplicationException(String.Format(
        "The publication {0} could not be created.", publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Set the Publisher, publication database, and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2022"

Dim publicationDb As ReplicationDatabase
Dim publication As MergePublication

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Enable the database for merge publication.				
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = True
        End If
    Else
        ' Do something here if the database does not exist. 
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist on {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the merge publication.
    publication = New MergePublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Enable precomputed partitions.
    publication.PartitionGroupsOption = PartitionGroupsOption.True

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    ' Enable Subscribers to request snapshot generation and filtering.
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowSubscriberInitiatedSnapshot
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.DynamicFilters

    ' Enable pull and push subscriptions
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPull
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPush

    If Not publication.IsExistingObject Then
        ' Create the merge publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

次の方法で共有

パブリケーションの作成

制限事項と制約事項

セキュリティ

SQL Server Management Studio を使用します。

パブリケーションを作成し、アーティクルを定義する

Transact-SQL の使用

スナップショットパブリケーションまたはトランザクショナルパブリケーションを作成するには

統合パブリケーションを作成するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショットパブリケーションまたはトランザクショナルパブリケーションを作成するには

統合パブリケーションを作成するには

例 (RMO)

フィードバック

その他のリソース

次の方法で共有

パブリケーションの作成

制限事項と制約事項

セキュリティ

SQL Server Management Studio を使用します。

パブリケーションを作成し、アーティクルを定義する

Transact-SQL の使用

スナップショット パブリケーションまたはトランザクショナル パブリケーションを作成するには

統合 パブリケーションを作成するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショット パブリケーションまたはトランザクショナル パブリケーションを作成するには

統合 パブリケーションを作成するには

例 (RMO)

関連するコンテンツ

フィードバック

その他のリソース

スナップショットパブリケーションまたはトランザクショナルパブリケーションを作成するには

統合パブリケーションを作成するには

スナップショットパブリケーションまたはトランザクショナルパブリケーションを作成するには

統合パブリケーションを作成するには