This is an automated email from the ASF dual-hosted git repository.
wenjin272 pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/flink-agents.git
The following commit(s) were added to refs/heads/main by this push:
new 9f3f1a34 [docs] Update the document to support asynchronous execution
of cross-language resources (#745)
9f3f1a34 is described below
commit 9f3f1a347cd636ee45d8cdd510066e5082ea2519
Author: Eugene <[email protected]>
AuthorDate: Sat Jun 13 22:12:20 2026 +0800
[docs] Update the document to support asynchronous execution of
cross-language resources (#745)
* [doc] FAQ: remove stale cross-language async limitation
Cross-language resources now support async execution (#05ed9910),
so async availability depends only on language/JDK. Drop the
obsolete cross-language note and references.
* [doc] FAQ: note cross-language async depends on Flink version
Cross-language async needs the pemja 0.5.7 fix (Flink 1.20.5+/2.0.2+/
2.1.3+/2.2.1+); current 2.2.0 builds still run synchronously. Per
review on apache/flink-agents#745.
---
docs/content/docs/faq/faq.md | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/docs/content/docs/faq/faq.md b/docs/content/docs/faq/faq.md
index ba416130..76ed3e03 100644
--- a/docs/content/docs/faq/faq.md
+++ b/docs/content/docs/faq/faq.md
@@ -81,17 +81,17 @@ Async execution can significantly improve performance by
allowing multiple opera
| Java (JDK 21+) | ✅ Supported (via Continuation API) |
| Java (JDK < 21) | ❌ Not supported (falls back to synchronous execution) |
-> **Cross-language async limitation**: When using cross-language resources
(e.g., calling Java integrations from Python or vice versa), async execution is
not supported. Cross-language calls always execute synchronously regardless of
your JDK version.
-
This is important because:
- **For Python users**: Async execution is always available.
-- **For Java users on JDK 21+**: Async execution is available, so using native
integrations (instead of cross-language) matters for performance.
-- **For Java users on JDK < 21**: Async execution is **not available
regardless of whether you use native or cross-language integrations**.
Therefore, the cross-language async limitation has **no additional performance
impact** for these users.
+- **For Java users on JDK 21+**: Async execution is available.
+- **For Java users on JDK < 21**: Async execution is not available and falls
back to synchronous execution.
+
+> **Cross-language async note**: Async execution for cross-language resources
requires the pemja 0.5.7 fix, available in Flink 1.20.5+ / 2.0.2+ / 2.1.3+ /
2.2.1+. Current builds target Flink 2.2.0, so cross-language calls still run
synchronously for now; this is resolved automatically once running on a Flink
version that includes the fix.
### Native Integration Support Matrix
-Flink Agents provides built-in integrations for many ecosystem providers. Some
integrations are only available in one language. For those marked as ❌, you can
still use them from the other language via cross-language support, but
cross-language calls do not support async execution.
+Flink Agents provides built-in integrations for many ecosystem providers. Some
integrations are only available in one language. For those marked as ❌, you can
still use them from the other language via cross-language support.
**Chat Models**
