SERVERPROPERTY(Transact-SQL)

서버 인스턴스에 대한 속성 정보를 반환합니다.

항목 링크 아이콘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 이름입니다.

    장애 조치(Failover) 클러스터의 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 인스턴스의 설치된 제품 버전을 나타내는 ID 번호입니다. 이 속성 값을 사용하여 설치된 제품에서 지원하는 기능 및 최대 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 = 개인용 또는 데스크톱 엔진(SQL Server에는 사용할 수 없음)

    2 = 스탠더드(스탠더드 및 워크그룹 버전인 경우 이 값이 반환됨)

    3 = 엔터프라이즈(엔터프라이즈, 엔터프라이즈 평가 및 디벨로퍼 버전인 경우 이 값이 반환됨)

    4 = 익스프레스(익스프레스, 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(로캘 ID)입니다.

    기본 데이터 형식: 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입니다. ProcessID는 인스턴스에 속하는 Sqlservr.exe를 식별하는 데 유용합니다.

    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

    Windows 서버 및 지정된 SQL Server 인스턴스에 대한 인스턴스 정보입니다.

    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 함수는 출력을 하나의 문자열로 결합합니다. 응용 프로그램에서 개별 속성 문자열이 필요한 경우 @@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