相关文章推荐
  • Neptune 工作台 允许你在完全托管的环境中运行 Jupyter 笔记本电脑,托管在亚马逊SageMaker上,并自动为你加载最新版本的 Neptune graph 笔记本项目。创建新的 Neptune 数据库时,可以轻松地在 Neptune 控制台 中设置工作台。

  • 你也可以 安装 Jupyter 或JupyterLab 在本地安装。这使您可以从笔记本电脑运行笔记本电脑,将其连接到 Neptune 或其中一个开源图形数据库的本地实例。在后一种情况下,你可以在花一分钱之前随心所欲地尝试图形技术。然后,当你准备就绪时,你可以平稳地迁移到 Neptune 提供的托管生产环境。

使用 Neptune 工作台托管 Neptune 笔记本电脑

您可以以每小时低于 0.10 美元的价格开始使用 Neptune 优惠 T3 和 T4g 实例类型。通过亚马逊向您收取工作台资源的账单SageMaker,与 Neptune 账单分开计费。请参阅 Neptune 定价页面 。在 Neptune 工作台上创建的 Jupyter 和JupyterLab笔记本电脑都使用亚马逊 Linux 2 和 3 环境。JupyterLab有关JupyterLab笔记本电脑支持的更多信息,请参阅 亚马逊SageMaker文档 。

你可以使用海王星工作台通过以下两种方式之一创建 Jupyter 或JupyterLab笔记本:AWS Management Console

使用JupyterLab笔记本菜单创建 Jupyter 或笔记本
  1. 登录AWS管理控制台,然后 通过 https://console.aws.amazon.com/neptune/home 打开亚马逊 Neptune 控制台。

  2. 在左侧的导航窗格中,选择 Notebooks (笔记本) 。

  3. 选择 Create Notebook (创建笔记本) 。

  4. 在 集群 列表中,选择您的 Neptune 数据库集群。如果您还没有数据库集群,请选择 Create cluster (创建集群) 以创建一个。

  5. 选择 笔记本实例类型 。

  6. 为您的笔记本提供一个名称以及可选的描述。

  7. 除非您已经为笔记本创建了 AWS Identity and Access Management (IAM) 角色,否则请选择 创建 IAM 角色 ,然后输入 IAM 角色名称。

    注意

    如果您选择重复使用为之前的笔记本创建的 IAM 角色,则角色策略必须包含正确的权限才能访问您正在使用的 Neptune 数据库集群。您可以通过检查 neptune-db:* 操作下的资源 ARN 中的组件是否与该集群相匹配来验证这一点。当你尝试运行笔记本魔法命令时,错误配置的权限会导致连接错误。

  8. 选择 Create Notebook (创建笔记本) 。创建过程可能需要5到10分钟才能准备就绪。

  9. 创建笔记本后,将其选中,然后选择 “ 打开 Jupyter” 或 “打开 ”。JupyterLab

控制台可以为您的笔记本创建 AWS Identity and Access Management (IAM) 角色,也可以自己创建一个。此角色的策略应包括以下内容:

"Version": "2012-10-17", "Statement": [ "Effect": "Allow", "Action": [ "s3:GetObject", "s3:ListBucket" "Resource": [ "arn:aws:s3:::aws-neptune-notebook- (AWS region) ", "arn:aws:s3:::aws-neptune-notebook- (AWS region) /*" "Effect": "Allow", "Action": "neptune-db:*", "Resource": [ "arn:aws:neptune-db: (AWS region) : (AWS account ID) : (Neptune resource ID) /*"

请注意,上述策略中的第二条语句列出了一个或多个 Neptune 集群资源 ID 。

此外,角色应建立以下信任关系:

"Version": "2012-10-17", "Statement": [ "Effect": "Allow", "Principal": { "Service": "sagemaker.amazonaws.com" "Action": "sts:AssumeRole"

同样,将一切准备就绪可能需要 5 到 10 分钟。

您可以将新笔记本配置为与 Neptune ML 配合使用,如中所述。 为 Neptune ML 手动配置 Neptune 笔记本

使用 Python 将通用SageMaker笔记本连接到 Neptune

如果你已经安装了 Neptune magics,将笔记本电脑连接到 Neptune 很容易,但是即使你没有使用 Neptune SageMaker 笔记本电脑,也可以使用 Python 将笔记本电脑连接到 Neptune。

在SageMaker笔记本电脑手机中连接海王星需要采取的步骤
  1. 安装 Gremlin Python 客户端:

    !pip install gremlinpython

    Neptune 笔记本电脑会为你安装 Gremlin Python 客户端,因此只有在你使用普通笔记本时才需要执行此步骤。SageMaker

    编写如下代码来连接和发出 Gremlin 查询:

    from gremlin_python import statics from gremlin_python.structure.graph import Graph from gremlin_python.process.graph_traversal import __ from gremlin_python.process.strategies import * from gremlin_python.driver.driver_remote_connection import DriverRemoteConnection from gremlin_python.driver.aiohttp.transport import AiohttpTransport from gremlin_python.process.traversal import * import os port = 8182 server = '(your server endpoint)' endpoint = f'wss://{server}:{port}/gremlin' graph=Graph() connection = DriverRemoteConnection(endpoint,'g', transport_factory=lambda:AiohttpTransport(call_from_event_loop=True)) g = graph.traversal().withRemote(connection) results = (g.V().hasLabel('airport') .sample(10) .order() .by('code') .local(__.values('code','city').fold()) .toList()) # Print the results in a tabular form with a row index for i,c in enumerate(results,1): print("%3d %4s %s" % (i,c[0],c[1])) connection.close()
    注意

    如果你碰巧使用的是早于 3.5.0 的 Gremlin Python 客户端版本,那么这一行:

    connection = DriverRemoteConnection(endpoint,'g', transport_factory=lambda:AiohttpTransport(call_from_event_loop=True))

    只会是:

    connection = DriverRemoteConnection(endpoint,'g')

    在 Neptune 笔记本电脑上启用CloudWatch日志

    CloudWatch现在,Neptune 笔记本电脑默认启用日志。如果您的旧笔记本无法生成CloudWatch日志,请按照以下步骤手动启用它们:

    1. 登录 AWS Management Console并打开 SageMaker 控制台 。

    2. 在左侧的导航窗格中,选择 笔记本 ,然后选择 笔记本实例 。查找要为其启用日志的 Neptune 笔记本的名称。

    3. 选择该笔记本实例的名称,进入详细信息页面。

    4. 如果笔记本实例正在运行,请选择笔记本详细信息页面右上角的 停止 按钮。

    5. 在 “ 权限和加密 ” 下,有一 个 IAM 角色 ARN 字段。选择此字段中的链接,转到此笔记本实例运行时使用的 IAM 角色。

    6. 创建以下策略:

      "Version": "2012-10-17", "Statement": [ "Effect": "Allow", "Action": [ "logs:CreateLogDelivery", "logs:CreateLogGroup", "logs:CreateLogStream", "logs:DeleteLogDelivery", "logs:Describe*", "logs:GetLogDelivery", "logs:GetLogEvents", "logs:ListLogDeliveries", "logs:PutLogEvents", "logs:PutResourcePolicy", "logs:UpdateLogDelivery" "Resource": "*"
    7. 保存此新策略并将其附加到步骤 4 中找到的 IAM 角色。

    8. 单击 n SageMaker otebook 实例详细信息页面右上角的 “ 开始 ”。

    9. 当日志开始流动时,您应该在详细信息页面 “ 笔记本实例设置 ” 部分左下角附近标有 “ 生命周期配置 ” 的字段下方看到 “ 查看日志 ” 链接。

    如果笔记本电脑无法启动,则SageMaker控制台的笔记本详细信息页面会显示一条消息,指出笔记本实例花了 5 分钟以上的时间才启动。CloudWatch可以用这个名字找到与此问题相关的日志:

    (your-notebook-name)/LifecycleConfigOnStart

    在本地计算机上设置图形笔记本

    graph-noteboot 项目包含在本地计算机上设置 Neptune 笔记本的说明:

    在海王星集群上使用海王星笔记本电脑

    如果您在后端连接到 Neptune 集群,则可能需要在 Amazon SageMaker 中运行笔记本电脑。从本地安装笔记本电脑连接到 Neptune 可能更方便,而且它SageMaker可以让你更轻松地使用 Neptune ML 。

    有关如何在中SageMaker设置笔记本的说明,请参阅 使用亚马逊启动 graph-not ebook。SageMaker

    有关如何设置和配置 Neptune 本身的说明,请参阅 设置海王星 。

    您也可以将本地安装的 Neptune 笔记本电脑连接到 Neptune 数据库集群。这可能会稍微复杂一些,因为 Amazon Neptune 数据库集群只能在亚马逊虚拟私有云 (VPC) 中创建,而该虚拟私有云 (VPC) 在设计上与外界隔离。从 VPC 外部连接到 VPC 的方法有很多。一种是使用负载均衡器。另一种是使用 VPC 对等互连(参见 Amazon 虚拟私有云对等互连指南 )。

    但是,对于大多数人来说,最便捷的方法是连接在 VPC 内设置 Amazon EC2 代理服务器,然后使用 SSH 隧道 (也称为端口转发)连接到该服务器。你可以在 grap h- GitHub notebook 项目的 additional-databases/neptune 文件夹中 在本地将 graph notebook 连接到 Amazon Neptune 中找到有关如何设置的说明。

    将 Neptune 笔记本电脑与开源图形数据库一起使用

    要免费开始使用图形技术,您还可以在后端使用带有各种开源数据库的 Neptune 笔记本电脑。例如 TinkerPop Gremlin 服务器 和 Blaz egraph 数据库。

    要使用 Gremlin Server 作为您的后端数据库,请按照以下说明进行操作:

    将你的 Neptune 笔记本从 Jupyter 迁移到 3 JupyterLab

    2022 年 12 月 21 日之前创建的 Neptune 笔记本电脑使用亚马逊 Linux 1 环境。您可以按照以下AWS博客文章中描述的步骤将在此日期之前创建的较旧 Jupyter 笔记本电脑迁移到使用 Amazon Linux 2 的新 Amazon Linux 2 环境和 JupyterLab 3 环境中: 使用 Amazon Linux 2 将您的工作迁移到亚马逊SageMaker笔记本电脑实例 。

    此外,还有一些步骤专门适用于将 Neptune 笔记本电脑迁移到新环境:

    海王星特有的先决条件

    在源 Neptune 笔记本的 IAM 角色中,添加以下所有权限:

    "Effect": "Allow", "Action": [ "s3:GetObject", "s3:ListBucket", "s3:CreateBucket", "s3:PutObject" "Resource": [ "arn:aws:s3::: (your ebs backup bucket name) ", "arn:aws:s3::: (your ebs backup bucket name) /*" "Effect": "Allow", "Action": [ "sagemaker:ListTags" "Resource": [

    请务必为要用于备份的 S3 存储桶指定正确的 ARN。

 
推荐文章