如何从 FaunaDB 的集合中获取所有文档？

Posted 2023-02-27

【中文标题】如何从 FaunaDB 的集合中获取所有文档？

【英文标题】：How to get all documents from a collection in FaunaDB?

【发布时间】：2020-08-12 17:54:15

【问题描述】：

我已经有了答案：

const faunadb = require('faunadb')
const q = faunadb.query

exports.handler = async (event, context) => 
  const client = new faunadb.Client(
    secret: process.env.FAUNADB_SERVER_SECRET
  ) 

  try   
    // Getting the refs with a first query
    let refs = await client.query(q.Paginate(q.Match(q.Index('skus'))))
    // Forging a second query with the retrieved refs
    const bigQuery = refs.data.map((ref) => q.Get(ref))
    // Sending over that second query
    let allDocuments = await client.query(bigQuery)
    // All my documents are here!
    console.log('@allDocuments: ', allDocuments);
    //...
   catch (err) 
    // ...
  

但我觉得它不令人满意，因为我正在对似乎最微不足道的数据库调用进行 2 次查询。这对我来说似乎效率低下而且冗长。

由于我刚刚了解 FaunaDB，所以这里可能有些东西我没有掌握。 我的问题可以分为 3 个：

我可以在一次调用中查询所有文档吗？ 如果不是，为什么不呢？这样的设计背后的逻辑是什么？ 我可以在没有索引的情况下进行这样的查询吗？

【参考方案1】：

FaunaDB 的 FQL 语言与 javascript 非常相似（如果您想进行条件事务等，这很有帮助）。

本质上，FaunaDB 也有一个 Map。鉴于您的索引仅包含一个 value 作为参考，您可以这样写：

q.Map(
  q.Paginate(q.Match(q.Index('skus'))),
  q.Lambda(x => q.Get(x))
)

对于这种特定情况，您实际上不需要索引，因为每个集合都有一个内置的默认索引，可以通过“文档”功能进行全选。

q.Map(
  q.Paginate(Documents(Collection('<your collection>'))),
  q.Lambda(x => q.Get(x))
)

现在，如果您使用的索引返回多个值（因为您想要对“ref”以外的其他内容进行排序），那么您需要向 Lambda 提供与之前的值数量相同的参数数量在索引中定义。假设我的索引值中有 ts 和 ref 因为我想按时对它们进行排序，那么获取所有值的查询变为：

q.Map(
  q.Paginate(q.Match(q.Index('<your index with ts and ref values>'))),
  q.Lambda((ts, ref) => q.Get(ref))
)

值用于范围查询/排序，但也定义索引返回的内容

回到你的问题：

- 我可以在一次调用中查询所有文档吗？

当然，我建议你这样做。请注意，您将获得的文档会自动分页。您可以通过提供参数来设置页面大小以分页，如果页面更大，将返回“之后”或“之前”属性。可以将 after 或 before 作为参数再次呈现给 Paginate 函数以获取下一页或上一页：https://docs.fauna.com/fauna/current/api/fql/functions/paginate

- 我可以在没有索引的情况下进行这样的查询吗？

不，但您可以使用上述内置索引。 FaunaDB 保护用户免于在没有索引的情况下进行查询。由于它是一个可扩展的数据库，可以包含大量数据并且是现收现付的，因此防止用户在脚下开枪是个好主意:)。分页和强制索引有助于做到这一点。

至于 FQL 不同的原因。 FQL 是一种不像许多查询语言那样具有声明性的语言。相反，它是程序性的，您准确地编写如何获取数据。这有好处：

通过编写如何检索数据，您可以准确预测查询的行为方式，这在现收现付系统中非常有用。 相同的语言可用于安全规则或复杂的条件事务（根据特定条件更新某些实体或跨越不同集合的许多实体）。在 Fauna 中编写一个在一个事务中执行许多操作的查询是很常见的。 我们称为用户定义函数的“存储过程”风格只是用 FQL 而非其他语言编写的。

本教程还讨论了查询，该教程随附 GitHub 存储库中的代码，这可能会给您一个更完整的画面：https://css-tricks.com/rethinking-twitter-as-a-serverless-app/

【讨论】：

嘿，任何想法我怎么能在 python 中做到这一点？

【参考方案2】：

我可以在一次调用中查询所有文档吗？

是的，如果您的收藏量很小。 Paginate 函数默认为每页获取 64 个文档。您最多可以调整 100,000 个文档的页面大小。如果您的集合有超过 100,000 个文档，那么您必须执行多个查询，使用游标来获取后续文档。

详见分页教程：https://docs.fauna.com/fauna/current/tutorials/indexes/pagination

如果不是，为什么不呢？这样的设计背后的逻辑是什么？

对于 SQL 数据库，SELECT * FROM table 既方便又可能是资源噩梦。如果表包含数十亿行，则尝试为该查询提供结果可能会消耗服务器和/或客户端上的可用资源。

Fauna 是一种共享数据库资源。我们希望任何数据库的任何用户都能很好地执行查询，这就要求我们对任何单个事务中涉及的文档数量设置合理的限制。

我可以在没有索引的情况下进行这样的查询吗？

不，是的。

从 Fauna 检索多个结果需要索引，除非您独立跟踪文档的引用。但是，通过 Documents 函数，Fauna 维护了一个内部索引，因此您无需创建自己的索引来访问集合中的所有文档。

详情请参阅文档参考页面：https://docs.fauna.com/fauna/current/api/fql/functions/documents

回到您的示例代码，您正在执行两个查询，但它们可以很容易地合并为一个。 FQL 是高度可组合的。例如：

let allDocuments = await client.query(
  q.Map(
    q.Paginate(q.Documents(q.Collection("skus"))),
    q.Lambda("X", q.Get(q.Var("X")))
  )
)

您对 FQL 冗长的观察是正确的。许多函数式语言都表现出这种冗长。优点是任何接受表达式的函数都可以随意组合。我们的电子商务教程中介绍了可组合性以及如何管理文档间引用的最佳示例之一，特别是描述submit_order 函数的部分：https://docs.fauna.com/fauna/current/tutorials/ecommerce#function