Serverless 入門（六）- DynamoDB 數(shù)據(jù)庫（上）

0. DynamoDB 是什么

Amazon DynamoDB 是一種完全托管的 NoSQL 數(shù)據(jù)庫服務叫乌，提供快速而可預測的性能织鲸，能夠?qū)崿F(xiàn)無縫擴展萌抵。我們可以使用 DynamoDB 創(chuàng)建一個數(shù)據(jù)庫表來存儲和檢索任何大小的數(shù)據(jù)棍丐，并處理任何級別的請求流量渠牲。DynamoDB 可自動將表的數(shù)據(jù)和流量分布到足夠多的服務器中，以處理客戶指定的請求容量和數(shù)據(jù)存儲量泌参，同時保持一致的性能和高效的訪問脆淹。

1. DynamoDB 核心組件

在 DynamoDB 中，tables沽一、items 和 attributes 是您使用的核心組件盖溺。table 是 items 的集合，而每個item是 attributes 的集合铣缠。DynamoDB 使用主鍵來唯一標識表中的每個項目烘嘱，并且使用二級索引來提供更大的查詢靈活性。您可以使用 DynamoDB 流捕獲 DynamoDB 表中的數(shù)據(jù)修改事件

Table – 類似于其他數(shù)據(jù)庫系統(tǒng)蝗蛙，DynamoDB 將數(shù)據(jù)存儲在表中蝇庭。Table是數(shù)據(jù)的集合。例如 People 表捡硅，該表可用于存儲有關好友哮内、家人或關注的任何其他人的個人聯(lián)系信息。

Item – 類似于數(shù)據(jù)行壮韭，具有不同于所有其他項目的唯一標識北发。在 People 表中，每個Item表示一位人員喷屋。

Attribute – 每個Item包含一個或多個attributes琳拨。Attributes 是基礎的數(shù)據(jù)元素，無需進一步分解屯曹。例如狱庇，People 表中的一個Item包含名為 PersonID、LastName恶耽、FirstName 等的屬性僵井。

2. 創(chuàng)建項目

serverless create --template aws-nodejs-typescript --path helloDynamoDB，從這篇開始驳棱，我們使用 TypeScript 模板來學習 Serverless 技術批什。

3. 配置數(shù)據(jù)庫環(huán)境

Amazon 還是一個良心公司，提供了本地測試數(shù)據(jù)庫來模擬線上 DynamoDB社搅，從而減少開發(fā)期間的賬單費用驻债，提升開發(fā)效率（操作本地數(shù)據(jù)庫肯定要比線上快）。

下載DynamoDB Local形葬，亞洲有這么兩個地址：
新加坡：https://s3-ap-southeast-1.amazonaws.com/dynamodb-local-singapore/dynamodb_local_latest.zip
東京：https://s3-ap-northeast-1.amazonaws.com/dynamodb-local-tokyo/dynamodb_local_latest.zip

注：如果想運行.jar 文件合呐，電腦上必須安裝了 Java 6 以上運行環(huán)境。在 Terminal 里執(zhí)行 java -version 來檢查自己的電腦環(huán)境

kenny@Kennys-MacBook-Pro ~/Downloads/dynamodb_local_latest $ java -version
java version "1.8.0_181"
Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)

解壓 dynamodb_local_latest.zip 文件笙以，然后進入該目錄淌实，如圖：
啟動本地 DynamoDB 數(shù)據(jù)庫

在解壓后的當前目錄執(zhí)行： java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb --port 8000

默認占用電腦的8000端口，如圖所示：

啟動成功后，就不要關這個 Terminal拆祈，一關 Terminal 數(shù)據(jù)庫服務也跟著關了恨闪。

連接數(shù)據(jù)庫
官方暫時（截止2019-3-15）沒有提供 GUI 客戶端，但 github 上已有好心人提供放坏，地址：
https://github.com/touchduck/dynamon

啟動 DynamoDB 軟件客戶端后咙咽，建議如圖填寫：

注意：我們這次使用的是本地數(shù)據(jù)庫，所以 AWS Access Key ID 和 AWS Secret Key 可以隨意填寫淤年，只要別空著就行

AWS Region钧敞、 AWS Access Key ID 和 AWS Secret Key 是如何獲得？見：Serverless 入門（一） - 創(chuàng)建 IAM

我們在軟件客戶端看不到任何數(shù)據(jù)麸粮，如圖所示：

連接后默認是沒有數(shù)據(jù)的溉苛，接下來我們用 Node.js 代碼來做 CRUD 操作。

4.操作本地數(shù)據(jù)庫

添加 aws-sdk 包弄诲，yarn add aws-sdk
添加 serverless-offline 包愚战，yarn add serverless-offline -D
創(chuàng)建 model，新建名為 models/movie.ts 文件

export const modelsMovie = {
  AttributeDefinitions: [ // 主鍵數(shù)據(jù)類型
    { AttributeName: "year", AttributeType: "N" }, // N Number
    { AttributeName: "title", AttributeType: "S" },   // S String
  ],
  KeySchema: [       // 主鍵
    { AttributeName: "year", KeyType: "HASH" },  // Partition key 分區(qū)鍵
    { AttributeName: "title", KeyType: "RANGE" },  // Sort key 排序鍵
  ],
  ProvisionedThroughput: { // DynamoDB 吞吐量配置
    ReadCapacityUnits: 20,
    WriteCapacityUnits: 20,
  },
  TableName: "Movies", // 表名
};

創(chuàng)建 client威根，新建名為 dynamo-client.ts 文件

import { DynamoDB } from "aws-sdk";

const getDynamoClient = (event, port = 8000) => {
  if ("isOffline" in event && event.isOffline) {
    return new DynamoDB({ endpoint: `http://localhost:${port}` });
  }
  return new DynamoDB();
};

export default getDynamoClient;

創(chuàng)建建表代碼凤巨，新建名為 table.ts 文件

import { APIGatewayProxyHandler } from 'aws-lambda';
import 'source-map-support/register';
import getDynamoClient from "./dynamo-client";
import { modelsMovie } from "./models/movie";

export const create: APIGatewayProxyHandler = async (event) => {
  const dynamodb = getDynamoClient(event);
  try {
    const { TableDescription = {} } = await dynamodb.createTable(modelsMovie).promise();
    return {
      body: JSON.stringify({
        creationDateTime: TableDescription.CreationDateTime,
        tableStatus: TableDescription.TableStatus,
        tableName: TableDescription.TableName,
        message: 'Table create successfully!',
      }),
      statusCode: 200,
    };
  } catch (e) {
    return {
      body: JSON.stringify(e),
      statusCode: 500,
    };
  }
};

配置 serverless.yml，全部配置如下：

service:
  name: helloDynamoDB

plugins:
  - serverless-webpack
  - serverless-offline # 用于離線調(diào)試

provider:
  name: aws
  runtime: nodejs8.10
  stage: dev
  region: ap-northeast-2

functions:
  hello:
    handler: handler.hello
    events:
      - http:
          method: get
          path: hello
  createTable:
    # table.ts 文件放到 src 里了洛搀，所以要加 src
    handler: src/table.create
    events:
      - http:
          method: get
          path: create  # create 是路由名稱

代碼都寫完了敢茁，來驗證一下吧！

5. 創(chuàng)建數(shù)據(jù)表

如果 DynamoDBLocal 數(shù)據(jù)庫服務器關了留美，進入 dynamodb_local_latest 目錄下彰檬，再次啟動 java -Djava.library.path=./dynamodb_local_latest/DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb --port 8000
在項目根目錄下執(zhí)行 serverless offline --useSeparateProcesses 啟動 serverless 服務
然后瀏覽器輸入 http://localhost:3000/create