@@ -30,7 +30,7 @@ influxdb3 serve \
30
30
--license-email example@email.com \
31
31
--object-store file \
32
32
--data-dir ~ /.influxdb3 \
33
- --log-filter info \
33
+ --log-filter info
34
34
```
35
35
36
36
##### Example environment variables
@@ -239,13 +239,21 @@ configuration--for example, the same bucket.
239
239
#### node-id-from-env
240
240
241
241
Specifies the node identifier used as a prefix in all object store file paths.
242
- Defines this node identified from the specificed environment variable;
243
- this cannot be used with the ` --node-id ` option also specified .
242
+ Takes the name of an environment variable as an argument and uses the value of that environment variable as the node identifier.
243
+ This option cannot be used with the ` --node-id ` option.
244
244
245
245
| influxdb3 serve option | Environment variable |
246
246
| :--------------------- | :----------------------------------- |
247
247
| ` --node-id-from-env ` | ` INFLUXDB3_NODE_IDENTIFIER_FROM_ENV ` |
248
248
249
+ ##### Example using --node-id-from-env
250
+
251
+ ``` bash
252
+ export DATABASE_NODE=node0 && influxdb3 serve \
253
+ --node-id-from-env DATABASE_NODE \
254
+ --cluster-id cluster0 \
255
+ --object-store file \
256
+ --data-dir ~ /.influxdb3/data
249
257
---
250
258
251
259
# ### object-store
@@ -278,7 +286,7 @@ The path to a key file for TLS to be enabled.
278
286
279
287
# ### tls-cert
280
288
281
- To a cert file for TLS to be enabled.
289
+ The path to a cert file for TLS to be enabled.
282
290
283
291
| influxdb3 serve option | Environment variable |
284
292
| :--------------------- | :--------------------- |
@@ -289,7 +297,8 @@ To a cert file for TLS to be enabled.
289
297
# ### tls-minimum-version
290
298
291
299
The minimum version for TLS.
292
- Valid values are ` tls-1.2 ` or ` tls-1.3 ` default is tls-1.2
300
+ Valid values are ` tls-1.2` or ` tls-1.3` .
301
+ Default is ` tls-1.2` .
293
302
294
303
| influxdb3 serve option | Environment variable |
295
304
| :---------------------- | :----------------------- |
@@ -299,8 +308,8 @@ Valid values are `tls-1.2` or `tls-1.3` default is tls-1.2
299
308
300
309
# ### without-auth
301
310
302
- Starts the database with authentication disabled. All requests will be served without any
303
- token or authentication required.
311
+ Disables authentication for all server actions (CLI commands and API requests).
312
+ The server processes all requests without requiring tokens or authentication.
304
313
305
314
---
306
315
@@ -1121,10 +1130,19 @@ Sets the interval to check if the in-memory Parquet cache needs to be pruned.
1121
1130
1122
1131
#### parquet-mem-cache-query-path-duration
1123
1132
1124
- Specifies the duration to check if Parquet files pulled in query path
1125
- require caching, expressed as a human-readable duration (starting from _ now_ )--for example: ` 5h ` , ` 3d ` .
1133
+ A [duration](/influxdb3/enterprise/reference/glossary/#duration) that specifies
1134
+ the time window for caching recent Parquet files in memory. Default is `5h`.
1135
+
1136
+ Only files containing data with a timestamp between `now` and `now - duration`
1137
+ are cached when accessed during queries--for example, with the default `5h` setting:
1138
+
1139
+ - Current time: `2024-06-10 15:00:00`
1140
+ - Cache window: Last 5 hours (`2024-06-10 10:00:00` to now)
1141
+
1142
+ If a query requests data from `2024-06-09` (old) and `2024-06-10 14:00` (recent):
1126
1143
1127
- ** Default:** ` 5h `
1144
+ - **Cached**: Parquet files with data from `2024-06-10 14:00` (within 5-hour window)
1145
+ - **Not cached**: Parquet files with data from `2024-06-09` (outside 5-hour window)
1128
1146
1129
1147
| influxdb3 serve option | Environment variable |
1130
1148
| :---------------------------- | :------------------------------------ |
@@ -1157,8 +1175,8 @@ expressed as a human-readable duration--for example: `20s`, `1m`, `1h`.
1157
1175
1158
1176
#### last-value-cache-disable-from-history
1159
1177
1160
- Disable populating the Last -N-Value cache from historical data.
1161
- When disabled, the cache will still be populated with data from the WAL.
1178
+ Disables populating the last -N-value cache from historical data.
1179
+ If disabled, the cache is still populated with data from the write-ahead log ( WAL) .
1162
1180
1163
1181
| influxdb3 serve option | Environment variable |
1164
1182
| :---------------------------------------- | :------------------------------------------------ |
@@ -1181,8 +1199,8 @@ expressed as a human-readable duration--for example: `20s`, `1m`, `1h`.
1181
1199
1182
1200
#### distinct-value-cache-disable-from-history
1183
1201
1184
- Disable populating the Distinct Value cache from historical data.
1185
- When disabled, the cache will still be populated with data from the WAL.
1202
+ Disables populating the distinct value cache from historical data.
1203
+ If disabled, the cache is still populated with data from the write-ahead log ( WAL) .
1186
1204
1187
1205
| influxdb3 serve option | Environment variable |
1188
1206
| :-------------------------------------------- | :---------------------------------------------------- |
@@ -1192,7 +1210,7 @@ When disabled, the cache will still be populated with data from the WAL.
1192
1210
#### query-file-limit
1193
1211
1194
1212
Limits the number of Parquet files a query can access.
1195
- If a query attempts to read more than this limit, InfluxDB returns an error.
1213
+ If a query attempts to read more than this limit, {{% product-name %}} returns an error.
1196
1214
1197
1215
| influxdb3 serve option | Environment variable |
1198
1216
| :--------------------- | :--------------------------- |
0 commit comments