User Connections have replaced Integrations
To continue using Push to git functionality, each user will have to configure their git integration in User Connections and provide their own personal access token. This functionality is no longer limited to admins.
This feature may not be available by default and might need to be enabled upon request. Please contact your account manager for more information.
Git integrations for SqlDBM projects are managed through User Connections. While this article provides specific instructions for GitLab, the related article at the end of this post covers the rest of the common steps to configuring the integration.
Once the integration has been configured, see the related at the end of this post on pushing to git and the various ways of generating the files themselves.
To enable version control through the GitLab repository, you will need to create a Personal Access Token and link it with SqlDBM using the steps below.
Please make sure to initialize your repository by creating at least one file in the main branch (Readme.md for example).
Go to GitLab. Create or choose an organization.
Create a Personal Access Token.
Ensure that "Role" is set to "Developer" or above.
If specifying an expiration date, make sure to set a reminder to avoid losing access.
Go to: User settings → Access Tokens
Once created, make sure to copy the above token. GitLab doesn't store it, and you will not be able to see it again.
Token must have read & write permissions or full access.
If you want to create pull requests while pushing, there should be no restrictions on creating a pull request for the user who created the token.
Note the expiration period. When it expires, the token will no longer be valid, and the integration will break.
3. Open the SqlDBM Account - User Connections - page in a different browser tab.
4. Choose the "Gitlab" option.
5. Enter your token in the "Personal Access Token" field.
6. Open GitLab again and create a repository.
7. Copy the link with HTTPS.
8. Open SqlDBM "User Connections" with the specified token.
9. Specify the repository URL.
10. Done.
Project users will now see a "Push to Git" button on the Forward engineering page. It will become active after generating DDL or YAML scripts.
The same behavior in the DataOps page (alter script popup).
After a successful push request, find your script in the repository files:
Code -> Overview -> Your branch -> Branch name -> there should be a commit with your SQL script.
Otherwise, if you selected the 'Create Pull Request' option in the Integration page, go to: Merge requests/open.
