翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

イントロスペクションAPIsによる GraphQL RDS の構築

AWS AppSyncのイントロスペクションユーティリティは、データベーステーブルからモデルを検出し、GraphQL タイプを提案できます。 AWS AppSync コンソールの作成APIウィザードは、Aurora MySQL または PostgreSQL データベースAPIから を即座に生成できます。データの読み取りと書き込みを行うタイプと JavaScript リゾルバーが自動的に作成されます。

AWS AppSync は、Amazon RDS Data を介して Amazon Aurora データベースと直接統合しますAPI。Amazon RDS Data APIは、永続的なデータベース接続を必要とするのではなく、 AWS AppSync に接続して実行するための安全なHTTPエンドポイントを提供します。SQL ステートメント。これを使用して、Aurora の MySQL ワークロードと PostgreSQL ワークロードAPIのリレーショナルデータベースを作成できます。

を使用してリレーショナルデータベースAPI用の を構築する AWS AppSync と、いくつかの利点があります。

AWS AppSync は、既存のリレーショナルデータベースAPIsからの構築を容易にします。そのイントロスペクションユーティリティは、データベーステーブルからモデルを検出し、GraphQL の型を提案できます。 AWS AppSync コンソールの作成APIウィザードは、Aurora MySQL または PostgreSQL データベースAPIから を瞬時に生成できます。データの読み取りと JavaScript書き込みを行うタイプとリゾルバーが自動的に作成されます。

AWS AppSync は、リゾルバーでのSQLステートメントの記述を簡素化する統合 JavaScript ユーティリティを提供します。 AWS AppSyncのsqlタグテンプレートは、動的値を持つ静的ステートメントに使用したり、rdsモジュールユーティリティを使用してプログラムでステートメントを構築したりできます。詳細については、データソースのリゾルバー関数リファレンスRDSと組み込みモジュールを参照してください。

イントロスペクション機能を使用する (コンソール)

詳細なチュートリアルと入門ガイドについては、「チュートリアル: Aurora PostgreSQL Serverless with DataAPI」を参照してください。

AWS AppSync コンソールを使用すると、データで設定された既存の Aurora データベースAPIから AWS AppSync GraphQL を数分APIで作成できます。これにより、データベース設定に基づいて運用スキーマが迅速に生成されます。をAPIそのまま使用するか、その上に構築して機能を追加できます。

イントロスペクション機能の使用 (API）

StartDataSourceIntrospection イントロスペクションを使用してAPI、プログラムでデータベース内のモデルを検出できます。コマンドの詳細については、StartDataSourceIntrospection「 の使用」を参照してくださいAPI。

を使用するにはStartDataSourceIntrospection、Aurora クラスターの Amazon リソースネーム (ARN）、データベース名、シー AWS Secrets Manager クレット を指定しますARN。このコマンドはイントロスペクションプロセスを開始します。GetDataSourceIntrospection コマンドを使用して結果を取得できます。コマンドが検出されたモデルの Storage Definition Language (SDL) 文字列を返すかどうかを指定できます。これは、検出されたモデルから直接SDLスキーマ定義を生成するのに役立ちます。

例えば、単純なTodosテーブルに次のデータ定義言語 (DDL) ステートメントがある場合です。

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

イントロスペクションは、以下のように開始します。

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

次に、GetDataSourceIntrospection コマンドを使用して結果を取得します。

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

これは次の結果を返します。

{
    "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
    }
}