sp_helpsubscription (Transact-SQL)
適用対象: SQL ServerAzure SQL Managed Instance
特定のパブリケーション、アーティクル、サブスクライバー、または一連のサブスクリプションに関連付けられているサブスクリプション情報を一覧表示します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。
構文
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)
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示