sp_change_subscription_properties (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

プル サブスクリプションの情報を更新します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

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'

パブリッシャーの名前。 @publishersysname で、既定値はありません。

[ @publisher_db = ] N'publisher_db'

パブリッシャー データベースの名前。 @publisher_dbsysname で、既定値はありません。

[ @publication = ] N'publication'

出版物の名前。 @publicationsysname で、既定値はありません。

[ @property = ] N'property'

変更するプロパティ。 @propertysysname で、既定値はありません。

[ @value = ] N'value'

プロパティの新しい値です。 @valuenvarchar(1000)で、既定値はありません。

[ @publication_type = ] publication_type

パブリケーションのレプリケーションの種類を指定します。 @publication_typeint で、既定値は 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_passwordsysname の既定値は 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を実行できます。