In Coalesce, your work is organized into Projects.
- A Project is a parent object that groups your builds, deploys, and refreshes into independent areas.
- You can think of Projects like the Folders on your computer that help organize your work.
- Projects are typically organized by work purpose, team goal, and/or business area.
- Each project is backed by its own Git repository which independently version controls the work within that Project.
- As a good practice, there should be a one-to-one relationship between a Project and a Git repository, and you should not share the same Git repository across Projects. This good practice can be used as a guiding factor when you are determining how to organize your Projects in Coalesce.
Let’s take a look at how Projects in Coalesce might be defined under a Data Mesh approach.
Under this approach, you may have a project for your Enterprise Data Warehouse. In this project, your data engineers complete the complex first-mile transformations to build, deploy, and refresh your organization’s data warehouse.
You may also have projects for each business unit that you have onboarded to Coalesce and empowered to create business-centric views for their individual business-unit reporting and analytics needs. As they work in these projects, these business units use the objects built in the Enterprise Data Warehouse project as sources for their views, as well as enrich the EDW data with secondary data sources specific to their business unit.
And each of these projects will have its own Git repository, which independently version controls the work within that Project.
The above example is pictured below within the context of the Build Interface of the Coalesce UI.
Create a Project
In Coalesce, a Project is created from the main landing area of the Build Interface. When creating a Project, you will need to configure the following details:
- Project Name. A brief name that conveys the purpose of the Project.
- Project Description. While optional, it is a good practice to enter a description for the project that further details the purpose of the Project.
- Git Repository URL. Unique to this Project, and not shared by any other Project in this or any other Coalesce organization.
- Git Account. If you have previously configured your personal Git account(s) details in your User Settings, you will be able to select the account associated with your Project repository; if you have not already completed this configuration, you will be able to do so while configuring the Project.
For further information on this process, we encourage you to watch the following instructional video which provides a detailed walkthrough of the process of creating a new Project in the Coalesce UI.