sp_change_subscription_properties (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
プル サブスクリプションの情報を更新します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。
構文
sp_change_subscription_properties
[ @publisher = ] N'publisher'
, [ @publisher_db = ] N'publisher_db'
, [ @publication = ] N'publication'
, [ @property = ] N'property'
, [ @value = ] N'value'
[ , [ @publication_type = ] publication_type ]
[ ; ]
引数
[ @publisher = ] N'publisher'
パブリッシャーの名前。 @publisher は sysname で、既定値はありません。
[ @publisher_db = ] N'publisher_db'
パブリッシャー データベースの名前。 @publisher_db は sysname で、既定値はありません。
[ @publication = ] N'publication'
出版物の名前。 @publication は sysname で、既定値はありません。
[ @property = ] N'property'
変更するプロパティ。 @property は sysname で、既定値はありません。
[ @value = ] N'value'
プロパティの新しい値です。 @value は nvarchar(1000)で、既定値はありません。
[ @publication_type = ] publication_type
パブリケーションのレプリケーションの種類を指定します。 @publication_type は int で、既定値は NULL で、次のいずれかの値を指定できます。
| Value | Publication type |
|---|---|
0 |
トランザクション |
1 |
スナップショット |
2 |
マージする |
NULL (既定) |
レプリケーションによってパブリケーションの種類が決まります。 このストアド プロシージャでは複数のテーブルを検索する必要があるため、このオプションを指定すると、パブリケーションの種類を直接指定したときに比べて動作が遅くなります。 |
次の表では、アーティクルのプロパティとそれらのプロパティの値について説明します。
| プロパティ | 値 | 説明 |
|---|---|---|
alt_snapshot_folder |
スナップショットの代替フォルダーの場所を指定します。 NULLに設定すると、スナップショット ファイルはパブリッシャーによって指定された既定の場所から取得されます。 |
|
distrib_job_login |
エージェントを実行する 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 は sysname の既定値は NULL で、パスワード プロパティを変更しないように指定します。 この値は、パブリケーションがトランザクションまたはスナップショットである場合にのみ指定できます。注: DTS パッケージにはパスワードが必要です。 |
|
dts_package_location |
DTS パッケージが格納されている場所。 この値は、パブリケーションがトランザクションまたはスナップショットである場合にのみ指定できます。 | |
dynamic_snapshot_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 つのデータベースのみが許可されるためです。
アクセス許可
sysadmin固定サーバー ロールまたは固定データベース ロールdb_ownerのメンバーのみがsp_change_subscription_propertiesを実行できます。