此存储过程用来将 Spatial 列注册为层。在处理此存储过程时, 有关所注册的层的信息被添加至 DB2GSE.GEOMETRY_COLUMNS 目录视图。 有关此视图的信息, 参见DB2GSE.GEOMETRY_COLUMNS。
有关用于调用此存储过程的代码示例, 参见样本程序中的 C 函数 gseRegisterLayer。有关此程序的信息, 参见编写 DB2 Spatial Extender 的应用程序。
调用此存储过程所使用的用户 ID 必须具有下列权限或特权之一:
输入参数
表 26. db2gse.gse_register_layer 存储过程的输入参数。
名称 | 数据类型 | 说明 |
---|---|---|
layerSchema | INTEGER(30) | layerTable 参数中指定的表或视图所属的模式名。
此参数可为空。 注解:若不为 layerSchema 参数提供值, 该参数将缺省为调用 db2gse.gse_register_layer 存储过程所使用的用户 ID。 |
layerTable | VARCHAR(128) | 表或视图的名称,
该表或视图包含正要注册为层的列。
此参数不能为空。 |
layerColumn | VARCHAR(128) | 正要注册为层的列的名称。若该列不存在,
则 DB2 Spatial Extender 将创建它。
此参数不能为空。 |
layerTypeName | VARCHAR(64) | 正要注册为层的列的数据类型。必须以大写字母指定数据类型;
例如:
ST_POINT
若该列是在处理此存储过程时将创建的表列, 则此参数不能为空。否则,若该列是表或视图中的现存列,则此参数可为空。 |
srId | INTEGER | 用于此层的 Spatial 参考系的标识符。
对于表层, 此参数不能为空。当您注册视图层时,DB2 Spatial Extender 忽略此参数。 |
geoSchema | VARCHAR(30) | 在将视图列注册为层时应用。geoSchema
参数是作为该列所属视图基础的表的模式。
当您将视图列注册为层时,此参数可为空。当您将表列注册为层时,DB2 Spatial Extender 忽略此参数。 注解: 若不为 geoSchema 参数提供值,则该参数将缺省为 layerSchema 参数的值。 |
geoTable | VARCHAR(128) | 在将视图列注册为层时应用。geoTable
参数是作为列所属视图基础的表的名称。
当您将视图列注册为层时,此参数不能为空。当您将表列注册为层时,DB2 Spatial Extender 忽略此参数。 |
geoColumn | VARCHAR(128) | 在将视图列注册为层时应用。geoColumn
参数是作为此视图列基础的表列的名称。
当您将视图列注册为层时,此参数不能为空。当您将表列注册为层时,DB2 Spatial Extender 忽略此参数。 |
nAttributes | SMALLINT | 包含此层将进行地理编码的源数据的列数。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 |
attr1Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第一列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 若打算使用缺省地理编码器,则需要在 attr1Name 列中存储街道地址。 |
attr2Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第二列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 若打算使用缺省地理编码器,则需要在 attr2Name 列中存储城市名。 |
attr3Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第三列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 若打算使用缺省地理编码器,则需要在 attr3Name 列中存储州的名称或简称。 |
attr4Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第四列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 若打算使用缺省地理编码器,则需要在 attr4Name 列中存储邮政编码。 |
attr5Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第五列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 缺省地理编码器忽略 Attr5Name 列。 |
attr6Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第六列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 缺省地理编码器忽略 Attr6Name 列。 |
attr7Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第柒列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 缺省地理编码器忽略 Attr7Name 列。 |
attr8Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第捌列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 缺省地理编码器忽略 Attr8Name 列。 |
attr9Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第玖列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 缺省地理编码器忽略 Attr9Name 列。 |
attr10Name | VARCHAR(128) | 包含此层将进行地理编码的源数据的第拾列名称。
当您将表列注册为层时,此参数可为空。当您将视图列注册为层时,DB2 Spatial Extender 忽略此参数。 缺省地理编码器忽略 Attr10Name 列。 |
输出参数
表 27. db2gse.gse_register_layer 存储过程的输出参数。
名称 | 数据类型 | 说明 |
---|---|---|
msgCode | INTEGER | 与此存储过程的调用程序可返回的信息相关的代码。 |
Reserved | VARCHAR(1024) | DB2 Spatial Extender 服务器上构造的完整错误信息。 |
限制