SERVERPROPERTY (Transact-SQL)

[アーティクル]
07/02/2013

サーバーインスタンスについてのプロパティ情報を返します。

構文

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 インスタンスのインストールされている製品のエディション。機能や制限 (SQLServer のエディション別の計算容量制限など) は、このプロパティの値を使用して調べます。このバージョン (64 ビット) には、64 ビットバージョンのデータベースエンジンが追加されています。

戻り値:

'Enterprise Edition'

‘Enterprise Edition: Core-based Licensing’

'Enterprise Evaluation Edition'

‘Business Intelligence Edition’

'Developer Edition'

'Express Edition'

'Express Edition with Advanced Services'

'Standard Edition'

'Web Edition'

基本データ型: nvarchar(128)

EditionID

EditionID は、SQL Server のインスタンスについて、インストールされている製品のエディションを表します。機能や制限 (SQLServer のエディション別の計算容量制限など) は、このプロパティの値を使用して調べます。

1804890536 = Enterprise

1872460670 = Enterprise Edition: Core-based Licensing

610778273= Enterprise Evaluation

284895786 = Business Intelligence

-2117995310 = Developer

-1592396055 = Express

-133711905 = Express with Advanced Services

-1534726760 = Standard

1293598313 = Web

基本データ型: bigint

EngineEdition

サーバーにインストールされている SQL Server インスタンスのデータベースエンジンのエディション。

1 = Personal または Desktop Engine (SQL Server 2005 以降のバージョンでは使用できません)

2 = Standard (Standard、Web、および Business Intelligence の場合に返されます)

3 = Enterprise (Evaluation、Developer、および両方の Enterprise エディションの場合にこの値が返されます)

4 = Express (Express、Express with Tools、および Express with Advanced Services の場合に返されます)

5 = SQL Azure

基本データ型: int

HadrManagerStatus

AlwaysOn 可用性グループマネージャーが開始されたかどうかを示します。

0 = 未開始状態、通信保留中

1 = 開始されて実行中

2 = 未開始状態、失敗

InstanceName

ユーザーの接続先のインスタンス名。

インスタンス名が既定インスタンスの場合や、無効な入力またはエラーの場合は、NULL が返されます。

基本データ型: nvarchar(128)

IsClustered

サーバーインスタンスがフェールオーバークラスターで構成されます。

1 = クラスター化

0 = 非クラスター化

NULL = 無効な入力またはエラー

基本データ型: int

IsFullTextInstalled

SQL Server の現在のインスタンスに、フルテキストインデックス作成およびセマンティックインデックス作成のコンポーネントがインストールされています。

1 = フルテキストインデックス作成およびセマンティックインデックス作成のコンポーネントがインストールされています。

0 = フルテキストインデックス作成およびセマンティックインデックス作成のコンポーネントがインストールされていません。

NULL = 無効な入力またはエラー

基本データ型: int

IsHadrEnabled

AlwaysOn 可用性グループは、このサーバーインスタンス上で有効です。

0 = AlwaysOn 可用性グループ機能は無効です。

1 = AlwaysOn 可用性グループ機能は有効です。

基本データ型: int

SQL Server のインスタンスで可用性レプリカを作成して実行するには、サーバーインスタンス上で AlwaysOn 可用性グループが有効になっている必要があります。詳細については、「AlwaysOn 可用性グループの有効化と無効化 (SQL Server)」を参照してください。

注
IsHadrEnabled プロパティは、AlwaysOn 可用性グループだけに関連します。データベースミラーリングやログ配布などの、その他の高可用性機能および災害復旧機能は、このサーバープロパティの影響を受けません。

IsIntegratedSecurityOnly

サーバーは統合セキュリティモードです。

1 = 統合セキュリティ (Windows 認証)

0 = 非統合セキュリティ (Windows 認証と SQL Server 認証の両方)。

NULL = 無効な入力またはエラー

基本データ型: int

IsLocalDB

サーバーは SQL Server Express LocalDB のインスタンスです。

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。 ProcessID は、このインスタンスに属する Sqlservr.exe を識別するときに効果的です。

NULL = 無効な入力またはエラー

基本データ型: int

ProductVersion

SQL Server インスタンスのバージョンです (major.minor.build.revision 形式)。

基本データ型: 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 プロパティ

SERVERPROPERTY 関数は、バージョン情報に関連するプロパティを個別に返します。一方、@@VERSION 関数は、出力を 1 つの文字列へと結合します。アプリケーションで個々のプロパティ文字列を必要とする場合は、@@VERSION の結果を解析する代わりに SERVERPROPERTY 関数を使用して個々のプロパティ文字列を取得できます。

使用例

次の例では、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

次の方法で共有

SERVERPROPERTY (Transact-SQL)

構文

引数

戻り値の型

説明

ServerName プロパティ

Version プロパティ

使用例

関連項目

参照

その他のリソース