建立叢集啟用資料 API 建立資料庫及資料表 GraphQL 模式設定解析程式執行變動執行查詢輸入清理

教學課程：將 Aurora 無伺服器搭配 AWS AppSync

AWS AppSync 提供資料來源，用SQL於對已透過資料啟用的 Amazon Aurora 無伺服器叢集執行命令。API您可以使用 AppSync 解析器對API具有 GraphQL 查詢、突變和訂閱的資料執行SQL陳述式。

建立叢集

將RDS資料來源新增至之前， AppSync 您必須先啟用 Aurora 無伺服器叢集API上的資料，並使用 AWS Secrets Manager. 您可以先使 AWS CLI用下列方式建立 Aurora 無伺服器叢集：


aws rds create-db-cluster --db-cluster-identifier http-endpoint-test  --master-username USERNAME \
--master-user-password COMPLEX_PASSWORD --engine aurora --engine-mode serverless \
--region us-east-1

這將返回ARN集群的。

通過 AWS Secrets Manager 控制台或通過輸入文件（例如使用上一步的USERNAME和 COMPLEX _PASSWORD）創建密鑰：CLI


{
    "username": "USERNAME",
    "password": "COMPLEX_PASSWORD"
}

將此作為參數傳遞給 AWS CLI：


aws secretsmanager create-secret --name HttpRDSSecret --secret-string file://creds.json --region us-east-1

這將返回一ARN個秘密。

請記下 ARN Aurora 無伺服器叢集和密碼，以便稍後在建立資料來源時在 AppSync 主控台中使用。

啟用資料 API

您可以依照RDS文件中的指示啟用叢集API上的資料。在新增為資料來源之前，API必須先啟用「 AppSync 資料」。

建立資料庫及資料表

啟用資料之後，API您可以確保它可以與中的aws rds-data execute-statement指令搭配使用 AWS CLI。這將確保您的 Aurora 無伺服器叢集在將叢集新增到您的 AppSync API. 首先創建一個使用參數調TESTDB用的--sql數據庫，如下所示：


aws rds-data execute-statement --resource-arn "arn:aws:rds:us-east-1:123456789000:cluster:http-endpoint-test" \
--schema "mysql"  --secret-arn "arn:aws:secretsmanager:us-east-1:123456789000:secret:testHttp2-AmNvc1"  \
--region us-east-1 --sql "create DATABASE TESTDB"

如果這次執行沒有錯誤，則搭配 create table 命令新增資料表：


aws rds-data execute-statement --resource-arn "arn:aws:rds:us-east-1:123456789000:cluster:http-endpoint-test" \
 --schema "mysql"  --secret-arn "arn:aws:secretsmanager:us-east-1:123456789000:secret:testHttp2-AmNvc1" \
 --region us-east-1 \
 --sql "create table Pets(id varchar(200), type varchar(200), price float)" --database "TESTDB"

如果一切都運行沒有問題，您可以繼續將叢集作為 AppSync API.

GraphQL 模式

現在您的 Aurora 無伺服器資料API已透過表格啟動並執行，我們將建立 GraphQL 結構描述並附加解析器以執行突變和訂閱。在 AWS AppSync 主控台API中建立新的並瀏覽至「結構描述」頁面，然後輸入下列內容：


type Mutation {
    createPet(input: CreatePetInput!): Pet
    updatePet(input: UpdatePetInput!): Pet
    deletePet(input: DeletePetInput!): Pet
}

input CreatePetInput {
    type: PetType
    price: Float!
}

input UpdatePetInput {
id: ID!
    type: PetType
    price: Float!
}

input DeletePetInput {
    id: ID!
}

type Pet {
    id: ID!
    type: PetType
    price: Float
}

enum PetType {
    dog
    cat
    fish
    bird
    gecko
}

type Query {
    getPet(id: ID!): Pet
    listPets: [Pet]
    listPetsByPriceRange(min: Float, max: Float): [Pet]
}

schema {
    query: Query
    mutation: Mutation
}

儲存您的結構描述並瀏覽到 Data Sources (資料來源) 頁面，並建立新的資料來源。選取資料來源類型為 Relational database (關聯式資料庫)，並提供易記名稱。使用您在最後一個步驟中建立的資料庫名稱，以及您在其中建立資料庫的叢集ARN。對於角色，您可以 AppSync 創建一個新角色，也可以使用類似下面的策略創建角色：


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "rds-data:DeleteItems",
                "rds-data:ExecuteSql",
                "rds-data:ExecuteStatement",
                "rds-data:GetItems",
                "rds-data:InsertItems",
                "rds-data:UpdateItems"
            ],
            "Resource": [
                "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster",
                "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster:*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": [
                "arn:aws:secretsmanager:us-east-1:123456789012:secret:mysecret",
                "arn:aws:secretsmanager:us-east-1:123456789012:secret:mysecret:*"
            ]
        }
    ]
}

請注意，在您授予角色存取權的這個政策中有 2 個陳述式 。第一個資源是您的 Aurora 無伺服器叢集，第二個是您的 AWS Secrets Manager ARN. 您需要在 AppSync 資料來源組態BOTHARNs中提供，然後按一下 [建立]。

設定解析程式

現在，我們有一個有效的 GraphQL 模式和一個RDS數據源，我們可以將解析器附加到我們的架構上的 GraphQL 字段。我們API將提供以下功能：

通過突變創建一個寵物。 createPet字段
通過變異更新寵物。 updatePet字段
通過變異刪除寵物。 deletePet字段
通過查詢獲得一隻寵物。 getPet字段
通過查詢列出所有寵物。 listPets字段
通過查詢列出價格範圍內的寵物。 listPetsByPriceRange字段

突變。 createPet

在 AWS AppSync 主控台的資料架構編輯器中，選擇右側的「貼附解析器」。createPet(input: CreatePetInput!): Pet選擇 RDS 資料來源。在 request mapping template (要求映射範本) 區段中，新增下列範本：


#set($id=$utils.autoId())
{
"version": "2018-05-29",
    "statements": [
        "insert into Pets VALUES (:ID, :TYPE, :PRICE)",
        "select * from Pets WHERE id = :ID"
    ],
    "variableMap": {
        ":ID": "$ctx.args.input.id",
        ":TYPE": $util.toJson($ctx.args.input.type),
        ":PRICE": $util.toJson($ctx.args.input.price)
    }
}

該SQL語句將按順序執行，基於語句數組中的順序。結果將以相同順序傳回。由於這是一個突變，我們在插入後運行 select 語句來檢索提交的值，以填充 GraphQL 響應映射模板。