docs: clarify joins for Actions and other sources

PR-URL: https://github.com/hasura/graphql-engine-mono/pull/9607
GitOrigin-RevId: 210a82300040594a85da35e2f045099c429b394d
This commit is contained in:
Rob Dominguez 2023-06-23 09:25:30 -05:00 committed by hasura-bot
parent 017d3a6ec3
commit e7983e268a
2 changed files with 22 additions and 3 deletions

View File

@ -24,11 +24,15 @@ connected with the rest of the graph.
For example, a custom `insertAuthor` action will be related to the `author` object in the schema. Hence, we would want
to be able to get information about the `author` from the graph as a response of the `insertAuthor` mutation.
:::info Supported databases
## Support for Action relationships
Currently, Action Relationships are only supported for Postgres databases.
Below, you can find information about the different types of relationship patterns that are supported for Actions.
:::
| Relationship Type | Description |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Action to Database | **Joins are supported _from_ Actions _to_ tables in Postgres databases.** However, Action to database joins are not currently supported for other databases. |
| Action to Action | Actions can be joined to each other by using a Hasura instance as a federation gateway, or "parent" supergraph. You can find more information about this pattern [here](/actions/action-relationships.mdx#action-to-action-relationships). |
| Action to Remote Schema | An Action cannot be joined to a Remote Schema. |
## Using an Action's output types in relationships

View File

@ -111,6 +111,21 @@ Each ✅ below links **directly** to the feature within a particular type of dat
| DELETE | [✅](/event-triggers/overview.mdx) | [❌](/databases/postgres/citus-hyperscale-postgres/hasura-citus-compatibility.mdx/#event-triggers) | [✅](/event-triggers/overview.mdx) | ❌ | [❌](/databases/postgres/cockroachdb/hasura-cockroachdb-compatibility.mdx/#event-triggers) | ❌ |
| MANUAL | [✅](/event-triggers/overview.mdx) | [❌](/databases/postgres/citus-hyperscale-postgres/hasura-citus-compatibility.mdx/#event-triggers) | [✅](/event-triggers/overview.mdx) | ❌ | [❌](/databases/postgres/cockroachdb/hasura-cockroachdb-compatibility.mdx/#event-triggers) | ❌ |
## Joins
| From ⬇️ / To ➡️ | Postgres | Citus | SQL Server | BigQuery | CockroachDB | CosmosDB | Action | Remote Schema |
| ----------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------- | -------- | ----------- | -------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Postgres Database | [✅](/schema/postgres/remote-relationships/index.mdx) | [✅](/schema/postgres/remote-relationships/index.mdx) | ❌ | ❌ | ❌ | ❌ | ❌ | [✅](/schema/postgres/remote-relationships/remote-schema-relationships.mdx) |
| Database (non-Postgres) | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | ⚠️ |
| Action | [✅](/schema/postgres/remote-relationships/action-relationships.mdx) | [✅](/schema/postgres/remote-relationships/action-relationships.mdx) | ❌ | ❌ | ❌ | ❌ | [✅](/actions/action-relationships.mdx#action-to-action-relationships) | ❌ |
| Remote Schema | [✅](/remote-schemas/remote-relationships/remote-schema-db-relationships.mdx) | [✅](/remote-schemas/remote-relationships/remote-schema-db-relationships.mdx) | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ❌ | [✅](/remote-schemas/remote-relationships/remote-schema-relationships.mdx) |
:::info For any ⚠️ above
Check your individual database's compatibility page for more details.
:::
</div>
:::info Additional Resources