SERVERPROPERTY (Transact-SQL)
Возвращает сведения о свойстве экземпляра сервера.
Синтаксис
SERVERPROPERTY ( propertyname )
Аргументы
propertyname
Выражение, содержащее сведения о свойстве, возвращаемые серверу. Аргумент propertyname может принимать одно из следующих значений.Свойство
Возвращаемые значения
BuildClrVersion
Версия среды CLR Microsoft.NET Framework, которая использовалась при построении экземпляра SQL Server.
Базовый тип данных: nvarchar(128)
Параметры сортировки
Имя параметров сортировки для сервера, установленного по умолчанию.
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-bit)».
Возвращает:
выпуск «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. Используйте значения этого свойства для определения возможностей и ограничений, таких как максимальное количество ЦП, которые поддерживаются установленным продуктом.
-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
Выпуск компонента Database Engine для экземпляра SQL Server, установленного на сервере.
1 = выпуск Personal или Desktop Engine (Недоступно для SQL Server.);
2 = Standard (Это значение возвращается для выпусков Standard и Workgroup.);
3 = Enterprise (это значение возвращается для выпусков Enterprise, Enterprise Evaluation и Developer);
4 = Express. (Это значение возвращается для выпусков Express, Express with Advanced Services и Windows Embedded SQL.)
Базовый тип данных: 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.
PER_SEAT = режим лицензирования на рабочее место;
PER_PROCESSOR = режим лицензирования на процессор;
DISABLED = лицензирование отключено.
Базовый тип данных: nvarchar(128)
MachineName
Имя компьютера Windows, на котором запущен экземпляр сервера.
Для кластеризованного экземпляра SQL Server, работающего на виртуальном сервере службы Microsoft Cluster Service, возвращается имя виртуального сервера.
NULL = недопустимый ввод или произошла ошибка.
Базовый тип данных: nvarchar(128)
NumLicenses
Количество зарегистрированных на этом экземпляре SQL Server клиентских лицензий для режима лицензирования на рабочее место.
Количество зарегистрированных на этом экземпляре SQL Server процессоров для режима лицензирования на процессор.
Возвращает значение NULL, если сервер работает в других режимах.
Базовый тип данных: int
ProcessID
Идентификатор процесса службы 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