Skip to main content
This section provides technical specifications and reference information for entities.
For conceptual explanations of entities, see Entities in the Metrics Concepts page.

Primary Key Types

Available primary key types for entities:
TypeDescriptionUse Case
COLUMN_TYPE_STRINGString identifiersUUIDs, usernames, session IDs
COLUMN_TYPE_INTEGERInteger identifiersAutoincrementing user IDs, numeric keys
COLUMN_TYPE_BOOLEANBoolean valuesBinary entity identifiers (rarely used)
COLUMN_TYPE_DOUBLEFloating point numbersNumeric identifiers with decimals (rarely used)

Entity Constraints

  • Unique names: Entity display names must be unique within a project
  • Immutable key type: You cannot change the primary key type after creation
  • Referenced entities: You cannot delete entities used in fact tables, dimension tables, or metrics
  • Case sensitivity: Entity names are case-sensitive

Entity Resource Name Format

Reference entities using the resource name format:
entities/{entity_id}
Example: entities/user, entities/session