Skip to content

Commit cb74222

Browse files
sandersonjstirnaman
authored andcommitted
update getting started landing page
1 parent 5611da7 commit cb74222

File tree

1 file changed

+27
-6
lines changed
  • content/shared/influxdb3-get-started

1 file changed

+27
-6
lines changed

content/shared/influxdb3-get-started/_index.md

Lines changed: 27 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,38 @@ including the following:
1010
> The [InfluxDB Discord server](https://discord.gg/9zaNCW2PRT) is the best place to find support for {{% product-name %}}.
1111
> For other InfluxDB versions, see the [Support and feedback](#bug-reports-and-feedback) options.
1212
13+
## Data model
1314

14-
### Data model
15+
The {{% product-name %}} server contains logical databases; databases contain
16+
tables; and tables are comprised of columns.
1517

16-
The database server contains logical databases, which have tables, which have columns. Compared to previous versions of InfluxDB you can think of a database as a `bucket` in v2 or as a `db/retention_policy` in v1. A `table` is equivalent to a `measurement`, which has columns that can be of type `tag` (a string dictionary), `int64`, `float64`, `uint64`, `bool`, or `string` and finally every table has a `time` column that is a nanosecond precision timestamp.
18+
Compared to previous versions of InfluxDB, you can think of a database as an
19+
InfluxDB v2 `bucket` in v2 or an InfluxDB v1 `db/retention_policy`.
20+
A `table` is equivalent to an InfluxDB v1 and v2 `measurement`.
1721

18-
In InfluxDB 3, every table has a primary key--the ordered set of tags and the time--for its data.
19-
This is the sort order used for all Parquet files that get created. When you create a table, either through an explicit call or by writing data into a table for the first time, it sets the primary key to the tags in the order they arrived. This is immutable. Although InfluxDB is still a _schema-on-write_ database, the tag column definitions for a table are immutable.
22+
Columns in a table represent time, tags, and fields. Columns can be one of the
23+
following types:
2024

21-
Tags should hold unique identifying information like `sensor_id`, or `building_id` or `trace_id`. All other data should be kept in fields. You will be able to add fast last N value and distinct value lookups later for any column, whether it is a field or a tag.
25+
- String dictionary (tag)
26+
- `int64` (field)
27+
- `float64` (field)
28+
- `uint64` (field)
29+
- `bool` (field)
30+
- `string` (field)
31+
- `time` (time with nanosecond precision)
2232

23-
### Tools to use
33+
In {{% product-name %}}, every table has a primary key--the ordered set of tags and the time--for its data.
34+
The primary key uniquely identifies each and determines the sort order for all
35+
Parquet files related to the table. When you create a table, either through an
36+
explicit call or by writing data into a table for the first time, it sets the
37+
primary key to the tags in the order they arrived.
38+
Although InfluxDB is still a _schema-on-write_ database, the tag column
39+
definitions for a table are immutable.
40+
41+
Tags should hold unique identifying information like `sensor_id`, `building_id`,
42+
or `trace_id`. All other data should be stored as fields.
43+
44+
## Tools to use
2445

2546
The following table compares tools that you can use to interact with {{% product-name %}}.
2647
This tutorial covers many of the recommended tools.

0 commit comments

Comments
 (0)