SERVERPROPERTY (Transact-SQL)
SQL Server 2008 R2 のサーバー インスタンスについてのプロパティ情報を返します。
構文
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 ビット バージョンのデータベース エンジンが追加されています。
戻り値
'Data Center Edition'
'Desktop Engine' (SQL Server 2005 以降のバージョンでは使用できません)
'Developer Edition'
'Enterprise Edition'
'Enterprise Evaluation Edition'
'Express Edition'
'Express Edition with Advanced Services'
'Personal Edition' (SQL Server 2005 以降のバージョンでは使用できません)
'Small Business Server Edition'
'Standard Edition'
'Web Edition'
'Windows Embedded SQL'
'Workgroup Edition'
基本データ型: nvarchar(128)
EditionID
SQL Server インスタンスの、インストールされている製品のエディションを表す識別番号。このプロパティの値を使用すると、CPU の最大数など、インストールされている製品でサポートされている機能や制限を確認できます。
-978676123 = Data Center
-1253826760 = Desktop
-2117995310 = Developer
-1592396055 = Express
1804890536 = Enterprise
610778273 = Enterprise Evaluation
-133711905 = Express with Advanced Services
-323382091 = Personal
-1960233010 = Small Business Server
-1534726760 = Standard
1293598313 = Web
-3250176541 = Windows Embedded SQL
1333529388 = Workgroup
基本データ型: bigint
EngineEdition
サーバーにインストールされている SQL Server インスタンスのデータベース エンジンのエディション。
1 = Personal または Desktop Engine (SQL Server 2005 以降のバージョンでは使用できません)
2 = Standard (Standard、Small Business Server、Web、および Workgroup の場合に返されます)
3 = Enterprise (Enterprise、Enterprise Evaluation、Data Center、および Developer の場合に返されます)
4 = Express (Express、Express with Advanced Services、および Windows Embedded SQL の場合に返されます)
5 = SQL Azure
基本データ型: 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 製品によって保存または保持されることはありません。常に DISABLED を返します。
基本データ型: nvarchar(128)
MachineName
サーバー インスタンスが稼働している Windows コンピューターの名前。
クラスター化インスタンスの場合、つまり、Microsoft Cluster Service 上の仮想サーバーで稼働している SQL Server のインスタンスの場合は、仮想サーバーの名前が返されます。
NULL = 無効な入力またはエラー
基本データ型: nvarchar(128)
NumLicenses
使用しません。ライセンス情報は、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