Skip to content
Merged
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
f01a9ab
Adding a no_sync documentation to get-started page (#5826)
MeelahMe Feb 26, 2025
c09d17f
Merge branch 'master' into docs/v3/no_sync-5826
MeelahMe Feb 26, 2025
d6109b3
adding CLI example to no_sync write option
MeelahMe Feb 26, 2025
716bedc
Adding HTTP documentation for no_sync option
MeelahMe Feb 26, 2025
329d12c
Updates to no_sync example for HTTP
MeelahMe Feb 26, 2025
b89b6b0
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
7713957
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
e7f4bc2
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
fa9a1bf
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
d0af3b3
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
826c987
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
8c5aeb0
Reverting sentence delete to note section
MeelahMe Feb 28, 2025
b04c7ef
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
9c00e4b
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
c28c8e9
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
0fc05b6
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
a5b8c44
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
95a88f6
Update content/shared/v3-core-get-started/_index.md
MeelahMe Feb 28, 2025
1f48311
Merge branch 'master' into docs/v3/no_sync-5826
MeelahMe Mar 4, 2025
5444065
Merge branch 'master' into docs/v3/no_sync-5826
jstirnaman Mar 5, 2025
6448be2
Update content/shared/v3-core-get-started/_index.md
jstirnaman Mar 5, 2025
9ce8d93
Update content/shared/v3-core-get-started/_index.md
jstirnaman Mar 5, 2025
9c276ee
Update content/shared/v3-core-get-started/_index.md
jstirnaman Mar 5, 2025
1d64237
Update content/shared/v3-core-get-started/_index.md
jstirnaman Mar 5, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 30 additions & 2 deletions content/shared/v3-core-get-started/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -329,8 +329,36 @@ For more information, see [diskless architecture](#diskless-architecture).
> [!Note]
> ##### Write requests return after WAL flush
>
> Because InfluxDB sends a write response after the WAL file has been flushed to the configured object store (default is every second), individual write requests might not complete quickly, but you can make many concurrent requests to achieve higher total throughput.
> Future enhancements will include an API parameter that lets requests return without waiting for the WAL flush.
> By default, InfluxDB acknowledges writes after flushing the WAL file to the Object store (occurring every second). For high throughput, you can send multiple concurrent write requests.
>
> To reduce the latency of writes, use the [`no_sync` write option](#no-sync-write-option), which acknowledges writes _before_ WAL persistence completes.

##### No sync write option

The `no_sync` write option reduces latency by acknowledging write requests before WAL persistence completes. When set to `true`, InfluxDB validates the data, writes the data to the WAL, and then immediately confirms the write, without waiting for persistence to the Object store.

Using `no_sync=true` is best when prioritizing high-throughput writes over absolute durability.

- Default behavior (`no_sync=false`): Waits for data to be written to the Object store before acknowledging the write. Reduces the risk of data loss, but increases the latency of the response.
- With `no_sync=true`: Reduces write latency, but increases the risk of data loss in case of a crash before WAL persistence.

###### Immediate write using the HTTP API

The `no_sync` parameter controls when writes are acknowledged--for example:


```sh
curl "http://localhost:8181/api/v3/write_lp?db=sensors&precision=auto&no_sync=true" \
--data-raw "home,room=Sunroom temp=96"
```

###### Immediate write using the influxdb3 CLI

The `no_sync` CLI option controls when writes are acknowledged--for example:

```sh
influxdb3 write --bucket=mydb --org=my_org --token=my-token --no-sync
```

#### Create a database or table

Expand Down