Neptune 載入器命令

source – Amazon S3 URI。

SOURCE 參數接受可識別單一檔案、多個檔案、一個資料夾或多個資料夾的 Amazon S3 URI。Neptune 會載入任何所指定資料夾中的每個資料檔案。

URI 可以是下列任何格式。

URI 的 object-key-name 元素相當於 Amazon S3 ListObjects API 呼叫中的 prefix 參數。它會識別所指定 Amazon S3 儲存貯體中其名稱以該字首開頭的所有物件。這可以是單一檔案或資料夾，也可以是多個檔案和/或資料夾。

一個或多個指定的資料夾可以包含多個頂點檔案和多個邊緣檔案。

例如，如果您在名為 的 Amazon S3 儲存貯體中具有下列資料夾結構和檔案bucket-name：

s3://bucket-name/a/bc
s3://bucket-name/ab/c
s3://bucket-name/ade
s3://bucket-name/bcd

如果將來源參數指定為 s3://bucket-name/a，則會載入前三個檔案。

s3://bucket-name/a/bc
s3://bucket-name/ab/c
s3://bucket-name/ade

format – 資料的格式。如需有關 Neptune Loader 命令的資料格式詳細資訊，請參閱 使用 Amazon Neptune 大量載入器擷取資料。

iamRoleArn – Neptune 資料庫執行個體為了存取 S3 儲存貯體 而擔任之 IAM 角色的 Amazon Resource Name (ARN)。如需建立可存取 Amazon S3 的角色，然後將其與 Neptune 叢集建立關聯的相關資訊，請參閱 必要條件：IAM 角色和 Amazon S3 存取。

從引擎版本 1.2.1.0.R3 開始，如果 Neptune 資料庫執行個體和 Amazon S3 儲存貯體位於不同的 AWS 帳戶中，您也可以鏈結多個 IAM 角色。在此情況下，iamRoleArn 會包含逗號分隔的角色 ARN 清單，如 在 Amazon Neptune 中鏈結 IAM 角色 中所述。例如：

curl -X POST https://localhost:8182/loader \
  -H 'Content-Type: application/json' \
  -d '{
        "source" : "s3://(the target bucket name)/(the target date file name)",
        "iamRoleArn" : "arn:aws:iam::(Account A ID):role/(RoleA),arn:aws:iam::(Account B ID):role/(RoleB),arn:aws:iam::(Account C ID):role/(RoleC)",
        "format" : "csv",
        "region" : "us-east-1"
      }'

region – region 參數必須符合叢集 AWS 的區域和 S3 儲存貯體。

Amazon Neptune 可在下列 區域使用：

mode – 載入工作模式。

允許的值：RESUME、NEW、AUTO。

預設值：AUTO

failOnError – 一種旗標，用來切換錯誤時完全停止。

允許的值："TRUE"、"FALSE"。

預設值："TRUE"。

此參數設為 "FALSE" 時，載入器會嘗試載入指定位置中的所有資料，並略過任何有錯誤的項目。

此參數設為 "TRUE" 時，載入器會在遇到錯誤時立即停止。到該時間點載入的資料仍然存在。

parallelism – 這是選用參數，可設定以減少大量載入程序所用的執行緒數量。

允許的值：

預設值：HIGH

載入 OpenCypher 資料時，parallelism 設定有時可能會導致執行緒之間發生死結。發生這種情況時，Neptune 會傳回 LOAD_DATA_DEADLOCK 錯誤。通常，您可以透過將 parallelism 設定為較低的設定，並重試載入命令來修正此問題。

parserConfiguration – 包含額外剖析器組態值的選用物件。也可選用每個子參數：

如需詳細資訊，請參閱SPARQL 預設圖形和具名圖形。

updateSingleCardinalityProperties – 這是選用參數，可控制大量載入器如何處理單一基數頂點或邊緣屬性的新值。不支援將此用於載入 openCypher 資料 (請參閱 載入 openCypher 資料)。

允許的值："TRUE"、"FALSE"。

預設值："FALSE"。

根據預設，或當 updateSingleCardinalityProperties 明確設定為 "FALSE" 時，載入器會將新值視為錯誤，因為它違反單一基數。

另一方面，當 updateSingleCardinalityProperties 設為 "TRUE" 時，大量載入器會以新的值取代現有的值。如果在要載入的來源檔案中提供多個邊緣或單一基數頂點屬性值，則大量載入結尾的最終值可以是這些新值的其中之一。載入器只會保證現有的值已由其中一個新值取代。

queueRequest – 此為選用標記參數，用以指示載入請求能否排入佇列。

您不必等到載入工作完成才能發出另一個載入工作，因為 Neptune 最多可以一次將 64 個工作排入佇列，前提是其 queueRequest 參數都設為 "TRUE"。工作的佇列順序將為先進先出 (FIFO)。

如果 queueRequest 參數遭省略或設為 "FALSE"，且已有其他執行中的載入任務，則此載入請求將失敗。

允許的值："TRUE"、"FALSE"。

預設值："FALSE"。

dependencies – 這是選用參數，可在一或多個佇列中先前工作順利完成時，發出佇列載入請求。

Neptune 最多可以一次將 64 個載入請求排入佇列，前提是其 queueRequest 參數設為 "TRUE"。dependencies 參數可讓您在一或多個佇列中指定的先前請求順利完成時，執行這類佇列請求。

例如，如果載入 Job-A 和 Job-B 彼此獨立，但載入 Job-C 須先完成 Job-A 和 Job-B 才能開始，請依照指示執行：

  "dependencies" : ["job_A_load_id", "job_B_load_id"]

由於 dependencies 參數的關係，大量載入器在 Job-A 和 Job-B 順利完成之前，將不會啟動 Job-C。如果其中任何一個失敗，則不執行 Job-C，且其狀態將設為 LOAD_FAILED_BECAUSE_DEPENDENCY_NOT_SATISFIED。

您可以使用這種方式設定多個相依性層級，如此一來，一項任務若失敗，將導致直間接仰賴該任務的所有請求遭取消。

userProvidedEdgeIds – 只有在載入包含關係 ID 的 OpenCypher 資料時，才需要這個參數。在載入資料中明確提供 OpenCypher 關係 ID 時，必須包含它並設定為 True (建議使用)。

如果 userProvidedEdgeIds 不存在或設定為 True，則載入中的每個關係檔案中都必須存在一個 :ID 欄。

當 userProvidedEdgeIds 存在且設定為 False 時，載入中的關係檔案不得包含 :ID 欄。相反地，Neptune 載入器會自動為每個關係產生一個 ID。

明確提供關係 ID 很有用，如此一來，載入器就可以在 CSV 資料中的錯誤完成修正之後繼續載入，而不必重新載入任何已載入的關係。如果尚未明確指派關係 ID，則載入器無法繼續失敗的載入 (如果任何關係檔案必須更正的話)，反而必須重新載入所有關係。

accessKey – 已棄用 可存取 S3 儲存貯體和資料檔案的 IAM 角色的存取金鑰 ID。

建議改用 iamRoleArn 參數。如需建立可存取 Amazon S3 的角色，然後將其與 Neptune 叢集建立關聯的相關資訊，請參閱 必要條件：IAM 角色和 Amazon S3 存取。

如需詳細資訊，請參閱存取金鑰 (存取金鑰 ID 和私密存取金鑰)。

secretKey – 已棄用 建議改用 iamRoleArn 參數。如需建立可存取 Amazon S3 的角色，然後將其與 Neptune 叢集建立關聯的相關資訊，請參閱 必要條件：IAM 角色和 Amazon S3 存取。

如需詳細資訊，請參閱存取金鑰 (存取金鑰 ID 和私密存取金鑰)。

以 CSV 格式載入 openCypher 資料時，必須將格式參數設定為 opencypher。

不支援 updateSingleCardinalityProperties 參數用於 openCypher 載入，因為所有 openCypher 屬性都有單一基數。OpenCypher 載入格式不支援陣列，而且如果 ID 值出現多次，則系統會將其視為重複或插入錯誤 (請參閱下文)。

Neptune 載入器會處理它在 OpenCypher 資料中遇到的重複項目，如下所示：

雖然您不必將 ID 指派給關係，但是這樣做通常是個好主意 (請參閱上面的 userProvidedEdgeIds 參數)。若沒有明確的關係 ID，載入器必須在關係檔案中發生錯誤時重新載入所有關係，而不是從失敗處繼續載入。

此外，如果載入資料未包含明確的關係 ID，則載入器無法偵測重複的關係。