Buat cluster Aktifkan Data API Buat database dan tabel GraphQL skema Mengkonfigurasi Resolver Jalankan mutasi Jalankan Kueri Sanitasi Masukan

Tutorial: Menggunakan Aurora Tanpa Server dengan AWS AppSync

AWS AppSync menyediakan sumber data untuk menjalankan SQL perintah terhadap klaster Amazon Aurora Tanpa Server yang telah diaktifkan dengan Data. API Anda dapat menggunakan AppSync resolver untuk mengeksekusi SQL pernyataan terhadap Data dengan kueri, mutasi, dan API langganan GraphQL.

Buat cluster

Sebelum menambahkan sumber RDS data ke AppSync Anda harus terlebih dahulu mengaktifkan Data API pada cluster Aurora Tanpa Server dan mengkonfigurasi rahasia menggunakan. AWS Secrets Manager Anda dapat membuat cluster Aurora Tanpa Server terlebih dahulu dengan: 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

Ini akan mengembalikan ARN untuk cluster.

Buat Rahasia melalui AWS Secrets Manager Konsol atau juga melalui CLI dengan file input seperti berikut menggunakan USERNAME dan COMPLEX _ PASSWORD dari langkah sebelumnya:


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

Berikan ini sebagai parameter ke AWS CLI:


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

Ini akan mengembalikan rahasia. ARN

Perhatikan klaster Aurora Tanpa Server dan Rahasia Anda untuk digunakan nanti di AppSync konsol saat membuat sumber data. ARN

Aktifkan Data API

Anda dapat mengaktifkan Data API pada klaster Anda dengan mengikuti petunjuk dalam RDS dokumentasi. Data API harus diaktifkan sebelum menambahkan sebagai sumber AppSync data.

Buat database dan tabel

Setelah Anda mengaktifkan Data Anda, API Anda dapat memastikannya berfungsi dengan aws rds-data execute-statement perintah di file AWS CLI. Ini akan memastikan bahwa cluster Aurora Serverless Anda dikonfigurasi dengan benar sebelum menambahkannya ke Anda. AppSync API Pertama buat database yang disebut TESTDBdengan --sql parameter seperti:


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"

Jika ini berjalan tanpa kesalahan, tambahkan tabel dengan perintah 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"

Jika semuanya berjalan tanpa masalah, Anda dapat melanjutkan untuk menambahkan cluster sebagai sumber data di file Anda AppSync API.

GraphQL skema

Sekarang setelah Data API Tanpa Server Aurora Anda aktif dan berjalan dengan tabel, kami akan membuat skema GraphQL dan melampirkan resolver untuk melakukan mutasi dan langganan. Buat yang baru API di AWS AppSync konsol dan arahkan ke halaman Skema, dan masukkan yang berikut ini:


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
}

Simpan skema Anda dan arahkan ke halaman Sumber Data dan buat sumber data baru. Pilih Database relasional untuk tipe sumber data, dan berikan nama yang ramah. Gunakan nama database yang Anda buat pada langkah terakhir, serta Cluster ARN tempat Anda membuatnya. Untuk Peran, Anda dapat AppSync membuat peran baru atau membuat peran dengan kebijakan yang mirip dengan di bawah ini:


{
    "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:*"
            ]
        }
    ]
}

Perhatikan ada dua Pernyataan dalam kebijakan ini yang Anda berikan akses peran. Sumber daya pertama adalah cluster Aurora Tanpa Server Anda dan yang kedua adalah milik Anda. AWS Secrets Manager ARN Anda harus menyediakan BOTHARNsdalam konfigurasi sumber AppSync data sebelum mengklik Buat.

Mengkonfigurasi Resolver

Sekarang kita memiliki skema GraphQL yang valid dan RDS sumber data, kita dapat melampirkan resolver ke bidang GraphQL pada skema kita. Kami API akan menawarkan kemampuan berikut:

buat hewan peliharaan melalui Mutasi. createPetlapangan
perbarui hewan peliharaan melalui Mutasi. updatePetlapangan
hapus hewan peliharaan melalui Mutasi. deletePetlapangan
dapatkan satu hewan peliharaan melalui Query. getPetlapangan
daftar semua hewan peliharaan melalui Query. listPetslapangan
daftar hewan peliharaan dalam kisaran harga melalui Query. listPetsByPriceRangelapangan

Mutasi. createPet

Dari editor skema di AWS AppSync konsol, di sisi kanan pilih Lampirkan Resolver untuk. createPet(input: CreatePetInput!): Pet Pilih sumber RDS data Anda. Di bagian template pemetaan permintaan, tambahkan template berikut:


#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)
    }
}

SQLPernyataan akan mengeksekusi secara berurutan, berdasarkan urutan dalam array pernyataan. Hasilnya akan kembali dalam urutan yang sama. Karena ini adalah mutasi, kami menjalankan pernyataan pilih setelah sisipan untuk mengambil nilai yang dikomit untuk mengisi template pemetaan respons GraphQL.