SERVERPROPERTY (Transact-SQL)
サーバー インスタンスについてのプロパティ情報を返します。
構文
SERVERPROPERTY ( propertyname )
引数
propertyname
サーバーに返されるプロパティ情報を含む式を指定します。propertyname には、次のいずれかの値を指定できます。プロパティ
戻り値
BuildClrVersion
SQL Server インスタンスの構築時に使用された Microsoft.NET Framework 共通言語ランタイム (CLR) のバージョン。
基本データ型 : nvarchar(128)
Collation
サーバーの既定の照合順序の名前。
NULL = 無効な入力またはエラー
基本データ型 : nvarchar(128)
CollationID
SQL Server 照合順序の ID。
基本データ型 : int
ComparisonStyle
照合順序の Windows 比較形式。
基本データ型 : int
ComputerNamePhysicalNetBIOS
SQL Server のインスタンスが現在実行されているローカル コンピュータの NetBIOS 名。
フェールオーバー クラスタの SQL Server クラスタ化インスタンスでは、SQL Server インスタンスがフェールオーバー クラスタの他のノードにフェールオーバーすると、この値が変わります。
SQL Server スタンドアロン インスタンスではこの値は変わらず、MachineName プロパティと同じ値が返されます。
注意
SQL Server のインスタンスがフェールオーバー クラスタ内にある場合に、フェールオーバー クラスタ インスタンスの名前を取得するには、MachineName プロパティを使用します。NULL = 無効な入力またはエラー
基本データ型 : nvarchar(128)
Edition
SQL Server インスタンスのインストールされている製品のエディション。このプロパティの値を使用すると、CPU の最大数など、インストールされている製品でサポートされている機能や制限を確認できます。このバージョン (64 ビット) には、64 ビット バージョンのデータベース エンジンが追加されています。
戻り値
'Desktop Engine' (SQL Server では使用できません)
'Developer Edition'
'Enterprise Edition'
'Enterprise Evaluation Edition'
'Personal Edition' (SQL Server では使用できません)
'Standard Edition'
'Express Edition'
'Express Edition with Advanced Services'
'Workgroup Edition'
'Windows Embedded SQL'
基本データ型 : nvarchar(128)
EditionID
SQL Server インスタンスの、インストールされている製品のエディションを表す識別番号。このプロパティの値を使用すると、CPU の最大数など、インストールされている製品でサポートされている機能や制限を確認できます。
-1253826760 = Desktop
-1592396055 = Express
-1534726760 = Standard
1333529388 = Workgroup
1804890536 = Enterprise
-323382091 = Personal
-2117995310 = Developer
610778273 = Enterprise Evaluation
1044790755 = Windows Embedded SQL
4161255391 = Express with Advanced Services
基本データ型 : int
EngineEdition
サーバーにインストールされている SQL Server インスタンスのデータベース エンジンのエディション。
1 = Personal または Desktop Engine (SQL Server では使用できません)
2 = Standard (Standard および Workgroup の場合に返されます)
3 = Enterprise (Enterprise、Enterprise Evaluation、および Developer の場合にこの値が返されます)
4 = Express (Express、Express with Advanced Services、および Windows Embedded SQL の場合に返されます)
基本データ型 : int
InstanceName
ユーザーの接続先のインスタンス名。
インスタンス名が既定インスタンスの場合や、無効な入力またはエラーの場合は、NULL が返されます。
基本データ型 : nvarchar(128)
IsClustered
サーバー インスタンスがフェールオーバー クラスタで構成されます。
1 = クラスタ化
0 = 非クラスタ化
NULL = 無効な入力またはエラー
基本データ型 : int
IsFullTextInstalled
フルテキスト コンポーネントは、SQL Server の現在のインスタンスと共にインストールされます。
1 = フルテキストはインストールされています。
0 = フルテキストはインストールされていません。
NULL = 無効な入力またはエラー
基本データ型 : int
IsIntegratedSecurityOnly
サーバーは統合セキュリティ モードです。
1 = 統合セキュリティ
0 = 非統合セキュリティ
NULL = 無効な入力またはエラー
基本データ型 : int
IsSingleUser
サーバーはシングルユーザー モードです。
1 = シングル ユーザー
0 = 非シングル ユーザー
NULL = 無効な入力またはエラー
基本データ型 : int
LCID
照合順序の Windows ロケール識別子 (LCID)。
基本データ型 : int
LicenseType
SQL Server のこのインスタンスのモード。
PER_SEAT = 接続クライアント数モード
PER_PROCESSOR = プロセッサ数モード
DISABLED = ライセンスが無効
基本データ型 : nvarchar(128)
MachineName
サーバー インスタンスが稼働している Windows コンピュータの名前。
クラスタ化インスタンスの場合、つまり、Microsoft Cluster Service 上の仮想サーバーで稼働している SQL Server のインスタンスの場合は、仮想サーバーの名前が返されます。
NULL = 無効な入力またはエラー
基本データ型 : nvarchar(128)
NumLicenses
接続クライアント数モードの場合、SQL Server のこのインスタンスに対して登録されているクライアント ライセンス数です。
プロセッサ数モードの場合、SQL Server のこのインスタンスに対して登録されているプロセッサ数です。
サーバーが上のどちらでもない場合は、NULL が返されます。
基本データ型 : int
ProcessID
SQL Server サービスのプロセス ID。このインスタンスに属する Sqlservr.exe を識別するときに、ProcessID は効果的です。
NULL = 無効な入力またはエラー
基本データ型 : int
ProductVersion
SQL Server インスタンスのバージョンです (major.minor.build 形式)。
基本データ型 : nvarchar(128)
ProductLevel
SQL Server インスタンスのバージョンのレベルです。
次のいずれかを返します。
'RTM' = オリジナル リリース バージョン
'SPn' = サービス パック バージョン
'CTP' = Community Technology Preview バージョン
基本データ型 : nvarchar(128)
ResourceLastUpdateDateTime
リソース データベースが最後に更新された日時を返します。
基本データ型 : datetime
ResourceVersion
リソース データベースのバージョンを返します。
基本データ型 : nvarchar(128)
ServerName
SQL Server の特定のインスタンスに関連付けられている Windows サーバーとインスタンスの情報。
NULL = 無効な入力またはエラー
基本データ型 : nvarchar(128)
SqlCharSet
照合順序 ID の SQL 文字セット ID。
基本データ型 : tinyint
SqlCharSetName
照合順序の SQL 文字セットの名前。
基本データ型 : nvarchar(128)
SqlSortOrder
照合順序の SQL 並べ替え順序 ID。
基本データ型 : tinyint
SqlSortOrderName
照合順序の SQL 並べ替え順序の名前。
基本データ型 : nvarchar(128)
FilestreamShareName
FILESTREAM で使用される共有の名前。
FilestreamConfiguredLevel
FILESTREAM アクセスの構成されているレベル。詳細については、「FILESTREAM アクセス レベル」を参照してください。
FilestreamEffectiveLevel
FILESTREAM アクセスの有効なレベル。レベルが変更されており、インスタンスの再起動またはコンピュータの再起動のいずれかが保留されている場合、この値は FilestreamConfiguredLevel と異なることがあります。詳細については、「FILESTREAM アクセス レベル」を参照してください。
戻り値の型
sql_variant
説明
ServerName プロパティ
SERVERPROPERTY 関数の ServerName プロパティと @@SERVERNAME は、同様の情報を返します。ServerName プロパティが返す Windows サーバーとインスタンス名を合わせることで、一意なサーバー インスタンスが形成されます。@@SERVERNAME は、現在構成されているローカル サーバー名を返します。
インストール時の既定のサーバー名が変更されていない場合、ServerName プロパティと @@SERVERNAME は同じ情報を返します。ローカル サーバー名は次のストアド プロシージャを実行することによって構成できます。
EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO
ローカル サーバー名がインストール時の既定のサーバー名から変更されている場合、@@SERVERNAME は新しい名前を返します。
Version プロパティ
例
次の例では、SELECT ステートメント内で SERVERPROPERTY 関数を使用することによって、現在のサーバーに関する情報を返します。このシナリオは、Windows サーバー上に複数の SQL Server のインスタンスがインストールされており、クライアントの現在の接続で使用しているインスタンスと同じインスタンスに対して、別の接続を開く必要がある場合に効果的です。
SELECT CONVERT(sysname, SERVERPROPERTY('servername'));
GO
次の例では、SELECT ステートメント内で SERVERPROPERTY 関数を使用することによって、製品のバージョン情報を返します。
SELECT
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('EngineEdition') AS EngineEdition;
GO