Translates a simple metric definition into reusable SQL and executes it against the SQL engine of your choice.
Build and maintain all of your metric logic in code.
See our latest updates in the Metricflow Changelog!
MetricFlow is a semantic layer that makes it easy to organize metric definitions. It takes those definitions and generates legible and reusable SQL. This makes it easy to get consistent metrics output broken down by attributes (dimensions) of interest.
The name comes from the approach taken to generate metrics. A query is compiled into a query plan (represented below) called a dataflow that constructs metrics. The plan is then optimized and rendered to engine-specific SQL.
MetricFlow provides a set of abstractions that help you construct complicated logic and dynamically generate queries to handle:
To get up and running with your own metrics, you should rely on MetricFlow’s documentation.
MetricFlow is distributed under a Business Source License (BUSL-1.1). For details on our additional use grant, change license, and change date please refer to our licensing agreement.
MetricFlow can be installed from PyPi for use as a Python library with the following command:
pip install dbt-metricflow
MetricFlow currently serves as a query compilation and SQL rendering library, built to work in conjunction with a dbt project. As such, using MetricFlow requires a working dbt project and a dbt adapter. We provide the dbt-metricflow bundle for this purpose. You may choose to install other adapters as optional extras from dbt-metricflow.
You may need to install Postgres or Graphviz. You can do so by following the install instructions for Postgres or Graphviz. Mac users may prefer to use brew: brew install postgresql or brew install graphviz.
The best way to get started is to follow the tutorial steps, which you can access by running:
mf tutorial
Note: this must be run from a dbt project root directory.
This project will be a place where people can easily contribute high-quality updates in a supportive environment.
Please read our code of conduct before diving in.
To get started on direct contributions, head on over to our contributor guide.
MetricFlow is source-available software.
Version 0 to 0.140.0 was covered by the Affero GPL license. Version 0.150.0 and greater is covered by the BSL license..
MetricFlow is built by dbt Labs.
FAQs
Translates a simple metric definition into reusable SQL and executes it against the SQL engine of your choice.
We found that metricflow demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.