You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@fluss.apache.org by "beryllw (via GitHub)" <gi...@apache.org> on 2025/09/30 06:22:10 UTC
[PR] [docs][lake/iceberg] Add a part about streaming union read in iceberg… [fluss]
beryllw opened a new pull request, #1774:
URL: https://github.com/apache/fluss/pull/1774
… doc
<!--
*Thank you very much for contributing to Fluss - we are happy that you want to help us improve Fluss. To help the community review your contribution in the best possible way, please go through the checklist below, which will get the contribution into a shape in which it can be best reviewed.*
## Contribution Checklist
- Make sure that the pull request corresponds to a [GitHub issue](https://github.com/apache/fluss/issues). Exceptions are made for typos in JavaDoc or documentation files, which need no issue.
- Name the pull request in the format "[component] Title of the pull request", where *[component]* should be replaced by the name of the component being changed. Typically, this corresponds to the component label assigned to the issue (e.g., [kv], [log], [client], [flink]). Skip *[component]* if you are unsure about which is the best component.
- Fill out the template below to describe the changes contributed by the pull request. That will give reviewers the context they need to do the review.
- Make sure that the change passes the automated tests, i.e., `mvn clean verify` passes.
- Each pull request should address only one issue, not mix up code from multiple issues.
**(The sections below can be removed for hotfixes or typos)**
-->
### Purpose
<!-- Linking this pull request to the issue -->
Linked issue: close #1671
<!-- What is the purpose of the change -->
### Brief change log
<!-- Please describe the changes made in this pull request and explain how they address the issue -->
### Tests
<!-- List UT and IT cases to verify this change -->
### API and Format
<!-- Does this change affect API or storage format -->
### Documentation
<!-- Does this change introduce a new feature -->
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [docs][lake/iceberg] Add a part about streaming union read in icebeg doc [fluss]
Posted by "beryllw (via GitHub)" <gi...@apache.org>.
beryllw commented on PR #1774:
URL: https://github.com/apache/fluss/pull/1774#issuecomment-3350215714
During the batch-mode union read test for log tables, an exception occurred.
```
025-09-30 06:16:16,243 ERROR org.apache.flink.runtime.source.coordinator.SourceCoordinatorContext [] - Exception while handling result from async call in SourceCoordinator-Source: fluss_order_log[5]. Triggering job failover.
org.apache.flink.util.FlinkRuntimeException: Failed to list splits for fluss.fluss_order_log to read due to
at org.apache.fluss.flink.source.enumerator.FlinkSourceEnumerator.handleSplitsAdd(FlinkSourceEnumerator.java:629) ~[fluss-flink-1.20-0.8-SNAPSHOT.jar:0.8-SNAPSHOT]
at org.apache.flink.runtime.source.coordinator.ExecutorNotifier.lambda$null$1(ExecutorNotifier.java:83) ~[flink-dist-1.20.0.jar:1.20.0]
at org.apache.flink.util.ThrowableCatchingRunnable.run(ThrowableCatchingRunnable.java:40) [flink-dist-1.20.0.jar:1.20.0]
at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) [?:?]
at java.util.concurrent.FutureTask.run(Unknown Source) [?:?]
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(Unknown Source) [?:?]
at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) [?:?]
at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) [?:?]
at java.lang.Thread.run(Unknown Source) [?:?]
Caused by: java.lang.UnsupportedOperationException: Currently, Batch mode can only be supported if one lake snapshot exists for the table.
at org.apache.fluss.flink.source.enumerator.FlinkSourceEnumerator.lambda$startInBatchMode$0(FlinkSourceEnumerator.java:289) ~[fluss-flink-1.20-0.8-SNAPSHOT.jar:0.8-SNAPSHOT]
at org.apache.flink.runtime.source.coordinator.ExecutorNotifier.lambda$notifyReadyAsync$2(ExecutorNotifier.java:80) ~[flink-dist-1.20.0.jar:1.20.0]
... 6 more
2025-09-30 06:16:16,247 INFO org.apache.flink.runtime.jobmaster.JobMaster [] - Trying to recover from a global failure.
org.apache.flink.util.FlinkException: Global failure triggered by OperatorCoordinator for 'Source: fluss_order_log[5] -> Calc[6] -> HashAggregate[7]' (operator cbc357ccb763df2852fee8c4fc7d55f2).
at org.apache.flink.runtime.operators.coordination.OperatorCoordinatorHolder$LazyInitializedCoordinatorContext.failJob(OperatorCoordinatorHolder.java:651) ~[flink-dist-1.20.0.jar:1.20.0]
at org.apache.flink.runtime.operators.coordination.RecreateOnResetOperatorCoordinator$QuiesceableContext.failJob(RecreateOnResetOperatorCoordinator.java:259) ~[flink-dist-1.20.0.jar:1.20.0]
at org.apache.flink.runtime.source.coordinator.SourceCoordinatorContext.failJob(SourceCoordinatorContext.java:432) ~[flink-dist-1.20.0.jar:1.20.0]
at org.apache.flink.runtime.source.coordinator.SourceCoordinatorContext.handleUncaughtExceptionFromAsyncCall(SourceCoordinatorContext.java:445) ~[flink-dist-1.20.0.jar:1.20.0]
at org.apache.flink.util.ThrowableCatchingRunnable.run(ThrowableCatchingRunnable.java:42) ~[flink-dist-1.20.0.jar:1.20.0]
at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) ~[?:?]
at java.util.concurrent.FutureTask.run(Unknown Source) ~[?:?]
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(Unknown Source) ~[?:?]
at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) ~[?:?]
at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) ~[?:?]
at java.lang.Thread.run(Unknown Source) ~[?:?]
Caused by: org.apache.flink.util.FlinkRuntimeException: Failed to list splits for fluss.fluss_order_log to read due to
at org.apache.fluss.flink.source.enumerator.FlinkSourceEnumerator.handleSplitsAdd(FlinkSourceEnumerator.java:629) ~[fluss-flink-1.20-0.8-SNAPSHOT.jar:0.8-SNAPSHOT]
at org.apache.flink.runtime.source.coordinator.ExecutorNotifier.lambda$null$1(ExecutorNotifier.java:83) ~[flink-dist-1.20.0.jar:1.20.0]
at org.apache.flink.util.ThrowableCatchingRunnable.run(ThrowableCatchingRunnable.java:40) ~[flink-dist-1.20.0.jar:1.20.0]
... 6 more
Caused by: java.lang.UnsupportedOperationException: Currently, Batch mode can only be supported if one lake snapshot exists for the table.
at org.apache.fluss.flink.source.enumerator.FlinkSourceEnumerator.lambda$startInBatchMode$0(FlinkSourceEnumerator.java:289) ~[fluss-flink-1.20-0.8-SNAPSHOT.jar:0.8-SNAPSHOT]
at org.apache.flink.runtime.source.coordinator.ExecutorNotifier.lambda$notifyReadyAsync$2(ExecutorNotifier.java:80) ~[flink-dist-1.20.0.jar:1.20.0]
... 6 more
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [docs][lake/iceberg] Add a part about streaming union read in icebeg doc [fluss]
Posted by "luoyuxia (via GitHub)" <gi...@apache.org>.
luoyuxia merged PR #1774:
URL: https://github.com/apache/fluss/pull/1774
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [docs][lake/iceberg] Add a part about streaming union read in iceberg… [fluss]
Posted by "beryllw (via GitHub)" <gi...@apache.org>.
beryllw commented on PR #1774:
URL: https://github.com/apache/fluss/pull/1774#issuecomment-3350152522
Test docker-compose.yml:
```
services:
coordinator-server:
image: fluss-iceberg-test:0.0.2
command: coordinatorServer
depends_on:
- zookeeper
environment:
- |
FLUSS_PROPERTIES=
zookeeper.address: zookeeper:2181
bind.listeners: FLUSS://coordinator-server:9123
remote.data.dir: hdfs://namenode:8020/fluss-data
datalake.format: iceberg
datalake.iceberg.type: hadoop
datalake.iceberg.warehouse: hdfs://namenode:8020/fluss-lake
ports:
- "9123:9123"
tablet-server:
image: fluss-iceberg-test:0.0.2
command: tabletServer
depends_on:
- coordinator-server
environment:
- |
FLUSS_PROPERTIES=
zookeeper.address: zookeeper:2181
bind.listeners: FLUSS://tablet-server:9123
tablet-server.id: 0
kv.snapshot.interval: 30s
data.dir: /tmp/fluss/data
remote.data.dir: hdfs://namenode:8020/fluss-data
ports:
- "9124:9123"
zookeeper:
restart: always
image: zookeeper:3.9.2
namenode:
image: apache/hadoop:3.3.6
hostname: namenode
user: root
command: ["hdfs", "namenode"]
ports:
- 9870:9870
- 8020:8020
env_file:
- ./config
environment:
ENSURE_NAMENODE_DIR: "/hadoop/dfs/name"
datanode:
image: apache/hadoop:3.3.6
user: root
command: ["hdfs", "datanode"]
env_file:
- ./config
depends_on:
- namenode
ports:
- 9866:9866
- 9864:9864
jobmanager:
image: flink-fluss-iceberg-test:0.0.1
ports:
- "8083:8081"
command: jobmanager
environment:
- |
FLINK_PROPERTIES=
jobmanager.rpc.address: jobmanager
taskmanager:
image: flink-fluss-iceberg-test:0.0.1
depends_on:
- jobmanager
command: taskmanager
environment:
- |
FLINK_PROPERTIES=
jobmanager.rpc.address: jobmanager
taskmanager.numberOfTaskSlots: 6
taskmanager.memory.process.size: 2048m
taskmanager.memory.framework.off-heap.size: 256m
```
flink docker
```
tree -L 4
.
├── config
├── docker-compose-0.8.yml
├── sql-client
│ ├── bin
│ │ └── sql-client
│ ├── Dockerfile
│ ├── lib
│ │ ├── avro-1.12.0.jar
│ │ ├── caffeine-2.9.3.jar
│ │ ├── flink-faker-0.5.3.jar
│ │ ├── fluss-flink-1.20-0.8-SNAPSHOT.jar
│ │ ├── fluss-fs-hdfs-0.8-SNAPSHOT.jar
│ │ ├── fluss-lake-iceberg-0.8-SNAPSHOT.jar
│ │ ├── hadoop-apache-3.3.5-2.jar
│ │ ├── iceberg-flink-runtime-1.20-1.9.1.jar
│ │ ├── jackson-annotations-2.15.3.jar
│ │ ├── jackson-core-2.15.3.jar
│ │ ├── jackson-core-asl-1.9.2.jar
│ │ ├── jackson-databind-2.15.3.jar
│ │ ├── jackson-mapper-asl-1.9.2.jar
│ │ ├── parquet-avro-1.15.2.jar
│ │ ├── parquet-column-1.15.2.jar
│ │ ├── parquet-common-1.15.2.jar
│ │ ├── parquet-encoding-1.15.2.jar
│ │ ├── parquet-format-structures-1.15.2.jar
│ │ ├── parquet-hadoop-1.15.2.jar
│ │ ├── parquet-jackson-1.15.2.jar
│ │ └── protobuf-java-2.5.0.jar
│ ├── opt
│ │ └── fluss-flink-tiering-0.8-SNAPSHOT.jar
│ └── sql
│ └── sql-client.sql
└── test.txt
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [docs][lake/iceberg] Add a part about streaming union read in icebeg doc [fluss]
Posted by "luoyuxia (via GitHub)" <gi...@apache.org>.
luoyuxia commented on PR #1774:
URL: https://github.com/apache/fluss/pull/1774#issuecomment-3350294172
> During the batch-mode union read test for log tables, an exception occurred.
>
> ```
> 2025-09-30 06:17:05,276 INFO org.apache.flink.runtime.jobmaster.JobMaster [] - Trying to recover from a global failure.
> org.apache.flink.util.FlinkException: Global failure triggered by OperatorCoordinator for 'Source: fluss_order_log[35] -> Calc[36] -> HashAggregate[37]' (operator cbc357ccb763df2852fee8c4fc7d55f2).
> at org.apache.flink.runtime.operators.coordination.OperatorCoordinatorHolder$LazyInitializedCoordinatorContext.failJob(OperatorCoordinatorHolder.java:651) ~[flink-dist-1.20.0.jar:1.20.0]
> at org.apache.flink.runtime.operators.coordination.RecreateOnResetOperatorCoordinator$QuiesceableContext.failJob(RecreateOnResetOperatorCoordinator.java:259) ~[flink-dist-1.20.0.jar:1.20.0]
> at org.apache.flink.runtime.source.coordinator.SourceCoordinatorContext.failJob(SourceCoordinatorContext.java:432) ~[flink-dist-1.20.0.jar:1.20.0]
> at org.apache.flink.runtime.source.coordinator.SourceCoordinatorContext.handleUncaughtExceptionFromAsyncCall(SourceCoordinatorContext.java:445) ~[flink-dist-1.20.0.jar:1.20.0]
> at org.apache.flink.util.ThrowableCatchingRunnable.run(ThrowableCatchingRunnable.java:42) ~[flink-dist-1.20.0.jar:1.20.0]
> at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) ~[?:?]
> at java.util.concurrent.FutureTask.run(Unknown Source) ~[?:?]
> at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(Unknown Source) ~[?:?]
> at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) ~[?:?]
> at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) ~[?:?]
> at java.lang.Thread.run(Unknown Source) ~[?:?]
> Caused by: org.apache.flink.util.FlinkRuntimeException: Failed to list splits for fluss.fluss_order_log to read due to
> at org.apache.fluss.flink.source.enumerator.FlinkSourceEnumerator.handleSplitsAdd(FlinkSourceEnumerator.java:629) ~[fluss-flink-1.20-0.8-SNAPSHOT.jar:0.8-SNAPSHOT]
> at org.apache.flink.runtime.source.coordinator.ExecutorNotifier.lambda$null$1(ExecutorNotifier.java:83) ~[flink-dist-1.20.0.jar:1.20.0]
> at org.apache.flink.util.ThrowableCatchingRunnable.run(ThrowableCatchingRunnable.java:40) ~[flink-dist-1.20.0.jar:1.20.0]
> ... 6 more
> Caused by: java.lang.UnsupportedOperationException: Currently, Batch mode can only be supported if one lake snapshot exists for the table.
> at org.apache.fluss.flink.source.enumerator.FlinkSourceEnumerator.lambda$startInBatchMode$0(FlinkSourceEnumerator.java:289) ~[fluss-flink-1.20-0.8-SNAPSHOT.jar:0.8-SNAPSHOT]
> at org.apache.flink.runtime.source.coordinator.ExecutorNotifier.lambda$notifyReadyAsync$2(ExecutorNotifier.java:80) ~[flink-dist-1.20.0.jar:1.20.0]
> ... 6 more
> ```
Expected since we have to wait lake snapshot generated.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [docs][lake/iceberg] Add a part about streaming union read in icebeg doc [fluss]
Posted by "luoyuxia (via GitHub)" <gi...@apache.org>.
luoyuxia commented on PR #1774:
URL: https://github.com/apache/fluss/pull/1774#issuecomment-3350396993
@beryllw Hi, I append a some commit to unify iceberg and paimon documenet. PTAL
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [docs][lake/iceberg] Add a part about streaming union read in icebeg doc [fluss]
Posted by "Copilot (via GitHub)" <gi...@apache.org>.
Copilot commented on code in PR #1774:
URL: https://github.com/apache/fluss/pull/1774#discussion_r2390015121
##########
website/docs/streaming-lakehouse/integrate-data-lakes/iceberg.md:
##########
@@ -406,6 +406,40 @@ All Iceberg tables created by Fluss include three system columns:
## Read Tables
+### Reading with Apache Flink
+
+For a table with the option 'table.datalake.enabled' = 'true', its data exists in two layers: one remains in Fluss, and the other has already been tiered to Iceberg.
+You can have a combined view of both Fluss and Iceberg data, which provides second-level latency but may result in slightly degraded query performance.
+Read data only from Iceberg not supported now.
+
+#### Union Read of Data in Fluss and Iceberg
+
+##### Prerequisites
+
+Prepare flink environment. See the [🚀 Start Tiering Service to Iceberg](#-start-datalake-tiering-service) for detailed instructions.
+
+##### Union Read
+
+To read the full dataset, which includes both Fluss (fresh) and Iceberg (historical) data, simply query the table without any suffix. The following example illustrates this:
+
+```sql
+-- Set execution mode to streaming or batch, here just take batch as an example
+SET 'execution.runtime-mode' = 'streaming';
+
+-- Query will union data from Fluss and Paimon
Review Comment:
The comment mentions 'Paimon' but this documentation is about Iceberg integration. It should say 'Query will union data from Fluss and Iceberg'.
```suggestion
-- Query will union data from Fluss and Iceberg
```
##########
website/docs/streaming-lakehouse/integrate-data-lakes/iceberg.md:
##########
@@ -406,6 +406,40 @@ All Iceberg tables created by Fluss include three system columns:
## Read Tables
+### Reading with Apache Flink
+
+For a table with the option 'table.datalake.enabled' = 'true', its data exists in two layers: one remains in Fluss, and the other has already been tiered to Iceberg.
+You can have a combined view of both Fluss and Iceberg data, which provides second-level latency but may result in slightly degraded query performance.
+Read data only from Iceberg not supported now.
Review Comment:
The sentence has grammatical issues. It should be 'Reading data only from Iceberg is not supported now.' or 'Reading data only from Iceberg is not currently supported.'
```suggestion
Reading data only from Iceberg is not supported now.
```
##########
website/docs/streaming-lakehouse/integrate-data-lakes/iceberg.md:
##########
@@ -406,6 +406,40 @@ All Iceberg tables created by Fluss include three system columns:
## Read Tables
+### Reading with Apache Flink
+
+For a table with the option 'table.datalake.enabled' = 'true', its data exists in two layers: one remains in Fluss, and the other has already been tiered to Iceberg.
+You can have a combined view of both Fluss and Iceberg data, which provides second-level latency but may result in slightly degraded query performance.
+Read data only from Iceberg not supported now.
+
+#### Union Read of Data in Fluss and Iceberg
+
+##### Prerequisites
+
+Prepare flink environment. See the [🚀 Start Tiering Service to Iceberg](#-start-datalake-tiering-service) for detailed instructions.
+
+##### Union Read
+
+To read the full dataset, which includes both Fluss (fresh) and Iceberg (historical) data, simply query the table without any suffix. The following example illustrates this:
+
+```sql
+-- Set execution mode to streaming or batch, here just take batch as an example
+SET 'execution.runtime-mode' = 'streaming';
+
+-- Query will union data from Fluss and Paimon
+select avg(total_price) from fluss_order;
+```
+
+It supports both batch and streaming modes, using Iceberg for historical data and Fluss for fresh data:
+
+- In batch mode (only log table)
+
+- In streaming mode(pk table and log table)
Review Comment:
Missing space before the opening parenthesis in 'streaming mode(pk table'. It should be 'streaming mode (pk table and log table)'.
```suggestion
- In streaming mode (pk table and log table)
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [docs][lake/iceberg] Add a part about streaming union read in icebeg doc [fluss]
Posted by "beryllw (via GitHub)" <gi...@apache.org>.
beryllw commented on PR #1774:
URL: https://github.com/apache/fluss/pull/1774#issuecomment-3350234759
[jobmanager.log](https://github.com/user-attachments/files/22612456/jobmanager.log)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org