如何在 MarkLogic 中重命名文档？

Question

我有一个简单的任务要做，但无法找到确切的解决方案。我在 MarkLogic 中将文件另存为 abc.xml。如何使用 XQuery 将该文件重命名为某个 example.xml？

我试过的代码：

xquery version "1.0-ml";
xdmp:document-rename ("/aaa.xml","/final.xml");

这是显示错误。

Answer 1

我知道，改变现有文档的文档URI是没有办法的。 我能想到的唯一方法是在同一个事务中创建一个具有相同内容和新URI的新文档，并删除现有文档。

它变得棘手的是确保保留所有权，权限，所有属性，属性文档，确保旧URI不用于任何地方链接到现有文档等。

但通常，文档URI从未真正使用过。 您应首先考虑是否确实需要重命名文档，以及原因。

（注意，如果您没有显示错误是什么，说“这显示错误”在SO或邮件列表上很少有用。）

Answer 2

弗洛伦特是正确的，真正的“重命名”是不可能的，或者甚至可能没有意义。 （比喻 - 将文件从一个磁盘重命名为另一个磁盘）

然而，“移动”是有意义的（复制然后在事务中删除）。 定义“移动”是依赖于用例 - 即metatdata还需要'移动'？ 权限？ 收藏？ 文件属性？ 继承权限？

xmlsh（ http://www.xmlsh.org ）为marklogic扩展实现了一个'rename'（ http://www.xmlsh.org/MarkLogicRename ）命令，这个命令实际上是一个'移动'，其实现是从帖子借来的markmail（ http://markmail.org/ ）

实现是以下XQuery - 它不会做你想要的一切，它可能会做你想要的更多。 因人而异

https://github.com/DALDEI/xmlsh/blob/master/extensions/marklogic/src/org/xmlsh/marklogic/resources/rename.xquery

（它也是很久以前写的 - 它可能会从改进中受益）

Answer 3

我有工作的例子，这对我有用。

xquery version "1.0-ml";

 declare function local:document-rename( $old-uri as xs:string, $new-uri as xs:string) as empty-sequence() { xdmp:document-delete($old-uri), let $permissions := xdmp:document-get-permissions($old-uri) let $collections := xdmp:document-get-collections($old-uri) return xdmp:document-insert( $new-uri, doc($old-uri), if ($permissions) then $permissions else xdmp:default-permissions(), if ($collections) then $collections else xdmp:default-collections(), xdmp:document-get-quality($old-uri) ) , let $prop-ns := namespace-uri(<prop:properties/>) let $properties := xdmp:document-properties($old-uri)/node() [ namespace-uri(.) ne $prop-ns ] return xdmp:document-set-properties($new-uri, $properties) }; 

(: function call :) local:document-rename ("/opt/backup/x.xml","y.xml");

Answer 4

MarkLogic 有一个解决文件重命名（移动）的教程：

https://developer.marklogic.com/recipe/move-a-document/

重要的是，它使用函数 xdmp:lock-for-update() 来防止在将源文件复制到目标位置时对其进行修改。

此外，如果您要进行批量重命名，您需要确保重命名的每个文件 URI 对应于数据库中的一个文档，否则会出现运行时错误。