sp_changepublication (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

パブリケーションのプロパティを変更します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

Transact-SQL 構文表記規則

構文

sp_changepublication
    [ [ @publication = ] N'publication' ]
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

引数

[ @publication = ] N'publication'

出版物の名前。 @publication は sysname で、既定値は NULL です。

[ @property = ] N'property'

変更するパブリケーション プロパティ。 @property は nvarchar(255) で、既定値は NULL です。

[ @value = ] N'value'

新しいプロパティ値です。 @value は nvarchar(255) で、既定値は NULL です。

次の表に、変更可能なパブリケーションのプロパティと、プロパティの値に関する制限を示します。

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

このストアド プロシージャによって実行されたアクションによって、既存のスナップショットが無効になる可能性があることを確認します。 @force_invalidate_snapshot は ビットで、既定値は 0 です。

• 0 は、アーティクルに対する変更によってスナップショットが無効になることがないように指定します。 ストアド プロシージャが変更に新しいスナップショットが必要であることを検出した場合、エラーが発生し、変更は行われません。
• 1 は、アーティクルに対する変更によってスナップショットが無効になる可能性があることを指定します。 新しいスナップショットを必要とする既存のサブスクリプションがある場合、この値は、既存のスナップショットが古いスナップショットとしてマークされ、新しいスナップショットが生成される権限を与えます。

変更時に新しいスナップショットの生成が必要なプロパティについては、「 Remarks 」セクションを参照してください。

[ @force_reinit_subscription = ] force_reinit_subscription

このストアド プロシージャによって実行されるアクションで、既存のサブスクリプションの再初期化が必要になる可能性があることを確認します。 @force_reinit_subscription は bit で、既定値は 0 です。

• 0 は、アーティクルに対する変更によってサブスクリプションが再初期化されないように指定します。 変更によって既存のサブスクリプションの再初期化が必要であることがストアド プロシージャによって検出された場合、エラーが発生し、変更は行われません。
• 1 は、アーティクルに変更を加えて既存のサブスクリプションを再初期化し、サブスクリプションの再初期化を実行するためのアクセス許可を付与することを指定します。

[ @publisher = ] N'publisher'

SQL Server 以外のパブリッシャーを指定します。 @publisher は sysname で、既定値は NULL です。

SQL Server パブリッシャーでアーティクルのプロパティを変更する場合は、@publisher を使用しないでください。

リターン コードの値

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

解説

sp_changepublication は、スナップショット レプリケーションとトランザクション レプリケーションで使用されます。

次のいずれかのプロパティを変更した後、新しいスナップショットを生成し、@force_invalidate_snapshot パラメーターに 1 の値を指定する必要があります。

• alt_snapshot_folder
• compress_snapshot
• enabled_for_het_sub
• ftp_address
• ftp_login
• ftp_password
• ftp_port
• ftp_subdirectory
• post_snapshot_script
• pre_snapshot_script
• snapshot_in_defaultfolder
• sync_mode

publish_to_active_directory パラメーターを使用して Active Directory 内のパブリケーション オブジェクトを一覧表示するには、SQL Server オブジェクトが Active Directory に既に作成されている必要があります。

即時同期の効果

即時同期がオンの場合、サブスクリプションがない場合でも、初期スナップショットが生成された直後にログ内のすべての変更が追跡されます。 ログに記録された変更は、顧客がバックアップを使用して新しいピア ノードを追加するときに使用されます。 バックアップが復元されると、バックアップの作成後に発生したその他の変更とピアが同期されます。 コマンドはディストリビューション データベースで追跡されるため、同期ロジックは最後にバックアップされた LSN を確認し、これを開始点として使用できます。これは、バックアップが最大リテンション期間内に実行された場合にコマンドが使用可能であることを認識します。 (最小保有期間の既定値は 0 時間、最大保有期間は 24 時間です)。

即時同期がオフの場合、変更は少なくとも最小保有期間を保持し、既にレプリケートされているすべてのトランザクションに対してすぐにクリーンアップされます。 即時同期がオフで、既定の保持期間で構成されている場合、バックアップの作成後に必要な変更がクリーンアップされ、新しいピア ノードが正しく初期化されない可能性があります。 残された唯一のオプションがトポロジの停止です。 即時同期を有効に設定すると、柔軟性が向上するため、これは P2P アプリケーションにお勧めの設定です。

例

DECLARE @publication AS sysname
SET @publication = N'AdvWorksProductTran' 

-- Turn off DDL replication for the transactional publication.
USE [AdventureWorks2022]
EXEC sp_changepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0
GO

アクセス許可

sysadmin固定サーバー ロールまたは固定データベース ロールdb_ownerのメンバーのみがsp_changepublicationを実行できます。

関連するコンテンツ

• パブリケーション プロパティの表示および変更
• パブリケーションおよびアーティクルのプロパティの変更
• sp_addpublication (Transact-SQL)
• sp_droppublication (Transact-SQL)
• sp_helppublication (Transact-SQL)
• レプリケーション ストアド プロシージャ (Transact-SQL)