邮资
Graffy的标准Postgres模块. 此模块将 Postgres 表格作为 Graffy 子树挂载 .
要求 页:1 库将安装为对等依赖.
使用量
import pg from '@graffy/pg';
import Graffy from '@graffy/core';
import link from '@graffy/link';
const store = new Graffy();
store.use(path, pg(options));
选项
table,表格的名称。 如未提供,则在path已使用。 这张表格必须存在.idCol:要用作标识的列的名称。 默认为id。此栏必须存在,必须是主要关键或有独特的制约.verCol:存储Graffy版本编号的列名. 此栏必须存在,而且必须有DEFAULTSQL 表达式定义 - 此表达式被评价来计算版本号. Graffy 版本必须单调地增加,所以这个表达式一般基于CURRENT_TIMESTAMP。 。 。 .joins: 其它有外来密钥引用本表中ID列的表格,我们希望用该其他表格的列通过"join"来过滤此表. 值是加入选项的关联名称地图 .- 合并名称是指在过滤表达式中用于引用合并表格的名称。 通常,这些是这些表格的名称.
- 加入选项是具有可选属性的对象
table, (中文(简体) ),idCol, (中文(简体) ),refCol财务报告和审定财务报表verCol。 。 。 .refCol是合并表格中引用此条目的列名称.
connection(单位:千美元) 页:1 客户端或 Pool 对象( 建议), 或构建新 Pool 对象的参数 。 可选的.
数据库连接
Graffy Postgres 可以通过包含 a 来配置每个请求使用特定的 pg.client 对象 pgClient 属性。 这对执行交易,分出,行级安全等都有用.
若无 pgClient 用于特定的操作, Graffy Postgres 返回到“ 全球” pg. client 或 pg. 池对象定义 connection 参数。 如果没有 connection 参数被通过,将使用 PSQL 环境变量创建一个新的 pg.Pool.
数据模型
Graffy Postgres将每个属性解释为一列的名称,但 $count, (中文(简体) ), $sum 如下文汇总部分所述.
这也解释了 $key 用于指定过滤、排序、页码和聚合参数.
过滤器
查询过滤器基于JSON,有点像蒙戈DB.
- 过滤表达式遵循 a 属性, (中文(简体) ), 运算符, (中文(简体) ), 价值 秩序。 秩序。 值为平分值(字符串或数字).
- 属性名称总是对象密钥. 可能跟点有关
.。 。 。 . - 操作员也被放置在物体中,并具有领先性
$。 。 。 . - 值为JSON值.
- 对象中的多个属性结合
AND。数组中的项目与OR。 。 。 . - 支持的操作员有:
$eq: 在大多数情况下可选.$lt, (中文(简体) ),$lte, (中文(简体) ),$gt, (中文(简体) ),$gte区域$re, (中文(简体) ),$ire: Regex 匹配(大小写敏感和不敏感版本)$text: 全文搜索, 总是大小写不敏感$not: 修改其他过滤器或倒置一个条件$and, (中文(简体) ),$or: 组合条件; 在大多数情况下可选$all, (中文(简体) ),$has, (中文(简体) ),$any: 对集合的元素(列表或地图)应用条件
基础
{ foo: 5 }财务报告和审定财务报表{ foo: { $eq: 5 } }编译到 SQLfoo = 5。 。 。 .{ foo: { $gt: 5, $lt: 6 } }变成foo > 5 AND foo < 6。 。 。 .{ foo: { $ire: '^wor.*' } }变成foo ~* "^wor.*"。 。 。 .{ foo: { $text: 'potatoes' } }变成foo @@ websearch_to_tsquery('potatoes')。 。 。 . 为了成功,foo必须是 TSVector 列.
或者说
{ foo: [5, 6] }表示 等价为5或等价为6,编译器足够聪明,可以简化到foo IN (5, 6)没有单独的美元.{ foo: [ 5, { $gt: 6 } ] }变成foo = 5 OR foo > 6[ { foo: 6 }, { bar: 7 } ]变成foo = 6 OR bar = 7
没有
{ foo: { $not: 6 } }变成foo <> 6(SQL 不等于运算符){ foo: { $not: [5, 6] }变成foo NOT IN (5, 6){ foo: { $not: [ 5, { $gt: 6 } ] } }变成NOT (foo = 5 OR foo > 6)
逻辑
-
默认,对象表示
AND数组表示OR数字 :[ { foo: 5, bar: 6 }, { baz: 7, qux: 4 } ]变成(foo = 5 AND bar = 6) OR (baz = 7 AND qux = 4) -
使用
$and财务报告和审定财务报表$or操作员明确在两种上下文中使用任何结构:{ $and: [ { $or: { foo: 5, bar: 6 } }, { $or: { baz: 7, qux: 4 } } ] }变成(foo = 5 OR bar = 6) AND (baz = 7 OR qux = 4)。 。 。 .
包含和包含的
{ tags: { $cts: ['foo', 'bar'] } }变成tags @> '{"foo","bar"}'。 。 。 . 标记必须包含两者 o 财务报告和审定财务报表 栏。请注意,此处的各种条件没有OR语义.{ tags: { $ctd: ['foo', 'bar', 'baz'] } }变成tags <@ '{"foo","bar","baz"}'。 。 。 . 每个标签必须是其中之一 o, (中文(简体) ), 栏 或者说 巴兹。 。 。 .
联合
joinName: { ...expression }, (中文(简体) ),
页:1
- 我们放下几个蒙戈DB操作员,同时保留其能力:
$ne: 不使用$.$in: 使用一连串的数值;它是含$or和$eq的组合.$nin: 使用$not和一系列数值.$exists: 使用null或者说{ $not: null }。邮资不区分undefined财务报告和审定财务报表null,Graffy也一样(至少在这个背景下;它很复杂)
- 葛来菲
$has与 MongoDB 相当$all(每个条件都由阵列中至少一个元素满足). 葛来菲$all(数组的每个元素都符合条件)没有直接的MongoDB等同物,但可以表示为{ $not: { $elemMatch: { $not: (cond) } } } - Graffy对大小写不敏感regex有单独的运算符,在数据库对象中配置文本搜索地块而不是查询. 这让MongoDB的Regex
$options,全文$language等 不必要的. - Graffy 对 MongoDB 运算符没有等效值
$type, (中文(简体) ),$expr, (中文(简体) ),$jsonSchema, (中文(简体) ),$where, (中文(简体) ),$mod, (中文(简体) ),$size和地理空间运营商.
顺序由
Graffy过滤器对象的根必须是对象. (使用时) $or (如果需要的话) 财产 $order 指定顺序。 它的值必须是一系列的顺序指定符,每个都可能是字符串属性名. 顺序是默认递增的; 属性名称可能与 ! 切换到下降.
全文搜索
全文查询通常有三个要求:
- 过滤器 :
{ tsv: { $text: 'query' } }。只返回匹配结果. - 顺序 :
{ $order: [{ $text: ['tsv', 'query'] }], ... }. 按相关性排序结果. - 预测 :
{ tsv: { query: true } }返回相匹配的文档片段.
在三个方面, tsv 是 TSVector 类型的计算列.
合计
在Graffy PG中,使用 $group 参数以$key 表示,特殊属性例如 $count, (中文(简体) ), $sum 在投影中显示. $group 也许 true 或数组.
考虑一个有栏目的书表 authorId 财务报告和审定财务报表 copiesSold我们想要在 copiesSold 栏.
没有分组
假设我们想要我们数据库中所有书籍的总销量. 我们用 $group: true,例如:
{
books: {
$key: { $group: true },
$sum: { copiesSold: true }
}
注意如何指定要和的字段; 这样可以指定多个字段 .
一如既往,结果将反映查询:
books: [{
$key: { $group: true },
$sum: { copiesSold: 12345 }
}]
组合
现在我们假设我们要每个作者分别的总和. 由于我们可能有许多作者,我们可能需要对结果进行纠缠.
组合属性( 如 . authorId)也可以包括在投影中,这些值甚至可能被用于构建链接.
{
books: {
$key: { $group: ['authorId'], $first: 30 },
authorId: true,
author: { namme: true }, // Link to ['users', authorId]
$sum: { copiesSold: true }
}
聚合函数
Graffy 支持以下集合函数.
$count行; 仅指定为$count: true,没有 任何田地下。 (所有其他集合函数需要指定字段. )$sum, (中文(简体) ),$avg, (中文(简体) ),$max, (中文(简体) ),$min$card(心率),或列中唯一值的数目