Developer
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Dec 1, 2025

Forge SQL limits

Forge SQL offers a multi-tenant SQL solution offering tenant isolation and stable query performance. To do so, we add a few constraints over and above TiDB's limitations:

  • Foreign keys are not supported. You can still perform JOIN operations, but DELETE operations will not be cascaded.

  • Each SQL statement can only contain a single query.

The following limits also apply:

Per-install limits

The following limits are applied to your app's Forge SQL usage on a per-install basis:

ResourceLimit
Total stored data1 GiB (production installs)
256 MiB (staging installs)
128 MiB (development or custom environment installs)
Number of tables200
DML Requests per second (RPS)150
DDL Requests per minute (RPM)25
Size per row6Mib
Total query execution time for all current invocations62.5 seconds (within each minute)

App databases provisioned and managed via Forge SQL are backed up periodically.

Query and response limits

The following limits apply to each query sent and response received by your app's Forge SQL database functions:

ResourceLimit
Memory usage per query16 MiB
Query time per minute (s/minute)62.5 seconds
Request size1 MiB
Response size4 MiB
Per-connection timeout for SELECT queries5 seconds
Per-connection timeout for INSERT, UPDATE, and DELETE queries10 seconds
Per-connection query timeoutfor DDL queries 20 seconds

SOC2 and ISO compliance

Forge SQL has not yet undergone external assessment for SOC 2 or ISO certification. As we continue development on Forge SQL, we will aim to include it in our standard audit certification reporting cycle.

Versioning

If you add Forge SQL to an existing app, admins of that app's current installations must review and consent before updating.

As such, adding Forge SQL to an existing app will require a major version upgrade. This will be triggered through the sql module (which is required to enable Forge SQL on an app).

Rate this page: