跳至正文
Wener Notes

Filter

约 4 分钟阅读
标签：Filter
  • 减少接口数量 - 提升开发效率
  • 增加业务灵活性 - 业务变化接口不变
  • Query - Source + Selector + Filter + Sort + Pagination
  • Condition == Filter
  • Condition
    • {field,op,value}
    • Triple
  • AST
    • 在 Condition 基础上增加逻辑运算符、分组等
    • and, or, not
  • Query Document / DSL
    • { field: { $op: value } }

mongodb

QueryDesc
比较运算符
$eq匹配等于指定值的值。
$gt匹配大于指定值的值。
$gte匹配大于或等于指定值的值。
$in匹配数组中指定的任何值。
$lt匹配小于指定值的值。
$lte匹配小于或等于指定值的值。
$ne匹配不等于指定值的所有值。
$nin不匹配数组中指定的任何值。
逻辑运算符
$and使用逻辑 AND 连接查询子句，返回符合所有子句条件的文档。
$not反转查询表达式的效果，返回不符合查询表达式的文档。
$nor使用逻辑 NOR 连接查询子句，返回不符合所有子句条件的文档。
$or使用逻辑 OR 连接查询子句，返回符合任一子句条件的文档。
元素运算符
$exists匹配具有指定字段的文档。
$type选择字段类型为指定类型的文档。
评估运算符
$expr允许在查询语言中使用聚合表达式。
$jsonSchema根据给定的 JSON Schema 验证文档。
$mod对字段值进行模运算，并选择具有指定结果的文档。
$regex选择值匹配指定正则表达式的文档。
$text执行文本搜索。
$where匹配满足 JavaScript 表达式的文档。
地理空间
$geoIntersects选择与 GeoJSON 几何图形相交的几何图形。2dsphere 索引支持 $geoIntersects。
$geoWithin选择边界 GeoJSON 几何图形内的几何图形。2dsphere 和 2d 索引支持 $geoWithin。
$near返回接近某点的地理空间对象。需要地理空间索引。2dsphere 和 2d 索引支持 $near。
$nearSphere返回接近球面上某点的地理空间对象。需要地理空间索引。2dsphere 和 2d 索引支持 $nearSphere。
数组运算符
$all匹配包含查询中指定的所有元素的数组。
$elemMatch如果数组字段中的元素匹配所有指定的 $elemMatch 条件，则选择文档。
$size选择数组字段大小为指定值的文档。
位运算符
$bitsAllClear匹配一组位位置都为 0 的数字或二进制值。
$bitsAllSet匹配一组位位置都为 1 的数字或二进制值。
$bitsAnyClear匹配一组位位置中任何一位为 0 的数字或二进制值。
$bitsAnySet匹配一组位位置中任何一位为 1 的数字或二进制值。
  • Query & Projection
    • Comparison Query - eq,eq, gt, gte,gte, in, lt,lt, lte, ne,ne, nin
    • Logical Query - and,and, not, nor,nor, or
    • Element Query - exists,exists, type
    • Evaluation Query - expr,expr, jsonSchema, mod,mod, regex, text,text, where
    • Geospatial Query
    • Array Query - all,all, elemMatch, $size
    • Bitwise Query
    • Projection - ,, elemMatch, $slice
  • $expr - MongoDB 3.6+, 2018+
JavaScript
db.monthlyBudget.find({ $expr: { $gt: ['$spent', '$budget'] } });
// 搜索 / FTS
db.article.find({ $text: { $search: 'groceries' } });

mikro-orm

操作符SQL描述
比较
$eq=匹配等于指定值的值。
$gt>匹配大于指定值的值。
$gte>=匹配大于或等于指定值的值。
$inIN匹配数组中指定的任何值。
$lt<匹配小于指定值的值。
$lte<=匹配小于或等于指定值的值。
$ne<>匹配不等于指定值的所有值。
$ninNOT IN不匹配数组中指定的任何值。
$likeLIKE使用 LIKE 操作符。
$reREGEXP使用 REGEXP 操作符。
$fulltextFULL TEXT使用驱动特定的全文搜索功能。
$ilikeILIKE仅限 PostgreSQL。
$overlap&&仅限 PostgreSQL。
$contains@>仅限 PostgreSQL。
$contained<@仅限 PostgreSQL。
$hasKey?仅限 PostgreSQL。
$hasSomeKeys?|仅限 PostgreSQL。
$hasKeys?&仅限 PostgreSQL。
逻辑
$andAND用逻辑 AND 连接查询子句，返回符合两个子句条件的所有文档。
$notNOT反转查询表达式的效果，返回不符合查询表达式的文档。
$orOR用逻辑 OR 连接查询子句，返回符合任一子句条件的所有文档。
集合
$some= ANY查找至少有一条记录符合条件的集合。
$none<> ANY查找没有任何记录符合条件的集合。
$every查找所有记录均符合条件的集合。
TypeScript
const query = [
  //
  { [sql`(select ${1} = ${1})`]: [] },
  { [raw('length(perex)')]: { $gt: 10000 } },
  { [sql`lower(name)`]: name.toLowerCase() },
  { time: sql`now()` },
  { [raw((alias) => `lower(${alias}.name)`)]: name.toLowerCase() },
  // 函数
  { [sql.upper('title')]: 'TITLE' },
  // 字段引用
  { foo: sql.ref('bar') },
];

hasura

  • 类似 mongo 的语法
  • 使用 _ 前缀 - $ 在 graphql 里表示变量
  • Equality - _eq, _neq
  • Greater than or less than - _gt, _lt, _gte, _lte
  • List based search - _in
  • Filter or check for null - _is_null
  • _not
  • _and, _or
  • Text - _like, _nlike, _ilike, _nilike, _similar, _nsimilar, _regex, _nregex, _iregex, _niregex
  • _cast - where:{ address: {_cast: {String: {_ilike: "%bengaluru%"}}} }
  • 参考

supabase

graphql
input BlogFilter {
  nodeId: IDFilter
  id: IntFilter
  name: StringFilter
  description: StringFilter
  createdAt: DatetimeFilter
  updatedAt: DatetimeFilter
  and: [BlogFilter!]
  or: [BlogFilter!]
  not: BlogFilter
}

"""
查询数据的根类型
"""
type Query {
  """
  可分页的`Blog`类型集合
  """
  blogCollection(
    """
    查询集合中的前`n`个记录
    """
    first: Int

    """
    查询集合中的后`n`个记录
    """
    last: Int

    """
    查询提供的游标之前的集合中的值
    """
    before: Cursor

    """
    查询提供的游标之后的集合中的值
    """
    after: Cursor

    """
    从游标后跳过n个值。游标分页的替代方案。不支持向后分页。
    """
    offset: Int

    """
    查询集合时应用到结果集的过滤器
    """
    filter: BlogFilter

    """
    应用到集合的排序顺序
    """
    orderBy: [BlogOrderBy!]
  ): BlogConnection
}

FAQ

Condition vs Filter

  • Condition - 条件
    • 条件描述
    • 更广泛
    • if-then-else / switch-case
    • 逻辑判断、决策分支、程序逻辑、业务规则
    • 侧重于状态或业务逻辑
    • 强调 单个对象 自身状态或逻辑分支
  • Filter - 过滤器
    • 条件的一种具体用途
    • 对 Collection/集合 进行保留筛选 - 减少数据
    • 侧重于数据，用途明确
    • 多用于 API/RESTful/GraphQL

关联信息

反向链接、本文链接的其他页面和外部资料。

反向链接

  • API Design
    笔记 · Filter

    grpc 内部默认 4mb buffer · Google Cloud API 常见设计模式 · - · - · Microsoft/api-guidelines · https://cloud.google.com/apis/design/

站内链接

  • MiniQuery
    笔记 · MiniQuery

    SQL Where like safe filter expression for ORM. · 目标 · 类似 SQL 的 Where 语法 · 学习成本低 · 语法友好直观 - 对比 GraphQL 和 Mongo · 提供安全的查询 - 抽取值作为 binding 参数，避免注入

参考资料

GitHub3 条
其他外链16 条
最近更新commit d1e28d9编辑

FAQ

上一页

AI LLM API

下一页