기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

RDS 내부 검사를 APIs 통한 GraphQL 구축

AWS AppSync의 내부 검사 유틸리티는 데이터베이스 테이블에서 모델을 검색하고 GraphQL 유형을 제안할 수 있습니다. AWS AppSync 콘솔의 생성 API 마법사는 Aurora MySQL 또는 PostgreSQL 데이터베이스API에서 를 즉시 생성할 수 있습니다. 데이터를 읽고 쓰는 유형 및 JavaScript 해석기를 자동으로 생성합니다.

AWS AppSync 는 Amazon RDS Data 를 통해 Amazon Aurora 데이터베이스와 직접 통합합니다API. Amazon RDS Data는 영구 데이터베이스 연결이 필요한 대신 실행을 위해 에 AWS AppSync 연결하는 보안 HTTP 엔드포인트를 API 제공합니다.SQL 문. 이를 사용하여 Aurora에서 MySQL 및 PostgreSQL 워크로드에 API 대한 관계형 데이터베이스를 생성할 수 있습니다.

를 사용하여 관계형 데이터베이스를 API 위한 를 빌드하면 다음과 같은 몇 가지 이점 AWS AppSync 이 있습니다.

AWS AppSync 를 사용하면 기존 관계형 데이터베이스APIs에서 쉽게 빌드할 수 있습니다. 내부 검사 유틸리티는 데이터베이스 테이블에서 모델을 검색하고 GraphQL 유형을 제안할 수 있습니다. 콘솔의 생성 API 마법사는 AWS AppSync Aurora MySQL 또는 PostgreSQL 데이터베이스API에서 를 즉시 생성할 수 있습니다. 데이터를 읽고 쓰는 유형 JavaScript 및 해석기를 자동으로 생성합니다.

AWS AppSync 는 해석기의 SQL 문 작성을 단순화하는 통합 JavaScript 유틸리티를 제공합니다. 동적 값이 있는 정적 문에 AWS AppSync의 sql 태그 템플릿을 사용하거나 rds 모듈 유틸리티를 사용하여 문을 프로그래밍 방식으로 빌드할 수 있습니다. 자세한 내용은 데이터 소스 및 내장 모듈에 대한 해석기 함수 참조RDS를 참조하세요.

내부 검사 기능 사용(콘솔)

자세한 자습서 및 시작 안내서는 자습서: 데이터가 포함된 Aurora PostgreSQL Serverless를 API참조하세요.

AWS AppSync 콘솔을 사용하면 몇 분 API 만에 데이터로 구성된 기존 Aurora 데이터베이스API에서 AWS AppSync GraphQL을 생성할 수 있습니다. 그러면 데이터베이스 구성을 기반으로 운영 스키마가 빠르게 생성됩니다. API 있는 그대로 또는 를 기반으로 기능을 추가할 수 있습니다.

소개 기능 사용(API)

StartDataSourceIntrospection 내부 검사를 사용하여 프로그래밍 방식으로 데이터베이스의 모델을 API 검색할 수 있습니다. 명령에 대한 자세한 내용은 사용 단원을 참조하세요StartDataSourceIntrospectionAPI.

를 사용하려면 Aurora 클러스터 Amazon 리소스 이름(ARN), 데이터베이스 이름 및 AWS Secrets Manager 보안 암호 를 StartDataSourceIntrospection제공합니다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
    }
}