本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
通过 Python 使用 IAM 身份验证连接到 Amazon Neptune 数据库
这个 boto3 neptunedata 客户端提供了最简单的连接方式 IAM-enabled 来自 Python 的海王星数据库。客户端会自动处理签名版本 4 签名,因此您无需自己签署请求。
先决条件
Python 3.x
这个
boto3图书馆:pip install boto3Amazon 通过任何标准方法配置的凭据(环境变量, Amazon 配置文件、实例配置文件或 Lambda 执行角色)
允许 IAM 的策略
neptune-db:*在 Neptune 集群上执行的操作
使用默认凭据连接
这种方法在以下情况下有效 boto3 可以自动解析证书,例如在带有实例配置文件的 Amazon 弹性计算云实例上 Amazon Lambda 函数,或已配置的 Amazon 配置文件。
将终端节点 URL 替换为您的 Neptune 集群终端节点。
Gremlin 和 OpenCypher
import boto3 from botocore.config import Config cfg = Config(retries={"total_max_attempts": 1, "mode": "standard"}, read_timeout=None) neptune = boto3.client('neptunedata', config=cfg, region_name='us-east-1', endpoint_url='https://your-neptune-endpoint:8182') # Gremlin resp = neptune.execute_gremlin_query(gremlinQuery='g.V().limit(1)') print(resp['result']) # openCypher resp = neptune.execute_open_cypher_query(openCypherQuery='MATCH (n) RETURN n LIMIT 1') print(resp['results'])
SPARQL
这个 boto3 neptunedata 客户端目前不支持 SPARQL。将 SPARQL 查询发送到 IAM-enabled Neptune 数据库,使用签名版本 4 手动签署请求 botocore 请求签名实用程序和 requests 图书馆(pip install boto3 requests)。
import requests from botocore.auth import SigV4Auth from botocore.awsrequest import AWSRequest from botocore.session import Session endpoint = 'https://your-neptune-endpoint:8182' region = 'us-east-1' query = 'SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 1' request = AWSRequest(method='POST', url=f'{endpoint}/sparql/', data={'query': query}) SigV4Auth(Session().get_credentials(), 'neptune-db', region).add_auth(request) resp = requests.post(f'{endpoint}/sparql/', headers=request.headers, data={'query': query}) print(resp.json())
此示例使用 botocore.session.Session 来解决 Amazon 自动从环境变量中获取证书, Amazon 配置文件、实例配置文件或 Lambda 执行角色。您无需明确设置凭证。
使用临时凭证
要进行跨账户访问、限时会话,或者作为避免长效证书的安全最佳实践,请使用 Amazon STS 获取临时证书并创建 boto3.Session。
Gremlin 和 OpenCypher
import boto3 from botocore.config import Config sts = boto3.client('sts') creds = sts.assume_role( RoleArn='arn:aws:iam::123456789012:role/NeptuneRole', RoleSessionName='neptune-session' )['Credentials'] session = boto3.Session( aws_access_key_id=creds['AccessKeyId'], aws_secret_access_key=creds['SecretAccessKey'], aws_session_token=creds['SessionToken'], region_name='us-east-1' ) cfg = Config(retries={"total_max_attempts": 1, "mode": "standard"}, read_timeout=None) neptune = session.client('neptunedata', config=cfg, endpoint_url='https://your-neptune-endpoint:8182') # Gremlin resp = neptune.execute_gremlin_query(gremlinQuery='g.V().limit(1)') print(resp['result']) # openCypher resp = neptune.execute_open_cypher_query(openCypherQuery='MATCH (n) RETURN n LIMIT 1') print(resp['results'])
临时证书在指定的间隔(默认值为 1 小时)后过期,并且不会由客户端自动刷新。对于长时间运行的应用程序,请改用基于配置文件的凭证或实例配置文件。
SPARQL
因为 boto3 neptunedata 客户端当前不支持 SPARQL,您必须使用临时证书手动签署请求。
import boto3 import requests from botocore.auth import SigV4Auth from botocore.awsrequest import AWSRequest from botocore.credentials import ReadOnlyCredentials sts = boto3.client('sts') creds = sts.assume_role( RoleArn='arn:aws:iam::123456789012:role/NeptuneRole', RoleSessionName='neptune-session' )['Credentials'] endpoint = 'https://your-neptune-endpoint:8182' region = 'us-east-1' query = 'SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 1' request = AWSRequest(method='POST', url=f'{endpoint}/sparql/', data={'query': query}) SigV4Auth(ReadOnlyCredentials( creds['AccessKeyId'], creds['SecretAccessKey'], creds['SessionToken'] ), 'neptune-db', region).add_auth(request) resp = requests.post(f'{endpoint}/sparql/', headers=request.headers, data={'query': query}) print(resp.json())
与一起使用 Amazon Lambda
在 Lambda 中,执行角色通过以下方式自动提供证书 boto3。默认凭证示例无需修改即可运行。
有关包含连接管理和重试逻辑的完整 Lambda 示例,请参阅 Amazon Lambda 亚马逊 Neptune 的函数示例。