You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/shared/influxdb3-get-started/_index.md
+27-6Lines changed: 27 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -10,17 +10,38 @@ including the following:
10
10
> The [InfluxDB Discord server](https://discord.gg/9zaNCW2PRT) is the best place to find support for {{% product-name %}}.
11
11
> For other InfluxDB versions, see the [Support and feedback](#bug-reports-and-feedback) options.
12
12
13
+
## Data model
13
14
14
-
### Data model
15
+
The {{% product-name %}} server contains logical databases; databases contain
16
+
tables; and tables are comprised of columns.
15
17
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`.
17
21
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:
20
24
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)
22
32
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
24
45
25
46
The following table compares tools that you can use to interact with {{% product-name %}}.
26
47
This tutorial covers many of the recommended tools.
0 commit comments