tencent cloud

All product documents
Serverless Application Center
DocumentationServerless Application CenterPractical Tutorial Connecting to Serverless DBConnecting to NoSQL
Connecting to NoSQL
Download PDF
Last updated: 2024-12-02 11:16:20
Connecting to NoSQL
Last updated: 2024-12-02 11:16:20
Download PDF

Operation Scenarios

You can use the Serverless Framework component to create, deploy, and manage a Serverless DB instance easily and connect to and access the database through the SCF SDK. Based on the serverless services in the cloud, you can conveniently develop and rapidly deploy your business with "zero" configuration so as to implement it more easily.
Currently, Serverless Framework supports connecting to and deploying two types of databases: PostgreSQL and NoSQL. This document describes how to use an SCF function to connect to a NoSQL database.

Prerequisites

You have installed Serverless Framework on at least the following versions; otherwise, please install it as instructed in Installing Serverless Framework.
Framework Core: 1.67.3
Plugin: 3.6.6
SDK: 2.3.0
Components: 2.30.1

Notes

Please make sure that the executing role of SLS_QcsRole under your account has been granted the QcloudTCBFullAccess permission; otherwise, please go to the CAM Console to configure it.
Currently, TCB allows you to create/terminate an environment for up to 4 times per month. Please create an environment with caution, as an error will be reported if the limit is exceeded.

Directions

This document uses a function in the Node.js programming language as an example to describes how to use the Serverless Framework component to write and create a function and use it to create and access a NoSQL database. The configuration process is as follows:
1. Configure identity information: configure the Tencent Cloud account information locally.
2. Create a TCB environment configuration file: use the Serverless Framework component to create a TCB environment and create and use a NoSQL database in the environment.
3. Write business code: use the Serverless DB SDK to call the database. SCF allows you to directly call the Serverless DB SDK to create and manage a NoSQL database.
4. Deploy and debug: use Serverless Framework to deploy the project in the cloud and test it in the SCF Console.
5. Remove project: you can use Serverless Framework to remove the project.

Configuring identity information

1. Create a local directory to store code and dependent modules. This document uses the test-NoSQL folder as an example.
2. Serverless Framework allows you to configure identity information in the following two ways. Please choose one as needed:
Run the following command for authentication:
serverless login
Create a .env file in test-NoSQL and configure the corresponding Tencent Cloud SecretId and SecretKey as follows:
# .env
TENCENT_SECRET_ID=xxx  // `SecretId` of your account
TENCENT_SECRET_KEY=xxx // `SecretKey` of your account
Note:
If you don't have a Tencent Cloud account yet, please sign up first.
If you already have a Tencent Cloud account, please make sure that your account has been granted the AdministratorAccess permission. In addition, you can get SecretId and SecretKey in API Key Management.

Creating TCB environment configuration file

1. Create a DB folder in test-NoSQL.
2. Create a serverless.yml file in the DB folder and enter the following content to use the Serverless Framework component to configure the TCB environment:
# serverless.yml 
component: mongodb
name: mongoDBDemoMongo
org: anycodes
app: mongoDBAPP
stage: dev
inputs:
  name: Mydemo

Writing business code

1. Create a function folder in test-NoSQL to store the business logic code and relevant dependencies.
2. Create an src folder in the function folder, enter it on the command line, and run the following command to install the TCB dependency package:
npm install --save tcb-admin-node@latest
3. Create an index.js file in the src folder and enter the following sample code, so that you can use the Serverless TCB SDK to call the TCB environment through the function and call the NoSQL database in the environment:
const tcb = require('tcb-admin-node')
const app = tcb.init({
 secretId: process.env.SecretId,
 secretKey: process.env.SecretKey,
 env: process.env.MongoId,
 serviceUrl: 'https://tcb-admin.tencentcloudapi.com/admin'
})
const db = app.database()
const _ = db.command
exports.main = async (event, context) => {
 await db.createCollection('serverless')
 const username = 'serverless'
 const collection = db.collection('serverless')
 if (username) {
         await collection.add({username: username})
             }
     const userList = await collection.get()
     return userList
}
4. After writing the business code, create a serverless.yml file and enter your SecretId and SecretKey in the environment variables.
Note:
If you use the following configuration, a TCB environment will be created free of charge. If you already have a free TCB environment, please enter its ID in MongoId; otherwise, an error will be reported. 
component: scf
name: mongoDBDemoSCF
org: anycodes
app: mongoDBAPP
stage: dev
inputs:
  name: MongoDBDemo
  src: ./src
  runtime: Nodejs8.9
  region: ap-guangzhou
  handler: index.main
  environment:
    variables:
      SecretId: enter your `SecretId`
      SecretKey: enter your `SecretKey`
      MongoId: ${output:${stage}:${app}:mongoDBDemoMongo.EnvId}

Deploying and debugging

1. Run the following command for deployment in test-NoSQL on the command line:
sls deploy --all
If the following result is returned, the deployment is successful:
serverless ⚡ framework
mongoDBDemoMongo:
  Region:    ap-guangzhou
  Name:      Mydemo
  EnvID:     Mydemo-dyxfxv
  FreeQuota: basic
mongoDBDemoSCF: 
  FunctionName: MongoDBDemo
  Description:  
    Namespace:    default
    Runtime:      Nodejs8.9
    Handler:      index.main
    MemorySize:   128
25s › tcbdemo › Success
2. After the deployment succeeds, you can view and debug the function in the SCF Console. For more information on the test steps, please see Cloud Test. The test success result is as shown below:


Note:
You can also use Serverless Dashboard to monitor the deployed project in real time with ease.

Removing project

Run the following command in the test-NoSQL directory to remove the project:
sls remove --all
If the following result is returned, the removal is successful:
serverless ⚡ framework
4s › test-NoSQL › Success

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon