更新日期：2024年09月11日
GBase 8s 的 CREATE ACCESS_METHOD 、CREATE XADATASOURCE TYPE
和 ALTER ACCESS_METHOD 语句可以以下列语法指定用途选项。
语法
用途选项
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1654
元素
描述
限制
语法
external
_routine
执行 task 的用户
定义的函数
必须在数据库中注册
数据库对象名
flag
指出标志所启用的
功能的关键字
接口指定标志名
Flag 用途分类
在用途函数、标
志和值表中。
numeric
_value
实数值
必须在数字数据类型范围内 精确数值
string
_value
表示成一个或多个
字符的值
字符必须是数据库代码集里
面的
引用字符串
task
标识用途函数的关
键字
可以对它分配函数（函数名
不能和关键字相同）的关键
字
Task 用途分类
在 用途函数、
标志和值的表
中。
value
标识配置选项的关
键字
可以赋值的预定义配置关键
字
Value 用途分类
在 用途函数、
标志和值的表
中。
用法
GBase 8s 支持在两类上下文中的用途选项：
定义或修改本地或远程表、视图和索引的主和辅存取方法
定义对符合 XA 的外部数据源的访问方法。
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1655
存取方法的用途选项
已注册的存取方法是一组属性，包含名称和称为 purpose options 的选项，它们
可用于完成以下任务：
指定哪一个函数执行是数据访问和操作任务，如打开、读取和关闭一个数
据源。
设置配置选项，例如存储空间类型。
设置标志、如允许 rowid 解释。
用 CREATE ACCESS_METHOD 语句创建存取方法时指定用途选项。要改变一个
存取方法的用途选项，使用 ALTER ACCESS_METHOD 语句。
每一个 task 、value 或 flag 关键字对应一个 sysams 系统目录表中的列名。
这些关键字允许设置下列属性：
用途函数
purpose-function attribute 将用户定义的函数或方法的名称映射到 task 关键
字，例如 am_create 、am_beginscan 或 am_getnext。这些关键字的完整
列表，请参阅用途函数、标志和值中表中的 "Task" 分类。external_routine
指定提供给存取方法的对于函数（C）。设置举例
am_create = FS_create
用途标志
purpose flag 指示存取方法是否支持一个给定的 SQL 语句或关键字。设置
举例：
am_rowids
用途值
这些字符串、字符或数字值给出标志不能提供的配置选项。设置举例：
am_sptype = 'X'
要允许一个用户定义函数或方法作为用途函数，必须首先使用 CREATE
FUNCTION 语句注册执行适当任务的 C 函数或 Java™ 方法，然后把用途关键
字设置成等价于已注册的函数或方法名。这将创建一个新的存取方法。 ALTER
ACCESS_METHOD 语句页上的示例向现有的存取方法添加用途方法。
要允许使用用途标志，把名称指定为没有对应的值。
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1656
要清除 sysams 表中的用途选项设置，使用 ALTER ACCESS_METHOD 语句的
DROP 子句。
用途函数、标志和值
用途函数、方法和标志定义了存取方法的属性。
下表描述了 sysams 列可能的设置，包括用途函数或方法、标志和值。输入项出
现的顺序和对应的 sysams 列相同。
表 1. 用途函数、用途标志和用途值
关键字
说明
类别
缺省值
am_sptype
一个字符，指定主要和辅助存取
方法可以从哪一种类型的存储空
间访问数据。am_sptype 字符
可以具有下列一种设置：
'X' 表示只能访问外部
空间的方法。
'S ' 表示只能访问
sbspace 的方法。
'A' 表示能够访问外部
空间和 sbspace 的方
法。
只有对新的存取方法是有效的。
不能用 ALTER
ACCESS_METHOD 更改或添
加一个 am_sptype 值。不要把
am_sptype 设置为 'D' 或试图
在 dbspace 中存储一个虚拟
表。
值
虚拟表接口
（C）： 'A'
am_defopclass
辅助存取方法的缺省运算符类。
在定义运算符类之前，存取方法
必须存在，然后在 ALTER
ACCESS_METHOD 语句中设置这个
值。
值
无
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1657
关键字
说明
类别
缺省值
am_keyscan
如果设置了标志，它表示
am_getnext 返回辅助存取方法
的索引键行。如果查询只选择索
引键的列，数据库服务器不读取
表而是使用辅助方法在共享存储
器的索引键行。
标志
没有设置
am_unique
如果辅助存取方法支持检查单
键，设置此标志
标志
没有设置
am_cluster
如果主或辅助存取方法支持表的
集群，设置此标志
标志
没有设置
am_rowids
如果主或辅助存取方法可以从指
定地址检索行，设置此标志
标志
没有设置
am_readwrite
如果辅助存取方法支持数据交
换，设置此标志。如果没有设置
缺省设置，表示虚拟表是只读
的。如果应用程序要写数据，为
C 虚拟表接口设置此标志，避免
产生下列问题：
INSERT 、DELETE、
UPDATE 或 ALTER
FRAGMENT 语句导致
SQL 错误。
不执行函数
am_insert 、am_delete
或 am_update 。
标志
没有设置
am_parallel
数据库服务器设置此标志以表示
哪一个用途函数或方法可以在主
或辅助存取方法中并行执行。如
果设置，十六进制am_parallel
位图包含一个或多个下列位设
置：
标志
没有设置
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1658
关键字
说明
类别
缺省值
第 1 位设置为可并行
扫描。
第 2 位设置为可并行
删除。
第 4 位设置为可并行
修改。
第 8 位设置为可并行
插入。
在Java™ Virtual-Table Interface
中不支持插入、删除和修改。
am_expr_pushdown
启用使用参数描述符的标志
标志
没有设置
am_costfactor
数据库服务器把这个值乘以
am_scancost 用途函数或方法返
回给主或辅助存取方法的成本。
从 0.1 到 0.9 的
am_costfactor 值把成本减少
到 am_scancost 计算得到的值
的几分之一。 1.1 或更大的
am_costfactor 值增加
am_scancost 值
值