クラスターを作成するデータを有効にする API データベースとテーブルを作成する GraphQL スキーマリゾルバーの設定ミューテーションを実行するクエリを実行する入力サニタイズ

チュートリアル: での Aurora Serverless の使用 AWS AppSync

AWS AppSync は、データで有効になっている Amazon Aurora Serverless クラスターに対してSQLコマンドを実行するためのデータソースを提供しますAPI。 AppSync リゾルバーを使用して、GraphQL クエリ、ミューテーション、サブスクリプションAPIを持つデータに対してSQLステートメントを実行できます。

クラスターを作成する

RDS データソースをに追加する前に、まず Aurora Serverless クラスターAPIでデータを有効にし、を使用してシークレットを設定 AppSync する必要があります AWS Secrets Manager。Aurora Serverless クラスターは、まずを使用して作成できます AWS CLI。


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 コンソール、または前のステップCLIの USERNAMEおよび COMPLEX_PASSWORD を使用して、次のような入力ファイルを使用して経由でシークレットを作成します。


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

これをパラメータとしてに渡します AWS CLI。


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

これにより、シークレットARNのが返されます。

データソースを作成するときは、後でコンソールで使用できるように、Aurora Serverless クラスターARNのとシークレットに注意してください。 AppSync

データを有効にする API

RDS ドキュメントの手順に従って、クラスターAPIでデータを有効にできます。をデータソースとして追加する前に、 AppSync データを有効にするAPI必要があります。

データベースとテーブルを作成する

データを有効にしたらAPI、の aws rds-data execute-statement コマンドで動作するようにできます AWS CLI。これにより、Aurora Serverless クラスターがに追加される前に正しく設定されます AppSync API。まず、 --sqlパラメータTESTDBを使用してという名前のデータベースを作成します。


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 Serverless Data 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
}

スキーマを保存し、[データソース] ページに移動して、新しいデータソースを作成します。データソースタイプとして [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 Serverless クラスターで、2 つ目はです AWS Secrets Manager ARN。の作成をクリックする前に、 AppSync データソース設定BOTHARNsでを指定する必要があります。

リゾルバーの設定

有効な GraphQL スキーマとRDSデータソースができたので、スキーマの GraphQL フィールドにリゾルバーをアタッチできます。API では、次の機能が提供されます。

Mutation フィールドを使用してペットを作成します。createPet
Mutation フィールドを使用してペットを更新します。updatePet
Mutation フィールドを使用してペットを削除します。deletePet
Query.getPet フィールドを使用してペットを 1 頭取得する
Query. フィールドを使用してすべてのペットを一覧表示します。listPets
Query フィールドを使用して、料金範囲内のペットを一覧表示します。listPetsByPriceRange

ミューテーション。createPet

AWS AppSync コンソールのスキーマエディタから、右側の「のリゾルバーをアタッチする」を選択しますcreatePet(input: CreatePetInput!): Pet。RDS データソースを選択します。[リクエストマッピングテンプレート] セクションで、以下のテンプレートを追加します。


#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 ステートメントは、ステートメント配列の順序に基づいて順番に実行されます。結果はその同じ順序で返されます。これはミューテーションなので、挿入の後に選択ステートメントを実行して、GraphQL レスポンスマッピングテンプレートに入力するための、コミットされた値を取得します。