使用 SPARQL UPDATE UNLOAD 从 Neptune 中删除数据 - Amazon Neptune
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

使用 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 -(必需)指定包含要从图形中卸载的数据的远程数据文件。

    远程文件必须具有以下扩展名之一(这些扩展名与 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 (要从中移除数据的命名图形)–(可选)指定应从中卸载远程数据的命名图形。

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

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

按照 LOADINSERT 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 响应)。