视频 天翼云媒体存储系统服务协议 企业中间件 天翼云分布式消息服务协议 软件开发生产线CodeArts服务协议 容器与微服务 天翼云云容器引擎服务协议 天翼云容器实例产品服务协议 天翼云Serverless容器服务产品服务协议 容器镜像产品服务协议 天翼云微服务云应用平台服务协议 微服务引擎产品服务协议 天翼云应用编排服务协议 天翼云应用服务网格服务协议 天翼云EasyCoding敏捷开发平台服务协议 天翼云翼飞低代码平台服务协议 天翼云应用性能监控APM服务协议 天翼云容器安全卫士服务协议 天翼云函数计算服务协议

接口功能介绍 批量查询实例监控数据，目前仅支持查询近30天的监控数据 接口约束 每分钟最多请求200次 URI POST /teledbdcp/v2/openapi/monitor/instMetricData/batch 路径参数 无 Query参数 无 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 prodEngineName 是 String 实例类型, 目前仅支持Mysql, PostgreSQL Mysql instIds 是 Array of Strings 实例Id, 当前最多一次查询20个实例 metricsType 是 String 指标 period 是 Integer 周期,取值为: 15, 60, 900, 3600 15 startTime 是 Long 开始时间戳，精确到秒 endTime 是 Long 结束时间戳，精确到秒 1. period取值为15时，startTime和endTime质检相差不能超过3小时 2. period取值为60时，startTime和endTime之间相差不能超过1天 3. period取值为900时，startTime和endTime之间相差不能超过15天 4. period取值为3600时，startTime和endTime之间相差不能超过30天 aggFunc 是 String 聚合函数 取值为: 5. avg: 表示按照period指定的周期计算平均值 6. max: 表示按照period指定的周期计算最大值 7. min: 表示按照period指定的周期计算最小值 avg 响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 接口状态码，参考下方状态码 200 error String 错误码。当接口失败时才返回具体错误编码，成功不返回或者为空 TELEDBDCP1000 message String 描述信息 returnObj Object 返回对象 ReturnObjDTO 表 ReturnObjDTO 参数 参数类型 说明 示例 下级对象 data Array of Objects 指标详情数据 MetricData 表 MetricData 参数 参数类型 说明 示例 下级对象 metricsType String 指标名 label Object 标签 Label dataPoints Array of Objects 监控数据 DataPoint 表 Label 参数 参数类型 说明 示例 下级对象 outProdInstId String 实例id vpcIp String 机器ip regionId String 资源池id device String 设备名,例如硬盘设备名 vda state String 设备名,例如硬盘设备名 v type String 设备名,例如硬盘设备名 v 表 DataPoint 参数 参数类型 说明 示例 下级对象 avg Double 平均值，当aggFun为avg时，返回此字段 max Double 最大值，当aggFun为max时，返回此字段 min Double 最小值，当aggFun为min时，返回此字段 timestamp Long 时间戳

您可以通过本页了解天翼云TeleDB数据库的应用程序语法。 建立函数语法 plaintext CREATE [OR REPLACE] FUNCTION [模式名.]函数名 ([参数模式 [参数名] 数据类型 [default 默认值] [,…]]) RETRUNS [SETOF] 数据类型 AS [标签] [DECLARE 变量定义] BEGIN 注释 /注释/ 语句执行 END; [标签] LANGUAGE PLPGSQL; [OR REPLACE] 更新函数介绍 OR REPLACE 的作用为函数存在时则替换，建立 PL/pgsql 函数时如果不带 OR REPLACE 关键字， 则遇到函数已经存在，系统会报错，如下所示： plaintext teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb CREATE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; ERROR: function "f" already exists with same argument types teledb CREATE OR REPLACE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb select f(); NOTICE: Hello ,teledb f (1 row) [模式名.]函数名介绍 建立函数名称，模式名可以指定，也可以不指定，不指存则存放在当前模式下，如上面例子就没有指定模式名，则就存放在当前模式下，如下所示： plaintext teledb select from pgnamespace; nspname nspowner nspacl ++ pgtoast 10 pgoracle 10 squeeze 10 pgtemp1 10 pgtoasttemp1 10 pgcatalog 10 {teledbUC/teledb,U/teledb} public 10 {teledbUC/teledb,UC/teledb} informationschema 10 {teledbUC/teledb,U/teledb} (8 rows) teledb

您可以通过本页了解天翼云TeleDB数据库的应用程序语法。 建立函数语法 plaintext CREATE [OR REPLACE] FUNCTION [模式名.]函数名 ([参数模式 [参数名] 数据类型 [default 默认值] [,…]]) RETRUNS [SETOF] 数据类型 AS [标签] [DECLARE 变量定义] BEGIN 注释 /注释/ 语句执行 END; [标签] LANGUAGE PLPGSQL; [OR REPLACE] 更新函数介绍 OR REPLACE 的作用为函数存在时则替换，建立 PL/pgsql 函数时如果不带 OR REPLACE 关键字， 则遇到函数已经存在，系统会报错，如下所示： plaintext teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb CREATE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; ERROR: function "f" already exists with same argument types teledb CREATE OR REPLACE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb select f(); NOTICE: Hello ,teledb f (1 row) [模式名.]函数名介绍 建立函数名称，模式名可以指定，也可以不指定，不指存则存放在当前模式下，如上面例子就没有指定模式名，则就存放在当前模式下，如下所示： plaintext teledb select from pgnamespace; nspname nspowner nspacl ++ pgtoast 10 pgoracle 10 squeeze 10 pgtemp1 10 pgtoasttemp1 10 pgcatalog 10 {teledbUC/teledb,U/teledb} public 10 {teledbUC/teledb,UC/teledb} informationschema 10 {teledbUC/teledb,U/teledb} (8 rows) teledb

本文介绍如何在Python运行环境下的日志打印。 打印日志 当需要查看函数运行相关的自定义状态时，可以使用如下几种方式打印日志至标准输出stdout。往标准输出stdout打印的日志内容会被函数收集。 以下分别介绍所使用的几种日志打印方法。 使用print打印日志 使用此方法打印日志会将内容原样输出到日志中。相应的执行代码及输出的日志内容如下所示。 def handler(event, context): print ('hello world') return 'done' hello world 使用logging模块打印日志 使用此方法打印的每条日志中都会包含时间、RequestId、日志级别等信息。相应的执行代码及输出的日志内容如下所示。 import logging def handler(event, context): logger logging.getLogger() logger.info('hello world') return 'done' 20241114 09:34:34.052 a8b30ba91afc46cd98b758e2a443ced0 [INFO] hello,world 查看日志 函数执行完成后，您可以在函数详情页的日志页签查看日志信息。

特性 对比 云服务日志采集 ELK：使用logstash或者filebeat等开源采集器采集日志。 云日志服务：使用采集器采集日志，提供采集配置向导页面，上手难度低。 多语言SDK日志采集 ELK：不支持。 云日志服务：提供多语言SDK直接上报日志到云日志服务。 日志结构化解析 ELK：基于采集器实现自定义日志结构化解析。 云日志服务：提供结构化解析能力，支持正则表达式、JSON、分隔符多种方式解析日志。 SQL函数 ELK：只支持最基础的SQL统计函数。 云日志服务：除了基础的SQL函数基础，还提供了大量的扩展函数，例如聚合函数、字符串函数、日期和时间函数等，极大扩展了使用场景。 可视化图表 云日志服务提供了表格、时序图、饼图、柱状图、流图、数值图等多种可视化图表。 日志告警 ELK：没有日志告警功能。 云日志服务：开箱即用的日志告警功能，可提供准实时的日志关键词告警功能。支持多种告警渠道。 日志转储 ELK：无法直接转储对象存储。 云日志服务：通过控制台的简单配置可以将日志转储到天翼云对象存储。 日志加工 ELK：没有日志加工功能。 云日志服务：提供可扩展、高可用的数据加工服务，支持数据规整、脱敏、过滤等加工。

您可以通过本页了解天翼云TeleDB数据库的应用程序语法。 建立函数语法 plaintext CREATE [OR REPLACE] FUNCTION [模式名.]函数名 ([参数模式 [参数名] 数据类型 [default 默认值] [,…]]) RETRUNS [SETOF] 数据类型 AS [标签] [DECLARE 变量定义] BEGIN 注释 /注释/ 语句执行 END; [标签] LANGUAGE PLPGSQL; [OR REPLACE] 更新函数介绍 OR REPLACE 的作用为函数存在时则替换，建立 PL/pgsql 函数时如果不带 OR REPLACE 关键字， 则遇到函数已经存在，系统会报错，如下所示： plaintext teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb CREATE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; ERROR: function "f" already exists with same argument types teledb CREATE OR REPLACE FUNCTION f() RETURNS VOID AS $$ BEGIN RAISE NOTICE 'Hello ,teledb'; END; $$ LANGUAGE PLPGSQL; CREATE FUNCTION teledb select prosrc from pgproc where proname'f'; prosrc BEGIN + RAISE NOTICE 'Hello ,teledb';+ END; + (1 row) teledb select f(); NOTICE: Hello ,teledb f (1 row) [模式名.]函数名介绍 建立函数名称，模式名可以指定，也可以不指定，不指存则存放在当前模式下，如上面例子就没有指定模式名，则就存放在当前模式下，如下所示： plaintext teledb select from pgnamespace; nspname nspowner nspacl ++ pgtoast 10 pgoracle 10 squeeze 10 pgtemp1 10 pgtoasttemp1 10 pgcatalog 10 {teledbUC/teledb,U/teledb} public 10 {teledbUC/teledb,UC/teledb} informationschema 10 {teledbUC/teledb,U/teledb} (8 rows) teledb

本文简述响应处理可以使用的相关函数的语法、作用、入参、返回值、示例。 ctyun.resp.getheaders 函数信息详见下表： 项目 描述 语法 headers, err ctyun.resp.getheaders(maxheaders?, raw?) 作用 获取响应头。 入参 maxheaders : numbe类型，缺省为100， 表示最多返回头部数量，为0表示不限制。 raw : bool类型，缺省为false，false 表示表头名称转成纯小写。 返回值 headers : table，保存全部返回的响应头，重复响应头的值为table。 err：字符串类型，错误描述，正确时为nil。 注意：建议ctyun.req.enrollheaderback 回调函数内使用。 示例： abnf local headers ctyun.resp.getheaders() headers {["server"] "openresty"} ctyun.resp.getcode 函数信息详见下表： 项目 描述 语法 respcode ctyun.resp.getcode() 作用 获响应状态码。 入参 无。 返回值 number 状态码 注意： 建议ctyun.req.enrollheaderback 回调函数内使用。 示例： abnf local respcode ctyun.resp.getcode() respcode 200 ctyun.resp.setheader 函数信息详见下表： 项目 描述 语法 ctyun.resp.setheader(headername, headervalue) 作用 设置响应头。 入参 headername：str, 响应头名。 headervalue：str, 响应头值，nil 或者空字符串表示删除。 返回值 无。 示例： stylus ctyun.resp.setheader("test", "aaaaaa") 增加响应头 test:aaaaaa

本文简述响应处理可以使用的相关函数的语法、作用、入参、返回值、示例。 ctyun.resp.getheaders 函数信息详见下表： 项目 描述 语法 headers, err ctyun.resp.getheaders(maxheaders?, raw?) 作用 获取响应头。 入参 maxheaders : numbe类型，缺省为100， 表示最多返回头部数量，为0表示不限制。 raw : bool类型，缺省为false，false 表示表头名称转成纯小写。 返回值 headers : table，保存全部返回的响应头，重复响应头的值为table。 err：字符串类型，错误描述，正确时为nil。 注意：建议ctyun.req.enrollheaderback 回调函数内使用。 示例： abnf local headers ctyun.resp.getheaders() headers {["server"] "openresty"} ctyun.resp.getcode 函数信息详见下表： 项目 描述 语法 respcode ctyun.resp.getcode() 作用 获响应状态码。 入参 无。 返回值 number 状态码 注意： 建议ctyun.req.enrollheaderback 回调函数内使用。 示例： abnf local respcode ctyun.resp.getcode() respcode 200 ctyun.resp.setheader 函数信息详见下表： 项目 描述 语法 ctyun.resp.setheader(headername, headervalue) 作用 设置响应头。 入参 headername：str, 响应头名。 headervalue：str, 响应头值，nil 或者空字符串表示删除。 返回值 无。 示例： stylus ctyun.resp.setheader("test", "aaaaaa") 增加响应头 test:aaaaaa

SQL中union/union all关键字使用的注意事项 不支持包含InnerTable的union运算，比如两个InnerTable，InnerTable与分片表，InnerTable与全局表。 不支持包含InnerTable的union/union all与聚合函数、limit、groupby、having、orderby等关键字运算。 当分组属性中参数：isPermitComplexInnerTableSql“true”时，允许union、union all中使用两个及两个以上的库内分表，反之禁止。 聚合函数 不支持在包含InnerTable的sql中使用包含聚合函数及运算的的表达式（诸如count()+' '）。 having关键字的使用注意事项 having条件中不支持“and”或“or”连接的多个表达式。 having条件中请在表达式左侧使用字段或别名，右侧使用过滤值。 having条件中请使用字段或函数的别名，请勿使用函数本身。 主SQL语句的having中不支持subquery，只能处理常量；子查询语句的having中支持subquery。 子查询 不支持包含InnerTable的子查询语句中“”关键字和聚合函数一起使用。 不支持子查询中InnerTable的数量大于1。 不支持包含InnerTable的子查询中使用包含聚合函数及运算的的表达式（诸如count()+' '）。 不支持包含InnerTable的子查询中使用union/union all。 不支持delete、update语句中使用包含InnerTable的子查询。 不支持delete、update语句包含InnerTable在内的多表操作。

本文简述时间关函数的语法、作用、入参、返回值、示例。 ctyun.now 函数信息详见下表： 项目 描述 语法 secs ctyun.now() 作用 从nginx时间缓存，返回当前时间戳。 入参 无。 返回值 secs : number，带小数表示毫秒的时间戳，例如 1657678155.998。 示例： livecodeserver local secs ctyun.now() secs 1657678155.998 ctyun.time 函数信息详见下表： 项目 描述 语法 sec ctyun.time() 作用 从nginx时间缓存，返回当前时间戳。 入参 无。 返回值 sec : number，时间戳，例如 1657678155。 示例： livecodeserver local sec ctyun.time() sec 1657678155 ctyun.localtime 函数信息详见下表： 项目 描述 语法 str ctyun.locattime() 作用 从nginx时间缓存，返回当前时间。 入参 无。 返回值 str: 返回nginx 缓存时间的本地时间（格式为 ）yyyymmdd hh:mm:ss。 示例： abnf local str ctyun.localtime() str "20220715 15:31:20" ctyun.utctime 函数信息详见下表： 项目 描述 语法 str ctyun.utctime() 作用 从nginx时间缓存，返回当前时间。 入参 无。 返回值 str: 返回nginx 缓存时间的utc时间（格式为 ）yyyymmdd hh:mm:ss。 示例： abnf local str ctyun.utctime() str "20220715 07:31:20"

触发器管理 1. 在“对象列表”下选择“触发器”页签。单击“新建触发器”，输入触发器名称、触发表、触发时机、和触发事件、触发器语句等信息。 2. 确认无误后，单击“立即创建”并在“请确认触发器定义脚本”窗口再次确认，有误请单击“返回修改”，无误请单击“执行脚本”即可创建成功。 函数管理 1. 在“对象列表”下选择“函数”页签。单击“新建函数”，输入函数名称、返回值类型和描述等信息。 2. 确认无误后，单击“确定”。页面跳转到创建函数的SQL预览页面。 3. 在SQL预览页面中单击“选项”，对存储过程的SQL Security、确定性、数据访问等进行配置。 4. 确认无误后，单击“保存”。若您需要修改，请在SQL窗口修改SQL语句，若您确认无误，请单击“执行”即可创建成功。

计算 弹性云主机服务等级协议 天翼云物理机服务等级协议 天翼云弹性伸缩服务等级协议 天翼云云迁移服务等级协议 天翼云函数工作流服务等级协议 天翼云轻量型云主机服务等级协议 天翼云云骁智算服务等级协议 存储 天翼云对象存储服务等级协议 天翼云弹性文件服务等级条款 天翼云硬盘服务等级条款 天翼云云备份服务等级条款 天翼云云容灾服务等级条款 天翼云并行文件HPFS服务等级协议 天翼云海量文件OceanFS服务等级协议 天翼云混合存储网关服务等级协议 云硬盘备份服务等级协议 天翼云弹性容器实例服务等级协议

常见报错 场景一 ERROR: permission denied for function controlextension 解决方法：未使用root 用户执行controlextension 函数，需更改连接用户为 root 。 场景二 ERROR: function controlextension(unknown, unknown) is not unique 解决方法：在不指定schema时，可能存在同名函数，导致函数不唯一无法运行，可选择添加schema参数重试。 场景三 ERROR: function controlextension(unknown, unknown) does not exist 解决方法：controlextension函数在postgres库不存在，postgres库作为RDS运维库，禁止创建插件。

本文简述时间相关函数的语法、作用、入参、返回值、示例。 ctyun.now 函数信息详见下表： 项目 描述 语法 secs ctyun.now() 作用 从nginx时间缓存，返回当前时间戳。 入参 无。 返回值 secs : number，带小数表示毫秒的时间戳，例如 1657678155.998。 示例： livecodeserver local secs ctyun.now() secs 1657678155.998 ctyun.time 函数信息详见下表： 项目 描述 语法 sec ctyun.time() 作用 从nginx时间缓存，返回当前时间戳。 入参 无。 返回值 sec : number，时间戳，例如 1657678155。 示例： livecodeserver local sec ctyun.time() sec 1657678155 ctyun.localtime 函数信息详见下表： 项目 描述 语法 str ctyun.locattime() 作用 从nginx时间缓存，返回当前时间。 入参 无。 返回值 str: 返回nginx 缓存时间的本地时间（格式为 ）yyyymmdd hh:mm:ss。 示例： abnf local str ctyun.localtime() str "20220715 15:31:20" ctyun.utctime 函数信息详见下表： 项目 描述 语法 str ctyun.utctime() 作用 从nginx时间缓存，返回当前时间。 入参 无。 返回值 str: 返回nginx 缓存时间的utc时间（格式为 ）yyyymmdd hh:mm:ss。 示例： abnf local str ctyun.utctime() str "20220715 07:31:20"

本章介绍如何创建函数流触发器 本节介绍创建函数流触发器，函数流触发器当前支持APIG触发器、定时触发器。 创建定时触发器 1. 登录FunctionGraph控制台，进入“函数流”页面。 2. 在“函数流”流程列表页面，选择需要创建触发器的流程，单击“编辑”，进入编辑页面。 3. 单击“开始”节点，在右侧弹出的属性页面添加触发器，触发器类型选择“定时触发器”。 4. 填写触发器配置信息。如下表所示，带参数为必填项。 定时触发器配置信息 配置项 说明 触发规则 定时触发器的触发规则，当前只支持Cron表达式 Cron表达式 用于表示任务调度的表达式，能够表示特定周期进行的特定的时间、日期等。 附加信息 附加信息为json格式，输入必须包含input，在input内输入需要的json体。 input的内容会作为流程的输入参数。 5. 单击“创建”，完成定时触发器创建。 创建APIG（共享版）触发器 说明 首次使用API网关的用户不再支持共享版服务，老用户仍可继续使用共享版服务。即API网关当前已不提供共享版，目前只有存量用户可以使用共享版。 函数流APIG触发器目前仅支持IAM认证方式。 1. 登录FunctionGraph控制台，进入“函数流”页面。 2. 在“函数流”流程列表页面，选择需要创建触发器的流程，单击“编辑”，进入编辑页面。 3. 单击“开始”节点，在右侧弹出的属性页面添加触发器，触发器类型选择“APIG触发器（共享版）”。 4. 填写触发器配置信息。如下表所示，带参数为必填项。 5. 单击“创建”，完成APIG（共享版）触发器创建。 APIG触发器（共享版）信息 字段 填写说明 分组 API分组相当于一个API集合，API提供方以API分组为单位，管理分组内的所有API。 选择“APIGrouptest”。 发布环境 API可以同时提供给不同的场景调用，如生产、测试或开发。 API网关服务提供环境管理，在不同的环境定义不同的API调用路径。 选择“RELEASE”，才能调用。 API类型 API类型： 路径 接口请求的路径。 格式如：/users/projects 请求方式 接口调用方式：GET、POST、DELETE、PUT、PATCH、HEAD、OPTIONS、ANY 其中ANY表示该API支持任意请求方法。

常见报错 场景一 plaintext ERROR: permission denied for function controlextension 解决方法：未使用root用户执行controlextension函数，需更改连接用户为root。 场景二 plaintext ERROR: function controlextension(unknown, unknown) is not unique 解决方法：在不指定schema时，可能存在同名函数，导致函数不唯一无法运行，可选择添加schema参数重试。 场景三 plaintext ERROR: function controlextension(unknown, unknown) does not exist 解决方法：controlextension函数在postgres库不存在，postgres库作为RDS运维库，禁止创建插件。

名称 类型 定义 tableschema name 列所在的表的模式（schema）名称 tablename name 列所在的表的名称 columnname name 列的名称 datatype text 列的数据类型 datatypeowner name 数据类型的所有者名称 datalength integer 列的数据长度，对于字符类型使用pgcharmaxlength函数，对于数值类型使用pgnumericprecision函数 dataprecision integer 列的数值精度，使用pgnumericprecision函数获取 datascale integer 列的数值小数位数，使用pgnumericscale函数获取 nullable text 列是否可以为NULL columnid smallint 列的标识符，对应于attnum datadefault text 列的默认值，使用pggetexpr函数获取

云日志服务支持如下URL函数。 函数列表 函数名称 语法 说明 urlencode urlencode(x) 对URL进行编码。 urldecode urldecode(x) 对URL进行解码。 urlextractfragment urlextractfragment(x) 从URL中提取Fragment信息。 urlextracthost urlextracthost(x) 从URL中提取Host信息。 urlextractparameter urlextractparameter(x) 从URL的查询部分中提取指定参数的值。 urlextractpath urlextractpath(x) 从URL中提取访问路径信息。 urlextractport urlextractport(x) 从URL中提取端口信息。 urlextractprotocol urlextractprotocol(x) 从URL中提取协议信息。 urlextractquery urlextractquery(x) 从URL中提取查询部分的信息。 urlencode函数 对URL进行编码。 语法 plaintext urlencode(x) 参数说明 参数名称 说明 类型 是否必选 x 参数值为具体的URL地址 string类型 是 返回值类型 string 示例 select urlencode(' urldecode函数 对URL进行解码。 语法 plaintext urldecode(x) 参数说明 参数名称 说明 类型 是否必选 x 参数值为编码过的URL地址 string类型 是 返回值类型 string 示例 plaintext select urldecode('https%3A%2F%2Fwww.ctyun.cn%2Fh5%2Fauth%2Flogin') urlextractfragment函数 从URL中提取Fragment信息。 语法 plaintext urlextractfragment(x)

本文介绍函数运行时中的addEventListener定义与用法。 此函数定义了执行用户函数脚本的触发器。addEventListener仅支持注册一个事件监听器。当前仅支持fetch请求事件，通过注册fetch事件监听器，生成HTTP请求事件FetchEvent，进而实现对HTTP请求的处理。 定义 javascript addEventListener(type: string, listener: (event: FetchEvent) > void): void; 说明 如果注册了多个"fetch"类型的监听器，当一个监听器未调用时event.respondWith()，运行时会将事件传递给下一个已注册的监听器。 如果对某个事件进行多次调用会形成调用链条。当某个回调函数调用了respondWith函数时，调用链条会被终止，后面注册的回调函数不会再被调用。 参数 type string 事件类型，当前仅支持"fetch"，后续会支持"scheduled"。 listener function 事件监听器。用于处理事件回调。 示例 javascript // 注册请求事件监听器 addEventListener("fetch", event > { // 响应客户端请求 return event.respondWith( new Response("Hello world") ) }) 相关参考 示例代码：返回 HTML 页面 示例代码：返回 JSON

本文为您介绍如何通过SELECT语法访问函数。 访问函数 plaintext teledb select md5(random()::text); md5 ed5b356234979a63efc6c4f6537c4853 (1 row)

名称 类型 定义 owner name 列所在的表的所有者名称 tableschema name 列所在的表的模式（schema）名称 tablename name 列所在的表的名称 columnname name 列的名称 datatype text 列的数据类型 datatypeowner name 数据类型的所有者名称 datalength integer 列的数据长度，对于字符类型使用pgcharmaxlength函数，对于数值类型使用pgnumericprecision函数 dataprecision integer 列的数值精度，使用pgnumericprecision函数获取 datascale integer 列的数值小数位数，使用pgnumericscale函数获取 nullable text 列是否可以为NULL columnid smallint 列的标识符，对应于attnum datadefault text 列的默认值，使用pggetexpr函数获取

本页简要介绍分布式数据库V5.1.0的版本更新说明。 V5.1.0版本说明 组件名称 版本号 发布时间 TeleDBXCore 5.1 2023年08 月 说明 该版本适配的DCP版本为3.6.1S。 新增和优化功能： 1. 新增日志管理模块。 管控侧：新增错误日志管理、慢日志管理、高频SQL管理和审计日志管理。 内核侧：不涉及。 2. 支持创建定时任务JOB。 管控侧：不涉及。 内核侧：支持通过DBMSJOB创建定时任务。 3. 支持逻辑备份恢复，包括多介质备份和恢复到不同实例。 管控侧：新增介质支持，新增恢复到不同实例功能。 内核侧：不涉及。 4. 支持闪回查询和闪回恢复。 管控侧：不涉及。 内核侧：支持一定时间内旧版本表数据的查询和支持表的恢复，应对误删表的场景。 5. 管控侧对接DCP模块，包括微服务接入和统一鉴权。通过微服务接入，用户管理、VIP管理、实例开通、扩容、注销等功能依赖的底层资源管理均交由DCP分配，控制台保留其实例管理功能和一系列高可用能力，作为DCP微服务体系一部分保障用户实例正常运行。 6. 监控告警信息由管控接入到DCP，包括支持GTM监控能力、指标监控对接DCP和事件告警。 7. 管控侧支持OpenAPI能力。 8. 管控侧对接DCP Cgroup资源隔离能力。 9. 管控侧支持开启索引优化建议定时任务，并查看慢SQL日志列表中对于SQL优化的建议。 10. 支持实例管理，包括实例开通时提供多个不同的blocksize编译包、实例开通时支持配置SSL协议和initdb的时候去设置是否要开启checksum校验。 11. 新增Analyze信息CN同步模块，包括数据计算模块、数据转换模块和数据加载模块。 12. 支持XML类型、支持包Package的修改语法。 13. 内核侧支持通过虚拟索引构建和索引建议分析提升数据库性能。 14. 支持按照如下分布方式：HASH(column) ，MODULO(column) ，ROUNDROBIN，shard，replication 设置数据分布。 15. 物化视图定期刷新数据。 16. 支持拓展MySQL和Oracle外表。 17. 支持madlib适配，扩展机器学习能力。 18. 支持全密态功能。 内核测：支持全密文，包括密文检索和计算。实现数据离开客户端时，在用户侧对数据进行加密，数据以加密形态存储在数据库服务器中，且不影响服务端的检索与计算，当数据返回至客户端时，可自动对数据进行解密，用户对加解密过程无感知。 管控侧：不涉及。 修复漏洞 无。 修复缺陷 1. 将oracle语法兼容的concat和concatws函数从stable改成immutable。 2. 安全用户提示需要修改为mls。 3. 编译配置增加withgmssl选项。 4. 超级用户无法触发慢查询SQL。 5. 创建物化视图使用using method。 6. 大量DROP、TRUNCATE操作从库回放慢导致的CPU飙升。 7. 单独编译插件teledbxoraclepackagefunction报错。 8. 当协调者分析表时，sample的时候采用目标行数需要除以n节点数。 9. 分区表创建include关键字索引报错。 10. 减小backend进程内存使用。 11. 将系统函数updateanalyzecn改成了pgupdateanalyzecn函数。 12. 解决会话处于pgxcnodereceive时无法响应cancel request的问题。 13. 解决arm环境旧版本gmssl在teledb的编译问题。 14. 解决gmssl在x86机器上编译问题。 15. 连续空字符串扩展查询commandTag为NULL coredump修复。 16. 慢SQL查询内核获取的SQL语句为空。 17. 启用“pgqualstats”插件时，在从分区表删除数据时会导致coredump。 18. 删除冗余的XLOGBTREESPLITLROOT和XLOGBTREESPLITRROOT两种xlog类型。 19. 删除EMA代码。 20. 实现alter package语法。 21. 视图增加无效优化SQL 记录。 22. 缩小使用的缓存内存，移除SMgrRelationData 中的 smgrshardtargblocks。 23. 索引支持include关键字特性。 24. 添加telesql，Makefile中添加telesql软连接(install/clean)。 25. 增加自动化DDS死锁检测算法。 26. 增加analyze同步功能。 27. 修改telesql引发make报warning的问题。 28. 修改源码以支持make world和make installworld通过。 29. 修复plpgsql 变量名定义逻辑。 30. 修复pgvisibility回归测例。 31. 修复pgunlock插件存在的编译警告。 32. 修复pgstatstatements插件bugs，创建报错。 33. 修复pgsqueeze如果没有加入sharedpreloadlibarairies参数，执行返回。 34. 修复pgdirtyread插件的Makefile文件以及make check测例。 35. 修复filefdw插件产生coredump问题。 36. 修复auditadmin只能在pghba.conf中设置trust才能使用。 37. 修复在pgxcctl.conf中关于pghba.conf采用scramsha256产生coredump。

本章节主要介绍最佳实践中实现数据列的加解密。 数据加密作为有效防止未授权访问和防护数据泄露的技术，在各种信息系统中广泛使用。作为信息系统的核心，GaussDB(DWS)数仓也提供数据加密功能，包括透明加密和使用SQL函数加密。本章节主要讨论SQL函数加密。 说明 DWS目前不支持从Oracle、Teradata和MySQL加密后到DWS解密。Oracle、Teradata和MySQL与DWS加解密有区别，需要非加密数据迁移到DWS后在DWS侧进行加解密。 技术背景 哈希函数 哈希函数又称为摘要算法，对于数据data，Hash函数会生成固定长度的数据，即Hash(data)result。这个过程是不可逆的，即Hash函数不存在反函数，无法由result得到data。在不应保存明文场景（比如口令password属于敏感信息），系统管理员用户也不应该知道用户的明文口令，就应该使用哈希算法存储口令的单向哈希值。 实际使用中会加入盐值和迭代次数，避免相同口令生成相同的哈希值，以防止彩虹表攻击。 哈希函数 对称密码算法 对称密码算法使用相同的密钥来加密和解密数据。对称密码算法分为分组密码算法和流密码算法。 分组密码算法将明文分成固定长度的分组，用密钥对每个分组加密。由于分组长度固定，当明文长度不是分组长度的整数倍时，会对明文做填充处理。由于填充的存在，分组密码算法得到的密文长度会大于明文长度。 流加密算法是指加密和解密双方使用相同伪随机加密数据流作为密钥，明文数据依次与密钥数据流顺次对应加密，得到密文数据流。实践中数据通常是一个位（bit）并用异或（xor）操作加密。流密码算法不需要填充，得到的密文长度等于明文长度。 对称密码算法

操作步骤 1. 登录工作流控制台，点击目标工作流，进入工作流详情详情。 2. 在配置选项卡中，选择左边的 工作流调度 选项卡。 3. 点击 创建工作流调度 ，在弹出的右抽屉中选择 Kafka触发器，配置参数解释如下表。 配置项 操作说明 示例 触发器类型 选择Kafka触发器。 Kafka触发器 名称 填写自定义的触发器名称。 kafkatrigger Kafka实例 选择已创建的Kafka实例。 Topic 选择已创建的Kafka实例的Topic。 Group ID • 快速创建 ：推荐方案。自动创建以GROUPFCTrigger{triggername}{uuid}命名的Group ID。 • 使用已有：选择Kafka实例已有的GroupID，请您注意不要与已有的业务混用GroupID，否则会影响已有的消息收发。 消费任务并发数 消费者的并发数量，有效取值范围为[1,20]，建议不超过Topic的分区数。该值同时影响投递到函数的并发数。 消费位点 选择消息的消费位点，即触发器从kafka消息队列开始拉取消息的位置。 • 最早位点 ：从最早位点开始消费。 • 最新位点：从最新位点开始消费。 最新位点 调用方式 选择函数调用方式。 • 同步调用 ：指触发器消费topic消息后投递到函数是同步调用，会等待函数响应后继续下一个消息投递。但消费任务并发数大于1时，多个消费者有可能会并发消费消息并投递，并发的情况视topic队列本身积存的消息而定。 • 异步调用：指触发器消费topic消息后投递到函数是异步调用，不会等待函数响应，可以快速消费事件。 同步调用 触发器启用状态 创建触发器后是否立即启用。默认选择开启，即创建触发器后立即启用触发器。 启用 推送配置 • 批量推送条数 ：批量推送的最大值，积压值达到后立刻推送，取值范围为[1,10000]。 • 批量推送间隔 ：批量推送的最大时间间隔，达到后立刻推送，单位秒，取值[0,15]。默认0无需等待，数据直接推送。 • 推送格式：函数收到的事件格式，详情请查阅触发器事件消息格式。 重试策略 消息推送函数失败后重试的策略，共两种： • 指数退避 ：指数退避重试，重试5次，重试周期为2,4,8,16,32（秒）。 • 线性退避：线性退避重试，重试5次，重试周期为1,2,3,4,5（秒）。 容错策略 当重试次数耗尽后仍然失败时的处理方式： • 允许容错 ：当异常发生并超过重试策略配置时直接丢弃。 • 禁止容错：当异常发生并超过重试策略配置时继续阻塞执行。 死信队列 当容错策略为：允许容错时，可以额外开启死信队列。当开启死信队列时且异常发生并超过重试策略配置时，消息会被投递到指定的消息队列里，当前只支持投递到kafka和rocketmq

本文主要介绍天翼云函数工作流服务协议。 天翼云函数工作流服务协议详情请参见这里

还原之前的编译环境 set GOARCHamd64 go env w GOARCHamd64 set GOOSwindows go env w GOOSwindows 创建HTTP函数并上传代码 创建1个HTTP函数，并上传已打包的xxx.zip包。详情请参见 用户指南的“创建HTTP函数”章节。 创建APIG触发器 详情请参见用户指南的“使用APIG（专享版）触发器”，“安全认证”建议选择“None”，方便调试。 调用测试 将刚才创建的APIG触发器的URL+代码中注册的“/hello”复制到浏览器地址栏，可以看到请求结果。

本文主要介绍云日志服务如何使用edrop函数或ekeep函数过滤日志。 您可以使用edrop函数或ekeep函数过滤日志，也可以使用eif函数与edrop()参数、eifelse函数与edrop()参数过滤日志。 常用规则如下所示： ekeep(ehas(...) )：满足条件时保留，不满足条件时丢弃。 edrop(ehas(...) )：满足条件时丢弃，不满足条件时保留。 eifelse(ehas("..."), ekeep(), edrop())：满足条件时保留，不满足条件时丢弃。 eif(ehas("not ..."), edrop())：满足条件时丢弃，不满足条件时保留。 eif(ehas("..."), ekeep())：无意义的加工规则。 示例 原始日志 日志1 tag:observedts: 1597214851 entry: appview id: 8412 selftag: testok 日志2 entry: h5view id: 8415 selftag: testok2 加工规则 丢弃没有entry字段和tag:observedts字段的日志。 eif(enothas("entry"),edrop()) eif(enothas("tag:observedts"),edrop()) 加工结果 tag:observedts: 1597214851 entry: appview id: 8412 selftag: testok

本文介绍插件管理相关概念。 态势感知（专业版）支持将安全编排流程中使用的插件进行统一管理。 名词解释 插件 ：是包含函数、连接器、公共库的聚合。插件有自定义插件和商业插件两种类型，其中，自定义的插件可以在集市中显示，也可以在剧本中使用。 插件集 ：是具有相同业务场景的插件集合。 函数 ：是可以在剧本中选用的执行函数，在剧本中执行特定的行为。 连接器 ：是用于连接数据源，将告警、事件等安全数据接入态势感知（专业版），包括事件触发和定时触发两种连接器类型。 公共库 ：是一个公共模块，包含在其他组件中会使用到的API调用和公共函数。

本文主要介绍天翼云函数工作流服务等级协议。 天翼云函数工作流服务等级协议详情请参见这里

本文介绍函数运行时的Encoding定义与用法。 基于 Web APIs 标准TextEncoder、TextDecoder进行设计，实现编码器与解码器。 TextEncoder TextEncoder 接口表示一个文本解码器，一个解码器只支持一种特定文本编码。传递给构造函数的参数将会被忽略，直接创建UTF8的TextEncoder。 TextEncoder()返回一个新构造的函数，该函数生成使用UTF8编码的字节流。详细定义请参见MDN官方文档TextEncoder。 构造函数 javascript let encoder new TextEncoder() 属性 encoding DOMString 只读，编码器使用的编码类型（始终为utf8）。 方法 encode( input USVString ) Uint8Array 对输入的字符串入进行编码。 TextDecoder 解码器。详细定义请参见MDN官方文档TextDecoder。 构造函数 javascript let decoder new TextDecoder() 属性 encoding DOMString 只读，解码器使用的编码类型。 fatal boolean 只读，表示错误模式是否致命。 ignoreBOM boolean 只读，表示是否忽略字节顺序标记。 方法 decode() DOMString 对输入的字符串入进行解码。 相关参考 示例代码：HMACSHA256签名摘要

DRDS支持字段级别的加解密功能，本文为您介绍该功能的具体使用方法。 注意 本功能尚在小范围公测中，请注意评估功能可能带来的风险并谨慎使用。 前提条件 已创建库表。 目标库表为分片表，且已设置分片规则。设置分片规则的操作，请参见库表管理。 背景信息 DRDS支持字段级别的加解密，通过该功能，可以为您的库表字段进行加密，提高数据安全性。 开启字段加密后，DRDS根据用户配置的字段，将DML类型的SQL语句中对应的字段重写为加密内容后写入到底层数据中。对DQL类型的SQL，如果用户有解密权限，会根据字段解密被加密的字段内容。适用于需要对用户身份证、电话号码等敏感信息加密的场景。 使用限制 仅V5.1.20.0.4及以后版本创建的实例，支持字段加密功能。 仅支持字符串类型的字段进行加密。 开启、关闭或修改字段均对存量数据不生效，仅对新增数据生效。 只支持对表的字段进行加密。 注意事项 开启加密功能后，仅对增量数据进行加密。因此您需要自行处理数据库中原始的存量数据。 开启加密功能后，如果您执行的SQL语句含有加密字段，则存在如下限制： 注意 如果您执行的SQL语句不含有加密字段，则不影响SQL语句执行结果。 支持进行like 和等值查询，比如name是加密字段时，您可以执行如下操作： plaintext select id , name from student where student.name 'xxx'； select id , name from student where 'xxx 'student.name ； SQL语句中涉及加密的字段，只支持单表的查询，包括包含单表自身的子查询，比如 select name from (select name from student ) a ，加密字段的条件只能放到子查询语句中。 不支持join语句里含有加密字段。 不支持对加密字段进行函数计算。 不支持加密字段作为查询条件时不区分大小写功能。如果设置了不区分大小写功能，则加密后大小写对应的加密数据没有大小写对应关系，不区大小写功能将会失效。 加密字段不支持比较操作，如：大于、小于、ORDER BY、BETWEEN 等。 加密字段不支持计算操作，如：AVG、SUM 以及计算表达式。 加密字段只支持字符类型。 不支持udpate 加密字段A 字段B 语法。