AML Reference

This is the reference for AML: the syntax, the types, the object-by-object details. Use it to look something up.

For concepts (what AML is for, design principles, reusability patterns, and how it fits with AQL), head to AML Overview in the Documentation section.

How this section is organized

AML is a declarative language for defining semantic models. The sidebar groups by object type and language feature:

Core objects

• Model: define table models and query models
  • Table Model: models backed by database tables/views
  • Query Model: models defined by SQL queries
  • Persistence: materialize model queries as tables
• Fields: dimensions and measures inside models
• Dataset: collections of models with relationships
  • Dataset Fields: cross-model dimensions and metrics
  • PreAggregate: map model fields to pre-aggregated tables for faster queries
  • Relationship: how models join together
• Dashboard: dashboard definitions as code
  • Dashboard Blocks: TextBlock, VizBlock, FilterBlock, DateDrillBlock
  • Dashboard Interactions: DateDrillInteraction, CustomMapping
  • CanvasLayout: block positioning and mobile layout
  • Theme: PageTheme, BlockTheme, VizTheme

Language features

• Types: the AML type system
• Constant: reusable constants
• Function: user-defined functions
• Module: organize and import definitions
• Extend: inherit and override object properties
• Partial: composable object fragments
• If-else: conditional logic
• String Interpolation: dynamic string values

Quick start

If you're new to AML:

• Examples: side-by-side code examples for common objects
• Model → Fields → Dataset: the core modeling path

See also

• AML Overview: conceptual introduction and design principles
• AQL Reference: the query language that runs on top of AML models
• Reusability Guide: patterns for composing and reusing AML code