As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Construindo GraphQL APIs com introspecção RDS

AWS AppSync O utilitário de introspecção da pode descobrir modelos de tabelas de banco de dados e propor tipos de GraphQL. O API assistente de criação do AWS AppSync console pode gerar instantaneamente e a API partir de um banco de dados Aurora My SQL ou SQL Postgre. Ele cria automaticamente tipos e JavaScript resolvedores para ler e gravar dados.

AWS AppSync fornece integração direta com bancos de dados Amazon Aurora por meio do Amazon RDS Data. API Em vez de exigir uma conexão persistente com o banco de RDS dados, o Amazon Data API oferece um HTTP endpoint seguro que AWS AppSync se conecta para execução SQL declarações. Você pode usar isso para criar um banco de dados relacional API para suas cargas de SQL trabalho My SQL e Postgre no Aurora.

Criar um API para seu banco de dados relacional AWS AppSync tem várias vantagens:

AWS AppSync facilita a criação APIs a partir de bancos de dados relacionais existentes. O utilitário de introspecção pode descobrir modelos por meio de tabelas de banco de dados e propor tipos de GraphQL. O API assistente de criação do AWS AppSync console pode gerar instantaneamente e a API partir de um banco de dados Aurora My SQL ou SQL Postgre. Ele cria automaticamente tipos e JavaScript resolvedores para ler e gravar dados.

AWS AppSync fornece JavaScript utilitários integrados para simplificar a escrita de SQL declarações em resolvedores. Você pode usar os modelos AWS AppSync de sql tags para instruções estáticas com valores dinâmicos ou os utilitários do rds módulo para criar instruções programaticamente. Consulte a referência da função de resolução para fontes de RDS dados e módulos integrados para saber mais.

Usar o recurso de introspecção (console)

Para ver um tutorial detalhado e um guia de introdução, consulte Tutorial: Aurora Postgre SQL Serverless with Data. API

O AWS AppSync console permite que você crie um AWS AppSync GraphQL a API partir do seu banco de dados Aurora existente configurado com os dados API em apenas alguns minutos. Isso gera rapidamente um esquema operacional com base na configuração do banco de dados. Você pode usar o API estado em que se encontra ou criar nele para adicionar recursos.

Usando o recurso de introspecção () API

Você pode usar a StartDataSourceIntrospection introspecção API para descobrir modelos em seu banco de dados programaticamente. Para obter mais detalhes sobre o comando, consulte o uso do StartDataSourceIntrospectionAPI.

Para usarStartDataSourceIntrospection, forneça seu cluster Aurora Amazon Resource Name (ARN), nome do banco de dados e AWS Secrets Manager segredo. ARN O comando inicia o processo de introspecção. É possível recuperar os resultados com o comando GetDataSourceIntrospection. Você pode especificar se o comando deve retornar a string Storage Definition Language (SDL) para os modelos descobertos. Isso é útil para gerar uma definição de SDL esquema diretamente dos modelos descobertos.

Por exemplo, se você tiver a seguinte instrução Data definition language (DDL) para uma Todos tabela simples:

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

Você deve começar a introspecção com o seguinte:

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

Depois, use o comando GetDataSourceIntrospection para recuperar o resultado.

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

Ele exibirá o resultado a seguir.

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