华为云ASTRO轻应用-按条件查询对象数据:请求参数

时间:2025-05-07 16:59:14

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

condition

Object

参数解释

表示查询的条件,包含以下元素,若为空则表示查询所有对象数据。

  • conjunction:表示需要满足的条件个数。
    • AND:表示条件都要满足。
    • OR:表示至少要满足一个条件。
  • conditions:筛选条件的数组。如果参数为空,代表查询所有对象数据,若不为空,其中的每一个元素对象都包含如下三个字段。
    • field:字段名称。
    • operator:操作符。例如,“eq”表示等于、“ne”表示不等于、“gt”表示大于、“lt”表示小于、“ge”表示大于等于、“le”表示小于等于。
    • value:对比值。
  • relation:数组中包含parents(向上查询)和children(向下查询)两个元素,两者分别对应相应的数组。

    其中,parents包含condition数组和relatedField(关联字段名称)。children包含condition数组和relationName(关联字段名称)。

约束限制

不涉及。

relation

Object

参数解释

关联查询,包含parents(向上查询)和children(向下查询)两个元素,两者分别对应相应的数组。

其中,parents包含condition数组和relatedField(关联字段名称)。children包含condition数组和relationName(关联字段名称)。

condition数组包含conjunction、conditions和relation,参数解释同condition。

{  
    //向上查询
    parents: [  //第一级父对象
      {
        relatedField: "CarHolder__ CS T",  //当前对象的字段(Lookup/MasterDetail类型),据此确定父对象
        options: {
          fields: ["id", "name", "Age__CST"] //父对象的待查字段
        },
        parents: [ //(可选)第二级父对象
          {
            relatedField: "cust__CST", //父对象的字段(Lookup/MasterDetail类型),据此确定祖父对象
            options: {
              fields: ["id", "name", "Email__CST"] //祖父对象的待查字段
            }
          }
        ]
      }
    ],
    //向下查询
    childs: [   //第一级子对象
      {
        relationName: "Contacts", //子对象关系名(子对象定义Lookup/MasterDetail时指定),据此确定子对象
        options: {
          fields: ["id", "name", "Age__CST", "cust__CST"] //子对象的待查字段
      },
      childs: [  //(可选)第二级子对象
        {
            relationName: "ContactCars", //孙子对象关系名
            options: {
              fields: ["id", "name", "Price__CST", "CarHolder__CST"]  //孙子对象待查字段
            }
        }
      ]
      }
    ]
  }

约束限制

不涉及。

options

Object

参数解释

附加选项,对查询返回的结果进行一些操作。

  • orderBy:按指定字段的值排序,取值为asc(升序)和desc(降序)
    options: {
                orderby: [
                    {
                        field: "name",
                        order: db.Order.desc
                    }
                ],
              }
  • groupby:按照指定字段进行分组
    options: {
                groupby: [
                    {
                        field: "name",
                    }
                ],
              }
  • distinct:去重
    options: {
                distinct: true,
              }
  • 限制查询返回的记录数:通过skip值指定从第多少条开始,limit指定总共返回多少条记录
    {
              options: {
                skip: 100,
                limit: 100
              }
          }

约束限制

不涉及。

support.huaweicloud.com/api-astrozero/astrozero_api_0024.html