sp_helppullsubscription (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

サブスクライバーの 1 つ以上のサブスクリプションに関する情報を表示します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

sp_helppullsubscription
    [ [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @publication = ] N'publication' ]
    [ , [ @show_push = ] N'show_push' ]
[ ; ]

引数

[ @publisher = ] N'publisher'

リモート サーバーの名前。 @publishersysname で、既定値は % で、すべてのパブリッシャーの情報を返します。

[ @publisher_db = ] N'publisher_db'

パブリッシャー データベースの名前。 @publisher_dbsysname で、既定値は % で、すべてのパブリッシャー データベースが返されます。

[ @publication = ] N'publication'

出版物の名前。 @publicationsysname で、既定値は % で、すべてのパブリケーションが返されます。 このパラメーターが ALL と等しい場合は、independent_agent = 0 を持つプル サブスクリプションのみが返されます。

[ @show_push = ] N'show_push'

すべてのプッシュ サブスクリプションを返すかどうかを指定します。 @show_pushnvarchar(5)で、既定値は false で、プッシュ サブスクリプションは返されません。

結果セット

列名 データ型 説明
publisher sysname パブリッシャーの名前。
publisher database sysname パブリッシャー データベースの名前。
publication sysname パブリケーションの名前。
independent_agent bit このパブリケーションのスタンドアロン ディストリビューション エージェントがあるかどうかを示します。
subscription type int パブリケーションのサブスクリプションの種類。
distribution agent nvarchar(100) サブスクリプションを処理ディストリビューション エージェント。
publication description nvarchar (255) パブリケーションの説明。
last updating time date サブスクリプション情報が更新された時刻。 この値は、ISO 日付 (114) + ODBC 時刻 (121) の Unicode 文字列です。 形式はyyyyMMdd HH:mm:ss.nnnyyyy年、MMは月、ddは日、HHは時間、mmは分、ssは秒、nnnはミリ秒です。
subscription name varchar(386) サブスクリプションの名前。
last transaction timestamp varbinary(16) 最後にレプリケートされたトランザクションのタイムスタンプ。
update mode tinyint 許可される更新プログラムの種類。
distribution agent job_id int ディストリビューション エージェントのジョブ ID。
enabled_for_synmgr int Microsoft Synchronization Manager を使用してサブスクリプションを同期できるかどうかを指定します。
subscription guid binary(16) パブリケーション上のサブスクリプションのバージョンのグローバル識別子。
subid binary(16) 匿名サブスクリプションのグローバル識別子。
immediate_sync bit スナップショット エージェントを実行するたびに同期ファイルを作成するか再作成するかを指定します。
publisher login sysname SQL Server 認証のパブリッシャーで使用されるログイン ID。
publisher password nvarchar(524) SQL Server 認証用にパブリッシャーで使用されるパスワード (暗号化)。
publisher security_mode int パブリッシャーで実装されているセキュリティ モード。

0 = SQL Server 認証
1 = Windows 認証
2 = 同期トリガーは、静的な sysservers エントリを使用してリモート プロシージャ コール (RPC) を実行し、 publisher をリモート サーバーまたはリンク サーバーとして sysservers テーブルで定義する必要があります。
distributor sysname ディストリビューターの名前。
distributor_login sysname SQL Server 認証のディストリビューターで使用されるログイン ID。
distributor_password nvarchar(524) SQL Server 認証のディストリビューターで使用されるパスワード (暗号化)。
distributor_security_mode int ディストリビューターで実装されるセキュリティ モード:

0 = SQL Server 認証
1 = Windows 認証
ftp_address sysname これは旧バージョンとの互換性のためにだけ用意されています。
ftp_port int これは旧バージョンとの互換性のためにだけ用意されています。
ftp_login sysname これは旧バージョンとの互換性のためにだけ用意されています。
ftp_password nvarchar(524) これは旧バージョンとの互換性のためにだけ用意されています。
alt_snapshot_folder nvarchar (255) 場所が既定の場所以外の場合、または既定の場所に加えて、スナップショット フォルダーが格納される場所。
working_directory nvarchar (255) 該当するオプションが指定され、ファイル転送プロトコル (FTP) を使ってスナップショット ファイルを転送する場合の、転送先ディレクトリの完全修飾パス。
use_ftp bit サブスクリプションがインターネット経由でパブリケーションをサブスクライブしており、FTP アドレス指定プロパティが構成されています。 0場合、サブスクリプションは FTP を使用していません。 1場合、サブスクリプションは FTP を使用しています。
publication_type int パブリケーションのレプリケーションの種類。

0 = トランザクション レプリケーション
1 = スナップショット レプリケーション
2 = マージ レプリケーション
dts_package_name sysname データ変換サービス (DTS) パッケージの名前を指定します。
dts_package_location int DTS パッケージが格納されている場所:

0 = ディストリビューター
1 = サブスクライバー
offload_agent bit エージェントをリモートでアクティブ化できるかどうかを指定します。 0場合、エージェントをリモートでアクティブ化することはできません。
offload_server sysname リモート ライセンス認証に使用するサーバーのネットワーク名を指定します。
last_sync_status int サブスクリプションの状態:

0 = すべてのジョブが開始を待機しています
1 = 1 つ以上のジョブが開始中
2 = 正常に実行されたすべてのジョブ
3 = 少なくとも 1 つのジョブが実行されている
4 = すべてのジョブがスケジュールされ、アイドル状態になっている
5 = 前回の失敗後に少なくとも 1 つのジョブの実行が試行されている
6 = 少なくとも 1 つのジョブが正常に実行できませんでした
last_sync_summary sysname 最後の同期結果の説明。
last_sync_time datetime サブスクリプション情報が更新された時刻。 この値は、ISO 日付 (114) + ODBC 時刻 (121) の Unicode 文字列です。 形式はyyyyMMdd HH:mm:ss.nnnyyyy年、MMは月、ddは日、HHは時間、mmは分、ssは秒、nnnはミリ秒です。
job_login nvarchar(512) ディストリビューション エージェントが実行される Windows アカウントです。このアカウントは、 domain\username の形式で返されます。
job_password sysname セキュリティ上の理由から、 ********** の値は常に返されます。

リターン コードの値

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

解説

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

アクセス許可

sysadmin固定サーバー ロールまたはdb_owner固定データベース ロールのメンバーのみが、sp_helppullsubscriptionを実行できます。