第七十八章 SQL命令 TUNE TABLE

基于代表性数据调优表。

大纲

TUNE TABLE tablename [ tune_options ]

参数

tablename - 要调优的现有表的名称。
表名可以是限定的(schema.table)，也可以是非限定的(table)。
非限定表名接受默认模式名。
tune_options - 可选—如果指定，一个或多个TUNE TABLE选项，以任意顺序指定，由空格分隔。
这些tune_options不区分大小写。

描述

TUNE TABLE命令根据表中当前的数据对现有表进行调优。
该数据应该代表表完全填充时所期望的数据。

TUNE TABLE根据代表性数据计算和设置表的块大小、选择性和范围大小。
通常，TUNE TABLE设置一个或多个这些值，并清除所有使用这个持久类(表)的缓存查询，以便查询将使用这些新值。
但是，如果TUNE TABLE没有更改这些值(例如，自上次对该表运行TUNE TABLE以来数据没有更改)，则缓存查询不会被清除，该表的类定义也不会被标记为需要重新编译。

TUNE TABLE更新SQL表定义(因此需要特权来更改表定义)。
通常，TUNE TABLE还会更新相应的持久类定义。
这允许查询优化器使用调优后的值，而不需要进行类编译。
但是，如果部署了类，那么TUNE TABLE只更新SQL表定义;
查询优化器间接使用表定义中的调优值。

如果TUNE TABLE成功，它将SQLCODE设置为0。
如果指定的表名不存在，TUNE TABLE将发出SQLCODE -30错误。

权限

TUNE TABLE命令是一个特权操作。
用户必须具有%ALTER_TABLE管理权限才能执行TUNE TABLE。
如果不这样做，将导致%msg的SQLCODE -99错误，User 'name' does not have %ALTER_TABLE privileges。
如果拥有适当的权限，可以使用GRANT命令为用户或角色分配%ALTER_TABLE权限。
管理权限是特定于名称空间的。

用户必须对指定的表具有%ALTER权限。
如果用户是表的Owner(创建者)，则自动授予该用户对该表的%ALTER权限。
否则，用户必须被授予%ALTER权限。
如果不这样做，将导致一个带有%msg的SQLCODE -99错误。
可以通过调用%CHECKPRIV命令来确定当前用户是否具有%ALTER权限。
可以使用GRANT命令为指定的表分配%ALTER权限。

调表选项

%KEEP_UP_TO_DATE:如果未指定(默认值)，则未设置修改后的类定义上的最新标志。
这表明类定义已经过期，并且被标记为需要重新编译。
如果指定，则类定义将保持标记为最新的。
这是在活动系统上更改统计信息时的首选选项，因为它降低了重新编译表类定义的可能性。
%CLEAR_VALUES:如果指定了现有的SELECTIVITY, EXTENTSIZE等值将从类和表定义中清除。
不指定此选项将提供默认的调优表行为。
%SAMPLE_PERCENT百分比:指定用于对TuneTable实用程序的数据进行抽样的表行的百分比。
这个百分比可以指定为。##或##%;
例如，在采样数据时，.12或12%将导致TuneTable使用表中12%的行。
指定大于0且小于等于100%的百分比值;
超出此范围的值将发出SQLCODE -1错误。
这个值通常不需要指定。
仅当字段的潜在离群值不是均匀分布在整个表的行中时指定此值。
注意，对于任何区段大小< 1000行的表，无论%SAMPLE_PERCENT值如何，整个区段都将由TuneTable使用。
%RECOMPILE_CQ:如果指定了，TuneTable将使用新的调优表统计信息重新编译缓存的查询类，而不仅仅是清除调优表的缓存查询。
不指定此选项将提供默认的TuneTable行为。

如果指定的tune_options值不存在，TUNE TABLE将发出SQLCODE -25错误。
如果两次指定相同的tune_options值，TUNE TABLE将发出SQLCODE -326错误。

缓存查询

执行TUNE TABLE将创建一个缓存查询。
显示“Show Plan”表示没有创建查询计划。
未创建SQL语句。
缓存的查询对名称空间是通用的;
在具体的表格中没有列出。
可以使用缓存查询重新运行相同的TUNE TABLE语句。

执行TUNE TABLE将清除指定表的所有现有缓存查询，包括上次执行TUNE TABLE的缓存查询。
可以选择让TUNE TABLE使用新的TUNE TABLE值重新编译所有这些缓存的查询。

如果运行TUNE TABLE没有更改任何TUNE TABLE值，则不会清除缓存的查询。

运行调优表的其他方法

有两个其他接口运行Tune Table:
- 通过使用Management Portal SQL接口Actions下拉列表，您可以在单个表或模式中的所有表上运行Tune Table。
- 为单个表或当前名称空间中的所有表调用$SYSTEM.SQL.Stats.Table.GatherTableStats()方法。

示例

下面的动态SQL示例调优一个表:

ClassMethod TuneTable()
{
    try {
        s mysql = "TUNE TABLE Sample.MyTest %KEEP_UP_TO_DATE"
        s tStatement = ##class(%SQL.Statement).%New()
        s qStatus = tStatement.%Prepare(mysql)
        if qStatus '= 1 {
            w "%Prepare failed:" 
            d $System.Status.DisplayError(qStatus) 
            q
        }
        s rset = tStatement.%Execute()
        if rset.%SQLCODE = 0 { 
            w !,"Executed Tune Table",! 
        } else { 
            s badSQL=##class(%Exception.SQL).%New(,rset.%SQLCODE,,rset.%Message)
            throw badSQL }
        ret
    }
    catch exp { 
        w "In the CATCH block",!
        if 1 = exp.%IsA("%Exception.SQL") {
            w "SQLCODE: ",exp.Code,!
            w "Message: ",exp.Data,! 
        } else { 
            w "Not an SQL exception",! 
        }
        ret
    }
}