在函数计算中,不同的执行环境实例之间的状态是不共享的,通过数据库可以将结构化的数据持久化以实现状态共享。通过函数计算访问云上数据库,您可以进行数据查询和数据插入等操作。本文以Python 3为例,介绍如何在同VPC或跨VPC跨地域访问云数据库 RDS SQL Server 版。
前提条件
本文中index.py示例代码中的逻辑是查询名为users的数据库表中的所有数据,您可以根据实际情况修改表名,并确保表内至少有一条数据。
操作步骤
步骤一:设置数据库白名单
场景一:访问同VPC内的SQL Server数据库
请确保您所创建的数据库实例与需要访问该数据库实例的函数在同一地域。
您在函数计算支持的可用区创建数据库实例。更多信息,请参见函数计算支持的可用区。
如果您的数据库实例不在函数计算支持的可用区内,可以通过在您的VPC环境中创建一个与函数计算相同可用区的vSwitch,并在函数计算的服务的VPC配置中设置此vSwitch ID。由于同一VPC内不同vSwitch之间私网互通,因此函数计算可以通过该vSwitch访问在其他可用区VPC内资源。具体步骤,请参见遇到vSwitch is in unsupported zone的错误怎么办?。
登录RDS管理控制台,在上方选择地域,然后单击目标实例ID,单击基本信息,单击专有网络后的查看连接详情,查看SQL Server的专有网络信息。
登录函数计算控制台,创建Python Web函数,为函数开通VPC访问能力,并配置目标VPC资源。
说明请确保为函数配置的VPC与数据库实例绑定的VPC相同。
在函数详情页,依次选择
,然后在网络页面获取函数配置中的交换机网段。将上一步获取的函数配置中交换机的网段添加到访问白名单。
重要请使用设置IP地址白名单方式授权函数访问数据库,请勿使用安全组方式。否则,可能导致函数偶尔连接不上数据库的情况,影响业务正常运行。
登录RDS管理控制台,在上方选择地域,然后单击目标实例ID。
在实例详情页的左侧导航栏,选择白名单与安全组,在白名单设置页签,找到目标白名单模板名称,单击右侧修改。
在弹出的修改白名单分组面板中,在组内白名单输入框输入目标实例绑定的vSwitch的IP地址段,然后单击确定。
完成配置后,函数可以通过数据库内网地址访问SQL Server数据库。
场景二:跨VPC或跨地域访问SQL Server数据库
不同VPC和不同地域之间属于完全的逻辑隔离,常规情况下,不能跨VPC和跨地域访问数据库。如果需要跨VPC或跨地域访问数据库,可以通过为函数配置固定公网IP的方式,此时系统会在函数绑定的专有网络VPC内创建公网NAT网关,通过公网网关即可实现通过公网IP访问数据库。
登录RDS管理控制台,在上方选择地域,然后单击目标实例ID,单击基本信息,单击专有网络后的查看连接详情,查看SQL Server的专有网络信息。
登录函数计算控制台,创建Python Web函数,在函数详情页,依次选择 ,在网络面板,为函数配置固定公网IP,然后单击部署。
在弹出的固定公网IP配置对话框,勾选提示框,然后单击确定。配置完成后,将参数允许函数默认网卡访问公网设置为否,使配置的固定公网IP生效,更多详情请参见配置固定公网IP地址。
说明将参数允许函数默认网卡访问公网设置为否后使得固定公网IP生效。函数计算会禁用默认网卡,从而强制使流量通过 VPC 绑定的网卡访问外网。
在函数详情页,依次选择
,然后在网络页面获取函数配置的固定公网IP地址。将上一步获取的函数固定公网IP地址添加到访问白名单。
重要请使用设置IP地址白名单方式授权函数访问数据库,请勿使用安全组方式。否则,可能导致函数偶尔连接不上数据库的情况,影响业务正常运行。
登录RDS管理控制台,在上方选择地域,然后单击目标实例ID。
在左侧导航栏,选择白名单与安全组,在白名单设置页签,找到目标白名单模板名称,单击右侧的修改。
在弹出的修改白名单分组面板中,在组内白名单输入框输入要绑定的固定公网IP地址,然后单击确定。
完成配置后,函数可以通过数据库公网地址访问SQL Server数据库。
步骤二:在函数中访问SQL Server数据库
登录函数计算控制台,在函数列表找到目标函数,在函数详情页,单击代码页签,在代码编辑器根据数据库表编写如下示例代码。
from flask import Flask, jsonify import os import pymssql # 需先安装pymssql库 from datetime import datetime app = Flask(__name__) # 全局变量用于存储数据库单例连接 _mssql_connection = None # 创建数据库连接(单例模式) def getConnection(): global _mssql_connection try: # 如果连接已经存在且未断开,直接返回 if _mssql_connection is not None: try: # 测试连接是否有效(简单命令测试) with _mssql_connection.cursor() as cursor: cursor.execute("SELECT 1") # 简单查询测试连接状态 result = cursor.fetchone() if result and result[0] == 1: return _mssql_connection except pymssql.OperationalError: # 如果连接断开,重置连接 _mssql_connection = None # 如果连接不存在或已断开,重新创建连接 _mssql_connection = pymssql.connect( host=os.environ['MSSQL_SERVER'], port=int(os.environ['MSSQL_PORT']), user=os.environ['MSSQL_USER'], password=os.environ['MSSQL_PASSWORD'], database=os.environ['MSSQL_DATABASE'], charset='utf8' ) return _mssql_connection except Exception as e: print(f"ERROR: Unexpected error: Could not connect to SQL Server instance: {e}") raise @app.route('/', defaults={'path': ''}) @app.route('/<path:path>', methods=['GET', 'POST', 'PUT', 'DELETE']) def hello_world(path): conn = getConnection() try: with conn.cursor() as cursor: # 查询 users 表的所有记录,users 表需要根据实际表名进行修改 cursor.execute("SELECT * FROM users") result = cursor.fetchall() columns = [desc[0] for desc in cursor.description] # 获取字段名列表 # 将查询结果转换为字典列表 users = [] for row in result: user = {} for idx, column_name in enumerate(columns): value = row[idx] if isinstance(value, datetime): # 处理日期类型字段 user[column_name] = value.strftime('%Y-%m-%d %H:%M:%S') else: user[column_name] = value users.append(user) if users: # 返回所有用户的 JSON 响应 return jsonify(users), 200 else: # 如果没有找到用户,返回 404 错误 return jsonify({'error': 'No users found'}), 404 finally: # 不需要关闭连接,因为使用了单例模式 pass if __name__ == '__main__': app.run(host='0.0.0.0', port=9000)
为函数安装所需依赖:
pip3 install -t . pymssql
,点击部署代码使依赖生效。详细步骤请参见通过控制台Web IDE终端安装依赖。在函数详情页,依次选择
,单击编辑,在环境变量面板配置以下环境变量。环境变量名称
环境变量值
说明
MSSQL_SERVER
rm-bp*****wn.sqlserver.rds.aliyuncs.com
数据库实例的访问地址,如果您选择同VPC内的SQL Server数据库的场景,请将此环境变量值设置为数据库的内网地址。如果您选择跨VPC或跨地域访问SQL Server数据库的场景,请将此环境变量值设置为数据库的外网地址。
访问实例列表,在上方选择地域,然后单击目标实例ID。在左侧导航栏单击数据库连接,在数据库连接信息区域获取连接数据库的连接地址信息。
MSSQL_PORT
1433
数据库内网端口号
MSSQL_USER
*****
SQL Server实例中创建的账号名称。
MSSQL_PASSWORD
*****
数据库密码
MSSQL_DATABASE
*****
实例中创建的数据库名称。
在函数详情页,选择代码页签,单击测试函数,执行成功后查看返回结果。
更多信息
更多访问RDS SQL Server数据库的示例,请参见函数计算Python访问SQL Server数据库。
关于如何查看函数计算配置的交换机信息以及如何在RDS MySQL数据库放行函数计算的交换机网段,请分别参见配置网络和SQL Server设置白名单。
如果数据库访问失败,需根据问题现象进行排查,详情请参见数据库访问失败的常见原因。
如果您希望使用Serverless Devs命令行工具创建函数并访问云数据库 RDS SQL Server 版的数据库,请参见以下步骤。