This page covers various features and tips for enforcing version control with Query Lambdas.
Each Query Lambda maintains a version history, and programmatic executions of every Query Lambda must provide a version. Any creation or update of a Query Lambda automatically creates a new version.
Versioning allows you to build and test changes without affecting production queries. Each Query Lambda/Version pair is immutable, so once specified in application code the underlying query will never change without the application source code itself changing.
To view all of the versions for a particular Query Lambda, navigate to the Query Lambdas tab of the Rockset Console and then select your Query Lambda. Then, select the
Versions tab to visualize and search through all of the past versions for your Query Lambda.
You can also view all the versions for a particular Query Lambda by hitting the Rockset API directly.
Query Lambda versions can be labeled with a tag, which can then itself by updated to point to different Query Lambda versions in the future. Labels are most useful when you have different sets of Query Lambda versions used to serve particular use cases (e.g. production and development), and you can label each set with a corresponding tag.
You can create, update, delete, and retrieve tags in the Query Lambdas tab of the Rockset Console or by hitting the Rockset API directly. Additionally, you may also execute Query Lambda versions by tag, list all Query Lambda tags, or list all tag versions using the Rockset API.
By default, a tag named
latest will be created with each Query Lambda and will automatically point to the first version of that Query Lambda. The
latest tag will also be automatically updated on each update of a Query Lambda to point to its newest version. By referencing a Query Lambda using its
latest tag in your application code, you can update the Query Lambda freely without ever having to change the version endpoint referenced (which is unique to each new version).
The Rockset CLI also contains fully supported features for creating, updating, and deploying Query Lambdas. You can view its documentation here or by selecting your Query Lambda in the Query Lambdas tab of the Rockset Console and following the instructions under the
Develop Locally tab.
You can also view, edit, and execute Query Lambda SQL locally using the Rockset VSCode Plugin.
Updated 1 day ago