Neptune-Export API を使用して Neptune-Export ジョブを実行する - Amazon Neptune

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Neptune-Export API を使用して Neptune-Export ジョブを実行する

CloudFormation スタックの出力タブは NeptuneExportApiUri も含みます。Neptune-Export エンドポイントにリクエストを送信するたびに、この URI を使用します。

Export ジョブを実行する
  • エクスポートを実行するユーザーまたはロールが execute-api:Invoke アクセス許可を付与されていることを確認してください。

  • Neptune-Export をインストールしたときに CloudFormation スタックの EnableIAM パラメータを true に設定すると、Neptune-Export API へのすべてのリクエストに Sigv4 署名しなければなりません。awscurl を使用して API にリクエストすることをお勧めします。ここでの例はすべて、IAM 認証が有効であることを前提としています。

  • Neptune-Export をインストールしたときに CloudFormation スタックの VPCOnly パラメータを true に設定すると、通常は VPC にある Amazon EC2 インスタンスから、VPC 内から Neptune-Export API を呼び出す必要があります。

データのエクスポートを開始するには、command および outputS3Path リクエストパラメータと endpoint エクスポートパラメータでリクエストを NeptuneExportApiUri エンドポイントに送信します。

以下は、Neptune からプロパティグラフデータをエクスポートし、それを Amazon S3 に発行するリクエストの例です。

curl \ (your NeptuneExportApiUri) \ -X POST \ -H 'Content-Type: application/json' \ -d '{ "command": "export-pg", "outputS3Path": "s3://(your Amazon S3 bucket)/neptune-export", "params": { "endpoint": "(your Neptune endpoint DNS name)" } }'

同様に、Neptune から Amazon S3 に RDF データをエクスポートするリクエストの例を次に示します。

curl \ (your NeptuneExportApiUri) \ -X POST \ -H 'Content-Type: application/json' \ -d '{ "command": "export-rdf", "outputS3Path": "s3://(your Amazon S3 bucket)/neptune-export", "params": { "endpoint": "(your Neptune endpoint DNS name)" } }'

command リクエストパラメーターを省略すると、デフォルトでは、Neptune-Export は Neptune からプロパティグラフデータをエクスポートしようとします。

前のコマンドが正常に実行された場合、出力は次のようになります。

{ "jobName": "neptune-export-abc12345-1589808577790", "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f" }

開始したばかりのエクスポートジョブを監視する

実行中のジョブを監視するには、次のようにその jobID を NeptuneExportApiUri に添付します。

curl \ (your NeptuneExportApiUri)/(the job ID)

サービスがエクスポートジョブをまだ開始していない場合、応答は次のようになります。

{ "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f", "status": "pending" }

エクスポートジョブの開始後にコマンドを繰り返すと、応答は次のようになります。

{ "jobId": "c86258f7-a9c9-4f8c-8f4c-bbfe76d51c8f", "status": "running", "logs": "https://us-east-1.console.aws.amazon.com/cloudwatch/home?..." }

ステータスコールで提供される URI を使用して CloudWatch Logs でログを開くと、エクスポートの進行状況を詳細に監視できます。

CloudWatch Logs のスクリーンショット。

実行中のエクスポートジョブをキャンセルする

AWS マネジメントコンソール を使用して実行中のエクスポートジョブをキャンセルするには
  1. AWS Batchコンソールをhttps://console.aws.amazon.com/batch/ で 開きます。

  2. ジョブ を選択します。

  3. jobID に基づいて、キャンセルする実行中のジョブを見つけます。

  4. ジョブのキャンセルを選択します。

Neptune export API を使用して実行中のエクスポートジョブをキャンセルするには

次のように HTTP DELETE リクエストを NeptuneExportApiUrijobID を添付して送信します。

curl -X DELETE \ (your NeptuneExportApiUri)/(the job ID)