Back to Details

develop-amql

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Instructions

说明

Use skill to prepare for the development
NEVER assume any AML/AQL syntax, functions, or references.
Use Holistics knowledge and tools
- Refer to and use
```
search_docs
```
  to learn about code syntax.
- Use
```
fetch_dataset
```
  to learn about the dataset (e.g. all available models and fields within that dataset), in order to make accurate edits.
- Use
```
generate_aql
```
  to write AQL (e.g. AQL metrics).
- Use
```
generate_viz
```
  to define Viz.
- Use
```
list_data_sources
```
  ,
```
list_data_source_schemas
```
  ,
```
read_data_source_schema
```
  ,
```
read_data_source_table_schema
```
  to study the underlying database schema in order to write relevant and accurate modeling codes.
Pay attention to code diagnostics and fix them if possible.

使用技能准备开发工作
绝对不要臆测任何AML/AQL语法、函数或引用。
运用Holistics相关知识与工具
- 参考并使用
```
search_docs
```
  学习代码语法。
- 使用
```
fetch_dataset
```
  了解数据集信息（例如该数据集中所有可用的模型和字段），以实现精准编辑。
- 使用
```
generate_aql
```
  编写AQL代码（例如AQL指标）。
- 使用
```
generate_viz
```
  定义可视化内容。
- 使用
```
list_data_sources
```
  、
```
list_data_source_schemas
```
  、
```
read_data_source_schema
```
  、
```
read_data_source_table_schema
```
  研究底层数据库schema，以便编写相关且准确的建模代码。
注意代码诊断信息，尽可能修复问题。

Example workflow

示例工作流

Read relevant codes
If working with a dataset, use
```
fetch_dataset
```
to view all semantics of the dataset
Refer to and use
```
search_docs
```
to learn the correct syntax
To write AQL and Viz, use
```
generate_aql
```
and
```
generate_viz
```
. For others, research further and write the codes.
Make code suggestions for the user

读取相关代码
如果处理的是数据集，使用
```
fetch_dataset
```
查看数据集的所有语义定义
参考并使用
```
search_docs
```
学习正确语法
如需编写AQL和可视化内容，使用
```
generate_aql
```
和
```
generate_viz
```
。其他场景请先深入调研再编写代码。
为用户提供代码建议

Creating new datasets

创建新数据集

Make sure to properly create the models first before creating the dataset
Remember to define relationships

请务必先正确创建模型，再创建数据集
记得定义关联关系

Working with Model files

处理模型文件

You currently are not able to query Models directly. Instead, look for the Dataset containing that Model and query that Dataset instead.
Always try to write field definitions in AQL first. Only fall back to writing SQL definitions if AQL is not possible.

你目前无法直接查询模型，请找到包含该模型的数据集，转而查询该数据集。
始终优先尝试用AQL编写字段定义，只有当AQL无法实现时，才退而使用SQL定义。

Working with Dashboard (page.aml) files

处理仪表盘（page.aml）文件

Remember to arrange your newly created blocks nicely and trim unnecessary spaces

记得把你新创建的区块排布整齐，删除不必要的空格

References

参考资料

See to learn about Holistics and AMQL.
See to learn about Data modeling in Holistics.
See to learn about Holistics AML.

查看了解Holistics和AMQL相关内容。
查看了解Holistics中的数据建模相关内容。
查看了解Holistics AML相关内容。

Related skills

相关技能