sp_helpsubscription (Transact-SQL)

適用対象: はいSQL Server (サポートされているすべてのバージョン) はいAzure SQL Managed Instance

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

トピック リンク アイコン Transact-SQL 構文表記規則

構文

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

引数

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

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

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

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

[ @found = ] 'found'OUTPUT 返される行を示すフラグです。 int で OUTPUT パラメーターが見つかりました。既定値は 23456 です。

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

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

[ @publisher = ] 'publisher'オブジェクトの名前を指定Publisher。 publishersysname で、既定値は現在のサーバーの名前です。

注意

パブリッシャー は、Oracle アプリケーションの場合を除き、指定Publisher。

結果セット

列名 データ型 説明
サブスクライバー sysname サブスクライバーの名前。
パブリケーション sysname パブリケーションの名前。
記事 sysname 記事の名前。
変換先データベース 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 の場合、エージェントは次のPublisher。

1 の場合、サブスクライバーでエージェントが実行されます。
offload_server sysname リモート エージェントのアクティブ化が有効になっているサーバーの名前。 NULL の場合、現在のoffload_serverテーブルに一 MSdistribution_agents が使用されます。
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 は、スナップショットレプリケーションおよびトランザクションレプリケーションで使用します。

アクセス許可

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

参照

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