Skip to content

Commit c831db4

Browse files
committed
fix(v3): Core and Enterprise Get Started, problems and cleanup.
1 parent a3f06ce commit c831db4

File tree

2 files changed

+25
-21
lines changed

2 files changed

+25
-21
lines changed

content/shared/v3-core-get-started/_index.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Core's feature highlights include:
3030
* Parquet file persistence
3131
* Compatibility with InfluxDB 1.x and 2.x write APIs
3232

33-
The Enterprise version adds onto Core's functionality with:
33+
The Enterprise version adds the following features to Core:
3434

3535
* Historical query capability and single series indexing
3636
* High availability
@@ -226,7 +226,7 @@ The database has three write API endpoints that respond to HTTP `POST` requests:
226226
227227
* `/write?db=mydb&precision=ns`
228228
* `/api/v2/write?bucket=mydb&precision=ns`
229-
* `/api/v3/write_lp?db=mydb&precision=ns&accept_partial=true`
229+
* `/api/v3/write_lp?db=mydb&precision=nanosecond&accept_partial=true`
230230
231231
{{% product-name %}} provides the `/write` and `/api/v2/write` endpoints for backward compatibility with clients that can write data to previous versions of InfluxDB.
232232
However, these APIs differ from the APIs in the previous versions in the following ways:
@@ -311,23 +311,24 @@ The response is the following:
311311
}
312312
```
313313
314-
Neither line is written to the database.
314+
InfluxDB rejects all points in the batch.
315315
The response is an HTTP error (`400`) status, and the response body contains `parsing failed for write_lp endpoint` and details about the problem line.
316316
317317
##### Data durability
318318
319-
Written data goes into WAL files, created once per second, and into an in-memory queryable buffer. Later, InfluxDB snapshots the WAL and persists the data into object storage as Parquet files.
320-
We cover the [diskless architecture](#diskless-architecture) later in this guide.
319+
When you write data to InfluxDB, InfluxDB ingests the data and writes it to WAL files, created once per second, and to an in-memory queryable buffer.
320+
Later, InfluxDB snapshots the WAL and persists the data into object storage as Parquet files.
321+
For more information, see [diskless architecture](#diskless-architecture).
321322
322323
> [!Note]
323324
> ##### Write requests return after WAL flush
324-
> Write requests to the database _don't_ return until a WAL file has been flushed to the configured object store, which by default happens once per second.
325-
> Individual write requests might not complete quickly, but you can make many concurrent requests to get higher total throughput.
326-
> In the future, we will add an API parameter that lets requests return without waiting for the WAL flush.
325+
>
326+
> 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.
327+
> Future enhancements will include an API parameter that lets requests return without waiting for the WAL flush.
327328
328-
#### Create a Database or Table
329+
#### Create a database or Table
329330
330-
To create a database without writing data into it, use the `create` subcommand--for example:
331+
To create a database without writing data, use the `create` subcommand--for example:
331332
332333
```bash
333334
influxdb3 create database mydb
@@ -345,6 +346,8 @@ InfluxDB 3 now supports native SQL for querying, in addition to InfluxQL, an
345346
SQL-like language customized for time series queries. {{< product-name >}} limits
346347
query time ranges to 72 hours (both recent and historical) to ensure query performance.
347348
349+
For more information about the 72-hour limitation, see the [Jan 27, 2025 blog post](https://www.influxdata.com/blog/influxdb3-open-source-public-alpha-jan-27/).
350+
348351
> [!Note]
349352
> Flux, the language introduced in InfluxDB 2.0, is **not** supported in InfluxDB 3.
350353

content/shared/v3-enterprise-get-started/_index.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Core's feature highlights include:
2222
* Parquet file persistence
2323
* Compatibility with InfluxDB 1.x and 2.x write APIs
2424

25-
The Enterprise version adds onto Core's functionality with:
25+
The Enterprise version adds the following features to Core:
2626

2727
* Historical query capability and single series indexing
2828
* High availability
@@ -221,7 +221,7 @@ The database has three write API endpoints that respond to HTTP `POST` requests:
221221
222222
* `/write?db=mydb&precision=ns`
223223
* `/api/v2/write?bucket=mydb&precision=ns`
224-
* `/api/v3/write_lp?db=mydb&precision=ns&accept_partial=true`
224+
* `/api/v3/write_lp?db=mydb&precision=nanosecond&accept_partial=true`
225225
226226
{{% product-name %}} provides the `/write` and `/api/v2/write` endpoints for backward compatibility with clients that can write data to previous versions of InfluxDB.
227227
However, these APIs differ from the APIs in the previous versions in the following ways:
@@ -306,23 +306,24 @@ The response is the following:
306306
}
307307
```
308308
309-
Neither line is written to the database.
309+
InfluxDB rejects all points in the batch.
310310
The response is an HTTP error (`400`) status, and the response body contains `parsing failed for write_lp endpoint` and details about the problem line.
311311
312312
##### Data durability
313313
314-
Written data goes into WAL files, created once per second, and into an in-memory queryable buffer. Later, InfluxDB snapshots the WAL and persists the data into object storage as Parquet files.
315-
We cover the [diskless architecture](#diskless-architecture) later in this guide.
314+
When you write data to InfluxDB, InfluxDB ingests the data and writes it to WAL files, created once per second, and to an in-memory queryable buffer.
315+
Later, InfluxDB snapshots the WAL and persists the data into object storage as Parquet files.
316+
For more information, see [diskless architecture](#diskless-architecture).
316317
317318
> [!Note]
318319
> ##### Write requests return after WAL flush
319-
> Write requests to the database _don't_ return until a WAL file has been flushed to the configured object store, which by default happens once per second.
320-
> Individual write requests might not complete quickly, but you can make many concurrent requests to get higher total throughput.
321-
> In the future, we will add an API parameter that lets requests return without waiting for the WAL flush.
320+
>
321+
> 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.
322+
> Future enhancements will include an API parameter that lets requests return without waiting for the WAL flush.
322323
323-
#### Create a Database or Table
324+
#### Create a database or table
324325
325-
To create a database without writing data into it, use the `create` subcommand--for example:
326+
To create a database without writing data, use the `create` subcommand--for example:
326327
327328
```bash
328329
influxdb3 create database mydb
@@ -397,7 +398,7 @@ $ influxdb3 query --database=servers "SELECT DISTINCT usage_percent, time FROM c
397398
To query using InfluxQL, enter the `influxdb3 query` subcommand and specify `influxql` in the language option--for example:
398399
399400
```bash
400-
influxdb3 query --database=servers --lang=influxql "SELECT DISTINCT usage_percent FROM cpu WHERE time >= now() - 1d"
401+
influxdb3 query --database=servers --language=influxql "SELECT DISTINCT usage_percent FROM cpu WHERE time >= now() - 1d"
401402
```
402403
403404
### Query using the API

0 commit comments

Comments
 (0)