Acceleration docs (#114)

* Acceleration spec

* default

* Update spiceaidocs/content/en/reference/Spicepod/datasets.md

Co-authored-by: Luke Kim <[email protected]>

* Update spiceaidocs/content/en/reference/Spicepod/datasets.md

Co-authored-by: Luke Kim <[email protected]>

* Update spiceaidocs/content/en/reference/Spicepod/datasets.md

Co-authored-by: Luke Kim <[email protected]>

* Update spiceaidocs/content/en/reference/Spicepod/datasets.md

Co-authored-by: Luke Kim <[email protected]>

* Fixes

---------

Co-authored-by: Luke Kim <[email protected]>

spiceaidocs/content/en/reference/Spicepod/datasets.md

@@ -108,13 +108,35 @@ Optional. Accelerate queries to the dataset by caching data locally.
 
 ## `acceleration.enabled`
 
-Optional. Enable or disable acceleration.
+Enable or disable acceleration, defaults to `true`.
 
-## `acceleration.refresh`
+## `acceleration.engine`
 
-Optional. The interval to refresh the data for the dataset if the dataset type is overwrite.
+The acceleration engine to use, defaults to `arrow`. The following engines are supported:
 
-For `append` datasets, the refresh interval not used.
+  - `arrow` - Accelerated in-memory backed by Apache Arrow DataTables.
+  - `duckdb` - Accelerated by an embedded DuckDB database.
+  - `postgres` - Accelerated by an embedded DuckDB database.
+
+## `acceleration.mode`
+
+Optional. The mode of acceleration. The following values are supported:
+
+  - `memory` - Store acceleration data in-memory.
+  - `file` - Store acceleration data in a file.
+
+`mode` is currently only supported for the `duckdb` engine.
+
+## `acceleration.refresh_mode`
+
+Optional. How to refresh the dataset. The following values are supported:
+
+  - `full` - Refresh the entire dataset.
+  - `append` - Append new data to the dataset.
+
+## `acceleration.refresh_interval`
+
+Optional. How often data should be refreshed. Only supported for `full` datasets. For `append` datasets, the refresh interval not used.
 
 i.e. `1h` for 1 hour, `1m` for 1 minute, `1s` for 1 second, etc.
 
@@ -123,3 +145,11 @@ i.e. `1h` for 1 hour, `1m` for 1 minute, `1s` for 1 second, etc.
 Optional. Only supported for `append` datasets. Specifies how long to retain data updates from the data source before they are deleted.
 
 If not specified, the default retention is to keep all data.
+
+## `acceleration.params`
+
+Optional. Parameters to pass to the acceleration engine. The parameters are specific to the acceleration engine used.
+
+## `acceleration.engine_secret`
+
+Optional. The secret store key to use the acceleration engine connection credential. For supported data connectors, use `spice login` to store the secret.