API 设计最佳实践：使用 json_build_object 将 SQL SELECT 查询构造为类 json 是否是个好主意

Question

我正在开发一个基于 Web 的应用程序，它实现了以下功能：

1. PostgreSQL RDBMS非ORM数据库
2. Django Rest 用于设计和处理后端数据序列化器和 API 请求的框架
3. 对于 GET 方法，使用 json_build_object 设计 SQL SELECT 查询以具有类似 json 的结构

在数据库中

person(personid, fullname, cityid)
city(cityid, cityname, countryid)
country(countryid, countryname)

在序列化器中

class CountrySerializer(serializers.Serializer):
 id=serializers.IntegerField()
 name=serializers.CharField()

class CitySerializer(serializers.Serializer):
 id=IntegerField()
 name=CharField()
 country=CountrySerializer()

class PersonSerializer(serializers.Serializer):
 id=IntegerField()
 person=CharField()
 city=CitySerializer()

在 API 视图中

from .custom_utils import raw_sql_select

class APIView_Person(generics.GenericAPIView):
  serializer_class = PersonSerializer
  permission_classes = (IsAuthenticatedOrReadOnly,)
  def get_queryset(self):
   query=("""
    SELECT
     p.personid as id,
     p.fullname as person,
     json_build_object(
      'id',ct.cityid,
      'name',ct.cityname,
      'country',json_build_object(
        'id',cntry.countryid,
        'name',cntry.countryname
       )
     ) AS city
     FROM persons p
     JOIN city ct ON ct.cityid=p.cityid
     JOIN country cntry ON cntry.countryid=ct.countryid
   """)
   return raw_sql_select(query, "db_connection")

  def get(self, request):
   rows = [
    {
      "id": col.id,
      "person": col.person,
      "city": col.city
    } for col in self.get_queryset()[1]
   ]
   results = PersonSerializer(rows, many=True).data
   return Response(results or [])

在前面

const [state, setState] = useState({
 personList: []
})

useEffect(()=>{
  fetch('/api/persons/', {method: 'GET', headers:{'Content-Type':'application/json'}})
  .then(res=>res.json())
  .then(rows=>setState(states=>({...states,personList:rows})))
}, [])

return(
 <>
  <Typography variant="body1" component="p">{state.person}</Typography>
  <Typography variant="caption" component="p" color="textSecondary">{state.city}, {state.city.country} 
  </Typography>
 </>
)

这就是我的 API 目前的设计方式。

1. 为什么我使用原始 sql 查询？ 因为我使用的数据库不是在我的 Django 应用程序中创建的，所以我没有用于实现 Django 的 ORM 的模型。
2. 为什么我的查询结构类似于 json？ 因为我使用的序列化器不依赖于 model 并且不扩展 ModelSerializer class。

我的问题是：

1. 这是一个好的、可接受的方法吗？
2. 如果数据库结构发生变化，这样的设计是否会在可维护性方面造成未来的问题？
3. 如果我将 CountrySerializer() 从 name=CharField() 更改为 country_name=CharField() 然后更改我的 API 后端逻辑以将响应的 object 键从“name”返回到“country_name”，并且我有 20 个前端模块引用旧的“名称”object 键 - 那么大概我必须编辑这 20 个前端模块以将“名称”引用更改为“国家名称”。 这种类型的维护是否不可避免并被认为是 RESTFul API 中常见的可能遭遇？