Merge branch 'master' into visualize-data-fixes
commit
b53ff298d7
|
@ -11,9 +11,12 @@ menu:
|
|||
weight: 201
|
||||
aliases:
|
||||
- /influxdb/v2/organizations/buckets/create-bucket/
|
||||
related:
|
||||
- /influxdb/v2/reference/internals/data-retention/
|
||||
|
||||
---
|
||||
|
||||
Use the InfluxDB user interface (UI) the `influx` command line interface (CLI),
|
||||
Use the InfluxDB user interface (UI), the `influx` command line interface (CLI),
|
||||
or the InfluxDB API to create a bucket.
|
||||
|
||||
{{% note %}}
|
||||
|
@ -42,10 +45,10 @@ There are two places you can create a bucket in the UI.
|
|||
|
||||
1. In the navigation menu on the left, select **Data (Load Data)** > **Buckets**.
|
||||
|
||||
{{< nav-icon "data" >}}
|
||||
{{< nav-icon "data" >}}
|
||||
|
||||
2. Click **{{< icon "plus" >}} Create Bucket** in the upper right.
|
||||
3. Enter a **Name** for the bucket
|
||||
3. Enter a **Name** for the bucket
|
||||
_(see [Bucket naming restrictions](#bucket-naming-restrictions))_.
|
||||
4. Select when to **Delete Data**:
|
||||
- **Never** to retain data forever.
|
||||
|
@ -54,12 +57,12 @@ There are two places you can create a bucket in the UI.
|
|||
|
||||
### Create a bucket in the Data Explorer
|
||||
|
||||
1. In the navigation menu on the left, select **Explore* (**Data Explorer**).
|
||||
1. In the navigation menu on the left, select **Explore (Data Explorer)**.
|
||||
|
||||
{{< nav-icon "data-explorer" >}}
|
||||
{{< nav-icon "data-explorer" >}}
|
||||
|
||||
2. In the **From** panel in the Flux Builder, select `+ Create Bucket`.
|
||||
3. Enter a **Name** for the bucket
|
||||
3. Enter a **Name** for the bucket
|
||||
_(see [Bucket naming restrictions](#bucket-naming-restrictions))_.
|
||||
4. Select when to **Delete Data**:
|
||||
- **Never** to retain data forever.
|
||||
|
|
|
@ -9,7 +9,8 @@ menu:
|
|||
name: Data retention
|
||||
parent: InfluxDB internals
|
||||
influxdb/v2/tags: [storage, internals]
|
||||
related:
|
||||
related:
|
||||
- /influxdb/v2/admin/buckets/create-bucket/
|
||||
- /influxdb/v2/reference/internals/shards/
|
||||
- /influxdb/v2/reference/internals/storage-engine/
|
||||
- /influxdb/v2/admin/internals/
|
||||
|
@ -32,10 +33,13 @@ configuration option.
|
|||
- [When does data actually get deleted?](#when-does-data-actually-get-deleted)
|
||||
|
||||
## Bucket retention period
|
||||
A **bucket retention period** is the [duration](/influxdb/v2/reference/glossary/#duration) of time that a bucket retains data.
|
||||
A **bucket retention period** is the [duration](/influxdb/v2/reference/glossary/#duration)
|
||||
of time that a bucket retains data.
|
||||
You can specify the retention period when you [create](/influxdb/v2/admin/buckets/create-bucket/) or [update](/influxdb/v2/admin/buckets/update-bucket/) a bucket.
|
||||
Retention periods can be infinite or as short as an hour.
|
||||
[Points](/influxdb/v2/reference/glossary/#point) in a bucket with timestamps
|
||||
beyond the defined retention period (relative to now) are _eligible_ for deletion.
|
||||
[Points](/influxdb/v2/reference/glossary/#point)
|
||||
in a bucket with timestamps beyond the defined retention period (relative to now)
|
||||
are _eligible_ for deletion.
|
||||
|
||||
## Shard group duration
|
||||
InfluxDB stores data on disk in [shards](/influxdb/v2/reference/glossary/#shard).
|
||||
|
@ -73,7 +77,7 @@ To calculate the possible time data will persist before being deleted:
|
|||
- **minimum**: `bucket-retention-period`
|
||||
- **maximum** `bucket-retention-period + shard-group-duration`
|
||||
|
||||
For example, if your bucket retention period is three days (`3d`) and your
|
||||
For example, if your bucket retention period is three days (`3d`) and your
|
||||
shard group duration is one day (`1d`), the retention enforcement service
|
||||
deletes all shard groups with data that is **three to four days old** the next
|
||||
time the service runs.
|
||||
|
|
Loading…
Reference in New Issue