sp_wlprofiler

语法


sp_wlprofiler [ ['drop metrics' ]
	| ['finish' [, <workload_id_name> ] ]
	| ['help' [, '<action-keyword>' ] ]
	| ['monitor' {,<database_name>} [, <using-clause> ] ]]
     | [{'report' | 'report config’} [, <workload_id_name> ] ] 
	| ['status' [, <workload_id_name> ] ]
	| ['uninstall' ] ]

<using_clause> = USING { <using_item> [, <using_item> ] ...}

<using_item> = { name = workload-name
	| feature = feature-name
	| metricsdb = dbname
	| interval = interval-specifier
	| sample = sample-specifier
	}

参数

drop metrics

从指标数据库中删除所有指标表。例如，从较早的分析会话中删除所有指标表或收集新指标。

finish

结束分析会话。

<workload_ID_name>

通过工作量 ID 或名称标识工作量。<workload_ID> 是内部生成的唯一编号，并通过引在引号中的编号指定。<Name> 可以是用户指定或内部生成的名称。内部生成的工作量名称使用 workload ID=<number> 作为名称格式，其中 <number> 是通过 monitor 参数生成的工作量 ID。

help

显示帮助并输出语法和示例。

<action_keyword>

以下值之一：

drop metrics

finish

help

monitor

report

status

uninstall

monitor {<database_name>} [, <using_clause>]

准备针对目标数据库执行的正在运行的工作量的分析活动。

通过触发影响目标数据库中活动对象和事务日志的监控表和指标的基线数据集合，收集指标。

结束分析间隔并触发包括在基线指标中所有 MDA 表的指标集合。

对新数据库发出 monitor，生成新工作量 ID 并收集可使用 using 参数指定的分析活动的任何用户指定的属性。

对现有分析会话发出 monitor，将收集具有之前会话中提供的 using 参数的数据库的指标。

<using_clause>

指定子参数的逗号分隔列表。<Using_item> 是以下内容之一：

name =<workload_name> – 命名正在分析的工作量。<Workload_name> 应至少有一个字母字符。如果不用 <using_clause> 指定 <workload_name>，sp_wlprofiler 会使用 Workload ID= 形式的缺省名称。

feature =<feature_name> – 指定由工作量分析器评估的 SAP ASE 功能。由工作量分析器评估的缺省功能名称是 DRC（数据行高速缓存）。

metrics =<database_name> – 存储了存储由工作量分析器收集的指标的数据库的名称。缺省值为 sybdsamdb。

interval =<interval_specifier> – 指定工作量分析器监控工作量期间的时间间隔，为该实用程序的计划阶段收集指标。格式是开放的：可以使用正整数以秒为单位指定时间（例如，针对 2 分钟指定 120），或者可以 <hh:mm:ss> 格式进行指定。缺省监控分析间隔为 5 分钟。<Interval_specifier> 允许可选的单引号。

sample =<interval_specifier> – 指定由分析器对特定指标进行定期采样和存档的时间间隔（以秒为单位）。格式是开放的：可以使用正整数以秒为单位指定时间（例如，针对 2 分钟指定 120），或者可以 <hh:mm:ss> 格式进行指定。缺省采样间隔为 120 秒（2 分钟），表示每隔 120 秒对指标进行一次采样。<Interval_specifier> 允许可选的单引号。

database_name

目标数据库的名称。

<workload_id_name>

计划工作量的名称或 ID。

状态 [<workload_id_name>]

输出最近工作量分析的状态。当数据库分析完成时，其状态和信息会存储在控制表中，包括如 workload ID 和 name、target database、metrics database、start date、end data 等的信息。信息通过 status 参数显示。发出不含任何参数的 status 将显示系统中最新活动工作量的状态。包括 <workload_ID> 或 <name>，显示此 ID 或名称的状态。

report

报告由 IMRS 限定的表、IMRS 高速缓存大小和 imrslog 大小。分数高于阈值的表是由 IMRS 限定的。

uninstall

卸载所有过程、控制表和其它由工作量分析器的 installwlprofiler 脚本安装的对象。

示例

示例 1

收集 tpcc 数据库的指标。首先收集基线指标，然后每隔 50 秒定期收集新指标。监控 10 分钟后，结束工作量分析并收集最终指标：
```
sp_wlprofiler 'monitor', 'tpcc', 
"using name = DailyWorkload,
metricsdb = tempdb,
sample = '50',
interval = '00:10:00'"
```
示例 2

收集 tpcc 数据库的指标。以之前运行提供的参数运行工作量分析。
```
sp_wlprofiler 'monitor', 'tpcc'
```
示例 3

显示 ID 为 10 的工作量分析器的状态：
```
sp_wlprofiler 'status', '10'
```
示例 4

显示最新活动工作量分析的状态：
```
sp_wlprofiler 'status'
```
示例 5

显示指定 ID 的工作量的计划（在此示例中，ID 号为 10）：
```
sp_wlprofiler 'plan', '10'
```
示例 6

在之前完成的所有指标数据库或活动分析会话中删除所有指标表：
```
sp_wlprofiler 'drop metrics'
```
示例 7

完成最新活动工作量会话，并完成 ID 为 2 的活动工作量会话：
```
sp_wlprofiler 'finish'
sp_wlprofiler 'finish', '2'
```
示例 8

报告
```
sp_wlprofiler 'report ', '1'
```
示例 9

报告
```
sp_wlprofiler 'report config', '1'
```
示例 14

删除为工作量分析器安装的所有过程、视图和控制表：

```

sp_wlprofiler 'uninstall'

用法

drop metrics 参数只删除发出 monitor 参数时重建的指标表。

finish 参数将工作量分析活动标记为已完成，因此在 finish 运行之后不再收集更多指标作为工作量的一部分。

如果手动将新的指标表添加到控制表中，并以 show 参数显示，则必须首先存在指标表。

不能针对相同的工作量同时运行 plan。

uninstall 删除系统中的所有内容。必须重新运行 installwlprofiler 脚本以重新安装工作量分析器。

sp_wlprofiler

语法

参数

示例

示例 1

示例 2

示例 3

示例 4

示例 5

示例 6

示例 7

示例 8

示例 9

示例 14

用法