Usar a ferramenta de linha de comando neptune-export para exportar dados do Neptune - Amazon Neptune
Pré-requisitosExecutar o neptune-exportExemplos de comando

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 a ferramenta de linha de comando neptune-export para exportar dados do Neptune

É possível usar as seguintes etapas para exportar dados do cluster de banco de dados do Neptune para o Amazon S3 usando o utilitário de linha de comando neptune-export:

Pré-requisitos para usar o utilitário de linha de comando neptune-export

Antes de começar

  • Tenha a versão 8 do JDK: você precisa instalar a versão 8 do Java SE Development Kit (JDK).

  • Baixe o utilitário neptune-export: baixe e instale o arquivo neptune-export.jar.

  • Garanta que o neptune-export tenha acesso à VPC do Neptune: execute o neptune-export de um local onde ele possa acessar a VPC em que o cluster de banco de dados do Neptune está localizado.

    Por exemplo, você pode executá-lo em uma EC2 instância da Amazon dentro da VPC Neptune, ou em uma VPC separada que é pareada com a VPC Neptune, ou em um bastion host separado.

  • Garanta que os grupos de segurança da VPC concedam acesso a neptune-export: confira se os grupos de segurança da VPC anexados à VPC do Neptune permitem acesso ao cluster de banco de dados a partir do endereço IP ou do grupo de segurança associado ao ambiente neptune-export.

  • Configure as permissões necessárias do IAM — Se seu banco de dados tiver a autenticação de banco de dados AWS Identity and Access Management (IAM) ativada, certifique-se de que a função sob a qual é neptune-export executada esteja associada a uma política do IAM que permite conexões com o Neptune. Para obter informações sobre políticas do Neptune, consulte Usar políticas do IAM.

    Se você quiser usar o parâmetro clusterId export nas solicitações de consulta, o perfil sob o qual o neptune-export é executado exige as seguintes permissões do IAM:

    • rds:DescribeDBClusters

    • rds:DescribeDBInstances

    • rds:ListTagsForResource

    Se você quiser exportar de um cluster clonado, o perfil sob o qual neptune-export é executado exige as seguintes permissões do IAM:

    • rds:AddTagsToResource

    • rds:DescribeDBClusters

    • rds:DescribeDBInstances

    • rds:ListTagsForResource

    • rds:DescribeDBClusterParameters

    • rds:DescribeDBParameters

    • rds:ModifyDBParameterGroup

    • rds:ModifyDBClusterParameterGroup

    • rds:RestoreDBClusterToPointInTime

    • rds:DeleteDBInstance

    • rds:DeleteDBClusterParameterGroup

    • rds:DeleteDBParameterGroup

    • rds:DeleteDBCluster

    • rds:CreateDBInstance

    • rds:CreateDBClusterParameterGroup

    • rds:CreateDBParameterGroup

    Para publicar os dados exportados no Amazon S3, o perfil sob o qual o neptune-export é executado exige as seguintes permissões do IAM para os locais do Amazon S3:

    • s3:PutObject

    • s3:PutObjectTagging

    • s3:GetObject

  • Defina a variável de ambiente SERVICE_REGION: defina a variável de ambiente SERVICE_REGION para identificar a região onde o cluster de banco de dados está localizado (consulte Connecting to Neptune para obter uma lista de identificadores de região).

Executar o utilitário neptune-export para iniciar uma operação de exportação

Use o seguinte comando para executar o neptune-export na linha de comando e iniciar uma operação de exportação:

java -jar neptune-export.jar nesvc \
  --root-path (path to a local directory) \
  --json (the JSON file that defines the export)

O comando tem dois parâmetros:

Parâmetros para neptune-export ao iniciar uma exportação

  • --root-path: caminho para um diretório no qual os arquivos de exportação são gravados antes de serem publicados no Amazon S3.

  • --json: um objeto JSON que define a exportação.

Exemplos de comando usando o utilitário de linha de comando neptune-export

Como exportar dados do grafo de propriedades diretamente do cluster de banco de dados de origem:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-pg",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)"
            }
          }'

Como exportar dados do RDF diretamente do cluster de banco de dados de origem:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-rdf",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)"
            }
          }'

Se você omitir o parâmetro de solicitação command, por padrão, o utilitário neptune-export exportará dados do grafo de propriedades do Neptune.

Como exportar de um clone do cluster de banco de dados:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-pg",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)",
              "cloneCluster" : true
            }
          }'

Como exportar do cluster de banco de dados usando a autenticação do IAM:

java -jar neptune-export.jar nesvc \
  --root-path /home/ec2-user/neptune-export \
  --json '{
            "command": "export-pg",
            "outputS3Path" : "s3://(your Amazon S3 bucket)/neptune-export",
            "params": {
              "endpoint" : "(your neptune DB cluster endpoint)"
              "useIamAuth" : true
            }
          }'