[Kernel] [Refactor] Add File Path to Action Wrapper (delta-io#4852)

## 🥞 Stacked PR
Use this [link](https://github.com/delta-io/delta/pull/4852/files) to
review incremental changes.
-
[**stack/refactor-batch**](delta-io#4852)
[[Files changed](https://github.com/delta-io/delta/pull/4852/files)]
- [stack/refactor-FB](delta-io#4853)
[[Files
changed](https://github.com/delta-io/delta/pull/4853/files/e335ce14517cecdec073fb2e535fa9a762801e2f..47d4e10a4e6bb9bf2f26e38f57740fd4b43278ed)]

---------
<!--
Thanks for sending a pull request!  Here are some tips for you:
1. If this is your first time, please read our contributor guidelines:
https://github.com/delta-io/delta/blob/master/CONTRIBUTING.md
2. If the PR is unfinished, add '[WIP]' in your PR title, e.g., '[WIP]
Your PR title ...'.
  3. Be sure to keep the PR description updated to reflect all changes.
  4. Please write your PR title to summarize what this PR proposes.
5. If possible, provide a concise example to reproduce the issue for a
faster review.
6. If applicable, include the corresponding issue number in the PR title
and link it in the body.
-->

#### Which Delta project/connector is this regarding?
<!--
Please add the component selected below to the beginning of the pull
request title
For example: [Spark] Title of my pull request
-->

- [ ] Spark
- [ ] Standalone
- [ ] Flink
- [x] Kernel
- [ ] Other (fill in here)

## Description

<!--
- Describe what this PR changes.
- Describe why we need the change.
 
If this PR resolves an issue be sure to include "Resolves #XXX" to
correctly link and close the issue upon merge.
-->
Refactor Action wrapper -> put file Path associated with the
ColumnarBatch to the action wrapper.

## How was this patch tested?

<!--
If tests were added, say they were added here. Please make sure to test
the changes thoroughly including negative and positive cases if
possible.
If the changes were tested in any way other than unit tests, please
clarify how you tested step by step (ideally copy and paste-able, so
that other reviewers can test and check, and descendants can verify in
the future).
If the changes were not tested, please explain why.
-->

## Does this PR introduce _any_ user-facing changes?

<!--
If yes, please clarify the previous behavior and the change this PR
proposes - provide the console output, description and/or an example to
show the behavior difference if possible.
If possible, please also clarify if this is a user-facing change
compared to the released Delta Lake versions or within the unreleased
branches such as master.
If no, write 'No'.
-->

Author: mmmyr

kernel/kernel-api/src/main/java/io/delta/kernel/internal/replay/ActionWrapper.java

@@ -23,15 +23,21 @@ public class ActionWrapper {
   private final ColumnarBatch columnarBatch;
   private final boolean isFromCheckpoint;
   private final long version;
+  private final String filePath;
   /* Timestamp of the commit file if isFromCheckpoint=false */
   private final Optional<Long> timestamp;
 
   ActionWrapper(
-      ColumnarBatch data, boolean isFromCheckpoint, long version, Optional<Long> timestamp) {
+      ColumnarBatch data,
+      boolean isFromCheckpoint,
+      long version,
+      Optional<Long> timestamp,
+      String filePath) {
     this.columnarBatch = data;
     this.isFromCheckpoint = isFromCheckpoint;
     this.version = version;
     this.timestamp = timestamp;
+    this.filePath = filePath;
   }
 
   public ColumnarBatch getColumnarBatch() {
@@ -49,4 +55,8 @@ public long getVersion() {
   public Optional<Long> getTimestamp() {
     return timestamp;
   }
+
+  public String getFilePath() {
+    return filePath;
+  }
 }

kernel/kernel-api/src/main/java/io/delta/kernel/internal/replay/ActionsIterator.java

@@ -337,8 +337,9 @@ private CloseableIterator<ActionWrapper> getNextActionsIter() {
             // If the checkpoint file is a UUID or classic checkpoint, read the top-level
             // checkpoint file and any potential sidecars. Otherwise, look for any other
             // parts of the current multipart checkpoint.
-            CloseableIterator<ColumnarBatch> dataIter =
-                getActionsIterFromSinglePartOrV2Checkpoint(nextFile, fileName);
+            CloseableIterator<FileReadResult> dataIter =
+                getActionsIterFromSinglePartOrV2Checkpoint(nextFile, fileName)
+                    .map(batch -> new FileReadResult(batch, nextFile.getPath()));
             long version = checkpointVersion(nextFilePath);
             return combine(dataIter, true /* isFromCheckpoint */, version, Optional.empty());
           }
@@ -350,13 +351,13 @@ private CloseableIterator<ActionWrapper> getNextActionsIter() {
             // optimizations like reading multiple files in parallel.
             CloseableIterator<FileStatus> checkpointFiles =
                 retrieveRemainingCheckpointFiles(nextLogFile);
-            CloseableIterator<ColumnarBatch> dataIter =
+            CloseableIterator<FileReadResult> dataIter =
                 wrapEngineExceptionThrowsIO(
                     () ->
                         engine
                             .getParquetHandler()
-                            .readParquetFiles(checkpointFiles, deltaReadSchema, checkpointPredicate)
-                            .map(FileReadResult::getData),
+                            .readParquetFiles(
+                                checkpointFiles, deltaReadSchema, checkpointPredicate),
                     "Reading checkpoint sidecars [%s] with readSchema=%s and predicate=%s",
                     checkpointFiles,
                     deltaReadSchema,
@@ -380,17 +381,17 @@ private CloseableIterator<ActionWrapper> readCommitOrCompactionFile(
     // version with actions read from the JSON file for further optimizations later
     // on (faster metadata & protocol loading in subsequent runs by remembering
     // the version of the last version where the metadata and protocol are found).
-    final CloseableIterator<ColumnarBatch> dataIter =
+    final CloseableIterator<FileReadResult> dataIter =
         wrapEngineExceptionThrowsIO(
             () ->
                 engine
                     .getJsonHandler()
                     .readJsonFiles(
-                        singletonCloseableIterator(nextFile), deltaReadSchema, Optional.empty()),
+                        singletonCloseableIterator(nextFile), deltaReadSchema, Optional.empty())
+                    .map(batch -> new FileReadResult(batch, nextFile.getPath())),
             "Reading JSON log file `%s` with readSchema=%s",
             nextFile,
             deltaReadSchema);
-
     return combine(
         dataIter,
         false /* isFromCheckpoint */,
@@ -406,7 +407,7 @@ private CloseableIterator<ActionWrapper> readCommitOrCompactionFile(
    * of the file.
    */
   private CloseableIterator<ActionWrapper> combine(
-      CloseableIterator<ColumnarBatch> fileReadDataIter,
+      CloseableIterator<FileReadResult> fileReadDataIter,
       boolean isFromCheckpoint,
       long version,
       Optional<Long> timestamp) {
@@ -416,12 +417,14 @@ private CloseableIterator<ActionWrapper> combine(
     // enabled, we will read the first batch and try to extract the timestamp from it.
     // We also ensure that rewoundFileReadDataIter is identical to the original
     // fileReadDataIter before any data was consumed.
-    final CloseableIterator<ColumnarBatch> rewoundFileReadDataIter;
+    final CloseableIterator<FileReadResult> rewoundFileReadDataIter;
     Optional<Long> inCommitTimestampOpt = Optional.empty();
     if (!isFromCheckpoint && fileReadDataIter.hasNext()) {
-      ColumnarBatch firstBatch = fileReadDataIter.next();
-      rewoundFileReadDataIter = singletonCloseableIterator(firstBatch).combine(fileReadDataIter);
-      inCommitTimestampOpt = InCommitTimestampUtils.tryExtractInCommitTimestamp(firstBatch);
+      FileReadResult fileReadResult = fileReadDataIter.next();
+      rewoundFileReadDataIter =
+          singletonCloseableIterator(fileReadResult).combine(fileReadDataIter);
+      inCommitTimestampOpt =
+          InCommitTimestampUtils.tryExtractInCommitTimestamp(fileReadResult.getData());
     } else {
       rewoundFileReadDataIter = fileReadDataIter;
     }
@@ -436,11 +439,13 @@ public boolean hasNext() {
 
       @Override
       public ActionWrapper next() {
+        FileReadResult fileReadResult = rewoundFileReadDataIter.next();
         return new ActionWrapper(
-            rewoundFileReadDataIter.next(),
+            fileReadResult.getData(),
             isFromCheckpoint,
             version,
-            finalResolvedCommitTimestamp);
+            finalResolvedCommitTimestamp,
+            fileReadResult.getFilePath());
       }
 
       @Override