使用 SPARQL UPDATE LOAD 將資料匯入至 Neptune

使用 SPARQL UPDATE LOAD 直接從 Amazon S3 將檔案載入至 Neptune

由於 Neptune 不允許您在使用 SPARQL UPDATLOAD 時將 IAM 角色傳遞給 Amazon S3，因此有問題的 Amazon S3 儲存貯體必須是公開的，或者您必須在 LOAD 查詢中使用預先簽署的 Amazon S3 URL。

若要為 Amazon S3 檔案產生預先簽署的 URL，您可以使用如下 AWS CLI 命令：

aws s3 presign --expires-in (number of seconds) s3://(bucket name)/(path to file of data to load)

然後，您可以在 LOAD 命令中使用產生的預先簽署 URL：

curl https://(a Neptune endpoint URL):8182/sparql \
  --data-urlencode 'update=load (pre-signed URL of the remote Amazon S3 file of data to be loaded) \
                           into graph (named graph)'

如需詳細資訊，請參閱對請求進行身分驗證：使用查詢參數。Boto3 文件展示了如何使用 Python 指令碼來產生一個預先簽署的 URL。

此外，必須正確設定要載入的檔案內容類型。

1. 當您使用 -metadata 參數將檔案上傳至 Amazon S3 時，請設定檔案的內容類型，如下所示：

   aws s3 cp test.nt s3://bucket-name/my-plain-text-input/test.nt --metadata Content-Type=text/plain
   aws s3 cp test.rdf s3://bucket-name/my-rdf-input/test.rdf --metadata Content-Type=application/rdf+xml

2. 確認媒體類型資訊真實存在。執行：

   curl -v bucket-name/folder-name

   此命令的輸出應該顯示您在上傳檔案時所設定的媒體類型資訊。

3. 然後，您可以使用 SPARQL UPDATE LOAD 命令將這些檔案匯入至 Neptune：

   curl https://your-neptune-endpoint:port/sparql \
     -d "update=LOAD <https://s3.amazonaws.com/bucket-name/my-rdf-input/test.rdf>"

搭配 SPARQL UPDATE LOAD 使用 Web 伺服器將檔案載入至 Neptune

1. 在 VPC 內執行的電腦上安裝 Web 伺服器，此為要載入檔案的 VPC，且是 Neptune 託管所在。例如，使用 Amazon Linux，您可能會以下列方式安裝 Apache：

   sudo yum install httpd mod_ssl
   sudo /usr/sbin/apachectl start

2. 定義您要載入之 RDF 檔案內容的 MIME 類型。SPARQL 使用 Web 伺服器傳送的 Content-type 標頭來決定內容的輸入格式，所以您必須定義 Web 伺服器的相關 MIME 類型。

   例如，假設您使用以下副檔名來識別檔案格式：

   • NTriples 為 .nt。

   • NQuads 為 .nq。

   • Trig 為 .trig。

   • RDF/XML 為 .rdf。

   • Turtle 為 .ttl。

   • N3 為 .n3。

   • JSON-LD 為 .jsonld。

   如果您使用 Apache 2 做為 Web 伺服器，您要編輯檔案 /etc/mime.types 並新增以下類型：

    text/plain nt
    application/n-quads nq
    application/trig trig
    application/rdf+xml rdf
    application/x-turtle ttl
    text/rdf+n3 n3
    application/ld+json jsonld

3. 確認 MIME 類型映射有效。一旦啟動並執行 Web 伺服器，並以您選擇的格式託管 RDF 檔案，您就可以從本機主機向 Web 伺服器傳送請求，測試組態。

   例如，您可能會傳送類似以下的請求：

   curl -v http://localhost:80/test.rdf

   然後，在 curl 的詳細輸出中，您應該會看到如下一行：

   Content-Type: application/rdf+xml

   這會顯示已成功定義的內容類型映射。

4. 您現在可以使用 SPARQL UPDATE 命令載入資料：

   curl https://your-neptune-endpoint:port/sparql \
       -d "update=LOAD <http://web_server_private_ip:80/test.rdf>"