sp_helppullsubscription (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

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

引数

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

[ @publisher_db = ] 'publisher_db' パブリッシャー データベースの名前を指定します。 publisher_dbは sysname で、既定値は %、すべてのパブリッシャー データベースを返します。

[ @publication = ] 'publication' パブリケーションの名前を指定します。 publication は sysname で、既定値は %、すべてのパブリケーションを返します。 このパラメーターが ALL に等しい場合は、independent_agent = 0 のプル サブスクリプションのみが返されます。

[ @show_push = ] 'show_push' すべてのプッシュ サブスクリプションを返すかどうかを指定します。 show_pushは nvarchar(5) で、既定値は FAL Standard Edition で、プッシュ サブスクリプションは返されません。

結果セット

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

0 = SQL Server 認証

1 = Windows 認証

2 = 同期トリガーは静的 sysservers エントリを使用してリモート プロシージャ コール (RPC) を実行し、パブリッシャーは sysservers テーブルでリモート サーバーまたはリンク サーバーとして定義する必要があります。
ディストリビューター 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:mi:sss.mmm 、'yyyy' は年、'mm' は月、'dd' は日、'hh' は時間、'mi' は分、'sss' は秒、'mmm' はミリ秒です。
job_login nvarchar(512) ディストリビューション エージェントが実行される Windows アカウントです。doメイン\username の形式で返されます。
job_password sysname セキュリティ上の理由から、値 "**********" は常に返されます。

リターン コードの値

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

解説

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

アクセス許可

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

参照

sp_addpullsubscription (Transact-SQL)
sp_droppullsubscription (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)