附录 1 关键字和保留字
以下不带*号的为关键字， 带*号的为系统保留字。
DM 还将保留字进一步划分为 SQL 保留字、DMSQL 程序保留字、模式保留字、变量保留字和别名保留字。对于关键字和保留字的详细信息请查询系统视图 V$RESERVED_WORDS。
注意：关键字 ROWID、TRXID、VERSIONS_STARTTIME、VERSIONS_ENDTIME、VERSIONS_STARTTRXID、VERSIONS_ENDTRXID 和 VERSIONS_OPERATION 不能作为表的列名，即使加上双引号也不行。
A
ABORT、ABSOLUTE*、ABSTRACT*、ACCESSED、ACCOUNT、ACROSS、ACTION、ADD*、ADMIN*、ADVANCED、AFTER、AGGREGATE、ALL*、ALLOW_DATETIME、ALLOW_IP、ALTER*、ANALYZE、AND*、ANY*、APPLY、APR、ARCHIVE、ARCHIVEDIR、ARCHIVELOG、ARCHIVESTYLE、ARRAY*、ARRAYLEN*、AS*、ASC*、ASCII、ASENSITIVE、ASSIGN*、ASYNCHRONOUS、AT、ATTACH、AUDIT*、AUG、AUTHID、AUTHORIZATION*、AUTO、AUTO_INCREMENT*、AUTOEXTEND、AUTONOMOUS_TRANSACTION、AVG
B
BACKED、BACKUP、BACKUPDIR、BACKUPINFO、BACKUPSET、BADFILE、BAKFILE、BASE、BATCH、BEFORE、BEGIN*、BETWEEN*、BIGDATEDIFF*、BIGINT、BINARY*、BIT、BITMAP、BLOB、BLOCK、BOOL*、BOOLEAN、BOTH*、BRANCH、BREADTH、BREAK*、BSTRING*、BTREE、BUFFER、BUILD、BULK、BY*、BYDAY、BYHOUR、BYMINUTE、BYMONTH、BYMONTHDAY、BYSECOND、BYTE*、BYWEEKNO、BYYEARDAY
C
CACHE、CALCULATE、CALL*、CASCADE、CASCADED、CASE*、CASE_SENSITIVE、CAST*、CATALOG、CATCH*、CHAIN、CHANGE、CHAR*、CHARACTER、CHARACTERISTICS、CHECK*、CHECKPOINT、CIPHER、CLASS*、CLOB、CLOSE、CLUSTER*、CLUSTERBTR*、COLLATE、COLLATION*、COLLECT、COLUMN*、COLUMNS、COMMENT*、COMMIT*、COMMITTED、COMMITWORK*、COMPILE、COMPLETE、COMPRESS、COMPRESSED、CONDITIONAL、CONNECT*、CONNECT_BY_ISCYCLE、CONNECT_BY_ISLEAF、CONNECT_BY_ROOT*、CONNECT_IDLE_TIME、CONNECT_TIME、CONST*、CONSTANT、CONSTRAINT*、CONSTRAINTS、CONSTRUCTOR、CONTAINS*、CONTEXT*、CONTINUE*、CONVERT*、COPY、CORRESPONDING*、CORRUPT、COUNT、COUNTER、CPU_PER_CALL、CPU_PER_SESSION、CREATE*、CROSS*、CRYPTO*、CTLFILE、CUBE*、CUMULATIVE、CURRENT*、CURRENT_SCHEMA、CURRENT_USER、CURSOR*、CYCLE
D
DAILY、DANGLING、DATA、DATABASE、DATAFILE、DATE、DATEADD*、DATEDIFF*、DATEPART*、DATETIME、DAY、DBFILE、DDL、DDL_CLONE、DEBUG、DEC、DECIMAL*、DECLARE*、DECODE*、DEFAULT*、DEFERRABLE、DEFERRED、DEFINER、DELETE*、DELETING、DELIMITED、DELTA、DEMAND、DENSE_RANK、DEPTH、DEREF、DESC*、DETACH、DETERMINISTIC、DEVICE、DIAGNOSTICS、DICTIONARY、DIRECTORY、DISABLE*、DISCONNECT、DISKGROUP、DISKSPACE*、DISTINCT*、DISTRIBUTED*、DML、DO*、DOMAIN*、DOUBLE*、DOWN、DROP*、DUMP
E
EACH、EDITIONABLE、ELSE*、ELSEIF*、ELSIF*、EMPTY、ENABLE*、ENCRYPT、ENCRYPTION、END*、EQU*、ERROR、ERRORS、ESCAPE、EVALNAME、EVENTINFO、EVENTS、EXCEPT、EXCEPTION、EXCEPTION_INIT、EXCEPTIONS、EXCHANGE*、EXCLUDE、EXCLUDING、EXCLUSIVE、EXEC*、EXECUTE*、EXISTS*、EXIT*、EXPIRE、EXPLAIN*、EXTENDS、EXTERN*、EXTERNAL、EXTERNALLY、EXTRACT*
F
FAILED_LOGIN_ATTEMPS、FAILED_LOGIN_ATTEMPTS、FAST、FEB、FETCH*、FIELDS、FILE、FILEGROUP、FILESIZE、FILLFACTOR、FINAL*、FINALLY*、FIRST*、FLASHBACK*、FLOAT*、FOLLOWS、FOLLOWING、FOR*、FORALL、FORCE、FOREIGN*、FORMAT、FREQ、FREQUENCE、FRI、FROM*、FULL*、FULLY*、FUNCTION*
G
GENERATED、GET*、GLOBAL、GLOBALLY、GLOBAL_SESSION_PER_USER、GOTO*、GRANT*、GREAT、GROUP*、GROUPING*
H
HASH、HASHPARTMAP、HAVING*、HEXTORAW、HIGH、HOLD、HOUR、HOURLY、HUGE
I
IDENTIFIED、IDENTIFIER、IDENTITY*、IDENTITY_INSERT、IF*、IFNULL*、IGNORE_ROW_ON_DUPKEY_INDEX、IMAGE、IMMEDIATE*、IN*、INCLUDE、INCLUDING、INCREASE、INCREMENT、INDEX*、INDEXES、INDICES、INITIAL、INITIALIZED、INITIALLY、INLINE*、INNER*、INNERID、INPUT、INSENSITIVE、INSERT*、INSERTING、INSTANCE、INSTANTIABLE、INSTEAD、INT*、INTEGER、INTENT、INTERSECT*、INTERVAL*、INTO*、INVISIBLE、IS*、ISOLATION、INACTIVE_ACCOUNT_TIME
J
JAN、JAVA、JOB、JOIN*、JSON、JSON_TABLE*、JUL、JUN
K
KEEP*、KEY、KEYS
L
LABEL、LARGE*、LAST、LAX、LEADING*、LEFT*、LEFTARG、LESS*、LEVEL、LEVELS、LEXER*、LIKE*、LIMIT、LINK、LIST*、LNNVL*、LOB、LOCAL、LOCAL_OBJECT、LOCALLY、LOCATION、LOCK、LOCKED、LOG、LOGFILE、LOGGING、LOGIN*、LOGOFF、LOGON、LOGOUT、LONG、LONGVARBINARY、LONGVARCHAR、LOOP*、LSN
M
MANUAL、MAP、MAPPED、MAR、MATCH、MATCHED、MATERIALIZED、MAX、MAX_RUN_DURATION、MAXPIECESIZE、MAXSIZE、MAXVALUE、MAY、MEM_SPACE、MEMBER*、MEMORY、MERGE、MICRO、MIN、MINEXTENTS、MINUS*、MINUTE、MINUTELY、MINVALUE、MIRROR、MOD、MODE、MODIFY、MON、MONEY、MONITORING、MONTH、MONTHLY、MOUNT、MOVE、MOVEMENT、MULTISET*
N
NATIONAL、NATURAL*、NCHAR、NCHARACTER、NEVER、NEW*、NEXT*、NO、NOARCHIVELOG、NOAUDIT、NOBRANCH、NOCACHE、NOCOPY*、NOCYCLE*、NODE、NOLOGGING、NOMAXVALUE、NOMINVALUE、NOMONITORING、NONE、NONEDITIONABLE、NOORDER、NOPARALLEL、NORMAL、NOROWDEPENDENCIES、NOSORT*、NOT*、NOT_ALLOW_DATETIME、NOT_ALLOW_IP、NOV、NOVALIDATE、NOWAIT、NULL*、NULLS、NUMBER、NUMERIC
O
OBJECT*、OCT、OF*、OFF、OFFLINE、OFFSET、OIDINDEX、OLD、ON*、ONCE、ONLINE、ONLY、OPEN、OPERATOR、OPTIMIZE*、OPTION、OR*、ORDER*、ORDINALITY、OUT*、OUTER、OVER*、OVERLAPS、OVERLAY*、OVERRIDE*、OVERRIDING
P
PACKAGE、PAD、PAGE、PARALLEL、PARALLEL_ENABLE、PARMS、PARTIAL、PARTITION*、PARTITIONS、PASSING、PASSWORD、PASSWORD_GRACE_TIME、PASSWORD_LIFE_TIME、PASSWORD_LOCK_TIME、PASSWORD_POLICY、PASSWORD_REUSE_MAX、PASSWORD_REUSE_TIME、PATH、PENDANT*、PERCENT*、PIPE*、PIPELINED、PIVOT、PLACING、PLS_INTEGER、PRAGMA、PREBUILT、PRECEDES、PRECEDING、PRECISION、PRESERVE、PRETTY、PRIMARY*、PRINT*、PRIOR*、PRIVATE*、PRIVILEGE、PRIVILEGES*、PROCEDURE*、PROFILE、PROTECTED*、PUBLIC*、PURGE
Q
QUERY_REWRITE_INTEGRITY、QUOTA
R
RAISE*、RANDOMLY、RANGE、RAWTOHEX、READ、READ_PER_CALL、READ_PER_SESSION、READONLY、REAL、REBUILD、RECORD*、RECORDS、REDUCED、REF*、REFERENCE*、REFERENCES*、REFERENCING*、REFRESH、REJECT、RELATED、RELATIVE*、RELEASE、RENAME、REPEAT*、REPEATABLE、REPLACE、REPLAY、REPLICATE*、RESIZE、RESTORE、RESTRICT、RESTRICT_REFERENCES、RESULT、RESULT_CACHE、RETURN*、RETURNING*、REVERSE*、REVOKE*、RIGHT*、RIGHTARG、ROLE、ROLLBACK*、ROLLFILE、ROLLUP*、ROOT、ROW*、ROWCOUNT、ROWDEPENDENCIES、ROWID、ROWNUM*、ROWS*、RULE
S
SALT、SAMPLE、SAT、SAVE、SAVEPOINT*、SBYTE*、SCHEMA*、SCHEMABINDING、SCN、SCOPE、SCROLL、SEALED*、SEARCH、SECOND、SECONDLY、SECTION*、SEED、SELECT*、SELF、SENSITIVE、SEP、SEQUENCE、SERERR、SERIALIZABLE、SERVER、SESSION、SESSION_PER_USER、SET*、SETS*、SHADOW、SHARE、SHORT*、SHUTDOWN、SIBLINGS、SIMPLE、SINCE、SIZE、SIZEOF*、SKIP、SMALLINT、SNAPSHOT、SOME*、SOUND、SPACE、SPAN、SPATIAL、SPEED、SPFILE、SPLIT、SQL、STANDBY、STARTUP、STAT、STATEMENT、STATIC*、STDDEV、STOP、STORAGE、STORE、STRICT、STRING、STRIPING、STRUCT*、STYLE、SUBPARTITION*、SUBPARTITIONS、SUBSCRIBE、SUBSTITUTABLE、SUBSTRING、SUBTYPE、SUCCESSFUL、SUM、SUN、SUSPEND、SWITCH*、SYNC、SYNCHRONOUS、SYNONYM*、SYS_CONNECT_BY_PATH、SYSTEM
T
TABLE*、TABLESPACE、TASK、TEMPLATE、TEMPORARY、TEXT、THAN*、THEN、THREAD、THROUGH、THROW*、THU、TIES、TIME、TIME_ZONE、TIMER、TIMES、TIMESTAMP、TIMESTAMPADD*、TIMESTAMPDIFF*、TINYINT、TO*、TOP*、TRACE、TRACKING、TRAILING*、TRANSACTION、TRANSACTIONAL、TRIGGER*、TRIGGERS、TRIM*、TRUNCATE*、TRUNCSIZE、TRXID、TRY*、TUE、TYPE、TYPEDEF*、TYPEOF*
U
UINT*、ULONG*、UNBOUNDED、UNCOMMITTED、UNCONDITIONAL、UNDER、UNION*、UNIQUE*、UNLIMITED、UNLOCK、UNPIVOT、UNTIL*、UNUSABLE、UP、UPDATE*、UPDATING、USAGE、USE_HASH、USE_MERGE、USE_NL、USE_NL_WITH_INDEX、USER*、USHORT*、USING*
V
VALUE、VALUES*、VALIDATE、VARBINARY、VARCHAR、VARCHAR2、VARIANCE、VARRAY*、VARYING、VERIFY*、VERSIONS*、VERSIONS_ENDTIME、VERSIONS_ENDTRXID、VERSIONS_OPERATION、VERSIONS_STARTTIME、VERSIONS_STARTTRXID、VERTICAL、VIEW*、VIRTUAL*、VISIBLE、VOID*、VSIZE
W
WAIT、WED、WEEK、WEEKLY、WHEN*、WHENEVER*、WHERE*、WHILE*、WITH*、WITHIN*、WITHOUT*、WORK、WRAPPED、WRAPPER、WRITE
X
XML*、XMLAGG*、XMLATTRIBUTES*、XMLELEMENT*、XMLPARSE*、XMLTABLE*、XMLNAMESPACES*、XMLSERIALIZE*
Y
YEAR、YEARLY
Z
ZONE
附录 2 SQL 语法书写规则
一 SQL 语法符号
下面分别介绍各 SQL 语法符号的含义：
< > 表示一个语法对象，但是小括号本身不能出现在语句中。
::= 定义符，用来定义一个语法对象。定义符左边为语法对象，右边为相应的语法描述。
| 或者符，或者符限定的语法选项在实际的语句中只能出现一个。
{ } 大括号指明大括号内的语法选项在实际的语句中可以出现 0…N 次(N 为大于 0 的自然数)，但是大括号本身不能出现在语句中。
[ ] 中括号指明中括号内的语法选项在实际的语句中可以出现 0…1 次，但是中括号本身不能出现在语句中。
关键字 关键字在 DM_SQL 语言中具有特殊意义，在 SQL 语法描述中，关键字以大写形式出现。但在实际书写 SQL 语句时，关键字可以为大写也可以为小写。
二 SQL 语法图的说明
SQL 语法图是用来帮助用户正确地理解和使用 DM SQL 语法的图形。阅读语法图时，请按照从上到下，从左到右的方式，依箭头所指方向进行阅读。
SQL 命令、语法关键字等终结符以全大写方式在长方形框内显示，使用时直接输入这些内容；语法参数或语法子句等非终结符的名称以全小写方式在圆角框内显示；各类标点符号显示在圆圈之中。注：如果小写参数中不带下划线_，则表示是由用户输入的参数，带下划线则表示是还需要进一步解释的子句或语法对象，如果在前面已解释过，则未重复列出。
- 必须关键字和参数
1）必须关键字和参数出现在语法参考图的主干路径上，也就是说，出现在当前阅读的水平线上。
例 以用户删除语句为例。DROP、USER、< 用户名 > 和;为必选内容。
用户删除语句语法：
DROP USER <用户名> [RESTRICT | CASCADE];
用户删除语句语法图：
这里 DROP、USER、username 和;都是语句必须的。
2）如果多个关键字或参数并行地出现在从主路径延伸出的多条可选路径中，则只选择其中的一个即可。
例 以 <GROUP BY 子句 > 为例。<group_by 项 > 有四种形式，可以任选一种。如果存在 GROUP BY 子句，则必须从 <group_by 项 > 中选择一种。
<GROUP BY 子句 > 语法：
<GROUP BY 子句> ::= GROUP BY <group_by项>{,<group_by项>}
<group_by项>::=<分组项> | <ROLLUP项> | <CUBE项> | <GROUPING SETS项>
<GROUP BY 子句 > 语法图：
- 可选关键字和参数
如果关键字或参数并行地出现在主路径下方，而主路径是一条直线，则这些关键字和参数是可选的。
例 1 以用户删除语句为例。IF EXISTS、RESTRICT、CASCADE 均是可选项。IF EXISTS 和主干道是二选一的关系；RESTRICT、CASCADE 和主干道是三选一的关系。
用户删除语句语法：
DROP USER [IF EXISTS] <用户名> [RESTRICT | CASCADE];
用户删除语句语法图：
例 2 以 < 分析子句 > 为例。<PARTITION BY 项 >、<ORDER BY 项 > 和 < 窗口子句 > 都是可选的，但出现的前后顺序不能颠倒。
分析函数的 < 分析子句 > 语法：
<分析子句> ::= [<PARTITION BY项>] [<ORDER BY项> ] [<窗口子句>]
用语法图表示 < 分析子句 >：
- 多条路径
如果一张语法参考图有一条以上的路径，可以从任意一条路径进行阅读。如果可以选择多个关键字、操作符、参数或者语法子句，这些选项将被并行地列出。
例 以 < 引用动作 > 为例。引用动作可以选择这四条路径的任一种。
< 引用动作 > 语法：
<引用动作> ::= CASCADE |
SET NULL |
SET DEFAULT |
NO ACTION
< 引用动作 > 语法图：
从语法图可以看出，引用动作可以选择这四种的任一种。
- 循环语法
循环语法表示可以按照需要，使用循环内的语法一次或者多次。
例 以 < 回滚文件子句 > 为例。通过逗号隔开，可以重复语法对象 ‘filepath’ SIZE filesize 多个。
< 回滚文件子句 > 语法：
<回滚文件子句> ::= ROLLFILE <文件说明子句>,{<文件说明子句>}
<文件说明子句> ::= <文件路径> SIZE <文件大小>
< 回滚文件子句 > 语法图：
- 多行语法图
由于有些 SQL 语句的语法十分复杂，生成的语法参考图无法完整地显示在一行之内，于是将其分行显示。阅读此类图形时，请从上至下，从左至右地进行。
例 以索引定义语句为例。索引定义的语法被分成了两行显示。
索引定义语句语法：
CREATE [OR REPLACE] [UNIQUE | BITMAP | CLUSTER] INDEX <索引名>
ON [<模式名>.]<表名>(<列名>{,<列名>}) [<STORAGE子句>];
索引定义语句语法图：
附录 3 系统存储过程和函数
以下为达梦数据库所用到的系统存储过程和函数。
注：函数名右上角有“*”标记的，表示此过程/函数的使用有下面两点限制：
- 此过程/函数不能在 MPP 全局模式下的存储过程中直接调用，在 MPP LOCAL 模式下可在存储过程中直接调用；
- 此过程/函数不能在存储过程中带参数进行动态调用。
1. INI 参数管理
1）SF_GET_PARA_VALUE
定义：
BIGINT
SF_GET_PARA_VALUE (
scope int,
ini_param_name varchar(256)
)
功能说明：
返回 DM.INI 文件中整型的参数值。
参数说明：
scope： 取值为 1、2 。 1 表示从 DM.INI 文件中读取；2 表示从内存中读取。当取值为 1，且 DM.INI 文件中该参数值设置为非法值时，若设置值与参数类型不兼容，则返回默认值；若设置值小于参数取值范围的最小值，则返回最小值；若设置值大于参数取值范围的最大值，则返回最大值。
ini_param_name：DM.INI 文件中的参数名。
返回值：
当前 DM.INI 文件中对应的参数值。
举例说明：
获得 DM.INI 文件中 BUFFER 参数值：
SELECT SF_GET_PARA_VALUE (1, 'BUFFER');
2）SP_SET_PARA_VALUE
定义：
SP_SET_PARA_VALUE (
scope int,
ini_param_name varchar(256)
value bigint
)
或
SP_SET_PARA_VALUE (
bro_flag int,
scope int,
ini_param_name varchar(256)
value bigint
)
或
SP_SET_PARA_VALUE(
inst_name varchar(128),
scope int,
paraname varchar(256),
value bigint
)
功能说明：
供具有 DBA 权限的用户设置 DM.INI 文件中整型的参数值。DSC 环境下，对于需要在各节点保持一致的参数，设置的参数值会在 OK 节点上同步。
参数说明：
scope：取值为 0、1、2 。0 表示修改内存中的动态配置参数值；1 表示 DM.INI 文件和内存参数都修改，不需要重启服务器；2 表示修改 DM.INI 文件的参数值或不在 DM.INI 中的 INI 配置项（具体可参看《DM8 系统管理员手册》2.1.1.1.26 节），修改后需重启服务器生效。
ini_param_name：DM.INI 文件中的参数名。
value：设置的值。
bro_flag：广播标记，取值为 0、1、2、3。0 表示不广播；1 表示广播至 MP 节点；2 表示广播至 BP 节点；3 表示广播至 SP 节点。该参数仅在 DMDPC 集群环境下指定有效。
inst_name：用于指定实例名，该函数重载用于 DPC 环境下修改指定实例的静态或动态配置参数，被修改的配置参数不能是必须同步的参数。
返回值：
无
举例说明：
将 DM.INI 文件中 HFS_CACHE_SIZE 参数值设置为 320：
SP_SET_PARA_VALUE (1,'HFS_CACHE_SIZE',320);
3）SF_GET_PARA_DOUBLE_VALUE
定义：
DOUBLE
SF_GET_PARA_DOUBLE_VALUE (
scope int,
ini_param_name varchar(256)
)
功能说明：
返回 DM.INI 文件中参数中浮点型的参数值。
参数说明：
scope：取值为 1、2 。1 表示从 DM.INI 文件中读取，不在 DM.INI 中的参数不能读取；2 表示从内存中读取；
ini_param_name：DM.INI 文件中的参数名。
返回值：
当前 DM.INI 文件中对应的参数值。
举例说明：
获得 DM.INI 中 CKPT_FLUSH_RATE 的参数值：
SELECT SF_GET_PARA_DOUBLE_VALUE (1, 'CKPT_FLUSH_RATE');
SELECT SF_GET_PARA_DOUBLE_VALUE (2, 'CKPT_FLUSH_RATE');
4）SP_SET_PARA_DOUBLE_VALUE
定义：
void
SP_SET_PARA_DOUBLE_VALUE (
scope int,
ini_param_name varchar(256),
value double
)
或
SP_SET_PARA_DOUBLE_VALUE (
bro_flag int,
scope int,
ini_param_name varchar(256),
value double
)
或
SP_SET_PARA_DOUBLE_VALUE (
inst_name varchar(128),
scope int,
ini_param_name varchar(256),
value double
)
功能说明：
供具有 DBA 权限的用户设置 DM.INI 参数中浮点型的参数值。DSC 环境下，除了特殊参数以外，其他参数值会在 OK 节点上同步。关于特殊参数的介绍请参考函数 SP_SET_PARA_VALUE 的功能说明。
参数说明：
scope：取值为 0、1、2。0 表示修改内存中的动态配置参数值；1 表示 DM.INI 文件和内存参数都修改，不需要重启服务器；2 表示只可修改 DM.INI 文件，服务器重启后生效。
ini_param_name：DM.INI 文件中的参数名。
value：设置的值。
bro_flag：广播标记，取值为 0、1、2、3。0 表示不广播；1 表示广播至 MP 节点；2 表示广播至 BP 节点；3 表示广播至 SP 节点。该参数仅在 DMDPC 集群环境下指定有效。
inst_name：用于指定实例名，该函数重载用于 DPC 环境下修改指定实例的静态或动态配置参数，被修改的配置参数不能是必须同步的参数。
返回值：
无
举例说明：
将 DM.INI 文件中 INDEX_SKIP_SCAN_RATE 参数值设置为 0.2：
SP_SET_PARA_DOUBLE_VALUE(1,'INDEX_SKIP_SCAN_RATE',0.2);
5）SF_GET_PARA_STRING_VALUE
定义：
VARCHAR
SF_GET_PARA_STRING_VALUE (
scope int,
ini_param_name varchar(256)
)
功能说明：
返回 DM.INI 文件中字符串类型的参数值。
参数说明：
scope： 取值为 1、2 。 1 表示从 DM.INI 文件中读取；2 表示从内存中读取。
ini_param_name：DM.INI 文件中的参数名。
返回值：
当前 DM.INI 文件中对应的参数值。
举例说明：
获得 DM.INI 文件中 TEMP_PATH 参数值：
SELECT SF_GET_PARA_STRING_VALUE (1, 'TEMP_PATH');
6）SP_SET_PARA_STRING_VALUE
定义：
SP_SET_PARA_STRING_VALUE (
scope int,
ini_param_name varchar(256) ,
value varchar(32767)
)
或
SP_SET_PARA_STRING_VALUE (
bro_flag int,
scope int,
ini_param_name varchar(256) ,
value varchar(32767)
)
或
SP_SET_PARA_STRING_VALUE (
inst_name varchar(128),
scope int,
ini_param_name varchar(256) ,
value varchar(32767)
)
功能说明：
供具有 DBA 权限的用户设置 DM.INI 文件中的字符串型参数值。DSC 环境下，除了特殊参数以外，其他参数值会在 OK 节点上同步。关于特殊参数的介绍请参考函数 SP_SET_PARA_VALUE 的功能说明。
参数说明：
scope：取值为 0、1、2 。0 表示修改内存中的动态配置参数值；1 表示 DM.INI 文件和内存参数都修改，不需要重启服务器；2 表示只修改 DM.INI 文件，服务器重启后生效。
ini_param_name：DM.INI 文件中的参数名。
value：设置的字符串的值。
bro_flag：广播标记，取值为 0、1、2、3。0 表示不广播；1 表示广播至 MP 节点；2 表示广播至 BP 节点；3 表示广播至 SP 节点。该参数仅在 DMDPC 集群环境下指定有效。
inst_name：用于指定实例名，该函数重载用于 DPC 环境下修改指定实例的静态或动态配置参数，被修改的配置参数不能是必须同步的参数。
返回值：
无
举例说明：
将 DM.INI 文件中 COMMIT_WRITE 参数值设置为 WAIT：
SP_SET_PARA_STRING_VALUE(1,'COMMIT_WRITE','WAIT');
7）SF_SET_SESSION_PARA_VALUE
定义：
void
SF_SET_SESSION_PARA_VALUE (
paraname varchar(256),
value bigint
)
功能说明：
设置会话级 INI 参数在当前会话上的值。
参数说明：
paraname： 会话级 INI 参数的参数名。
value：要设置的新值。
返回值：
无
举例说明：
将会话级 INI 参数 JOIN_HASH_SIZE 在当前会话上的值设置为 2000：
SF_SET_SESSION_PARA_VALUE ('JOIN_HASH_SIZE', 2000);
8）SP_RESET_SESSION_PARA_VALUE
定义：
void
SP_RESET_SESSION_PARA_VALUE (
paraname varchar(256)
)
功能说明：
重置会话级 INI 参数在当前会话上的值，使得当前会话的参数值和全局值一致。
参数说明：
paraname：会话级 INI 参数的参数名。
返回值：
无
举例说明：
重置会话级 INI 参数 JOIN_HASH_SIZE 在当前会话上的值：
SP_RESET_SESSION_PARA_VALUE ('JOIN_HASH_SIZE');
9）SF_GET_SESSION_PARA_VALUE
定义：
INT
SF_GET_SESSION_PARA_VALUE (
paraname varchar(256)
)
功能说明：
获得整型的会话级 INI 参数的值。
参数说明：
paraname：会话级 INI 参数的参数名。
返回值：
整型的会话级 INI 参数的值。
举例说明：
获取会话级 INI 参数 JOIN_HASH_SIZE 的值：
SELECT SF_GET_SESSION_PARA_VALUE ('JOIN_HASH_SIZE');
10）SF_GET_SESSION_PARA_DOUBLE_VALUE
定义：
DOUBLE
SF_GET_SESSION_PARA_DOUBLE_VALUE (
paraname varchar(256)
)
功能说明：
获得浮点型的会话级 INI 参数的值。
参数说明：
paraname：会话级 INI 参数的参数名。
返回值：
浮点型会话级 INI 参数的值。
举例说明：
获取会话级 INI 参数 SEL_RATE_SINGLE 的值：
SELECT SF_GET_SESSION_PARA_DOUBLE_VALUE ('SEL_RATE_SINGLE');
11）SF_GET_SESSION_PARA_STRING_VALUE
定义：
VARCHAR
SF_GET_SESSION_PARA_STRING_VALUE (
paraname varchar(256)
)
功能说明：
获得字符串类型的会话级 INI 参数的值。
参数说明：
paraname：会话级 INI 参数的参数名。
返回值：
字符串类型的会话级 INI 参数的值。
举例说明：
获取会话级 INI 参数 SQLTUNE_CATEGORY 的值：
SELECT SF_GET_SESSION_PARA_STRING_VALUE ('SQLTUNE_CATEGORY');
12）SF_SET_SYSTEM_PARA_VALUE
定义：
SF_SET_SYSTEM_PARA_VALUE (
paraname varchar(256),
value bigint/double/varchar(256),
deferred int,
scope int
)
或
SF_SET_SYSTEM_PARA_VALUE (
bro_flag int,
paraname varchar(256),
value bigint/double/varchar(256),
deferred int,
scope int
)
或
SF_SET_SYSTEM_PARA_VALUE (
inst_name varchar(128),
paraname varchar(256),
value bigint/double/varchar(256),
deferred int,
scope int
)
功能说明：
修改整型、double、varchar 的静态配置参数或动态配置参数。DSC 环境下，除了特殊参数以外，其他参数值会在 OK 节点上同步。关 SF_SET_SQL_LOG 于特殊参数的介绍请参考函数 SP_SET_PARA_VALUE 的功能说明。
参数说明：
paraname：INI 参数的参数名。
value：要设置的新值。
deferred：是否立即生效。为 0 表示当前 session 修改的参数立即生效；1 表示当前 session 不生效，后续再生效。默认为 0。
scope：取值为 0、1、2 。0 表示修改内存中的动态的配置参数值；1 表示修改 DM.INI 文件或不在 DM.INI 总中的 INI 配置项中的静态或动态参数之后，需重启服务器生效。
bro_flag：广播标记，取值为 0、1、2、3。0 表示不广播；1 表示广播至 MP 节点；2 表示广播至 BP 节点；3 表示广播至 SP 节点。该参数仅在 DMDPC 集群环境下指定有效。
inst_name：用于指定实例名，该函数重载用于 DPC 环境下修改指定实例的静态或动态配置参数，被修改的配置参数不能是必须同步的参数。
返回值：
无
举例说明：
修改 INI 参数 JOIN_HASH_SIZE 的值：
SF_SET_SYSTEM_PARA_VALUE ('JOIN_HASH_SIZE',50,1,1);
13）SF_SET_SQL_LOG
定义：
INT
SF_SET_SQL_LOG (
svrlog int,
svrmsk varchar(1000)
)
功能说明：
设置服务器日志相关 INI 参数 SVR_LOG 和 SQL_TRACE_MASK。
参数说明：
svrlog：INI 参数 SVR_LOG 的设置值。
svrmsk：INI 参数 SQL_TRACE_MASK 的设置值。
返回值：
是否成功。
举例说明：
设置服务器日志相关 INI 参数：
SELECT SF_SET_SQL_LOG(1, '3:5:7');
14）SF_SYNC_INI
定义：
INT
SF_SYNC_INI(
level int
)
功能说明：
用于备库从主库同步 DM.INI 参数。直连备库执行，只对当前的备库有效，不同的备库需要分别单独执行。
对于不同类型的 INI 参数，同步情况说明如下：
- 静态 INI 参数：仅同步 dm.ini 文件值，不同步内存值，备库需要重启才能使用新的参数值；
- 系统级动态 INI 参数：同时同步 dm.ini 文件值与内存值；
- 会话级动态 INI 参数：同步全局内存值，不同步会话上的 INI 参数值；
- 同步的两个节点须同为 V8.1.3.31 之前的版本，或同为大于等于 V8.1.3.31 的版本。若在小于 V8.1.3.31 和大于等于 V8.1.3.31 的两个版本间执行，不会真正同步，而是直接返回成功。
参数说明：
参数说明：
level：同步级别，取值 0 和 1。
0：表示同步所属环境下必须同步的参数 。专用于 DMDSC 和 DMDPC 架构的主备中。在普通环境的主备中执行 SF_SYNC_INI(0)不会同步任何参数。当前环境下必须同步的参数，请参考 V$DM_INI 中 SYNC_FLAG 为 MUST_SYNC 的参数。
1：表示同步所有可以同步的参数。可用于 DMDPC 架构的主备、DMDSC 架构的主备和普通环境的主备中。除了不可被同步的 INI 参数外，其余 INI 参数均可被同步。当前环境下可以被同步的参数，请参考 V$DM_INI 中 SYNC_FLAG 为 CAN_SYNC 的参数。
返回值：
0：执行成功。
<0：执行失败。
100：未执行同步，对方 MAL 消息版本过低或 INI 版本一致无需同步。
举例说明：
在备库上执行，同步主库上所有可以同步的 INI 参数：
SELECT SF_SYNC_INI (1);
15）SF_DSC_SYNC_INI
定义：
INT
SF_DSC_SYNC_INI(
level int
)
功能说明：
用于普通节点从控制节点同步 DM.INI 参数。仅 DMDSC 集群节点生效。函数直连 DMDSC 普通节点执行。只对当前普通节点有效。不同的普通节点需要分别单独执行。在控制节点执行会报错。
仅同步 INI 参数的内存值及 DM.INI 文件值。对于某个会话上的 INI 参数修改，不进行同步。
同步的两个节点须同为 V8.1.3.31 之前的版本，或同为大于等于 V8.1.3.31 的版本。若在小于 V8.1.3.31 和大于等于 V8.1.3.31 的两个版本间执行，不会真正同步，而是直接返回成功。
参数说明：
level：同步级别。取值 0 和 1。0：表示同步所属环境下必须同步的部分参数；1：表示同步所有可以同步的参数。必须同步的部分参数和所有可以同步的参数与 SF_SYNC_INI()中的 DMDSC 参数一样，具体的参数请参考 SF_SYNC_INI()。
返回值：
0：执行成功。
<0：执行失败。
100：对方 MAL 消息版本过低或 INI 版本一致无需同步。
举例说明：
在普通节点上执行，同步控制节点上所有可以同步的 INI 参数：
SELECT SF_DSC_SYNC_INI (1);
16）SP_SET_SQLLOG_INI
定义：
SP_SET_SQLLOG_INI(
raft_id int,
sqllog_config varchar(24575)
)
或
SP_SET_SQLLOG_INI(
sqllog_config varchar(24575)
)
功能说明：
修改 SQLLOG.INI 文件的内容。
参数说明：
raft_id：要修改的 SQLLOG.INI 文件所在的服务器站点号。无此参数表示修改本地的 SQLLOG.INI 文件。
sqllog_config：要修改的内容，模式名用’[]’标出，配置项之间用’;’分隔；若模式名已存在，则修改其配置，对于未设置的配置项，继承原值；对于不存在的模式名，新增模式。当不指定模式名时，认为是全局配置区，全局配置区的模式内配置项只有写在配置串开头时才认为其合法。
返回值：
无。
举例说明：
新增模式 SLOG_CONFIG1 和 SLOG_CONFIG2。
SP_SET_SQLLOG_INI('[SLOG_CONFIG1]FILE_PATH=../log;PART_STOR=0;[SLOG_CONFIG2]SWITCH_MODE=2;SWITCH_LIMIT=128');
17）SP_DELETE_SQLLOG_INI_MODE
定义：
SP_DELETE_SQLLOG_INI_MODE(
raft_id int,
mode_name varchar(128)
)
或
SP_DELETE_SQLLOG_INI_MODE(
mode_name varchar(128)
)
功能说明：
删除 SQLLOG.INI 文件中的模式。
参数说明：
raft_id：要修改的 SQLLOG.INI 文件所在的服务器站点号。无此参数表示修改本地的 SQLLOG.INI 文件。
mode_name：要删除的模式名。
返回值：
无。
举例说明：
删除模式名为 SLOG_ALL 的 SQL 日志模式。
SP_DELETE_SQLLOG_INI_MODE('SLOG_ALL');
18）SP_SET_PARAM_IN_SESSION
定义：
SP_SET_PARAM_IN_SESSION (
SESS_ID BIGINT,
SESS_SEQ INT,
PARANAME VARCHAR(256),
VALUE BIGINT
)
功能说明：
用于设置指定会话的会话级 INI 参数的值。调用此系统过程需要管理员权限。
参数说明：
SESS_ID：会话 ID。
SESS_SEQ：会话序列号。
PARANAME：会话级 INI 参数的参数名。
VALUE：要设置的新值。
返回值：
无
举例说明：
查看当前已存在的会话 ID 和序列号等信息：
SELECT SESS_ID, SESS_SEQ FROM V$SESSIONS;
行号 SESS_ID SESS_SEQ
---------- -------------------- -----------
1 12429400 6
2 13518936 7
设置会话 id 为 13518936 的会话级 INI 参数 JOIN_HASH_SIZE 的值为 2000：
SP_SET_PARAM_IN_SESSION (13518936, 7, 'JOIN_HASH_SIZE', 2000);
19）SP_SET_INI_PARA_VALUE*
定义：
SP_SET_INI_PARA_VALUE (
scope int,
ini_param_name varchar(256) ,
value varchar(32767)
)
功能说明：
设置 DM.INI 文件中的整型，浮点型，字符串型参数值。DSC 环境下，除了特殊参数以外，其他参数值会在 OK 节点上同步。关于特殊参数的介绍请参考函数 SP_SET_PARA_VALUE 的功能说明。
参数说明：
scope：取值为 0、1、2。0 表示修改内存中的动态配置参数值；1 表示 DM.INI 文件和内存参数都修改，不需要重启服务器；2 表示只修改 DM.INI 文件，服务器重启后生效。
ini_param_name：DM.INI 文件中的参数名。
value：设置的字符串的值。
返回值：
无。
举例说明：
将 DM.INI 文件中 HFS_CACHE_SIZE 参数值设置为 320：
SP_SET_INI_PARA_VALUE (1,'HFS_CACHE_SIZE',320);
将 DM.INI 文件中 SEL_RATE_EQU 参数值设置为 0.3：
SP_SET_INI_PARA_VALUE(1, 'SEL_RATE_EQU', 0.3);
将 DM.INI 文件中 COMMIT_WRITE 参数值设置为 WAIT：
SP_SET_INI_PARA_VALUE(1,'COMMIT_WRITE','WAIT');
2. 系统信息管理
1）SP_SET_SESSION_READONLY
定义：
SP_SET_SESSION_READONLY (
readonly int
)
功能说明：
设置当前会话的只读模式。当 INI 参数 USER_READ_ONLY_MODE 的取值为 1（禁止只读用户设置会话为非只读）时，只读用户不能通过 SP_SET_SESSION_READONLY(0)命令取消会话的只读限制。
参数说明：
取值 1 或 0。1 表示对数据库只读；0 表示对数据库为读写。
返回值：
无。
举例说明：
设置当前会话为只读模式：
SP_SET_SESSION_READONLY (1);
2）SP_CLOSE_SESSION
定义：
SP_CLOSE_SESSION (
session_id bigint
)
或
SP_CLOSE_SESSION (
ep_seqno int,
session_id bigint
)
或
SP_CLOSE_SESSION (
session_id bigint,
force_commit boolean
)
功能说明：
停止一个活动的会话，会话 ID 可通过 V$SESSIONS 或 GV$SESSIONS 查询，DM 系统创建的内部 SESSION（PORT_TYPE = 12，但 CONNECTED = 1 的 SESSION）也可通过 V$SESSIONS 或 GV$SESSIONS 查询到。
SP_CLOSE_SESSION()会回滚会话上的当前操作并释放会话，但 SP_CLOSE_SESSION()并不会等待会话真正释放后才返回。
当设置 force_commit 为 TRUE 时，会进行强制会话提交。仅单机和 DSC 环境支持指定 force_commit=true，DPC/MPP 环境执行会报错。如果会话在执行 DDL 类型语句、快速装载或者 XA 分布式事务，指定 force_commit=true 不会强制事务提交，依然进行回滚事务。
中断会话，强制事务提交可能导致事务不一致，用户要能接受可能的不一致，或者说有其他手段恢复事务不一致。
需要注意的是，对于任意会话 sess，假设其会话 ID 为 sess_id，如果先执行 SP_CLOSE_SESSION (sess_id)或者 SP_CLOSE_SESSION (sess_id, false)，或者 sess 客户端主动断开，sess 事务已经开始回滚，再执行 SP_CLOSE_SESSION (sess1_id, true)是不能强制事务提交的。
参数说明：
session_id：指定会话 ID。
ep_seqno：指定会话所在的 DMDSC 集群节点的节点号。
force_commit：指定是否强制提交事务，true 为强制提交，false 为回滚。
举例说明：
例 1 停止 ID 为 510180488 的会话。
SP_CLOSE_SESSION (510180488);
例 2 强制提交事务。
//假设会话SESS1的ID为510180489，且其中对表test1，test2有如下操作
update test1 set count=count+100 where id=100;
update test2 set count=count-100 where id=100;
//对SESS1执行强制事务提交
SP_CLOSE_SESSION (510180489, true);
//查看两表数据，则有可能发现test1和test2的数据无法满足事务一致性，如test1的数据部分更新了，但是test2的数据都还没有更新。
select * from test1;
select * from test2;
3）SF_GET_CASE_SENSITIVE_FLAG/ CASE_SENSITIVE
定义：
INT
SF_GET_CASE_SENSITIVE_FLAG()
或者
INT
CASE_SENSITIVE ()
功能说明：
返回大小写敏感信息。
参数说明：
无
返回值：
1：敏感。
0：不敏感。
举例说明：
获得大小写敏感信息：
SELECT SF_GET_CASE_SENSITIVE_FLAG();
- SESS_CASE_SENSITIVE
定义：
INT
SESS_CASE_SENSITIVE ()
功能说明：
返回会话级大小写敏感信息。
参数说明：
无
返回值：
1：敏感。
0：不敏感。
举例说明：
获得会话级大小写敏感信息：
SELECT SESS_CASE_SENSITIVE();
5）SF_GET_EXTENT_SIZE
定义：
INT
SF_GET_EXTENT_SIZE()
功能说明：
返回簇大小。
参数说明：
无
返回值：
系统建库时指定的簇大小。
举例说明：
获得系统建库时指定的簇大小：
SELECT SF_GET_EXTENT_SIZE ();
6）SF_GET_PAGE_SIZE/PAGE
定义：
INT
SF_GET_PAGE_SIZE()
或者
INT
PAGE()
功能说明：
返回页大小。
参数说明：
无
返回值：
系统建库时指定的页大小。
举例说明：
获得系统建库时指定的页大小：
SELECT SF_GET_PAGE_SIZE ();
补充说明：
获得系统建库时指定的页大小也可使用：
SELECT PAGE();
7）SF_PAGE_GET_SEGID
定义：
INT
SF_PAGE_GET_SEGID(
ts_id int,
file_id int,
page_no int
)
功能说明：
获取目标页所在的段号。
参数说明：
ts_id：指定目标页的表空间，如果表空间不存在，报错。
file_id：指定目标页的文件，如果文件不存在，报错。
page_no：指定目标页的编号，如果编号超出文件范围，报错。
返回值：
页所在的段号。如果返回 0，表示该页是描述页，不属于任何段。
举例说明：
SELECT SF_PAGE_GET_SEGID(4, 0, 2000);
8）SF_PAGE_GET_PAGE_TYPE
定义：
VARCHAR
SF_PAGE_GET_PAGE_TYPE(
ts_id int,
file_id int,
page_no int
)
功能说明：
获取目标页的类型。
参数说明：
ts_id：指定目标页的表空间，如果表空间不存在，报错。
file_id：指定目标页的文件，如果文件不存在，报错。
page_no：指定目标页的编号，如果编号超出文件范围，报错。
返回值：
页的类型。详细如下：
PAGE_NOUSE：没有使用的页。
RESERVED：保留页。
PSEG_MGR：回滚记录管理页。
BLOB_REC_CTL：大字段记录管理页。
BLOB_REC：大字段页。
MTAB_PAGE：临时数据页。
BLOB_PAGE：大字段页。
PSEG_SLOT_CTL：回滚段管理页。
PSEG_UREC：回滚记录页。
INDEX_INNER：索引内节点页。
INDEX_LEAF：索引叶节点页。
DATA_INNER：数据内节点页。
DATA_LEAF：数据页节点页。
TS_HDR：表空间/文件头页。
INODE：段描述页。
BTR_CONTROL：B 树控制页。
EXTENT_DESC：簇描述页。
OTHER：其他页。
举例说明：
SELECT SF_PAGE_GET_PAGE_TYPE(4, 0, 2000);
9）SF_GET_FILE_BYTES_SIZE
定义：
BIGINT
SF_GET_FILE_BYTES_SIZE (
groupid int,
fileid int
)
功能说明：
获取文件字节长度。
参数说明：
groupid：所属的表空间 ID。
fileid：数据库文件 ID。
返回值：
文件字节长度。
举例说明：
获取 0 号文件组中 0 号文件的字节长度：
SELECT SF_GET_FILE_BYTES_SIZE (0,0);
10）SF_GET_UNICODE_FLAG/UNICODE
定义：
INT
SF_GET_UNICODE_FLAG()
或者
INT
UNICODE ()
功能说明：
返回建库时指定的字符集。
参数说明：
无
返回值：
0 表示 GB18030，1 表示 UTF-8，2 表示 EUC-KR。
举例说明：
获得系统建库时指定字符集：
SELECT SF_GET_UNICODE_FLAG ();
11）SF_GET_SGUID
定义：
INT
SF_GET_SGUID ()
功能说明：
返回数据库唯一标志 sguid。
参数说明：
无
返回值：
返回数据库唯一标志 sguid。
举例说明：
获取数据库唯一标志 sguid：
SELECT SF_GET_SGUID();
12）GUID()
定义：
VARCHAR
GUID ()
功能说明：
生成一个唯一编码串（32 个字符）。
返回值：
返回一个唯一编码串。
举例说明：
获取一个唯一编码串：
SELECT GUID();
13）NEWID()
定义：
VARCHAR
NEWID ()
功能说明：
生成一个 SQLSERVER 格式的 guid 字符串 SQLSERVER 的 guid 格式 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
返回值：
返回一个 SQLSERVER 格式的唯一编码串。
举例说明：
获取一个唯一编码串：
SELECT NEWID();
14）SESSID()
定义：
BIGINT
SESSID ( )
功能说明：
获取当前连接的 id。
返回值：
返回当前连接 id。
举例说明：
返回当前连接 id：
SELECT SESSID ();
15）CHECK_INDEX
定义：
INT
CHECK_INDEX (
schname varchar,
indexid int
)
功能说明：
检查一个索引的合法性（正确性和有效性）。检查过程中，会使用 S+IX 锁来封锁索引对应的表对象，如果封锁失败，会忽略索引检查，并记录相关日志到 dmserver 的 log 文件中。
参数说明：
schname：模式名。
indexid：索引 id。
返回值：
0：表示不合法；1：表示合法；2：表示存在未校验的索引。
举例说明：
CREATE INDEX PRODUCT_IND ON PRODUCTION.PRODUCT(PRODUCTID);
//查询系统表得到索引ID
select name, id from sysobjects where name='PRODUCT_IND' and subtype$='INDEX';
select CHECK_INDEX ('PRODUCTION',33555531);
16）CHECK_DB_INDEX
定义：
INT
CHECK_DB_INDEX ()
功能说明：
检查数据库中所有索引的合法性（正确性和有效性）。检查过程中，会使用 S+IX 锁来封锁索引对应的表对象，如果封锁失败，会忽略索引检查，并记录相关日志到 dmserver 的 log 文件中。
返回值：
0：表示不合法；1：表示合法；2：表示除未能检查的索引外，其它索引都合法。
举例说明：
SELECT CHECK_DB_INDEX ();
17）UID
定义：
INT
UID ()
功能说明：
返回当前用户 ID。
参数说明：
无
返回值：
返回当前用户 ID。
举例说明：
返回当前用户 ID：
SELECT UID();
18）USER
定义：
VARCHAR
USER ()
功能说明：
返回当前用户名。
参数说明：
无
返回值：
返回当前用户名：
举例说明：
返回当前用户名
SELECT USER();
19）CUR_DATABASE
定义：
VARCHAR
CUR_DATABASE ()
功能说明：
返回数据库名。
参数说明：
无
返回值：
返回数据库名。
举例说明：
获取数据库名：
SELECT CUR_DATABASE();
20）VSIZE
定义：
INT
VSIZE(n)
功能说明：
返回 n 的核心内部表示的字节数。如果 n 为 NULL，则返回 NULL。
参数说明：
n：待求字节数的参数，可以为任意数据类型。
返回值：
n 占用的字节数。
举例说明：
SELECT VSIZE(256); //整数类型
查询结果为：4
SELECT VSIZE('数据库'); //中文字符
查询结果为：6
21）SP_RECLAIM_TS_FREE_EXTENTS
定义：
SP_RECLAIM_TS_FREE_EXTENTS (
tsname varchar(128)
)
功能说明：
重组表空间空闲簇。
参数说明：
tsname：表空间名。
返回值：
无
举例说明：
重组表空间空闲簇：
SP_RECLAIM_TS_FREE_EXTENTS('SYSTEM');
22）SP_CLEAR_PLAN_CACHE
定义：
SP_CLEAR_PLAN_CACHE()
功能说明：
清空当前站点的执行缓存信息。
参数说明：
无
返回值：
无
举例说明：
清空当前站点的执行缓存信息：
CALL SP_CLEAR_PLAN_CACHE();
23）SP_CLEAR_PLAN_CACHE
定义：
SP_CLEAR_PLAN_CACHE(
plan_id bigint
)
功能说明：
清空当前站点指定的执行缓存信息。
参数说明：
plan_id：指定计划 ID，其值可以从动态视图 V$CACHEPLN 中的 CACHE_ITEM 列获得。
返回值：
无
举例说明：
清空当前站点 ID 为 139688237135984 的执行缓存信息：
SP_CLEAR_PLAN_CACHE(139688237135984);
24）SP_CLEAR_PLAN_CACHE
定义：
SP_CLEAR_PLAN_CACHE(
plan_id bigint,
hash_value int
)
功能说明：
清空当前站点指定的执行缓存信息。
参数说明：
plan_id：指定计划 ID，其值可以从动态视图 V$CACHEPLN 中的 CACHE_ITEM 列获得。
hash_value：指定缓存项的 HASH 值，其值可以从动态视图 V$CACHEPLN 中的 HASH_VALUE 列获得。
返回值：
无
举例说明：
清空当前站点 ID 为 139688237144176，HASH 值为 1719382609 的执行缓存信息：
SP_CLEAR_PLAN_CACHE(139688237144176,1719382609);
25）SP_SET_PLN_RS_CACHE
定义：
SP_SET_PLN_RS_CACHE(
plan_id bigint,
to_cache int
)
功能说明：
强制设置指定计划结果集缓存的生效及失效。
参数说明：
plan_id：指定计划 ID，其值可以从动态视图 V$CACHEPLN 中的 CACHE_ITEM 列获得。
to_cache：指定缓存与否，0：不缓存；1：缓存。
返回值：
无
举例说明：
设置计划 ID 为 139688237234288 的计划结果集缓存生效：
SP_SET_PLN_RS_CACHE(139688237234288, 1);
26）SP_SET_PLN_RS_CACHE
定义：
SP_SET_PLN_RS_CACHE(
plan_id bigint,
hash_value int,
to_cache int
)
功能说明：
强制设置指定计划结果集缓存的生效及失效。
参数说明：
plan_id：指定计划 ID，其值可以从动态视图 V$CACHEPLN 中的 CACHE_ITEM 列获得。
hash_value：指定缓存项的 HASH 值，其值可以从动态视图 V$CACHEPLN 中的 HASH_VALUE 列获得。
to_cache：指定缓存与否，0：不缓存；1：缓存。
返回值：
无
举例说明：
设置计划 ID 为 139688237234288，HASH 值为 1140234264 的计划结果集缓存失效
SP_SET_PLN_RS_CACHE(139688237234288, 1140234264,0);
27）SF_CHECK_USER_TABLE_PRIV
定义：
INT
SF_CHECK_USER_TABLE_PRIV(
schema_name varchar(128),
table_name varchar(128),
user_name varchar(128),
priv_code int
)
功能说明：
返回用户对表是否具有某种权限。
参数说明：
schema_name： 模式名。
table_name：表名。
user_name：用户名。
priv_code：权限代码，0=SELECT, 1=INSERT, 2=DELETE, 3=UPDATE，4=REFERENCE。
返回值：
0：用户不具备相应权限；1：用户具备相应权限。
举例说明：
获得用户 SYSDBA 对表 SYS.SYSOBJECTS 的查询权限：
SELECT SF_CHECK_USER_TABLE_PRIV ('SYS', 'SYSOBJECTS', 'SYSDBA', 0);
28）SF_CHECK_USER_TABLE_COL_PRIV
定义：
INT
SF_CHECK_USER_TABLE_COL_PRIV(
schema_name varchar(128),
table_name varchar(128),
col_name varchar(128),
user_name varchar(128),
priv_code int
)
功能说明：
返回用户对表中某列是否具有某种权限。
参数说明：
schema_name：模式名。
table_name：表名。
col_name：列名。
user_name：用户名。
priv_code：权限代码，0=SELECT, 1=INSERT, 2=DELETE, 3=UPDATE，4=REFERENCE。
返回值：
0：用户不具备相应权限；1：用户具备相应权限。
举例说明：
获得用户 SYSDBA 对表 SYS.SYSOBJECTS 的 ID 列的查询权限：
SELECT SF_CHECK_USER_TABLE_COL_PRIV ('SYS', 'SYSOBJECTS', 'ID' , 'SYSDBA', 0);
29）CUR_TICK_TIME
定义：
VARCHAR
CUR_TICK_TIME ()
功能说明：
获取系统当前时钟记数。
参数说明：
无
返回值：
时钟记数的字符串。
举例说明：
获取系统当前时钟记数：
SELECT CUR_TICK_TIME();
30）SP_SET_LONG_TIME
定义：
SP_SET_LONG_TIME (
long_exec_time int
)
功能说明：
设置 V$LONG_EXEC_SQLS 和 V$SYSTEM_LONG_EXEC_SQLS 动态视图中监控 SQL 语句的最短执行时间预定值，以毫秒为单位，取值范围 50~3600000。仅 INI 参数 ENABLE_MONITOR=1 时设置有效。仅 DBA 有权限操作该过程。
参数说明：
无
返回值：
无
举例说明：
监控执行时间超过 5 秒的 SQL 语句：
CALL SP_SET_LONG_TIME(5000);
31）SF_GET_LONG_TIME
定义：
INT
SF_GET_LONG_TIME ()
功能说明：
返回 V$LONG_EXEC_SQLS 和 V$SYSTEM_LONG_EXEC_SQLS 动态视图中监控的最短执行时间预定值，以毫秒为单位。仅 DBA 有权限操作该过程。
参数说明：
无
返回值：
V$LONG_EXEC_SQLS 和 V$SYSTEM_LONG_EXEC_SQLS 所监控的最短执行时间预定值。
举例说明：
查看 V$LONG_EXEC_SQLS 监控的最短执行时间预定值：
SELECT SF_GET_LONG_TIME();
32）PERMANENT_MAGIC
定义：
INT
PERMANENT_MAGIC ()
功能说明：
返回数据库永久魔数。
参数说明：
无
返回值：
返回整型值：永久魔数。
举例说明：
获取数据库永久魔数：
SELECT PERMANENT_MAGIC();
33）SP_CANCEL_SESSION_OPERATION
定义：
SP_CANCEL_SESSION_OPERATION (
session_id bigint
)
或
SP_CANCEL_SESSION_OPERATION (
ep_seqno int,
session_id bigint
)
功能说明：
终止指定会话的操作。
参数说明：
session_id：指定会话 ID，可通过 V$SESSIONS 或 GV$SESSIONS 查询。
ep_seqno：指定会话所在的 DMDSC 集群节点的节点号。
返回值：
无
举例说明：
终止 ID 为 310509680 的会话的操作：
SP_CANCEL_SESSION_OPERATION (310509680);
34）SP_PURGE_TS
定义：
SP_PURGE_TS(
timeout int
)
功能说明：
清理已提交事务回滚记录。
参数说明：
timeout：超时等待时间，单位秒，指的是当存在其他 purge 清理操作并发时，本操作需要等待其他 purge 操作完成的超时等待时间。当等待超过 timeout 设定时间，其他 purge 操作还未完成时，报错处理。
返回值：
无
举例说明：
清理已提交事务回滚记录。如果等待并发 purge 清理操作超过 5 秒还未完成时，报错。
SP_PURGE_TS(5);
35）SF_GET_SESSION_SQL
定义：
CLOB
SF_GET_SESSION_SQL (
sess_id bigint
)
或
CLOB
SF_GET_SESSION_SQL (
ep_seqno int,
sess_id bigint
)
功能说明：
返回指定会话上最近处理的完整的 SQL 语句。
参数说明：
sess_id：指定会话 ID，可通过 V$SESSIONS 或 GV$SESSIONS 查询。
ep_seqno：指定会话所在的 DMDSC 集群节点的节点号。
返回值：
指定会话上最近处理的完整的 SQL 语句。
举例说明：
在 ID 为 96710784 的会话上执行如下语句：
CREATE OR REPLACE PROCEDURE xx AS
BEGIN
SELECT SF_GET_SESSION_SQL(96710784);
EXCEPTION
WHEN OTHERS THEN NULL;
END;
/
重新打开一个会话，调用 xx 过程。可以查看到 ID 为 96710784 的会话上的最后一次执行的 SQL 语句。
SQL> call xx;
执行结果如下：
行号 SF_GET_SESSION_SQL(96710784)
---------- --------------------------------------
1 CREATE OR REPLACE PROCEDURE xx AS
BEGIN
SELECT SF_GET_SESSION_SQL(96710784);
EXCEPTION
WHEN OTHERS THEN NULL;
END;
36）SF_CLOB_LEN_IS_VALID
定义：
INT
SF_CLOB_LEN_IS_VALID (
clob
)
功能说明：
检查系统存储的 clob 字符长度是否正常。
参数说明：
clob：clob 对象。
返回值：
0：不正常，1：正常。
举例说明：
select SF_CLOB_LEN_IS_VALID ('PRODUCTION.PRODUCT.DESCRIPTION');
37）SP_VALIDATE_CLOB_LEN
定义：
SP_VALIDATE_CLOB_LEN(
clob
)
功能说明：
修复系统存储的 clob 字符长度。
参数说明：
clob：clob 对象。
举例说明：
SP_VALIDATE_CLOB_LEN ('PRODUCTION.PRODUCT.DESCRIPTION');
38）CHECK_INDEX_PAGE_USED
定义：
INT
CHECK_INDEX_PAGE_USED (
indexid int
)
功能说明：
检查 ID 为 indexid 的索引数据页（包含 BLOB 字段）分配是否与对应的簇分配情况一致。
参数说明：
indexid：索引 ID，如果不是数据库中的索引 ID 或者为空，则报错。
返回值：
1：一致。
0：不一致。
举例说明：
DROP TABLE T1_CHECK;
CREATE TABLE T1_CHECK(c1 INT);
SELECT CHECK_INDEX_PAGE_USED(a.id) FROM sysobjects a WHERE a.subtype$='INDEX' AND a.pid IN(SELECT id FROM sysobjects WHERE name = 'T1_CHECK');
39）SF_FILE_SYS_CHECK_REPORT
定义：
INT
SF_FILE_SYS_CHECK_REPORT(
ts_id int
)
功能说明：
校验检查指定表空间的簇是否正常。
参数说明：
ts_id：指定检测的表空间，如果表空间不存在则返回 0。
返回值：
1：表示表空间的簇都是正常的。
0：表空间中存在检验不通过的簇，问题的详细描述输出到服务器的运行日志中。
举例说明：
SELECT SF_FILE_SYS_CHECK_REPORT(4);
40）SP_LOAD_LIC_INFO()
定义：
VOID
SP_LOAD_LIC_INFO()
功能说明：
进行 DM 服务器的 LICENSE 校验，检查 LICENSE 与当前 DM 版本及系统运行环境是否一致。一致则执行成功；不一致则 DM 服务器主动退出。
参数说明：
无
返回值：
无
举例说明：
SP_LOAD_LIC_INFO();
41）SF_PROXY_USER()
定义：
VARCHAR
SF_PROXY_USER()
功能说明：
返回当前代理用户名。
参数说明：
无
返回值：
返回当前代理用户名。
举例说明：
返回当前代理用户名：
SELECT SF_PROXY_USER();
42）SP_CLEAR_PLAN_CACHE_BY_DICT()
定义：
VOID
SP_CLEAR_PLAN_CACHE_BY_DICT(
dict_id int
)
功能说明：
清除涉及指定字典对象的缓存计划。
参数说明：
dict_id：指定字典对象的 ID 值。
返回值：
无
举例说明：
清除涉及 ID 值为 1250 的字典对象的缓存计划：
SP_CLEAR_PLAN_CACHE_BY_DICT(1250);
43）SF_GET_LOGIN_ID
定义：
INT
SF_GET_LOGIN_ID()
功能说明：
获取当前登录用户 ID，功能同系统函数 UID()。
参数说明：
无
返回值：
当前登录用户 ID。
举例说明：
获取当前登录用户 ID：
SELECT SF_GET_LOGIN_ID();
44）SF_GET_LOGIN_IP
定义：
VARCHAR
SF_GET_LOGIN_IP()
功能说明：
获取当前执行登录操作的 IP 地址。
参数说明：
无
返回值：
当前执行登录操作的 IP 地址。
举例说明：
获取当前执行登录操作的 IP 地址：
SELECT SF_GET_LOGIN_IP();
45）SF_GET_LOGIN_APP
定义：
VARCHAR
SF_GET_LOGIN_APP()
功能说明：
获取当前执行登录操作的应用名。
参数说明：
无
返回值：
当前执行登录操作的应用名。
举例说明：
获取当前执行登录操作的应用名：
SELECT SF_GET_LOGIN_APP();
46）SF_LOGIN_SUCCESS
定义：
DMBOOL
SF_LOGIN_SUCCESS()
功能说明：
判断当前会话是否登录成功，一般在 LOGIN/LOGON 触发器中使用。
参数说明：
无
返回值：
0：登录失败；
1：登录成功。
举例说明：
判断当前会话是否登录成功：
SELECT SF_LOGIN_SUCCESS();
47）SF_GET_TABLE_GROUP_INFO
定义：
CLOB
SF_GET_TABLE_GROUP_INFO(
schname varchar(128)
tabname varchar(128)
group_count int
)
功能说明：
按照数据页分布对表数据进行分组。不支持堆表、HUGE 表和分区主表。
参数说明：
schname：模式名。
tabname：表名。
group_count：指定分组数，取值范围 1~1000。实际分组时由于数据页分布不同，返回结果分组数可能小于指定分组数。
返回值：
返回表数据分组信息，各字段含义如下：
COLUMN：分组列。如果表中存在 CLUSTER KEY，则根据 CLUSTER KEY 分组；否则根据 ROWID 分组。
GROUP_NO：组别编号，从 1 开始依次递增。
START：当前组的起始分组列值，“-”表示当前组无起始值。
END：当前组的终止分组列值，“-”表示当前组无终止值。
COUNT：当前组的表记录行数。
举例说明：
准备数据：
DROP TABLE TEST;
CREATE TABLE TEST(C1 INT CLUSTER KEY, C2 INT);
INSERT INTO TEST SELECT LEVEL,LEVEL FROM DUAL CONNECT BY LEVEL <=20000;
COMMIT;
将表 TEST 数据按照数据页分布分组，指定分组数为 4：
SELECT SF_GET_TABLE_GROUP_INFO('SYSDBA','TEST',4);
执行结果如下：
COLUMN: C1
GROUP_NO START END COUNT
1 1 5040 5040
2 5041 10080 5040
3 10081 15120 5040
4 15121 20000 4880
48）SF_GET_TABLE_GROUP_INFO_BY_ROWS/SP_GET_TABLE_GROUP_INFO_BY_ROWS
定义：
CLOB
SF_GET_TABLE_GROUP_INFO_BY_ROWS(
schname varchar(128)
tabname varchar(128)
row_count int
)
或
SP_GET_TABLE_GROUP_INFO_BY_ROWS(
schname varchar(128)
tabname varchar(128)
row_count int
)
功能说明：
按照数据页分布对表数据进行分组。不支持堆表、HUGE 表和分区主表。
参数说明：
schname：模式名。
tabname：表名。
row_count：指定行数，除最后一组外每组需要达到的最小行数。
返回值：
返回表数据分组信息，各字段含义如下：
COLUMN：分组列。如果表中存在 CLUSTER KEY，则根据 CLUSTER KEY 分组；否则根据 ROWID 分组。
GROUP_NO：组别编号，从 1 开始依次递增。
START：当前组的起始分组列值，“-”表示当前组无起始值。
END：当前组的终止分组列值，“-”表示当前组无终止值。
COUNT：当前组的表记录行数。
举例说明：
准备数据：
DROP TABLE TEST;
CREATE TABLE TEST(C1 INT CLUSTER KEY, C2 INT);
INSERT INTO TEST SELECT LEVEL,LEVEL FROM DUAL CONNECT BY LEVEL <=20000;
COMMIT;
使用系统函数 SF_GET_TABLE_GROUP_INFO_BY_ROWS 将表 TEST 数据按照数据页分布分组，指定除最后一组外，其余每组需要至少包含 4000 行记录：
SELECT SF_GET_TABLE_GROUP_INFO_BY_ROWS('SYSDBA','TEST',4000);
执行结果如下：
COLUMN: C1
GROUP_NO START END COUNT
1 1 4032 4032
2 4033 8064 4032
3 8065 12096 4032
4 12097 16128 4032
5 16129 20000 3872
使用系统过程 SP_GET_TABLE_GROUP_INFO_BY_ROWS 将表 TEST 数据按照数据页分布分组，指定除最后一组外，其余每组需要至少包含 4000 行记录：
SP_GET_TABLE_GROUP_INFO_BY_ROWS('SYSDBA','TEST',4000);
执行结果如下：
GROUP_NO COLUMN START END COUNT
----------- -------- ------- -------- -----
1 C1 1 4032 4032
2 C1 4033 8064 4032
3 C1 8065 12096 4032
4 C1 12097 16128 4032
5 C1 16129 20000 3872
- SP_CLOSE_LSNR
定义：
SP_CLOSE_LSNR()
功能说明：
关闭 dmserver 监听端口。
参数说明：
无。
返回值：
无。
举例说明：
关闭当前连接 dmserver 的监听端口：
SP_CLOSE_LSNR();
执行结果如下：
DMSQL 过程已成功完成
执行成功后，客户端再次连接服务器：
disql V8
用户名:
密码:
[-70028]:创建SOCKET连接失败.
- SP_OPEN_LSNR
定义：
SP_OPEN_LSNR()
功能说明：
打开 dmserver 监听端口。
参数说明：
无。
返回值：
无。
举例说明：
打开当前连接 dmserver 的监听端口：
SP_OPEN_LSNR();
执行结果如下：
DMSQL 过程已成功完成
执行成功后，客户端再次连接服务器：
服务器[LOCALHOST:5236]:处于普通打开状态
Linux 系统可以通过给 dmserver 进程发送 SIGUSR2 信号来打开监听端口。当用户关闭监听端口并退出客户端，无法重新连接时，可以通过该方式打开监听端口并连接服务器。操作如下：
kill -SIGUSR2 [dmserver进程号]
- SF_TS_FREE_LIST_REPAIR
定义：
INT
SF_TS_FREE_LIST_REPAIR (
ts_id int
)
功能说明：
检查指定表空间的全局空闲链表是否正常，若异常则截断该全局空闲链表。
参数说明：
ts_id：表空间 ID。
返回值：
0：全局空闲链表异常，或指定的表空间不存在。
1：全局空闲链表正常。
举例说明：
首先可以查询动态视图 V$TABLESPACE，获取表空间 ID。
SQL> SELECT ID FROM V$TABLESPACE WHERE NAME='MAIN';
行号 ID
---------- -----------
1 4
利用表空间 ID 检查表空间的全局空闲链表是否正常，若异常则对链表进行截断。
SQL> SELECT SF_TS_FREE_LIST_REPAIR(4);
- SP_CLEAR_RAFT_PLAN_CACHE
定义：
SP_CLEAR_RAFT_PLAN_CACHE(
raft_id INT
)
功能说明：
清空指定站点的执行缓存信息。
参数说明：
raft_id：站点号。如果站点号为 NULL，就清除所有站点的执行缓存信息；否则清理指定站点的执行缓存信息。非 DPC 环境忽略站点号。
返回值：
无。
举例说明：
清空所有站点的执行缓存信息：
SP_CLEAR_RAFT_PLAN_CACHE(NULL);
- SP_CLEAR_RAFT_PLAN_CACHE
定义：
SP_CLEAR_RAFT_PLAN_CACHE(
plan_id BIGINT,
raft_id INT
)
功能说明：
清空指定站点的指定执行缓存信息。
参数说明：
plan_id：指定计划 ID，其值可以从动态视图 V$CACHEPLN 中的 CACHE_ITEM 列获得。
raft_id：站点号。如果站点号为 NULL，就清除所有站点指定 ID 的执行缓存信息；否则清理指定站点指定 ID 的执行缓存信息。非 DPC 环境忽略站点号。
返回值：
无。
举例说明：
在所有站点中查找并清空 ID 为 139688237135984 的执行缓存信息：
SP_CLEAR_RAFT_PLAN_CACHE(139688237135984，NULL);
在站点 3 中清空 ID 为 139688237135984 的执行缓存信息：
SP_CLEAR_RAFT_PLAN_CACHE(139688237135984，3);
- SP_CLEAR_RAFT_PLAN_CACHE
定义：
SP_CLEAR_RAFT_PLAN_CACHE(
plan_id BIGINT,
hash_value INT,
raft_id INT
)
功能说明：
清空指定站点的指定执行缓存信息。
参数说明：
plan_id：指定计划 ID，其值可以从动态视图 V$CACHEPLN 中的 CACHE_ITEM 列获得。
hash_value：指定缓存项的 HASH 值，其值可以从动态视图 V$CACHEPLN 中的 HASH_VALUE 列获得。
raft_id：站点号。如果站点号为 NULL，就在所有站点上查找并清除指定的执行缓存信息；否则清理指定站点的指定执行缓存信息。非 DPC 环境忽略站点号。
返回值：
无。
举例说明：
清空 ID 为 139688237144176，HASH 值为 1719382609 的执行缓存信息：
SP_CLEAR_RAFT_PLAN_CACHE(139688237144176,1719382609, NULL);
DPC 环境下某 SP 站点号为 3，清空此站点 ID 为 139688237135984，HASH 值为 1719382609 的执行缓存信息：
SP_CLEAR_RAFT_PLAN_CACHE(139688237135984，1719382609, 3);
- SP_CLEAR_OS_MEM_INFO
定义：
SP_CLEAR_OS_MEM_INFO (
raft_id int
)
功能说明：
清除所有或指定节点上的操作系统内存分配释放信息。
参数说明：
raft_id：站点号。如果站点号为 NULL，就清除所有站点上的内存信息；否则清理指定站点的内存信息。
返回值：
无
举例说明：
清理所有站点上的内存信息。
SP_CLEAR_OS_MEM_INFO(NULL);
- SF_CLEAR_DICT_CACHE
定义：
INT
SF_CLEAR_DICT_CACHE()
或
INT
SF_CLEAR_DICT_CACHE(
OBJID INT,
CASCADE INT,
TYPE VARCHAR(128),
SUBTYPE VARCHAR(128)
)
功能说明：
不指定任何参数时，清理所有字典缓存，指定对象时，清理指定对象 ID 的字典缓存。
参数说明：
OBJID：对象 ID。
CASCADE：是否级联删除。
TYPE：类型，对应 SYSOBJECTS 的 TYPE$。
SUBTYPE：子类型，对应 SYSOBJECTS 的 SUBTYPE$。
返回值：
清理的字典个数。
举例说明：
例 1 清理所有字典信息。
SELECT SF_CLEAR_DICT_CACHE();
例 2 清理对象 ID 为 1024 的字典缓存
SELECT SF_CLEAR_DICT_CACHE(1024,1,'SCHOBJ','UTAB');
定义 2
INT
SF_CLEAR_DICT_CACHE(
RAFT_ID INT
)
或
INT
SF_CLEAR_DICT_CACHE(
RAFT_ID INT,
OBJID INT,
CASCADE INT,
TYPE VARCHAR(128),
SUBTYPE VARCHAR(128)
)
功能说明：
DPC 下使用，其他环境清理当前节点。广播到指定节点，如果不指定对象 ID，清理所有字典缓存，否则清理指定 ID 的字典缓存。
参数说明：
RAFT_ID：广播的目标节点号。
OBJID：对象 ID。
CASCADE：是否级联删除。
TYPE：类型，对应 SYSOBJECTS 的 TYPE$。
SUBTYPE：子类型，对应 SYSOBJECTS 的 SUBTYPE$。
返回值：
清理的字典个数。
举例说明：
例 1 清理目标节点号为 1 的所有字典信息。
SELECT SF_CLEAR_DICT_CACHE(1);
例 2 清理目标节点号为 1，对象 ID 为 1024 的字典缓存
SELECT SF_CLEAR_DICT_CACHE(1,1024,1,'SCHOBJ','UTAB');
- SP_CREATE_SYSTEM_VIEWS
定义：
VOID
SP_CREATE_SYSTEM_VIEWS(
CREATE_FLAG INT
)
或
VOID
SP_CREATE_SYSTEM_VIEWS(
CREATE_FLAG INT,
VIEWNAME VARCHAR(128)
)
功能说明：
用于删除或创建所有系统视图，也支持删除指定的系统视图。
参数说明：
CREATE_FLAG：为 1 时表示创建所有的系统视图，为 0 时表示删除所有的系统视图。
VIEWNAME：系统视图名称。当 CREATE_FLAG 为 0 时，可以对该参数赋值，表示删除指定的系统视图。
返回值：
无。
举例说明：
SP_CREATE_SYSTEM_VIEWS(1);
- SP_DROP_OLD_DYNAMIC_TAB
定义：
SP_DROP_OLD_DYNAMIC_TAB();
功能说明：
用于升级后删除老版本库中系统表残留的动态视图定义。DM8 的 8.1.1.189 版本之前的库中，动态性能视图相关定义保存在系统表中，升级后残留的定义会在部分特殊场景导致崩溃，故提供此系统过程。
该系统过程需要 DBA 权限执行，执行后影响执行码降级。
参数说明：
无。
返回值：
无。
举例说明：
清理老版本中动态性能视图在系统表中的字典信息。
SP_DROP_OLD_DYNAMIC_TAB();
- SP_CLEAR_INVALID_QUOTA
定义：
VOID
SP_CLEAR_INVALID_QUOTA(
TS_ID SMALLINT
);
功能说明：
用于删除用户后清理用户在表空间设置的配额信息。部分场景下删除用户时，用户在表空间设置的配额信息不会被及时清理（如表空间 OFFLINE 或是 DPC 环境中 BP 节点下线），通常情况下服务器会在后续运行中自动清理此类已经无效的表空间配额信息，用户不必为此费心，但也允许用户主动调用此系统过程清理。
参数说明：
TS_ID：表空间 ID，smallint 类型。
返回值：
无。
举例说明：
清理 MAIN 表空间无效的配额信息。
--通过V$TABLESPACE查询MAIN表空间对应ID
SELECT ID FROM V$TABLESPACE WHERE NAME ='MAIN';
行号 ID
---------- -----------
1 4
--使用SP_CLEAR_INVALID_QUOTA清理MAIN表空间
SP_CLEAR_INVALID_QUOTA(4);
3. 备份恢复管理
1）SF_BAKSET_BACKUP_DIR_ADD
定义：
INT
SF_BAKSET_BACKUP_DIR_ADD(
device_type varchar,
backup_dir varchar(256)
)
功能说明：
添加备份目录。若添加目录已经存在或者为库默认备份路径，则认为已经存在，系统不添加但也不报错。
参数说明：
device_type：待添加的备份目录对应存储介质类型，DISK 或者 TAPE。目前，无论指定介质类型为 DISK 或者 TAPE，都会同时搜索两种类型的备份集。
backup_dir：待添加的备份目录。
返回值：
1：目录添加成功；其它情况下报错。
举例说明：
SELECT SF_BAKSET_BACKUP_DIR_ADD('DISK','/home/dm_bak');
2）SF_BAKSET_BACKUP_DIR_REMOVE
定义：
INT
SF_BAKSET_BACKUP_DIR_REMOVE (
device_type varchar,
backup_dir varchar(256)
)
功能说明：
删除备份目录。若删除目录为库默认备份路径，不进行删除，认为删除失败。若指定目录存在于记录的合法目录中，则删除；不存在或者为空则跳过，正常返回。
参数说明：
device_type：待删除的备份目录对应存储介质类型。待删除的备份目录对应存储介质类型，DISK 或者 TAPE。
backup_dir：待删除的备份目录。
返回值：
1：目录删除成功、目录不存在或者目录为空；0：目录为库默认备份路径；其他情况报错。
举例说明：
SELECT SF_BAKSET_BACKUP_DIR_REMOVE('DISK','/home/dm_bak');
3）SF_BAKSET_BACKUP_DIR_REMOVE_ALL
定义：
INT
SF_BAKSET_BACKUP_DIR_REMOVE_ALL()
功能说明：
清理全部备份目录，默认备份目录除外。
返回值：
1：目录全部清理成功；其它情况下报错。
举例说明：
SELECT SF_BAKSET_BACKUP_DIR_REMOVE_ALL();
4）SF_BAKSET_CHECK
定义：
INT
SF_BAKSET_CHECK(
device_type varchar,
bakset_path varchar(256)
)
功能说明：
对备份集进行校验。
参数说明：
device_type：设备类型，disk 或 tape。
bakset_path：待校验的备份集目录。
返回值：
1：备份集目录存在且合法；否则报错。
举例说明：
BACKUP DATABASE FULL BACKUPSET '/home/dm_bak/db_bak_for_check';
SELECT SF_BAKSET_CHECK('DISK','/home/dm_bak/ db_bak_for_check');
5）SF_BAKSET_REMOVE
定义：
INT
SF_BAKSET_REMOVE (
device_type varchar,
backsetpath varchar(256),
option integer
)
功能说明：
删除指定设备类型和指定备份集目录的备份集。一次只检查一个合法.meta 文件，然后删除对应备份集；若存在非法或非正常备份的.meta 文件，则报错或直接返回，不会接着检查下一个.meta 文件；若同一个备份集下还存在其它备份文件或备份集，则只删除备份文件，不会删除整个备份集。
参数说明：
device_type：设备类型，disk 或 tape。
backsetpath：待删除的备份集目录。
option：删除备份集选项，0 默认删除，1 级联删除。可选参数。并行备份集中子备份集不允许单独删除；目标备份集被其他备份集引用为基备份的，默认删除，报错；级联删除情况下，会递归将相关的增量备份也删除。
返回值：
1：备份集目录删除成功；其它情况下报错。
举例说明：
例 1
BACKUP DATABASE FULL BACKUPSET '/home/dm_bak/db_bak_for_remove';
BACKUP DATABASE INCREMENT BACKUPSET '/home/dm_bak/db_bak_for_remove_incr';
SELECT SF_BAKSET_REMOVE('DISK','/home/dm_bak/db_bak_for_remove');
执行结果如下：
[-8202]:[/home/dm_bak/db_bak_for_remove_incr]的基备份，不能删除.
例 2
SELECT SF_BAKSET_REMOVE('DISK','/home/dm_bak/db_bak_for_remove',1);
执行结果如下：
1
6）SF_BAKSET_REMOVE_BATCH
定义：
INT
SF_BAKSET_REMOVE_BATCH (
device_type varchar,
end_time datetime,
range int,
obj_name varchar(257)
)
功能说明：
批量删除满足指定条件的所有备份集。
参数说明：
device_type：设备类型，disk 或 tape。指定 NULL，则忽略存储设备的区分。
end_time：删除备份集生成的结束时间，仅删除 end_time 之前的备份集，必须指定。
range：指定删除备份的级别。1 代表库级；2 代表表空间级；3 代表表级；4 代表归档备份。若指定 NULL，则忽略备份集备份级别的区分。
obj_name：待删除备份集中备份对象的名称，仅表空间级和表级有效。若为表级备份删除，则需指定完整的表名（模式.表名）。否则，将认为删除会话当前模式下的表备份。若指定为 NULL，则忽略备份集中备份对象名称区分。
返回值：
1：备份集目录删除成功；其它情况下报错。
举例说明：
BACKUP DATABASE FULL BACKUPSET '/home/dm_bak/db_bak_for_remove';
BACKUP TABLESPACE MAIN FULL BACKUPSET '/home/dm_bak/ts_bak_for_remove';
SELECT SF_BAKSET_REMOVE_BATCH ('DISK', now(), NULL, NULL);
7）SF_BAKSET_REMOVE_BATCH_S
定义：
INT
SF_BAKSET_REMOVE_BATCH_S (
device_type varchar,
end_time datetime,
range int,
obj_name varchar(257)
)
功能说明：
批量安全删除满足指定条件的所有库级备份集，保留备份时间最新的库级完全备份集。
参数说明：
range：指定删除备份的级别。1代表库级，2代表表空间级，3代表表级，4代表归档备份。若指定为NULL，则忽略备份集备份级别的区分。SF_BAKSET_REMOVE_BATCH_S目前仅支持批量安全删除库级备份集，若参数指定为2、3、4，则SF_BAKSET_REMOVE_BATCH_S的功能与SF_BAKSET_REMOVE_BATCH相同。
其余参数说明与SF_BAKSET_REMOVE_BATCH相同。
返回值：
1：备份集目录删除成功；其它情况下报错。
举例说明：
SF_BAKSET_REMOVE_BATCH_S将保留库级完全备份db_bak_for_remove_s_2，删除其余三个备份集。
BACKUP DATABASE FULL BACKUPSET '/home/dm_bak/db_bak_for_remove_s_1';
BACKUP DATABASE FULL BACKUPSET '/home/dm_bak/db_bak_for_remove_s_2';
BACKUP TABLESPACEMAIN FULL BACKUPSET '/home/dm_bak/ts_bak_for_remove_s_1';
BACKUP TABLESPACEMAIN FULL BACKUPSET '/home/dm_bak/ts_bak_for_remove_s_2';
SELECT SF_BAKSET_REMOVE_BATCH_S ('DISK', now(), NULL, NULL);
8）SP_DB_BAKSET_REMOVE_BATCH
定义：
SP_DB_BAKSET_REMOVE_BATCH (
device_type varchar,
end_time datetime
)
功能说明：
批量删除指定时间之前的数据库备份集。使用该方法前，需要先使用 SF_BAKSET_BACKUP_DIR_ADD 添加将要删除的备份集目录，否则只删除默认备份路径下的备份集。
参数说明：
device_type：设备类型，disk 或 tape。指定 NULL，则忽略存储设备的区分。
end_time：删除备份集生成的结束时间，仅删除 end_time 之前的备份集，必须指定。
举例说明：
BACKUP DATABASE FULL BACKUPSET '/home/dm_bak/db_bak_for_batch_del';
SELECT SF_BAKSET_BACKUP_DIR_ADD('DISK','/home/dm_bak');
SP_DB_BAKSET_REMOVE_BATCH('DISK', NOW());
9）SP_TS_BAKSET_REMOVE_BATCH
定义：
SP_TS_BAKSET_REMOVE_BATCH (
device_type varchar,
end_time datetime,
ts_name varchar(128)
)
功能说明：
批量删除指定表空间对象及指定时间之前的表空间备份集。使用该方法前，需要先使用 SF_BAKSET_BACKUP_DIR_ADD 添加将要删除的备份集目录，否则只删除默认备份路径下的备份集。
参数说明：
device_type：设备类型，disk 或 tape。指定 NULL，则忽略存储设备的区分。
end_time：删除备份集生成的结束时间，仅删除 end_time 之前的备份集，必须指定。
ts_name：表空间名，若未指定，则认为删除所有满足条件的表空间备份集。
举例说明：
BACKUP TABLESPACE MAIN BACKUPSET '/home/dm_bak/ts_bak_for_batch_del';
SELECT SF_BAKSET_BACKUP_DIR_ADD('DISK','/home/dm_bak');
SP_TS_BAKSET_REMOVE_BATCH('DISK',NOW(),'MAIN');
10）SP_TAB_BAKSET_REMOVE_BATCH
定义：
SP_TAB_BAKSET_REMOVE_BATCH (
device_type varchar,
end_time datetime,
sch_name varchar(128),
tab_name varchar(128)
)
功能说明：
批量删除指定表对象及指定时间之前的表备份集。使用该方法前，需要先使用 SF_BAKSET_BACKUP_DIR_ADD 添加将要删除的备份集目录，否则只删除默认备份路径下的备份集。
参数说明：
device_type：设备类型，disk 或 tape。指定 NULL，则忽略存储设备的区分。
end_time：删除备份集生成的结束时间，仅删除 end_time 之前的备份集，必须指定。
sch_name：表所属的模式名。
tab_name：表名，只要模式名和表名有一个指定，就认为需要匹配目标；若均指定为 NULL，则认为删除满足条件的所有表备份。
举例说明：
CREATE TABLE TAB_FOR_BATCH_DEL(C1 INT);
BACKUP TABLE TAB_FOR_BATCH_DEL BACKUPSET'/home/dm_bak/tab_bak_for_batch_del';
SELECT SF_BAKSET_BACKUP_DIR_ADD('DISK','/home/dm_bak');
SP_TAB_BAKSET_REMOVE_BATCH('DISK',NOW(),'SYSDBA','TAB_FOR_BATCH_DEL');
11）SP_ARCH_BAKSET_REMOVE_BATCH
定义：
SP_ARCH_BAKSET_REMOVE_BATCH (
device_type varchar,
end_time datetime
)
功能说明：
批量删除指定时间之前的归档备份集。使用该方法前，需要先使用 SF_BAKSET_BACKUP_DIR_ADD 添加将要删除的备份集目录，否则只删除默认备份路径下的备份集。
参数说明：
device_type：设备类型，disk 或 tape。指定 NULL，则忽略存储设备的区分。
end_time：删除备份集生成的结束时间，仅删除 end_time 之前的备份集，必须指定。
举例说明：
BACKUP ARCHIVELOG BACKUPSET '/home/dm_bak/arch_bak_for_batch_del';
SELECT SF_BAKSET_BACKUP_DIR_ADD('DISK','/home/dm_bak');
SP_ARCH_BAKSET_REMOVE_BATCH('DISK', NOW());
4. 定时器管理
1）SP_ADD_TIMER
定义：
SP_ADD_TIMER(
timer_name varchar(128),
type int,
freq_month_week_interval int,
freq_sub_interval int,
freq_minute_interval int,
start_time time,
end_time time,
during_start_date datetime(0),
during_end_time datetime(0),
no_end_date_flag bool,
describe varchar(128),
is_valid bool
)
功能说明：
创建一个定时器
参数说明：
timer_name：定时器名称，应使用普通标识符，包含特殊符号可能导致无法正常使用。
type：定时器调度类型，取值范围为：1~9；1：执行一次；2：按日执行；3：按周执行；4：按月执行的第几天；5：按月执行的第一周；6：按月执行的第二周；7：按月执行的第三周；8：按月执行的第四周； 9：按月执行的最后一周。
freq_month_week_interval：间隔的月/周/天（调度类型决定）数。
freq_sub_interval：第几天/星期几/一个星期中的某些天。
freq_minute_interval：间隔的分钟数。
start_time：开始时间。
end_time：结束时间。
during_start_date：有效日期时间段的开始日期时间。只有当前时间大于该字段时，该定时器才有效。
during_end_date：有效日期时间段的结束日期时间。
no_end_date_flag：是否有结束日期（0：有结束日期；1：没有结束日期）。
describe：描述。
is_valid：定时器是否有效。
返回值：
无
说明：
-
type = 1 时，freq_sub_interval、freq_month_week_interval、freq_minute_interval、end_time、during_end_date 无效。只有 start_time，during_start_date 有意义。
-
type = 2 时，freq_month_week_interval 有效，表示相隔几天，取值范围为 1~100；freq_sub_interval 无效；freq_minute_interval <=24* 60 有效。
a) 当 freq_minute_interval = 0 时，当天只执行一次。end_time 无效；
b) 当 0<freq_minute_interval <=24*60 时，表示当天从 start_time 时间开始，每隔 freq_minute_interval 分钟执行一次；
c) 当 freq_minute_interval > 24* 60 时，非法。
-
type = 3 时，意思是每隔多少周开始工作（从开始日期算起）。计算方法为：(当前日期和开始日期的天数之差/7)% freq_month_week_interval =0 且当前是星期 freq_sub_interval，其中 freq_sub_interval 的八位如下表所示：
8 7 6 5 4 3 2 1 1-7 位分别代表星期天，星期一、星期二…、星期六，第 8 位无意义。这几位 为 1 表示满足条件，为 0 表示不满足条件。
a) 1<=freq_month_week_interval<=100，代表每隔多少周；
b) 1<=freq_sub_interval<=127 代表星期中的某些天；
c) freq_minute_interval 代表分钟数。
当 freq_minute_interval = 0 时，当天只执行一次。end_time 无效；当 freq_minute_interval > 0 且，表示当天可执行多次；当 freq_minute_interval > 24* 60 时，非法。
-
type = 4 时，每 freq_month_week_interval 个月的第 freq_sub_interval 日开始工作。其中，是否满足 freq_month_week_interval 个月的判断条件是：(月份的差 +(日期的差 >=15|| 日期的差 <= -15)?1:0 ) % freq_month_week_interval = 0 且当前是当月的 freq_sub_interval 日，表示满足条件；否则不满足。其中，“月份的差” 和 “日期的差”分别指的是系统当前时间和字段“during_start_date”中的月份差值和日期差值。
a) 1<=freq_sub_interval<31，代表第几日；
b) 1<=freq_month_week_interval<=100，代表每隔多少个月；
c) freq_minute_interval 代表分钟数。
当 freq_minute_interval = 0 时，当天只执行一次。end_time 无效；当 freq_minute_interval > 0 且，表示当天可执行多次；当 freq_minute_interval >24* 60 时，非法。
-
type = 5，6，7，8，9 时，每 freq_month_week_interval 个月的第 type-4 周的周 freq_sub_interval 开始工作。其中，是否满足 freq_month_week_interval 个月的判断条件是：(月份的差 + 日期的差/15) % freq_month_week_interval = 0 且当前是当月的第 type-4 周的周 freq_sub_interval，表示满足条件；否则不满足。
a) 1<=freq_sub_interval<=7，代表星期天到星期六（星期天是一个星期的第一天）；
b) 1<=freq_month_week_interval<=100，代表每隔多少个月；
c) freq_minute_interval 代表分钟数。
当 freq_minute_interval = 0 时，当天只执行一次。end_time 无效；当 freq_minute_interval > 0 且，表示当天可执行多次；当 freq_minute_interval > 24* 60 时，非法。
-
如果 no_end_date_flag = TRUE：表示永远不结束，一直存在下去。
-
如果 is_valid= TRUE：表示定时器创建时就有效。
-
总结 type 取值 1~9 时，freq_sub_interval、freq_month_week_interval 和 freq_minute_interval 各自对应的有效值范围如下表所示：
举例说明：
创建一个定时器，每天 02：00 进行调度，开始日期：2011-02-01，结束日期：2011-09-01，间隔天数 1 天，每隔一分钟循环执行：
CALL SP_ADD_TIMER('TIMER1', 2, 1, 0, 1, '02:00:00', '20:00:00', '2011-02-01 14:30:34', '2011-09-01', 0, '每天凌晨两点进行调度', 1);
2）SP_DROP_TIMER
定义：
SP_DROP_TIMER (
timer_name varchar(128)
)
功能说明：
删除一个定时器。
参数说明：
timer_name：定时器名。
返回值：
无
举例说明：
删除定时器 TIMER1：
SP_DROP_TIMER('TIMER1');
3）SP_OPEN_TIMER
定义：
SP_OPEN_TIMER (
timer_name varchar(128)
)
功能说明：
打开一个定时器。仅在内存中生效。
参数说明：
timer_name：定时器名。
返回值：
无
举例说明：
打开定时器 TIMER1：
SP_OPEN_TIMER('TIMER1');
4）SP_CLOSE_TIMER
定义：
SP_CLOSE_TIMER (
timer_name varchar(128)
)
功能说明：
关闭一个定时器。仅在内存中生效。
参数说明：
timer_name：定时器名。
返回值：
无
举例说明：
关闭定时器 TIMER1：
SP_CLOSE_TIMER('TIMER1');
5. 模式对象相关信息管理
用户必须拥有相应对象的权限才可以获取到相关信息。
1）SP_TABLEDEF
定义：
SP_TABLEDEF (
schname varchar(128),
tablename varchar(128)
)
功能说明：
以结果集的形式返回表的定义，当表定义过长时，会以多行返回。
参数说明：
schname：模式名。
tablename：表名。
返回值：
无
举例说明：
CALL SP_TABLEDEF('PRODUCTION','PRODUCT');
2）SP_VIEWDEF
定义：
void
SP_VIEWDEF (
schname varchar(128),
viewname varchar(128)
)
功能说明：
以结果集的形式返回视图的定义。
参数说明：
schname：模式名。
viewname：视图名。
返回值：
无
举例说明：
SP_VIEWDEF('PURCHASING','VENDOR_EXCELLENT');
3）SF_VIEW_EXPIRED
定义：
INT
SF_VIEW_EXPIRED(
schname varchar(128),
viewname varchar(128)
)
功能说明：
检查当前系统表中视图列定义是否有效。
返回值：
返回 0 或 1。0 表示有效；1 表示无效。
举例说明：
CREATE TABLE T_01_VIEW_DEFINE_00(C1 INT,C2 INT);
CREATE VIEW TEST_T_01_VIEW_DEFINE_00 AS SELECT* FROM T_01_VIEW_DEFINE_00;
select sf_view_expired('SYSDBA','TEST_T_01_VIEW_DEFINE_00');
//查询结果为0
ALTER TABLE T_01_VIEW_DEFINE_00 DROP COLUMN C1 CASCADE ;
select sf_view_expired('SYSDBA','TEST_T_01_VIEW_DEFINE_00');
//查询结果为1
4）CHECKDEF
定义：
VARCHAR
CHECKDEF (
consid int,
preflag int
)
功能说明：
获得 check 约束的定义。
参数说明：
consid：check 约束 id 号。
preflag：对象前缀个数。1 表示导出模式名；0 表示只导出对象名。
返回值：
check 约束的定义。
举例说明：
CREATE TABLE TEST_CHECKDEF(C1 INT CHECK(C1>10));
//通过查询系统表
select a.name, a.id from sysobjects a, sysobjects b where b.name='TEST_CHECKDEF' and a.pid=b.id and a.subtype$='CONS';
//得到约束ID为134217770
SELECT CHECKDEF(134217770,1);
5）CONSDEF
定义：
VARCHAR
CONSDEF (
indexid int,
preflag int
)
功能说明：
获取 unique 约束的定义。
参数说明：
indexid：索引号数字字符串。
preflag：对象前缀个数。1 表示导出模式名；0 表示只导出对象名。
返回值：
unique 约束的定义。
举例说明：
CREATE TABLE TEST_CONSDEF(C1 INT PRIMARY ,, CONSTRAINT CONS1 UNIQUE(C2));
//通过查询系统表
SELECT C.INDEXID FROM SYSOBJECTS O,SYSCONS C WHERE O.NAME='CONS1' AND O.ID=C.ID;
//系统生成C2上的INDEX为33555481
SELECT CONSDEF(33555481,1);
6）INDEXDEF
定义：
VARCHAR
INDEXDEF (
indexid int,
preflag int
)
功能说明：
获取 INDEX 的创建定义。
参数说明：
indexid：索引 ID。
preflag：对象前缀个数。1 表示导出模式名；0 表示只导出对象名。
返回值：
索引的创建定义。
举例说明：
CREATE INDEX PRODUCT_IND ON PRODUCTION.PRODUCT(PRODUCTID);
//查询系统表得到索引ID
SELECT NAME, ID FROM SYSOBJECTS WHERE NAME='PRODUCT_IND' AND SUBTYPE$='INDEX';
SELECT indexdef(33555530,1);
7）SP_REORGANIZE_INDEX
定义：
SP_REORGANIZE_INDEX (
schname varchar(128),
indexname varchar(128)
)
功能说明：
对指定索引进行空间整理。拥有 DBA/DB_OBJECT_ADMIN 角色权限的用户才能对其他模式下的索引进行空间整理，普通用户仅能对自己模式下的索引进行空间整理。
参数说明：
schname：模式名。
indexname：索引名。
返回值：
无
举例说明：
CREATE INDEX PRODUCT_IND ON PRODUCTION.PRODUCT(PRODUCTID);
SP_REORGANIZE_INDEX('PRODUCTION','PRODUCT_IND');
8）SP_REBUILD_INDEX
定义：
SP_REBUILD_INDEX (
schname varchar(128),
indexid int
)
功能说明：
重建索引。约束：1. 水平分区子表、临时表和系统表上建的索引不支持重建；2. 虚索引和聚集索引不支持重建。
只有拥有 DBA/DB_OBJECT_ADMIN 角色权限的用户才能重建其他模式下的索引，普通用户仅能重建自己模式下的索引。
参数说明：
schname：模式名。
indexid：索引 ID。
返回值：
无
举例说明：
CREATE INDEX PRODUCT_IND ON PRODUCTION.PRODUCT(PRODUCTID);
SELECT ID FROM SYS.SYSOBJECTS WHERE NAME='PRODUCT_IND';//查询系统表SYSOBJECTS得到索引ID（33555595）
SP_REBUILD_INDEX('PRODUCTION', 33555595);
9）CONTEXT_INDEX_DEF
定义：
VARCHAR
CONTEXT_INDEX_DEF (
indexid int,
preflag int
)
功能说明：
获取全文索引的创建定义。
参数说明：
indexid：全文索引 ID。
preflag：对象前缀个数。1 表示导出模式名；0 表示只导出对象名。
返回值：
全文索引的创建定义。
举例说明：
create context index product_cind on production.product(name) LEXER DEFAULT_LEXER;
//查询系统表得到全文索引ID
select name, id from sysobjects where name='PRODUCT_CINd';
select context_index_def(33555531, 1);
10）SYNONYMDEF
定义：
VARCHAR
SYNONYMDEF (
username varchar(128),
synname varchar(128),
type int,
preflag int
)
功能说明：
获取同义词的创建定义。
参数说明：
username：用户名。
synname：同义词名。
type：同义词类型。 0，public 1，user。
preflag：对象前缀个数。1 表示导出模式名；0 表示只导出对象名。
返回值：
同义词的创建定义。
举例说明：
SELECT SYNONYMDEF('SYSDBA', 'SYSOBJECTS',0,1);
11）SEQDEF
定义：
VARCHAR
SEQDEF (
seqid int,
preflag int
)
功能说明：
获取序列的创建定义。
参数说明：
seqid：序列 id 号。
preflag：对象前缀个数。1 表示导出模式名；0 表示只导出对象名。
返回值：
序列的创建定义。
举例说明：
CREATE SEQUENCE SEQ1;
SELECT ID FROM SYSOBJECTS WHERE NAME='SEQ1'; //查出id为167772160
SELECT SEQDEF(167772160, 1);
12）IDENT_CURRENT
定义：
INT
IDENT_CURRENT (
fulltablename varchar(261)
)
功能说明：
获取自增列当前值，不能用于 AUTO_INCREMENT 自增列。
参数说明：
fulltablename：表全名；格式为“模式名.表名”。
返回值：
自增列当前值。
举例说明：
SELECT IDENT_CURRENT('PRODUCTION.PRODUCT');
13）IDENT_SEED
定义：
INT
IDENT_SEED (
fulltablename varchar(261)
)
功能说明：
获取自增列种子，不能用于 AUTO_INCREMENT 自增列。
参数说明：
fulltablename：表全名；格式为“模式名.表名”。
返回值：
自增列种子。
举例说明：
select ident_seed('PRODUCTION.PRODUCT');
14）IDENT_INCR
定义：
INT
IDENT_INCR (
fulltablename varchar(261)
)
功能说明：
获取自增列增量值 increment，不能用于 AUTO_INCREMENT 自增列。
参数说明：
fulltablename：表全名；格式为“模式名.表名”。
返回值：
自增列增量值 increment。
举例说明：
select ident_incr('PRODUCTION.PRODUCT');
15）SCOPE_IDENTITY
定义：
INT
SCOPE_IDENTITY ();
功能说明：
返回插入到同一作用域中的 identity 列内的最后一个 identity 值。
返回值：
RVAL：函数返回值，长度为 8。
举例说明：
详见 GLOBAL_IDENTITY 例子。
16）GLOBAL_IDENTITY
定义：
INT
GLOBAL_IDENTITY();
功能说明：
返回在当前会话中的任何表内所生成的最后一个标识值，不受限于特定的作用域。一个作用域就是一个模块：存储过程、触发器、函数或批处理，若两个语句处于同一个存储过程、函数或批处理中，则它们位于相同的作用域中。
返回值：
RVAL：函数返回值，长度为 8。
举例说明：
DROP TABLE T1;
DROP TABLE T2;
CREATE TABLE T1(C1 INT IDENTITY(1,1), C2 CHAR);
CREATE TABLE T2(C1 INT IDENTITY(1,1), C2 CHAR);
INSERT INTO T1(C2) VALUES('a');
INSERT INTO T1(C2) VALUES('b');
INSERT INTO T1(C2) VALUES('c');
COMMIT;
SELECT SCOPE_IDENTITY();
////返回值：3
SELECT GLOBAL_IDENTITY();
//返回值：3
CREATE OR REPLACE TRIGGER TRI1 AFTER INSERT ON T1
BEGIN
INSERT INTO T2(C2) VALUES('a');
END;
/
INSERT INTO T1(C2) VALUES('d');
COMMIT;
SELECT SCOPE_IDENTITY();
//返回值：4
SELECT GLOBAL_IDENTITY();
//返回值：1
17）SF_CUR_SQL_STR
定义：
CLOB
SF_CUR_SQL_STR (
is_top int
)
功能说明：
用于并行环境中，获取当前执行的 SQL 语句。
参数说明：
is_top：取 0 时返回当前层计划执行的语句；取 1 时返回顶层计划语句。
返回值：
sql 语句。
举例说明：
SELECT SF_CUR_SQL_STR(0);
18）SF_COL_IS_CHECK_KEY
定义：
INT
SF_COL_IS_CHECK_KEY (
key_num int,
key_info varchar(32767),
col_id int
)
功能说明：
判断一个列是否为 CHECK 约束列。
参数说明：
key_num：约束列总数。
key_info：约束列信息。
col_id：列 id。
返回值：
返回 1 表示该列是 check 约束列，否则返回 0。
举例说明：
CREATE TABLE TC (C1 INT, C2 DOUBLE, C3 DATE, C4 VARCHAR, CHECK(C1 < 100 AND C4 IS NOT NULL));
SELECT TBLS.NAME, COLS.NAME, COLS.COLID, COLS.TYPE$, COLS.LENGTH$, COLS.SCALE, COLS.NULLABLE$, COLS.DEFVAL
FROM (SELECT ID, NAME FROM SYS.SYSOBJECTS WHERE NAME = 'TC' AND TYPE$ = 'SCHOBJ' AND SUBTYPE$ = 'UTAB' AND SCHID = (SELECT ID FROM SYS.SYSOBJECTS WHERE NAME = 'SYSDBA' AND TYPE$ = 'SCH')) AS TBLS,
(SELECT ID, PID, INFO1, INFO6 FROM SYS.SYSOBJECTS WHERE TYPE$ = 'TABOBJ' AND SUBTYPE$ = 'CONS') AS CONS_OBJ,SYS.SYSCOLUMNS AS COLS,SYS.SYSCONS AS CONS WHERE TBLS.ID = CONS_OBJ.PID AND TBLS.ID = COLS.ID AND SF_COL_IS_CHECK_KEY(CONS_OBJ.INFO1, CONS_OBJ.INFO6, COLS.COLID) = 1 AND CONS.TABLEID = TBLS.ID AND CONS.TYPE$ = 'C';
19）SF_REPAIR_HFS_TABLE
定义：
INT
SF_REPAIR_HFS_TABLE (
schname varchar(128),
tabname varchar(128)
)
功能说明：
HUGE 表日志属性为 LOG NONE 时，如果系统出现故障，导致该表数据不一致，则通过该函数修复表数据，保证数据的一致性。
参数说明：
schname：模式名。
tabname：表名。
返回值：
成功返回 0，否则报错。
举例说明：
CREATE HUGE TABLE T_DM(C1 INT, C2 VARCHAR(20)) LOG NONE;
INSERT INTO T_DM VALUES(99, 'DM8');
COMMIT;
UPDATE T_DM SET C1 = 100;//系统故障
SF_REPAIR_HFS_TABLE('SYSDBA','T_DM');
20）SP_ENABLE_EVT_TRIGGER
定义：
SP_ENABLE_EVT_TRIGGER (
schname varchar(128),
triname varchar(128),
enable bool
)
功能说明：
禁用/启用指定的事件触发器。
参数说明：
schname：模式名。
triname：触发器名。
enable：1 表示启用，0 表示禁用。
返回值：
成功返回 0，否则报错。
举例说明：
SP_ENABLE_EVT_TRIGGER('SYSDBA', 'TRI_1', 1);
SP_ENABLE_EVT_TRIGGER('SYSDBA', 'TRI_1', 0);
21）SP_ENABLE_ALL_EVT_TRIGGER
定义：
SP_ENABLE_ALL_EVT_TRIGGER (
enable bool
)
功能说明：
禁用/启用数据库上的所有事件触发器。
参数说明：
ENABLE：1 表示启用，0 表示禁用。
返回值：
成功返回 0，否则报错。
举例说明：
SP_ENABLE_ALL_EVT_TRIGGER(1);
SP_ENABLE_ALL_EVT_TRIGGER(0);
22）SF_GET_TRIG_DEPENDS
定义：
BINARY
SF_GET_TRIG_DEPENDS(
trigid int
)
功能说明：
查看触发器的依赖项。
参数说明：
trigid：触发器 id。
返回值：
触发器的依赖项。
举例说明：
CREATE TABLE T1_TRI_10000(OBJECTTYPE VARCHAR);
CREATE TRIGGER TRI1_TRI_10000 BEFORE CREATE ON DATABASE BEGIN INSERT INTO T1_TRI_10000 VALUES(:EVENTINFO.OBJECTTYPE); END;
SELECT SF_GET_TRIG_DEPENDS((SELECT ID FROM SYSOBJECTS WHERE NAME LIKE 'TRI1_TRI_10000'));
23）SF_GET_PROC_DEPENDS
定义：
BINARY
SF_GET_PROC_DEPENDS(
procid int
)
功能说明：
查看过程/函数的依赖项。
参数说明：
procid：过程/函数 id。
返回值：
过程/函数的依赖项。
举例说明：
CREATE OR REPLACE FUNCTION FUN1 (A INT) RETURN INT AS
S INT;
BEGIN
S:=A*A;
RETURN S;
EXCEPTION
WHEN OTHERS THEN NULL;
END;
/
CREATE OR REPLACE FUNCTION FUN2 (A INT, B INT) RETURN INT AS
S INT;
BEGIN
S:=A+B+FUN1(A);
RETURN S;
EXCEPTION
WHEN OTHERS THEN NULL;
END;
/
SELECT SF_GET_PROC_DEPENDS((SELECT ID FROM SYSOBJECTS WHERE NAME LIKE 'FUN2'));
24）SP_TMP_TABLE_CLEAR
定义：
SP_TMP_TABLE_CLEAR(
schname varchar(128),
tablename varchar(128)
)
功能说明：
清除指定的临时表中的数据，本操作不会改变事务的状态，但无论事务后续提交或回滚，临时表清除操作都被永久化。
参数说明：
schname：模式名。
tablename：临时表名。
返回值：
无
举例说明：
SYSDBA 用户创建临时表 T1，之后清除临时表 T1 的数据：
CREATE TEMPORARY TABLE T1(c1 int);
INSERT INTO T1 VALUES(1);
SP_TMP_TABLE_CLEAR('SYSDBA','T1');
25）SF_GET_VIEW_DEPEND_OBJINFO
定义：
SF_GET_VIEW_DEPEND_OBJINFO (
schname varchar(128),
viewname varchar(128),
col_seq int
depend_flag int
)
功能说明：
获取 viewname 视图所依赖的对象信息。只支持视图查询项表达式为列类型情况，经过表达式计算得来的视图列不支持。
参数说明：
schname：模式名。
viewname：视图名。
col_seq： 视图的列序号。0 表示返回视图中所有列依赖的基表列信息。N 表示返回视图中第 N 列所依赖的基表列信息。
depend_flag:需要返回对象类型标记。目前只支持 1 返回基表对象信息。
返回值：
视图依赖的对象信息。
举例说明：
返回 V1 中第二列 CITY 所依赖的基表列信息。
create view V1 AS select ADDRESS1,CITY from PERSON.ADDRESS;
select SF_GET_VIEW_DEPEND_OBJINFO ('SYSDBA','V1',2,1);
返回 V2 中第一列 ADDRESS1+10 所依赖的基表列信息，表达式不支持，显示为 UNKOWN。
create view V2 AS select ADDRESS1,CITY from PERSON.ADDRESS;
select SF_GET_VIEW_DEPEND_OBJINFO ('SYSDBA','V2',1,1);
26）SP_GET_MV_DEPEND_COLS_INFO
定义：
SP_GET_MV_DEPEND_COLS_INFO (
schname varchar(128),
mv_name varchar(128)
)
功能说明：
获取 mv_name 物化视图的列所直接依赖的对象列信息。当前用户必须对物化视图具有查询权限，否则不支持。
参数说明：
schname：模式名。
mv_name：物化视图名。
返回值：
物化视图依赖的对象列信息。
举例说明：
返回 MV1 所依赖的基表 T1 的列信息。
CREATE TABLE T1(C1 INT, C2 INT);
CREATE MATERIALIZED VIEW MV1 REFRESH ON COMMIT AS SELECT C1, C2 FROM T1;
SP_GET_MV_DEPEND_COLS_INFO('SYSDBA','MV1');
返回 MV2 所依赖的基视图 V1 的列信息。
create view V1 AS select c1, c2 from T1;
CREATE MATERIALIZED VIEW MV2 REFRESH ON COMMIT AS SELECT C1, C2 FROM v1;
SP_GET_MV_DEPEND_COLS_INFO('SYSDBA','MV2');
- SP_INIT_LIMITED_USER_QUOTA
定义：
SP_INIT_LIMITED_USER_QUOTA()
功能说明：
重新加载所有用户的表空间配额限制。
参数说明：
无
返回值：
无
举例说明：
重新加载所有用户的表空间配额限制。
SP_INIT_LIMITED_USER_QUOTA();
- SP_SWITCH_SYSVIEW
定义：
SP_SWITCH_SYSVIEW (
flag int
)
功能说明：
对 DPC 环境下涉及分区相关的系统视图查询进行优化，使查询优化后的视图耗时降低，在数据量大时推荐切换为优化后的视图进行查询。
通过使用该存储过程可以在视图的原始定义和针对 DPC 优化后的视图定义之间切换，支持切换的系统视图包括：分区子表信息相关的 DBA_TAB_SUBPARTITIONS、ALL_TAB_SUBPARTITIONS、USER_TAB_SUBPARTITIONS；分区列信息相关的 USER_SUBPART_KEY_COLUMNS、ALL_SUBPART_KEY_COLUMNS。
DPC 环境默认使用优化后的视图。且本存储过程为 DPC 环境专用，在非 DPC 环境下使用时报错。
参数说明：
flag：取值 0 表示同义词指向原始视图定义，取值 1 表示使用优化后视图定义；缺省为 1。
返回值：
无
举例说明：
DPC 环境下，设置使用原始系统视图定义。
SP_SWITCH_SYSVIEW(0);
- OPERATORDEF
定义：
VARCHAR
OPERATORDEF (
schname varchar(128),
obj_name varchar(128)
)
功能说明：
获取自定义运算符的定义。
参数说明：
schname：模式名。
obj_name：自定义运算符名称。
返回值：
自定义运算符的定义。
举例说明：
//在SYSDBA模式下，创建存储函数FUNC_TEST
CREATE FUNCTION FUNC_TEST(
C IN INT
) RETURN INTEGER
AS
BEGIN
RETURN C*2;
END;
/
//在SYSDBA模式下，基于存储函数FUNC_TEST创建自定义运算符%^
CREATE OPERATOR %^ (FUNCTION FUNC_TEST, LEFTARG INT, RIGHTARG INT);
//获取自定义运算符%^的定义
SELECT OPERATORDEF('SYSDBA', '%^');
- SF_GET_EXTFUN_REF_NAME
定义：
VARCHAR
SF_GET_EXTFUN_REF_NAME (
proc_id int
)
功能说明：
获取外部函数的引用函数名。
参数说明：
proc_id：外部函数 id。
返回值：
外部函数的引用函数名。
举例说明：
查询 SYSDBA 模式下 JAVA 外部函数 MY_INT 的引用函数名。
SELECT SF_GET_EXTFUN_REF_NAME(ID) FROM SYSTEXTS WHERE ID = (SELECT ID FROM SYSOBJECTS WHERE NAME LIKE 'MY_INT' AND SCHID = (SELECT ID FROM SYSOBJECTS WHERE NAME LIKE 'SYSDBA' AND TYPE$='SCH'));
- SF_XBOX_SYS_DUMP_LEN
定义：
BIGINT
SF_XBOX_SYS_DUMP_LEN()
功能说明：
获取实例上所有 XBOX 临时文件保存的邮件总量，单位 BYTE。在 DMDPC 环境下需要直连实例所在的节点执行。
参数说明：
无
返回值：
实例上所有 XBOX 临时文件保存的邮件总量。
举例说明：
SELECT SF_XBOX_SYS_DUMP_LEN();
32）DBLINKDEF
定义：
VARCHAR
DBLINKDEF (
schname varchar(128),
linkname varchar(128),
type int,
sch_prefix int
)
功能说明：
获取外部链接的定义。
参数说明：
schname：模式名。
linkname：外部链接名。
type：外部链接类型，0：public 链接，1：私有链接。
sch_prefix：返回的定义中是否补充模式名前缀(仅对私有 dblink 有效)，0：不补充模式名前缀，1：补充模式名前缀。
返回值：
外部链接定义。
举例说明：
CREATE LINK LINK1 CONNECT 'ORACLE' WITH USER01 IDENTIFIED BY Oracle_123 USING 'ORCL';
SELECT DBLINKDEF('SYSDBA','LINK1', 1, 1) FROM DUAL;
33）RESET_ATTRINFO_BY_ID
定义：
RESET_ATTRINFO_BY_ID (
objid int,
)
功能说明：
根据传入的对象 ID，将其属性信息在系统表 SYSTYPEATTRINFO 中重置。
参数说明：
objid：需要重置的对象 ID。
返回值：
无
举例说明：
CREATE OR REPLACE TYPE TP1 AS OBJECT (
A INT,
B VARCHAR2(100)
);
SELECT ID FROM SYSOBJECTS WHERE NAME = 'TP1';
--根据查询到的对象ID，调用系统函数
RESET_ATTRINFO_BY_ID(234882104)；
- RESET_ATTRINFO_BY_NAME
定义：
RESET_ATTRINFO_BY_NAME (
schname varchar(128),
objname varchar(128)
)
功能说明：
根据传入的 schname 和 objname 定位对象，并将系统表 SYSTYPEATTRINFO 中的对象属性信息重置。
参数说明：
schname：对象所属模式名。
objname：对象名。
返回值：
无
举例说明：
CREATE OR REPLACE TYPE SYSDBA.TP1 AS OBJECT (
A INT,
B VARCHAR2(100)
);
RESET_ATTRINFO_BY_NAME('SYSDBA', 'TP1');
- SF_HUGE_CHECK_SECIND
定义：
SF_HUGE_CHECK_SECIND(
schname varchar(128),
tabname varchar(128)
)
功能说明：
检查 huge 表所有二级索引中数据是否与列存数据一致。
参数说明：
schname：对象所属模式名。
tabname：表名。
返回值：
二级索引数据一致时返回 1，不一致时返回 0，出错返回错误码。
举例说明：
CREATE HUGE TABLE HTAB_SECIND(C1 INT, C2 VARCHAR);
CREATE INDEX HTAB_SECIND_1 ON HTAB_SECIND(C1);
SELECT SF_HUGE-CHECK_SECIND('SYSDBA','HTAB_SECIND');
- SF_GET_USER_DEFAULT_TS_GROUP
定义：
VARCHAR(128)
SF_GET_USER_DEFAULT_TS_GROUP
(
USER_NAME VARCHAR(128)
)
功能说明：
获取指定用户的默认表空间组名。如果此用户未指定默认表空间组，返回 NULL。
参数说明：
USER_NAME: 用户名。
返回值：
指定用户的默认表空间组名。
举例说明：
获取用户 USER1 的默认表空间组名。
SELECT SF_GET_USER_DEFAULT_TS_GROUP(‘USER1’);
6. 数据守护管理
本小节的存储过程都与 DM 的数据守护功能相关，关于数据守护的概念和相关环境配置与操作可以参考《DM8 数据守护与读写分离集群 V4.0》相关章节。
1）SP_SET_OGUID
定义：
SP_SET_OGUID (
oguid int
)
功能说明：
设置主备库监控组的 ID 号。
参数说明：
oguid：oguid。
返回值：
无
举例说明：
SP_SET_OGUID (451245);
2）SF_GET_BROADCAST_ADDRESS
定义：
VARCHAR
SF_GET_BROADCAST_ADDRESS (
ip_addr varchar,
subnet_mask varchar
)
功能说明：
根据 IPv4 的 IP 地址以及子网掩码计算广播地址。
参数说明：
ip_addr：输入的 IP 地址。
subnet_mask：子网掩码地址。
返回值：
广播地址。
举例说明：
select sf_get_broadcast_address('15.16.193.6','255.255.248.0');
3）SP_SET_RT_ARCH_VALID
定义：
SP_SET_RT_ARCH_VALID ()
功能说明：
设置实时归档有效。
参数说明：
无
返回值：
无
举例说明：
SP_SET_RT_ARCH_VALID ();
4）SP_SET_RT_ARCH_INVALID
定义：
SP_SET_RT_ARCH_INVALID ()
功能说明：
设置实时归档无效。
参数说明：
无
返回值：
无
举例说明：
SP_SET_RT_ARCH_INVALID ();
5）SF_GET_RT_ARCH_STATUS
定义：
VARCHAR
SF_GET_RT_ARCH_STATUS ()
功能说明：
获取实时归档状态。
参数说明：
无
返回值：
有效：VALID。
无效：INVALID。
举例说明：
SELECT SF_GET_RT_ARCH_STATUS ();
6）SP_SET_ARCH_STATUS
定义：
SP_SET_ARCH_STATUS (
arch_dest varchar,
arch_status int
)
功能说明：
设置指定归档目标的归档状态。
如果主库是 DSC 集群，则将备库的归档状态置为无效后，需要连接对应备库执行 SP_CLEAR_PKG_DEPENDS 清理正在等待依赖包的待重演日志包，避免备库上的重演操作卡住。
参数说明：
arch_dest：归档目标名称。
arch_status：要设置的归档状态，取值 0 或 1，0 表示有效状态，1 表示无效状态。
返回值：
无
举例说明：
SP_SET_ARCH_STATUS('DM1', 1);
7）SP_SET_ALL_ARCH_STATUS
定义：
SP_SET_ALL_ARCH_STATUS (
arch_status int
)
功能说明：
设置所有归档目标的归档状态。
如果主库是 DSC 集群，且要将备库的归档状态置为无效时，要求主库的各节点都处于 SUSPEND 状态。
参数说明：
arch_status：要设置的归档状态，取值 0 或 1，0 表示有效状态，1 表示无效状态。
返回值：
无
举例说明：
SP_SET_ALL_ARCH_STATUS(1);
8）SP_APPLY_KEEP_PKG
定义：
SP_APPLY_KEEP_PKG()
功能说明：
APPLY 备库的 KEEP_PKG 数据。
参数说明：
无
返回值：
无
举例说明：
SP_APPLY_KEEP_PKG();
9）SP_DISCARD_KEEP_PKG
定义：
SP_DISCARD_KEEP_PKG()
功能说明：
丢弃备库的 KEEP_PKG 数据。
参数说明：
无
返回值：
无
举例说明：
SP_DISCARD_KEEP_PKG();
10）SP_CLEAR_ARCH_SEND_INFO
定义一：
SP_CLEAR_ARCH_SEND_INFO()
或
SP_CLEAR_ARCH_SEND_INFO(inst_name varchar)
功能说明：
此系统函数在主库上执行有效，用于清理到备库最近 N 次的归档发送信息。保留总的归档发送信息和最大发送信息。
如果不指定 inst_name，则清理所有备库最近 N 次的归档发送信息。
N 值为 V$ARCH_SEND_INFO 中的 RECNT_SEND_CNT 值。
参数说明：
inst_name：备库实例名。
返回值：
无
举例说明：
SP_CLEAR_ARCH_SEND_INFO();
SP_CLEAR_ARCH_SEND_INFO('GRP1_RWW_02');
定义二：
SP_CLEAR_ARCH_SEND_INFO(
clear_all int
)
功能说明：
此系统函数在主库上执行有效，用于清理到所有备库最近 N 次的归档发送信息。
可以通过指定 clear_all 判断是否需要清理总的归档发送信息和最大发送信息。
N 值为 V$ARCH_SEND_INFO 中的 RECNT_SEND_CNT 值。
参数说明：
clear_all：用于设置是否清理总的归档发送信息和最大发送信息。取值 0 或 1，若 clear_all 指定为 0，则不清理总的发送信息和最大发送信息；若 clear_all 指定为 1，则清理总的发送信息和最大发送信息。
返回值：
无
举例说明：
SP_CLEAR_ARCH_SEND_INFO(0);
SP_CLEAR_ARCH_SEND_INFO(1);
定义三：
SP_CLEAR_ARCH_SEND_INFO(
inst_name varchar,
clear_all int
)
功能说明：
此系统函数在主库上执行有效，用于清理到指定备库 inst_name 最近 N 次的归档发送信息。
可以通过指定 clear_all 判断是否需要清理总的归档发送信息和最大发送信息。N 值为 V$ARCH_SEND_INFO 中的 RECNT_SEND_CNT 值。
参数说明：
inst_name：备库实例名。该参数可不指定，不指定则和定义二一致。
clear_all：用于设置是否清理总的归档发送信息和最大发送信息。取值 0 或 1，若 clear_all 指定为 0，则不清理总的归档发送信息和最大发送信息；若 clear_all 指定为 1，则清理总的归档发送信息和最大发送信息。
返回值：
无
举例说明：
SP_CLEAR_ARCH_SEND_INFO('RT_02',0);
SP_CLEAR_ARCH_SEND_INFO('RT_03', 1);
11）SP_CLEAR_RAPPLY_STAT
定义：
SP_CLEAR_RAPPLY_STAT()
功能说明：
此系统函数在备库上执行有效，用于清理此备库最近 N 次的日志重演信息。
N 值为 V$RAPPLY_STAT 中的 RECNT_APPLY_NUM 值。
参数说明：
无
返回值：
无
举例说明：
SP_CLEAR_RAPPLY_STAT();
12）SP_ADD_TIMELY_ARCH(
定义：
SP_ADD_TIMELY_ARCH(
inst_name varchar
)
功能说明：
OPEN 状态下动态扩展 TIMELY 归档。
参数说明：
inst_name：TIMELY 归档的目标实例名。
返回值：
无
举例说明：
SP_ADD_TIMELY_ARCH('DB3');
13）SF_MAL_CONFIG
定义：
SF_MAL_CONFIG(
cfg_flag int,
bro_flag int
)
功能说明：
设置 MAL 配置状态。
参数说明：
cfg_flag：1，设置配置状态；0 取消配置状态。
bro_flag：1，多节点广播设置；0 本地设置。
返回值：
无
举例说明：
SF_MAL_CONFIG(1,0);
14）SF_MAL_INST_ADD
定义：
SF_MAL_INST_ADD(
item_name varchar,
inst_name varchar,
mal_ip varchar,
mal_port int,
mal_inst_ip varchar,
mal_inst_port int,
dw_port int,
link_magic int,
inst_dw_port int
)
功能说明：
增加 MAL 配置项。
参数说明：
item_name：配置项名称。
inst_name：实例名。
mal_ip：MAL IP 地址。
mal_port：MAL 端口。
mal_inst_ip：实例 IP 地址。
mal_inst_port：实例端口。
dw_port：守护进程端口，用于和远程守护进程/或者监视器通信。
link_magic：链路魔数。
inst_dw_port：实例和本地守护进程通信的端口。
举例说明：
SF_MAL_INST_ADD('MAL_INST3','GRP1_RT_DSC01','192.168.0.143',8338,'192.168.1.133',31431, 3567,0, 4567);
15）SF_MAL_CONFIG_APPLY
定义：
SF_MAL_CONFIG_APPLY()
功能说明：
将 MAL 配置生效。
参数说明：
无
举例说明：
sf_mal_config_APPLY();
16）SP_SET_ARCH_SEND_UNTIL_TIME
定义：
SP_SET_ARCH_SEND_UNTIL_TIME(
dest varchar,
until_time varchar
)
功能说明：
设置异步备库重演到指定时间。
参数说明：
dest：异步归档目标库实例名。
until_time：重演到指定时间点。若为空串，则表示取消重演到指定时间点。
举例说明：
SP_SET_ARCH_SEND_UNTIL_TIME('EP01', '2020-09-14 10:00:00');
取消重演到指定时间点：
SP_SET_ARCH_SEND_UNTIL_TIME('EP01', '');
17）SP_GET_ARCH_SEND_UNTIL_TIME
定义：
VARCHAR
SF_GET_ARCH_SEND_UNTIL_TIME(
dest varchar
)
功能说明：
获取异步备库的重演指定时间。
参数说明：
dest：异步归档目标库实例名。
举例说明：
SP_GET_ARCH_SEND_UNTIL_TIME('EP01');
18）SP_NOTIFY_ARCH_SEND
定义：
SP_NOTIFY_ARCH_SEND(
dest varchar
)
功能说明：
通知源库立即发送归档到指定异步备库。
参数说明：
dest：异步归档目标库实例名。
举例说明：
SP_NOTIFY_ARCH_SEND('EP01');
- SF_GET_ARCHIVE_SIZE
定义：
BIGINT
SF_GET_ARCHIVE_SIZE(
dsc_seqno int,
type int,
start bigint
)
功能说明：
根据指定的节点号、比较方式和起始位置，计算出该节点上从起始位置开始的剩余归档日志量。
此系统函数主要用于备库归档无效场景下计算主备相差的日志量。在备库归档有效（和主库保持实时同步）的情况下，主库很可能会因为日志包还未归档导致无法计算日志量。
参数说明：
dsc_seqno：指定 DMDSC 节点号。若调用该函数的数据库为单节点库，则该字段需要传入 0。
type：比较方式。取值范围 0 或 1。0：使用全局包序号 G_SEQNO 进行比较；1：使用 LSN 进行比较。
start：起始位置。若 type 输入值为 0，则此字段需要传入起始的 G_SEQNO；若 type 为 1，则该字段需要传入起始 LSN。
返回值：
返回从 start 指定位置开始的剩余归档日志量，单位为字节（Byte）。
举例说明：
查询 0 号节点上从 G_SEQNO=8000 开始的剩余归档日志量：
SELECT SF_GET_ARCHIVE_SIZE(0, 0, 8000);
查询 1 号节点上从 LSN=40000 开始的剩余归档日志量：
SELECT SF_GET_ARCHIVE_SIZE(1, 1, 40000);
- SF_SET_STANDBY_DETACH
定义：
SP_SET_STANDBY_DETACH(
dest varchar,
clear_flag int
)
功能说明：
向数据库中插入或删除一条 DETACH 记录，用于将指定备库 DETACH 出集群或者 ATTACH 回集群。
此过程只允许在主库上执行。若主库是 DSC，则只允许在控制节点上执行。
此过程只允许具有 DBA 权限的用户执行，并且要求系统状态为 OPEN。
参数说明：
dest：需要 DETACH 或 ATTACH 的备库实例名。若备库是 DSC，则指定 DSC 集群内任一节点的实例名即可。在 clear_flag 为 1 的情况下，此参数允许传空。
clear_flag：是插入还是删除指定备库的 DETACH 记录，取值 0 或 1。
0：插入一条指向 dest 指定库的 DETACH 记录，要求 dest 指定库的归档状态为 INVALID。最多能够插入 8 条 DETACH 记录。
1：删除指向 dest 指定库的 DETACH 记录。若 dest 为空，则删除所有已登记的 DETACH 记录。
返回值：
无
举例说明：
插入一条指向 DM1 备库的 DETACH 记录：
SP_SET_STANDBY_DETACH('DM1', 0);
删除指向 DM2 备库的 DETACH 记录：
SP_SET_STANDBY_DETACH('DM2', 1);
删除已登记的所有 DETACH 记录：
SP_SET_STANDBY_DETACH('',1);
- SP_CLEAR_PKG_DEPENDS
定义：
SP_CLEAR_PKG_DEPENDS()
功能说明：
适用于 DMDSC 主库的数据守护环境，在备库上执行，用于清理备库上正在等待依赖包的待重演日志包，并截断日志。
该系统过程建议和 SP_SET_ARCH_STATUS 搭配使用，先在主库上执行 SP_SET_ARCH_STATUS 将备库的归档状态置为无效，之后再在备库上执行 SP_CLEAR_PKG_DEPENDS 清理日志包并截断日志，否则可能导致备库后续无法进行故障恢复。
执行该系统过程要求备库处于 OPEN 状态。如果备库是 DMDSC 集群，则只需在备库控制节点上执行该系统过程即可。
参数说明：
无
返回值：
无
举例说明：
SP_CLEAR_PKG_DEPENDS();
7. MPP 管理
1）SP_SET_SESSION_MPP_SELECT_LOCAL
定义：
SP_SET_SESSION_MPP_SELECT_LOCAL (
local_flag int
)
功能说明：
MPP 系统下设置当前会话是否只查询本节点数据。如果不设置，表示可以查询全部节点数据。
参数说明：
local_flag：设置标记。1 代表只查询本节点数据；0 代表查询全部节点数据。
返回值：
无
举例说明：
SP_SET_SESSION_MPP_SELECT_LOCAL(1);
2）SF_GET_SESSION_MPP_SELECT_LOCAL
定义：
INT
SF_GET_SESSION_MPP_SELECT_LOCAL ()
功能说明：
查询 MPP 系统下当前会话是否只查询本节点数据。
参数说明：
无
返回值：
1 代表只查询本节点数据，0 查询全部节点数据。
举例说明：
SELECT SF_GET_SESSION_MPP_SELECT_LOCAL();
3）SP_SET_SESSION_LOCAL_TYPE
定义：
SP_SET_SESSION_LOCAL_TYPE (
ddl_flag int
)
功能说明：
MPP 下本地登录时，设置本会话上是否允许 DDL 操作。本地登录默认不允许 DDL 操作。
参数说明：
ddl_flag：为 1 时表示允许当前本地会话执行 DDL 操作，为 0 时则不允许。
返回值：
无
举例说明：
MPP 下本地登录会话：
SP_SET_SESSION_LOCAL_TYPE (1);
CREATE TABLE TEST(C1 INT);
SP_SET_SESSION_LOCAL_TYPE (0);
4）SF_GET_SELF_EP_SEQNO
定义：
INT
SF_GET_SELF_EP_SEQNO ()
功能说明：
获取本会话连接的 EP 站点序号。
参数说明：
无
返回值：
获取本会话连接的 EP 站点序号。
举例说明：
select SF_GET_SELF_EP_SEQNO();
5）SP_GET_EP_COUNT
定义：
INT
SP_GET_EP_COUNT (
sch_name varchar(128),
tab_name varchar(128)
);
功能说明：
统计 MPP 环境下表在各个站点的数据行数。
参数说明：
sch_name：表所在模式名。
tab_name：表名。
举例说明：
SP_GET_EP_COUNT('SYSDBA','T');
6）SF_MPP_INST_ADD
定义：
SF_MPP_INST_ADD(
item_name varchar,
inst_name varchar
)
功能说明：
增加 MPP 实例配置。
参数说明：
item_name：配置项名称。
inst_name：实例名。
举例说明：
SF_MPP_INST_ADD(' service_name3', 'EP03');
7）SF_MPP_INST_REMOVE
定义：
SF_MPP_INST_REMOVE(
inst_name varchar
)
功能说明：
删除 MPP 实例。
参数说明：
inst_name：实例名。
举例说明：
SF_MPP_INST_REMOVE('EP03');
8. 日志与检查点管理
1）CHECKPOINT
定义：
INT
CHECKPOINT (
rate int
)
功能说明：
设置检查点。需要注意的是：在 DSC 环境下，OK 节点个数大于 1 时，MOUNT 状态下调用该函数不会生效。
参数说明：
rate：刷脏页百分比，取值范围：1~100。
返回值：
检查点是否成功，0 表示成功，非 0 表示失败。
举例说明：
设置刷脏页百分比为 30% 的检查点：
SELECT CHECKPOINT(30);
2）SF_ARCHIVELOG_DELETE_BEFORE_TIME
定义：
INT
SF_ARCHIVELOG_DELETE_BEFORE_TIME (
time datetime
)
功能说明：
数据库以归档模式打开的情况下，删除指定时间之前的本地归档日志文件。待删除的文件必须处于未被使用状态。在 DSC 集群中，本地归档会共享为其他节点的远程节点，连接任一节点执行 SF_ARCHIVELOG_DELETE_BEFORE_TIME，会删除该节点本地归档及远程归档中指定时间之前的归档文件，即删除 DSC 集群中所有节点在指定时间之前的本地归档。
参数说明：
time：指定删除的最大关闭时间，若大于当前使用归档日志文件的创建时间，则从当前使用归档文件之前的归档日志文件开始删除。
返回值：
删除归档日志文件数，-1 表示出错。
举例说明：
删除三天之前的归档日志：
SELECT SF_ARCHIVELOG_DELETE_BEFORE_TIME(SYSDATE - 3);
3）SF_ARCHIVELOG_DELETE_BEFORE_LSN
定义：
INT
SF_ARCHIVELOG_DELETE_BEFORE_LSN (
lsn bigint
)
功能说明：
数据库以归档模式打开的情况下，删除小于指定 LSN 值的本地归档日志文件。待删除的文件必须处于未被使用状态。
参数说明：
lsn：指定删除的最大 LSN 值文件，若指定 lsn 值大于当前正在使用归档日志的起始 LSN（arch_lsn），则从当前使用归档文件之前的文件开始删除。
返回值：
删除归档日志文件数，-1 表示出错。
举例说明：
删除 LSN 值小于 95560 的归档日志文件：
SELECT SF_ARCHIVELOG_DELETE_BEFORE_LSN(95560);
4） SP_ELOG_FILE_DELETE
定义：
SP_ELOG_FILE_DELETE (
[SITE_ID INT,]
FILE_NAME VARCHAR(128)
)
功能说明：
支持删除当前实例生成的ELOG日志文件。将删除日志文件的功能给角色SYSDBA。
参数说明：
SITE_ID：要删除的ELOG日志文件所在的服务器站点号，为空时删除本地的ELOG日志文件。
FILE_NAME：要删除的ELOG日志文件名，包含文件后缀，不包含文件路径。
返回值：
无。
举例说明：
删除文件名为”dm_DMSEVER_202209.log”的本地日志文件：
SP_ELOG_FILE_DELETE('DM_DMSEVER_202209.LOG');
- SP_REFRESH_SVR_LOG_CONFIG
定义：
SP_REFRESH_SVR_LOG_CONFIG(
)
功能说明：
重新加载 SQL 日志模块，使 SQLLOG.INI 中新修改的值生效。
参数说明：
无。
返回值：
无。
举例说明：
SP_REFRESH_SVR_LOG_CONFIG();
9. 统计信息
达梦数据库的统计数据对象分三种：表统计信息、列统计信息和索引统计信息。使用表、索引统计信息相关的过程需要具有表查询权限；使用列统计信息相关的过程需要具有列查询权限。
以下对象不支持统计信息：1. 外部表、DBLINK 远程表、动态视图、记录类型数组所用的临时表；2. 所在表空间为 OFFLINE 的对象；3. 位图索引，位图连接索引、虚索引、无效的索引、全文索引；4. BLOB、IMAGE、LONGVARBINARY、CLOB、TEXT、LONGVARCHAR 等列类型。
1）SP_TAB_INDEX_STAT_INIT
定义：
SP_TAB_INDEX_STAT_INIT (
schname varchar(128),
tablename varchar(128)
)
功能说明：
对表上所有的索引生成统计信息。
参数说明：
schname：模式名。
tablename：表名。
举例说明：
对 SYSOBJECTS 表上所有的索引生成统计信息：
SP_TAB_INDEX_STAT_INIT ('SYS', 'SYSOBJECTS');
- SP_TAB_INDEX_STAT_INIT
定义
SP_TAB_INDEX_STAT_INIT (
schname varchar(128),
tablename varchar(128)，
estimate_percent double
)
功能说明：
对表上所有的索引生成统计信息。
参数说明：
schname：模式名。
tablename：表名。
estimate_percent: 收集的百分比，范围为0~100，低于0.000001时按0.000001计算。默认系统自定。
举例说明
对 SYSOBJECTS 表上所有的索引按照 50% 的采样比例生成统计信息：
SP_TAB_INDEX_STAT_INIT ('SYS', 'SYSOBJECTS', 50);
3）SP_DB_STAT_INIT
定义：
SP_DB_STAT_INIT (
)
功能说明：
对库上所有模式下的所有用户表以及表上的所有索引生成统计信息。
举例说明：
对库上所有模式下的所有用户表以及表上的所有索引生成统计信息：
CALL SP_DB_STAT_INIT ();
- SP_DB_STAT_INIT
定义
SP_DB_STAT_INIT (
estimate_percent double,
flag int default 1
)
功能说明
对库上所有模式下的所有用户表以及表上的所有索引生成统计信息。
参数说明
estimate_percent: 收集的百分比，范围为 0~100，低于 0.000001 时按 0.000001 计算。默认系统自定。
flag: 是否收集列统计信息的标记，flag=0 表示不收集列的统计信息，flag= 1 表示收集列的统计信息。默认收集列的统计信息。
举例说明：
例 1 对库上所有模式下的所有用户表、表上的所有索引、表上所有列按照 50% 的采样百分比生成统计信息：
SP_DB_STAT_INIT (50, 1);
例 2 对库上所有模式下的所有用户表、表上的所有索引、表上所有列按照系统自定义的采样百分比生成统计信息：
SP_DB_STAT_INIT (NULL, 1);
例 3 对库上所有模式下的所有用户表、表上的所有索引按照系统 50% 的采样百分比生成统计信息：
SP_DB_STAT_INIT (50, 0);
5）SP_INDEX_STAT_INIT
定义：
SP_INDEX_STAT_INIT (
schname varchar(128),
indexname varchar(128)
)
功能说明：
对指定的索引生成统计信息。
参数说明：
schname：模式名。
indexname：索引名。
举例说明：
对指定的索引 IND 生成统计信息：
SP_INDEX_STAT_INIT ('SYSDBA', 'IND');
6）SP_COL_STAT_INIT
定义：
SP_COL_STAT_INIT (
schname varchar(128),
tablename varchar(128),
colname varchar(128)
)
功能说明：
对指定的列生成统计信息，不支持大字段列和虚拟列。
参数说明：
schname：模式名。
tablename：表名。
colname：列名。
举例说明：
对表 SYSOBJECTS 的 ID 列生成统计信息：
SP_COL_STAT_INIT ('SYS', 'SYSOBJECTS', 'ID');
7）SP_TAB_COL_STAT_INIT
定义：
SP_TAB_COL_STAT_INIT (
schname varchar(128),
tablename varchar(128)
)
功能说明：
对某个表上所有的列生成统计信息。
参数说明：
schname：模式名。
tablename：表名。
举例说明：
对'SYSOBJECTS'表上所有的列生成统计信息：
SP_TAB_COL_STAT_INIT ('SYS', 'SYSOBJECTS');
8）SP_STAT_ON_TABLE_COLS
定义：
SP_STAT_ON_TABLE_COLS(
schname varchar(128),
tablename varchar(128),
percent int
)
功能说明：
对某个表上所有的列，按照指定的采样率生成统计信息。
参数说明：
schname：模式名。
tablename：表名。
percent：采样率（0-100]。
举例说明：
对'SYSOBJECTS'表上所有的列生成统计信息，采样率 90：
SP_STAT_ON_TABLE_COLS ('SYS','SYSOBJECTS',90);
9）SP_TAB_STAT_INIT
定义：
SP_TAB_STAT_INIT (
schname varchar(128),
tablename varchar(128)
)
功能说明：
对某张表生成统计信息。
参数说明：
schname：模式名。
tablename：表名。
举例说明：
对表 SYSOBJECTS 生成统计信息：
SP_TAB_STAT_INIT ('SYS', 'SYSOBJECTS');
10）SP_SQL_STAT_INIT
定义：
SP_SQL_STAT_INIT (
sql varchar(32767)
)
功能说明：
对某个 SQL 查询语句中涉及的所有表和过滤条件中的列(不包括大字段、ROWID)生成统计信息。
可能返回的错误提示：
- 语法分析出错，sql 语句语法错误；
- 对象不支持统计信息，统计的表或者列不存在，或者不允许被统计。
参数说明：
sql：sql 语句。
举例说明：
对'SELECT * FROM SYSOBJECTS'语句涉及的所有表生成统计信息：
SP_SQL_STAT_INIT ('SELECT * FROM SYSOBJECTS');
11）SP_INDEX_STAT_DEINIT
定义：
SP_INDEX_STAT_DEINIT (
schname varchar(128),
indexname varchar(128)
)
功能说明：
清空指定索引的统计信息。
参数说明：
schname：模式名。
indexname：索引名。
举例说明：
清空索引 IND 的统计信息：
SP_INDEX_STAT_DEINIT ('SYSDBA', 'IND');
12）SP_COL_STAT_DEINIT
定义：
SP_COL_STAT_DEINIT (
schname varchar(128),
tabname varchar(128),
colname varchar(128)
)
功能说明：
删除指定列的统计信息。
参数说明：
schname：模式名。
tabname：表名。
colname：列名。
举例说明：
删除 SYSOBJECTS 的 ID 列的统计信息：
SP_COL_STAT_DEINIT ('SYS', 'SYSOBJECTS', 'ID');
13）SP_TAB_COL_STAT_DEINIT
定义：
SP_TAB_COL_STAT_DEINIT (
schname varchar(128),
tablename varchar(128)
)
功能说明：
删除表和表上所有列的统计信息。
参数说明：
schname：模式名。
tablename：表名。
举例说明：
删除 SYSOBJECTS 表和表上所有列的统计信息：
SP_TAB_COL_STAT_DEINIT ('SYS', 'SYSOBJECTS');
14）SP_TAB_STAT_DEINIT
定义：
SP_TAB_STAT_DEINIT (
schname varchar(128),
tablename varchar(128)
)
功能说明：
删除某张表的统计信息。
参数说明：
schname：模式名。
tablename：表名。
举例说明：
删除表 SYSOBECTS 的统计信息：
SP_TAB_STAT_DEINIT ('SYS', 'SYSOBJECTS');
15）ET
定义：
ET(
id_in bigint
)
功能说明：
统计执行 ID 为 ID_IN 的所有操作符的执行时间。需设置 INI 参数 ENABLE_MONITOR=1 和 MONITOR_SQL_EXEC=1。
参数说明：
id_in：SQL 语句的执行 ID。
举例说明：
select count(*) from sysobjects where name='SYSDBA';
行号 COUNT(*)
---------- --------------------
1 2
已用时间: 14.641(毫秒). 执行号:26.
可以得到执行号为 26。
et(26);
执行结果如下：
OP TIME(US) PERCENT RANK SEQ N_ENTER MEM_USED(KB)
----- -------------------- ------- -------------------- ----------- ----------- --------------------
DISK_USED(KB) HASH_USED_CELLS HASH_CONFLICT DHASH3_USED_CELLS DHASH3_CONFLICT HASH_SAME_VALUE
-------------------- -------------------- -------------------- ----------------- --------------- --------------------
PRJT2 5 2.30% 4 2 4 0
0 0 0 NULL NULL 0
AAGR2 33 15.21% 3 3 4 0
0 0 0 NULL NULL 0
NSET2 59 27.19% 2 1 3 0
0 0 0 NULL NULL 0
SSEK2 120 55.30% 1 4 2 0
0 0 0 NULL NULL 0
结果中每一行对应一个操作符，每一列对应的解释如下：
| 列名 | 含义 |
|---|---|
| OP | 操作符名称 |
| TIME(US) | 执行耗时，单位：微秒 |
| PERCENT | 在整个计划中用时占比 |
| RANK | 执行耗时排名，由高到低正序排序 |
| SEQ | 计划中的序号 |
| N_ENTER | 操作符进入的次数 |
| MEM_USED(KB) | 操作符使用的内存空间，单位：KB |
| DISK_USED(KB) | 操作符使用的磁盘空间，单位：KB |
| HASH_USED_CELLS | 哈希表使用的槽数 |
| HASH_CONFLICT | 哈希表存在冲突的记录数 |
| DHASH3_USED_CELLS | 动态哈希表中使用的槽数 |
| DHASH3_CONFLICT | 动态哈希表中的冲突情况 |
| HASH_SAME_VALUE | 开启哈希相同值挂链优化时，记录哈希表中相同值的总数，唯一值不纳入计数。例如：哈希表中存在一个 0 和两个相同值链 1—1—1、3—3，此时 HASH_SAME_VALUE=5 |
如果某些操作符并没有真正执行或者耗时很短，则不会在 ET 中显示。另外，结果中出现了 EXPLAIN 计划中没有的 DLCK 操作符，它是用来对字典对象的上锁处理，通常情况下可以忽略。
16）SP_UPDATE_SYSSTATS
定义：
SP_UPDATE_SYSSTATS（
flag int
)
功能说明：
用以升级及迁移统计信息。7.1.5.173 及之后的版本支持该功能。
参数说明：
flag：标记，取值 0、1、2、3、4、99。 0：回退版本；1：创建统计信息升级辅助表； 2：升级 SYS.SYSSTATS 表结构； 3：导入 SYS.SYSSTATS 表数据； 4：删除升级辅助表；参数 99：理想状态下使用，集合了参数 1、2、3、4 的功能。
举例说明：
如果想要将老库升级，需要手动升级，升级步骤如下：
SP_UPDATE_SYSSTATS(99);
或者
SP_UPDATE_SYSSTATS(1);
SP_UPDATE_SYSSTATS(2);
SP_UPDATE_SYSSTATS(3);
SP_UPDATE_SYSSTATS(4);
如果想使用老库，且使用了之前的加列版本服务器且升级失败，那么需要先回退版本，再升级：
SP_UPDATE_SYSSTATS(0);
SP_UPDATE_SYSSTATS(99);
17）SP_TAB_MSTAT_DEINIT
定义：
SP_TAB_MSTAT_DEINIT(
schname varchar(128),
tablename varchar(128)
)
功能说明：
删除一个表的多维统计信息。
参数说明：
schname：模式名。
tablename：表名。
举例说明：
删除表 SYSDBA.L1 上所有的多维统计信息：
SP_TAB_MSTAT_DEINIT('SYSDBA','L1');
18）SF_GET_MD_COL_STR
定义：
SF_GET_MD_COL_STR(
tabid int,
col_info varbinary(4096),
col_num int
)
功能说明：
获取表上建多维统计信息的列信息。
参数说明：
tabid：表 id。
col_info：多维的维度信息。
col_num：维度。
返回值：
多维统计信息的列信息。
举例说明：
获取表 L1 上建的多维统计信息的列信息：
SELECT SF_GET_MD_COL_STR(ID, MCOLID, N_DIMENSION) FROM SYS.SYSMSTATS WHERE ID IN (SELECT ID FROM SYSOBJECTS WHERE NAME='L1');
19）SP_CREATE_AUTO_STAT_TRIGGER
定义：
SP_CREATE_AUTO_STAT_TRIGGER(
type int,
freq_interval int,
freq_sub_interval int,
freq_minute_interval int,
starttime varchar(128),
during_start_date varchar(128),
max_run_duration int,
enable int
)
功能说明：
INI 参数 AUTO_STAT_OBJ 开启时，启用自动收集统计信息功能。
参数说明：
type：指定调度类型。可取值 1、2、3、4、5、6、7、8，缺省为 1，不同取值意义分别介绍如下：
1：按天的频率来执行；
2：按周的频率来执行；
3：在一个月的某一天执行；
4：在一个月的第一周第几天执行；
5：在一个月的第二周的第几天执行；
6：在一个月的第三周的第几天执行；
7：在一个月的第四周的第几天执行；
8：在一个月的最后一周的第几天执行。
freq_interval：与 type 有关，表示不同调度类型下的发生频率，默认为 1。具体说明如下：
当 type=1 时，表示每几天执行，取值范围为 1~100；
当 type=2 时，表示每几个星期执行，取值范围为 1~100；
当 type=3 时，表示每几个月中的某一天执行，取值范围为 1~100；
当 type=4 时，表示每几个月的第一周执行，取值范围为 1~100；
当 type=5 时，表示每几个月的第二周执行，取值范围为 1~100；
当 type=6 时，表示每几个月的第三周执行，取值范围为 1~100；
当 type=7 时，表示每几个月的第四周执行，取值范围为 1~100；
当 type=8 时，表示每几个月的最后一周执行，取值范围为 1~100。
freq_sub_interval：与 type 和 freq_interval 有关，表示不同 type 的执行频率，在 freq_interval 基础上，继续指定更为精准的频率，缺省为 1。具体说明如下：
当 type=1 时，这个值无效，系统不做检查；
当 type=2 时，表示某一个星期的星期几执行，可以同时选中七天中的任意几天，取值范围 1~127。具体可参考如下规则：因为每周有七天，所以 DM 数据库系统内部用七位二进制来表示选中的日子，从最低位开始算起，依次表示周日、周一到周五、周六。选中周几，就将该位置 1，否则置 0。例如，选中周二和周六，7 位二进制就是 1000100，转化成十进制就是 68，所以 FREQ_SUB_INTERVAL 取值 68；
当 type=3 时，表示将在一个月的第几天执行，取值范围 1~31；
当 type 为 4、5、6、7 或 8 时，都表示将在某一周内第几天执行，取值范围 1~7，分别表示从周一到周日。
freq_minute_interval：开始时间后，当天每隔几分钟再次执行，取值范围为 1~1439，缺省为 1439。
starttime：开始时间，缺省为 22:00。
during_start_date：有效日期时间段的开始日期时间，只有当前时间大于该参数值时，该定时器才有效，缺省为 1900/1/1。
max_run_duration：收集统计信息触发器最大执行时间，单位秒，0 表示不限制，缺省为 0。
enable：定时器的操作。0：使触发器无效；1：使触发器有效；2：删除触发器。缺省为 1。
举例说明：
示例请参考《DM8 系统管理员手册》的 22.5 统计信息章节。
20）SYSDBA.GET_AUTO_STAT_INFO_FUNC
定义：
CREATE OR REPLACE PROCEDURE SYSDBA.GET_AUTO_STAT_INFO_FUNC(
task_id INT,
total_stat INT,
table_id INT,
sch_name varchar(24),
table_name varchar(24),
curr_gath_tab_id INT,
curr_gath_sch_name varchar(24),
curr_gath_tab_name varchar(24),
success_stat INT,
fail_stat INT,
task_start_time DATETIME,
task_end_time DATETIME,
gather_tbl_start_time DATETIME,
gather_tbl_end_time DATETIME
) as
BEGIN
/\*用户自定义如何使用统计信息的代码*/
END;
/
功能说明：
支持对自动收集统计信息的过程进行监控。
通过创建确定的过程 SYSDBA.GET_AUTO_STAT_INFO_FUNC，用以接收服务器在自动收集统计信息时的相关信息。该过程的模块体为开放式，用户可以根据自己的需求来编写如何使用统计信息的代码。
参数说明：
task_id： 任务 id，同一个任务的 task_id 相同。
total_stat： 一次任务需要收集的表的总个数。
table_id： 收集完成的一个表 table 的 id，每收集完一个表的统计信息，就会调用一次 SYSDBA.GET_AUTO_STAT_INFO_FUNC，传出一次数据，用户可自定义该过程，自定义处理接收到的数据。
sch_name： 对应 table_id 的模式名。
table_name： 对应 table_id 的表名。
curr_gath_tab_id： 当前正在收集的表 id。收集完一个表 table 后，传出数据时，该字段为接下来要收集的表 id，也是服务器当前正要或正在收集的表。
curr_gath_sch_name： 对应 curr_gath_tab_id 的模式名。
curr_gath_tab_name： 对应 curr_gath_tab_id 的表名。
success_stat： 截止到目前这次收集任务一共成功收集了多少张表。
fail_stat： 截止到目前这次收集任务一共失败收集了多少张表。
task_start_time： 这次任务的开始时间。
task_end_time： 这次任务的结束时间，未结束为 NULL。
gather_tbl_start_time： 收集完一个表 table 时，该表收集的开始时间。
gather_tbl_end_time： 收集完一个表 table 时，该表收集的结束时间，收集失败，则结束时间为 NULL。
举例说明：
示例请参考《DM8 系统管理员手册》的 22.5 统计信息章节。
21）SP_FLUSH_MODIFICATIONS_INFO
定义：
SP_FLUSH_MODIFICATIONS_INFO ()
功能说明：
更新系统表 SYSMODIFICATIONS 中的数据，将内存中表对象的监控信息记录到系统表 SYSMODIFICATIONS 中。
举例说明：
将内存中表对象的监控信息记录到系统表 SYSMODIFICATIONS 中。
SP_FLUSH_MODIFICATIONS_INFO();
22）SP_CLEAN_MODIFICATIONS
定义：
SP_CLEAN_MODIFICATIONS ()
功能说明：
清理系统表 SYSMODIFICATIONS 中的冗余数据，将已经不存在的对象从该系统表中清除。
举例说明：
清除系统表 SYSMODIFICATIONS 中已经不存在的对象：
SP_CLEAN_MODIFICATIONS();
10. 资源监测
1）SP_CHECK_IDLE_MEM
定义：
SP_CHECK_IDLE_MEM ()
功能说明：
对可用内存空间进行检测，并在低于阈值（对应 INI 参数 IDLE_MEM_THRESHOLD）的情况下打印报警记录到日志，同时报内存不足的异常。
举例说明：
监测当前系统的内存空间是否低于阈值：
SP_CHECK_IDLE_MEM ();
2）SP_CHECK_IDLE_DISK
定义：
SP_CHECK_IDLE_DISK (
path varchar(256)
)
功能说明：
对指定位置的磁盘空间进行检测，并在低于阈值（对应 INI 参数 IDLE_DISK_THRESHOLD）的情况下打印报警记录到日志，同时报磁盘空间不足的异常。
参数说明：
path：监测的路径。
举例说明：
监测 d:\data 路径下的磁盘空间是否低于阈值：
SP_CHECK_IDLE_DISK ('d:\data');
3）SF_GET_CMD_RESPONSE_TIME
定义：
SF_GET_CMD_RESPONSE_TIME()
功能说明：
查看 DM 服务器对用户命令的平均响应时间。
返回值：
命令的平均响应时间，单位秒。
举例说明：
在 DM.INI 中 ENABLE_MONITOR=1 的前提下执行：
SELECT SYS.SF_GET_CMD_RESPONSE_TIME();
4）SF_GET_TRX_RESPONSE_TIME
定义：
SF_GET_TRX_RESPONSE_TIME()
功能说明：
查看事务的平均响应时间。
返回值：
事务的平均响应时间，单位秒。
举例说明：
在 DM.INI 中 ENABLE_MONITOR=1 的前提下执行：
SELECT SYS.SF_GET_TRX_RESPONSE_TIME();
5）SF_GET_DATABASE_TIME_PER_SEC
定义：
SF_GET_DATABASE_TIME_PER_SEC()
功能说明：
查看数据库中用户态时间占总处理时间的比值。
返回值：
用户态时间占总处理时间的比值，该比值越大表明用于 IO、事务等待等耗费的时间越少。
举例说明：
在 DM.INI 中 ENABLE_MONITOR=1 的前提下执行：
SELECT SYS.SF_GET_DATABASE_TIME_PER_SEC();
6）TABLE_USED_SPACE
定义：
BIGINT
TABLE_USED_SPACE (
schname varchar(256);
tabname varchar(256)
)
功能说明：
获取指定表所占用的页数。
参数说明：
schname：模式名，必须大写。
tabname：表名，必须大写。
返回值：
表所占用的页数。
举例说明：
查看 SYSOJBECTS 的所占用的页数：
SELECT TABLE_USED_SPACE ('SYS','SYSOBJECTS');
查询结果如下：
32
7）HUGE_TABLE_USED_SPACE
定义：
BIGINT
HUGE_TABLE_USED_SPACE (
schname varchar(256);
tabname varchar(256)
)
功能说明：
获取指定 HUGE 表所占用的大小。
参数说明：
schname：模式名，必须大写。
tabname：huge 表名，必须大写。
返回值：
HUGE 表所占用的大小，单位：MB。
举例说明：
查看 huge 表 test 所占用的大小：
CREATE HUGE TABLE TEST(A INT);
INSERT INTO TEST SELECT LEVEL FROM DUAL CONNECT BY LEVEL <=5000000;
SELECT HUGE_TABLE_USED_SPACE ('SYSDBA','TEST');
查询结果如下：
20
8）USER_USED_SPACE
定义：
BIGINT
USER_USED_SPACE (
username varchar(256)
)
功能说明：
获取指定用户所占用的页数，不包括用户占用的 HUGE 表页数。
参数说明：
username：用户名。
返回值：
用户所占用的页数。
举例说明：
查看 SYSDBA 的所占用的页数：
SELECT USER_USED_SPACE ('SYSDBA');
查询结果如下：
64
9）TS_USED_SPACE
定义：
BIGINT
TS_USED_SPACE (
tsname varchar(256)
）
功能说明：
获取指定表空间所有文件所占用的页数之和。RLOG 和 ROLL 表空间不支持。
参数说明：
tsname：表空间名。
返回值：
表空间占用的页数。
举例说明：
查看 MAIN 表空间所有文件占用的页数之和：
SELECT TS_USED_SPACE ('MAIN');
查询结果如下：
16384
10）DB_USED_SPACE
定义：
BIGINT
DB_USED_SPACE ()
功能说明：
获取整个数据库占用的页数。
返回值：
整个数据库占用的页数。
举例说明：
查看数据库所占用的页数：
SELECT DB_USED_SPACE ();
查询结果如下：
19712
11）INDEX_USED_SPACE
定义 1：
BIGINT
INDEX_USED_SPACE (
indexid int
）
功能说明：
根据索引 ID，获取指定索引所占用的页数。
参数说明：
indexid：索引 ID。
返回值：
索引占用的页数。
举例说明：
查看索引号为 33554540 的索引所占用的页数：
SELECT INDEX_USED_SPACE (33554540);
查询结果如下：
32
定义 2：
BIGINT
INDEX_USED_SPACE (
schname varchar(256),
indexname varchar(256)
）
功能说明：
根据索引名获取指定索引占用的页数。
参数说明：
schname：模式名。
indexname：索引名。
返回值：
索引占用的页数。
举例说明：
查看 SYSDBA 模式下索引名为 INDEX_TEST 的索引占用的页数：
SELECT INDEX_USED_SPACE ('SYSDBA', 'INDEX_TEST');
查询结果如下：
14
定义 3：
BIGINT
INDEX_USED_SPACE (
schname varchar(256),
tablename varchar(256),
nth_index int
）
功能说明：
获取表指定序号的索引占用的页数。
参数说明：
schname：模式名。
tablename：表名。
nth_index：要获取表的第几个索引。
返回值：
索引占用的页数。
举例说明：
查看 SYSDBA 模式下，TEST 表的第二个索引占用的页数：
SELECT INDEX_USED_SPACE ('SYSDBA', 'TEST', 2);
查询结果如下：
14
12）INDEX_USED_PAGES
定义 1：
BIGINT
INDEX_USED_PAGES (
indexid int
）
功能说明：
根据索引 id，获取指定索引已使用的页数，为估算值。
参数说明：
indexid：索引 ID。
返回值：
索引已使用的页数。
举例说明：
查看索引号为 33554540 的索引已使用的页数：
SELECT INDEX_USED_PAGES (33554540);
查询结果如下：
14
定义 2：
BIGINT
INDEX_USED_PAGES (
schema_name varchar(128),
index_name varchar(128)
)
功能说明：
根据模式下的索引名获取指定索引已使用的页数，为估算值。
参数说明：
schema_name：模式名。
index_name：索引名。
返回值：
指定索引已使用的页数。
举例说明：
查看模式 SYSDBA 下索引名为 IDX1 的索引已使用的页数：
SELECT INDEX_USED_PAGES('SYSDBA','IDX1');
查询结果如下：
2
定义 3：
BIGINT
INDEX_USED_PAGES (
schema_name varchar(128),
table_name varchar(128),
index_no int
)
功能说明：
根据模式下的指定表的第 index_no 个索引获取该索引使用的页数，为估算值。
参数说明：
schema_name：模式名。
table_name：表名。
index_no：索引序号(从 1 开始)。
返回值：
指定索引已使用的页数。
举例说明：
查看模式 SYSDBA 下表名为 TAB1 的第一个索引已使用的页数：
SELECT INDEX_USED_PAGES('SYSDBA','TAB1',1);
13）TABLE_USED_PAGES
定义：
BIGINT
TABLE_USED_PAGES (
schname varchar(256);
tabname varchar(256)
)
功能说明：
获取指定表已使用的页数，为估算值。
参数说明：
schname：模式名。
tabname：表名。
返回值：
表已使用的页数。
举例说明：
查看 SYSOJBECTS 已使用的页数：
SELECT TABLE_USED_PAGES('SYS','SYSOBJECTS');
查询结果如下：
14
14）TS_FREE_SPACE
定义：
INT
TS_FREE_SPACE (
tsname varchar(256)
）
功能说明：
获取指定表空间可分配的空闲页数。RLOG 和 ROLL 表空间不支持。
参数说明：
tsname：表空间名。
返回值：
表空间可分配的空闲页数，包含 TS_RESERVED_SPACE()的预留页数。
举例说明：
查看 MAIN 表空间可分配的空闲页数：
SELECT TS_FREE_SPACE ('MAIN');
查询结果如下：
8192
15）TS_RESERVED_SPACE
定义：
INT
TS_RESERVED_SPACE (
tsname varchar(256)
）
功能说明：
获取指定表空间系统预留的页数。RLOG 和 ROLL 表空间不支持。系统启动时根据 dm.ini 参数 TS_RESERVED_EXTENTS 预留部分空间，避免 ROLLBACK/PURGE 等操作过程中分配数据页失败，这些预留空间用户无法使用。
参数说明：
tsname：表空间名。
返回值：
表空间系统预留的页数。
举例说明：
查看 MAIN 表空间系统预留的页数：
SELECT TS_RESERVED_SPACE ('MAIN');
查询结果如下：
512
16）TS_FREE_SPACE_CALC
定义：
INT
TS_FREE_SPACE_CALC (
tsname varchar(256)
）
功能说明：
重新计算指定表空间可分配的空闲页数。RLOG 和 ROLL 表空间不支持。
参数说明：
tsname：表空间名。
返回值：
表空间可分配的空闲页数，包含 TS_RESERVED_SPACE 的预留页数。
举例说明：
重新计算 MAIN 表空间可分配的空闲页数：
SELECT TS_FREE_SPACE_CALC('MAIN');
查询结果如下：
8192
17）TABLE_USED_LOB_PAGES
定义：
BIGINT
TABLE_USED_LOB_PAGES (
schname varchar(256);
tabname varchar(256)
)
功能说明：
获取指定表已使用的 lob 页数，包括大字段列使用的行外数据 lob 页和指定了 USING LONG ROW 存储选项时变长字符串列使用的行外数据 lob 页。返回值为估算值。
参数说明：
schname：模式名。
tabname：表名。
返回值：
表已使用的 lob 页数。
举例说明：
查看 SYS.SYSTEXTS 表已使用的 lob 页数：
SELECT TABLE_USED_LOB_PAGES('SYS','SYSTEXTS');
查询结果如下：
139
18）TABLE_FREE_LOB_PAGES
定义：
BIGINT
TABLE_FREE_LOB_PAGES(
schema_name in varchar,
table_name in varchar
)
功能说明：
获取指定表的大字段的段首页登记的空闲页个数。
参数说明：
schema_name：表所在模式名。
table_name：表名。
返回值：
失败则报错，成功返回空闲页个数。
举例说明：
查询 T_CLOB 表的大字段的段首页登记的空闲页个数：
SELECT TABLE_FREE_LOB_PAGES('SYSDBA','T_CLOB');
19）SP_TABLE_LOB_RECLAIM
定义：
SP_TABLE_LOB_RECLAIM(
schema_name in varchar,
table_name in varchar
)
功能说明：
清理指定表的大字段的段首页登记的空闲页。
参数说明：
schema_name：表所在模式名。
table_name：表名。
返回值：
无。失败则报错。
举例说明：
清理表 T_CLOB 的大字段的段首页登记的空闲页：
SP_TABLE_LOB_RECLAIM('SYSDBA','T_CLOB');
20）SP_SET_SQL_STAT_THRESHOLD
定义：
SP_SET_SQL_STAT_THRESHOLD(
name varchar,
val int64)
功能说明：
设置语句级资源监控，SQL 监控项生成的条件阈值，当资源大于设置的阈值时才生成统计项。可以设置的监控项为 V$SQL_STAT/V$SQL_STAT_HISTORY 视图中的 5~62、64 和 66 列。该过程只有 DBA 权限才能执行。
参数说明：
name：允许为 NULL。需要设置阈值的监控项名字，可选名字为 V$SQL_STAT/V$SQL_STAT_HISTORY 视图中第 5~62、64 和 66 列的列名。当 name 为 NULL 时，val 只能设置为 0 或者-1。0 表示无条件生成历史监控项，-1 表示不生成历史监控项。
val：不允许为 NULL 且必须大于等于 0。表示需要设置的阈值。
返回值：
无
举例说明：
SP_SET_SQL_STAT_THRESHOLD('INS_IN_PL_CNT', 60000);
21）TABLE_ROWCOUNT
定义：
INT
TABLE_ROWCOUNT (
schema_name varchar(128),
table_name varchar(128)
)
功能说明：
获取指定模式下指定表的总行数。
参数说明：
schema_name：模式名。
table_name：表名。
返回值：
指定表的总行数。
举例说明：
查看模式 SYSDBA 下表 TAB1 的总行数：
SELECT TABLE_ROWCOUNT('SYSDBA','TAB1');
- TABLE_FREE_PAGE_STACK_USED_SPACE
定义：
BIGINT
TABLE_FREE_PAGE_STACK_USED_SPACE (
schname varchar(256)，
tabname varchar(256)
)
功能说明：
获取指定模式下指定表的B树空闲页堆栈所占用的页数。
参数说明：
schname：模式名，必须大写。
tabname：表名，必须大写。
返回值：
指定表的B树空闲页堆栈所占用的页数。
举例说明：
将 dm.ini 中 BTR_FREE_PAGE_STACK 设为 1，开启空闲页堆栈，查看表 test 空闲页堆栈所占用的页数。
CREATE TABLE TEST(A INT);
INSERT INTO TEST SELECT LEVEL FROM DUAL CONNECT BY LEVEL <= 10000;
SELECT TABLE_FREE_PAGE_STACK_USED_SPACE('SYSDBA', 'TEST');
11. 类型别名
DM 支持用户对各种基础数据类型定义类型别名，定义的别名可以在 SQL 语句和 DMSQL 程序中使用。
1）SP_INIT_DTYPE_SYS
定义：
SP_INIT_DTYPE_SYS (
create_flag int
)SELECT SF_CHECK_SYSTEM_PACKAGES
功能说明：
初始化或清除类型别名运行环境。
参数说明：
create_flag：1 表示创建，0 表示删除。
返回值：
无
举例说明：
初始化类型别名运行环境：
SP_INIT_DTYPE_SYS(1);
2）SF_CHECK_DTYPE_SYS
定义：
INT
SF_CHECK_DTYPE_SYS ()
功能说明：
系统类型别名系统的启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得系统类型别名系统的启用状态：
SELECT SF_CHECK_DTYPE_SYS;
3）SP_DTYPE_CREATE
定义：
SP_DTYPE_CREATE (
name varchar(32),
base_name varchar(32),
len int,
scale int
)
功能说明：
创建一个类型别名。最多只能创建 100 个类型别名。仅 DBA 有权限调用此过程。
参数说明：
name：类型别名的名称。
base_name：基础数据类型名。
len：基础数据类型长度，当为固定精度类型时，应该设置为 NULL。
scale：基础数据类型刻度。当基础数据类型为 CHAR/VARCHAR 时，若指定为 1，则表示字符长度；否则忽略，表示字节长度。
返回值：
无
举例说明：
创建 VARCHAR(100)的类型别名‘STR’：
SP_DTYPE_CREATE('STR', 'VARCHAR', 100, NULL);
4）SP_DTYPE_DELETE
定义：
SP_DTYPE_DELETE (
name varchar(32)
)
功能说明：
删除一个类型别名。仅 DBA 有权限调用此过程。
参数说明：
name：类型别名的名称。
返回值：
无
举例说明：
删除类型别名‘STR’：
SP_DTYPE_DELETE('STR');
12. 杂类函数/过程
1）TO_DATETIME
定义：
DATETIME
TO_DATETIME(
year int,
month int,
day int,
hour int,
minute int
）
功能说明：
将 int 类型值组合并转换成日期时间类型。
参数说明：
year：年份，必须介于-4713 和 +9999 之间，且不为 0。
month：月份。
day：日。
hour：小时。
minute：分钟。
返回值：
日期时间值。
举例说明：
将整型数 2010，2，2，5，5 转换成日期时间类型：
SELECT TO_DATETIME (2010,2,2,5,5);
查询结果如下：
2010-02-02 05:05:00.000000
2）SP_SET_ROLE*****
定义：
SP_SET_ROLE (
role_name varchar(128),
enable int
)
功能说明：
设置角色启用禁用。
参数说明：
role_name: 角色名。
enable：0/1 (0：禁用 1：启用)。
返回值：
无
举例说明：
禁用角色 ROLE1：
SP_SET_ROLE ( 'ROLE1', 0);
3）SF_CHECK_SYSTEM_VIEWS
定义：
INT
SF_CHECK_SYSTEM_VIEWS()
功能说明：
系统视图的启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得系统视图的启用状态：
SELECT SF_CHECK_SYSTEM_VIEWS;
4）SP_DYNAMIC_VIEW_DATA_CLEAR
定义：
SP_DYNAMIC_VIEW_DATA_CLEAR (
view_name varchar(128)
)
功能说明：
清空动态性能视图的历史数据，仅对存放历史记录的动态视图起作用。
参数说明：
view_name：动态性能视图名。
返回值：
无
举例说明：
清空动态性能视图 V$SQL_HISTORY 的历史数据：
SP_DYNAMIC_VIEW_DATA_CLEAR('V$SQL_HISTORY');
5）SP_INIT_INFOSCH
定义：
SP_INIT_INFOSCH (
create_flag int
)
功能说明：
创建或删除信息模式。
参数说明：
create_flag：为 1 时表示创建信息模式；为 0 表示删除信息模式。
举例说明：
创建信息模式：
SP_INIT_INFOSCH (1);
6）SF_CHECK_INFOSCH
定义：
INT
SF_CHECK_INFOSCH ()
功能说明：
系统的信息模式启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得系统信息模式的启用状态：
SELECT SF_CHECK_INFOSCH;
7）SP_INIT_CPT_SYS
定义：
int
SP_INIT_CPT_SYS (
flag int
)
功能说明：
初始化数据捕获环境。
参数说明：
flag： 1 表示初始化环境；0 表示删除环境。
举例说明：
初始化数据捕获环境：
SP_INIT_CPT_SYS(1);
8）SF_CHECK_CPT_SYS
定义：
INT
SF_CHECK_CPT_SYS ()
功能说明：
系统的数据捕获环境启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得系统数据捕获环境的启用状态：
SELECT SF_CHECK_CPT_SYS;
9）SF_SI
定义：
VARCHAR
SF_SI(
index_sql varchar
)
功能说明：
输入索引创建语句或索引重建语句，查看预计的执行信息。
参数说明：
INDEX_SQL： 指定的索引创建语句。
返回值：
索引创建的统计信息，排序区大小的建议值。
举例说明：
--输入索引创建语句
SELECT SF_SI('CREATE INDEX idx_t1 ON t1(c1,c2);');
--输入索引重建语句
SELECT SF_SI('ALTER INDEX idx_t1 REBUILD ONLINE;');
--索引重建语句支持系统过程
SELECT SF_SI('SP_REBUILD_INDEX(''SYSDBA'', 33555473);');
10）SP_UNLOCK_USER
语法：
SP_UNLOCK_USER(
user_name varchar(128) not null
)
参数说明：
user_name：需要解锁的用户名。
功能说明：
为指定的用户解锁。
举例说明：
CREATE USER USER123 IDENTIFIED BY DMsys_123456;
//错误登录3次，导致用户被锁
SQL>LOGIN
服务名:
用户名:USER123
密码:
SSL路径:
SSL密码:
UKEY名称:
UKEY PIN码:
MPP类型:
是否读写分离(y/n):
协议类型:
[-2501]:用户名或密码错误.
//解锁
//SYSDBA用户登录：
SP_UNLOCK_USER('USER123');
11）DUMP 函数
定义：
VARCHAR
DUMP（
exp int/bigint/dec/double/float/varbinary/ varchar/date/time/datetime/time with time zone/timestamp with time zone/interval year/interval day/blob/clob/rowid,
fmt int,
start int,
len int
）
功能说明：
获得表达式的内部存储字节。
参数说明：
exp：输入参数，必选。可以是任何基本数据类型。
fmt：输出格式进制，可选，缺省为 10。8：以八进制的形式返回结果集；10：以十进制的形式返回结果集；16：以十六进制的形式返回结果集；17：以字符的形式返回结果集；1000+N: 以上四种加上 1000，表示在返回值中加上当前字符集名称，N 为 8、10、16 或 17。
start：开始进行返回的字节的位置。可选。
len：需要返回的字节长度。可选。
返回值：
依次是数据类型代码、字节长度、表达式在系统内部存储字节。其中，数据类型代码有：2 代表 VARCHAR、7 代表 INT、8 代表 BIGINT、9 代表 DEC、10 代表 FLOAT、11 代表 DOUBLE、12 代表 BLOB、14 代表 DATE、15 代表 TIME、16 代表 DATETIME、18 代表 VARBINARY、19 代表 CLOB、20 代表 INTERVAL YEAR MONTH、21 代表 INTERVAL DAY TIME、22 代表 TIME WITH TIME ZONE、23 代表 TIMESTAMP WITH TIME ZONE、28 代表 ROWID。
举例说明：
例 1 查询字符串’an’的存储字节，显示字符集，显示成字符：
select dump('an',1017);
查询结果如下：
Typ=2 Len=2 CharacterSet=GBK: a,n
例 2 查询日期类型'2005-01-01'的默认字节，默认进制显示：
select dump(date '2005-01-01' ) ;
查询结果如下：
Typ=14 Len=13: 213,7,1,1,0,0,0,0,0,0,232,3,0
例 3 查询数字 1234567890 的从第 2 个字节开始的 4 个字节，以 16 进制显示：
select dump(1234567890,16,2,4);
查询结果如下：
Typ=7 Len=4: 2,96,49
例 4 查询 clob 类型的默认字节，默认进制显示。
create table testdump(c1 clob);
insert into testdump values('adbca');
insert into testdump values('1.曹雪芹，是中国文学史上最伟大也是最复杂的作家，《红楼梦》也是中国文学史上最伟大而又最复杂的作品。《红楼梦》写的是封建贵族的青年贾宝玉、林黛玉、薛宝钗之间的恋爱和婚姻悲剧，而且以此为中心，写出了当时具有代表性的贾、王、史、薛四大家族的兴衰，其中又以贾府为中心，揭露了封建社会后期的种种黑暗和罪恶，及其不可克服的内在矛盾，对腐朽的封建统治阶级和行将崩溃的封建制度作了有力的批判，使读者预感到它必然要走向覆灭的命运。本书是一部具有高度思想性和高度艺术性的伟大作品，从本书反映的思想倾向来看，作者具有初步的民主主义思想，他对现实社会包括宫廷及官场的黑暗，封建贵族阶级及其家庭的腐朽，封建的科举制度、婚姻制度、奴婢制度、等级制度，以及与此相适应的社会统治思想即孔孟之道和程朱理学、社会道德观念等等，都进行了深刻的批判并且提出了朦胧的带有初步民主主义性质的理想和主张。这些理想和主张正是当时正在滋长的资本主义经济萌芽因素的曲折反映。2.曹雪芹，是中国文学史上最伟大也是最复杂的作家，《红楼梦》也是中国文学史上最伟大而又最复杂的作品。《红楼梦》写的是封建贵族的青年贾宝玉、林黛玉、薛宝钗之间的恋爱和婚姻悲剧，而且以此为中心，写出了当时具有代表性的贾、王、史、薛四大家族的兴衰，其中又以贾府为中心，揭露了封建社会后期的种种黑暗和罪恶，及其不可克服的内在矛盾，对腐朽的封建统治阶级和行将崩溃的封建制度作了有力的批判，使读者预感到它必然要走向覆灭的命运。本书是一部具有高度思想性和高度艺术性的伟大作品，从本书反映的思想倾向来看，作者具有初步的民主主义思想，他对现实社会包括宫廷及官场的黑暗，封建贵族阶级及其家庭的腐朽，封建的科举制度、婚姻制度、奴婢制度、等级制度，以及与此相适应的社会统治思想即孔孟之道和程朱理学、社会道德观念等等，都进行了深刻的批判并且提出了朦胧的带有初步民主主义性质的理想和主张。这些理想和主张正是当时正在滋长的资本主义经济萌芽因素的曲折反映。');
select dump(c1) from testdump;
查询结果如下：
DUMP(C1)
--------------------------------------------------------------------------------------------------------------------------------
Typ=19 Len=52: 1,104,2,0,0,0,0,0,0,5,0,0,0,0,0,0,0,0,0,0,0,146,4,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,97,100,98,99,97
Typ=19 Len=47: 2,105,2,0,0,0,0,0,0,108,6,0,0,4,0,0,0,86,0,0,0,146,4,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0
例 5 查询 ROWID 类型数据内部存储字节。
select DUMP(cast('AAACAAAAAAAAAAAAAC'AS ROWID));
查询结果如下：
DUMP(CAST('AAACAAAAAAAAAAAAAC'ASROWID))
---------------------------------------
Typ=28 Len=12: 0,2,0,0,0,0,0,0,0,0,0,2
12）SP_CLOSE_DBLINK
定义：
SP_CLOSE_DBLINK(
dblink varchar(128)
)
功能说明：
关闭系统缓冲区中指定的空闲的外部链接，若指定的外部链接不处于空闲状态（可通过 V$DBLINK 查询），则不关闭。
参数说明：
dblink ：指定的待关闭的外部链接名。
返回值：
无
举例说明：
关闭之前创建的外部链接 LINK1：
SP_CLOSE_DBLINK('LINK1');
13）SP_XA_TRX_PROCESS
定义：
SP_XA_TRX_PROCESS(
trxid bigint,
flag boolean
)
功能说明：
指定提交或回滚 TRXID 对应的 XA TRX。指定的 TRXID 对应的 TRX 必须是 XA TRX，且已经通过接口执行过 xa_end 或 xa_prepare 操作，否则报错。
TRXID 可通过 V$TRX 中的 ID 查询。
参数说明：
trxid：事务的 ID 号。
flag：false 表示回滚，true 表示提交。
返回值：
无
14）GETUTCDATE
定义：
DATETIME
GETUTCDATE ()
功能说明：
获取当前 UTC 时间。
返回值：
当前 UTC 时间。
举例说明：
获取当前 UTC 时间：
SELECT GETUTCDATE();
15）SLEEP
定义：
SLEEP(time dec)
功能说明：
表示让一个线程进入睡眠状态，等待一段时间 time 之后，该线程自动醒来进入到可运行状态。
参数说明：
time：睡眠时间，单位秒。
返回值：
无
举例说明：
让一个线程睡眠 1 秒钟之后，再醒过来继续运行：
sleep(1);
16）SF_GET_TRIG_EP_SEQ
定义：
INT
SF_GET_TRIG_EP_SEQ(id int)
功能说明：
获取 DMDSC 环境下时间触发器执行节点号。
参数说明：
id：时间触发器 id。
返回值：
执行节点号。
举例说明：
SELECT SF_GET_TRIG_EP_SEQ(117440523);
17）SF_EXTRACT_BIND_DATA
定义：
VARCHAR
SF_EXTRACT_BIND_DATA(
binddata varbinary,
nth integer,
attr integer
)
功能说明：
获取绑定参数的信息。
参数说明：
binddata：绑定的参数数据。
nth：指定参数序号，从 1 开始以 1 为单位递增。
attr：为 1 时表示获取参数类型，对于小数类型，不显示精度和标度；为 2 时表示获取参数内容。
返回值：
指定参数的参数类型或参数内容。若 binddata 为 NULL 或空值，则返回 NULL；若 nth 大于实际绑定的参数个数且小于等于绑定语句中的参数个数，则返回字符串“NO DATA”；若 nth<=0 或大于绑定语句中的参数个数，则报错；若 attr 不为 1 或 2，则报错。
举例说明：
获取执行号为 1701 的绑定语句中绑定的第 3 个参数的参数类型和参数内容：
SELECT SF_EXTRACT_BIND_DATA(BINDDATA, 3, 1), SF_EXTRACT_BIND_DATA(BINDDATA, 3, 2) FROM V$SQL_BINDDATA_HISTORY WHERE EXEC_ID=1701;
查询结果如下：
DEC 123456789.123
18）SF_EXTRACT_BIND_DATA_NUM
定义：
INT
SF_EXTRACT_BIND_DATA_NUM(
binddata varbinary,
num int
)
功能说明：
获取绑定参数的个数。
参数说明：
binddata：绑定的参数数据。
num：为 1 时表示获取实际绑定的参数个数；为 2 时表示获取绑定语句中的参数个数。
返回值：
参数个数。
举例说明：
获取执行号为 1701 的绑定语句实际绑定的参数个数：
SELECT SF_EXTRACT_BIND_DATA_NUM(BINDDATA, 1) FROM V$SQL_BINDDATA_HISTORY WHERE EXEC_ID=1701;
查询结果如下：
17
19）SP_CREATE_SYS_OBJTYPE
定义：
SP_CREATE_SYS_OBJTYPE(
create_flag int
)
功能说明：
创建或删除内置对象(ODCI 相关)。
需要注意的是，由于新旧版本系统初始化时对某些 ODCI 相关系统类型有不同的处理，可能对该函数有不同的使用需求。
V8.1.3.97 到 V8.1.4.65 之间的版本系统初始化的时候默认存在 odcinumberlist 系统类型，表现为动态数组，最大容量为 20。此时执行 SP_CREATE_SYS_OBJTYPE(1)重建 ODCI 相关的全局系统类型，重建后 odcinumberlist 表现为嵌套表。v8.1.4.65 及其之后的版本系统初始化不存在 odci 相关系统类型，如果用到了 ODCI 相关数据类型需要先手动执行 SP_CREATE_SYS_OBJTYPE(1)，创建后 ODCINUMBERLIST 表现为嵌套表。
重建 ODCI 系统类型时，如果已经基于动态数组的 odcinumberlist 创建了表，需要先执行 SP_CREATE_SYS_OBJTYPE(0)级联删除 ODCI 相关系统类型以及关联的表，再执行 SP_CREATE_SYS_OBJTYPE(1)进行重建
参数说明：
create_flag：1 表示创建，0 表示删除。
返回值：
无
举例说明：
创建内置对象：
SP_CREATE_SYS_OBJTYPE(1);
20）SP_SET_PLN_BINDED
定义：
SP_SET_PLN_BINDED(
sql_text varchar(32767),
schname varchar(128),
type varchar(12),
binded int
)
或者
SP_SET_PLN_BINDED(
hash_value int,
schid int,
type varchar(12),
binded int
)
或者
SP_SET_PLN_BINDED(
sql_text varchar(32767),
schid int,
type varchar(12),
binded int
)
或者
SP_SET_PLN_BINDED(
hash_value int,
schname varchar(128),
type varchar(12),
binded int
)
功能说明：
绑定或解绑指定的执行计划。
参数说明：
sql_text：执行计划对应的 SQL 语句，该语句可以从动态视图 V$SQL_PLAN 中的 SQLSTR 列获得。
schname：执行计划的模式名。
type：执行计划的类型，可取值：SQL：查询语句类型；PL/OBJ：存储过程或触发器类型。
binded：是否绑定执行计划，可取值：0、1、2。0：解除内存中绑定；1：内存中绑定；2：持久化绑定。解除持久化绑定可以通过系统过程函数 SP_REMOVE_STORE_PLN 完成。对于长度超过 1000 字节的 SQL 语句建议使用内存中绑定。由于持久化绑定只保存 SQL 语句的前 1000 字节，通过执行计划哈希值以及前 1000 字节字符共同校验以查找计划，故可能存在 SQL 语句不同但哈希值相同的情况，导致查找到错误的计划。
hash_value：执行计划的哈希值，其值可以从动态视图 V$SQL_PLAN 中的 HASH_VALUE 列获得。
schid：执行计划的模式 ID。
返回值：
无
举例说明：
绑定 SQL 语句“SELECT * FROM T1”对应的执行计划：
SP_SET_PLN_BINDED('SELECT * FROM T1;', 'SYSDBA', 'SQL', 1);
21）SP_SET_PLN_DISABLED
定义：
SP_SET_PLN_DISABLED(
pln_id bigint,
disabled int
)
功能说明：
设置绑定执行计划为禁用或启用。
参数说明：
pln_id：绑定执行计划 ID，对应于系统表 SYSPLNINFO 的 PLN_ID 列。系统表 SYSPLNINFO 请参考《DM8 系统管理员手册》中的附录 1。
disabled：是否禁用执行计划。取值为 0、1。0 表示启用；1 表示禁用。
返回值：
无
举例说明：
禁用系统表 SYSPLNINFO 中 PLN_ID 为 1 的执行计划：
SP_SET_PLN_DISABLED(1, 1);
22）SF_GET_PLN_VERSION
定义：
SF_GET_PLN_VERSION(
type int
)
功能说明：
获取执行计划指定类型的版本号。
参数说明：
type：版本号类型。取值为0、1、2。0表示操作符版本号；1表示指令版本号；2表示格式版本号。
返回值：
执行计划指定类型的版本号。
举例说明：
获取执行计划的操作符版本号：
SELECT SF_GET_PLN_VERSION(0);
23）SP_REMOVE_STORE_PLN
定义：
SP_REMOVE_STORE_PLN(
pln_id bigint
)
功能说明：
移除持久化绑定的执行计划。
参数说明：
pln_id：绑定执行计划 ID，对应于系统表 SYSPLNINFO 的 PLN_ID 列。系统表 SYSPLNINFO 请参考《DM8 系统管理员手册》中的附录 1。
返回值：
无
举例说明：
移除系统表 SYSPLNINFO 中 PLN_ID 为 1 的执行计划：
SP_REMOVE_STORE_PLN(1);
24）$$PLSQL_UNIT
定义：
$$PLSQL_UNIT
功能说明：
获取当前方法所在 DMSQL 程序名称。其中，语句块因为无名称所以不显示。
返回值：
DMSQL 程序名称。
举例说明：
使用$$PLSQL_UNIT 获取当前方法所在的 DMSQL 程序名称。
create or replace package test_dm
is
procedure test_plsql_prc;
function test_plsql_fnc return varchar;
end test_dm;
create or replace package body test_dm is
procedure test_plsql_prc IS
i pls_integer;
begin
DBMS_OUTPUT.PUT_LINE('Inside test_plsql_prc');
i := $$PLSQL_LINE;
DBMS_OUTPUT.PUT_LINE('i = ' || i);
DBMS_OUTPUT.PUT_LINE('$$PLSQL_LINE = ' || $$PLSQL_LINE);
DBMS_OUTPUT.PUT_LINE('$$PLSQL_UNIT = ' || $$PLSQL_UNIT);
end test_plsql_prc;
function test_plsql_fnc return varchar
IS
j pls_integer;
res varchar(100);
begin
DBMS_OUTPUT.PUT_LINE('Inside test_plsql_fnc');
j := $$PLSQL_LINE;
res := $$PLSQL_UNIT;
DBMS_OUTPUT.PUT_LINE('j = ' || j);
DBMS_OUTPUT.PUT_LINE('$$PLSQL_LINE = ' || $$PLSQL_LINE);
DBMS_OUTPUT.PUT_LINE('$$PLSQL_UNIT = ' || $$PLSQL_UNIT);
return (res);
end test_plsql_fnc;
end test_dm;
declare
res varchar(100);
begin
res := test_dm.test_plsql_fnc;
DBMS_OUTPUT.PUT_LINE('$$PLSQL_UNIT2 = ' || res);
end;
打印结果如下：
Inside test_plsql_fnc
j = 17
$$PLSQL_LINE = 20
$$PLSQL_UNIT = TEST_DM
$$PLSQL_UNIT2 = TEST_DM
25）$$PLSQL_LINE
定义：
$$PLSQL_LINE
功能说明：
获取当前方法在 DMSQL 程序中的行号。
返回值：
行号。
举例说明：
使用$$PLSQL_LINE 获取当前方法在 DMSQL 程序中的行号。
CREATE OR REPLACE PROCEDURE p
IS
i pls_integer;
c varchar(100);
BEGIN
DBMS_OUTPUT.PUT_LINE('Inside p');
i := $$PLSQL_LINE;
DBMS_OUTPUT.PUT_LINE('i = ' || i);
DBMS_OUTPUT.PUT_LINE('$$PLSQL_LINE = ' || $$PLSQL_LINE);
DBMS_OUTPUT.PUT_LINE('$$PLSQL_UNIT = ' || $$PLSQL_UNIT);
END;
BEGIN
DBMS_OUTPUT.PUT_LINE('当前块中的信息：');
DBMS_OUTPUT.PUT_LINE($$PLSQL_LINE);
DBMS_OUTPUT.PUT_LINE('$$PLSQL_LINE = ' || $$PLSQL_LINE);
DBMS_OUTPUT.PUT_LINE('P中的信息：');
p;
END;
打印结果如下：
当前块中的信息：
3
$$PLSQL_LINE = 4
P中的信息：
Inside p
i = 7
$$PLSQL_LINE = 9
$$PLSQL_UNIT = P
26）SP_SESSION_BT
定义：
SP_SESSION_BT (
session_id bigint
)
功能说明：
打开 INI 监控参数 ENABLE_MONITOR=1、MONITOR_SQL_EXEC=1，SP_SESSION_BT()才有效。
通过指定会话 ID，查询该会话虚拟机当前执行的堆栈信息。如果输入的会话处于空闲状态，则本过程不输出信息。例如：当会话 X 执行了一个复杂存储过程，长时间没有结束，此时 DBA 可在另一个活动的会话 Y 中执行 SP_SESSION_BT(X 会话 ID)，来查询会话 X 中的长耗过程的信息（过程名、代码行及对应的 SQL 文本片段等），便于诊断性能问题。
参数说明：
session_id：指定的会话 ID。
返回值：
无
举例说明：
准备数据：
CREATE TABLE TEST1(ID INT);
CREATE TABLE TEST2(ID INT);
INSERT INTO TEST1 SELECT LEVEL FROM DUAL CONNECT BY LEVEL <=20000;
INSERT INTO TEST2 SELECT LEVEL FROM DUAL CONNECT BY LEVEL <=20000;
COMMIT;
--创建系统过程PROC_1
CREATE OR REPLACE PROCEDURE PROC_1() AS
V_SQL VARCHAR2(2000);
BEGIN
V_SQL := 'SELECT /*+USE_NL(A,B)*/ COUNT(*) FROM TEST1 A, TEST2 B WHERE A.ID=B.ID';
EXECUTE IMMEDIATE V_SQL;
END;
/
--开启ENABLE_MONITOR和MONITOR_SQL_EXEC参数
SP_SET_PARA_VALUE(1,'ENABLE_MONITOR',1);
SP_SET_PARA_VALUE(1,'MONITOR_SQL_EXEC',1);
开启两个会话，会话 1 和会话 2。
在会话 1 中获取会话 ID，然后执行系统过程 PROC_1。
SQL> SELECT SESSID();
行号 SESSID()
---------- --------------------
1 139918747748408
SQL> CALL PROC_1();
在会话 1 执行 PROC_1 期间，在会话 2 中调用 SP_SESSION_BT，查询会话 1 当前堆栈信息，包括当前执行的过程名、代码行、SQL 文本和 sql_id 等信息。
SQL> SP_SESSION_BT(139918747748408);
行号 METHOD_NAME LINE_NO CMD
---------- -------------- ----------- -------------------------------------
1 0x7f40f9260688 1 select /*+use_nl(A,B)*/ count(*) from test1 A, test2 B Where A.ID=B.ID
2 SYSDBA.PROC_1 5 EXEC IMMEDIATE, pln:cd40afa8 sql_id:1376
3 $$TOP_METHOD 1
对于具体的执行计划，可以通过 sql_id 查询 V$PLN_HISTORY 视图来获取。
SQL> SELECT * FROM V$PLN_HISTORY WHERE SQL_ID = 1376;
行号 SQL_ID TOP_SQL_TEXT SQL_PLAN
---------- ----------- ---------- ----------------------------------
1 1376 select /*+use_nl(A,B)*/ count(*) from test1 A, test2 B Where A.ID=B.ID
1 #NSET2: [667883600, 1, 8]
2 #PRJT2: [667883600, 1, 8]; exp_num(1), is_atom(FALSE)
3 #AAGR2: [667883600, 1, 8]; grp_num(0), sfun_num(1), distinct_flag[0]; slave_empty(0)
4 #SLCT2: [667883600, 3920399, 8]; A.ID = B.ID
5 #NEST LOOP INNER JOIN2: [667883600, 3920399, 8];
6 #CSCN2: [2, 20000, 4]; INDEX33555464(TEST1 as A)
7 #CSCN2: [2, 20000, 4]; INDEX33555465(TEST2 as B)
若会话 1 中 PROC_1 过程执行结束，则在会话 2 上调用 SP_SESSION_BT 查询会话 1 的堆栈信息时不会输出任何信息。
SQL> SP_SESSION_BT(139918747748408);
DMSQL 过程已成功完成
27）SF_WHO_CALLED_ME
定义：
SF_WHO_CALLED_ME(
owner_name varchar2,
caller_name varchar2,
line_num number,
caller_type varchar2
)
功能说明：
获取上层语句块对当前语句块的调用信息。
参数说明：
owner_name：输出参数，上层语句块所属模式名。
caller_name：输出参数，上层语句块的过程名或函数名。
line_num：输出参数，上层语句块调用当前语句块的行号。
caller_type：输出参数，上层语句块类型，取值包括：ANONYMOUS BLOCK：匿名块；PROCEDURE：过程；FUNCTION：函数。当上层语句块非过程或函数时，语句块类型为 ANONYMOUS BLOCK，此时参数 owner_name 和 caller_name 均为空串。
返回值：
无
举例说明：
创建过程 CHILD_PROC 和 PARENT_PROC，PARENT_PROC 调用 CHILD_PROC，使用系统函数 SF_WHO_CALLED_ME 获取 PARENT_PROC 对 CHILD_PROC 的调用信息。
//创建过程CHILD_PROC
CREATE OR REPLACE PROCEDURE CHILD_PROC(ID NUMBER)
AS
OWNER_NAME VARCHAR2(100);
CALLER_NAME VARCHAR2(100);
LINE_NUMBER NUMBER;
CALLER_TYPE VARCHAR2(100);
BEGIN
SF_WHO_CALLED_ME(OWNER_NAME, CALLER_NAME, LINE_NUMBER, CALLER_TYPE);
DBMS_OUTPUT.PUT_LINE('[ID:] ' || ID || ' [CALLER_TYPE:] ' || CALLER_TYPE || ' [OWNER_NAME:] ' || OWNER_NAME || ' [CALLER_NAME:] ' || CALLER_NAME || ' [LINE_NUMBER:] ' || LINE_NUMBER);
END;
/
//创建过程PARENT_PROC
CREATE OR REPLACE PROCEDURE PARENT_PROC
AS
V_CHILD_PROC VARCHAR2(100) := 'BEGIN SYSDBA.CHILD_PROC (1); END;';
BEGIN
EXECUTE IMMEDIATE V_CHILD_PROC;
SYSDBA.CHILD_PROC(2);
END;
/
//调用过程PARENT_PROC
CALL PARENT_PROC();
执行结果如下：
[ID:] 1 [CALLER_TYPE:] ANONYMOUS BLOCK [OWNER_NAME:] [CALLER_NAME:] [LINE_NUMBER:] 1
[ID:] 2 [CALLER_TYPE:] PROCEDURE [OWNER_NAME:] SYSDBA [CALLER_NAME:] PARENT_PROC [LINE_NUMBER:] 6
- SP_CREATE_SYSTEM_OPERATORS
定义：
SP_CREATE_SYSTEM_OPERATORS (
create_flag int
)
功能说明：
创建或删除所有系统自定义运算符。
参数说明：
create_flag：为 1 时表示创建所有系统自定义运算符；为 0 表示删除所有系统自定义运算符。
返回值：
无
举例说明：
创建所有系统自定义运算符：
SP_CREATE_SYSTEM_OPERATORS(1);
- LSN_TO_TIMESTAMP
定义：
DATETIME
LSN_TO_TIMESTAMP(
lsn bigint
)
功能说明：
将 LSN 转换为对应时间戳，返回的时间戳为通过 V$LSN_TIME 估算的结果，可能存在一定误差。
参数说明：
lsn：需要转换为时间戳的 LSN 值，可通过 V
$LSN_TIME 查询 LSN 和时间的映射关系，对于在[V$LSN_TIME 查询结果中最小的 LSN,系统 CUR_LSN]范围之间的 LSN 值，都能返回其对应时间戳。
返回值：
指定 LSN 值对应的时间戳
举例说明：
SELECT LSN_to_TIMESTAMP(52317);
- TIMESTAMP_TO_LSN
定义：
BIGINT
TIMESTAMP_TO_LSN(
d timestamp
)
功能说明：
将时间戳转换为对应 LSN，返回的 LSN 为通过 V$LSN_TIME 估算的结果，可能存在一定误差。
参数说明：
d：需要转换为 LSN 值的时间戳，可通过 V$LSN_TIME 查询 LSN 和时间的映射关系。
返回值：
指定时间戳对应的 LSN 值
举例说明：
SELECT TIMESTAMP_to_LSN('2023-03-02 11:01:50');
- MD5
定义：
MD5(
src varchar
)
功能说明：
计算并返回源串的 MD5 散列值。
参数说明：
src：源串，字符串类型，长度小于 32767。
返回值：
源串的 MD5 值。
返回值类型通过静态 INI 参数 MD5_TYPE 控制，修改参数值并重启服务器后生效，缺省值为 0。当 MD5_TYPE=0，返回值类型为 VARBINARY；当 MD5_TYPE=1，返回值类型为 VARCHAR。
举例说明：
例 1 当 MD5_TYPE=0 时。
SELECT MD5('ABC');
查询结果如下：
行号 MD5('ABC')
---------- ----------------------------------
1 0X902FBDD2B1DF0C4F70B4A5D23525E932
例 2 当 MD5_TYPE=1 时。
SELECT MD5('ABC');
查询结果如下：
行号 MD5('ABC')
---------- --------------------------------
1 902FBDD2B1DF0C4F70B4A5D23525E932
- SP_FLUSH_HIST_PLAN
定义：
SP_FLUSH_HIST_PLAN()
功能说明：
将内存中暂存的执行计划历史信息主动记录到系统表 SYS.SYSPLANHIST 中。不支持 DMDPC 环境。
举例说明：
首先，启用执行计划历史信息功能，随后重启数据库使修改的静态参数生效。
SP_SET_PARA_VALUE(2, 'ENABLE_MONITOR_PLNHIST', 1);
SP_SET_PARA_VALUE(2, 'USE_PLN_POOL', 1);
其次，执行查询语句。
SELECT 1 FROM DUAL;
接着，运行 SP_FLUSH_HIST_PLAN()将暂存执行计划历史信息主动记录到系统表 SYS.SYSPLANHIST 中。
SP_FLUSH_HIST_PLAN();
然后，使用 DBMS-xplan 系统包相关包方法查看对应的执行计划历史信息。
DBMS_XPLAN.DISPLAY_PLANHIST('SELECT 1 FROM DUAL;');
查询结果如下：
行号 SHOW_STR
--------- ------------------------------------------------------------------
1 SELECT 1 FROM DUAL;
2 HASH VALUE: 476121253
3
1 #NSET2: [1, 1, 1]
2 #PRJT2: [1, 1, 1]; EXP_NUM(1), IS_ATOM(FALSE)
3 #CSCN2: [1, 1, 1]; SYSINDEXSYSDUAL2(SYSDUAL2 AS DUAL); BTR_SCAN(1)
4 PLAN_ADDR: 0XB5C116D8
5 TIME: 2024-08-15 15:27:38
- SF_SEQUENCE_GET_MAX
定义：
DEC
SF_SEQUENCE_GET_MAX(
schema_name VARCHAR,
seq_name VARCHAR
)
功能说明：
查看指定序列的最大值。任意参数为NULL时，返回NULL。
参数说明：
schema_name：表示序列所属的模式名。
seq_name：表示序列的名字。
返回值：
序列的最大值。
举例说明：
例1 创建SEQ1并查询SEQ1的最大值。
CREATE SEQUENCE SEQ1 INCREMENT BY 1000 START WITH 5 MAXVALUE 5000 MINVALUE 1 CACHE 10;
SELECT SF_SEQUENCE_GET_MAX('SYSDBA', 'SEQ1');
查询结果为：5000
- SF_SEQUENCE_GET_MIN
定义：
DEC
SF_SEQUENCE_GET_MIN(
schema_name VARCHAR,
seq_name VARCHAR
)
功能说明：
查看指定序列的最小值。任意参数为NULL时，返回NULL。
参数说明：
schema_name：表示序列所属的模式名。
seq_name：表示序列的名字。
返回值：
序列的最小值。
举例说明：
例1 创建SEQ1并查询SEQ1的最小值。
CREATE SEQUENCE SEQ1 INCREMENT BY 1000 START WITH 5 MAXVALUE 5000 MINVALUE 1 CACHE 10;
SELECT SF_SEQUENCE_GET_MIN('SYSDBA', 'SEQ1');
查询结果为：1
35）SF_SEQUENCE_GET_START
定义：
DEC
SF_SEQUENCE_GET_STRAT(
schema_name VARCHAR,
seq_name VARCHAR
)
功能说明：
查看指定序列的起始值。任意参数为NULL时，返回NULL。
参数说明：
schema_name：表示序列所属的模式名。
seq_name：表示序列的名字。
返回值：
序列的起始值。
举例说明：
例1 创建SEQ1并查询SEQ1的起始值。
CREATE SEQUENCE SEQ1 INCREMENT BY 1000 START WITH 5 MAXVALUE 5000 MINVALUE 1 CACHE 10;
SELECT SF_SEQUENCE_GET_START('SYSDBA', 'SEQ1');
查询结果为：5
36）SF_SEQUENCE_GET_LAST_NUM
定义：
DEC
SF_SEQUENCE_GET_LAST_NUM(
schema_name VARCHAR,
seq_name VARCHAR
)
功能说明：
查看指定序列的NEXTVAL。任意参数为NULL时，返回NULL。
参数说明：
schema_name：表示序列所属的模式名。
seq_name：表示序列的名字。
返回值：
序列的NEXTVAL。
举例说明：
例1 创建SEQ1并查询SEQ1的NEXTVAL。
CREATE SEQUENCE SEQ1 INCREMENT BY 1000 START WITH 5 MAXVALUE 5000 MINVALUE 1 CACHE 10;
SELECT SF_SEQUENCE_GET_LAST_NUM('SYSDBA', 'SEQ1');
查询结果为：5
37）SF_SEQUENCE_GET_CACHE_NUM
定义：
INT
SF_SEQUENCE_GET_CACHE_NUM(
schema_name VARCHAR,
seq_name VARCHAR
)
功能说明：
查看指定序列的缓存个数。任意参数为NULL时，返回NULL。
参数说明：
schema_name：表示序列所属的模式名。
seq_name：表示序列的名字。
返回值：
序列的缓存个数。
举例说明：
例1 创建SEQ1并查询SEQ1的缓存个数。
CREATE SEQUENCE SEQ1 INCREMENT BY 1000 START WITH 5 MAXVALUE 5000 MINVALUE 1 CACHE 10;
SELECT SF_SEQUENCE_GET_CACHE_NUM('SYSDBA', 'SEQ1');
查询结果为：10
13. 编目函数调用的系统函数
1）SF_GET_BUFFER_LEN
定义：
SF_GET_BUFFER_LEN(
name varchar,
length int,
scale int
)
参数说明：
name：某列数据类型名，数据类型为 VARCHAR。
length：列的精度，INT 类型。
scale：列的刻度，INT 类型。
功能说明：
根据某列数据类型名 name 和列的精度 length 刻度 scale 获取该列存贮在硬盘上的长度。
返回值：
列存贮长度，数据类型为 INT。
举例说明：
SELECT SF_GET_BUFFER_LEN('VARCHAR',3,2);
查询结果如下：
3
2）SF_GET_DATA_TYPE
定义：
INT
SF_GET_DATA_TYPE(
name varchar,
scale int,
version int
)
参数说明：
name：某列数据类型名，数据类型为 VARCHAR。
scale：时间间隔类型刻度，INT 类型。
version：版本号，INT 类型。
功能说明：
根据数据类型关键字获取对应的 SQL 数据类型。
返回值：
数据类型值，数据类型为 INT。
举例说明：
SELECT SF_GET_DATA_TYPE('VARCHAR',3,2);
查询结果如下：
12
3）SF_GET_DATE_TIME_SUB
定义：
INT
SF_GET_DATE_TIME_SUB(
name varchar,
scale int
)
参数说明：
name：某列数据类型名，数据类型为 VARCHAR。
scale：类型刻度，INT 类型。
功能说明：
获得时间类型的子类型。
返回值：
时间类型子类型值，数据类型为 INT。
举例说明：
SELECT SF_GET_DATE_TIME_SUB('datetime',2);
查询结果如下：
3
4）SF_GET_DECIMAL_DIGITS
定义：
INT
SF_GET_DECIMAL_DIGITS(
name varchar,
scale int
)
参数说明：
name：某列数据类型名，数据类型为 VARCHAR。
scale：预期类型刻度，INT 类型。
功能说明：
根据某数据类型名和预期的刻度获取该数据类型的实际刻度。
返回值：
类型实际刻度值，数据类型为 INT。
举例说明：
SELECT SF_GET_DECIMAL_DIGITS('INT',2);
查询结果如下：
0
5）SF_GET_SQL_DATA_TYPE
定义：
INT
SF_GET_SQL_DATA_TYPE(
name varchar
)
参数说明：
name：某列数据类型名，数据类型为 VARCHAR。
功能说明：
根据某数据类型名返回该数据类型的 SQL 数据类型值。
返回值：
SQL 数据类型值，数据类型为 INT。
举例说明：
SELECT SF_GET_SQL_DATA_TYPE('INT');
查询结果如下：
4
6）SF_GET_SYS_PRIV
定义：
VARCHAR
SF_GET_SYS_PRIV(
privid int
)
参数说明：
privid：数据类型为 INT。取值范围：数据库权限 4096~4244，对象权限 8192~8198。除了 4123、4204 和 4205。
功能说明：
获得 privid 所代表的权限操作。
返回值：
前导字符串，数据类型为 VARCHAR。
举例说明：
SELECT SF_GET_SYS_PRIV(4096);
SELECT SF_GET_SYS_PRIV(4099);
查询结果如下：
CREATE DATABASE
CREATE LOGIN
7）SF_GET_OCT_LENGTH
定义：
INT
SF_GET_OCT_LENGTH(
name varchar,
length int
)
参数说明：
name：数据类型名，数据类型为 VARCHAR。
length：类型长度，INT 类型。
功能说明：
返回变长数据类型的长度。
返回值：
类型长度，数据类型为 INT。
举例说明：
SELECT SF_GET_OCT_LENGTH('VARCHAR',3);
查询结果如下：
3
8）SF_GET_TABLES_TYPE
定义：
VARCHAR
SF_GET_TABLES_TYPE(
type varchar
)
参数说明：
type：表的类型名，数据类型为 VARCHAR。
功能说明：
返回表类型名。
返回值：
表类型名，数据类型为 VARCHAR。
举例说明：
SELECT SF_GET_TABLES_TYPE('UTAB');
查询结果如下：
TABLE
9）CURRENT_SCHID
定义：
INT
CURRENT_SCHID()
参数说明：
无
功能说明：
返回当前会话的当前模式 ID。
返回值：
当前会话的当前模式 ID。
举例说明：
SELECT CURRENT_SCHID();
查询结果如下：
150994945
10）SF_GET_SCHEMA_NAME_BY_ID
定义：
VARCHAR
SF_GET_SCHEMA_NAME_BY_ID(
schid int
)
参数说明：
schid：模式 ID，INT 类型。
功能说明：
根据模式 ID 返回模式名。
返回值：
模式名，数据类型为 VARCHAR。
举例说明：
SELECT SF_GET_SCHEMA_NAME_BY_ID(150994945);
查询结果如下：
SYSDBA
11）SF_COL_IS_IDX_KEY
定义：
INT
SF_COL_IS_IDX_KEY(
key_num int,
key_info varbinary,
col_id int
)
参数说明：
key_num：键值个数，数据类型为 INT。
key_info：键值信息，数据类型为 VARBINARY。
col_id：列 ID，INT 类型。
功能说明：
判断所给的 colid 是否是 index key。
返回值：
是否索引键，数据类型为 INT。
举例说明：
CREATE TABLE TT1(C1 INT);
CREATE INDEX ID1 ON TT1(C1);
SELECT ID FROM SYSOBJECTS WHERE NAME LIKE 'TT1';//1334
SELECT INDS.KEYNUM, INDS.KEYINFO, SF_COL_IS_IDX_KEY(INDS.KEYNUM, INDS.KEYINFO, COLS.COLID) FROM (SELECT ID,PID,NAME FROM SYSOBJECTS WHERE SUBTYPE$='INDEX') AS OBJ_INDS, SYSCOLUMNS AS COLS, SYSINDEXES AS INDS WHERE COLS.ID = 1334 AND OBJ_INDS.PID = 1334 AND INDS.ID = OBJ_INDS.ID;
查询结果如下：
1 000041 1 //ID1
0 0 //聚集索引
- SF_COL_IS_IDX_KEY
定义：
INT
SF_COL_IS_IDX_KEY(
key_num int,
key_info varbinary,
col_id int,
idx_type int
)
参数说明：
key_num：键值个数，数据类型为 INT。
key_info：键值信息，数据类型为 VARBINARY。
col_id：列 ID，INT 类型。
idx_type：索引类型，0/1/2 分别表示聚集索引/函数索引/位图索引。
功能说明：
判断所给的 colid 是否是指定索引类型的 index key。
返回值：
是否是指定索引类型的索引键，数据类型为 INT。
举例说明：
DROP INDEX IDX1;
DROP TABLE TAB2;
DROP TABLE TAB1;
CREATE TABLE TAB1(
C1 INT IDENTITY(1,1) PRIMARY KEY ,
C2 INT NOT NULL);
CREATE TABLE TAB2(
C3 INT IDENTITY(1,1) PRIMARY KEY,
C4 INT NOT NULL REFERENCES TAB1(C1));
//创建位图索引：
CREATE BITMAP INDEX IDX1 ON TAB2(TAB1.C2)
FROM TAB1, TAB2
WHERE TAB1.C1 = TAB2.C4;
SELECT
distinct OBJ_INDS.NAME, COLS.NAME, INDS.TYPE$, COLS.COLID
FROM
(SELECT * FROM SYSINDEXES) INDS,
SYSCOLUMNS AS COLS,
(SELECT * FROM SYSOBJECTS WHERE SYSOBJECTS.NAME='TAB1') OBJ_TAB1,
(SELECT * FROM SYSOBJECTS WHERE SYSOBJECTS.SUBTYPE$='INDEX') OBJ_INDS
WHERE
COLS.ID=OBJ_TAB1.ID
AND OBJ_TAB1.ID=OBJ_INDS.PID
AND SF_COL_IS_IDX_KEY(INDS.KEYNUM, INDS.KEYINFO, COLS.COLID,2)=1
AND INDS.TYPE$='BM';
查询结果如下：
行号 NAME NAME TYPE$ COLID
---------- -------------- ---- ----- -----------
1 INDEX33556047 C2 BM 1
2 INDEX33556048 C2 BM 1
3 IDX1_1371_1370 C2 BM 1
- SF_GET_INDEX_KEY_ORDER
定义：
VARCHAR
SF_GET_INDEX_KEY_ORDER(
key_num int,
key_info varbinary,
col_id int
)
参数说明：
key_num：索引键个数，数据类型为 INT。
key_info：键值信息，数据类型为 VARBINARY。
col_id：列 ID，INT 类型。
功能说明：
获得当前 column 的 key 的排序。
返回值：
类型长度，数据类型为 VARCHAR。
举例说明：
CREATE TABLE TT1(C1 INT);
CREATE INDEX ID1 ON TT1(C1);
SELECT ID FROM SYSOBJECTS WHERE NAME LIKE 'TT1';//1135
SELECT SF_GET_INDEX_KEY_ORDER(INDS.KEYNUM, INDS.KEYINFO, COLS.COLID) FROM (SELECT ID,PID,NAME FROM SYSOBJECTS WHERE SUBTYPE$='INDEX') AS OBJ_INDS, SYSCOLUMNS AS COLS, SYSINDEXES AS INDS WHERE COLS.ID = 1135 AND OBJ_INDS.PID = 1135 AND INDS.ID = OBJ_INDS.ID;
查询结果：
A
NULL
- SF_GET_INDEX_KEY_SEQ
定义：
INT
SF_GET_INDEX_KEY_SEQ(
key_num int,
key_info varbinary,
col_id int
)
参数说明：
key_num：索引键个数，数据类型为 INT。
key_info：键值信息，数据类型为 VARBINARY。
col_id：列 ID，INT 类型。
功能说明：
获得当前 column 所在的 key 序号。
返回值：
当前列 KEY 序号，数据类型为 INT。
举例说明：
CREATE TABLE TT1(C1 INT);
CREATE INDEX ID1 ON TT1(C1);
SELECT ID FROM SYSOBJECTS WHERE NAME LIKE 'TT1';//1135
SELECT SF_GET_INDEX_KEY_SEQ(INDS.KEYNUM, INDS.KEYINFO, COLS.COLID) FROM (SELECT ID,PID,NAME FROM SYSOBJECTS WHERE SUBTYPE$='INDEX') AS OBJ_INDS, SYSCOLUMNS AS COLS, SYSINDEXES AS INDS WHERE COLS.ID = 1135 AND OBJ_INDS.PID = 1135 AND INDS.ID = OBJ_INDS.ID;
查询结果如下：
1
-1
- SF_GET_UPD_RULE
定义：
INT
SF_GET_UPD_RULE(
rule varchar(2)
)
参数说明：
rule：规则名，数据类型为 VARCHAR。rule 参数只会用到 rule[0]，取值为''/'C'/'N'/'D'，分别表示 no act/cascade/set null/set default。
功能说明：
解析在 SYSCONS 中 faction 中保存的外键更新规则。
返回值：
外键更新规则值，数据类型为 INT。
举例说明：
SELECT SF_GET_UPD_RULE('C');
查询结果如下：
0
- SF_GET_DEL_RULE
定义：
INT
SF_GET_DEL_RULE(
rule varchar(2)
)
参数说明：
rule：规则名，数据类型为 VARCHAR，rule 参数只会用到 rule[1]，取值为''/'C'/'N'/'D'，分别表示 no act/cascade/set null/set default。
功能说明：
解析在 SYSCONS 中 faction 中保存的外键删除规则。
返回值：
外键删除规则值，数据类型为 INT。
举例说明：
SELECT SF_GET_DEL_RULE('AC');
查询结果如下：
0
- SF_GET_OLEDB_TYPE
定义：
INT
SF_GET_OLEDB_TYPE(
name varchar
)
参数说明：
name：类型名，数据类型为 VARCHAR。
功能说明：
获得 OLEDB 的数据类型长度。
返回值：
数据类型值，数据类型为 INT。
举例说明：
SELECT SF_GET_OLEDB_TYPE('INT');
查询结果如下：
3
- SF_GET_OLEDB_TYPE_PREC
定义：
INT
SF_GET_OLEDB_TYPE_PREC(
name varchar,
length int )
参数说明：
name：类型名，数据类型为 VARCHAR。
length：类型长度，数据类型为 INT。
功能说明：
获得 OLEDB 的数据类型的精度。
返回值：
数据类型的精度值，数据类型为 INT。
举例说明：
SELECT SF_GET_OLEDB_TYPE_PREC('INT',2);
查询结果如下：
10
- SP_GET_TABLE_COUNT
定义：
BIGINT
SP_GET_TABLE_COUNT(
table_id int
)
参数说明：
table_id：表 id，数据类型为 INT。
功能说明：
获得表行数。
返回值：
表的行数，数据类型为 BIGINT。
举例说明：
SELECT SP_GET_TABLE_COUNT(1097);
查询结果如下：
69
- SF_OLEDB_TYPE_IS_LONG
定义：
INT
SF_OLEDB_TYPE_IS_LONG(
typename varchar )
参数说明：
typename：类型名，数据类型为 VARCHAR。
功能说明：
判断类型是否较长。
返回值：
0 或者 1，数据类型为 INT。
举例说明：
SELECT SF_OLEDB_TYPE_IS_LONG('IMAGE');
SELECT SF_OLEDB_TYPE_IS_LONG('INT');
查询结果如下：
1
0
- SF_OLEDB_TYPE_IS_BESTMATCH
定义：
INT
SF_OLEDB_TYPE_IS_BESTMATCH(
typename varchar
)
参数说明：
typename：类型名，数据类型为 VARCHAR。
功能说明：
判断类型是否精确匹配类型。
返回值：
0 或者 1，数据类型为 INT。
举例说明：
SELECT SF_OLEDB_TYPE_IS_BESTMATCH('INT');
SELECT SF_OLEDB_TYPE_IS_BESTMATCH('IMAGE');
查询结果如下：
1
0
- SF_OLEDB_TYPE_IS_FIXEDLEN
定义：
INT
SF_OLEDB_TYPE_IS_FIXEDLEN(
typename varchar )
参数说明：
typename：类型名，数据类型为 VARCHAR。
功能说明：
判断类型是否为定长类型。
返回值：
0 或者 1，数据类型为 INT。
举例说明：
SELECT SF_OLEDB_TYPE_IS_FIXEDLEN('INT');
SELECT SF_OLEDB_TYPE_IS_FIXEDLEN('IMAGE');
查询结果如下：
1
0
- SF_GET_TABLE_COUNT
定义：
BIGINT
SF_GET_TABLE_COUNT(
schema_name varchar(128),
table_name varchar(128))
参数说明：
schema_name：模式名，数据类型为 varchar。
table_name：表名，数据类型为 varchar。
功能说明：
获得表行数。功能和 SP_GET_TABLE_COUNT 一样。
返回值：
表的行数，数据类型为 BIGINT。
举例说明：
SELECT SF_GET_TABLE_COUNT('SYSDBA','T');
查询结果如下：
69
14. BFILE
- BFILENAME
定义：
BFILE
BFILENAME(
dir varchar,
filename varchar
)
参数说明：
dir：数据库的目录对象名，字符串中不能包含“:”。
filename：操作系统文件名，字符串中不能包含“:”。
功能说明：
生成一个 BFILE 类型数据。
返回值：
BFILE 数据类型对象。
15. 定制会话级 INI 参数
提供用户定制会话级 ini 参数默认值的功能。定制以后，当用户再次登录时无需复杂的设置就可以在当前会话中使用定制的会话级 ini 参数，并且使无法设置参数的 B/S 或者 C/S 应用也能使用特定的会话级 ini 参数。
定制后的 ini 参数值可以通过数据字典 SYSUSERINI 查看。
使用时有以下限制：
- 用户对会话级参数的定制和取消对于当前会话不会立刻生效，也不会影响当前已经连接的该用户的其他会话。该用户新登录的会话会使用定制的值作为默认值。
- MPP 环境下，参数的定制在整个 MPP 环境所有的服务器节点生效。
- 对于一个会话级 ini 参数，其取值优先级顺序为： 会话中设置的值 > 用户定制的值 > INI 文件中匹配的值。
- DBA 用户拥有定制、查询和删除所有用户 ini 的权限；普通用户拥有定制、查询和删除自身 ini 的权限。
对于不同数据类型的参数要使用不同的系统过程。ini 参数的 VALUE 有三种类型：INT、VARCHAR 和 DOUBLE，分别对应三个系统过程：
1）SP_SET_USER_INI
定义：
SP_SET_USER_INI(
user varchar,
para_name varchar,
value int
)
功能说明：
定制 INT 类型的 ini 参数。
参数说明：
user：用户名。
para_name：参数名。
value：INT 类型参数值。
举例说明：
SP_SET_USER_INI('USER1','SORT_BUF_SIZE','1234');
2）SP_SET_USER_STRING_INI
定义：
SP_SET_USER_STRING_INI(
user varchar,
para_name varchar,
value varchar
)
功能说明：
定制 VARCHAR 类型的 ini 参数。
参数说明：
user：用户名。
para_name：参数名。
value：VARCHAR 类型参数值。
3）SP_SET_USER_DOUBLE_INI
定义
SP_SET_USER_STRING_INI(
user varchar,
para_name varchar,
value varchar
)
功能说明：
定制 DOUBLE 类型的 ini 参数。
参数说明：
user：用户名。
para_name：参数名。
value：DOUBLE 类型参数值。
举例说明：
SP_SET_USER_DOUBLE_INI('USER2','INDEX_SKIP_SCAN_RATE','0.0035');
4）SP_CLEAR_USER_INI
定义
SP_CLEAR_USER_INI(
user varchar,
para_name varchar
)
功能说明：
清除用户 USER 的 PARA_NAME 的参数定制。当 USER 和 PARA_NAME 都等于 NULL 时，表示清除所有用户的所有定制；当 PARA_NAME 为 NULL 时，表示清除用户 USER 的所有定制。不支持 USER 为 NULL，PARA_NAME 不为 NULL 的情况。
参数说明：
user：用户名。
para_name：参数名。
举例说明：
SP_CLEAR_USER_INI('USER2',NULL);
16. 为 SQL 注入 HINT 规则
为 SQL 语句注入 HINT 规则，是指无需修改 SQL 语句，通过 SF_INJECT_HINT 为该 SQL 注入 HINT 规则，随后该 SQL 按照注入的 HINT 规则运行的功能。通过 SF_INJECT_HINT 注入的 HINT 称为 INJECT HINT。
使用方法：
第一步，DM.INI 参数 ENABLE_INJECT_HINT 设置为 1。
第二步，通过 SF_INJECT_HINT 为 SQL 注入 HINT 规则。
HINT 规则一经注入，就全局存在。HINT 规则名称必须全局唯一。HINT 规则的名称是指 SF_INJECT_HINT 中 name 参数指定的名称或 name 参数为 NULL 时系统自动创建的名称。
SF_INJECT_HINT 方法创建的 HINT 规则默认无生效类别限制。如果需要为该 HINT 规则设置生效类别，可通过 SF_ALTER_HINT 过程修改。
第三步，使用使用 SF_ALTER_HINT 修改指定 HINT 规则的属性。
本步骤为可选项，需要修改 HINT 规则时使用。
对于指定 SQL，在一个指定生效类别下，精确匹配 HINT 规则至多指定一个，模糊匹配 HINT 规则可以一个或多个。当指定 SQL 已经存在无生效类别限制的精确匹配 HINT 规则时，无法再为该 SQL 指定新的精确匹配 HINT 规则。在符合 SQL 匹配条件的 HINT 规则同时存在多个时，精确匹配总是优先于模糊匹配，且 SQL 匹配方式（精确/模糊匹配）相同时，有生效类别限制的优先。
第四步，改变当前会话的 HINT 规则。
本步骤为可选项，需要改变当前会话的 HINT 规则时使用。
当某 HINT 规则存在生效类别限制，且其和 DM.INI 参数 SQLTUNE_CATEGORY 的会话值不一致时，该 HINT 规则在本会话范围内将不生效。因此，可以通过设置 SQLTUNE_CATEGORY 的会话值，让 HINT 规则在指定会话中达到不生效的目的。
第五步，验证是否指定成功。
通过 SYSINJECTHINT 视图查看 SQL 语句及其注入的 HINT 规则信息。
第六步，使用 SF_DEINJECT_HINT 删除 SQL 的 HINT 规则。
本步骤为可选项，需要删除 SQL 的 HINT 规则时使用。
下面详细介绍为 SQL 注入 HINT 规则的相关系统函数：
- SF_INJECT_HINT
定义：
定义 1：
VARCHAR
SF_INJECT_HINT (
sql_text text,
hint_text text,
name varchar(128),
description varchar(256),
validate boolean
)
或者
定义 2：
VARCHAR
SF_INJECT_HINT (
sql_text text,
hint_text text,
name varchar(128),
description varchar(256),
validate boolean,
fuzzy boolean
)
或者
定义 3：
VARCHAR
SF_INJECT_HINT (
sql_text text,
hint_text text,
name varchar(128),
description varchar(256),
validate boolean,
fuzzy boolean,
need_clear boolean
)
或者
定义 4：
VARCHAR
SF_INJECT_HINT (
sql_text text,
hint_text text,
name varchar(128),
description varchar(256),
validate boolean,
fuzzy int
)
或者
定义 5：
VARCHAR
SF_INJECT_HINT (
sql_text text,
hint_text text,
name varchar(128),
description varchar(256),
validate boolean,
fuzzy int,
need_clear boolean
)
功能说明：
为 SQL 注入 HINT 规则。SF_INJECT_HINT 方法创建的 HINT 规则无生效类别限制，如果需要为该 HINT 规则设置生效类别，可通过 SF_ALTER_HINT 过程修改实现。
参数说明：
sql_text：待注入 HINT 规则的 SQL 语句。fuzzy 参数类型为 INT 时，值为 2 表示支持通过 sql_text_id 指定待注入的 SQL 语句，sql_text_id 字段可通过 V$SQLTEXT 视图进行查询。
hint_text：待注入的 HINT 规则，必须指定为非 NULL 值。
name：HINT 规则的名称，指定为 NULL 值时系统为其命名。
description：对 HINT 规则的详细描述。
validate：HINT 规则是否生效。TRUE 是；FALSE 否。
fuzzy：指定 SQL 的匹配规则为精准匹配或模糊匹配。当该参数缺省时，表示使用定义 1 的语法，仅支持精准匹配。该参数类型为 BOOLEAN 时，使用定义 2 或定义 3 的语法，值为 TRUE 时，为模糊匹配；值为 FALSE 时，为精准匹配。精准匹配时，待注入 HINT 规则的 SQL 语句必须为语法正确的 INSERT/DELETE/UPDATE/SELECT/MERGE INTO 语句（语句以 EXPLAIN/EXPLAIN FOR 开头时，去掉 EXPLAIN/EXPLAIN FOR 后的语句必须完全正确），精准匹配要求 SQL 语句完全匹配，不支持 SQL 语句中的子查询匹配；模糊匹配时，待注入 HINT 规则的 SQL 语句应为非 NULL 值。该参数类型为 INT 时，使用定义 4 或定义 5 的语法，值为 0 表示精确匹配，值为 1 表示模糊匹配，值为 2 表示通过 sql_text_id 精确匹配。fuzzy 取值为 2 时，参数 sql_text 应该输入长度为 13 的 sql_text_id 字段，如果 fuzzy 取值为 2 但参数 sql_text 依旧输入 SQL 语句，预期会报错。
need_clear：是否同步清空所有缓存的计划。当该参数缺省时，表示使用定义 1、定义 2 或定义 4 的语法，此时默认不清空缓存的计划。指定该参数时，使用定义 3 和定义 5 的语法，值为 TRUE 时，清空缓存的计划；值为 FALSE 时，模糊匹配和通过 sql_text_id 匹配时，不清空缓存的计划，需要手动清除对应 SQL 的计划后，指定的 HINT 才能生效，精确匹配时，默认会删除受影响 SQL 的计划缓存。
返回值：
执行成功返回名称，执行失败报错误信息。
举例说明：
进行建表操作。
DROP TABLE A;
CREATE TABLE A(C1 INT,C2 CHAR(20));
在指定 HINT 前，LIKE_OPT_FLAG 默认为 127，将对 LIKE 表达式进行优化处理。执行下列语句：
EXPLAIN SELECT * FROM A WHERE C2 LIKE '%DM%';
对 LIKE 表达式进行优化处理，执行结果如下：
1 #NSET2: [1, 1, 64]
2 #PRJT2: [1, 1, 64]; exp_num(3), is_atom(FALSE)
3 #SLCT2: [1, 1, 64]; exp11 > 0
4 #CSCN2: [1, 6, 64]; INDEX33555472(A); btr_scan(1)
通过以下语句指定 HINT 为 LIKE_OPT_FLAG=0 的精准匹配规则，此时将不对 LIKE 表达式进行优化处理。
SF_INJECT_HINT('SELECT * FROM A WHERE C2 LIKE ''%DM%'';', 'LIKE_OPT_FLAG(0)', 'TEST_INJECT', 'to test function of injecting hint', TRUE);
或者：
SF_INJECT_HINT('SELECT * FROM A WHERE C2 LIKE ''%DM%'';', 'LIKE_OPT_FLAG(0)', 'TEST_INJECT', 'to test function of injecting hint', TRUE, FALSE);
在指定 HINT 为 LIKE_OPT_FLAG=0 的精准匹配规则后，执行下列语句：
EXPLAIN SELECT * FROM A WHERE C2 LIKE '%DM%';
此时不对 LIKE 表达式进行优化处理，规则生效，执行结果如下：
1 #NSET2: [1, 1, 64]
2 #PRJT2: [1, 1, 64]; exp_num(3), is_atom(FALSE)
3 #SLCT2: [1, 1, 64]; A.C2 LIKE '%DM%' SLCT_PUSHDOWN(TRUE)
4 #CSCN2: [1, 6, 64]; INDEX33555472(A) NEED_SLCT(TRUE); btr_scan(1)
通过以下语句指定 HINT 为 LIKE_OPT_FLAG=0 的模糊匹配规则：
SF_INJECT_HINT('SELECT * FROM A WHERE C2 LIKE ''%DM%'';', 'LIKE_OPT_FLAG(0)', 'TEST_INJECT', 'to test function of injecting hint', TRUE, TRUE);
或者：
SF_INJECT_HINT('SELECT * FROM A WHERE C2 LIKE ''%DM%'';', 'LIKE_OPT_FLAG(0)', 'TEST_INJECT', 'to test function of injecting hint', TRUE, NULL);
为以下语句指定 HINT 为 LIKE_OPT_FLAG=0 的模糊匹配规则，且不清空缓存的计划：
SF_INJECT_HINT('SELECT * FROM A WHERE C2 LIKE ''%DM%'';', 'LIKE_OPT_FLAG(0)', 'TEST_INJECT', 'to test function of injecting hint', TRUE, TRUE, FALSE);
- SF_ALTER_HINT
定义:
定义 1：
INT
SF_ALTER_HINT (
name varchar(128),
attribute_name varchar(12),
attribute_value varchar(256)
)
或者
定义 2：
INT
SF_ALTER_HINT (
name varchar(128),
attribute_name varchar(12),
attribute_value varchar(256),
need_clear boolean
)
功能说明：
修改 HINT 规则的属性。
参数说明：
name： 要修改的规则名称，必须指定为非 NULL 值。
attribute_name：要修改的属性名，必须指定为非 NULL 值。支持的可修改的属性名和属性值包括：属性名 NAME，属性值为修改后的规则名；属性名 DESCRIPTION，属性值为修改后的规则描述；属性名 STATUS，属性值为 ENABLED/DISABLED；属性名 CATEGORY，属性值为修改后的 HINT 的生效类别（由于 SF_INJECT_HINT 方法仅能注入无类别限制的 HINT，若需要注入带生效类别的 HINT，则还需要再调用一次 SF_ALTER_HINT 更改其生效类别）。
attribute_value：设置的属性值，必须指定为非 NULL 值。
need_clear：是否同步清空所有缓存的计划。当该参数缺省时，表示使用定义 1 的语法，此时默认不清空缓存的计划。指定该参数时，使用定义 2 的语法，值为 TRUE 时，清空缓存的计划；值为 FALSE 时，模糊匹配时，不清空缓存的计划，需要手动清除对应 SQL 的计划后，指定的 HINT 才能生效，精确匹配时，默认会删除受影响 SQL 的计划缓存。需要特别注意的是，若 need_clear 为 FALSE，调用 SF_ALTER_HINT 仅修改 HINT 规则的名字，并不会删除相应 SQL 的计划缓存。
返回值：
执行成功返回 0，执行失败返回错误码。
举例说明：
让指定的 HINT 规则失效：
SF_ALTER_HINT('TEST_INJECT', 'STATUS', 'DISABLED');
修改规则名，且不清空缓存的计划：
SF_ALTER_HINT('TEST_INJECT', 'NAME', 'TEST_INJECT1', FALSE);
- SF_DEINJECT_HINT
定义:
定义 1：
INT
SF_DEINJECT_HINT (
name varchar(128)
)
或者
定义 2
INT
SF_DEINJECT_HINT (
name varchar(128),
need_clear boolean
)
功能说明：
删除 SQL 中已注入的 HINT 规则。
参数说明：
name： 要删除的规则名称，必须指定为非 NULL 值。
need_clear：是否同步清空所有缓存的计划。当该参数缺省时，表示使用定义 1 的语法，此时默认不清空缓存计划。指定该参数时，使用定义 2 的语法，值为 TRUE 时，清空缓存的计划；值为 FALSE 时，模糊匹配时，不清空缓存的计划，需要手动清除对应 SQL 的计划后，指定的 HINT 才能生效，精确匹配时，默认会删除受影响 SQL 的计划缓存。
返回值：
执行成功返回 0，执行失败返回错误码。
举例说明：
为 SQL 删除已注入的 HINT 规则：
SF_DEINJECT_HINT('TEST_INJECT');
为 SQL 删除已注入的 HINT 规则，且不清空缓存的计划：
SF_DEINJECT_HINT('TEST_INJECT', FALSE);
17. 时区设置
本小节的过程与函数都是用来设置时区相关信息。
1）SP_SET_TIME_ZONE
定义:
SP_SET_TIME_ZONE(interval day)
SP_SET_TIME_ZONE(interval day to hour)
SP_SET_TIME_ZONE(interval day to minute)
SP_SET_TIME_ZONE(interval day to second)
SP_SET_TIME_ZONE(interval hour)
SP_SET_TIME_ZONE(interval hour to minute)
SP_SET_TIME_ZONE(interval hour to second)
功能说明：
设置时区为标准时区加上 interval day 中的小时和分钟。
返回值：
无
举例说明：
SP_SET_TIME_ZONE(INTERVAL '12 3:9' hour to second);
drop table ttime;
create table ttime (c2 timestamp with time zone);
insert into ttime values('1977-01-10 8:0:0');
select * from ttime;
查询结果如下：
1977-01-10 08:00:00.000000 +12:03
2）SP_SET_TIME_ZONE_STRING
定义:
SP_SET_TIME_ZONE_STRING(
varchar
)
功能说明：
设置时区为标准时区加上 varchar 的 interval hour。varchar 只能是 interval hour 或 hour to minute。
返回值：
无。
举例说明：
SP_SET_TIME_ZONE_string('7 3');
drop table ttime;
create table ttime (c2 timestamp with local time zone);
insert into ttime values('1977-01-10 8:0:0 +4:00');
select * from ttime;
查询结果如下：
1977-01-10 11:03:00.000000
3）SP_SET_TIME_ZONE_LOCAL
定义:
SP_SET_TIME_ZONE_LOCAL()
功能说明：
设置时区为当前服务器的时区。
返回值：
无。
举例说明：
SP_SET_TIME_ZONE_LOCAL();
drop table ttime;
create table ttime (c2 timestamp with local time zone);
insert into ttime values('1977-01-10 8:0:0 +3:00');
select * from ttime;
查询结果如下：
1977-01-10 13:00:00.000000
4）SF_TIME_ADD_TIME_ZONE_INTERVAL/ SF_DATETIME_ADD_TIME_ZONE_INTERVAL
定义:
DATETIME SF_TIME_ADD_TIME_ZONE_INTERVAL(time)
或
DATETIME SF_DATETIME_ADD_TIME_ZONE_INTERVAL(datetime)
功能说明：
将指定时间加上 LOCAL 时区时间。调用 SF_TIME_ADD_TIME_ZONE_INTERVAL 时，日期将被强制设置为 1900-01-01。
返回值：
无
举例说明：
select SF_TIME_ADD_TIME_ZONE_INTERVAL('2:00:36');
或
select SF_DATETIME_ADD_TIME_ZONE_INTERVAL('1988-01-01 2:00:36');
查询结果如下：
1900-01-01 10:00:36 +00:00
或
1988-01-01 10:00:36 +00:00
18. XML
本小节的过程与函数都是用来解析和查询 XML 数据的，目前 DM 支持解析的 XML 数据大小不得超过 500M。
1）SF_XMLQUERY
定义:
CLOB
SF_XMLQUERY(
xmldata clob,
xpath clob
)
功能说明：
解析得到的 XML 数据。xmldata 或 xpath 为 NULL 的情况下一律返回空串。
参数说明：
xmldata：待解析的 XML 数据。
xpath：指定的解析路径。
返回值：
解析得到的 XML 数据。
举例说明：
SELECT SF_XMLQUERY('<a><b>b</b></a>', '/a');
查询结果如下：
<a>
<b>b</b>
</a>
2）XMLQUERY
定义:
CLOB
XMLQUERY(
xmldata clob,
xpath varchar
)
功能说明：
解析得到的 XML 数据。xmldata 或 xpath 为 NULL 的情况下一律返回空串。
参数说明：
xmldata：待解析的 XML 数据。
xpath：指定的解析路径。
返回值：
解析得到的 XML 数据。
举例说明：
SELECT XMLQUERY('<a><b>b</b></a>', '/a');
查询结果如下：
<a>
<b>b</b>
</a>
3）EXISTSNODE
定义:
INT
EXISTSNODE(
xmldata clob,
xpath varchar
)
功能说明：
xmldata 中是否存在指定的路径节点，若存在则返回 1，不存在返回 0。
参数说明：
xmldata：待解析的 XML 数据。
xpath：指定的路径节点。
返回值：
1 代表节点存在，0 代表节点不存在。xmldata 或 xpath 为 NULL 的情况下一律返回空串。
举例说明：
SELECT EXISTSNODE('<a><b>b</b></a>', '/a');
查询结果如下：
1
4）EXTRACTVALUE
定义:
VARCHAR
EXTRACTVALUE(
xmldata clob,
xpath varchar
)
功能说明：
获取 xmldata 中指定路径下的结点值，若路径下不止一个结点，或者结点不是叶子结点，将报错处理。
参数说明：
xmldata：待解析的 XML 数据。
xpath：指定的路径。
返回值：
获取的节点值。xmldata 或 xpath 为 NULL 的情况下一律返回空串。
举例说明：
SELECT EXTRACTVALUE('<a><b>b</b></a>', '/a/b');
查询结果如下：
b
5）APPENDCHILDXML
定义:
CLOB
APPENDCHILDXML(
xmldata clob,
xpath varchar,
child clob
)
功能说明：
将 child 结点插入到 xmldata 的 xpath 下的结点中，并将插入结点后的新 xmldata 返回。
参数说明：
xmldata：源 XML 数据。
xpath：指定的插入节点路径。
child：指定的待插入节点。
返回值：
插入节点后的新 XML 数据。xmldata 或 xpath 为 NULL 的情况下一律返回空串。
举例说明：
SELECT APPENDCHILDXML('<a><b>b</b></a>', '/a', '<d>xxx</d>');
查询结果如下：
<a>
<b>b</b>
<d>xxx</d>
</a>
6）XMLPARSE
语法格式:
XMLPARSE ({DOCUMENT|CONTENT}<value_expr>[WELLFORMED])
图例:
功能说明：
XMLPARSE 用于解析 XMLTYPE 类型数据，亦即 value_expr 的值。当指定为 DOCUMENT 时，value_expr 被解析为只有一个根节点的标准 XML 文档；当指定为 CONTENT 时，value_expr 被解析为有效的 XML 值，value_expr 可以没有 XML 申明部分。若指定了 WELLFORMED 参数，则不对 XML 内容进行检查，否则会对内容的合法性进行检查，内容不合法则报错。
举例说明：
SELECT XMLPARSE(DOCUMENT '<a>good</a>' WELLFORMED);
查询结果如下：
<a>good</a>
7）XMLTABLE
语法格式:
XMLTABLE([<namespace_clause>,]<xmlpath> PASSING <xmldata> [COLUMNS <xmlcoldef_lst>])
<namespace_clause>::=XMLNAMESPACE( <string> AS "<id>"{, <string> AS "<id>"})
图例:
<namespace_clause>
功能说明：
查询 XML 数据的子选项。
参数说明：
namespaces：表示命名空间。
string：表示字符串类型数据。
id：表示标识符。
xmlpath：XML 数据的路径。
xmldata：XMLTYPE 类型数据。
xmlcoldef_lst：列定义列表。
举例说明：
CREATE TABLE T3(C1 VARCHAR);
SF_SET_SESSION_PARA_VALUE('ENABLE_TABLE_EXP_REF_FLAG', 1); //开启同层列引用参数。SELECT语句中T3.C引用了同层表T3的列。
INSERT INTO T3 VALUES('<A><标签 属性="属性名">HELLO</标签></A>');
SELECT X1,X2 FROM T3, XMLTABLE('/A/标签' PASSING T3.C1 COLUMNS X1 VARCHAR(12) PATH '@属性', X2 VARCHAR(12) PATH 'text()');
查询结果如下：
行号 X1 X2
------- ------ -----
1 属性名 HELLO
支持多个命名空间。
SELECT * FROM XMLTABLE(XMLNAMESPACES('hxtp://www.a.com' AS "d",'hxtp://www.a.com' AS "f"), '/a' PASSING XMLTYPE('<a ibm:id="123" xmlns:ibm="hxtp://www.a.com" ><ibm:b>textaaa</ibm:b></a>') columns id varchar(20) path '/a/f:b');
查询结果如下：
行号 ID
---------- -------
1 textaaa
8）XMLSEQUENCE
语法格式:
XMLSEQUENCE (EXTRACT ( <xmldata>, <xmlpath>) )
图例:
功能说明：
XMLSEQUENCE 用于获取 xmlpath 路径下 xmldata 中不同节点的数据，并将各结点数据按数组表的形式展示出来。
举例说明：
SELECT * FROM TABLE(XMLSEQUENCE(EXTRACT('<a><b>shanghai</b><b>dameng</b></a>','/a/b')));
查询结果如下：
行号 COLUMN_VALUE
---------- ---------------
1 <b>shanghai</b>
2 <b>dameng</b>
9）XMLELEMENT
语法格式:
XMLELEMENT(<identifier> | EVALNAME <exp> [, XMLATTRIBUTES (<exp> [AS EVALNAME <exp>] | [[AS] c_alias] {, AS EVALNAME <exp> | [AS] c_alias})][, <exp> {, <exp>}])
图例:
XML_attributes_clause
功能说明：
XMLELEMENT 用于将 exp 构建成 xml 数据类型元素，返回 xmltype 类型数据。当前将 XMLELEMENT 的功能拆分为三个子函数进行调用：XMLELEMENT：一个输入参数，用于创建 XML 元素结点；XMLATTRIBUTE：用于向 XML 元素结点添加属性；XMLCHILD：用于向 XML 元素结点添加孩子。
参数说明：
identifier：标识符。
exp：字符串类型的数据。
c_alias：列别名。
举例说明：
SELECT XMLELEMENT(DM, 'TXT1', 'TXT2') FROM DUAL;
查询结果如下：
行号 XMLCHILD(XMLCHILD(XMLELEMENT(DM),'TXT1',0),'TXT2',0)
---------- ----------------------------------------------------
1 <DM>TXT1TXT2</DM>
使用 XMLATTRIBUTES 子句。
CREATE TABLE TABLE1 (ID NUMBER(10), COL1 VARCHAR2(5));
INSERT INTO TABLE1 VALUES (1,'HELLO');
INSERT INTO TABLE1 VALUES (2,NULL);
COMMIT;
SELECT
XMLELEMENT("OUTER",
XMLFOREST(ID AS "ID"),
(CASE NVL(COL1,'NULL')
WHEN 'NULL' THEN XMLELEMENT(COL1, XMLATTRIBUTES('TRUE' AS "XSI:NIL"), NULL)
ELSE XMLFOREST(COL1 AS "COL1")
END)
)AS XML_TESTTEMP
FROM TABLE1
/
查询结果如下：
行号 XML_TESTTEMP
---------- ------------------------------------------------------
1 <OUTER>
<ID>1</ID>
<COL1>hello</COL1>
</OUTER>
2 <OUTER>
<ID>2</ID>
<COL1 XSI:NIL="TRUE"/>
</OUTER>
10）XMLFOREST
语法格式:
XMLFOREST(<exp> [AS <identifier>] {,<exp> [AS <identifier>]})
图例:
功能说明：
XMLFOREST 用于将 exp 构建成 xml 数据类型元素，返回 xmltype 类型数据。当 exp 为列名时，可以省略标识符，此时将列名作为标识符，并将该列的查询结果作为字符串类型数据，其他情况不能省略标识符。
参数说明：
exp：字符串类型的数据。
identifier：标识符。
举例说明：
exp 不为列名，不能省略标识符：
SELECT XMLFOREST('TXT1' AS A, 'TXT2' AS B) FROM DUAL;
查询结果如下：
行号 XMLFOREST('TXT1'ASA,'TXT2'ASB)
---------- --------------------
1 <A>TXT1</A><B>TXT2</B>
exp为列名，可以省略标识符，省略后将列名作为标识符：
CREATE TABLE TEST(C1 INT,C2 VARCHAR);
INSERT INTO TEST VALUES(1, 'TXT');
SELECT XMLFOREST(C1,C2) FROM TEST;
查询结果如下：
行号 XMLFOREST(C1,C2)
---------- --------------------
1 <C1>1</C1><C2>TXT</C2>
11）XMLAGG
语法格式:
XMLAGG(<XMLdata>[<ORDER BY 子句 >])
图例：
功能说明：
XMLAGG 函数，拼接 xml 数据。
参数说明：
XMLdata:待拼接的数据。
ORDER BY 子句：请参考第 4 章 数据查询语句。
举例说明：
create table X (A varchar(10),B int);
insert into X values('aaa',3);
insert into X values('bb',2);
insert into X values('c',1);
select XMLAGG(XMLPARSE(content A WELLFORMED) order by B) from X;
查询结果如下：
cbbaaa
12）DELETEXML
定义:
CLOB
DELETEXML(
xmldata clob,
xpath clob
)
功能说明：
从 xmldata 中删除 xpath 路径下的结点。
参数说明：
xmldata：XML 数据。
xpath：XML 路径。
返回值：
删除结点后的 XML 数据。
举例说明：
SELECT deleteXML('<a><b2>地方<c>d</c></b2><b2>dd</b2></a>', 'a/b2/c');
查询结果如下：
<a>
<b2>地方</b2>
<b2>dd</b2>
</a>
13）INSERTCHILDXML
定义:
CLOB
INSERTCHILDXML(
xmldata clob,
xpath varchar,
exp varchar,
insnode clob
)
功能说明：
将 insnode 结点插入到 xmldata 的 xpath 路径下，其中 insnode 结点名必须与 exp 保持一致。
参数说明：
xmldata：XML 数据。
xpath：XML 路径。
exp：结点名。
insnode：待插入的 XML 结点。
返回值：
已插入结点后的 XML 数据。
举例说明：
SELECT INSERTchildXML('<a><b2>地方</b2><b2>dd</b2></a>', 'a/b2','c', xmltype('<c>china</c>'));
查询结果如下：
<a>
<b2>地方<c>china</c></b2>
<b2>dd<c>china</c></b2>
</a>
14）INSERTCHILDXMLAFTER
定义:
CLOB
INSERTCHILDXMLAFTER(
xmldata clob,
xpath varchar,
exp varchar,
insnode clob
)
功能说明：
将 insnode 结点插入到 xmldata 的 xpath 路径下 exp 子结点后面。
参数说明：
xmldata：XML 数据。
xpath：XML 路径。
exp：xpath 下的子结点名，insonde 在此结点之后插入。
insnode：待插入的 XML 结点。
返回值：
已插入结点后的 XML 数据。
举例说明：
SELECT INSERTchildXMLafter('<a><b2>地方</b2><b2>dd</b2></a>', 'a/','b2', xmltype('<c>china</c>'));
查询结果如下：
<a>
<b2>地方</b2>
<c>china</c>
<b2>dd</b2>
<c>china</c>
</a>
15）INSERTCHILDXMLBEFORE
定义:
CLOB
INSERTCHILDXMLBEFORE (
xmldata clob,
xpath varchar,
exp varchar,
insnode clob
)
功能说明：
将 insnode 结点插入到 xmldata 的 xpath 路径下 exp 子结点前面。
参数说明：
xmldata：XML 数据。
xpath：XML 路径。
exp：xpath 下的子结点名，insonde 在此结点之前插入。
insnode：待插入的 XML 结点。
返回值：
已插入结点后的 XML 数据。
举例说明：
SELECT INSERTchildXMLbefore('<a><b2>地方</b2><b2>dd</b2></a>', 'a/','b2', xmltype('<c>china</c>'));
查询结果如下：
<a>
<c>china</c>
<b2>地方</b2>
<c>china</c>
<b2>dd</b2>
</a>
16）INSERTXMLBEFORE
定义:
CLOB
INSERTXMLBEFORE(
xmldata clob,
xpath varchar,
insnode clob
)
功能说明：
将 insnode 结点插入到 xmldata 的 xpath 路径下 exp 结点前面。
参数说明：
xmldata：XML 数据。
xpath：XML 路径。
insnode：待插入的 XML 结点。
返回值：
已插入结点后的 XML 数据。
举例说明：
SELECT INSERTXMLbefore('<a><b2>hello</b2><b2>dd</b2></a>', '/a/b2[1]', xmltype('<c>china</c>'));
查询结果如下：
<a>
<c>china</c>
<b2>hello</b2>
<b2>dd</b2>
</a>
17）INSERTXMLAFTER
定义:
CLOB
INSERTXMLAFTER(
xmldata clob,
xpath varchar,
insnode clob
)
功能说明：
将 insnode 结点插入到 xmldata 的 xpath 路径下 exp 结点后面。
参数说明：
xmldata：XML 数据。
xpath：XML 路径。
insnode：待插入的 XML 结点。
返回值：
已插入结点后的 XML 数据。
举例说明：
SELECT INSERTXMLAFTER(xmltype('<a><b2>地方</b2><b2>dd</b2></a>'), 'a/b2', xmltype('<c>china</c>'));
查询结果如下：
<a>
<b2>地方</b2>
<c>china</c>
<b2>dd</b2>
<c>china</c>
</a>
18）UPDATEXML
定义:
CLOB
UPDATEXML(
xmldata clob,
xpath varchar,
updnode clob
)
功能说明：
用 updnode 替换 xmldata 的 xpath 路径下结点。
参数说明：
xmldata：XML 数据。
xpath：XML 路径。
updnode：用于替换的 XML 结点。
返回值：
更新结点后的 XML 数据。
举例说明：
SELECT UPDATEXML('<a><a1>d1</a1><a2>d2</a2></a>', '/a/a2', '<x>f</x>');
查询结果如下：
<a>
<a1>d1</a1>
<x>f</x>
</a>
- XMLTRANSFORM
定义：
CLOB
XMLTRANSFORM(
xmldata clob,
xslt clob
)
功能说明：
将 xmldata 中的内容按照 xslt 中指定的格式生成一个新的 xml 数据。使用 xmltransform 须遵循 xslt 标准，DM 通过引入第三方库 libxslt 来支持 xslt 标准，使用时需要保证有 libxslt 库。
参数说明：
xmldata：XML 数据。
xslt：表单格式。
返回值：
变换后的新 XML 数据。
举例说明：
DECLARE
xmldata clob;
xslt clob;
BEGIN
xmldata :='
<s1 title="s1 foo">
<s2 title="Foo">
<p>Hello</p>
</s2>
</s1>';
xslt := '<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<xsl:apply-templates/>
</xsl:template>
<xsl:template match="s1">
<html>
<head><title><xsl:value-of select="@title"/></title></head>
<body>
<xsl:apply-templates select="s2"/>
</body>
</html>
</xsl:template>
</xsl:stylesheet>';
select xmltransform(xmldata, xslt);
END;
查询结果如下：
XMLTRANSFORM(XMLDATA,XSLT)
----------------------------------------------------------
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>s1 foo</title>
</head>
<body>Hello</body>
</html>
- XMLSERIALIZE
语法格式：
XMLSERIALIZE(<DOCUMENT | CONTENT> <value_expr> [AS <datatype>] [ENCODING <xml_encoding_spec>] [VERSION <string_literal>] [<NO INDENT> | <INDENT [SIZE = <number>]>] [<HIDE | SHOW> DEFAULTS])
图例：
功能说明：
XMLSERIALIZE 用于将 xml 实例按照指定的选项进行格式化输出。
参数说明：
<datatype>：仅支持 VARCHAR、BLOB、CLOB 三种数据类型。
<xml_encoding_spec>：字符串类型，用于指定输出串的编码，目前支持指定为 GBK、GB18030、UTF-8。仅在 datatype 为 BLOB 时可指定 ENCODING <xml_encoding_spec> 语句。
<string_literal>：字符串类型，设置 xml 版本类型，不作合法性校验。
<number>：整型数字，表示节点缩进格式。默认没有格式缩进，该参数取值不超过 20，即缩进不能超过 20。
<HIDE|SHOW> DEFAULTS：为语法兼容项，暂无实际意义。
举例说明：
例 1 指定为 CLOB 类型进行输出。
SELECT XMLSERIALIZE(content xmltype('<?xml version="1.1" encoding="GB18030"?> <a><c><x>d</x></c></a>') as Clob version '1.2' indent size = 10) AS xmlserialize_doc from dual;
查询结果如下：
行号 XMLSERIALIZE_DOC
---------- -----------------------------------------------------------------------------------------------------------
1 <?xml version="1.2" encoding="GB18030"?>
<a>
<c>
<x>d</x>
</c>
</a>
例 2 指定为 BLOB 类型进行输出。
SELECT XMLSERIALIZE(content xmltype('<?xml version="1.1" encoding="UTF-8"?> <a><c><x>d</x></c></a>') as Blob ENCODING 'UTF8' version '1.2' indent size = 10) AS xmlserialize_doc from dual;
查询结果如下：
行号 XMLSERIALIZE_DOC
---------- -----------------------------------------------------------------------------------------------------------
1 0x3C3F786D6C2076657273696F6E3D22312E322220656E636F64696E673D225554462D38223F3E0A3C613E0A202020202020202020203C633E0A20202020202020202020202020202020202020203C783E643C2F783E0A202020202020202020203C2F633E0A3C2F613E0A
- XMLCAST
语法格式：
XMLCAST(exp AS type)
图例：
功能说明：
XMLCAST 用于将 exp 构建的 xml 数据中的 content 内容转换为指定类型输出。
参数说明：
exp：XMLTYPE 类型的数据。
type：指定类型。
举例说明：
SELECT XMLCAST(XMLType( '<test><a>Hello</a><b> World</b>!</test>' ) AS varchar2(100)) AS XML_TO_VARCHAR2 FROM DUAL;
查询结果如下：
行号 XML_TO_VARCHAR2
---------- --------------------
1 Hello World!
19. IP
本小节的过程与函数都是用来进行 IP 地址比较的。
1）SF_INET_EQUAL
定义:
INT
SF_INET_EQUAL(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较两个 IP 地址是否相等。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
是否相等，1 表示相等，0 表示不相等。
举例说明：
SELECT SF_INET_EQUAL('192.168.1.1', '192.168.2.1') FROM DUAL;
查询结果如下：
0
2）SF_INET_NEQUAL
定义:
INT
SF_INET_NEQUAL(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较两个 IP 地址是否不等。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
是否不等，1 表示不等，0 表示相等。
举例说明：
SELECT SF_INET_EQUAL('192.168.1.1', '192.168.2.1') FROM DUAL;
查询结果如下：
1
3）SF_INET_LESS
定义:
INT
SF_INET_LESS(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较第一个 IP 地址是否小于第二个 IP 地址。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果。
举例说明：
SELECT SF_INET_LESS('192.168.1.1', '192.168.2.1') FROM DUAL;
查询结果如下：
1
4）SF_INET_LESS_EQUAL
定义:
INT
SF_INET_LESS_EQUAL(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较第一个 IP 地址是否小于等于第二个 IP 地址。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果。
举例说明：
SELECT SF_INET_LESS_EQUAL('192.168.1.1', '192.168.2.1') FROM DUAL;
查询结果如下：
1
5）SF_INET_GREAT
定义:
INT
SF_INET_GREAT(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较第一个 IP 地址是否大于第二个 IP 地址。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果。
举例说明：
SELECT SF_INET_GREAT('192.168.1.1', '192.168.2.1') FROM DUAL;
查询结果如下：
0
6）SF_INET_GREAT_EQUAL
定义:
INT
SF_INET_GREAT_EQUAL(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较第一个 IP 地址是否大于等于第二个 IP 地址。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果。
举例说明：
SELECT SF_INET_GREAT_EQUAL('192.168.1.1', '192.168.2.1') FROM DUAL;
查询结果如下：
0
7）SF_INET_CONTAIN
定义:
INT
SF_INET_CONTAIN(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较第一个 IP 地址是否包含第二个 IP 地址。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果，1 表示包含，0 表示不包含。
举例说明：
SELECT SF_INET_CONTAIN('145.13.255.1/16', '145.13.176.1/16') FROM DUAL;
查询结果如下：
0
8）SF_INET_CONTAIN_EQUAL
定义:
INT
SF_INET_CONTAIN_EQUAL(
ip1 varchar2(256),
ip2 varchar2(256)
)
功能说明：
比较第一个 IP 地址是否包含或等于第二个 IP 地址。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果，1 表示包含或等于，0 表示不包含且不等于。
举例说明：
SELECT SF_INET_CONTAIN_EQUAL('145.13.255.1/16', '145.13.176.1/16') FROM DUAL;
查询结果如下：
1
9）SF_INET_BECONTAINED
定义:
INT
SF_INET_BECONTAINED(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较第一个 IP 地址是否被第二个 IP 地址包含。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果，1 表示包含，0 表示不包含。
举例说明：
SELECT SF_INET_BECONTAINED('145.13.255.1/16', '145.13.176.1/16') FROM DUAL;
查询结果如下：
0
10）SF_INET_BECONTAINED_EQUAL
定义:
INT
SF_INET_BECONTAINED_EQUAL(
ip1 varchar(256),
ip2 varchar(256)
)
功能说明：
比较第一个 IP 地址是否被包含或等于第二个 IP 地址。
参数说明：
ip1：进行比较的第一个 IP 地址。
ip2：进行比较的第二个 IP 地址。
返回值：
比较结果，1 表示包含或等于，0 表示不包含且不等于。
举例说明：
SELECT SF_INET_BECONTAINED_EQUAL('145.13.255.1/16', '145.13.176.1/16') FROM DUAL;
查询结果如下：
1
11）SF_INET_SORT
定义:
VARCHAR
SF_INET_SORT(
ip varchar2,
)
功能说明：
将 IP 转换成一个可用来比较的字符串值。
参数说明：
ip：待转换的 IP 串，IP 串中的子网掩码为可选项。
返回值：
转换后的字符串。
举例说明：
将 IP 地址 192.168.100.2/12 转换成可比较的字符串值，其中/12 为子网掩码。
SELECT SF_INET_SORT ('192.168.100.2/12') FROM DUAL;
查询结果如下：
A192160000000012192168100002
20. ROWID
1）ROWIDTOCHAR
定义：
VARCHAR(18)
ROWIDTOCHAR (
rowid rowid
)
功能说明：
将 ROWID 类型的 ROWID 值转换成 BASE64 编码的定长为 18 字节的字符串。
参数说明：
rowid：ROWID 类型的数据。
返回值：
以 BASE64 编码的定长为 18 字节的字符串。
举例说明：
查询 TEST 表中的 ROWIDTOCHAR(ROWID)和 ROWID：
CREATE TABLE TEST(C1 INT);
INSERT INTO TEST VALUES(10);
INSERT INTO TEST VALUES(11);
SELECT ROWIDTOCHAR(ROWID),ROWID FROM TEST;
查询结果如下：
ROWIDTOCHAR(ROWID) ROWID
------------------ ------------------
AAAAAAAAAAAAAAAAAB AAAAAAAAAAAAAAAAAB
AAAAAAAAAAAAAAAAAC AAAAAAAAAAAAAAAAAC
2）CHARTOROWID
定义：
ROWID
CHARTOROWID (
c1 varchar(18)
)
功能说明：
将 BASE64 编码的定长 18 字节的字符串 STR 转换成 ROWID 数据类型。
参数说明：
C1：BASE64 编码的定长 18 字节的字符串，可为 NULL 或空串。
返回值：
ROWID 类型的值，参数为 NULL 或空串时返回 NULL。
举例说明：
将 BASE64 编码的定长 18 字节的字符串转换成 ROWID 类型的值：
CREATE TABLE T1(C1 INT);
CREATE TABLE T2(D1 ROWID,D2 VARCHAR(18));
INSERT INTO T1 SELECT LEVEL FROM DUAL CONNECT BY LEVEL<=5;
INSERT INTO T2(D1,D2) SELECT ROWID,ROWIDTOCHAR(ROWID) FROM T1;
SELECT D1,D2,CHARTOROWID(D2) FROM T2;
查询结果如下：
D1 D2 CHARTOROWID(D2)
------------------ ------------------ ------------------
AAAAAAAAAAAAAAAAAB AAAAAAAAAAAAAAAAAB AAAAAAAAAAAAAAAAAB
AAAAAAAAAAAAAAAAAC AAAAAAAAAAAAAAAAAC AAAAAAAAAAAAAAAAAC
AAAAAAAAAAAAAAAAAD AAAAAAAAAAAAAAAAAD AAAAAAAAAAAAAAAAAD
AAAAAAAAAAAAAAAAAE AAAAAAAAAAAAAAAAAE AAAAAAAAAAAAAAAAAE
AAAAAAAAAAAAAAAAAF AAAAAAAAAAAAAAAAAF AAAAAAAAAAAAAAAAAF
3）SF_BUILD_ROWID
定义：
ROWID
SF_BUILD_ROWID(
epno int,
partno bigint,
real_rowid bigint
)
功能说明：
根据站点号、分区号和数据在表中的物理行号构造一个 ROWID 类型的数据。
参数说明：
epno：站点号。取值范围 0~65535。
partno：分区号。取值范围 0~65534。
real_rowid：数据在表中的物理行号。取值范围 1~281474976710655。
返回值：
一个 ROWID 类型的数据。
举例说明：
假定站点号为 1，分区号为 2，数据的物理行号为 50。使用 SF_BUILD_ROWID 函数构造出一个 ROWID 类型数据。
SELECT SF_BUILD_ROWID(1,2,50);
查询结果如下：
AAABAAAAACAAAAAAAy
其中，AAAB 为站点号、AAAAAC 为分区号、AAAAAAAy 为 ROWID 值。
4）SF_GET_EP_SEQNO
定义：
INT
SF_GET_EP_SEQNO(
rowid rowid
)
功能说明：
在 DSC 环境下返回配置的站点号；MPP 或者 DPC 环境下返回 ROWID 上的站点号；否则返回 0。
参数说明：
rowid：ROWID 类型的数据。
返回值：
EP 站点号。
举例说明：
SELECT SF_GET_EP_SEQNO('AAABAAAAACAAAAAAAy');
查询结果如下：
0
5）SF_ROWID_GET_EP_SEQNO
定义：
INT
SF_GET_EP_SEQNO(
rowid rowid
)
功能说明：
根据 ROWID 数据类型获取本条数据来自哪个 EP 站点。本函数不适用于堆表的 ROWID。
参数说明：
rowid：ROWID 类型的数据。
返回值：
EP 站点号。
举例说明：
SELECT SF_ROWID_GET_EP_SEQNO('AAABAAAAACAAAAAAAy');
查询结果如下：
1
6）SF_ROWID_GET_PARTNO
定义：
INT
SF_ROWID_GET_PARTNO(
rowid rowid
)
功能说明：
根据 ROWID 数据类型获取本条数据的分区号。本函数不适用于堆表的 ROWID。
参数说明：
rowid：ROWID 类型的数据。
返回值：
分区号。
举例说明：
SELECT SF_ROWID_GET_PARTNO('AAABAAAAACAAAAAAAy');
查询结果如下：
2
7）SF_GET_REAL_ROWID
定义：
BIGINT
SF_GET_REAL_ROWID(
rowid rowid
)
功能说明：
根据 ROWID 数据类型获取本条数据的物理行号。本函数不适用于堆表的 ROWID。
参数说明：
rowid：ROWID 类型的数据。
返回值：
物理行号。
举例说明：
SELECT SF_GET_REAL_ROWID('AAABAAAAACAAAAAAAy');
查询结果如下：
50
- SF_GET_ROWID_BY_PAGE
定义：
CBLOB
SF_GET_ROWID_BY_PAGE (
ts_id int,
file_id int,
page_no int
)
功能说明：
获取目标页页内记录的所有 ROWID，仅限于包含数据的叶子节点页。
参数说明：
ts_id：指定目标页的表空间，如果表空间不存在则报错。
file_id：指定目标页的文件，如果文件不存在则报错。
page_no：指定目标页的编号，如果编号超出文件范围则报错。
返回值：
rowid：数据在表中的一系列物理行号，用空格隔开，范围 1~281474976710655。
举例说明：
本例中的参数值需根据实际情况进行指定。
SELECT SF_GET_ROWID_BY_PAGE(5, 0, 52);
查询结果如下：
5762 5763 5764 5765 5766 5767 5768 5769 5770 5771 5772 5773 5774 5775 5776 5777 ...... 6035 6036 6037 6038 6039 6040 6041 6042 6043 6044 6045 6046 6047 6048
21. 系统包
本小节的过程与函数都与系统包相关。
- SP_INIT_DBG_SYS
定义：
SP_INIT_DBG_SYS(
create_flag int
)
功能说明：
创建或删除 DBMS_DBG 系统包。DBMS_DBG 属于系统内部系统包，并未在《DM8 系统包使用手册》中进行介绍，若用户需要使用 dmdbg 调试工具，则必须首先创建 DBMS_DBG 系统包。关于 dmdbg 调试工具的介绍可以参考《DM8_SQL 程序设计》。
参数说明：
create_flag：为 1 时表示创建 DBMS_DBG 包；为 0 表示删除该系统包。
返回值：
无
举例说明：
创建 DBMS_DBG 系统包：
SP_INIT_DBG_SYS(1);
- SF_CHECK_DBG_SYS
定义：
INT
SF_CHECK_DBG_SYS ()
功能说明：
DBMS_DBG 系统包启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得 DBMS_DBG 系统包的启用状态：
SELECT SF_CHECK_DBG_SYS;
- SP_CREATE_SYSTEM_PACKAGES*****
定义：
SP_CREATE_SYSTEM_PACKAGES (
create_flag int
)
功能说明：
创建或删除所有系统包，其中不包含 DMGEO、DBMS_JOB、DBMS_WORKLOAD_REPOSITORY 和 DBMS_SCHEDULER 包。若在创建过程中某个系统包由于特定原因未能创建成功，会跳过继续创建后续的系统包。关于系统包的详细介绍可参考《DM8 系统包使用手册》。
参数说明：
create_flag：为 1 时表示创建所有系统包；为 0 表示删除这些系统包。
返回值：
无
举例说明：
创建所有系统包：
SP_CREATE_SYSTEM_PACKAGES (1);
- SP_CREATE_SYSTEM_PACKAGES*****
定义：
SP_CREATE_SYSTEM_PACKAGES (
create_flag int,
pkgname varchar(128)
)
功能说明：
创建或删除指定的系统包。不支持 DMGEO、DBMS_JOB、DBMS_WORKLOAD_REPOSITORY 和 DBMS_SCHEDULER 系统包。关于系统包的详细介绍可参考《DM8 系统包使用手册》。
参数说明：
create_flag：为 1 时表示创建指定的系统包；为 0 表示删除这个系统包。
pkgname：指定要创建的包名。
返回值：
无
举例说明：
创建 DBMS_LOB 系统包：
SP_CREATE_SYSTEM_PACKAGES(1, 'DBMS_LOB');
- SF_CHECK_SYSTEM_PACKAGES
定义：
INT
SF_CHECK_SYSTEM_PACKAGES（）
功能说明：
系统包的启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得系统包的启用状态：
SELECT SF_CHECK_SYSTEM_PACKAGES;
- SF_CHECK_SYSTEM_PACKAGE
定义：
INT
SF_CHECK_SYSTEM_PACKAGE（
package_name varchar(128)
）
功能说明：
检测指定系统包的启用状态。
参数说明：
package_name： 指定的系统包名。
返回值：
0：未启用；1：已启用。
举例说明：
获得系统包 DBMS_SCHEDULER 的启用状态：
SELECT SF_CHECK_SYSTEM_PACKAGE('DBMS_SCHEDULER');
- SP_INIT_GEO_SYS*****
定义：
SP_INIT_GEO_SYS(
create_flag int
)
功能说明：
创建或删除 DMGEO 系统包。
参数说明：
create_flag：为 1 时表示创建 DMGEO 包；为 0 表示删除该系统包。
返回值：
无
举例说明：
创建 DMGEO 系统包：
SP_INIT_GEO_SYS(1);
- SF_CHECK_GEO_SYS
定义：
INT
SF_CHECK_GEO_SYS ()
功能说明：
系统的 GEO 系统包启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得 GEO 系统包的启用状态：
SELECT SF_CHECK_GEO_SYS;
- SP_INIT_JOB_SYS*****
定义：
SP_INIT_JOB_SYS(
create_flag int
)
功能说明：
创建或删除 DBMS_JOB 系统包。
参数说明：
create_flag：为 0 时表示删除 DBMS_JOB 系统包；为 1 时表示创建 DBMS_JOB 系统包；为 2 时表示重建 DBMS_JOB 包中的相关方法，一般用于版本升级后，包中方法发生了改变的情况下使用。
返回值：
无
举例说明：
创建 DBMS_JOB 系统包：
SP_INIT_JOB_SYS(1);
- SP_INIT_AWR_SYS*****
定义：
SP_INIT_AWR_SYS(
create_flag int
)
功能说明：
创建或删除 DBMS_WORKLOAD_REPOSITORY 系统包。
参数说明：
create_flag：为 1 时表示创建 DBMS_WORKLOAD_REPOSITORY 系统包；为 0 表示删除该系统包。
返回值：
无
举例说明：
创建 DBMS_WORKLOAD_REPOSITORY 系统包：
SP_INIT_AWR_SYS(1);
- SF_CHECK_AWR_SYS
定义：
INT
SF_CHECK_AWR_SYS()
功能说明：
系统的 DBMS_WORKLOAD_REPOSITORY 系统包启用状态检测。
返回值：
0：未启用；1：已启用。
举例说明：
获得 DBMS_WORKLOAD_REPOSITORY 系统包的启用状态：
SELECT SF_CHECK_AWR_SYS;
- SP_INIT_DBMS_SCHEDULER_SYS*****
定义：
SP_INIT_DBMS_SCHEDULER_SYS(
create_flag int
)
功能说明：
创建或删除 DBMS_SCHEDULER 系统包。
参数说明：
create_flag：为 1 时表示创建 DBMS_SCHEDULER 系统包；为 0 表示删除该系统包。
返回值：
无
举例说明：
创建 DBMS_SCHEDULER 系统包：
SP_INIT_DBMS_SCHEDULER_SYS(1);
22. 用户自定义分词词库
本小节的过程均与全文索引相关。
- SP_WORD_LIB_CREATE
定义：
SP_WORD_LIB_CREATE(
lib_dir varchar(256),
lib_name varchar(256)
)
功能说明：
创建用户自定义的分词词库文件。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
返回值：
无
- SP_WORD_LIB_ADD_WORD
定义：
SP_WORD_LIB_ADD_WORD(
lib_dir varchar(256),
lib_name varchar(256),
word varchar(48)
)
功能说明：
向指定的自定义分词词库添加新的分词。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
word：表示新增的分词词语，最长不超过48字节。
返回值：
无
- SP_WORD_LIB_DELETE_WORD
定义：
SF_WORD_LIB_DELETE_WORD(
lib_dir varchar(256),
lib_name varchar(256),
word varchar(48)
)
功能说明：
向指定的自定义分词词库删除一个分词。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
word：表示待删除的分词词语。
返回值：
无
- SP_WORD_LIB_MODIFY_WORD
定义：
SP_WORD_LIB_MODIFY_WORD(
lib_dir varchar(256),
lib_name varchar(256),
old_word varchar(48),
new_word varchar(48)
)
功能说明：
将用户自定义的分词词库文件中的旧分词用新分词替换。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
old_word：旧分词。
new_word：新分词。
返回值：
无
- SP_WORD_LIB_DELETE
定义：
SP_WORD_LIB_DELETE(
lib_dir varchar(256),
lib_name varchar(256)
)
功能说明：
删除用户自定义的分词词库文件。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
返回值：
无
- SP_WORD_LIB_CLEAR
定义：
SP_WORD_LIB_CLEAR(
lib_dir varchar(256),
lib_name varchar(256)
)
功能说明：
清空用户自定义的分词词库文件中的全部分词词语。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
返回值：
无
- SP_WORD_LIB_BATCH_ADD_WORDS
定义：
SP_WORD_LIB_BATCH_ADD_WORDS(
lib_dir varchar(256),
lib_name varchar(256),
words_path varchar(256)
)
功能说明：
向用户自定义的分词词库文件批量添加分词词语。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
word_path：为用户自定义词语所在文件路径，文件内词语按换行分隔。
返回值：
无
- SP_WORD_LIB_BATCH_DELETE_WORDS
定义：
SP_WORD_LIB_BATCH_DELETE_WORDS(
lib_dir varchar(256),
lib_name varchar(256),
words_path varchar(256)
)
功能说明：
向用户自定义的分词词库文件批量删除分词词语。
参数说明：
lib_dir：表示目录对象名。
lib_name：表示词库文件名。
word_path：为用户自定义词语所在文件路径，文件内词语按换行分隔。
返回值：
无
