Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membangun GraphQL API dengan introspeksi RDS

AWS AppSync utilitas introspeksi dapat menemukan model dari tabel database dan mengusulkan jenis GraphQL. Wizard Create API AWS AppSync konsol dapat langsung menghasilkan API dari database Aurora MySQL atau PostgreSQL. Secara otomatis membuat tipe dan JavaScript resolver untuk membaca dan menulis data.

AWS AppSync menyediakan integrasi langsung dengan database Amazon Aurora melalui Amazon RDS Data API. Alih-alih memerlukan koneksi database persisten, Amazon RDS Data API menawarkan titik akhir HTTP aman yang AWS AppSync terhubung untuk menjalankan SQL pernyataan. Anda dapat menggunakan ini untuk membuat API database relasional untuk beban kerja MySQL dan PostgreSQL Anda di Aurora.

Membangun API untuk database relasional Anda AWS AppSync memiliki beberapa keuntungan:

AWS AppSync membuat pembuatan API dari database relasional yang ada menjadi mudah. Utilitas introspeksinya dapat menemukan model dari tabel database dan mengusulkan jenis GraphQL. Wizard Create API AWS AppSync konsol dapat langsung menghasilkan API dari database Aurora MySQL atau PostgreSQL. Secara otomatis membuat tipe dan JavaScript resolver untuk membaca dan menulis data.

AWS AppSync menyediakan JavaScript utilitas terintegrasi untuk menyederhanakan penulisan pernyataan SQL di resolver. Anda dapat menggunakan AWS AppSync template sql tag untuk pernyataan statis dengan nilai dinamis, atau utilitas rds modul untuk membuat pernyataan secara terprogram. Lihat referensi fungsi resolver untuk sumber data RDS dan modul bawaan untuk informasi lebih lanjut.

Menggunakan fitur introspeksi (konsol)

Untuk tutorial terperinci dan panduan memulai, lihat Tutorial: Aurora PostgreSQL Serverless with Data API.

Kon AWS AppSync sol memungkinkan Anda membuat AWS AppSync GraphQL API dari database Aurora yang ada yang dikonfigurasi dengan API Data hanya dalam beberapa menit. Ini dengan cepat menghasilkan skema operasional berdasarkan konfigurasi database Anda. Anda dapat menggunakan API apa adanya atau membangunnya untuk menambahkan fitur.

Menggunakan fitur introspeksi (API)

Anda dapat menggunakan API StartDataSourceIntrospection introspeksi untuk menemukan model dalam database Anda secara terprogram. Untuk detail selengkapnya tentang perintah, lihat menggunakan StartDataSourceIntrospection API.

Untuk menggunakanStartDataSourceIntrospection, berikan nama Amazon Resource Name (ARN) cluster Aurora Anda, nama database, dan ARN AWS Secrets Manager rahasia. Perintah memulai proses introspeksi. Anda dapat mengambil hasilnya dengan GetDataSourceIntrospection perintah. Anda dapat menentukan apakah perintah harus mengembalikan string Storage Definition Language (SDL) untuk model yang ditemukan. Ini berguna untuk menghasilkan definisi skema SDL langsung dari model yang ditemukan.

Misalnya, jika Anda memiliki pernyataan bahasa definisi data (DDL) berikut untuk Todos tabel sederhana:

create table if not exists public.todos  
(  
id serial constraint todos_pk primary key,  
description text,  
due timestamp,  
"createdAt" timestamp default now()  
);

Anda memulai introspeksi dengan yang berikut ini.

aws appsync start-data-source-introspection \ 
  --rds-data-api-config resourceArn=<cluster-arn>,secretArn=<secret-arn>,databaseName=database

Selanjutnya, gunakan GetDataSourceIntrospection perintah untuk mengambil hasilnya.

aws appsync get-data-source-introspection \
  --introspection-id a1234567-8910-abcd-efgh-identifier \
  --include-models-sdl

Ini mengembalikan hasil berikut.

{
    "introspectionId": "a1234567-8910-abcd-efgh-identifier",
    "introspectionStatus": "SUCCESS",
    "introspectionStatusDetail": null,
    "introspectionResult": {
        "models": [
            {
                "name": "todos",
                "fields": [
                    {
                        "name": "description",
                        "type": {
                            "kind": "Scalar",
                            "name": "String",
                            "type": null,
                            "values": null
                        },
                        "length": 0
                    },
                    {
                        "name": "due",
                        "type": {
                            "kind": "Scalar",
                            "name": "AWSDateTime",
                            "type": null,
                            "values": null
                        },
                        "length": 0
                    },
                    {
                        "name": "id",
                        "type": {
                            "kind": "NonNull",
                            "name": null,
                            "type": {
                                "kind": "Scalar",
                                "name": "Int",
                                "type": null,
                                "values": null
                            },
                            "values": null
                        },
                        "length": 0
                    },
                    {
                        "name": "createdAt",
                        "type": {
                            "kind": "Scalar",
                            "name": "AWSDateTime",
                            "type": null,
                            "values": null
                        },
                        "length": 0
                    }
                ],
                "primaryKey": {
                    "name": "PRIMARY_KEY",
                    "fields": [
                        "id"
                    ]
                },
                "indexes": [],
                "sdl": "type todos\n{\ndescription: String\n\ndue: AWSDateTime\n\nid: Int!\n\ncreatedAt: AW
SDateTime\n}\n"
            }
        ],
        "nextToken": null
    }
}