View a markdown version of this page

Esegui un processo utilizzando l'API Neptune-Export Neptune-Export - Amazon Neptune
Monitoraggio del processoAnnullamento di un processo

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esegui un processo utilizzando l'API Neptune-Export Neptune-Export

La scheda Output dello CloudFormation stack include anche. NeptuneExportApiUri Usa questo URI ogni volta che invii una richiesta all' Neptune-Export endpoint.

Esecuzione di un processo di esportazione

  • Assicurati che all'utente o al ruolo in cui viene eseguita l'esportazione sia stata concessa l'autorizzazione execute-api:Invoke.

  • Se hai impostato il EnableIAM parametro su true nello CloudFormation stack al momento dell'installazione Neptune-Export, devi Sigv4 firmare tutte le richieste all' Neptune-Export API. Ti consigliamo di utilizzare awscurl per inviare le richieste all'API. Tutti gli esempi riportati qui presuppongono che l'autenticazione IAM sia abilitata.

  • Se imposti il VPCOnly parametro su true nello CloudFormation stack al momento dell'installazione Neptune-Export, devi chiamare l' Neptune-Export API dall'interno del VPC, in genere da un'istanza Amazon EC2 situata nel VPC.

Per iniziare a esportare i dati, invia una richiesta all'endpoint NeptuneExportApiUri con i parametri di richiesta command e outputS3Pathe un parametro di esportazione endpoint.

Quello che segue è un esempio di richiesta che esporta i dati del grafo delle proprietà da Neptune e li pubblica in 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)" }
      }'

Analogamente, ecco un esempio di richiesta che esporta i dati RDF da Neptune ad Amazon S3:

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)" }
      }'

Se ometti il parametro command request, per impostazione predefinita Neptune-Export tenta di esportare i dati del grafico delle proprietà da Neptune.

Se il comando precedente è stato eseguito correttamente, l'output avrà un aspetto simile al seguente:

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

Monitoraggio del processo di esportazione appena avviato

Per monitorare un processo in esecuzione, aggiungi il relativo jobID a NeptuneExportApiUri, in modo simile al seguente:

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

Se il servizio non ha ancora avviato il processo di esportazione, restituirà la risposta seguente:

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

Quando si ripete il comando dopo l'avvio del processo di esportazione, la risposta sarà simile alla seguente:

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

Se apri i log in CloudWatch Logs utilizzando l'URI fornito dalla chiamata di stato, puoi monitorare in dettaglio l'avanzamento dell'esportazione:

Schermata della visualizzazione dei registri. CloudWatch

Annullamento di un processo di esportazione in esecuzione

Per annullare un processo di esportazione in esecuzione utilizzando il Console di gestione AWS

  1. Aprire la AWS Batch console all'indirizzo https://console.aws.amazon.com/batch/.

  2. Scegliere Jobs (Processi).

  3. Individua il processo in esecuzione da annullare, in base al jobID corrispondente.

  4. Seleziona Annulla processo.

Per annullare un processo di esportazione in esecuzione tramite l'API Neptune-Export:

Invia una richiesta HTTP DELETE a NeptuneExportApiUri con l'aggiunta di jobID, in questo modo:

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