Skip to content

chore: GraphQL Transformer v1 prerequisite and feature matrix updates #8597

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
iliapolo wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

chore: GraphQL Transformer v1 prerequisite and feature matrix updates #8597

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions src/pages/[platform]/start/migrate-to-gen2/feature-matrix/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,6 +125,9 @@ The migration tool does not convert your GraphQL schema to the native Gen 2 sche
| auth - custom - function | Yes | Yes | 🟢 |
| searchable | Yes | No (guide using Zero-ETL DynamoDB-to-OpenSearch) | 🔴 |
| predictions | Yes | No (guide with AI service integrations) | 🔴 |
| key | Yes | [No](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) | 🔴 |
| versioned | Yes | [No](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) | 🔴 |
| connection | Yes | [No](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) | 🔴 |
| Custom Mutations, Queries, Subscriptions | Yes | Yes | 🟢 |
| VTL handler | Yes | Yes with CDK | 🟢 |
| JavaScript resolver handler | No | Yes | - |
Expand Down
10 changes: 10 additions & 0 deletions src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,16 @@ Before starting the migration, carefully review the [Backend Categories](/[platf

If your API has conflict resolution enabled (DataStore), you must disable it before proceeding with the Gen 2 migration. See the [Migrate from DataStore](/gen1/[platform]/build-a-backend/more-features/datastore/migrate-from-datastore/) guide for instructions.

### GraphQL Transformer v1

The migration tool does not support GraphQL Transformer v1 schemas. If your project still uses Transformer v1, you must migrate to v2 before proceeding. See the [Transformer migration guide](https://docs.amplify.aws/gen1/react/tools/cli/migration/transformer-migration/) for instructions.

<Callout info>

If you choose to skip this prerequisite, the `generate` step will prompt you to acknowledge the gap. Doing so will skip the data resource entirely — no Gen 2 data definition will be generated. You will need to manually write the Gen 2 data resource definition to restore your GraphQL API functionality.

</Callout>

### GraphQL types protected by the `iam` auth provider

If you have models protected by IAM:
Expand Down
Loading