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 인스턴스가 장애 조치(failover) 클러스터에 있는 상태에서 장애 조치(failover) 클러스터형 인스턴스 이름을 가져오려는 경우 MachineName 속성을 사용하십시오.

    NULL = 입력이 유효하지 않거나 오류입니다.

    기본 데이터 형식: nvarchar(128)

    Edition

    SQL Server 인스턴스의 설치된 제품 버전입니다. 이 속성 값을 사용하여 SQL Server의 버전별 계산 용량 제한와 같은 기능 및 제한을 확인합니다. 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

    SQL Server 인스턴스의 설치된 제품 버전을 나타내는 EditionID입니다. 이 속성 값을 사용하여 SQL Server의 버전별 계산 용량 제한와 같은 기능 및 제한을 확인합니다.

    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 = 웹

    기본 데이터 형식: 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

    서버 인스턴스가 장애 조치(failover) 클러스터에 구성되어 있습니다.

    1 = 클러스터형입니다.

    0 = 비클러스터형입니다.

    NULL = 입력이 유효하지 않거나 오류입니다.

    기본 데이터 형식: int

    IsFullTextInstalled

    전체 텍스트 및 의미 체계 인덱싱 구성 요소가 SQL Server의 현재 인스턴스에 설치되었습니다.

    1 = 전체 텍스트 및 의미 체계 인덱싱 구성 요소가 설치되었습니다.

    0 = 전체 텍스트 및 의미 체계 인덱싱 구성 요소가 설치되지 않았습니다.

    NULL = 입력이 유효하지 않거나 오류입니다.

    기본 데이터 형식: int

    IsHadrEnabled

    이 서버 인스턴스에서 AlwaysOn 가용성 그룹이 사용됩니다.

    0 = AlwaysOn 가용성 그룹 기능을 사용하지 않습니다.

    1 = AlwaysOn 가용성 그룹 기능을 사용합니다.

    기본 데이터 형식: int

    SQL Server 인스턴스에서 AlwaysOn 가용성 그룹 가용성 복제본을 만들고 실행하려면 서버 인스턴스에서 HADR 서비스를 사용하도록 설정해야 합니다. 자세한 내용은 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(로캘 ID)입니다.

    기본 데이터 형식: 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

    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

참고 항목

참조

SQL Server 2012 버전 및 구성 요소