About Using Git with Semantic Model Development

You can use Git to enable sharing and concurrent semantic model development. You can use any Git service in a public cloud that Oracle Analytics can access, or you can connect to a Git repository in a private (on-premises) network through a private access channel.

Examples of Git services in a public cloud that you can use are: Oracle Visual Builder Studio, GitHub, Bitbucket, GitLab, and Azure DevOps.

Semantic Modeler supports Git repositories with URLs that don't contain the .git domain, for example Azure repositories.

To connect to a Git repository in a private (on-premises) network, your administrator needs to set up a private access channel. A private access channel gives access to a Git repository within your virtual cloud network (VCN) on Oracle Cloud Infrastructure or other network peered to the VCN such as your corporate network. For more information, see About Private Access Channels.

A semantic model is comprised of a set of SMML files. When you create and develop a semantic model locally, the model's SMML files are stored in Oracle Cloud. To make a semantic model's SMML files available for other development team members to work on, the semantic model's owner creates a Git repository, initializes it with HTTPS or SSH, and uploads the semantic model's SMML files to the repository. Each developer creates a semantic model and uses HTTPS or SSH to connect to and clone the semantic model's SMML files to their Git repository.

When working on a cloned semantic model, the development team creates and works in branches to add, update, and commit the files on their computers and then pushes the commits to the remote repository.

To effectively create and contribute to a semantic model Git repository, you must have a basic understanding of Git and how to work with branches. If you're new to Git and want to learn more about Git repositories and Git basics, such as remote repositories, cloning, commits, pushes, and branches, then read the Git documentation. See https://git-scm.com/book/ and http://git-scm.com/doc.