使用 SQL 编辑 DB2 中的版本化数据
可以使用两种方式编辑 Linux、UNIX 或 Windows 操作系统上的 IBM DB2 地理数据库中的版本化数据:通过版本化视图编辑已命名版本或通过版本化视图编辑 DEFAULT 版本。有关每种编辑模式的说明,请参阅快速浏览:使用 SQL 编辑版本化数据。
大多数情况下,您将仅使用一种编辑模式。但可以在同一个站点使用两种模式;因此,本工作流将介绍如何使用这两种模式,这样您可以了解如何在两种模式间转换。如果仅使用一种模式,请阅读特定于要使用的编辑模式的部分。
z 操作系统上的 DB2 数据库中不支持版本化视图。
编辑 DEFAULT 版本
可以使用 SQL 连接到 DEFAULT 版本并编辑版本化视图。不必打开编辑会话。当开始编辑时,会自动连接到当前状态的 DEFAULT 版本。
您应该在每次编辑后进行提交,以免阻止其他用户访问表或要素类的增量表。
在以下步骤中,编辑了版本化视图 (blic_evw)。对该视图所做的编辑将写入 blic 版本化表的增量表中。由于仅有少量编辑,所以将在 DEFAULT 版本中进行编辑。
- 从 SQL 客户端连接到数据库。确保以具有编辑数据集和版本化视图的权限的用户身份进行连接。
-
使用 SQL 对版本化视图执行第一次编辑。
在本例中,对现有行进行更新以更改属性所有者名称。
UPDATE blic_evw SET propowner = 'C. O. Industry' WHERE lic = 44977;
- 提交编辑。
COMMIT;
- 进行下一次编辑。
一条新记录会通过版本化视图添加到表中。
INSERT INTO blic_evw (propowner, date_entered, location) VALUES ( 'Moe Esposito', CURRENT TIMESTAMP, db2gse.ST_PointFromText ('point (0.0125662 0.0046711)', 12));
提示:在 INSERT 语句中未指定对象 ID 值;版本化视图会自动获取下一个可用对象 ID,然后为该行插入 ID。
- 提交编辑。
COMMIT;
编辑命名版本
您需要对 blic 要素类进行一系列更新,所以决定在命名版本中进行编辑是一个好办法。
用于编辑命名版本的地理数据库的存储过程及其语法如下:
存储过程 | 权限用途 | 语法和描述 |
---|---|---|
sde.create_version | 创建已命名的地理数据库版本。 如果正在编辑命名版本(除 DEFAULT 以外的版本),请始终编辑自己的独立版本;使用版本化视图时,多个编辑器无法编辑同一个命名版本。 | CALL sde.create_version ('<parent_version>', '<child_version>', <name_rule>, <access>, '<description>', <message_code_output>, <message_output>) |
sde.setcurrentversion | 设置将访问的地理数据库版本和状态。 您将访问调用 setcurrentversion 时版本指向的状态。 | CALL sde.setcurrentversion('<child_version>', <message_code_output>, <message_output>) |
sde.edit_version | 启动和结束针对命名版本的编辑会话。 只要调用该过程,就会提交事务中的编辑内容。 | CALL sde.edit_version('<child_version>', <1 or 2>, <message_code_output>, <message_output>) 指定 1 启动编辑会话。指定 2 结束编辑会话。 |
调用语句中的参数所表示的含义如下:
- <parent_version> 是您创建版本时所依据的版本。
- <child_version> 是您所创建用于编辑的命名版本。
- <name_rule> 指示为版本指定的名称是否应采用给定名称 (2),或者在指定重复名称时是否创建唯一名称 (1)。
- <access> 是版本的权限级别:0 表示私有,1 表示公共,2 表示受保护。
- <description> 是子版本的文本描述。
- <message_code_output> 指示希望返回 SQL 代码。
- <message_output> 指示希望返回 SQL 消息。
在以下步骤中,将根据 DEFAULT 版本创建一个命名版本 (myedits12111),并通过 blic_evw 版本化视图在该版本中进行编辑。
-
从命令提示符创建一个要进行编辑的新版本。
CALL sde.create_version ('SDE.DEFAULT', 'myedits12111', 1, 1, 'versioned view edit version', ?, ?);
-
将编辑会话的版本设置为刚刚创建的子版本。
CALL sde.setcurrentversion('myedits12111', ?, ?);
这会将编辑状态设置为 myedits12111 的当前状态。
-
通过调用 edit_version 存储过程并指定 1 来启动编辑会话。1 表示应启动编辑会话。
CALL sde.edit_version('myedits12111', 1, ?, ?);
- 从 SQL 客户端启动一个新事务以编辑 blic_evw。
-
使用 SQL 对版本化视图进行一系列编辑。
INSERT INTO blic_evw (propowner, date_entered, location) VALUES ( 'V. Nay', CURRENT TIMESTAMP, db2gse.ST_PointFromText ('point (0.0125699 0.0046700)', 12)); UPDATE blic_evw SET (phone1,phone2) = ('555.111.2345','555.111.6789') WHERE propowner = 'Tella Chomsky'; UPDATE blic_evw SET exp_date = '2020-06-30 17:00:00' WHERE lid = 22903; UPDATE blic_evw SET location = db2gse.ST_PointFromText ('point (0.0125705 0.0046688)', 12)) WHERE lid = 8992; INSERT INTO blic_evw (codenum, propowner) VALUES (456, 'Anjo Badsu'); DELETE FROM blic_evw WHERE lid = 133;
- 提交编辑。
COMMIT;
-
通过调用 edit_version 存储过程并指定 2 来停止编辑会话2 表示应结束编辑会话。
CALL sde.edit_version('myedits12111', 2, ?, ?);
提示:每个编辑会话只能编辑一个版本。例如,如果要编辑第二个版本(如 mynewedits),则必须关闭针对 myedits12111 的编辑会话,如该步骤所示。然后可以调用 setcurrentversion 指向 mynewedits 版本,并通过调用 edit_version 来启动编辑会话。
用单引号括起的文本是从字面上读的。因此,在引号标记中输入的文本必须与文本存储在数据库中的大小写情况相匹配(全大写、全小写或大小写混合)。
从编辑命名版本切换到编辑 DEFAULT
如果需要直接返回编辑 DEFAULT 版本(例如,管理员通知您站点上的其他用户需要立即查看特定的编辑),可以调用 set_default 切换回编辑 DEFAULT 版本。只要连接到 DEFAULT 版本的其他用户刷新其客户端连接,就能看到您对 DEFAULT 版本所进行的编辑。
用于编辑 DEFAULT 版本的地理数据库的存储过程及其语法如下:
存储过程 | 权限用途 | 语法和描述 |
---|---|---|
sde.set_default | 返回以编辑 DEFAULT 版本的当前状态。 如果您正在编辑一个命名版本或特定状态的 DEFAULT 版本,但想返回编辑当前状态的 DEFAULT 版本,则调用此过程。 | CALL sde.set_default (<message_code_output>, <message_output>) <message_code_output> 指示希望返回 SQL 代码。<message_output> 指示希望返回 SQL 消息。 |
- 在 SQL 提示符处调用 set_default 过程。
CALL sde.set_default
此时会话已设置为编辑 DEFAULT 版本引用的当前状态。
- 编辑 blic_evw 版本化视图。
INSERT INTO blic_evw (propowner, b_name, date_entered, location) VALUES ( 'Ruben Gol', CURRENT TIMESTAMP, 'Chez Coiffure', db2gse.ST_PointFromText ('point (0.0125650 0.0046721)', 12));
- 提交编辑。
COMMIT;
指向 DEFAULT 版本同一状态或其他版本中任意状态的其他客户端可以刷新其连接并看到新的点要素。
协调编辑内容并提交到命名版本
完成对命名版本的编辑后,必须使用 ArcGIS 查看、协调和解决冲突,并提交编辑。这可以在 ArcGIS for Desktop 中使用批量协调版本地理工具或 Python 脚本来实现。有关详细信息,请参阅以下主题:
如果编辑的数据已注册为版本并且选择了将编辑内容移动到基表的选项,则编辑内容在协调和提交到 DEFAULT 版本后将移动到基表中。
将编辑内容提交到 DEFAULT 版本后,可以删除命名版本。用于协调并提交到地理数据库的 DEFAULT 版本后删除命名版本的存储过程及其语法如下:
存储过程 | 权限用途 | 语法和描述 |
---|---|---|
sde.delete_version | 删除地理数据库版本。 | CALL sde.delete_version('<child_version>', <message_code_output>, <message_output>) |
以下示例将在所有编辑内容被协调并提交到 DEFAULT 版本后删除 myedits12111:
CALL sde.delete_version ('myedits12111', ?,?);