Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用亚马逊 Neptune 作为目标Amazon Database Migration Service

Amazon Neptune 是一项快速、可靠且完全托管式的图数据库服务，可帮助您轻松构建和运行适用于高度互连数据集的应用程序。Neptune 的核心是专门构建的高性能图形数据库引擎。该引擎经过优化，可存储数十亿个关系并以毫秒延迟查询图形。Neptune 支持流行的图形查询语言 ApacheTinkerPopGremlin 和 W3C 的 SPARQL。有关亚马逊 Neptune 的更多信息，请参阅什么是亚马逊海王星？在亚马逊 Neptune 用户指南。

如果没有像 Neptune 这样的图形数据库，你可能会在关系数据库中对高度连接的数据进行建模。由于数据具有潜在的动态关联，因此使用此类数据源的应用程序必须在 SQL 中为关联的数据查询建模。此方法要求您编写额外的层以将图形查询转换为 SQL。此外，关系数据库附带了架构刚度。为对更改连接建模而在架构中进行任何更改都需要停机时间以及对查询转换的额外维护，以支持新架构。查询性能也是设计应用程序时需要考虑的另一大约束。

图形数据库可大大简化此类情况。丰富的图形查询层（Gremlin 或 SPARQL）和针对图形查询优化的索引提高了灵活性和性能，可将您从架构中解放出来。Amazon Neptune 图形数据库还具有企业级功能，例如静态加密、安全授权层、默认备份、多可用区支持、只读副本支持等。

使用Amazon DMS，对于任何支持的 SQL 数据库，您可以将建模高度连接图的关系数据从 DMS 源端点迁移到 Neptune 目标端点。

有关更多详细信息，请参阅以下内容。

作为目标迁移到亚马逊 Neptune 的概述

在开始迁移到 Neptune 目标之前，请在您的中创建以下资源Amazon账户:

获得这些资源后，设置和开始迁移到 Neptune 目标与使用控制台或 DMS API 进行任何满负载迁移类似。但是，迁移到海王星目标需要一些独特的步骤。

将亚马逊 Neptune 的终端节点设置指定为目标

要创建或修改目标终端节点，您可以使用控制台，也可以使用 CreateEndpoint 或 ModifyEndpoint API 操作。

对于海王星中的目标Amazon DMS控制台，指定终端节点特定设置在创建终端节点要么修改终端节点控制台页面。对于 CreateEndpoint 和 ModifyEndpoint，指定 NeptuneSettings 选项的请求参数。以下示例显示了如何使用 CLI 执行此操作。

dms create-endpoint --endpoint-identifier my-neptune-target-endpoint
--endpoint-type target --engine-name neptune 
--server-name my-neptune-db.cluster-cspckvklbvgf.us-east-1.neptune.amazonaws.com 
--port 8192
--neptune-settings 
     '{"ServiceAccessRoleArn":"arn:aws:iam::123456789012:role/myNeptuneRole",
       "S3BucketName":"my-bucket",
       "S3BucketFolder":"my-bucket-folder",
       "ErrorRetryDuration":57,
       "MaxFileSize":100, 
       "MaxRetryCount": 10, 
       "IAMAuthEnabled":false}‘

这里是 CLI--server-name选项指定 Neptune 集群写入器端点的服务器名称。或者你可以为 Neptune 写入器实例端点指定服务器名称。

--neptune-settings 选项请求参数如下所示：

创建 IAM 服务角色以访问作为目标的亚马逊 Neptune

要将 Neptune 作为目标进行访问，请使用 IAM 创建服务角色。根据您的 Neptune 终端节点配置，将以下部分或全部 IAM 策略和信任文档附加到该角色。创建 Neptune 终端节点时，您需要提供此服务角色的 ARN。这样做会启用Amazon DMS并且 Amazon Neptune 将获得访问 Neptune 及其关联的 Amazon S3 存储桶的权限。

如果你设置了IAMAuthEnabled参数输入NeptuneSettings到true在您的 Neptune 终端节点配置中，将如下所示的 IAM 策略附加到您的服务角色。如果将 IAMAuthEnabled 设置为 false，则可忽略此策略。

// Policy to access Neptune

    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "VisualEditor0",
                "Effect": "Allow",
                "Action": "neptune-db:*",
                "Resource": "arn:aws:neptune-db:us-east-1:123456789012:cluster-CLG7H7FHK54AZGHEH6MNS55JKM/*"
            }
        ]
    }

前面的 IAM 策略允许完全访问由指定的 Neptune 目标集群Resource。

将如下所示的 IAM 策略附加到服务角色。此策略允许 DMS 将迁移的图形数据临时存储在您为批量加载到 Neptune 目标数据库而创建的 S3 存储桶中。

//Policy to access S3 bucket

{
	"Version": "2012-10-17",
	"Statement": [{
			"Sid": "ListObjectsInBucket0",
			"Effect": "Allow",
			"Action": "s3:ListBucket",
			"Resource": [
				"arn:aws:s3:::my-bucket"
			]
		},
		{
			"Sid": "AllObjectActions",
			"Effect": "Allow",
			"Action": ["s3:GetObject",
				"s3:PutObject",
				"s3:DeleteObject"
			],

			"Resource": [
				"arn:aws:s3:::my-bucket/"
			]
		},
		{
			"Sid": "ListObjectsInBucket1",
			"Effect": "Allow",
			"Action": "s3:ListBucket",
			"Resource": [
				"arn:aws:s3:::my-bucket",
				"arn:aws:s3:::my-bucket/"
			]
		}
	]
}

前面的 IAM 策略允许您的账户查询 S3 存储桶的内容 (arn:aws:s3:::my-bucket) 为你的海王星目标创建。它还允许您的账户完全操作所有存储桶文件和文件夹的内容 (arn:aws:s3:::my-bucket/)。

编辑信任关系并将以下 IAM 角色附加到您的服务角色以允许这两者兼而有之Amazon DMS并且 Amazon Neptune 数据库服务担任该角色。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "dms.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    },
    {
      "Sid": "neptune",
      "Effect": "Allow",
      "Principal": {
        "Service": "rds.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

有关为您的 Neptune 目标端点指定此服务角色的信息，请参阅将亚马逊 Neptune 的终端节点设置指定为目标。

使用亚马逊 Neptune 的 Gremlin 和 R2RML 作为目标指定图形映射规则

您创建的图形映射规则指定如何将从 SQL 关系数据库源提取的数据加载到 Neptune 数据库集群目标中。这些映射规则的格式会有所不同，具体取决于这些规则是否用于使用 Apache 加载属性图数据TinkerPop使用 R2RML 的 Gremlin 或资源描述框架 (RDF) 数据。在下文中，您可以找到有关这些格式的信息并查明可从何处了解更多信息。

在使用控制台或 DMS API 创建迁移任务时，可以指定这些映射规则。

使用控制台，使用以下命令指定这些映射规则图形映射规则在创建数据库迁移任务页面。在图形映射规则中，可以使用提供的编辑器直接输入和编辑映射规则。或者，可以浏览找到包含采用适当的图形映射格式的映射规则的文件。

借助 API，使用 CreateReplicationTask API 调用的 TaskData 请求参数指定这些选项。将 TaskData 设置为包含采用适当图形映射格式的映射规则的文件的路径。

用于通过 Gremlin 生成属性图形数据的图形映射规则

使用 Gremlin 生成属性图形数据，为要从源数据生成的每个图形实体指定一个具有映射规则的 JSON 对象。此 JSON 的格式是专门为批量加载亚马逊 Neptune 而定义的。以下模板显示了该对象中的每条规则的样子。

{
    "rules": [
        {
            "rule_id": "(an identifier for this rule)",
            "rule_name": "(a name for this rule)",
            "table_name": "(the name of the table or view being loaded)",
            "vertex_definitions": [
                {
                    "vertex_id_template": "{col1}",
                    "vertex_label": "(the vertex to create)",
                    "vertex_definition_id": "(an identifier for this vertex)",
                    "vertex_properties": [
                        {
                            "property_name": "(name of the property)",
                            "property_value_template": "{col2} or text",
                            "property_value_type": "(data type of the property)"
                        }
                    ]
                }
            ]
        },
        {
            "rule_id": "(an identifier for this rule)",
            "rule_name": "(a name for this rule)",
            "table_name": "(the name of the table or view being loaded)",
            "edge_definitions": [
                {
                    "from_vertex": {
                        "vertex_id_template": "{col1}",
                        "vertex_definition_id": "(an identifier for the vertex referenced above)"
                    },
                    "to_vertex": {
                        "vertex_id_template": "{col3}",
                        "vertex_definition_id": "(an identifier for the vertex referenced above)"
                    },
                    "edge_id_template": {
                        "label": "(the edge label to add)",
                        "template": "{col1}_{col3}"
                    },
                    "edge_properties":[
                        {
                            "property_name": "(the property to add)",
                            "property_value_template": "{col4} or text",
                            "property_value_type": "(data type like String, int, double)"
                        }
                    ]
                }
            ]
        }
    ]
}
 

存在顶点标签意味着在此处创建了顶点。没有顶点标签意味着顶点是由其他源创建的，并且此定义仅添加顶点属性。指定所需数量的顶点和边定义，以便指定整个关系数据库源的映射。

employee 表的示例规则如下所示。

{
    "rules": [
        {
            "rule_id": "1",
            "rule_name": "vertex_mapping_rule_from_nodes",
            "table_name": "nodes",
            "vertex_definitions": [
                {
                    "vertex_id_template": "{emp_id}",
                    "vertex_label": "employee",
                    "vertex_definition_id": "1",
                    "vertex_properties": [
                        {
                            "property_name": "name",
                            "property_value_template": "{emp_name}",
                            "property_value_type": "String"
                        }
                    ]
                }
            ]
        },
        {
            "rule_id": "2",
            "rule_name": "edge_mapping_rule_from_emp",
            "table_name": "nodes",
            "edge_definitions": [
                {
                    "from_vertex": {
                        "vertex_id_template": "{emp_id}",
                        "vertex_definition_id": "1"
                    },
                    "to_vertex": {
                        "vertex_id_template": "{mgr_id}",
                        "vertex_definition_id": "1"
                    },
                    "edge_id_template": {
                        "label": "reportsTo",
                        "template": "{emp_id}_{mgr_id}"
                    },
                    "edge_properties":[
                        {
                            "property_name": "team",
                            "property_value_template": "{team}",
                            "property_value_type": "String"
                        }
                    ]
                }
            ]
        }
    ]
}
 

在此处，顶点和边定义映射来自具有员工 ID (EmpID) 的 employee 节点和具有经理 ID (managerId) 的 employee 节点的报告关系。

有关使用 Gremlin JSON 创建图形映射规则的更多信息，请参阅Gremlin 加载数据格式在亚马逊 Neptune 用户指南。

用于生成 RDF/SPARQL 数据的图形映射规则

如果要加载将使用 SPARQL 查询的 RDF 数据，请使用 R2RML 编写图形映射规则。R2RML 是用于将关系数据映射到 RDF 的标准 W3C 语言。在 R2RML 文件中，三重映射（例如，下面的 <#TriplesMap1>）指定用于将逻辑表的每个行转换为零个或更多 RDF 三元组的规则。主题映射（例如，下面的任意 rr:subjectMap）指定了一个规则，用于生成由三元组映射生成的 RDF 三元组的主题。谓词-对象映射（例如，下面的任意 rr:predicateObjectMap）是一个函数，用于为逻辑表的每个逻辑表行创建一个或多个谓词-对象对。

下面是 nodes 表的简单示例。

@prefix rr: <http://www.w3.org/ns/r2rml#>.
@prefix ex: <http://example.com/ns#>.

<#TriplesMap1>
    rr:logicalTable [ rr:tableName "nodes" ];
    rr:subjectMap [
        rr:template "http://data.example.com/employee/{id}";
        rr:class ex:Employee;
    ];
    rr:predicateObjectMap [
        rr:predicate ex:name;
        rr:objectMap [ rr:column "label" ];
    ]

在上一个示例中，映射定义了从员工表映射的图形节点。

下面是 Student 表的另一个简单示例。

@prefix rr: <http://www.w3.org/ns/r2rml#>.
@prefix ex: <http://example.com/#>.
@prefix foaf: <http://xmlns.com/foaf/0.1/>.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#>.

<#TriplesMap2>
    rr:logicalTable [ rr:tableName "Student" ];
    rr:subjectMap   [ rr:template "http://example.com/{ID}{Name}";
                      rr:class foaf:Person ];
    rr:predicateObjectMap [
        rr:predicate ex:id ;
        rr:objectMap  [ rr:column "ID";
                        rr:datatype xsd:integer ]
    ];
    rr:predicateObjectMap [
        rr:predicate foaf:name ;
        rr:objectMap  [ rr:column "Name" ]
    ].

在前面的示例中，映射定义了图形节点映射friend-of-a-friend人与人之间的关系Student桌子。

有关使用 SPARQL R2RML 创建图形映射规则的更多信息，请参阅 W3C 规范 R2RML：RDB 到 RDF 映射语言。

Gremlin 和 R2RML 迁移到亚马逊 Neptune 作为目标的数据类型

Amazon DMS通过以下两种方式之一执行从 SQL 源端点到 Neptune 目标的数据类型映射。你使用哪种方式取决于你用来加载 Neptune 数据库的图形映射格式：

有关这两种图形映射格式的更多信息，请参阅使用亚马逊 Neptune 的 Gremlin 和 R2RML 作为目标指定图形映射规则。

在下文中，您可以找到每种格式的数据类型映射的描述。

SQL 源到 Gremlin 目标数据类型映射

下表显示了从 SQL 源到 Gremlin 格式化目标的数据类型映射。

Amazon DMS 将任何未列出的 SQL 源数据类型映射到 Gremlin String。

有关用于加载 Neptune 的 Gremlin 数据类型的更多信息，请参见Gremlin 数据类型在海王星用户指南。

SQL 源到 R2RML (RDF) 目标数据类型映射

下表显示了从 SQL 源到 R2RML 格式化目标的数据类型映射。

所有列出的 RDF 数据类型都区分大小写，但 RDF 文本除外。Amazon DMS 将任何未列出的 SQL 源数据类型映射到 RDF 文本。

RDF 文本 是多种文本词汇形式和数据类型之一。有关更多信息，请参见RDF 文字在 W3C 规范中资源描述框架 (RDF)：概念和抽象语法。

有关用于加载 Neptune 的 RDF 数据类型及其与 SQL 源数据类型的映射的更多信息，请参见数据类型转换在 W3C 规范中R2RML：RDB 到 RDF 的映射语言。

使用亚马逊 Neptune 作为目标的局限性

使用 Neptune 作为目标时存在以下限制：