Skip to main content

Limits

A listing of table, data, and query limits.


Since Tableland is still in open beta, each table is limited to the following constraints while the full production network is further clarified. These are temporary limits while the production mainnet is further researched.

Table limits

ConstraintMax size
Rows500000
Columns24

Data limits

Each cell limit is 1kb.

Tableland is not a file storage solution. Instead, use pointers to solutions like IPFS, Filecoin, & Arweave to enable large file integrations and store the pointers in table cells.

info

Since the Tableland network is currently in open beta, row limits have been imposed. When Tableland launches a production network (its own mainnet), there likely won’t be row limits. This is subject to change based on pending research.

Query limits

Query size is limited to a maximum of 35kb.

Recall that mutating queries require an on-chain operation—thus, a limit for write queries must abide by standard blockspace constraints. That is, Tableland inherits EVM-based limitations, including computational gas that exceeds the gas limit. For reference, multiple transactions are fully supported such that one or more SQL statements can exist in a single block, which could near this query limit for a large set of writes.

Note that on Ethereum, due to the block gas limit (30 million gas), the query limit is reached when it is around 14.5kb. In other words, query size is limited to 14.5kb when writing to Ethereum mainnet only; other chains should assume a maximum of 35kb.

tip

You can create tables and write data to it within the same on-chain transaction, but note that database operations are atomic. If one of these fail, then all operations in that transaction fail—so be careful to not exceed the query size limit!

Query "lag"

When a table is created or written to, there will be a "lag" between calling the smart contract and the time at which the event’s SQL instructions are materialized in Tableland. This "lag" is documented below as a chain-driven limitation due to block times.

ChainAverage block finalization time
Ethereum13.5 seconds
Optimism2 seconds
Arbitrum One<0.5 seconds
Arbitrum Nova2-3 seconds
Polygon2 seconds
Filecoin30 seconds

Table reads

All table reads must happen through an off-chain interaction using an unauthenticated REST API call to a Tableland validator node's gateway.

The TL;DR is that table reads directly access the Tableland network, and mutating database instructions (create & write transactions) are on-chain actions. You can make read queries at a gateway, such as the one hosted by the core Tableland team. For more information, see the docs on gateways.

note

It is not possible for a smart contract to read data from a table created in Tableland. Using an oracle or some off-chain logic to write data back on chain (e.g., inbox-outbox type of setup) is an alternative.