Executar um trabalho do Neptune-Export usando a API do Neptune-Export - Amazon Neptune
Monitoramento do trabalhoCancelar um trabalho

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Executar um trabalho do Neptune-Export usando a API do Neptune-Export

A guia Saídas da pilha CloudFormation também inclui o NeptuneExportApiUri. Use esse URI sempre que enviar uma solicitação ao endpoint do Neptune-Export.

Executar um trabalho de exportação

  • Assegure-se de que o usuário ou o perfil sob o qual a exportação é executada tenha recebido a permissão execute-api:Invoke.

  • Se você definir o parâmetro EnableIAM como true na pilha CloudFormation ao instalar o Neptune-Export, precisará assinar com Sigv4 todas as solicitações na API do Neptune-Export. Recomendamos usar o awscurl para fazer solicitações à API. Todos os exemplos aqui pressupõem que a autenticação do IAM esteja habilitada.

  • Se você definir o parâmetro VPCOnly como true na pilha CloudFormation ao instalar o Neptune-Export, deverá chamar a API do Neptune-Export de dentro da VPC, normalmente de uma instância do Amazon EC2 localizada na VPC.

Para começar a exportar dados, envie uma solicitação ao endpoint NeptuneExportApiUri com os parâmetros de solicitação command e outputS3Path e um parâmetro de exportação endpoint.

Veja um exemplo de solicitação que exporta dados de grafos de propriedades do Neptune e os publica no 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)" }
      }'

Da mesma forma, veja um exemplo de solicitação que exporta dados do RDF do Neptune para o 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 você omitir o parâmetro de solicitação command, por padrão, o Neptune-Export tentará exportar dados do grafo de propriedades do Neptune.

Se o comando anterior fosse executado com êxito, a saída ficaria desta forma:

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

Monitorar o trabalho de exportação que você acabou de iniciar

Para monitorar um trabalho em execução, anexe o jobID ao NeptuneExportApiUri, mais ou menos desta forma:

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

Se o serviço ainda não tivesse iniciado o trabalho de exportação, a resposta ficaria desta forma:

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

Quando você repete o comando após o início do trabalho de exportação, a resposta é mais ou menos esta:

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

Se você abrir os logs no CloudWatch Logs usando o URI fornecido pela chamada de status, poderá monitorar detalhadamente o andamento da exportação:

Captura de tela da exibição do CloudWatch Logs.

Cancelar um trabalho de exportação em execução

Como cancelar o trabalho de exportação usando o Console de gerenciamento da AWS

  1. Abra o console AWS Batch em https://console.aws.amazon.com/batch/.

  2. Escolha Trabalhos.

  3. Localize o trabalho em execução que você deseja cancelar, com base no jobID.

  4. Selecione Cancelar trabalho.

Para cancelar um trabalho de exportação em execução usando a API de exportação do Neptune:

Envie uma solicitação HTTP DELETE ao NeptuneExportApiUri com o jobID anexado, desta forma:

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