Entities

​

What is an Entity?

An Entity is a real-world concept that you want to represent and reason about in Galaxy. Entities describe the important “things” in your organization. They are the nouns of your business. Examples of common entities:

• Customer
• Order
• Product
• Invoice
• Employee
• Deal
• Document

Entities give structure and identity to raw data. Instead of thinking in tables and columns, you think in meaningful concepts that people recognize.

​

Why Entities Matter

Without entities, data remains fragmented across systems and schemas. Entities allow you to:

• Standardize business concepts across tools
• Create shared definitions for key ideas
• Bring multiple data sources together under one concept
• Reason about data at a business level instead of a technical one
• Power graph exploration, chat, and analytics

Instead of asking:

Which table has customer information?

you can ask:

What do we know about this Customer?

​

Entities Turn Data into Meaning

Your connected Sources contain data. Projects turn that data into understanding. An entity is the bridge between the two. For example: Different systems may store similar information in different ways. Entities provide a single, consistent definition that can span many Sources.

​

Anatomy of an Entity

Every entity in Galaxy includes several layers of information.

​

1. Name and Description

An entity has:

• A clear, human-readable name
• A description explaining what it represents

This ensures that teams share the same understanding of what the entity means.

​

2. Identifiers

Entities need identity. An entity definition typically specifies:

• How individual records are uniquely identified
• Which fields act as primary identifiers
• How records from different systems should be matched together

Identifiers allow Galaxy to recognize that two pieces of data refer to the same real-world thing.

​

3. Attributes

Attributes describe the properties of an entity. For a Customer entity, attributes might include:

• Name
• Email
• Signup date
• Status
• Region

Attributes come from your Sources, but they are organized and interpreted at the entity level.

​

4. Mappings to Sources

Entities are not abstract ideas. They are connected directly to real data. Each entity includes mappings that define:

• Which tables or files it comes from
• Which columns correspond to which attributes
• How data from multiple Sources should be combined

This mapping is what turns raw Source data into semantic understanding.

​

5. Relationships

Entities rarely exist alone. They connect to other entities. Examples:

• A Customer places an Order
• An Order contains Products
• An Employee manages an Account

These connections are defined through Relationships, described in detail on the Relationships page.