2.0 - 创建脚本 - Teradata AppCenter

Teradata® AppCenter 用户指南

prodname
Teradata AppCenter
vrm_release
2.0
created_date
2020 年 9 月
category
用户指南
featnum
B035-1111-090K-CHS
"" 用户、管理员
  1. 选择"" > 开发 > 创建
  2. 为该脚本输入名称(最多包含 64 个字符),然后选择脚本和类型。
    保存基本信息后,将无法更改脚本类型。
  3. 设置指南中,选择脚本代码,然后输入或上载代码,或链接到 GitHub 存储库。
    选项 注意事项
    上载或输入代码 ("")
    • 上载脚本后,将显示代码,您可以向代码添加内容或编辑代码。
    • 如果上载脚本文件,则可以在创建或编辑脚本时切换为从 GitHub 存储库中提取。
    • 可以为 SQL 查询添加参数,以提高查询的通用性和使其更容易共享。参数可以定义为 “${schema}”,其中的 schema 是接受不同值的参数。

      例如:

      SELECT * FROM “${table}”

    从 GitHub 存储库提取 ("")
    • 从 GitHub 存储库提取之后,将显示代码,您可以向代码添加内容或编辑代码。
    • 如果从 GitHub 存储库提取,则可以在创建或编辑脚本时切换为上载文件。
    • 选择提取文件时,AppCenter 将从通过成功匹配测试的存储库中选择第一个脚本文件,并在缺省文件中显示。具体而言,如果存储库分支中文件的名称与 queriesqueryinitcmdcommand 匹配,则 AppCenter 将选择第一个文件作为驱动程序文件。如果要从存储库中选择另一个文件,请选择 "",选择该文件,然后选择同步存储库
    如果代码中包含环境变量,AppCenter 会在您保存代码时自动将它们添加到设置中。
  4. [可选] 选择说明以选择标记和输入说明。
    选项 注意事项
    添加标记
    • 标记由管理员创建,为可选设置。
    • 添加标记中,开始键入标记的名称,然后选择该名称。
    • 可以为一个应用程序选择一个或多个标记。
    • 若需更多标记,请与管理员联系。
    说明
    • AppCenter 支持纯文本或 GitHub Markdown。
    • 若需有关 GitHub 标记语法的帮助,请在格式设置工具栏中选择 ""
  5. 选择权限以设置用户和脚本权限。
    选项 注意事项
    管理者
    • 在您创建脚本时,您就是脚本所有者。您可以按用户名和 LDAP 组添加管理者。您添加的管理者将视为所有者。
    隐私
    • 缺省情况下,脚本为私有脚本。您可以关闭隐私。对于私有脚本,只有脚本所有者和由所有者添加为管理者的其他用户可以查看、编辑和删除脚本。
  6. 选择设置为运行此脚本的用户添加和移除必需设置和可选设置。
    选项 注意事项
    缺省系统配置 选择运行此脚本时所针对的缺省系统,然后输入系统设置。
    添加字段
    • 名称字段不支持空格。
    • 提示是用户运行脚本时显示的参数的简要说明。
    • 您可以输入缺省参数,最多 5000 个字符。
    • 如果添加参数并选择上载作为类型,AppCenter 将在您运行此脚本的作业时提示您上载参数文件。
    • 对于参数类型为 SQL 的脚本,SQL 参数支持简单 SQL 查询。它不支持下列 SQL 语句:
      • CREATE
      • DELETE
      • DROP
      • INSERT
      • JOIN
      • TRUNCATE
      • UPDATE
        SQL 参数只能列出一列的数据。因此,不能对表使用 * 或多个投影。例如,您不能使用:
        Select * from table-name;
        Select col1,col2,col3 from table-name;
    • SQL 类型字段提供了一个允许用户从该查询中选择多个值选项。运行脚本时,您可以通过 AppCenter 根据关联的数据库表值为查询选择多个值。

      查询语句示例:

      select * from cfilter_demo where col1_item2 in (${Param});
      in 子句 ${Param} 代表整个内容,不需要单引号。
    • 对于多值 SQL 类型参数,AppCenter 仅支持字符串类型列和 IN (notIN) 查询。

      例如,如果脚本代码中的查询是 select * from cfilter_demo where col in (${param}),则 param 是一个 SQL 类型的参数,此参数具有查询 select value from table

      此查询会生成结果 'value1', 'value2', ....。用户可以选择 'value1' 'value2'

      AppCenter 会将 ${param} 替换为 "'value1', 'value2'" 并将查询转换为 "select * from cfilter_demo where col in ('value1', 'value2')

    参数操作
    • 要编辑、重新排序或删除参数,请选择 ""
    • 此处的参数顺序决定这些参数在您运行脚本时的显示顺序。
    可视化
    • 只有 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;
  7. [可选] 选择脚本概览,然后在脚本信息中更改脚本图标和颜色,内存,以及CPU设置。
    选项 注意事项
    图标和颜色
    • AppCenter 会自动分配脚本图标和颜色。您可以更改其中一项设置,也可以同时更改这两项设置。
    内存
    • 接受缺省设置。
      Teradata 建议您仅在遇到表明资源有限的消息或错误时才更改内存CPU 值。例如,如果您运行一个作业,且此作业处于等待资源的状态。如果作业由于内存问题而失败,则会生成一个错误日志,并可通过执行历史记录查看。
    CPU