fix

Author: JingsongLi

docs/content/pypaimon/file-cache.md docs/content/program-api/file-cache.mddocs/content/pypaimon/file-cache.md renamed to docs/content/program-api/file-cache.md

@@ -1,8 +1,9 @@
 ---
 title: "Local Disk Cache"
-weight: 7
+weight: 8
 type: docs
 aliases:
+- /program-api/file-cache.html
 - /pypaimon/file-cache.html
 ---
 <!--
@@ -26,7 +27,7 @@ under the License.
 
 # Local Disk Cache
 
-When reading files from remote storage (S3, OSS, HDFS, etc.), each seek+read goes over the network. PyPaimon provides a block-level local disk cache that transparently caches file reads on local disk, significantly reducing remote I/O for repeated access patterns.
+When reading files from remote storage (S3, OSS, HDFS, etc.), each seek+read goes over the network. Paimon provides a block-level local disk cache that transparently caches file reads on local disk, significantly reducing remote I/O for repeated access patterns.
 
 ## Cached File Types
 
@@ -46,6 +47,33 @@ All file types can be added to the whitelist. The default whitelist is `meta,glo
 
 Use `table.copy()` to pass cache options as dynamic parameters:
 
+{{< tabs "enable-cache" >}}
+
+{{< tab "Java" >}}
+
+```java
+import org.apache.paimon.table.Table;
+
+import java.util.HashMap;
+import java.util.Map;
+
+Table table = catalog.getTable(Identifier.create("my_db", "my_table"));
+
+Map<String, String> options = new HashMap<>();
+options.put("file-cache.enabled", "true");
+// optional: customize cache directory and limits
+options.put("file-cache.dir", "/tmp/paimon-file-cache");
+options.put("file-cache.max-size", "2gb");
+options.put("file-cache.block-size", "1mb");
+
+// All subsequent reads on this table instance will use the cache
+table = table.copy(options);
+```
+
+{{< /tab >}}
+
+{{< tab "Python" >}}
+
 ```python
 table = catalog.get_table("db.my_table")
 
@@ -61,6 +89,10 @@ table = table.copy({
 # All subsequent reads on this table instance will use the cache
 ```
 
+{{< /tab >}}
+
+{{< /tabs >}}
+
 ## Cache Options
 
 | Option | Type | Default | Description |

docs/content/pypaimon/global-index.md

@@ -133,4 +133,4 @@ read = read_builder.new_read()
 data = read.to_arrow(scan.plan().splits)
 ```
 
-For better performance when reading from remote storage, consider enabling the [Local Disk Cache]({{< ref "pypaimon/file-cache" >}}).
+For better performance when reading from remote storage, consider enabling the [Local Disk Cache]({{< ref "program-api/file-cache" >}}).

docs/layouts/shortcodes/generated/core_configuration.html

@@ -566,6 +566,36 @@
             <td>String</td>
             <td>Default aggregate function of all fields for partial-update and aggregate merge function.</td>
         </tr>
+        <tr>
+            <td><h5>file-cache.block-size</h5></td>
+            <td style="word-wrap: break-word;">1 mb</td>
+            <td>MemorySize</td>
+            <td>Block size for local disk cache.</td>
+        </tr>
+        <tr>
+            <td><h5>file-cache.dir</h5></td>
+            <td style="word-wrap: break-word;">(none)</td>
+            <td>String</td>
+            <td>Directory for file block cache. Defaults to a 'paimon-file-cache' subdirectory under the system temp directory.</td>
+        </tr>
+        <tr>
+            <td><h5>file-cache.enabled</h5></td>
+            <td style="word-wrap: break-word;">false</td>
+            <td>Boolean</td>
+            <td>Whether to enable local disk block cache for file reads.</td>
+        </tr>
+        <tr>
+            <td><h5>file-cache.max-size</h5></td>
+            <td style="word-wrap: break-word;">9223372036854775807 bytes</td>
+            <td>MemorySize</td>
+            <td>Maximum total size of the local disk block cache. Unlimited by default.</td>
+        </tr>
+        <tr>
+            <td><h5>file-cache.whitelist</h5></td>
+            <td style="word-wrap: break-word;">"meta,global-index"</td>
+            <td>String</td>
+            <td>Comma-separated list of file types to cache. Supported values: meta, global-index, bucket-index, data, file-index.</td>
+        </tr>
         <tr>
             <td><h5>file-index.in-manifest-threshold</h5></td>
             <td style="word-wrap: break-word;">500 bytes</td>