Quack: The DuckDB Client-Server Protocol

(duckdb.org)

152 points | by aduffy 5 hours ago

9 comments

  • rglover 2 hours ago
    This is rad. I've been eyeballing using DuckDB in my firm's internal app framework and this just solved the "but how do I horizontally scale this" problem. Kudos to the DuckDB folks. Love "Quack" for the protocol name, too.
  • ashkankiani 44 minutes ago
    My first thought: setting up a self replicating duckdb wrapper over ssh so that I can execute queries on any computer. Can’t wait to play with this!
  • simlevesque 4 hours ago
    I like DuckDB but I'm not sure what it wants to be. There's always new ways to use it and it's not easy to see what's the right one.
    • wenc 1 hour ago
      DuckDB is both a standalone and a component. This effort is actually very coherent and brings it back into a familiar usage model — that of a traditional client server RDBMS.

      RDBMS have always been multi-user concurrent systems. DuckDB is a very fast local engine that has a multitude of use cases because it is a embeddable in other systems.

      It’s like saying what does SQLite wanna be? It’s in your phones, your browser, your desktop apps, iot devices and people have extended it in different directions. The only difference here is that this is first party not third party. But to me it’s a very legible move.

    • whalesalad 3 hours ago
      Our data pipeline produces .duckdb files that our app downloads (it watches the asset in S3 and pulls when etag changes). Makes it easy to get BQ/Clickhouse like performance without running or paying for that infrastructure. Not perfect for all cases, but it handles a lot more than you would expect.
      • duzer65657 2 hours ago
        this is a great use-case for duckdb, but not sure how it maps to the use of this protocol?
    • slotix 2 hours ago
      I read it less as "DuckDB wants to become Postgres" and more as DuckDB becoming an execution layer inside bigger workflows.

      The engine is often not the painful part anymore. The pain is the stuff around it: live DBs, S3 paths, Parquet files, credentials, repeatable runs, exports, validation, and the moment a one-off script quietly becomes infrastructure.

      Quack makes the remote/server part cleaner, but the bigger trend seems to be DuckDB becoming the SQL layer inside tools, not necessarily the final user-facing tool.

    • Lemaxoxo 3 hours ago
      +1

      I can't think of many use cases for this and Arrow Flight, other than moving data around.

      • twoodfin 3 hours ago
        The use case is local user DuckDB talking to MotherDuck for $.

        This is not commercially a terrible idea. Why keep paying Snowflake for bog-standard SQL query workload when SF makes it easy to migrate to Iceberg & commodity engines like MotherDuck?

        • szarnyasg 3 hours ago
          Hello, DuckDB DevRel here. Quack is independent from MotherDuck. MotherDuck has its own proprietary protocol, which has been around for years and it supports things like dual execution – see more here:

          https://duckdb.org/quack/faq#what-is-the-relationship-betwee...

          Of course, in the future MotherDuck can also support Quack, but this is not the only interesting use case for Quack.

          • twoodfin 3 hours ago
            Sure! Not knocking the architecture: Building out peer-to-peer federation in place of client/server makes perfect sense for DuckDB. And I’m a big fan of owning the protocol so you can optimize it to internal structures.

            Just making the point that DuckDB is disruptive technology & what it’s most likely to disrupt.

      • jtbaker 3 hours ago
        uh, doing analytics type queries on large datasets that postgres would choke on, as an RPC? I'm using it (ducklake specifically) to build a lakehouse RPC server that can scale horizontally based on resource utilization in k8s.
        • Lemaxoxo 2 hours ago
          Right, I get that usecase. You have to crunch numbers that sit somewhere, and store the outputs in the same place. DuckLake is great for that. But where does this DuckDB client-server setup fit in?
          • jtbaker 1 hour ago
            Sounds like it means you don't have to wire up the RPC server yourself anymore? Just build a docker container that invokes this quack server command, expose it over the network and connect to it from remote clients using your own access controls?

            Ducklake handles the metadata and storage, but a local duckdb instance connected to it still has to do the compute itself. This lets you federate access to the compute.

            Fun for me, I just finished a big streaming implementation doing essentially the same thing in Go-gRPC with arrow table record batches. It was fun though.

  • hermitcrab 1 hour ago
    I have a C++ application. Everything is in memory during execution. Saved to disk between session as XML. Works great, except that that it is strictly single user and some of my customers would love me to generalize it for multiple concurrent users reading and writing. Performance requirements are quite low - a few thousand records being updated by 2 or 3 people at a time. Would DuckDb + Quack be a good choice for this? Or are there better choices? I looked at SQLite, but I understand it doesn't operate as client server.
    • appplication 1 hour ago
      DuckDB is more for analytics. I don’t think you’re going to find good options for a DB that can handle concurrent users without hosting it in some way server side. It’s certainly possible (think how some games create their own client servers for direct multiplayer) but honestly hosting Postgres or SQLite is ridiculously cheap, easy, and more importantly the standard approach to this issue.
      • hermitcrab 52 minutes ago
        IIRC SQLite is in-process and says in it's documentation that it is not a client-server database.
  • mritchie712 2 hours ago
    > Can I use DuckDB with Quack as the catalog database for DuckLake?

    > Not yet, but we are working on it!

    Seems like a niche use case, but it's the one I'm most interested in.

    Our lakehouse uses ducklake with postgres as the catalog. Seems like a DuckDB / Quack catalog would be an excellent alternative.

    • szarnyasg 2 hours ago
      Well, we are really working on it: https://github.com/duckdb/ducklake/pull/1151

      So you'll be able to test it in a few days.

      • IceWreck 2 hours ago
        Does this mean I can finally connect to a ducklake instnace hosted remotely? i.e. DuckLake is writing to disk on the remote server and my client is just a client.

        Because rn even with Postgres as a catalog my client needs access to the underlying storage to use Ducklake.

        • szarnyasg 1 hour ago
          Yes, Quack resolves this problem. In particular, your client (likely a DuckDB instance) will talk to a remote DuckDB that both has access to the underlying storage and can also serve as the catalog itself.
    • pdet 2 hours ago
      I think that Quack will become the primary option for a DuckLake catalog in the future, for several reasons. To list a few:

      1. No type mismatches for inlining. If you use a non-DuckDB catalog, many types do not have a 1:1 mapping, which introduces additional overhead when operating on those data types.

      2. You get the raw performance of DuckDB analytics (and now transactions) over the catalog. DuckDB reading DuckDB is simply faster than any of our Postgres/SQLite scanners.

      3. No round-trip for retries. We can easily(tm) run the full retry logic on the DuckDB server side. Right now, these retries trigger multiple round trips for Postgres, making it a performance bottleneck for high-contention workloads.

      Disclaimer: I'm a duckdb/ducklake developer.

  • NortySpock 3 hours ago
    Sounds useful for small-ball internal analytics datasets you want to place on shared team server.

    I can definitely see exploring this for some homelab use.

    • arpinum 2 hours ago
      With ducklake this scales well to multi-terabyte data sets. The big benefit of this server protocol is sharing a high memory server and taking advantage of a shared cache for recent data.
  • ozgrakkurt 3 hours ago
    > It would be rather misguided not to build a database protocol on top of HTTP in 2026

    This is wrong, HTTP is bad for transferring large amount of data and it is also bad for doing streaming.

    It is bad for large amount of data because you have timeout issues on some clients, you hit request/response size limits etc.

    It is obviously bad for streaming as there is no concept of streaming in it.

    It is comical to go the path of least resistance so lazy people can put a reverse proxy on top of it. And then say HTTP is the only relevant way to do it in 2026.

    The benchmark doesn't seem to mean much as TCP can max out 50GB/s on a single thread. Pretty sure it can do more than that even. So you could be using anything that isn't terrible and you should get max performance out of this.

    Also the protocol is something else from the format. For example if you are transferring mp4 over ftp and http you can compare that.

    If you are transferring different things over different protocols then the comparison means nothing.

    The benchmark graph for bulk transfer should show more granularity so it is possible to understand how much of the % of the hardware limit it is reaching. Similar to how BLAS GEMM routines are benchmarked based on the % of theoretical max flops of the hardware.

    > 60 million rows (76 GB in CSV format!)

    This reads a bit disingenuous.

    It is dissappointing to see this instead of something like PostgreSQL protocol with support for a columnar format.

    • geysersam 42 minutes ago
      They mention in the benchmarks section that the network they're on is a "up to" 15 Gbps connection. So to max out 50GB/s is not realistic.

      I agree they should have also listed the compressed size of the table instead of only mentioning the CSV size. But the compressed dataset is probably not smaller than 1/10 of the CSV size. If that's the case they're transferring ~8GB in 4.6 s on a 2GB/s (15Gbps) connection. Seems pretty close to max.

    • arpinum 2 hours ago
      It uses http/2, it has streaming.
    • duzer65657 2 hours ago
      really like duckdb and sorry to pile on, but the parent makes some strong points. I wonder if MotherDuck builds on http as well?
  • znite 2 hours ago
    Does this work with duckdb-wasm?
    • PhilippGille 2 hours ago
      It's in the article:

      > HTTP also allows the DuckDB-Wasm distribution to speak Quack natively! So DuckDB running in a browser can e.g., directly connect to a DuckDB instance running in an EC2 server using Quack.

    • hfmuehleisen 2 hours ago
      Maintainer here. Yes!
  • analyticsfs 3 hours ago
    [dead]