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á.

Usar o serviço Neptune-Export para exportar dados do Neptune

É possível usar as etapas a seguir para exportar dados do cluster de banco de dados do Neptune para o Amazon S3 usando o serviço Neptune-Export:

Instalar o serviço Neptune-Export

Use um modelo do AWS CloudFormation para criar a pilha:

Habilitar o acesso ao Neptune por meio do Neptune-Export

Depois que a instalação do Neptune-Export for concluída, atualize o grupo de segurança da VPC do Neptune para permitir o acesso do Neptune-Export. Quando a pilha do AWS CloudFormation do Neptune-Export tiver sido criada, a guia Saídas incluirá um ID NeptuneExportSecurityGroup. Atualize o grupo de segurança da VPC do Neptune para permitir o acesso desse grupo de segurança do Neptune-Export.

Habilitar o acesso ao endpoint do Neptune-Export por meio de uma instância do EC2 baseada em VPC

Se você tornar o endpoint do Neptune-Export somente para VPC, só poderá acessá-lo de dentro da VPC em que o serviço Neptune-Export estiver instalado. Para viabilizar a conectividade de uma instância do Amazon EC2 na VPC a partir da qual você pode fazer chamadas à API do Neptune-Export, anexe o NeptuneExportSecurityGroup criado pela pilha AWS CloudFormation a essa instância do Amazon EC2.

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

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

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:

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

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)