SPARQLUPDATEUNLOAD用于从 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。

  • .rdffo RDF r/XML。

  • .ttl 表示 Turtle。

  • .n3 表示 N3。

  • .jsonld代表 JSON-LD。

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

  要卸载数据，必须包含任何 Amazon S3 身份验证。URL您可以预先签署 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 将每个三元组与一个命名图形相关联。你可以使用后备命名图来指定默认的命名图 URIhttp://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响应）。