数据类型

数据表中支持的数据类型

类型 说明
string 字符串，如 "a" "b"
integer 整数， 如 2 3
number 数字，可以是整数，也可以是浮点数，如 5 6.2 3.1415926
boolean 布尔值， true 或者 false
array 数组， 数组元素支持 string、integer、number、boolean、object、geojson、file、date 8 种类型
object 对象，必须是{...}格式，即对象的字面量形式
geojson 地理位置，支持 GeoPoint、GeoPloygon（点与多边形）两种类型，请参考地理位置操作章节。GeoJSON 具体介绍，请参考 mongoDB 的 GeoJSON Object
date 日期时间，ISO8601 格式的日期字符串，例如："2018-09-01T18:31:02.631000+08:00"
file 文件，记录文件信息的对象（数据结构详见下表）
pointer pointer，指向了其他数据表的某一数据行

file 类型的数据结构

字段 说明
cdn_path 文件在 CDN 中的相对路径
created_at 创建时间
id 文件 id
mime_type 文件类型
name 文件名称
path 上传成功后的访问地址 URL
size 文件尺寸，单位 byte

数据表内置字段 created_at、updated_at 的数据是 integer 类型的 unix 时间戳，而非 date 类型。

数据类型示例

这是一条包含了所有数据类型的记录：

{
  _id: "5baafb910afdde0c2a6dbb8e",
  id: "5baafb910afdde0c2a6dbb8e",
  int: 97,    // integer
  num: 89.11167842607728,   // number
  str: "abcdefg",   //string
  obj: {    // object
    a: "b",
    c: ["apple", "array", "dog"],
    f: {
      num: 123.44
    },
  },
  array_bool: [true, true],   // array field，元素类型为 boolean
  array_int: [123456, 123, 456],   // array field，元素类型为 integer
  array_num: [91.7485922640633, 10.305134978939634],   // array field，元素类型为 number
  array_str: ["abc", "def", "ghi"],   // array field，元素类型为 string
  array_object: [{a: 10}],    // array field，元素类型为 object
  array_date: ['2018-12-12T11:48:04+08:00', '2018-12-12T11:48:04.734000+08:00'],    // array field，元素类型为 date
  array_geojson [{    // array field，元素类型为 geojson
    coordinates: [10.123, 8.543],
    type: "Point"
  }],
  array_file [{    // array field，元素类型为 file
    cdn_path: "1g50PgtbHMNWFntB.png",
    created_at: 1537932176,
    id: "5baafb906e73240d2acfb67e",
    mime_type: "image/png",
    name: "wxfab60d15556a51ec.o6zAJs8v7AFX-FTE2ziIK8E1moJI.8LnYokv8aq4Ubaeaa306f0bbec994ad399bdb97d92ce.png",
    path: "https://cloud-minapp-7894.cloud.ifanrusercontent.com/1g50PgtbHMNWFntB.png",
    size: 105224
  }],
  bool: true,   // boolean
  date: "2018-09-26T11:22:51.100000+08:00",   // date
  file: {   // file
    cdn_path: "1g50PgtbHMNWFntB.png",
    created_at: 1537932176,
    id: "5baafb906e73240d2acfb67e",
    mime_type: "image/png",
    name: "wxfab60d15556a51ec.o6zAJs8v7AFX-FTE2ziIK8E1moJI.8LnYokv8aq4Ubaeaa306f0bbec994ad399bdb97d92ce.png",
    path: "https://cloud-minapp-7894.cloud.ifanrusercontent.com/1g50PgtbHMNWFntB.png",
    size: 105224
  },
  geo_point: {    // geojson
    coordinates: [10.123, 8.543],
    type: "Point"
  },
  geo_polygon: {    // geojson
    coordinates: [[[10.123, 10], [20.12453, 10], [30.564654, 20], [20.654, 30], [10.123, 10]]],
    type: "Polygon"
  },
  pointer_default: {                       // 没有使用 expand 展开时的 pointer 数据格式，为一个 object 对象，包含 id 和 _table 字段
    _table: "schema_name",                 // pointer 指向的表名
    id: "5baafb9061235656789"
  },  
  pointer_expanded: {                      // 在查询中使用 expand('pointer_expanded') 操作后，将会展开为一个数据行对象，注意使用 expand 方法会增加一次数据表查询，api call 计费 +1
    id: "5baafb9061235656789",
    _table: "schema_name",                 // pointer 指向的表名
    created_at: 1537933123,
    created_by: 1,
    updated_at: 1537933123
    // 该行的其他字段...
  }, 
  created_at: 1537932120,
  created_by: 67566799,
  updated_at: 1538031640,
  read_perm: ["user:*"],
  write_perm: ["user:*"]
}

TableRecord 类型

TableRecord 表示数据库中的一条记录，包括 id、创建时间等，其中 recordInfo 包含该记录的所有信息。

属性 类型 说明
id String 记录项 Id
created_by_map Map 创建者信息，只有才查询设置 expand 时才有值。详见过滤与扩展
created_by int 创建者 Id
created_at int 时间戳，创建日期
updated_at int 时间戳，更新日期
recordInfo Map 该记录项的所有信息

RecordList 类型

RecordList 表示一次查询数据库所返回的数据列表以及元数据。

属性 类型 说明
limit int 返回记录的最大个数
offset int 返回记录的起始偏移值
total_count int 记录总数，默认为 -1，表示该属性无效
next String 下一页地址，若值为 null，表示当前为最后一页
previous String 上一页地址，若值为 null，表示当前为第一页
records List 记录数组，每个元素为 TableRecord 类型

查询结果默认不包含 total_count，如需获取该值可以在设置查询条件 Query 时，通过设置 query.withTotalCount(true) 来获取 total_count。详见获取记录总数

TableRecordOperationList 类型

名称 类型 说明
succeed int 成功插入记录数
total_count int 总的待插入记录数
operation_result List TableRecordOperation 数组，包含每条数据是否成功被创建等信息

TableRecordOperation 类型

名称 类型 说明
success Map 记录创建成功信息
error Map 记录创建失败信息

results matching ""

    powered by

    No results matching ""