- 在开发中,单击 创建。
- 为该脚本输入名称(最多包含 64 个字符),然后选择脚本和类型。保存基本信息后,将无法更改脚本类型。
- 完成配置,并考虑以下注意事项:
脚本选项 注意事项 脚本代码 - 您可以输入 SQL 代码、上载脚本文件或与 GitHub 存储库同步。
- 如果上载脚本文件,则可切换到 GitHub 存储库。如果从 GitHub 存储库提取数据,则可切换到已上载的文件。
- 如果从 GitHub 提取数据,AppCenter 会选择成功通过匹配测试的第一个脚本文件。具体而言,如果存储库分支中的文件名称与 queries、query、init、cmd 或 command 匹配,AppCenter 将选择其中的第一个文件作为驱动程序文件。如果要选择存储库中的其他文件,请单击 ,选择该文件,然后单击同步存储库。
- 可以为 SQL 查询添加参数,以使其变得更通用和可共享。参数可以定义为 “${schema}”,其中 schema 是接受不同值的参数。例如:SELECT * FROM “${schema}”
说明和标记 - 说明为可选项。AppCenter 支持纯文本或 GitHub Markdown。您可以使用 GitHub Markdown 或 HTML 添加图像。
- 标记为可选。您可以为应用程序或脚本选择一个或多个标记。有关其他标记,请联系管理员。
权限 - 可以按用户名和组添加管理者和私有用户。
设置 - 执行作业时会自动为该脚本选择缺省系统。执行作业时,您可以选择缺省系统以外的其他系统。
- 可用设置取决于上载的脚本代码。
- 设置的名称字段不支持空格。
- 如果添加了一个必填字段,但它不是作业执行参数的一部分,则作业将失败。
- 对于 SQL 类型,AppCenter 支持简单的 SQL 查询,但不支持以下查询:
- CREATE
- DELETE
- DROP
- INSERT
- JOIN
- TRUNCATE
- UPDATE
- "*"
- ","
- 如果添加参数并选择上载作为类型,则在执行作业时,AppCenter 会提示您为该脚本上载参数文件。
- 单击 可编辑和删除参数或对参数进行重新排序。移动一个参数后,请等待直到 AppCenter 已保存配置,然后再移动其他参数。配置已保存后,AppCenter 会显示一条消息。
可视化 - 只有 SQL 脚本支持可视化。
- 如果添加了可视化参数,AppCenter 将基于您上载的脚本文件文件中的查询数生成可视化。
- 每个可视化类型的代码必须包含 --name=type,后跟 SQL。有关示例,请参阅 SQL 脚本的可视化代码示例。
- 如果选择上载作为类型,请按照屏幕上有关安装和运行 Node.js 与 Polymer Bundler 的说明,上载生成的包含可视化的已捆绑文件。
- 如果 SQL 文件包含 SELECT 语句但没有查询标记,AppCenter 将生成一个表可视化。例如,AppCenter 将根据以下 SQL 文件生成一个表可视化:
SELECT * FROM cfilter_demo LIMIT 100;
如果 SQL 文件包含 SELECT 语句和查询标记,AppCenter 将生成图表可视化。例如,AppCenter 将基于以下 SQL 文件生成一个图表可视化:
--name=query1 SELECT * FROM cfilter_demo LIMIT 100;