View a markdown version of this page

Execute um Neptune-Export trabalho usando a Neptune-Export API - 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á.

Execute um Neptune-Export trabalho usando a Neptune-Export API

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

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 EnableIAM parâmetro como true na CloudFormation pilha durante a instalação Neptune-Export, precisará Sigv4 assinar todas as solicitações na Neptune-Export API. 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 VPCOnly parâmetro como true na CloudFormation pilha durante a instalação Neptune-Export, deverá chamar a Neptune-Export API 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 command solicitação, por padrão, Neptune-Export tentará exportar dados do gráfico 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 CloudWatch registros no Logs usando o URI fornecido pela chamada de status, poderá monitorar detalhadamente o progresso da exportação:

Captura de tela da exibição de CloudWatch registros.

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

Para cancelar um trabalho de exportação em execução usando o Console de gerenciamento da AWS

  1. Abra o AWS Batch console 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)