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

# 用來控制 Neptune 匯出程序的參數
<a name="export-parameters"></a>

無論您使用的是 Neptune-Export 服務還是 `neptune-export` 命令行公用程式，您用來控制匯出的參數大部分都是相同的。它們包含傳遞至 Neptune-Export 端點或傳遞至命令行上 `neptune-export` 的 JSON 物件。

傳入匯出程序的物件具有下列最上層欄位：

```
-d '{
      "command" : "(either export-pg or export-rdf)",
      "outputS3Path" : "s3:/(your Amazon S3 bucket)/(path to the folder for exported data)",
      "expectedBucketOwner" : "(your AWS account ID for Amazon S3 bucket)",
      "jobSize" : "(for Neptune-Export service only)",
      "params" : { (a JSON object that contains export-process parameters) },
      "additionalParams": { (a JSON object that contains parameters for training configuration) }
    }'
```

**Contents**
+ [`command` 參數](#export-parameters-command)
+ [`outputS3Path` 參數](#export-parameters-outputS3Path)
+ [`expectedBucketOwner` 參數](#export-parameters-expectedBucketOwner)
+ [`jobSize` 參數](#export-parameters-jobSize)
+ [`params` 物件](#export-parameters-params)
+ [`additionalParams` 物件](#export-parameters-additionalParams)
+ [匯出 `params` 頂層 JSON 物件中的參數欄位](export-params-fields.md)
  + [所匯出參數 `params` 物件中可能欄位的清單](export-params-fields.md#export-params-fields-list)
    + [所有匯出類型通用的欄位清單](export-params-fields.md#export-params-common-fields-list)
    + [屬性圖匯出的欄位清單](export-params-fields.md#export-params-property-graph-fields-list)
    + [RDF 匯出的欄位清單](export-params-fields.md#export-params-RDF-fields-list)
  + [所有匯出類型通用的欄位](export-params-fields.md#export-params-common-fields)
    + [`params` 中的 `cloneCluster` 欄位](export-params-fields.md#export-params-cloneCluster)
    + [`params` 中的 `cloneClusterInstanceType` 欄位](export-params-fields.md#export-params-cloneClusterInstanceType)
    + [`params` 中的 `cloneClusterReplicaCount` 欄位](export-params-fields.md#export-params-cloneClusterReplicaCount)
    + [`params` 中的 `cloneClusterEnableAuditLogs` 欄位](export-params-fields.md#export-params-cloneClusterEnableAuditLogs)
    + [`params` 中的 `clusterId` 欄位](export-params-fields.md#export-params-clusterId)
    + [`params` 中的 `endpoint` 欄位](export-params-fields.md#export-params-endpoint)
    + [`params` 中的 `endpoints` 欄位](export-params-fields.md#export-params-endpoints)
    + [`params` 中的 `profile` 欄位](export-params-fields.md#export-params-profile)
    + [`params` 中的 `useIamAuth` 欄位](export-params-fields.md#export-params-useIamAuth)
    + [`params` 中的 `includeLastEventId` 欄位](export-params-fields.md#export-params-includeLastEventId)
  + [屬性圖匯出的欄位](export-params-fields.md#export-params-property-graph-fields)
    + [`params` 中的 `concurrency` 欄位](export-params-fields.md#export-params-concurrency)
    + [`params` 中的 `edgeLabels` 欄位](export-params-fields.md#export-params-edgeLabels)
    + [`params` 中的 `filter` 欄位](export-params-fields.md#export-params-filter)
    + [`params` 中的 `filterConfigFile` 欄位](export-params-fields.md#export-params-filterConfigFile)
    + [`params` 中用於屬性圖資料的 `format` 欄位](export-params-fields.md#export-params-format-pg)
    + [`params` 中的 `gremlinFilter` 欄位](export-params-fields.md#export-params-gremlinFilter)
    + [`params` 中的 `gremlinNodeFilter` 欄位](export-params-fields.md#export-params-gremlinNodeFilter)
    + [`params` 中的 `gremlinEdgeFilter` 欄位](export-params-fields.md#export-params-gremlinEdgeFilter)
    + [`params` 中的 `nodeLabels` 欄位](export-params-fields.md#export-params-nodeLabels)
    + [`params` 中的 `scope` 欄位](export-params-fields.md#export-params-scope)
  + [RDF 匯出的欄位](export-params-fields.md#export-params-rdf-fields)
    + [`params` 中用於 RDF 資料的 `format` 欄位](export-params-fields.md#export-params-format-rdf)
    + [`params` 中的 `rdfExportScope` 欄位](export-params-fields.md#export-params-rdfExportScope)
    + [`params` 中的 `sparql` 欄位](export-params-fields.md#export-params-sparql)
    + [`params` 中的 `namedGraph` 欄位](export-params-fields.md#namedgraph-params-sparql)
+ [篩選匯出內容的範例](export-filtering-examples.md)
  + [篩選屬性圖資料的匯出](export-filtering-examples.md#export-property-graph-filtering-examples)
    + [使用 `scope` 僅匯出邊緣的範例](export-filtering-examples.md#export-property-graph-filtering-scope-example)
    + [使用 `nodeLabels` 和 `edgeLabels` 僅匯出具有特定標籤之節點和邊緣的範例](export-filtering-examples.md#export-property-graph-filtering-labels-example)
    + [使用 `filter` 僅匯出所指定節點、邊緣和屬性的範例](export-filtering-examples.md#export-property-graph-filtering-filter-example)
    + [使用 `gremlinFilter` 的範例](export-filtering-examples.md#export-property-graph-filtering-gremlinFilter-example)
    + [使用 `gremlinNodeFilter` 的範例](export-filtering-examples.md#export-property-graph-filtering-gremlinNodeFilter-example)
    + [使用 `gremlinEdgeFilter` 的範例](export-filtering-examples.md#export-property-graph-filtering-gremlinEdgeFilter-example)
    + [合併 `filter`、`gremlinNodeFilter`、`nodeLabels` `edgeLabels` 和 `scope`](export-filtering-examples.md#export-property-graph-filtering-combo-example)
  + [篩選 RDF 資料的匯出](export-filtering-examples.md#export-RDF-filtering-examples)
    + [使用 `rdfExportScope` 和 `sparql` 匯出特定邊緣](export-filtering-examples.md#export-RDF-filtering-rdfExportScope-sparql-example)
    + [使用 `namedGraph` 匯出單一具名圖形](export-filtering-examples.md#export-RDF-filtering-rdfExportScope-sparql-namedGraph-example)

## `command` 參數
<a name="export-parameters-command"></a>

`command` 頂層參數決定要匯出屬性圖資料還是 RDF 資料。如果您省略 `command` 參數，匯出程序預設為匯出屬性圖資料。
+ **`export-pg`** – 匯出屬性圖資料。
+ **`export-rdf`** – 匯出 RDF 資料。

## `outputS3Path` 參數
<a name="export-parameters-outputS3Path"></a>

`outputS3Path` 頂層參數為必要參數，且必須包含可將已匯出檔案發佈至其中之 Amazon S3 位置的 URI：

```
  "outputS3Path" : "s3://(your Amazon S3 bucket)/(path to output folder)"
```

此值必須以 `s3://` 開始，其後跟著有效的儲存貯體名稱，以及選擇性地跟著儲存貯體內的資料夾路徑。

## `expectedBucketOwner` 參數
<a name="export-parameters-expectedBucketOwner"></a>

`expectedBucketOwner` 頂層參數是選用的。設定為 AWS 帳戶 ID 時，它會驗證 中指定的 Amazon S3 儲存貯體`outputS3Path`是否屬於該帳戶。如果省略，它會預設為從用於 Amazon S3 操作的登入資料解析的帳戶 ID。

```
  "expectedBucketOwner" : "(your AWS account ID for Amazon S3 bucket)"
```

## `jobSize` 參數
<a name="export-parameters-jobSize"></a>

`jobSize` 頂層參數只會與 Neptune-Export 服務搭配使用，而不會與 `neptune-export` 命令列公用程式搭配使用，而且是選用的。它可讓您描述正在啟動的匯出工作大小，這有助於判斷專用於工作的運算資源數量及其最大並行層級。

```
  "jobSize" : "(one of four size descriptors)"
```

四個有效的大小描述項如下：
+ `small` – 並行上限：8。適用於高達 10 GB 的儲存磁碟區。
+ `medium` – 並行上限：32。適用於高達 100 GB 的儲存磁碟區。
+ `large` – 並行上限：64。適用於超過 100 GB 但小於 1 TB 的儲存磁碟區。
+ `xlarge` – 並行上限：96。適用於超過 1 TB 的儲存磁碟區。

根據預設，在 Neptune-Export 服務上啟動的匯出會以 `small` 工作的形式執行。

匯出的效能不僅取決於 `jobSize` 設定，還取決於您要從中匯出的資料庫執行個體數目、每個執行個體的大小，以及工作的有效並行層級。

對於屬性圖匯出，您可以使用 [cloneClusterReplicaCount](export-params-fields.md#export-params-cloneClusterReplicaCount) 參數設定資料庫執行個體的數目，也可以使用 [concurrency](export-params-fields.md#export-params-concurrency) 參數設定工作的有效並行層級。

## `params` 物件
<a name="export-parameters-params"></a>

`params` 頂層參數是 JSON 物件，其中包含您用來控制匯出程序本身的參數，如 [匯出 `params` 頂層 JSON 物件中的參數欄位](export-params-fields.md) 中所述。`params` 物件中的有些欄位是屬性圖匯出特有的，有些欄位則是 RDF 特有的。

## `additionalParams` 物件
<a name="export-parameters-additionalParams"></a>

`additionalParams` 頂層參數是 JSON 物件，您可以使用其中包含的參數，控制在資料匯出之後套用至該資料的動作。目前，`additionalParams` 僅用於匯出 [Neptune ML](machine-learning-additionalParams.md) 的訓練資料。