访问数据库是指在函数计算中通过函数调用数据库应用编程接口,对数据库执行数据插入、查询等操作。通常函数计算中不同的执行环境实例之间的状态是不共享的,通过数据库可以将结构化的数据持久化以实现状态共享。本文以Python 3为例,介绍如何使用Serverless Devs部署函数来访问MongoDB数据库。

前提条件

  • 创建适合业务需求的云数据库MongoDB实例:
    重要
    • 请确保您所创建的数据库实例与需要访问该数据库实例的函数在同一地域。

    • 建议您在函数计算支持的可用区创建数据库实例。更多信息,请参见函数计算支持的可用区

      如果您的数据库实例不在函数计算支持的可用区内,可以通过在您的VPC环境中创建一个与函数计算相同可用区的vSwitch,并在函数计算的服务的VPC配置中设置此vSwitch ID。由于同一VPC内不同vSwitch之间私网互通,因此函数计算可以通过该vSwitch访问在其他可用区的VPC内的资源。具体步骤,请参见遇到vSwitch is in unsupported zone的错误怎么办?

  • 创建名为test-db的数据库和名为fc_col的数据库集合。

    本文示例中,s init初始化的模板代码中的代码逻辑为向名为test-db的数据库的fc-col集合中插入一条文档数据;其中,test-db为环境变量MONGO_DATABASE的取值。

步骤一:配置数据库访问IP地址白名单

请使用IP地址白名单来实现安全访问,请勿使用安全组。否则,可能会导致函数连接不稳定的情况,影响业务正常运行。

说明 本文以分片集群实例为例。添加IP地址白名单的详细步骤,请参见设置白名单
  1. 登录云数据库MongoDB
  2. 在顶部菜单栏,选择地域。
  3. 在左侧导航栏,单击分片集群实例列表
  4. 分片集群实例列表页面,找到目标实例,并单击其名称。
  5. 在左侧导航栏,选择数据安全性 > 白名单设置
  6. 白名单设置页面,找到白名单分组名,在其操作列,单击更多图标,在下拉菜单中,选择手动修改
  7. 手动修改面板,按需填写IP地址,单击确定
    重要 此处填写的IP地址,需为在函数计算服务的网络配置中添加的vSwitch的IP段。

步骤二:部署并调试函数

  1. 安装Serverless Devs和Docker,并添加密钥信息。
  2. 执行以下命令初始化项目。
    s init start-fc-mongodb-python -d start-fc-mongodb-python
  3. 执行以下命令进入项目。
    cd start-fc-mongodb-python
  4. 编辑s.yaml文件。

    示例如下:

    edition: 1.0.0
    name: fcDeployApp
    access: "default"
    
    services:
      fc-db-mongodb-python:
        component: devsapp/fc
        props:
          region: cn-hangzhou
          service:
            name: fc-db-demo
            description: 'demo for fc visit db'
            internetAccess: true
            vpcConfig:
              vpcId: vpc-bp1hcg467ekqsv0zr**** # 数据库实例所在的VPC ID。
              securityGroupId: sg-bp1j6knvj40yjn0g**** # 安全组ID。
              vswitchIds:
                - vsw-bp1lgecrqfslgji9b**** # 请确保该vSwitch对应的网段已配置到数据库实例访问白名单中。
          function:
            name: mongodb
            description: visit mongodb
            runtime: python3
            codeUri: ./code
            handler: index.handler
            memorySize: 256
            timeout: 60
            environmentVariables:
              MONGO_DATABASE: test-db # 数据库名称。
              MONGO_URL: mongodb://m****:Hang****@s-bp1a2d6c391e****.mongodb.rds.aliyuncs.com:37** # 数据库接入点。
  5. 执行以下命令构建项目。
    s build --use-docker
  6. 执行以下命令部署项目。
    s deploy -y
  7. 执行以下命令调用函数。
    s invoke -e "{}"

    预期输出如下:

    [2021-09-22T22:25:58.139] [INFO ] [S-CLI] - Start ...
    ========= FC invoke Logs begin =========
    FC Invoke Start RequestId: b361814a-0a70-4511-8212-6739389d3ca4
    find documents:{'_id': ObjectId('614b3ccea90d5fbfc262e918'), 'DEMO': 'FC', 'MSG': 'Hello FunctionCompute For MongoDB'}
    FC Invoke End RequestId: b361814a-0a70-4511-8212-6739389d3ca4
    
    Duration: 61.27 ms, Billed Duration: 62 ms, Memory Size: 256 MB, Max Memory Used: 51.21 MB
    ========= FC invoke Logs end =========
    
    FC Invoke Result:
    {'_id': ObjectId('614b3ccea90d5fbfc262e918'), 'DEMO': 'FC', 'MSG': 'Hello FunctionCompute For MongoDB'}
    
    
    End of method: invoke

示例代码

函数计算Python访问MongoDB数据库