Hasura GraphQL Engine中计算字段对数组类型的限制解析

在PostgreSQL数据库开发中，计算字段(Computed Field)是一个非常实用的功能，它允许开发者在不实际存储数据的情况下，通过函数动态生成字段值。然而，在使用Hasura GraphQL Engine时，开发者可能会遇到一个常见限制：无法直接创建返回数组类型(如text[])的计算字段。

计算字段的类型限制

Hasura对计算字段的返回类型有明确要求，函数返回值必须是以下两种类型之一：

1. 基本类型(BASE type)：包括常见的标量类型如text、integer、boolean等
2. 表类型(SETOF )：返回多行记录的结果集

   PostgreSQL中的数组类型(如text[])属于容器类型(Container type)，不是基本类型，因此Hasura目前不支持直接使用这类类型作为计算字段的返回类型。

   实际案例中的解决方案

   在实际开发中，当确实需要返回数组类型数据时，可以考虑以下两种替代方案：

   1. 使用生成列(Generated Column)

   CREATE OR REPLACE FUNCTION mp.getArrayNamesById(mp_id uuid)
    RETURNS text[]
    LANGUAGE sql
    IMMUTABLE
   AS $function$
       SELECT array_agg(name) FROM (
           SELECT name FROM mp.medical_provider_names 
           WHERE medical_provider_id = mp_id AND deleted_at IS NULL
           UNION ALL 
           (SELECT name FROM mp.medical_providers WHERE medical_provider_id = mp_id)
           UNION ALL 
           (SELECT en_name as name FROM mp.medical_providers WHERE medical_provider_id = mp_id)
       )
   $function$;
   
   ALTER TABLE mp.medical_providers 
   ADD COLUMN names text[] 
   GENERATED ALWAYS AS (mp.getArrayNamesById(medical_provider_id)) STORED;
   

   注意：这种方法会将结果物化存储，且由于使用了IMMUTABLE函数，当源数据变更时，可能需要手动更新主表记录才能刷新生成列的值。

   2. 使用视图(VIEW)替代

   创建包含所需数组结果的视图，然后在Hasura中跟踪该视图：

   CREATE VIEW mp.medical_providers_with_names AS
   SELECT 
       mp.*,
       (
           SELECT array_agg(name) FROM (
               SELECT name FROM mp.medical_provider_names 
               WHERE medical_provider_id = mp.medical_provider_id AND deleted_at IS NULL
               UNION ALL 
               SELECT name FROM mp.medical_providers WHERE medical_provider_id = mp.medical_provider_id
               UNION ALL 
               SELECT en_name as name FROM mp.medical_providers WHERE medical_provider_id = mp.medical_provider_id
           )
       ) AS names
   FROM mp.medical_providers mp;
   

   技术背景解析

   PostgreSQL的类型系统分为几个层次：

   1. 基本类型(BASE type)：最底层的标量类型
   2. 容器类型(Container type)：包括数组、复合类型等
   3. 域类型(Domain type)：基于现有类型的带有约束的类型

   Hasura选择不支持容器类型作为计算字段的返回类型，主要是出于GraphQL类型系统的兼容性和查询性能考虑。GraphQL本身对数组类型的处理方式与PostgreSQL有所不同，直接映射可能会带来复杂性和性能问题。

   最佳实践建议

   1. 对于简单的数组需求，考虑使用JSON类型作为替代
   2. 对于复杂的多值关系，建议使用关联查询而不是数组
   3. 评估是否真的需要数组类型，或许关系型设计更适合你的场景
   4. 如果必须使用数组，考虑上述生成列或视图方案

   理解这些限制背后的设计考量，可以帮助开发者更好地规划数据模型，在Hasura和PostgreSQL的强大功能之间找到平衡点。