sp_changesubscription (Transact-SQL)

適用対象: はいSQL Server (サポートされているすべてのバージョン) はいAzure SQL Managed Instance

キュー更新トランザクション レプリケーションに関連するスナップショット またはトランザクション プッシュ サブスクリプションまたはプル サブスクリプションのプロパティを変更します。 他のすべての種類のプル サブスクリプションのプロパティを変更するには、Transact-sp_change_subscription_properties (を使用SQL)。 sp_changesubscription は、パブリケーション データベースの Publisherで実行されます。

重要

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

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

構文

  
sp_changesubscription [ @publication = ] 'publication'  
        , [ @article = ] 'article'  
        , [ @subscriber = ] 'subscriber'  
        , [ @destination_db = ] 'destination_db'  
        , [ @property = ] 'property'  
        , [ @value = ] 'value'  
    [ , [ @publisher = ] 'publisher' ]  

引数

[ @publication = ] 'publication' 変更するパブリケーションの名前を指定します。 publication は sysname で、既定値はありません

[ @article = ] 'article' 変更する記事の名前を指定します。 articlesysname で、 既定値はありません。

[ @subscriber = ] 'subscriber' サブスクライバーの名前を指定します。 subscribersysname で、 既定値はありません。

[ @destination_db = ] 'destination_db' サブスクリプション データベースの名前を指定します。 destination_db sysname で、 既定値はありません。

[ @property = ] 'property' 指定したサブスクリプションに対して変更するプロパティを指定します。 プロパティnvarchar(30) で、テーブルの値の 1 つを指定できます。

[ @value = ] 'value' 指定したプロパティの新しい値 ですvaluenvarchar(4000) で、テーブルの値の 1 つを指定できます。

プロパティ 説明
distrib_job_login エージェントを実行する Microsoft Windows アカウントのログイン。
distrib_job_password エージェントが実行Windowsアカウントのパスワード。
subscriber_catalog アプリケーション プロバイダーへの接続を確立するときに使用OLE DBカタログ。 このプロパティは、サブスクライバー以外の場合 Microsoft SQL Server にのみ有効です。
subscriber_datasource OLE DB プロバイダーで認識されるデータ ソースの名前。 このプロパティは、 以外の場合にのみ有効です。 SQL Serverサブスクライバー。
subscriber_location データベース プロバイダーによって理解されるデータベースOLE DB場所。 このプロパティは、 以外の場合にのみ有効です。 SQL Serverサブスクライバー。
subscriber_login サブスクライバーでのログイン名。
subscriber_password 指定されたログインの強力なパスワード。
subscriber_security_mode 1 サブスクライバーに接続するときに Windows 認証を使用。
0 サブスクライバー SQL Server に接続するときに認証を使用します。
subscriber_provider データ ソース以外のプロバイダーが登録OLE DBプログラム識別子 (PROGID) SQL Server を一意に指定します。 このプロパティは、 以外の場合にのみ有効です。 SQL Serverサブスクライバー。
subscriber_providerstring OLE DBを識別するプロバイダー固有の接続文字列です。 このプロパティは、 以外の場合にのみ有効です。 SQL Serverサブスクライバー。
subscriptionstreams サブスクライバーに変更のバッチを並列ディストリビューション エージェント適用できる接続数を指定します。 パブリッシャーでは 、1 ~ 64 の範囲の値が SQL Server サポートされています。 サブスクライバー以外、Oracle パブリッシャー、またはピア ツー ピア サブスクリプションの場合、このプロパティは 0 SQL Server である必要があります。
subscriber_type 1 ODBC データ ソース サーバー
3 OLE DB プロバイダー
memory_optimized bit サブスクリプションがメモリ最適化テーブルをサポートします。 memory_optimized ビット です。 ここで、1 は true に等しくなります (サブスクリプションはメモリ最適化テーブルをサポートします)。

[ @publisher = ] 'publisher'非パラメーターを指定 SQL Server Publisher。 publishersysname で、既定値は NULL です。

注意

パブリッシャー は、アプリケーションに対して指定 SQL Server Publisher。

リターン コードの値

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

解説

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

sp_changesubscription は、キュー更新トランザクション レプリケーションに関連するプッシュ サブスクリプションまたはプル サブスクリプションのプロパティを変更する場合にのみ使用できます。 他のすべての種類のプル サブスクリプションのプロパティを変更するには、Transact-sp_change_subscription_properties (を使用SQL)。

エージェントのログインまたはパスワードを変更した後、変更を有効にするには、エージェントを停止して再起動する必要があります。

アクセス許可

sysadmin 固定 サーバー ロールまたは 固定データベース ロール db_ownerメンバーだけが、 を実行 sp_changesubscription。

参照

sp_addsubscription (Transact-SQL)
sp_dropsubscription (Transact-SQL)