sp_change_subscription_properties (Transact-SQL)
適用対象: 
SQL ServerAzure SQL Managed Instance
プル サブスクリプションの情報を更新します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。
構文
sp_change_subscription_properties [ @publisher = ] 'publisher'
, [ @publisher_db = ] 'publisher_db'
, [ @publication = ] 'publication'
, [ @property = ] 'property'
, [ @value = ] 'value'
[ , [ @publication_type = ] publication_type ]
引数
[ @publisher = ] 'publisher' パブリッシャーの名前を指定します。 publisher は sysname で、既定値はありません。
[ @publisher_db = ] 'publisher_db' パブリッシャー データベースの名前を指定します。 publisher_dbは sysname で、既定値はありません。
[ @publication = ] 'publication' パブリケーションの名前を指定します。 publication は sysname で、既定値はありません。
[ @property = ] 'property' 変更するプロパティを指定します。 プロパティ は sysname です。
[ @value = ] 'value' プロパティの新しい値です。 値 は nvarchar(1000)で、既定値はありません。
[ @publication_type = ] publication_type パブリケーションのレプリケーションの種類を指定します。 publication_typeは int であり、これらの値のいずれかになります。
| Value | Publication type |
|---|---|
| 0 | トランザクション |
| 1 | スナップショット |
| 2 | マージする |
| NULL (既定値) | レプリケーションによってパブリケーションの種類が決まります。 このストアド プロシージャでは複数のテーブルを検索する必要があるため、このオプションを指定すると、パブリケーションの種類を直接指定したときに比べて動作が遅くなります。 |
次の表では、アーティクルのプロパティとそれらのプロパティの値について説明します。
| プロパティ | 値 | 説明 |
|---|---|---|
| alt_snapshot_folder | スナップショットの代替フォルダーの場所を指定します。 NULL に設定すると、スナップショット ファイルはパブリッシャーによって指定された既定の場所から取得されます。 | |
| distrib_job_login | エージェントが実行されている Microsoft Windows アカウントにログインします。 | |
| distrib_job_password | エージェントを実行する Windows アカウントのパスワード。 | |
| distributor_login | ディストリビューター ログイン。 | |
| distributor_password | ディストリビューター パスワード。 | |
| distributor_security_mode | 1 | ディストリビューターに接続するときは、Windows 認証を使用します。 |
| 0 | ディストリビューターに接続するときは、SQL Server 認証を使用します。 | |
| dts_package_name | SQL Server 2000 データ変換サービス (DTS) パッケージの名前。 この値は、パブリケーションがトランザクションまたはスナップショットの場合にのみ指定できます。 | |
| dts_package_password | パッケージのパスワードを指定します。 dts_package_passwordは、既定値が NULL の sysname であり、パスワード プロパティを変更せずに残すよう指定します。 注: DTS パッケージにはパスワードが必要です。 この値は、パブリケーションがトランザクションまたはスナップショットの場合にのみ指定できます。 |
|
| dts_package_location | DTS パッケージが格納されている場所。 この値は、パブリケーションがトランザクションまたはスナップショットの場合にのみ指定できます。 | |
| dynamic_スナップショット_location | スナップショット ファイルを保存するフォルダーへのパスを指定します。 この値は、パブリケーションがマージ パブリケーションの場合にのみ指定できます。 | |
| ftp_address | これは旧バージョンとの互換性のためにだけ用意されています。 | |
| ftp_login | これは旧バージョンとの互換性のためにだけ用意されています。 | |
| ftp_password | これは旧バージョンとの互換性のためにだけ用意されています。 | |
| ftp_port | これは旧バージョンとの互換性のためにだけ用意されています。 | |
| hostname | パブリッシャーに接続するときに使用されるホスト名。 | |
| internet_login | 基本認証を使用して Web 同期をホストしている Web サーバーに接続するときに、マージ エージェントが使用するログイン。 | |
| internet_password | 基本認証を使用して Web 同期をホストしている Web サーバーに接続するときにマージ エージェントが使用するパスワード。 | |
| internet_security_mode | 1 | Web 同期には Windows 統合認証を使用します。 Web 同期で基本認証を使用することをお勧めします。 詳しくは、「 Configure Web Synchronization」をご覧ください。 |
| 0 | Web 同期に基本認証を使用。 注: Web 同期には、Web サーバーへの TLS 接続が必要です。 |
|
| internet_timeout | Web 同期要求の有効期限が切れるまでの時間 (秒単位)。 | |
| internet_url | Web 同期のレプリケーション リスナーの場所を表す URL。 | |
| merge_job_login | エージェントを実行する Windows アカウントのログイン。 | |
| merge_job_password | エージェントを実行する Windows アカウントのパスワード。 | |
| publisher_login | パブリッシャー ログイン。 publisher_loginの変更は、マージ パブリケーションのサブスクリプションでのみサポートされます。 | |
| publisher_password | 発行元のパスワード。 publisher_passwordの変更は、マージ パブリケーションのサブスクリプションでのみサポートされます。 | |
| publisher_security_mode | 1 | パブリッシャーに接続するときに Windows 認証を使用。 publisher_security_modeの変更は、マージ パブリケーションのサブスクリプションでのみサポートされます。 |
| 0 | パブリッシャーに接続するときは、SQL Server 認証を使用します。 | |
| use_ftp | true | 通常のプロトコルの代わりに FTP を使用して、スナップショットを取得します。 |
| false | 標準のプロトコルを使用してスナップショットを取得。 | |
| use_web_sync | true | Web 同期を有効にします。 |
| false | Web 同期を無効にします。 | |
| working_directory | ファイル転送プロトコル (FTP) を使用してファイルを転送するときに、パブリケーションのデータ ファイルとスキーマ ファイルを一時的に格納するために使用する作業ディレクトリの名前スナップショット。 |
リターン コードの値
0 (成功) または 1 (失敗)
解説
sp_change_subscription_propertiesは、すべての種類のレプリケーションで使用されます。
sp_change_subscription_propertiesはプル サブスクリプションに使用されます。
Oracle パブリッシャーの場合、publisher_dbの値は無視されます。Oracle では、サーバーのインスタンスごとに 1 つのデータベースのみが許可されるためです。
アクセス許可
sp_change_subscription_propertiesを実行できるのは、sysadmin 固定サーバー ロールまたは固定データベース ロールdb_ownerメンバーだけです。
参照
プル サブスクリプションのプロパティの表示または変更
sp_addmergepullsubscription (Transact-SQL)
sp_addmergepullsubscription_agent (Transact-SQL)
sp_addpullsubscription (Transact-SQL)
sp_addpullsubscription_agent (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示