Merge branch 'master' into visualize-data-fixes

pull/5672/head
Jason Stirnaman 2024-11-14 15:05:36 -06:00 committed by GitHub
commit b53ff298d7
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 18 additions and 11 deletions

View File

@ -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.

View File

@ -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.