• [アーティクル]

SERVERPROPERTY (Transact-SQL)

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

トピック リンク アイコン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 ビット バージョンのデータベース エンジンが追加されています。

    戻り値

    '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 プロパティ

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