sp_helpsubscription (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

特定のパブリケーション、アーティクル、サブスクライバー、または一連のサブスクリプションに関連付けられているサブスクリプション情報を一覧表示します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

Transact-SQL 構文表記規則

構文

  
sp_helpsubscription [ [ @publication = ] 'publication' ]   
    [ , [ @article = ] 'article' ]  
    [ , [ @subscriber = ] 'subscriber' ]  
    [ , [ @destination_db = ] 'destination_db' ]   
    [ , [ @found=] found OUTPUT ]  
    [ , [ @publisher = ] 'publisher' ]

引数

[ @publication = ] 'publication' 関連付けられているパブリケーションの名前です。 publication は sysname で、既定値は %であり、このサーバーのすべてのサブスクリプション情報を返します。

[ @article = ] 'article' アーティクルの名前を指定します。 article は sysname で、既定値は で %、選択したパブリケーションとサブスクライバーのすべてのサブスクリプション情報を返します。 すべてである場合、パブリケーションの完全なサブスクリプションに対して 1 つのエントリのみが返されます。

[ @subscriber = ] 'subscriber' サブスクリプション情報を取得するサブスクライバーの名前です。 subscriber は sysname で、既定値は %で、選択したパブリケーションとアーティクルのすべてのサブスクリプション情報を返します。

[ @destination_db = ] 'destination_db' コピー先データベースの名前を指定します。 destination_db は sysname で、既定値は %です。

[ @found = ] 'found'OUTPUT 返される行を示すフラグです。 foundは int で、OUTPUT パラメーターは既定値の 23456 です。

1 は、パブリケーションが見つかった場合を示します。

0 は、パブリケーションが見つからない場合を示します。

[ @publisher = ] 'publisher' パブリッシャーの名前を指定します。 publisher は sysname で、既定値は現在のサーバーの名前です。

注意

パブリッシャー は、Oracle パブリッシャーの場合を除き、指定しないでください。

結果セット

列名 データ型 説明
サブスクライバー sysname サブスクライバーの名前。
パブリケーション (publication) sysname パブリケーションの名前。
記事 sysname アーティクルの名前。
destination データベース sysname レプリケートされたデータの格納先のデータベースの名前。
サブスクリプションの状態 tinyint サブスクリプションの状態:

0 = 非アクティブ

1 = サブスクライブ済み

2 = アクティブ
同期の種類 tinyint サブスクリプション同期の種類:

1 = 自動

2 = なし
サブスクリプションの種類 int サブスクリプションの種類:

0 = プッシュ

1 = プル

2 = 匿名
full subscription bit サブスクリプションがパブリケーション内のすべてのアーティクルを対象としているかどうかを示します。

0 = いいえ

1 = はい
サブスクリプション名 nvarchar (255) サブスクリプションの名前。
更新モード int 0 = 読み取り専用

1 = 即時更新サブスクリプション
distribution job id binary(16) ディストリビューション エージェントのジョブ ID。
loopback_detection bit ディストリビューション エージェントが、サブスクライバーで発生したトランザクションをサブスクライバーに戻すかどうかを示します。

0 = 返送します。

1 = 返送されません。

双方向トランザクション レプリケーションで使用されます。 詳細については、「 Bidirectional Transactional Replication」を参照してください。
offload_enabled bit レプリケーション エージェントのオフロード実行がサブスクライバーで実行されるように設定されているかどうかを指定します。

0 の場合、エージェントはパブリッシャーで実行されます。

1 の場合、エージェントはサブスクライバーで実行されます。
offload_server sysname リモート エージェントのアクティブ化が有効になっているサーバーの名前。 NULL の場合は、MSdistribution_agents テーブルに一覧表示されている現在 のoffload_server が使用されます。
dts_package_name sysname データ変換サービス (DTS) パッケージの名前を指定します。
dts_package_location int DTS パッケージの場所 (サブスクリプションに割り当てられている場合)。 パッケージがある場合、 値 0 はディストリビューターのパッケージの場所を指定 します。 値 1 は 、サブスクライバーを指定します。
subscriber_security_mode smallint サブスクライバーのセキュリティ モードです。1 は Windows 認証を意味し、0 は認証SQL Server意味します。
subscriber_login sysname サブスクライバーのログイン名を指定します。
subscriber_password 実際のサブスクライバー パスワードは返されません。 結果は "******" 文字列でマスクされます。
job_login sysname ディストリビューション エージェントが実行される Windows アカウントの名前。
job_password 実際のジョブ パスワードは返されません。 結果は "******" 文字列でマスクされます。
distrib_agent_name nvarchar(100) サブスクリプションを同期するエージェント ジョブの名前。
subscriber_type tinyint サブスクライバーの種類。次のいずれかになります。

0 = サブスクライバー SQL Server

1 = ODBC データ ソース サーバー

2 = Microsoft JET データベース (非推奨)

3 = OLE DB プロバイダー
subscriber_provider sysname 非SQL Server データ ソースの OLE DB プロバイダーが登録される一意のプログラム識別子 (PROGID)。
subscriber_datasource nvarchar (4000) OLE DB プロバイダーで認識されるデータ ソースの名前。
subscriber_providerstring nvarchar (4000) データ ソースを識別する OLE DB プロバイダー固有の接続文字列。
subscriber_location nvarchar (4000) OLE DB プロバイダーによって認識されるデータベースの場所
subscriber_catalog sysname OLE DB プロバイダーへの接続時に使用するカタログ。

リターン コードの値

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

解説

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

アクセス許可

実行アクセス許可は、既定で パブリック ロールに設定されます。 ユーザーに返されるのは、ユーザーが自分で作成したサブスクリプションの情報だけです。 すべてのサブスクリプションに関する情報は、パブリッシャーの sysadmin 固定サーバー ロールのメンバー、またはパブリケーション データベースの db_owner 固定データベース ロールのメンバーに返されます。

参照

sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)