sp_helpserver (Transact-SQL)

  • [アーティクル]

適用対象: SQL サーバー

特定のリモート サーバーまたはレプリケーション サーバー、あるいはすべてのリモート サーバーとレプリケーション サーバーに関する情報をレポートします。 サーバー名、サーバーのネットワーク名、サーバーのレプリケーションの状態、サーバーの ID 番号、照合順序名を指定します。 また、リンク サーバーに接続したり、リンク サーバーに対してクエリを実行したりするためのタイムアウト値も提供します。

Transact-SQL 構文表記規則

構文

sp_helpserver
    [ [ @server = ] N'server' ]
    [ , [ @optname = ] 'optname' ]
    [ , [ @show_topology = ] 'show_topology' ]
[ ; ]

引数

[ @server = ] N'server'

情報を報告するサーバーを指定します。 @server は sysname で、既定値は NULL です。 serverが指定されていない場合は、master.sys.servers内のすべてのサーバーに関する情報を返します。

[ @optname = ] 'optname'

サーバーを記述するオプション。 @optname は varchar(35)であり、これらの値のいずれかである必要があります。

Value 説明
collation compatible リンク サーバーに対する分散クエリの実行に影響します。 このオプションを true に設定した場合、
data access 分散クエリ アクセスに対してリンク サーバーを有効または無効にします。
dist ディストリビューターです。
dpub このディストリビューターへのリモート パブリッシャー。
lazy schema validation クエリ開始時のリモート テーブルのスキーマ チェックをスキップします。
pub Publisher。
rpc 指定されたサーバーからの RPC を有効にします。
rpc out 指定されたサーバーへの RPC を有効にします。
sub 加入者。
system 単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
use remote collation ローカル サーバーの照合順序ではなく、リモート列の照合順序を使用します。

[ @show_topology = ] 'show_topology'

指定したサーバーと他のサーバーの関係。 @show_topology は varchar(1) で、既定値は NULL です。 @show_topologyがtと等しくない場合、またはNULLされている場合、sp_helpserverは結果セット セクションに一覧表示されている列を返します。 @show_topologyがtと等しい場合は、result setに記載されている列に加えて、sp_helpserverはtopxおよびtopy情報も返します。

リターン コードの値

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

結果セット

列名 データ型 説明
name sysname サーバー名。
network_name sysname サーバーのネットワーク名
status varchar(70) サーバーの状態。
id char(4) サーバーの識別番号
collation_name sysname サーバーの照合順序。
connect_timeout int リンク サーバーに接続するためのタイムアウト値。
query_timeout int リンク サーバーに対するクエリのタイムアウト値

解説

1 つのサーバーについて複数の状態値が返されることもあります。

アクセス許可

アクセス許可はチェックされません。

例

A. すべてのサーバーに関する情報を表示する

次の例では、パラメーターを指定せずに sp_helpserver を使用して、すべてのサーバーに関する情報を表示します。

USE master;
GO
EXEC sp_helpserver;

B. 特定のサーバーに関する情報を表示する

次の例では、 SEATTLE2 サーバーに関するすべての情報を表示します。

USE master;
GO
EXEC sp_helpserver 'SEATTLE2';

関連するコンテンツ