本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 SPARQL UPDATE UNLOAD 從 Neptune 刪除資料
<a name="sparql-api-reference-unload"></a>

Neptune 也提供自訂 SPARQL 操作 (`UNLOAD`)，用於移除遠端來源中指定的資料。`UNLOAD` 可被視為 `LOAD` 操作的對應項。它的語法是：

```
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 支援的相同格式)：
  + NTriples 為 `.nt`。
  + NQuads 為 `.nq`。
  + Trig 為 `.trig`。
  + RDF/XML 為 `.rdf`。
  + Turtle 為 `.ttl`。
  + N3 為 `.n3`。
  + JSON-LD 為 `.jsonld`。

  `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)'
  ```

  如需詳細資訊，請參閱[對請求進行身分驗證：使用查詢參數](https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html)。
+ **`FROM GRAPH `***(要從中移除資料的具名圖形)* – (*選用*) 指定應從中卸載遠端資料的具名圖形。

  Neptune 會將每個三元組與一個具名圖形建立關聯。您可以使用後援具名圖形 URI 來指定預設的具名圖形 (`http://aws.amazon.com/neptune/vocab/v01/DefaultNamedGraph`)，如下所示：

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

`UNLOAD` 會以 `LOAD` 對應至 `INSERT DATA { (inline data) }` 的相同方式對應至 `DELETE DATA { (inline data) }`。如同 `DELETE DATA`，`UNLOAD` 無法對包含空白節點的資料運作。

例如，如果本機 Web 伺服器提供名為 `data.nt` 的檔案，其中包含以下兩個三元組：

```
<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 回應)。*