mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-15 01:12: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>
|
||||
MySQL preview <mysql-preview>
|
||||
Updating to Hasura v2 <upgrade-hasura-v2>
|
||||
FAQs <faq/index>
|
||||
|
||||
.. 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
|
||||
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
|
||||
-----------------------
|
||||
|
||||
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.
|
||||
|
||||
.. 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
|
||||
--------------------
|
||||
|
||||
|
||||
@ -124,5 +124,6 @@ APIs to provide a unified real-time GraphQL API across all your data sources.
|
||||
API Reference <api-reference/index>
|
||||
How It Works <how-it-works/index>
|
||||
Troubleshooting <troubleshooting/index>
|
||||
FAQs <faq/index>
|
||||
guides/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,
|
||||
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.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user