sp_change_subscription_properties (Transact-SQL)
プル サブスクリプションの情報を更新します。このストアド プロシージャは、サブスクライバ側でサブスクリプション データベースについて実行されます。
.gif "トピック リンク アイコン")
構文
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'
変更するプロパティを指定します。property のデータ型は sysname です。
- [ @value=] 'value'
プロパティの新しい値を指定します。value のデータ型は nvarchar(1000) で、既定値はありません。
[ @publication_type = ] publication_type
パブリケーションのレプリケーションの種類を指定します。publication_type のデータ型は int で、次のいずれかの値を指定できます。値 パブリケーションの種類 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 のデータ型は sysname で、既定値は NULL です。既定値はパスワードのプロパティを変更しないことを表します。
.gif "ms188918.note(ja-jp,SQL.90).gif")
メモ :
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 認証と共に使用することをお勧めします。詳細については、「Web 同期の構成」を参照してください。
0
Web 同期に基本認証を使用。
メモ :
Web 同期には、Web サーバーへの SSL 接続が必要です。
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) を使用する場合、パブリケーションのデータとスキーマ ファイルを一時的に保存するために使用する作業ディレクトリの名前。
解説
sp_change_subscription_properties は、すべての種類のレプリケーションで使用できます。
sp_change_subscription_properties はプル サブスクリプションで使用します。
Oracle パブリッシャの場合、Oracle ではサーバーのインスタンス 1 つにつき 1 つのデータベースしか許可されないため、publisher_db の値は無視されます。
権限
sp_change_subscription_properties を実行できるのは、sysadmin 固定サーバー ロールまたは db_owner 固定データベース ロールのメンバだけです。
戻り値
0 (成功) または 1 (失敗)
参照
関連項目
sp_addmergepullsubscription (Transact-SQL)
sp_addmergepullsubscription_agent (Transact-SQL)
sp_addpullsubscription (Transact-SQL)
sp_addpullsubscription_agent (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)
その他の技術情報
プル サブスクリプションのプロパティを表示および変更する方法 (レプリケーション Transact-SQL プログラミング)