Documentation

InfluxDB 3 Core release notes

InfluxDB 3 Core and Enterprise relationship

InfluxDB 3 Enterprise is a superset of InfluxDB 3 Core. All updates to Core are automatically included in Enterprise. The Enterprise sections below only list updates exclusive to Enterprise.

v3.2.1

Core

Features

  • Enhanced database lifecycle management:
    • Allow updating the hard deletion date for already-deleted databases and tables, providing flexibility in managing data retention and compliance requirements
    • Include hard_deletion_date column in _internal system tables (databases and tables) for better visibility into data lifecycle and audit trails

Bug Fixes

  • CLI improvements:
    • Added help text for the new update subcommand for database and table update features (#26569)
    • --object-store and storage configuration parameters are required for the serve command (#26575)
  • Query processing: Fixed V1-compatible /query HTTP API endpoint to correctly default to nanosecond precision (ns) for CSV output, ensuring backward compatibility with InfluxDB 1.x clients and preventing data precision loss (#26577)
  • Database reliability: Fixed issue preventing hard deletion of soft-deleted databases and tables, enabling complete data removal for compliance and storage management needs (#26574)

Enterprise

All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:

Features

  • License management improvements: New influxdb3 show license command displays detailed license information including type, expiration date, and resource limits, making it easier to monitor license status and compliance

Bug Fixes

  • API stability: Fixed HTTP API trigger specification to use the correct "request:REQUEST_PATH" syntax, ensuring proper request-based trigger configuration for processing engine workflows

v3.2.0

Core: revision 1ca3168bee
Enterprise: revision 1ca3168bee

Core

Features

  • Hard delete for databases and tables: Permanently delete databases and tables, enabling complete removal of data structures for compliance and storage management (#26553)
  • AWS credentials auto-reload: Support dynamic reloading of ephemeral AWS credentials from files, improving security and reliability when using AWS services (#26537)
  • Database retention period support: Add retention period support for databases via CLI commands (create database and update database commands) and HTTP APIs (#26520):
    • New CLI command: update database --retention-period
  • Configurable lookback duration: Users can specify lookback duration for PersistedFiles buffer, providing better control over query performance (#26528)
  • WAL replay concurrency control: Add concurrency limits for WAL (Write-Ahead Log) replay to improve startup performance and resource management (#26483)
  • Enhanced write path: Separate write path executor with unbounded memory for improved write performance (#26455)

Bug Fixes

  • WAL corruption handling: Handle corrupt WAL files during replay without panic, improving data recovery and system resilience (#26556)
  • Database naming validation: Disallow underscores in database names when created via API to ensure consistency (#26507)
  • Object store cleanup: Automatic intermediate directory cleanup for file object store, preventing storage bloat (#26480)

Additional Updates

  • Track generation 1 duration in catalog for better performance monitoring (#26508)
  • Add retention period support to the catalog (#26479)
  • Update help text for improved user experience (#26509)

Enterprise

All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:

Features

  • License management improvements:
    • New influxdb3 show license command to display current license information
  • Table-level retention period support: Add retention period support for individual tables in addition to database-level retention, providing granular data lifecycle management
    • New CLI commands: create table --retention-period and update table --retention-period
    • Set or clear table-specific retention policies independent of database settings
  • Compaction improvements:
    • Address compactor restart issues for better reliability
    • Track compacted generation durations in catalog for monitoring
    • Disable parquet cache for ingest mode to optimize memory usage

Bug Fixes

  • Query optimization: Correctly partition query chunks into generations for improved performance
  • Data integrity: Don’t delete generation 1 files as part of compaction process
  • License handling: Trim whitespace from license file contents after reading to prevent validation issues

v3.1.0

Core: revision 482dd8aac580c04f37e8713a8fffae89ae8bc264

Enterprise: revision 2cb23cf32b67f9f0d0803e31b356813a1a151b00

Core

Token and Security Updates

  • Named admin tokens can now be created, with configurable expirations
  • health, ping, and metrics endpoints can now be opted out of authorization
  • Basic $TOKEN is now supported for all APIs
  • Additional info available when creating a new token
  • Additional info available when starting InfuxDB using --without-auth

Additional Updates

  • New catalog metrics available for count operations
  • New object store metrics available for transfer latencies and transfer sizes
  • New query duration metrics available for Last Value caches
  • /ping API now contains versioning headers
  • Other performance improvements

Fixes

  • New tags are now backfilled with NULL instead of empty strings
  • Bitcode deserialization error fixed
  • Series key metadata not persisting to Parquet is now fixed
  • Other general fixes and corrections

Enterprise

Token and Security Updates

  • Resource tokens now use resource names in show tokens
  • Tokens can now be granted CREATE permission for creating databases

Additional Updates

  • Last value caches populate on creation and reload on restart
  • Distinct value caches populate on creation and reload on restart
  • Other performance improvements
  • Replaces remaining “INFLUXDB_IOX” Dockerfile environment variables with the following:
    • ENV INFLUXDB3_OBJECT_STORE=file
    • ENV INFLUXDB3_DB_DIR=/var/lib/influxdb3

Fixes

  • Improvements and fixes for license validations
  • False positive fixed for catalog error on shutdown
  • UX improvements for error and onboarding messages
  • Other general fixes and corrections

v3.0.3

Core: revision 384c457ef5f0d5ca4981b22855e411d8cac2688e

Enterprise: revision 34f4d28295132b9efafebf654e9f6decd1a13caf

Core

Fixes

  • Prevent operator token, _admin, from being deleted.

Enterprise

Fixes

  • Fix object store info digest that is output during onboarding.
  • Fix issues with false positive catalog error on shutdown.
  • Fix licensing validation issues.
  • Other fixes and performance improvements.

v3.0.2

Core: revision d80d6cd60049c7b266794a48c97b1b6438ac5da9

Enterprise: revision e9d7e03c2290d0c3e44d26e3eeb60aaf12099f29

Core

Security updates

  • Generate testing TLS certificates on the fly.
  • Set the TLS CA via the INFLUXDB3_TLS_CA environment variable.
  • Enforce a minimum TLS version for enhanced security.
  • Allow CORS requests from browsers.

General updates

  • Support the --format json option in the token creation output.
  • Remove the Last Values Cache size limitation to improve performance and flexibility.
  • Incorporate additional performance improvements.

Fixes

  • Fix a counting bug in the distinct cache.
  • Fix how the distinct cache handles rows with null values.
  • Fix handling of group by tag columns that use escape quotes.
  • Sort the IOx table schema consistently in the SHOW TABLES command.

Enterprise

Updates

  • Introduce a command and system table to list cluster nodes.
  • Support multiple custom permission argument matches.
  • Improve overall performance.

Fixes

  • Initialize the object store only once.
  • Prevent the Home license server from crashing on restart.
  • Enforce the --num-cores thread allocation limit.

v3.0.1

Core: revision d7c071e0c4959beebc7a1a433daf8916abd51214

Enterprise: revision 96e4aad870b44709e149160d523b4319ea91b54c

Core

Updates

  • TLS CA can now be set with an environment variable: INFLUXDB3_TLS_CA
  • Other general performance improvements

Fixes

  • The --tags argument is now optional for creating a table, and additionally now requires at least one tag if specified

Enterprise

Updates

  • Catalog limits for databases, tables, and columns are now configurable using influxdb3 serve options:
    • --num-database-limit
    • --num-table-limit
    • --num-total-columns-per-table-limit
  • Improvements to licensing prompts for clarity
  • Other general performance improvements

Fixes

  • Home license thread count log errors

v3.0.0

Core

General Updates

  • Performance and reliability improvements.

Enterprise

Token Support

  • Authorization is now turned on by default.
  • Token support for database level permissions are now available.
  • Token support for system level queries are now available.

General Updates

  • You can now use Commercial, Trial, and At-Home licenses.

v3.0.0-0.beta.3

Core: revision f881c5844bec93a85242f26357a1ef3ebf419dd3

Enterprise: revision 6bef9e700a59c0973b0cefdc6baf11583933e262

Core

General Improvements

  • InfluxDB 3 now supports graceful shutdowns when sending the interrupt signal to the service.

Bug fixes

  • Empty batches in JSON format results are now handled properly
  • The Processing Engine now properly extracts data from DictionaryArrays

Enterprise

Multi-node improvements
  • Query nodes now automatically detect new ingest nodes

Bug fixes

  • Several fixes for compaction planning and processing
  • The Processing Engine now properly extracts data from DictionaryArrays

v3.0.0-0.beta.2

Core: revision 033e1176d8c322b763b4aefb24686121b1b24f7c

Enterprise: revision e530fcd498c593cffec2b56d4f5194afc717d898

This update brings several backend performance improvements to both Core and Enterprise in preparation for additional new features over the next several weeks!

v3.0.0-0.beta.1

Core

Features

Query and storage enhancements
  • New ability to stream response data for CSV and JSON queries, similar to how JSONL streaming works
  • Parquet files are now cached on the query path, improving performance
  • Query buffer is incrementally cleared when snapshotting, lowering memory spikes
Processing engine improvements
  • New Trigger Types:
    • Scheduled: Run Python plugins on custom, time-defined basis
    • Request: Call Python plugins via HTTP requests
  • New in-memory cache for storing data temporarily; cached data can be stored for a single trigger or across all triggers
  • Integration with virtual environments and install packages:
    • Specify Python virtual environment via CLI or VIRTUAL_ENV variable
    • Install packages or a requirements.txt
  • Python plugins are now implemented through triggers only. Simply create a trigger that references your Python plugin code file directly
  • Snapshots are now persisted in parallel, improving performance by running jobs simultaneously, rather than sequentially
  • Write to logs from within the Processing Engine
Database and CLI improvements
  • You can now specify the precision on your timestamps for writes using the --precision flag. Includes nano/micro/milli/seconds (ns/us/ms/s)
  • Added a new show system subcommand to display system tables with different options via SQL (default limit: 100)
  • Clearer table creation error messages
Bug fixes
  • If a database was created and the service was killed before any data was written, the database would not be retained
  • A last cache with specific “value” columns could not be queried
  • Running CTRL-C no longer stopped an InfluxDB process, due to a Python trigger
  • A previous build had broken JSON queries for RecordBatches
  • There was an issue with the distinct cache that caused panics

Parameter changes

For Core and Enterprise, there are parameter changes for simplicity:

Old ParameterNew Parameter
--writer-id
--host-id
--node-id

Enterprise features

Cluster management

  • Nodes are now associated with clusters, simplifying compaction, read replication, and processing
  • Node specs are now available for simpler management of cache creations

Mode types

  • Set ingest, query, compact, and process individually per node

Enterprise parameter changes

For Enterprise, additional parameters for the serve command have been consolidated for simplicity:

Old ParameterNew Parameter
--read-from-node-ids
--compact-from-node-ids
--cluster-id
--run-compactions
--mode=compactor
--mode=compact
--mode=compact

In addition to the above changes, --cluster-id is now a required parameter for all new instances.


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

New in InfluxDB 3.2

Key enhancements in InfluxDB 3.2 and the InfluxDB 3 Explorer UI is now generally available.

See the Blog Post

InfluxDB 3.2 is now available for both Core and Enterprise, bringing the general availability of InfluxDB 3 Explorer, a new UI that simplifies how you query, explore, and visualize data. On top of that, InfluxDB 3.2 includes a wide range of performance improvements, feature updates, and bug fixes including automated data retention and more.

For more information, check out: