数据库服务器属性

下表列出了在整个数据库服务器上应用的属性。

可以使用 PROPERTY 系统函数检索单个属性的值，也可使用 sa_eng_properties 系统过程检索所有数据库服务器属性的值。属性名称不区分大小写。

示例

♦ 检索数据库服务器属性的值

使用 PROPERTY 系统函数。例如，以下语句返回用于全局服务器数据结构的高速缓存页数：
SELECT PROPERTY ( 'MainHeapPages' );

♦ 检索所有服务器属性的值：

使用 sa_eng_properties 系统过程：
CALL sa_eng_properties;

另请参见

说明

属性说明

ActiveReq 返回当前处理请求的服务器线程数。

AvailIO 返回当前可用的 I/O 控制块数。

BuildChange 保留。

BuildClient 保留。

BuildProduction 如果数据库服务器是为了用于生产而编译的，则返回 Yes；如果数据库服务器为调试内部版本，则返回 No。

BuildReproducible 保留。

BytesReceived 返回在客户端/服务器通信期间所收到的字节数。此值对于 HTTP 和 HTTPS 连接会进行更新。

BytesReceivedUncomp 返回在禁用压缩的情况下，在客户端/服务器通信期间所收到的字节数。（在禁用压缩的情况下该值与 BytesReceived 的值相同。）

BytesSent 返回在客户端/服务器通信期间所发送的字节数。此值对于 HTTP 和 HTTPS 连接会进行更新。

BytesSentUncomp 返回在禁用压缩的情况下，在客户端/服务器通信期间所发送的字节数。（在禁用压缩的情况下该值与 BytesSent 的值相同。）

CacheAllocated 返回已为服务器数据结构分配的高速缓存页数。

CacheFile 返回用于存放数据库文件中数据的高速缓存页数。

CacheFileDirty 返回处于脏状态的高速缓存页数（需要写操作）。

CacheFree 返回未在使用的高速缓存页数。

CacheHits 返回数据库页查找次数。

CachePanics 返回高速缓存管理器未能找到要分配页的次数。

CachePinned 返回固定高速缓存页数。

CacheRead 返回高速缓存读取次数。

CacheReplacements 返回高速缓存中已替换的页数。

CacheScavenges 返回高速缓存管理器清除回收以分配页的次数。

CacheScavengeVisited 返回在清除回收以分配页期间访问的页数。

CacheSizingStatistics 如果服务器在重新调整高速缓存大小时显示高速缓存大小调整统计信息，则返回 Yes；否则，返回 No。请参见-cs 服务器选项。

CarverHeapPages 返回供短期使用（如查询优化）的堆页数。

CharSet 返回数据库服务器所使用的 CHAR 字符集。

ClientStmtCacheHits 返回因客户端语句高速缓存而不需要进行的准备的数目。如果禁用了客户端语句高速缓存，则为必需的附加准备数。请参见max_client_statements_cached 选项 [数据库]。

ClientStmtCacheMisses 返回客户端语句高速缓存中再次准备的语句数。即为由于模式更改、数据库选项设置或 DROP VARIABLE 语句等原因而使本打算重用的某个高速缓存的语句无法重用的次数。请参见max_client_statements_cached 选项 [数据库]。

CollectStatistics 返回 Yes 或 No，指示数据库服务器是否正在收集性能统计信息。请参见-k 服务器选项。

CommandLine

返回用于启动数据库服务器的命令行。

如果数据库的加密密钥是使用 -ek 选项指定的，则该密钥在由此属性返回的值中将以星号字符串常量代替。

CompactPlatformVer 返回 PlatformVer 属性的精简版本。

CompanyName 返回拥有此软件的公司的名称。

ConnsDisabled

返回 Yes 或 No，指示用于禁用新连接的服务器选项的当前设置。请参见sa_server_option 系统过程。

ConsoleLogFile 如果指定了 -o 选项，则返回用于记录数据库服务器消息的文件的名称；否则，返回一个空字符串。请参见-o 服务器选项和记录数据库服务器操作。

ConsoleLogMaxSize 返回用于记录数据库服务器消息的文件的最大大小（以字节为单位）。请参见-os 服务器选项。

CurrentCacheSize 返回当前高速缓存大小（以千字节为单位）。

DebuggingInformation 如果服务器显示用于进行排除故障的诊断消息，则返回 Yes；否则，返回 No。请参见-z 服务器选项。

DefaultCollation 返回如果没有明确指定，将用于新数据库的归类。

DefaultNcharCollation 返回服务器计算机上缺省 NCHAR 归类的名称（如果安装了 ICU，则为 UCA；否则为 UTF8BIN）。

DiskRead 返回磁盘读取次数。

DiskReadHintScatterLimit 返回对分散读取提示大小（以字节为单位）的强加限制。

DiskRetryRead 返回磁盘读取重试的次数。

DiskRetryReadScatter 返回分散读取的磁盘读取重试次数。

DiskRetryWrite 返回磁盘写入重试的次数。

EventTypeDesc 返回与给定事件类型 ID 相关联的系统事件类型说明。

EventTypeName 返回与给定事件类型 ID 相关联的系统事件类型名称。

ExchangeTasks 返回当前用于并行执行查询的任务数。

ExchangeTasksCompleted 返回自数据库服务器启动以来已用于查询内并行机制的内部任务总数。请参见查询执行期间的并行。

FipsMode 如果在启动数据库服务器时指定了 -fips 选项，则返回 Yes；否则，返回 No。

FirstOption 返回一个数字，表示与某个数据库选项相对应的第一个连接属性。

FreeBuffers 返回可用的网络缓冲区数。

FunctionMaxParms

返回最多可为函数指定的参数个数。函数通过 function-number 所指定的值进行标识，该值是一个正整数。例如：

SELECT PROPERTY ( 'FunctionMaxParms', function-number );

请注意，function-number 在不同的版本之间可能会发生变化。

FunctionMinParms

返回必须为函数指定的最少参数个数。函数通过 function-number 所指定的值进行标识，该值是一个正整数。例如：

SELECT PROPERTY ( 'FunctionMaxParms', function-number );

请注意，function-number 在不同的版本之间可能会发生变化。

FunctionName

返回通过 function-number 指定的值（该值是一个正整数）所标识的函数的名称：

SELECT PROPERTY ( 'FunctionName', function-number );

请注意，function-number 在不同的版本之间可能会发生变化。

HeapsCarver 返回供短期使用（如查询优化）的堆数。

HeapsLocked 返回高速缓存中当前锁定的可重定位堆数。

HeapsQuery 返回用于查询处理（散列和排序操作）的堆数。

HeapsRelocatable 返回可重定位堆数。

HttpAddresses

返回服务器为 HTTP 连接正在监听的 TCP/IP 地址的列表（以分号分隔）。例如：

(::1):80;127.0.0.1:80

HttpNumActiveReq 返回正在主动处理 HTTP 请求的 HTTP 连接数。不包括已发送其响应的 HTTP 连接。

HttpNumConnections 返回数据库服务器中当前打开的 HTTP 连接数。这些连接可能正在主动处理请求，或者正在长寿命（保持活动状态）连接队列中等待。

HttpNumSessions 返回数据库服务器中活动的和休眠的 HTTP 会话数量。

HttpPorts 返回 Web 服务器的 HTTP 端口号列表（以逗号分隔）。

HttpsAddresses

返回服务器为 HTTPS 连接正在监听的 TCP/IP 地址的列表（以分号分隔）。例如：

(::1):443;127.0.0.1:443

HttpsNumActiveReq 返回正在主动处理 HTTPS 请求的安全 HTTPS 连接数量。不包括已发送其响应的 HTTPS 连接。

HttpsNumConnections 返回数据库服务器中当前打开的 HTTPS 连接数。这些连接可能正在主动处理请求，或者正在长寿命（保持活动状态）连接队列中等待。

HttpsPorts 返回 Web 服务器的 HTTPS 端口号列表（以逗号分隔）。

IdleTimeout 返回缺省空闲超时值。请参见-ti 服务器选项。

IsEccAvailable 如果安装了 ECC DLL，则返回 Yes；否则，返回 No。

IsFipsAvailable 如果安装了 FIPS DLL，则返回 Yes；否则，返回 No。

IsNetworkServer 如果连接到网络数据库服务器，则返回 Yes；如果连接到个人数据库服务器，则返回 No。

IsRsaAvailable 如果安装了 RSA DLL，则返回 Yes；否则，返回 No。

IsRuntimeServer 如果连接到受限的桌面运行时数据库服务器，则返回 Yes；否则，返回 No。

IsService 如果数据库服务器是作为服务来运行，则返回 Yes，否则返回 No。

Language 返回服务器的地区语言。

LastConnectionProperty 返回表示最后一个连接属性的数字。

LastDatabaseProperty 返回表示最后一个数据库属性的数字。

LastOption 返回一个数字，表示与某个数据库选项相对应的最后一个连接属性。

LastServerProperty 返回表示最后一个服务器属性的数字。

LegalCopyright 返回软件的版权字符串。

LegalTrademarks 返回软件的商标信息。

LicenseCount 返回被授权的存取设备或处理器数量。

LicensedCompany 返回被授权公司的名称。

LicensedUser 返回被授权用户的名称。

LicenseType 返回许可类型。可以是联网存取设备（每存取设备）或基于 CPU 的类型。

LivenessTimeout 返回客户端活动超时缺省值。请参见-tl 服务器选项。

LockedCursorPages 返回用于使游标堆在内存中保持固定的页数。

LockedHeapPages 返回高速缓存中锁定的堆页数。

MachineName 返回运行数据库服务器的计算机名称。通常，这是计算机的主机名。

MainHeapBytes 返回用于全局服务器数据结构的字节数。

MainHeapPages 返回用于全局服务器数据结构的页数。

MapPhysicalMemoryEng 返回使用 Address Windowing Extensions 映射到高速缓存中物理内存的数据库页地址空间窗口的数量。

MaxCacheSize 返回所允许的最大高速缓存大小（以千字节为单位）。

MaxConnections

返回服务器允许的最大并发连接数。对于个人服务器，此值在缺省情况下为 10。对于网络服务器，此值在缺省情况下约为 32000。可使用 -gm 服务器选项降低此值。请参见-gm 服务器选项。

受计算机资源所限，网络服务器的连接数通常低于缺省值。

MaxEventType 返回最大有效事件类型 ID。

MaxMessage 不建议使用。返回可从数据库服务器消息窗口检索的当前最大行号。它表示数据库服务器消息窗口中显示的最新消息。

MaxRemoteCapability 返回最大有效功能 ID。

Message, linenumber

不建议使用。返回数据库服务器消息窗口中的某一行，前面带有消息出现的日期和时间。第二个参数指定行号。

由 PROPERTY( "message" ) 返回的值是写入数据库服务器消息窗口的第一行输出。调用 PROPERTY( "message", n ) 会返回服务器输出的第 n 行（0 为第一行）。缓冲区是有限的，因此随着消息不断被生成，前面的行可能被删除且不再存储在内存中。在这种情况下，返回 NULL。

MessageCategoryLimit 返回可使用 sa_server_messages 系统过程检索的各个严重级和类别的最小消息数。缺省值为 400。请参见sa_server_messages 系统过程。

MessageText, linenumber 不建议使用。返回与数据库服务器消息窗口中所指定的行号相关联的文本，前面不带日期和时间。第二个参数指定行号。

MessageTime, linenumber 不建议使用。返回与数据库服务器消息窗口中所指定的行号相关联的日期和时间。第二个参数指定行号。

MessageWindowSize 不建议使用。返回可从数据库服务器消息窗口检索的最大行数。

MinCacheSize 返回所允许的最小高速缓存大小（以千字节为单位）。

MultiPacketsReceived 返回在客户端/服务器通信期间所收到的多包请求数。

MultiPacketsSent 返回在客户端/服务器通信期间所发送的多包请求数。

MultiPageAllocs 返回多页高速缓存分配数。

MultiProgrammingLevel 返回服务器最多可以处理的并发任务数。如果并发任务数大于此值，则会将请求送入队列。可使用 -gn 服务器选项对此进行更改。请参见-gn 服务器选项。

Name 如果指定了用于连接到数据库的服务器的替代名称，则返回该名称；否则，返回实际服务器名。请参见-sn 数据库选项。

NativeProcessorArchitecture

返回一个字符串，它标识了可对处理器进行模拟的平台（如 Win64 上的 X86）上的本地处理器类型。在所有其它情况下，其返回值与 property( 'ProcessorArchitecture' ) 的返回值相同。

值可以包括：

32 位 Windows（Windows Mobile 除外）- X86
Windows Mobile - ARM
64 位 Windows - X86_64
Solaris - SPARC 或 X86_64
AIX - PPC
MAC OS - X86 或 X86_64
HP - IA64
Linux - X86 或 X86_64

有关支持的平台的完整列表，请参见 [external link] http://www.sybase.com/detail?id=1062617。

NumLogicalProcessors 返回服务器计算机上已启用的逻辑处理器数（包括内核和超线程）。

NumLogicalProcessorsUsed 返回数据库服务器将要使用的逻辑处理器数。在 Windows 上，可使用 -gtc 选项更改所使用的逻辑处理器数。请参见-gtc 服务器选项。

NumPhysicalProcessors 返回服务器计算机上已启用的物理处理器数。此值是用 NumLogicalProcessors 除以每个物理处理器的内核或超线程数得到的。在某些非 Windows 平台上，可能会将内核或超线程计为物理处理器。

NumPhysicalProcessorsUsed 返回数据库服务器将要使用的物理处理器数。在某些平台上，个人服务器仅限使用一个处理器。在 Windows 上，可使用 -gt 选项更改网络数据库服务器所使用的物理处理器数。请参见-gt 服务器选项。

OmniIdentifier 此属性保留供系统使用。请不要更改此选项的设置。

PacketsReceived 返回所收到的客户端/服务器通信包数。此值对于 HTTP 和 HTTPS 连接不会进行更新。

PacketsReceivedUncomp

返回在禁用压缩的情况下，在客户端/服务器通信期间所收到的包数。（在禁用压缩的情况下，该值与 PacketsReceived 的值相同。）

PacketsSent 返回所发送的客户端/服务器通信包数。此值对于 HTTP 和 HTTPS 连接不会进行更新。

PacketsSentUncomp 返回在禁用压缩的情况下，在客户端/服务器通信期间所发送的包数。（在禁用压缩的情况下，该值与 PacketsSent 的值相同。）

PageSize 返回数据库服务器高速缓存页的大小。可以使用 -gp 选项设置该值，否则为命令行中指定数据库的数据库页面的最大值。

PeakCacheSize 返回高速缓存在当前会话中已达到的最大值（以千字节为单位）。

Platform 返回运行软件的操作系统。例如，如果您正运行在 Windows 2000 上，则此属性返回 Windows2000。

PlatformVer 返回运行软件的操作系统，其中包括内部版本号、服务包等。例如，可以返回 Windows 2000 Build 2195 Service Pack 3。

ProcessCPU

返回数据库服务器进程的 CPU 使用情况。这些值以秒为单位。在 Windows 和 Unix 上支持此属性。在 Windows Mobile 上不支持此属性。

此属性的返回值是自启动数据库服务器以来的累计值。该值与应用程序（如 Windows 任务管理器或 Windows 性能监控器）所返回的瞬时值不匹配。

ProcessCPUSystem

返回数据库服务器进程 CPU 的系统 CPU 使用情况。这是数据库服务器花费在操作系统内核中的 CPU 时间。这些值以秒为单位。在 Windows 和 Unix 上支持此属性。在 Windows Mobile 上不支持此属性。

此属性的返回值是自启动数据库服务器以来的累计值。该值与应用程序（如 Windows 任务管理器或性能监控器）所返回的瞬时值不匹配。

ProcessCPUUser

返回数据库服务器进程的用户 CPU 使用情况。这些值以秒为单位。这不包括数据库服务器花费在操作系统内核中的 CPU 时间。在 Windows 和 Unix 上支持此属性。在 Windows Mobile 上不支持此属性。

此属性的返回值是自启动数据库服务器以来的累计值。该值与应用程序（如 Windows 任务管理器或性能监控器）所返回的瞬时值不匹配。

ProcessorArchitecture

返回用于标识处理器类型的字符串。值包括：

32 位 Windows（Windows Mobile 除外）- X86
64 位 Windows - X86_64
Windows Mobile - ARM
Solaris - SPARC 或 X86_64
AIX - PPC
MAC OS - X86
HP - IA64
Linux - X86 或 X86_64

ProductName 返回软件的名称。

ProductVersion 返回正在运行的软件版本。

ProfileFilterConn 如果开启对某特定连接的过程分析，则返回被监控连接的 ID。否则，返回一个空字符串。可使用 sa_server_option 过程来控制用户所进行的过程分析。请参见sa_server_option 系统过程。

ProfileFilterUser 如果开启对某特定用户的过程分析，则返回被监控用户的名称。否则，返回一个空字符串。可使用 sa_server_option 过程来控制用户所进行的过程分析。请参见sa_server_option 系统过程。

QueryHeapPages 返回用于查询处理（散列和排序操作）的高速缓存页数。

QueryMemActiveCurr 返回主动使用查询内存的请求数。

QueryMemActiveEst 返回在数据库服务器处于稳定状态时对主动使用查询内存的请求数平均值的估计。

QueryMemActiveMax 返回主动允许使用查询内存的最大请求数。

QueryMemExtraAvail 返回可用于在基础内存密集型授权之外进行授权的内存量。

QueryMemGrantBase 返回授权给所有请求的最小内存量。

QueryMemGrantBaseMI 返回授权给内存密集型请求的最小内存量。

QueryMemGrantExtra 返回除 QueryMemGrantBaseMI 以外可分发到活动内存密集型请求的查询内存页数。

QueryMemGrantFailed 返回某一请求等待但未能获得查询内存的总次数。

QueryMemGrantGranted 返回当前授予请求的页数。

QueryMemGrantRequested 返回任一请求尝试获取查询内存的总次数。

QueryMemGrantWaited 返回任一请求等待查询内存的总次数。

QueryMemGrantWaiting 返回等待查询内存的当前请求数。

QueryMemPages 返回可用于查询执行算法的内存量，以页数表示。

QueryMemPercentOfCache 返回可用于查询执行算法的内存量，以最大高速缓存大小的百分比表示。

QuittingTime 返回服务器的关机时间。如果没有指定，则该值为 none。

RememberLastPlan 如果服务器正在记录优化程序返回的最后一个查询优化计划，则返回 Yes。请参见-zp 服务器选项。

RememberLastStatement 如果服务器正在记录每个连接所准备的最后一条语句，则返回 Yes；否则，返回 No。请参见-zl 服务器选项。

RemoteCapability 返回与给定功能 ID 相关联的远程功能的名称。

RemoteputWait 返回远程放置等待数。

Req 返回为使服务器可以处理新请求或继续处理现有请求而进入该服务器的次数。

RequestFilterConn 返回正在为其过滤记录信息的连接的 ID，否则，返回 -1。

RequestFilterDB 返回正在为其过滤记录信息的数据库的 ID，否则，返回 -1。

RequestLogFile

返回请求记录文件名。如果没有任何请求记录，则会返回一个空字符串。请参见sa_server_option 系统过程。

RequestLogging

返回 SQL、PLAN、HOSTVARS、PROCEDURES、TRIGGERS、OTHER、BLOCKS、REPLACE、ALL 或 NONE 之一，指示请求记录的当前设置。请参见sa_server_option 系统过程。

RequestLogMaxSize 返回请求日志文件的最大大小。请参见-zs 服务器选项。

RequestLogNumFiles

返回保留的请求日志文件数。请参见sa_server_option 系统过程。

RequestsReceived 返回客户端/服务器通信请求数或往返次数。它与 PacketsReceived 的不同之处在于：多包请求将计为一个请求，并且不包括活动包。

RequestTiming 如果开启请求计时，则返回 Yes；否则，返回 No。可使用 -zt 数据库服务器选项开启请求计时。请参见-zt 服务器选项。

SendFail 返回底层通信协议发送数据包失败的次数。

ServerEdition

返回数据库服务器许可的类型。值包括：

Education
Full Developer Evaluation
Web Authenticated
RunTime
IQ

如果您对于以下任一功能具有单独的许可，则相应的字符串会被添加到返回的许可字符串。

HighAvailability 请参见SQL Anywhere 高可用性组件。
InMemory 请参见SQL Anywhere 内存模式选项。
ECC 请参见SQL Anywhere 安全性组件。
FIPS 请参见SQL Anywhere 安全性组件。

ServerName 返回当前连接的服务器名称。可使用此值确定哪个工作服务器当前在担当数据库镜像配置中的主服务器。请参见数据库镜像简介。

StartDBPermission 返回 -gd 服务器选项的设置，该值可以为 DBA、all 或 none 之一。请参见-gd 服务器选项。

StartTime 返回服务器启动的日期/时间。

StreamsUsed 返回正在使用的数据库服务器流的数量。

TcpIpAddresses

返回服务器为命令序列和 TDS 连接正在监听的 TCP/IP 地址的列表（以分号分隔）。例如：

(::1):2638;127.0.0.1:2638

TempDir 返回服务器存储临时文件的目录。

TimeZoneAdjustment 返回为显示服务器本地时间而必须对协调通用时间（Coordinated Universal Time，简称 UTC）增加的分钟数。

TotalBuffers 返回网络缓冲区的总数。

UniqueClientAddresses 返回连接到网络服务器的唯一客户端网络地址数。

UnschReq 返回当前排队等候可用服务器线程的请求数。

WebClientLogFile 返回 Web 服务客户端日志文件的名称。请参见-zoc 服务器选项。

WebClientLogging 返回一个值，指示是否正在将 Web 服务客户端信息记录到文件中。请参见-zoc 服务器选项。