KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #deepseek-harness #dsh-plugin #react #windows #developer-tools

fast-modeling-language

★ 75 Open GitHub ↗

阿里云计算平台DataWorks(https://help.aliyun.com/document_detail/276018.html) 团队出品，快速建模语言

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

>> 语言： [中文](https://github.com/alibaba/fast-modeling-language/blob/main/README_zh_CN.md) | English

# Fast Modeling Language[![Java CI with Maven](https://github.com/alibaba/fast-modeling-language/actions/workflows/maven.yml/badge.svg?branch=main)](https://github.com/alibaba/fast-modeling-language/actions/workflows/maven.yml)

FML(Fast Modeling Language) is a SQL-like language designed for Dimensional Modeling. It is an attempt for fast modeling follows the “Kimball
Dimensional Modeling Techniques Theory” and the “Alibaba’s OneData Theory.“ FML inherits many features from the SQL. For example, the FML studied and
consulted the standard DDL syntax when creating a model, and extensions upon it. While designing a model, you no longer have to care about the
specific rules for different kinds of big data engines. The FML Transformer will convert your models into a SQL syntax, which can be read directly by
a certain kind of engine.

### Features

- A SQL-like language specially designed dimensional modeling.
- Supports syntax definition in the process of data warehouse establishment, such as: Data Warehouse Planning, Fields Standards, Code Tables, Data
  Indicators.
- Build with Java, you can build models easily with the Syntax Nodes Construct API.
- Transforms models into varies syntax with the Transform API for common engines, such as: Hive, Hologres, Mysql.
- Supports JDBC Driver mode, interact with the model engine.

Relation Document(Continuously updating): https://alibaba.github.io/fast-modeling-language/

### Parser Example

```java

import com.aliyun.fastmodel.core.parser.FastModelParser;
import com.aliyun.fastmodel.core.parser.FastModelParserFactory;

public class HelloFML {
    //单例
    private static final FastModelParser FAST_MODEL_PARSER = FastModelParserFactory.getInstance().get();

public static void main(String[] args) {
        String fml
            = "create dim table t_1 alias 'alias_name' (col bigint alias 'alias_name' comment 'col_comment') comment 'comment';";
        CreateDimTable createDimTable = FAST_MODEL_PARSER.parseStatement(fml);
        //do your work
    }
}

```

### Transformer Example

```java
import com.aliyun.fastmodel.core.tree.BaseStatement;
import com.aliyun.fastmodel.transform.api.Transformer;
import com.aliyun.fastmodel.transform.api.TransformerFactory;
import com.aliyun.fastmodel.transform.api.context.TransformContext;
import com.aliyun.fastmodel.transform.api.dialect.DialectMeta;

public class HelloFMLTransformer {
    public static void main(String[] args) {
        DialectMeta dialectMeta =
            Transformer < BaseStatement > statementTransformer = TransformerFactory.getInstance().get(dialectMeta);
        statementTransformer.transform(statement, context).getNode();
    }
}
```

## Building FML from Source

Build environment and conditions for FML

- Unix-like environment (we use Linux, Mac OS X, Cygwin, WSL)
- Git
- Maven (version 3.5.0+ recommended)
- Java 8

Clone and build

```Shell
git clone git@github.com:alibaba/fast-modeling-language.git
cd fast-modeling-language
mvn clean package -DskipTests # this will take up to 10 minutes
```

## Develop FML

IntelliJ IDEA is recommended for the FML Java project. We provide IntelliJ IDEA to developers who would like to commit to the FML code base.
Developer’s IDE need to support at least:

- Java project development
- Support Maven

IntelliJ IDEA IntelliJ IDEA Plugins

- IntelliJ地址: https://www.jetbrains.com/idea/
- IntelliJ ANTLR: https://plugins.jetbrains.com/plugin/7358-antlr-v4
- Code style template: docs/Alibaba_CodeStyle.xml
- ErrorProne: https://errorprone.info/docs/installation

## Security Notice

The `fastmodel-ide-open` web service (default port 7001) does not provide built-in authentication. Do not expose it directly to untrusted networks; deploy it behind an authenticating gateway or reverse proxy, or restrict access to trusted networks only.

## Documentation

FML文档可The introduction and guide of the FML can be found under the `doc/` directory, the docs is managed with the Docsify, to learn more about it: docsify quickstart

- Run locally: `docsify serve docs`
- Then visit http://localhost:3000

## JDK8 Deploy
```mvn
mvn clean compile deploy -Dmaven.test.skip  -Pjdk8 -pl '!fastmodel-transform/fastmodel-transform-hologres,!fastmodel-transform/fastmodel-transform-example,!fastmodel-transform/fastmodel-transform-postgresql,!fastmodel-transform/fastmodel-transform-adbpg,!fastmodel-ide/fastmodel-ide-open-front,!fastmodel-ide/fastmodel-ide-open,!fastmodel-ide/fastmodel-ide-spi,!fastmodel-jacoco,!fastmodel-benchmarks
```

fast-modeling-language

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README