mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-15 17:31:56 +03:00
docs: move FAQ section to top-level in sidebar + update metadata catalogue details
PR-URL: https://github.com/hasura/graphql-engine-mono/pull/3514 Co-authored-by: Rikin Kachhia <54616969+rikinsk@users.noreply.github.com> GitOrigin-RevId: 36f695916a04d3e86796964864aac48a815f3320
This commit is contained in:
Divya Bhushan
hasura-bot
parent
149f4b53d5
commit
b0fa87566a
177
docs/graphql/core/faq/index.rst
Normal file
177
docs/graphql/core/faq/index.rst
Normal file
@ -0,0 +1,177 @@
|
|||||||
|
.. meta::
|
||||||
|
:description: Hasura FAQs
|
||||||
|
:keywords: hasura, docs, FAQs
|
||||||
|
|
||||||
|
.. _faq:
|
||||||
|
|
||||||
|
FAQs
|
||||||
|
====
|
||||||
|
|
||||||
|
.. contents:: Table of contents
|
||||||
|
:backlinks: none
|
||||||
|
:depth: 1
|
||||||
|
:local:
|
||||||
|
|
||||||
|
.. _faq_db:
|
||||||
|
|
||||||
|
What types of workloads and databases does Hasura support?
|
||||||
|
----------------------------------------------------------
|
||||||
|
|
||||||
|
Hasura supports the following databases:
|
||||||
|
- PostgresQL (and the Postgres family of databases: Yugabyte, Timescale, Citus, Aurora)
|
||||||
|
- SQL Server
|
||||||
|
- Big Query
|
||||||
|
|
||||||
|
.. _faq_how_hasura_works:
|
||||||
|
|
||||||
|
How does Hasura work?
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
Although Hasura presents itself as a web-service, Hasura is quite a JIT compiler. Hasura takes incoming GraphQL API calls over HTTP and
|
||||||
|
then tries to achieve theoretically optimal performance while delegating the data fetches to downstream data sources. You can read more
|
||||||
|
about Hasura’s design philosophy in this `blog post. <https://hasura.io/blog/how-hasura-works/>`__
|
||||||
|
|
||||||
|
.. _faq_hasura_timesaving:
|
||||||
|
|
||||||
|
How much time & effort does Hasura save?
|
||||||
|
----------------------------------------
|
||||||
|
|
||||||
|
Hasura cuts down development time by 50-80%. You can find out more from our case studies `here. <https://hasura.io/user-stories/>`__
|
||||||
|
|
||||||
|
.. _faq_hasura_existing_app_api:
|
||||||
|
|
||||||
|
How do I use Hasura if I already have an existing application or API?
|
||||||
|
---------------------------------------------------------------------
|
||||||
|
|
||||||
|
Hasura is designed for incremental adoption without having to rip-and-replace or entirely rebuild your stack. You can incrementally migrate
|
||||||
|
your application to Hasura. Use Hasura to first build any new features for your application using your existing data as well as a high
|
||||||
|
performance read layer for any read-heavy use-cases as this takes no time to set up. You can also use any business logic in your existing
|
||||||
|
applications by delegating to them via Hasura Actions. This gives you the time to migrate over any legacy code or rewrite existing
|
||||||
|
micro-services with Hasura.
|
||||||
|
|
||||||
|
.. _faq_business_logic:
|
||||||
|
|
||||||
|
Where do I put business logic?
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
Hasura exposes your domain’s data and logic over a high-performance flexible API. Hasura removes the need for writing any code required
|
||||||
|
for external or internal authorization rules.
|
||||||
|
|
||||||
|
Hasura provides 4 ways for exposing existing or new business logic in your domain:
|
||||||
|
|
||||||
|
**Event triggers:**
|
||||||
|
Whenever there’s a change in the upstream database, Hasura can capture that change as an event and deliver that to a HTTP webhook that
|
||||||
|
can process that data change event and react to it asynchronously. Apart from attaching specific pieces of logic to events, this is especially
|
||||||
|
useful if you’re thinking about building end-to-end real-time and reactive applications.
|
||||||
|
|
||||||
|
- Read more about this architecture at https://3factor.app.
|
||||||
|
- Read more about event triggers in the Hasura :ref:`docs. <event_triggers>`.
|
||||||
|
- Go through a quick tutorial on how to set event triggers up at https://learn.hasura.io.
|
||||||
|
|
||||||
|
**REST APIs:**
|
||||||
|
If you have new or existing REST APIs that serve domain data or logic, you can easily connect Hasura to them and extend the GraphQL schema
|
||||||
|
that Hasura exposes. This is useful not just when you have legacy APIs that contain a lot of transactional or application logic, but also
|
||||||
|
when you want to build and serve custom logic with cloud-native code deployed as containers or serverless functions.
|
||||||
|
|
||||||
|
- Read more about :ref:`Hasura Actions <actions>`
|
||||||
|
|
||||||
|
**GraphQL APIs:**
|
||||||
|
If you have a new or existing GraphQL service that extends the schema, say with custom mutations that incorporate your custom logic, or if
|
||||||
|
you’d like to extend your overall GraphQL API with a “sub graph” that comes from a service that you may not directly own, you can use “Remote Schemas”
|
||||||
|
in Hasura to bring in GraphQL services as data & logic providers to your GraphQL API.
|
||||||
|
|
||||||
|
- Read more about :ref:`Remote Schemas <remote_schemas>`
|
||||||
|
|
||||||
|
**Stored procedures/functions in the database:**
|
||||||
|
Stored procedures and functions are a common way to write and store high-performance business logic, or transactional logic, that's close to the
|
||||||
|
data. As a part of the GraphQL API that Hasura exposes over databases, Hasura allows you to expose stored procedures or functions as fields in
|
||||||
|
the GraphQL schema. This is a great way to bring in existing business logic that maybe in your database, or to write custom, high-performance logic
|
||||||
|
if you’re familiar with databases!
|
||||||
|
|
||||||
|
- Read more about :ref:`custom functions <pg_custom_sql_functions>`
|
||||||
|
|
||||||
|
Choose one or more of the methods above depending on where your existing business logic is; and where you want it to be in the future!
|
||||||
|
|
||||||
|
For example, you might have existing logic in synchronous REST APIs in Java or .NET, but you might want to write new logic as reactive event triggers
|
||||||
|
deployed as serverless functions (or lambdas) in Javascript or Python or Go!
|
||||||
|
|
||||||
|
.. _faq_REST_api:
|
||||||
|
|
||||||
|
Can I use REST instead of GraphQL APIs?
|
||||||
|
---------------------------------------
|
||||||
|
|
||||||
|
Hasura 2.0 added support for REST APIs. Hasura 2.0 allows users to create idiomatic REST endpoints based on GraphQL templates. Read more
|
||||||
|
:ref:`here. <restified_api_reference>`
|
||||||
|
|
||||||
|
.. _faq_hasura_auth:
|
||||||
|
|
||||||
|
Can Hasura integrate with my authentication system?
|
||||||
|
---------------------------------------------------
|
||||||
|
|
||||||
|
Hasura believes authentication should not be restricted to a particular provider. Therefore, we make it easier for you to bring in your authentication
|
||||||
|
system. The most favored mechanism is via JWT. Hasura can accept JWT tokens from any standard JWT provider.
|
||||||
|
For extremely customized authentication systems, Hasura also supports auth webhook that allows you to read through cookies or tokens that might have a
|
||||||
|
custom format. We have guides for some of the popular authentication providers. Read more :ref:`here. <authentication>`
|
||||||
|
|
||||||
|
.. _faq_hasura_query_caching:
|
||||||
|
|
||||||
|
Does Hasura also automatically cache queries or data to improve performance?
|
||||||
|
----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Query response caching (available on Hasura Cloud & Hasura EE) can be enabled by specifying which query to cache using the @cached directive. Read more about
|
||||||
|
caching `here. <https://hasura.io/learn/graphql/hasura-advanced/performance/1-caching/>`__
|
||||||
|
|
||||||
|
.. _faq_ABAC_RBAC:
|
||||||
|
|
||||||
|
How does Hasura handle ABAC, RBAC style authorization policies?
|
||||||
|
---------------------------------------------------------------
|
||||||
|
|
||||||
|
Hasura implements RBAC by automatically publishing a different GraphQL schema that represents the right queries, fields, and
|
||||||
|
mutations that are available to that role.
|
||||||
|
|
||||||
|
For ABAC, session variables can be used as attributes, and permission rules can be created that can use any dynamic
|
||||||
|
variable that is a property of the request.
|
||||||
|
|
||||||
|
.. _faq_security:
|
||||||
|
|
||||||
|
Does Hasura have other security features, specifically for GraphQL in production?
|
||||||
|
---------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Hasura has multiple security features to best utilize the power of our GraphQL Engine.
|
||||||
|
Features like service level security, authentication & authorization, allow lists, rate, and response limiting are present. Learn more about Hasura
|
||||||
|
security `here. <https://hasura.io/learn/graphql/hasura-advanced/security/>`__
|
||||||
|
|
||||||
|
|
||||||
|
.. _faq_compiler_performance:
|
||||||
|
|
||||||
|
How does the compiler approach provide superior performance?
|
||||||
|
------------------------------------------------------------
|
||||||
|
|
||||||
|
Typically when you think of GraphQL servers processing a query, you think of the number of resolvers involved in fetching the data for
|
||||||
|
the query. This approach can lead to multiple hits to the database with obvious constraints associated with it. Batching with data loader can
|
||||||
|
improve the situation by reducing the number of calls.
|
||||||
|
|
||||||
|
Internally Hasura parses a GraphQL query gets an internal representation of the GraphQL AST. GraphQL AST is then converted to a
|
||||||
|
SQL AST. With necessary transformations and variables the final SQL is formed.
|
||||||
|
|
||||||
|
``GraphQL Parser -> GraphQL AST -> SQL AST -> SQL``
|
||||||
|
|
||||||
|
This compiler-based approach allows Hasura to form a single SQL query for a GraphQL query of any depth.
|
||||||
|
|
||||||
|
.. _faq_scaling:
|
||||||
|
|
||||||
|
How does Hasura scale vertically and horizontally?
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Hasura Cloud lets you scale your applications automatically without having to think about the number of instances, cores, memory, thresholds
|
||||||
|
etc. You can keep increasing your number of concurrent users and the number of API calls and Hasura Cloud will figure out the optimizations
|
||||||
|
auto-magically. Hasura Cloud can load balance queries and subscriptions across read replicas while sending all mutations and metadata API calls to the master.
|
||||||
|
Learn more about Horizontal scaling with Hasura, `here. <https://hasura.io/learn/graphql/hasura-advanced/performance/2-horizontal-scaling/>`__
|
||||||
|
|
||||||
|
.. _faq_slow_api_perf:
|
||||||
|
|
||||||
|
How can I improve the performance of slow running API calls?
|
||||||
|
------------------------------------------------------------
|
||||||
|
|
||||||
|
Hasura allows analyzing queries to identify the slow running calls and use Indexes to improve the performance. Learn more
|
||||||
|
`here. <https://hasura.io/learn/graphql/hasura-advanced/performance/3-analyze-query-plans/>`__
|
||||||
@ -1,207 +0,0 @@
|
|||||||
.. meta::
|
|
||||||
:description: Hasura FAQs
|
|
||||||
:keywords: hasura, docs, FAQs
|
|
||||||
|
|
||||||
.. _faq:
|
|
||||||
|
|
||||||
FAQs
|
|
||||||
====
|
|
||||||
|
|
||||||
.. contents:: Table of contents
|
|
||||||
:backlinks: none
|
|
||||||
:depth: 1
|
|
||||||
:local:
|
|
||||||
|
|
||||||
.. _faq_db:
|
|
||||||
|
|
||||||
What types of workloads and databases does Hasura support?
|
|
||||||
----------------------------------------------------------
|
|
||||||
|
|
||||||
Hasura supports the following databases:
|
|
||||||
- PostgresQL (and the Postgres family of databases: Yugabyte, Timescale, Citus, Aurora)
|
|
||||||
- SQL Server
|
|
||||||
- Big Query
|
|
||||||
|
|
||||||
.. _faq_how_hasura_works:
|
|
||||||
|
|
||||||
How does Hasura work?
|
|
||||||
---------------------
|
|
||||||
|
|
||||||
Although Hasura presents itself as a web-service,
|
|
||||||
Hasura is quite a JIT compiler, Hasura takes incoming GraphQL API
|
|
||||||
calls over HTTP and then tries to achieve theoretically optimal performance
|
|
||||||
while delegating the data fetches to downstream data-sources. You can read
|
|
||||||
more about Hasura’s design philosophy in this `blog post. <https://hasura.io/blog/how-hasura-works/>`__
|
|
||||||
|
|
||||||
.. _faq_hasura_timesaving:
|
|
||||||
|
|
||||||
How much time & effort does Hasura save?
|
|
||||||
----------------------------------------
|
|
||||||
|
|
||||||
Hasura cuts down development time by 50-80%. You can find out more from
|
|
||||||
our case studies `here. <https://hasura.io/user-stories/>`__
|
|
||||||
|
|
||||||
.. _faq_hasura_existing_app_api:
|
|
||||||
|
|
||||||
How do I use Hasura if I already have an existing application or API?
|
|
||||||
---------------------------------------------------------------------
|
|
||||||
|
|
||||||
Hasura is designed for incremental adoption without having to
|
|
||||||
rip-and-replace or entirely rebuild your stack. You can incrementally
|
|
||||||
migrate your application to Hasura. Use Hasura to first build any new
|
|
||||||
features for your application using your existing data as well as a high
|
|
||||||
performance read layer for any read heavy use-cases as this takes no time
|
|
||||||
to set up. You can also use any business logic in your existing applications
|
|
||||||
by delegating to them via Hasura Actions. This will give you the time to
|
|
||||||
migrate over any legacy code or rewrite existing microservices with Hasura.
|
|
||||||
|
|
||||||
.. _faq_business_logic:
|
|
||||||
|
|
||||||
Where do I put business logic?
|
|
||||||
------------------------------
|
|
||||||
|
|
||||||
Hasura exposes your domain’s data and logic over a high-performance flexible API. If
|
|
||||||
you’re pointing Hasura at a database you might be wondering, where you’d write the
|
|
||||||
necessary business logic that’s required for an API.
|
|
||||||
|
|
||||||
Note that Hasura removes the need for writing any code required for external or internal
|
|
||||||
authorization rules.
|
|
||||||
|
|
||||||
Hasura provides 4 ways for exposing existing or new business logic in your domain:
|
|
||||||
|
|
||||||
**Event triggers:**
|
|
||||||
Whenever there’s a change in the upstream database, Hasura can
|
|
||||||
capture that change as an event and deliver that to a HTTP webhook that can process
|
|
||||||
that data change event and react to it asynchronously. Apart from attaching specific pieces
|
|
||||||
of logic to events, this is especially useful if you’re thinking about building end to end
|
|
||||||
realtime and reactive applications.
|
|
||||||
|
|
||||||
- Read more about this architecture at https://3factor.app
|
|
||||||
- Read more about event triggers in the Hasura :ref:`docs. <event_triggers>`
|
|
||||||
- Go through a quick tutorial on how to set event triggers up at https://learn.hasura.io
|
|
||||||
|
|
||||||
**REST APIs:**
|
|
||||||
If you have new or existing REST APIs that serve domain data or logic, you can easily connect
|
|
||||||
Hasura to them and extend the GraphQL schema that Hasura exposes. This is useful not just when
|
|
||||||
you have legacy APIs that contain a lot of transactional or application logic, but also when you
|
|
||||||
want to build and serve custom logic with cloud-native code deployed as containers or serverless
|
|
||||||
functions.
|
|
||||||
|
|
||||||
- Read more about :ref:`Hasura Actions <actions>`
|
|
||||||
|
|
||||||
**GraphQL APIs:**
|
|
||||||
If you have a new or existing GraphQL service that extends the schema, say with custom mutations
|
|
||||||
that incorporate your custom logic, or if you’d like to extend your overall GraphQL API with a
|
|
||||||
“sub graph” that comes from a service which you may not directly own, you can use “Remote Schemas”
|
|
||||||
in Hasura to bring in GraphQL services as data & logic providers to your GraphQL API.
|
|
||||||
|
|
||||||
- Read more about :ref:`Remote Schemas <remote_schemas>`
|
|
||||||
|
|
||||||
**Stored procedures / functions in the database:**
|
|
||||||
Stored procedures and functions are a common way to write and store high-performance business
|
|
||||||
logic, or transactional logic, that is close to the data. As a part of the GraphQL API that Hasura
|
|
||||||
exposes over databases, Hasura allows you to expose stored procedures or functions as fields in
|
|
||||||
the GraphQL schema. This is a great way to bring in existing business logic that maybe in your
|
|
||||||
database, or to write custom, high-performance logic if you’re familiar with databases!
|
|
||||||
|
|
||||||
- Read more about :ref:`custom functions <pg_custom_sql_functions>`
|
|
||||||
|
|
||||||
Choose one or more of the methods above depending on where your existing business logic is, and
|
|
||||||
where you want it to be in the future.
|
|
||||||
|
|
||||||
For example, you might have existing logic in synchronous REST APIs in Java or .NET, but you
|
|
||||||
might want to write new logic as reactive event triggers deployed as serverless functions (or
|
|
||||||
lambdas) in Javascript or Python or Go!
|
|
||||||
|
|
||||||
.. _faq_REST_api:
|
|
||||||
|
|
||||||
Can I use REST instead of GraphQL APIs?
|
|
||||||
---------------------------------------
|
|
||||||
|
|
||||||
Hasura 2.0 added support for REST APIs. Hasura 2.0 allows users to create idiomatic REST endpoints based on GraphQL templates. Read more :ref:`here. <restified_api_reference>`
|
|
||||||
|
|
||||||
.. _faq_hasura_auth:
|
|
||||||
|
|
||||||
Can Hasura integrate with my authentication system?
|
|
||||||
---------------------------------------------------
|
|
||||||
|
|
||||||
Hasura believes authentication should not be restricted to a particular provider, hence, we
|
|
||||||
make it really easy for you to bring your own authentication system. The most favoured
|
|
||||||
mechanism is via JWT. Hasura can accept JWT tokens from any standard JWT provider.
|
|
||||||
For extremely customized authentication systems, Hasura also supports auth webhook that
|
|
||||||
allows you to read through cookies or tokens that might have a custom format. We have guides
|
|
||||||
for some of the popular authentication providers.
|
|
||||||
Read more :ref:`here. <authentication>`
|
|
||||||
|
|
||||||
.. _faq_hasura_query_caching:
|
|
||||||
|
|
||||||
Does Hasura also automatically cache queries or data to improve performance?
|
|
||||||
----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
Query response caching (available on Hasura Cloud & Hasura EE) can be enabled by
|
|
||||||
specifying which query to cache using the @cached directive. Read more about caching
|
|
||||||
`here. <https://hasura.io/learn/graphql/hasura-advanced/performance/1-caching/>`__
|
|
||||||
|
|
||||||
.. _faq_ABAC_RBAC:
|
|
||||||
|
|
||||||
How does Hasura handle ABAC, RBAC style authorization policies?
|
|
||||||
---------------------------------------------------------------
|
|
||||||
|
|
||||||
Hasura implements RBAC by automatically publishing a different
|
|
||||||
GraphQL schema that represents the right queries, fields, and
|
|
||||||
mutations that are available to that role.
|
|
||||||
|
|
||||||
For ABAC, session variables can be used as attributes and
|
|
||||||
permission rules can be created that can use any dynamic
|
|
||||||
variable that is a property of the request.
|
|
||||||
|
|
||||||
.. _faq_security:
|
|
||||||
|
|
||||||
Does Hasura have other security features, specifically for GraphQL in production?
|
|
||||||
---------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
Hasura has multiple security features to best utilize the power of our GraphQL Engine.
|
|
||||||
Features like service level security, authentication & authorization, allow lists,
|
|
||||||
rate and response limiting are present. Learn more about Hasura security `here. <https://hasura.io/learn/graphql/hasura-advanced/security/>`__
|
|
||||||
|
|
||||||
|
|
||||||
.. _faq_compiler_performance:
|
|
||||||
|
|
||||||
How does the compiler approach provide superior performance?
|
|
||||||
------------------------------------------------------------
|
|
||||||
|
|
||||||
Typically when you think of GraphQL servers processing a query, you
|
|
||||||
think of the number of resolvers involved in fetching the data for
|
|
||||||
the query. This approach can lead to multiple hits to the database with
|
|
||||||
obvious constraints associated with it. Batching with data loader can
|
|
||||||
improve the situation by reducing the number of calls.
|
|
||||||
|
|
||||||
Internally Hasura parses a GraphQL query, gets an internal
|
|
||||||
representation of the GraphQL AST. This is then converted to a
|
|
||||||
SQL AST and with necessary transformations and variables the final
|
|
||||||
SQL is formed.
|
|
||||||
|
|
||||||
``GraphQL Parser -> GraphQL AST -> SQL AST -> SQL``
|
|
||||||
|
|
||||||
This compiler based approach allows Hasura to form a single SQL query for a GraphQL query of any depth.
|
|
||||||
|
|
||||||
.. _faq_scaling:
|
|
||||||
|
|
||||||
How does Hasura scale vertically and horizontally?
|
|
||||||
--------------------------------------------------
|
|
||||||
|
|
||||||
Hasura Cloud lets you scale your applications automatically without
|
|
||||||
having to think about the number of instances, cores, memory, thresholds
|
|
||||||
etc. You can keep increasing your number of concurrent users and the
|
|
||||||
number of API calls and Hasura Cloud will figure out the optimizations
|
|
||||||
auto-magically. Hasura Cloud can load balance queries and subscriptions
|
|
||||||
across read replicas while sending all mutations and metadata API calls
|
|
||||||
to the master. Learn more about Horizontal scaling with Hasura, `here. <https://hasura.io/learn/graphql/hasura-advanced/performance/2-horizontal-scaling/>`__
|
|
||||||
|
|
||||||
.. _faq_slow_api_perf:
|
|
||||||
|
|
||||||
How can I improve the performance of slow running API calls?
|
|
||||||
------------------------------------------------------------
|
|
||||||
|
|
||||||
Hasura allows analyzing queries to identify the slow running calls and use
|
|
||||||
Indexes to improve the performance. Learn more `here. <https://hasura.io/learn/graphql/hasura-advanced/performance/3-analyze-query-plans/>`__
|
|
||||||
@ -29,7 +29,6 @@ Guides / Tutorials / Resources
|
|||||||
Code Editor Integrations <code-editor-integrations/index>
|
Code Editor Integrations <code-editor-integrations/index>
|
||||||
MySQL preview <mysql-preview>
|
MySQL preview <mysql-preview>
|
||||||
Updating to Hasura v2 <upgrade-hasura-v2>
|
Updating to Hasura v2 <upgrade-hasura-v2>
|
||||||
FAQs <faq/index>
|
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
|||||||
@ -30,142 +30,18 @@ This schema is created by the Hasura GraphQL engine to manage its internal state
|
|||||||
table/permission/relationship is created/updated using the Hasura console or the metadata API, the Hasura GraphQL engine
|
table/permission/relationship is created/updated using the Hasura console or the metadata API, the Hasura GraphQL engine
|
||||||
captures that information and stores it in the corresponding tables.
|
captures that information and stores it in the corresponding tables.
|
||||||
|
|
||||||
The following tables are used by the Hasura GraphQL engine:
|
|
||||||
|
|
||||||
**hdb_table** table
|
|
||||||
^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
This table stores information about all the tables/views which are created/tracked using the Hasura console or
|
|
||||||
the metadata API.
|
|
||||||
|
|
||||||
Schema
|
|
||||||
""""""
|
|
||||||
|
|
||||||
.. thumbnail:: /img/graphql/core/engine-internals/hdb_table.jpg
|
|
||||||
:width: 30%
|
|
||||||
:alt: hdb_table schema
|
|
||||||
|
|
||||||
Column Definitions
|
|
||||||
""""""""""""""""""
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| column | description |
|
|
||||||
+=====================+==========================================================================================+
|
|
||||||
| table_schema | Captures information about the schema under which a table/view is tracked |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| table_name | Captures name of the tracked table/view. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| is_system_defined | If it is true, then the table/view is created by GraphQL engine for internal purpose. |
|
|
||||||
| | If it is false, then the table/view is created by the end user. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
|
|
||||||
**hdb_relationship** table
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
This table stores information about the relationships created for tables/views using the Hasura console or
|
|
||||||
the metadata API.
|
|
||||||
|
|
||||||
Schema
|
|
||||||
""""""
|
|
||||||
|
|
||||||
.. thumbnail:: /img/graphql/core/engine-internals/hdb_relationship.jpg
|
|
||||||
:width: 30%
|
|
||||||
:alt: hdb_relationship schema
|
|
||||||
|
|
||||||
Column Definitions
|
|
||||||
""""""""""""""""""
|
|
||||||
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| column | description |
|
|
||||||
+=====================+==========================================================================================+
|
|
||||||
| table_schema | Captures information about the schema under which a relationship is created. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| table_name | Captures name of the table/view under which a relationship is created. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| rel_name | Captures name of the relationship. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| rel_type | Captures the permission type (insert/select/update/delete). |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| perm_def | Captures information about how the relationship is defined. |
|
|
||||||
| | |
|
|
||||||
| | For example: |
|
|
||||||
| | |
|
|
||||||
| | .. code-block:: json |
|
|
||||||
| | |
|
|
||||||
| | { |
|
|
||||||
| | "foreign_key_constraint_on": "user_id" |
|
|
||||||
| | } |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| comment | Captures the comment for the relationship. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| is_system_defined | If it is true, then the relationship is created by GraphQL engine for internal purpose. |
|
|
||||||
| | If it is false, then the relationship is created by the end user. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
|
|
||||||
|
|
||||||
**hdb_permission** table
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
This table stores information about the access control rules on tables/views set up using the Hasura console or
|
|
||||||
the metadata API.
|
|
||||||
|
|
||||||
Schema
|
|
||||||
""""""
|
|
||||||
|
|
||||||
.. thumbnail:: /img/graphql/core/engine-internals/hdb_permission.jpg
|
|
||||||
:width: 30%
|
|
||||||
:alt: hdb_permission schema
|
|
||||||
|
|
||||||
Column Definitions
|
|
||||||
""""""""""""""""""
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| column | description |
|
|
||||||
+=====================+==========================================================================================+
|
|
||||||
| table_schema | Captures information about the schema under which a permission is created. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| table_name | Captures name of the table/view under which a permission is created. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| role_name | Captures name of the role for which this permission will be applicable. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| perm_type | Captures the permission type (insert/select/update/delete). |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| perm_def | Captures information about how the permission is defined. |
|
|
||||||
| | |
|
|
||||||
| | Whenever a request is made with the above role for the above table GraphQL engine |
|
|
||||||
| | will first validate the requested columns with the columns which the user has access to |
|
|
||||||
| | using the ``columns`` key. |
|
|
||||||
| | Once the request is validated the appropriate results are returned after applying the |
|
|
||||||
| | filter defined in the ``filter`` key. |
|
|
||||||
| | |
|
|
||||||
| | For example: |
|
|
||||||
| | |
|
|
||||||
| | .. code-block:: json |
|
|
||||||
| | |
|
|
||||||
| | { |
|
|
||||||
| | "columns": ["id", "name"], |
|
|
||||||
| | "filter": { |
|
|
||||||
| | "id": { |
|
|
||||||
| | "_eq": "X-HASURA-USER-ID" |
|
|
||||||
| | } |
|
|
||||||
| | } |
|
|
||||||
| | } |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| comment | Captures the comment for the permission. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
| is_system_defined | If it is true, then the permission is created by GraphQL engine for internal purpose. If |
|
|
||||||
| | it is false, then the permission is created by the end user. |
|
|
||||||
+---------------------+------------------------------------------------------------------------------------------+
|
|
||||||
|
|
||||||
.. note::
|
|
||||||
|
|
||||||
This section is a work in progress. There have been other tables and columns added to the catalogue to
|
|
||||||
support new features since this was last updated.
|
|
||||||
|
|
||||||
Exploring the catalogue
|
Exploring the catalogue
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
You can check the current schema and contents of the catalogue by exploring the ``hdb_catalog``
|
You can check the current schema and contents of the catalogue by exploring the ``hdb_catalog``
|
||||||
schema in the metadata database through a Postgres client.
|
schema in the metadata database through a Postgres client.
|
||||||
|
|
||||||
|
.. admonition:: Hasura Cloud
|
||||||
|
|
||||||
|
The metadata for Hasura Cloud projects is stored in dedicated databases managed by Hasura Cloud itself, hence the metadata
|
||||||
|
catalogue will not be set up on the user's connected database(s).
|
||||||
|
*(Though note that if any event triggers are defined on a database, then their invocation logs will be stored in the "hdb_catalog" schema of that database).*
|
||||||
|
|
||||||
Catalogue versioning
|
Catalogue versioning
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
|
|||||||
@ -124,5 +124,6 @@ APIs to provide a unified real-time GraphQL API across all your data sources.
|
|||||||
API Reference <api-reference/index>
|
API Reference <api-reference/index>
|
||||||
How It Works <how-it-works/index>
|
How It Works <how-it-works/index>
|
||||||
Troubleshooting <troubleshooting/index>
|
Troubleshooting <troubleshooting/index>
|
||||||
|
FAQs <faq/index>
|
||||||
guides/index
|
guides/index
|
||||||
security-disclosure/index
|
security-disclosure/index
|
||||||
|
|||||||
@ -73,4 +73,3 @@ Discord
|
|||||||
If you didn't find a solution in any of the above mentioned sections or if you prefer to troubleshoot with the community,
|
If you didn't find a solution in any of the above mentioned sections or if you prefer to troubleshoot with the community,
|
||||||
feel free to join our `Discord server <https://hasura.io/discord>`__. Other users might have come across the same issues,
|
feel free to join our `Discord server <https://hasura.io/discord>`__. Other users might have come across the same issues,
|
||||||
and the Hasura community on Discord is very active and helpful.
|
and the Hasura community on Discord is very active and helpful.
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user