Srikar Chamarthy
03/24/2026, 1:23 AMkapa.ai
03/24/2026, 1:24 AMSrikar Chamarthy
03/24/2026, 1:25 AMSrikar Chamarthy
03/24/2026, 1:26 AMkapa.ai
03/24/2026, 1:26 AMTerminating due to java.lang.OutOfMemoryError: Java heap space is a well-known issue in Airbyte, particularly when syncing large tables or large volumes of CDC changes. Here's what the knowledge sources tell us: What's Happening The Java process running your source connector is running out of heap memory. This can happen when:
• Syncing very large tables (hundreds of millions of rows)
• Processing large CDC change sets (e.g., 70M+ row changes in a single run) [Java heapspace issue]
• The Postgres source connector's JDBC fetchSize is calculated as 60% of JVM heap, making memory requirements unpredictable, especially with variable row sizes (e.g., JSON columns) [Postgres fetchSize OOM] How to Fix It 1. Increase Resource Limits via Helm (values.yaml) global:
jobs:
resources:
limits:
cpu: "4"
memory: "8Gi"
requests:
cpu: "2"
memory: "4Gi"
Or use environment variables: JOB_MAIN_CONTAINER_CPU_LIMIT, JOB_MAIN_CONTAINER_MEMORY_LIMIT, etc. [SAP HANA issue] 2. Set Connection-Level Resource Requirements You can update the connection table directly in the Airbyte database:
UPDATE connection
SET resource_requirements = '{"cpu_limit": "1.5", "cpu_request": "1.0", "memory_limit": "20Gi", "memory_request": "13Gi"}'
WHERE id = '<your-connection-id>';
[Java heapspace issue] 3. Known Limitation: Orchestrator Memory Be aware that there is an open issue where CONTAINER_ORCHESTRATOR_MEMORY_LIMIT and REPLICATION_ORCHESTRATOR_MEMORY_LIMIT environment variables are ignored and the orchestrator always uses 1Gi. The connection.resource_requirements workaround works for source/destination containers but not for the orchestrator. [Orchestrator memory issue] 4. Linux Kernel Consideration If you're running on a newer Red Hat-based or Ubuntu Linux kernel (e.g., 6.14.x), there is an open issue where OOM kills are significantly worse. Downgrading the kernel (e.g., to 6.8.x on Ubuntu) has been reported as a workaround. [OOM on newer kernels]
In summary, the most actionable steps are to increase memory limits at the connection or global job level, and ensure your connector is up to date. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Srikar Chamarthy
03/24/2026, 2:39 AMkapa.ai
03/24/2026, 2:39 AMOutOfMemoryError: Java heap space error, the table sizes you're seeing failures on (ranging from 0.5 × 10,000 / 1,000 = 5 GB of RAM [Scaling Airbyte]
Additionally, for JDBC-based connectors (like CockroachDB, which uses a Postgres-compatible driver), the fetchSize is calculated as 60% of JVM heap, and since it only samples the first 10 rows to estimate row size, it can significantly underestimate memory needs for tables with variable-length columns (TEXT, JSON, arrays). [Postgres fetchSize OOM]
Java connectors also default to using only 1/4 of the host's allocated memory for the JVM heap, so even if your pod has 8 GB, the connector may only use 2 GB before OOMing. [MySQL to ClickHouse] Recommended Actions 1. Increase memory limits at the connection level:
UPDATE connection
SET resource_requirements = '{"memory_limit": "20Gi", "memory_request": "8Gi"}'
WHERE id = '<your-connection-id>';
[Java heapspace issue]
2. Note the orchestrator limitation: Even with increased source/destination memory, the container orchestrator may still be capped at 1 Gi due to an open bug where CONTAINER_ORCHESTRATOR_MEMORY_LIMIT is ignored. [Orchestrator memory issue]
3. General recommendation: Start with a mid-sized instance (4–8 cores) and gradually tune upward based on your workload. [Scaling Airbyte]
Given your table sizes (up to ~5 GB), you likely need significantly more than the default memory allocation to handle the in-memory buffering safely. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Srikar Chamarthy
03/25/2026, 4:27 PMkapa.ai
03/25/2026, 4:27 PMQuota exceeded for quota metric 'Queries' and limit 'Queries per minute per user' with a limit of 15,000 queries per minute per user.
This is happening because the Gmail source connector is making too many requests to the Gmail API in a short period, exceeding your Google Cloud project's quota. What's Happening The Gmail connector is hitting the defaultPerMinutePerUser quota limit (15,000 queries/min/user) on the Gmail API. Google returns a 403 status code for this rate limit error, which Airbyte's default error handler may treat as a non-retryable permission error rather than a rate limit. [Error Handling] How to Fix It 1. Request a Quota Increase from Google The error response itself suggests this: go to Google Cloud Console and request a higher quota for the Gmail API on your project (project_number:37329956). 2. Configure Rate Limiting in the Connector (if using a custom/forked connector) If you're building or modifying a connector, you can use Airbyte's HTTP API Budget to proactively limit request rates and avoid hitting the quota. For example, using a `MovingWindowCallRatePolicy`: [Rate limiting]
api_budget:
type: "HTTPAPIBudget"
policies:
- type: "MovingWindowCallRatePolicy"
rates:
- limit: 14000 # stay under the 15,000/min limit
interval: "PT1M"
matchers:
- method: "GET"
url_base: "https://gmail.googleapis.com"
url_path_pattern: "^/gmail/v1/users/me/threads" 3. Handle 403 as a Rate Limit Error Since Gmail uses 403 for rate limit errors (not the standard 429), you can configure the connector's error handler to treat 403 as a retryable rate limit response. [Error Handling] 4. Check the Gmail Connector's Rate Limit Headers The HTTP API Budget also supports reading rate limit headers (X-RateLimit-Reset, X-RateLimit-Remaining) to automatically back off when limits are approaching. [Global Configuration]
The most immediate fix is to request a quota increase from Google, as the connector is operating within normal bounds but your project's quota is being exhausted. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Srikar Chamarthy
03/25/2026, 4:28 PMkapa.ai
03/25/2026, 4:29 PMSrikar Chamarthy
03/25/2026, 4:29 PM