SERVERPROPERTY(Transact-SQL)
서버 인스턴스에 대한 속성 정보를 반환합니다.
.gif "항목 링크 아이콘")
구문
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 속성과 같은 값을 반환합니다.
.gif "참고")
참고
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 속성
예
다음 예에서는 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