• Статья

SERVERPROPERTY (Transact-SQL)

Возвращает сведения о свойстве экземпляра SQL Server 2008 R2.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

SERVERPROPERTY ( propertyname )

Аргументы

  • propertyname
    Выражение, содержащее сведения о свойстве, возвращаемые серверу. Аргумент propertyname может принимать одно из следующих значений.

    Свойство

    Возвращаемые значения

    BuildClrVersion

    Версия среды CLR Microsoft .NET Framework, которая использовалась при построении экземпляра SQL Server.

    Базовый тип данных: nvarchar(128)

    Collation

    Имя параметров сортировки для сервера, установленного по умолчанию.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: nvarchar(128)

    CollationID

    Идентификатор параметров сортировки SQL Server.

    Базовый тип данных: int

    ComparisonStyle

    Стиль сравнения Windows параметров сортировки.

    Базовый тип данных: int

    ComputerNamePhysicalNetBIOS

    Имя NetBIOS для локального компьютера, на котором работает экземпляр SQL Server.

    Для кластеризованного экземпляра SQL Server на отказоустойчивом кластере это значение изменяется, когда экземпляр SQL Server переключается на другие узлы в отказоустойчивом кластере.

    Для изолированного экземпляра SQL Server это значение остается постоянным и совпадает со значением, возвращаемым свойством MachineName.

    ПримечаниеПримечание
    Если экземпляр SQL Server находится в отказоустойчивом кластере и необходимо получить имя экземпляра отказоустойчивого кластера, воспользуйтесь свойством MachineName.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: nvarchar(128)

    Edition

    Установленный выпуск экземпляра SQL Server. Используйте значения этого свойства для определения возможностей и ограничений, таких как максимальное количество процессоров, которые поддерживаются установленным продуктом. В 64-разрядных версиях компонента Database Engine к обозначению версии добавляется «(64-разрядная версия)».

    Возвращает:

    «Data Center Edition»

    «Desktop Engine» (Недоступно для SQL Server 2005 и более поздних версий.)

    выпуск «Developer Edition»;

    выпуск «Enterprise Edition»;

    выпуск «Enterprise Evaluation Edition»;

    выпуск «Express Edition»;

    выпуск «Express Edition с дополнительными службами»;

    «Personal Edition» (Недоступно для SQL Server 2005 и более поздних версий.)

    «Small Business Server Edition»

    выпуск «Standard Edition»;

    «Web Edition»

    выпуск «Windows Embedded SQL».

    выпуск «Workgroup Edition»;

    Базовый тип данных: nvarchar(128)

    EditionID

    Идентификатор, который представляет установленный выпуск экземпляра SQL Server. Используйте значения этого свойства для определения возможностей и ограничений, таких как максимальное количество процессоров, которые поддерживаются установленным продуктом.

    -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

    Выпуск компонента Database Engine для экземпляра 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

    Установлен ли компонент Full-Text Search в текущем экземпляре SQL Server.

    1 = компонент Full-Text Search установлен.

    0 = компонент Full-Text Search не установлен.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: int

    IsIntegratedSecurityOnly

    Сервер запущен во встроенном режиме безопасности.

    1 = встроенный режим безопасности.

    0 = без встроенного режима безопасности.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: int

    IsSingleUser

    Server запущен в однопользовательском режиме.

    1 = однопользовательский режим.

    0 = не однопользовательский режим.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: int

    LCID

    Код локали (LCID) Windows для параметров сортировки.

    Базовый тип данных: int

    LicenseType

    Не используется. Лицензионная информация не сохраняется и не поддерживается продуктом SQL Server. Всегда возвращает DISABLED.

    Базовый тип данных: nvarchar(128)

    MachineName

    Имя компьютера Windows, на котором запущен экземпляр сервера.

    Для кластеризованного экземпляра SQL Server, работающего на виртуальном сервере Microsoft Cluster Service, возвращается имя виртуального сервера.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: nvarchar(128)

    NumLicenses

    Не используется. Лицензионная информация не сохраняется и не поддерживается продуктом SQL Server. Всегда возвращает значение NULL.

    Базовый тип данных: int

    ProcessID

    Свойство Process ID службы SQL Server. По свойству ProcessID удобно определять, какой файл Sqlservr.exe принадлежит этому экземпляру.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: int

    ProductVersion

    Версия экземпляра SQL Server в формате 'major.minor.build'.

    Базовый тип данных: nvarchar(128)

    ProductLevel

    Уровень версии экземпляра SQL Server.

    Возвращает одно из следующих значений.

    'RTM' = Исходная выпущенная версия.

    «SPn» = версия пакета обновления

    'CTP', = CTP-версия.

    Базовый тип данных: nvarchar(128)

    ResourceLastUpdateDateTime

    Отображаются дата и время последнего изменения базы данных Resource.

    Базовый тип данных: datetime

    ResourceVersion

    Возвращает версию базы данных Resource.

    Базовый тип данных: nvarchar(128)

    ServerName

    Сведения об экземпляре и сервере Windows, связанные с определенным экземпляром SQL Server.

    NULL = недопустимый ввод или произошла ошибка.

    Базовый тип данных: nvarchar(128)

    SqlCharSet

    Идентификатор кодировки SQL из идентификатора параметров сортировки.

    Базовый тип данных: tinyint

    SqlCharSetName

    Имя кодировки SQL из параметров сортировки.

    Базовый тип данных: nvarchar(128)

    SqlSortOrder

    Идентификатор порядка сортировки SQL из параметров сортировки

    Базовый тип данных: tinyint

    SqlSortOrderName

    Имя порядка сортировки SQL из параметров сортировки

    Базовый тип данных: nvarchar(128)

    FilestreamShareName

    Имя общего ресурса, используемое FILESTREAM.

    FilestreamConfiguredLevel

    Настроенный уровень доступа FILESTREAM. Дополнительные сведения см. в разделе Параметр уровня доступа файлового потока.

    FilestreamEffectiveLevel

    Действующий уровень доступа FILESTREAM. Это значение может отличаться от значения FilestreamConfiguredLevel, если уровень был изменен и ожидается перезапуск экземпляра или перезагрузка компьютера. Дополнительные сведения см. в разделе Параметр уровня доступа файлового потока.

Типы возвращаемых значений

sql_variant

Замечания

Свойство ServerName

Свойство ServerName функции SERVERPROPERTY, а также функция @@SERVERNAME возвращают аналогичные сведения. В свойстве ServerName задаются имена экземпляра и сервера Windows, которые вместе образуют уникальный экземпляр сервера. Функция @@SERVERNAME возвращает текущее имя локального сервера.

Свойство ServerName и функция @@SERVERNAME возвращают одинаковые сведения, если установленное по умолчанию имя сервера не было изменено во время установки. Имя локального сервера можно настроить, выполнив следующие команды:

EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO

Если имя локального сервера было изменено во время установки и отличается от заданного по умолчанию, то функция @@SERVERNAME будет возвращать новое имя.

Свойства версии

Функция SERVERPROPERTY возвращает отдельные свойства, которые относятся к сведениям о версии, а функция @@VERSION объединяет выходные данные в одну строку. Если для приложения требуются отдельные строки свойств, можно использовать функцию SERVERPROPERTY, которая возвращает эти строки, а не заниматься синтаксическим анализом результатов функции @@VERSION.

Примеры

В следующем примере используется функция SERVERPROPERTY в инструкции SELECT для возвращения сведений о текущем сервере. Этот сценарий полезен, когда на сервер Windows установлено несколько экземпляров SQL Server и клиенту приходится открывать другое соединение с тем же экземпляром, использующим текущее соединение.

SELECT CONVERT(sysname, SERVERPROPERTY('servername'));
GO

В следующем примере используется функция SERVERPROPERTY в инструкции SELECT, чтобы получить информацию о версии продукта.

SELECT
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('EngineEdition') AS EngineEdition;
GO

См. также

Справочник

Выпуски и компоненты SQL Server 2008 R2