content/shared/v3-core-enterprise-release-notes/_index.md
[!Note]
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.
No adjustments in this release. Core remains on v3.8.3.
Stale compactor blocking startup: Fixed an issue where stopped (stale) compactor entries in the catalog prevented new compactor nodes from starting. Enterprise now only considers currently running compactor nodes for conflict checks.
WAL replay: Fixed an issue where combined-mode deployments silently ignored the --wal-replay-concurrency-limit flag and always used serial replay (concurrency of 1). The flag is now respected.
Other bug fixes and performance improvements.
TLS: Skip certificate verification in CLI subcommands: Use the new --tls-no-verify flag with any CLI subcommand to skip TLS certificate verification when connecting to a server. Useful for testing environments with self-signed certificates.
Environment variable prefix standardization: InfluxDB 3 specific environment variables use the INFLUXDB3_ prefix for consistency. Legacy variable names continue to work (deprecated) for backward compatibility.
[!IMPORTANT]
INFLUXDB3_LOG_FILTERis currently ignored. To set the log filter, useLOG_FILTERor the--log-filterflag.
Parquet output format for show subcommands: You can now save query results from the show subcommand directly to a Parquet file.
SQL: tag_values() table function: Query distinct tag values using the new tag_values() SQL table function.
InfluxQL: SHOW TAG VALUES improvements: In Enterprise deployments with auto-DVC enabled, SHOW TAG VALUES queries now use the Distinct Value Cache (DVC) automatically for improved performance. The WHERE clause is also now supported in SHOW TAG VALUES queries backed by the DVC, including compound predicates using AND and OR.
InfluxQL: SHOW RETENTION POLICIES returns duration: The duration column in SHOW RETENTION POLICIES results now returns the configured retention period in InfluxDB v1-compatible format (for example, 168h0m0s) instead of returning an empty value.
Ceph S3 backend support: Use --aws-s3-custom-backend ceph with influxdb3 serve to connect to Ceph S3-compatible object storage. This enables ETag quote stripping required for conditional PUT operations with Ceph.
_internal database default retention: The _internal system database now defaults to a 7-day retention period (previously infinite). Only admin tokens can modify retention on the _internal database.
Snapshot checkpointing for faster startup: Use the new --checkpoint-interval serve option to periodically consolidate snapshots into monthly checkpoints. On startup, the server loads one to two checkpoints per calendar month instead of thousands of individual snapshots, reducing startup time for long-running servers.
Sparse write handling for LVC, DVC, and Processing Engine: Fixed incorrect behavior when processing sparse writes (writes that include only some fields from a table with multiple field families).
influxdb3-launcher: SSL certificate path on RHEL systems: Fixed an issue where the SSL_CERT_FILE environment variable was not correctly set on affected RHEL-based
systems when using the influxdb3-launcher script.
Additional bug fixes and performance improvements.
All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
Compaction stability: Several fixes to compaction scheduling and processing to improve stability and correctness in multi-node clusters.
TableIndexCache initialization: Fixed a concurrency bug that could cause incorrect behavior during TableIndexCache initialization.
Snapshot checkpointing: Fixed an issue where snapshot checkpoint cleanup was not running as a background task.
influxdb3-launcher script to initialize the serviceSHOW RETENTIONAll Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
cluster-uuid header containing the catalog UUID, enabling clients to identify specific cluster instances programmaticallyinfluxdb3 show retention command displays effective retention periods for each table, showing whether retention is set at the database-level or table-level with human-readable formatting (for example, "7d", "24h")Authorization: Fixed multi-database permission handling to properly authorize queries across multiple databases.
General Improvements: Several key bug fixes and performance improvements.
All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
influxdb3 now supports running without arguments for instant database startup, automatically generating IDs and storage flags values based on your system's setup.--upload flag.system.plugin_files table and show plugins CLI command now provide visibility into all loaded plugin files.--plugin-repo CLI flag.--package-manager disabled for locked-down environments.ns, ms, us, s) to work correctly with the /api/v3/write_lp endpoint. Previously, only full precision names (nanosecond, microsecond, millisecond, second) worked.All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
--plugin-repo option with influxdb3 serve to specify custom plugin repositories. This enables loading plugins from personal repos or disabling remote repo access.All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
/api/v2/write error response format to match other InfluxDB editions. Error responses now use the consistent format: {"code": "<code>", "message": "<detailed message>"} (#26787)All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
--azure-endpoint option with influxdb3 serve to specify the Azure Blob Storage endpoint for object store connections. (#26687)--no-sync option with influxdb3 write to skip waiting for WAL persistence on write and immediately return a response to the write request. (#26703)Introduce a new v2 catalog path structure:
catalog/v2/logs/ directory for log files (instead of catalogs/)catalog/v2/snapshot file for checkpoint/snapshot files (instead of _catalog_checkpoint)Reduce verbosity of the TableIndexCache log. (#26709)
WAL replay concurrency limit defaults to number of CPU cores, preventing possible OOMs. (#26715)
Remove unsafe signal_handler code. (#26685)
Tags with / in the name no longer break the primary key.
All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
Token Provisioning:
Select a home or trial license without using an interactive terminal.
Use --license-type [home | trial | commercial] option to the influxdb3 serve command to automate the selection of the license type.
--mode does not require it.INFLUXDB3_PLUGIN_DIR is set in containers without the Processing Engine enabled.influxdb_schema system table for database schema management (#26640)system.processing_engine_trigger_arguments table for trigger configuration management (#26604)x-forwarded-for header if available, x-real-ip if available, or remote address as reported by TlsStream/AddrStream (#26616)TableIndexCache for efficient automatic cleanup of expired gen1 Parquet files based on retention policies and hard deletes. Includes new background loop for applying data retention policies with configurable intervals and comprehensive purge operations for tables and retention period expired data (#26636)--admin-token-recovery-http-bind option for running recovery server on separate port, with automatic shutdown after successful token regeneration (#26594)All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
TableIndexCache with advanced features beyond Core's basic cleanup: persistent snapshots, object store integration, merge operations for distributed environments, and recovery capabilities for multi-node clustersTableIndexSnapshot, TableIndex, and TableIndices types for distributed table index managementhard_deletion_date column in _internal system tables (databases and tables) for better visibility into data lifecycle and audit trails/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)All Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
influxdb3 show license command displays detailed license information including type, expiration date, and resource limits, making it easier to monitor license status and compliance"request:REQUEST_PATH" syntax, ensuring proper request-based trigger configuration for processing engine workflowsCore: revision 1ca3168bee
Enterprise: revision 1ca3168bee
create database and update database commands) and HTTP APIs (#26520):
update database --retention-periodAll Core updates are included in Enterprise. Additional Enterprise-specific features and fixes:
influxdb3 show license command to display current license informationcreate table --retention-period and update table --retention-periodCore: revision 482dd8aac580c04f37e8713a8fffae89ae8bc264
Enterprise: revision 2cb23cf32b67f9f0d0803e31b356813a1a151b00
health, ping, and metrics endpoints can now be opted out of authorizationBasic $TOKEN is now supported for all APIs--without-auth/ping API now contains versioning headersshow tokensCREATE permission for creating databasesENV INFLUXDB3_OBJECT_STORE=fileENV INFLUXDB3_DB_DIR=/var/lib/influxdb3Core: revision 384c457ef5f0d5ca4981b22855e411d8cac2688e
Enterprise: revision 34f4d28295132b9efafebf654e9f6decd1a13caf
_admin, from being deleted.Core: revision d80d6cd60049c7b266794a48c97b1b6438ac5da9
Enterprise: revision e9d7e03c2290d0c3e44d26e3eeb60aaf12099f29
--format json option in the token creation output.group by tag columns that use escape quotes.SHOW TABLES command.--num-cores thread allocation limit.Core: revision d7c071e0c4959beebc7a1a433daf8916abd51214
Enterprise: revision 96e4aad870b44709e149160d523b4319ea91b54c
INFLUXDB3_TLS_CA--tags argument is now optional for creating a table, and additionally now requires at least one tag if specifiedinfluxdb3 serve options:
--num-database-limit--num-table-limit--num-total-columns-per-table-limit--parquet-mem-cache-size-mb option with --parquet-mem-cache-size. The new option accepts values in megabytes (as an integer) or as a percentage of total available memory (for example, 20%). The default value changed from 1000 MB to 20% of total available memory. The environment variable INFLUXDB3_PARQUET_MEM_CACHE_SIZE_MB was replaced with INFLUXDB3_PARQUET_MEM_CACHE_SIZE. (#26023)50% of available memory20% of available memoryCore: revision f881c5844bec93a85242f26357a1ef3ebf419dd3
Enterprise: revision 6bef9e700a59c0973b0cefdc6baf11583933e262
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.
VIRTUAL_ENV variablerequirements.txt--precision flag. Includes nano/micro/milli/seconds (ns/us/ms/s)show system subcommand to display system tables with different options via SQL (default limit: 100)For Core and Enterprise, there are parameter changes for simplicity:
| Old Parameter | New Parameter |
|---|---|
--writer-id | |
--host-id | --node-id |
ingest, query, compact, and process individually per nodeFor Enterprise, additional parameters for the serve command have been consolidated for simplicity:
| Old Parameter | New 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.