Versioning guide for KDB.AI
This section explains how KDB.AI versioning works for both Cloud and Server editions and provides information on how to interpret version numbers.
KDB.AI versions
KDB.AI has two types of versions:
- User Interface (UI) Version is the version number of the KDB.AI Cloud UI.
- KDB.AI Server Version is the version number of KDB.AI Server and KDB.AI Cloud.
To learn more about the features included in each version, go to our latest or previous release notes.
Semantic versioning
KDB.AI adheres to semantic versioning (SemVer). This means that a version number follows the format MAJOR.MINOR.PATCH, where:
- MAJOR version changes in case of significant backward-incompatible API changes, new major features or architectural overhauls. Users should pay attention to major version updates and test their existing workflows.
- MINOR version increments for backward-compatible functionality additions and improvements to existing features. Users can safely upgrade to a new minor version without major disruptions.
- PATCH version increases for backward-compatible bug fixes, security updates, and performance optimizations. Users are encouraged to keep their installations up to date with the latest patch versions.
Release cadence
-
Major releases: potentially once per year, when we introduce backward-incompatible changes.
-
Minor releases: 1 per quarter for KDB.AI Server and 1 per month for KDB.AI Cloud UI.
-
Patch releases: As needed, approximate historical cadence is 1 patch every 2-4 weeks.
How to check your version
To find out which version of KDB.AI you are using, follow these steps:
- Log in to your KDB.AI Cloud account.
- Look for the version information, which should be displayed prominently at the top left corner of your screen, under the KDB.AI Cloud logo.
On hover, you'll also notice the Server version which reflects the product version you were allocated.
Documentation versioning
The documentation is mapped against the KDB.AI Product releases. Let's assume you're looking for information about hybrid search:
- Navigate to the previous release notes.
- Find the release version when hybrid search was launched. You'll notice that we introduced it in the KDB.AI Server v1.1.0 release.
- Go to the top left dropdown on the documentation site and select 1.1.0 or a later version. Previous releases (such as v1.0.0) don't have hybrid search documented.
Release notes
For each release, KDB.AI provides detailed release notes that highlight the changes made in that version. These notes include:
- A summary of new features and improvements.
- Any known issues or limitations.
- Upgrade instructions (if applicable).
Next steps
- Upgrade your KDB.AI Server.
- Read the latest release notes to discover what's new in KDB.AI.
- Go through previous release notes for a timeline of KDB.AI functionalities.