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

时间:2025-02-12 14:56:04

请求参数

表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