Managing workspace configurations
Last updated
Was this helpful?
Last updated
Was this helpful?
In this guide, you'll learn how to manage essential configurations for your Paradime workspace. Proper configuration management ensures consistency, security, and flexibility across your analytics engineering projects.
Estimated completion time: 10 minutes
An admin role In Paradime to create workspaces
Paradime allows you to centrally manage the dbt™ version for your entire workspace, ensuring consistency across both the Code IDE and Bolt scheduler for all users. This feature is crucial for maintaining compatibility and leveraging the latest dbt™ functionalities across your projects.
Navigate to your account settings.
Select the Workspace
tab.
Under the project settings section, find the current dbt™ version configuration.
Before changing the dbt™ version, ensure that your projects are compatible with the new version to avoid any potential issues.
Click the Edit
button next to the current dbt™ version.
Select the desired dbt™ version from the dropdown menu.
Click the Save
button to apply the changes.
Once saved, all users in the workspace will inherit this dbt™ version, which applies to both the Code IDE and the Bolt scheduler.
Environment variables allow you to securely store and use sensitive information or configuration details in Paradime. These variables can be managed in two different contexts:
Bolt Schedule Environment Variables: For production jobs (requires Admin access)
Code IDE Environment Variables: For development work
From any page in the Paradime application, Click Settings
Navigate to Workspaces > Environment Variables
Choose where to add your variable:
For production jobs: In the Bolt Schedules section, click Add New
For development work: In the Code IDE section, click Add New
Configure your variable:
Enter Key name
Enter Value
Click Save icon (💾)
Bolt Schedules: Variables are automatically injected into your dbt™ project at runtime
Code IDE: Variables are immediately available in your development environment
Edit: Click the 'Edit' button (✎) next to the variable
Delete: Click the 'Delete' button (🗑️) next to the variable
Remember to save your changes
Bolt Schedule variables require Admin access to manage
Environment variables are environment-specific (development vs. production)
For detailed information, see:
API keys in Paradime provide secure, programmatic access to your workspace resources. They are essential for integrating Paradime with other tools and automating workflows. Each API key is scoped to a specific workspace, ensuring isolation and security of your data and configurations.
Navigate to your account settings.
Select the "Workspace" tab.
Scroll to API key section and click on the + Generate API Key
Provide a name for the key (e.g., 'My New API Key').
Optional: Set a lifetime for the key by specifying the number of days until expiration.
Click Create
to save.
After creation, securely store your API key, secret, and endpoint.
Choose the capabilities you want to enable for this API key, you can find all the capabilities and access in the API docs. Select the appropriate capabilities based on your intended use of the API key.
Important Note on API Key Scope: API keys in Paradime are scoped to specific workspaces. This means:
Each API key is tied to the workspace in which it was created.
An API key generated in one workspace cannot be used to access or manage resources in another workspace.
To manage existing API keys:
View all generated keys in the API key section of your workspace settings.
Delete keys that are no longer needed or may have been compromised.
Best Practice: Regularly review your API keys, rotate them periodically, and ensure each key has only the necessary capabilities for its intended use.
You've now learned how to manage dbt™ versions, set up environment variables, and handle API keys in your Paradime workspace. These skills will help you maintain a secure and efficient analytics engineering environment.
Next, we'll explore Managing Users in the Workspace to ensure proper access control and collaboration in your Paradime projects.