使用 SPARQL UPDATE UNLOAD 从 Neptune 中删除数据 - Amazon Neptune

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 SPARQL UPDATE UNLOAD 从 Neptune 中删除数据

Neptune 还提供了自定义 SPARQL 操作 UNLOAD，用于删除远程源中指定的数据。UNLOAD 可以视为 LOAD 操作的反操作。它的语法如下：

注意

此特征从 Neptune 引擎版本 1.0.4.1 开始推出。

UNLOAD SILENT (URL of the remote data to be unloaded) FROM GRAPH (named graph from which to remove the data)

  • SILENT –（可选）即使在处理数据时出错，也使操作返回成功。

    当单个事务包含多个语句（例如 "LOAD ...; LOAD ...; UNLOAD ...; LOAD ...;"）并且即使某些远程数据无法处理也希望事务完成时，这可能很有用。

  • URL of the remote data to be unloaded—（必需）指定包含要从图表中卸载的数据的远程数据文件。

    远程文件必须具有以下扩展名之一（这些扩展名与 UPDATE-LOAD 支持的格式相同）：

    • .nt对于 NTriples。

    • .nq对于 NQuads。

    • .trig 表示 Trig。

    • .rdf 表示 RDF/XML。

    • .ttl 表示 Turtle。

    • .n3 表示 N3。

    • .jsonld 表示 JSON-LD。

    UNLOAD 操作将从您的数据库集群中删除该文件包含的所有数据。

    要卸载的数据的 URL 中必须包含任何 Amazon S3 身份验证。您可以预签署 Amazon S3 文件，然后使用生成的 URL 来安全地访问该文件。例如：

    aws s3 presign --expires-in (number of seconds) s3://(bucket name)/(path to file of data to unload)

    然后：

    curl https://(a Neptune endpoint URL):8182/sparql \
  --data-urlencode 'update=unload (pre-signed URL of the remote Amazon S3 data to be unloaded) \
                           from graph (named graph)'

    有关更多信息，请参阅身份验证请求：使用查询参数。

  • FROM GRAPH (named graph from which to remove the data)—（可选）指定应从中卸载远程数据的命名图。

    Neptune 将每个三元组与一个命名图形相关联。您可以使用后备命名图形 URI http://aws.amazon.com/neptune/vocab/v01/DefaultNamedGraph 来指定默认的命名图形，如下所示：

    FROM GRAPH <http://aws.amazon.com/neptune/vocab/v01/DefaultNamedGraph>

按照 LOAD 与 INSERT DATA { (inline data) } 对应的相同方式，UNLOAD 对应于 DELETE DATA { (inline data) }。与 DELETE DATA 相似，UNLOAD 不适用于包含空白节点的数据。

例如，如果本地 Web 服务器提供的文件命名为 data.nt，其中包含以下 2 个三元组：

<http://example.org/resource#a> <http://example.org/resource#p> <http://example.org/resource#b> .
<http://example.org/resource#a> <http://example.org/resource#p> <http://example.org/resource#c> .

以下 UNLOAD 命令将从命名图形 <http://example.org/graph1> 中删除这两个三元组：

UNLOAD <http://localhost:80/data.nt> FROM GRAPH <http://example.org/graph1>

这与使用以下 DELETE DATA 命令的效果相同：

DELETE DATA {
  GRAPH <http://example.org/graph1> {
    <http://example.org/resource#a> <http://example.org/resource#p> <http://example.org/resource#b> .
    <http://example.org/resource#a> <http://example.org/resource#p> <http://example.org/resource#c> .
  }
}
UNLOAD 命令引发的异常

  • InvalidParameterException – 数据中有空白节点。HTTP 状态：400 错误请求。

    消息： Blank nodes are not allowed for UNLOAD

     

  • InvalidParameterException – 数据中存在语法错误。HTTP 状态：400 错误请求。

    消息：Invalid syntax in the specified file.

     

  • UnloadUrlAccessDeniedException – 访问被拒绝。HTTP 状态：400 错误请求。

    消息：Update failure: Endpoint (Neptune endpoint) reported access denied error. Please verify access.

     

  • BadRequestException – 无法检索远程数据。HTTP 状态：400 错误请求。

    消息：（取决于 HTTP 响应）。