Skip to content
About
Main content

Summary and key takeaways

The one sentence. A format is a treaty, a protocol is a conversation with amnesia, an integration is a bookmark. The only thing you ever choose is who does the interpreting, and how many times.

The reframe. At a boundary, and cannot be updated atomically, and the producer may be gone. Efficiency stops being the deciding vote. What decides is the number of parties who can take part without negotiating. Formats win on installed base, not on quality.

One variable, three families

FamilyTime gapContract lives inHard problem
File formatsUnboundedNoneThe bytes, or a agreed earlierWhere does the schema live?
Access protocolsShortFullThe conversationWhat if the conversation dies?
Integration patternsIndefiniteYes, with memory neededDurable external stateWhat is the position, and is it total and ?

Key facts, by part

  • Files. The schema lives nowhere, in the bytes or in a registry. The is paid by the reader, forever. is a property: gets it for free, CSV with quoted newlines does not, and one gzip stream blocks it. Columnar files need a , so they cannot be streamed, and the footer is also a query interface. formats cost total agreement. are specified metadata protocols. Logs have no ending, so they only append and scan. Six agreement-level hazards (encoding, decimal vs. float, /empty/absent, timestamps, integer width, ) make both sides parse correctly and disagree silently.
  • Protocols. You cannot know whether a failed request happened. SQL lets the callee optimize. Dialects come from capability differences. Row are bad for huge results, so large results leave by . makes scale at the price of round trips. Caller-chosen shapes () make cost unpredictable, so defences re-create endpoints. A winning API exports its limits to everybody. Wire compatibility is cheap, semantic compatibility is not. force duplicates, so receivers must be . A protocol must tell callers whether a is safe, must publish its limits, and must plan for versioning cost ( × callers).
  • Integrations. Position must be durable state. A source is only as resumable as its position is total and monotonic. versus is reprocessability, flipped by economics. depends on . Mounting leaves maintenance with nobody. Zero-copy sharing is tighter than a copy. imports analytical delay into operational systems. Paginate by value, not by count. File drop rebuilds protocols from convention: the filename is the protocol, the is the commit, and absence needs a clock to detect.

Three equations and rules of thumb

RuleMeaning
= dual-running time × number of counterpartiesWhy mature interfaces calcify
integrations without a standard, N + M with oneWhy drivers, connectors and shared layouts exist
Pushdown gain = full transfer ÷ filtered transferWhy federation succeeds or fails (1,000× in our example)

Patterns that repeat

  • Early moves cost off the read path and onto the agreement.
  • Costs are conserved: the question is which side pays and whether it can refuse.
  • Manifest plus commit keeps returning wherever a set of objects must become visible at once.
  • Zero-copy through total agreement appears on files, then on the wire.
  • Failures at a boundary are silent: the consumer pays, later.