本文简述异步处理相关函数的语法、作用、入参、返回值、示例。 ctyun.thread.run 函数信息详见下表： 项目 描述 语法 result，err ctyun.thread.run(callback, arg1, arg2, ...) 作用 创建一个线程， 异步执行lua函数。主要使用场景为异步通知远端处理结果，不阻塞正常的业务流程。 入参 callback 为lua函数，arg1,arg2,...为lua函数的参数。 返回值 创建成功返回true，失败返回false，以及错误信息err。 注意 由于是独立的线程执行callback，跟正常的业务请求是独立的环境。在callback中不能使用跟请求属性相关的函数（ctyun.req和ctyun.resp以及ctyun.var)。如果需要用到相关的变量，请通过arg1,arg2,...参数传进去。 示例： stata local function test(url, body) local res, err ctyun.queryremote(url, { method "POST", body body, headers { ["ContentType"] "application/xwwwformurlencoded", }, }, 30000) if err then return end end ctyun.thread.run(test, " "test bodyyyyyyy") ctyun.resp.setoutput("hello world") 结果：hello world

本文简述异步处理相关函数的语法、作用、入参、返回值、示例。 ctyun.thread.run 函数信息详见下表： 项目 描述 语法 result，err ctyun.thread.run(callback, arg1, arg2, ...) 作用 创建一个线程， 异步执行lua函数。主要使用场景为异步通知远端处理结果，不阻塞正常的业务流程。 入参 callback 为lua函数，arg1,arg2,...为lua函数的参数。 返回值 创建成功返回true，失败返回false，以及错误信息err。 注意 ：由于是独立的线程执行callback，跟正常的业务请求是独立的环境。在callback中不能使用跟请求属性相关的函数（ctyun.req和ctyun.resp以及ctyun.var)。如果需要用到相关的变量，请通过arg1,arg2,...参数传进去。 示例： stata local function test(url, body) local res, err ctyun.queryremote(url, { method "POST", body body, headers { ["ContentType"] "application/xwwwformurlencoded", }, }, 30000) if err then return end end ctyun.thread.run(test, " "test bodyyyyyyy") ctyun.resp.setoutput("hello world") 结果：hello world

本文介绍函数运行时的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内容

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

本章节主要指导使用Springboot开发应用的用户，部署业务到FunctionGraph。用户通常可以使用SpringInitializr或者IntelliJ IDEA新建等多种方式构建SpringBoot，本章节以Spring.io 的 操作流程 将既有项目部署到FunctionGraph通常只需要：修改项目监听端口号为8000，然后在jar包同目录创建bootstrap文件写入执行jar包的命令。本案例使用IntelliJIDEA，Maven项目。 构建代码包 1. 打开Springboot项目，在maven插件处单击package，生成jar包。 图 生成jar包 2. 配置工程web端口。HTTP函数当前支持8000端口，需配置工程web端口为 8000 （此端口请勿修改） ,可以使用application.properties文件来配置，也可以在启动时指定端口号。 图 配置8000端口 3. 在jar包同目录创建bootstrap文件，输入启动参数：/opt/function/runtime/java11/rtsp/jre/bin/javajar Dfile.encodingutf8/opt/function/code/restservicecomplete0.0.1SNAPSHOT.jar 图 输入启动参数 4. 选中jar包和bootstrap文件，打包成zip包。 创建HTTP函数并上传代码 创建1个HTTP函数，并上传已打包的zip包。请参见用户指南的“创建HTTP函数”章节。 验证结果 1. 使用函数测试事件验证 1. 在函数详情页，选择函数版本，单击“配置测试事件”，弹出“配置测试事件”页。 2. 选择事件模板，修改测试事件中的path、pathParameters参数，构建一个简单的Get请求。 3. 单击“创建”，完成测试事件创建。 4. 单击“测试”，获取响应。 2. 配置APIG（专享版）触发器测试 1. 请参见 用户指南的“使用APIG（专享版）触发器”章节，创建APIG（专享版）触发器，“安全认证”建议选择“None”，方便调试。 2. 复制生成的调用URL在浏览器进行访问。在URL后添加请求参数greeting?namefguser。默认生成的APIG（专享版）触发器的调用URL为“域名/函数名”，在本案例中即： 如果用户直接把已有的工程上传，会因为path里多了函数名而无法直接访问自己的服务。

本页简要介绍分布式数据库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。

本文介绍函数运行时的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内容

响应示例 成功 { "tunnelState": { "status": 1 } } 4.5.查询隧道状态 函数介绍 (void)getTunnelStatus:(TrustCompletion Nullable)completion; 函数用于注册零信任SDK的全局回调。 请求 参数列表 参数 参数类型 参数含义 是否必传 备注 请求示例 [LXRVPNSDKClient getTunnelStatus:^(NSDictionary Nullable response) { self.skipBtn.text [self jsonStringFromDictionary:response]; }]; 响应 参数列表 参数 参数类型 参数含义 是否必传 备注 status NSNumber 隧道状态 是 1｜2｜3｜ 断开｜连接中 ｜已连上 响应示例 成功 { "status": 1 } 4.6.分享日志 函数介绍 (void)SdkShareLog; 函数用于获取日志的存储路径。 请求 参数列表 参数 参数类型 参数含义 是否必传 备注 请求示例 { } 响应 参数列表 参数 参数类型 参数含义 是否必传 备注 无 NSString 日志路径 是 返回日志的路径 响应示例 成功 4.7.获取日志路径 函数介绍 (NSArray)SdkGetLogPath; 函数用于获取日志的存储路径。

本文介绍IP地址转换函数的基本语法及示例。 函数列表 函数名称 语法 说明 inetaton inetaton(x) 把ip转为无符号整型。 inetntoa inetntoa(x) 把无符号整型的ip转为字符串式的地址。 inetaton函数 把ip转为无符号整型。 语法 plaintext inetaton(x) 参数说明 参数名称 说明 类型 是否必选 x 需要转换的参数 string类型 是 返回值类型 unsigned int类型 示例 类型 示例 统计分析语句 返回结果 2130706433 inetntoa函数 把无符号整型的ip转为字符串式的地址。 语法 plaintext inetntoa(x) 参数说明 参数名称 说明 类型 是否必选 x 需要转换的参数 unsigned int类型 是 返回值类型 string类型 示例 类型 示例 统计分析语句 返回结果 127.0.0.1

项目 描述 语法 ctyun.req.enrollheaderback(callbackfunc, ...) 作用 在收到响应头时会回调callbackfunc函数。 入参 callbackfunc: function。回调函数 ... : 回调函数的入参：其他任意类型。入参个数可以是不定的。 返回值 无。

项目 描述 语法 ctyun.req.enrollheaderback(callbackfunc, ...) 作用 在收到响应头时会回调callbackfunc函数。 入参 callbackfunc: function。回调函数 ... : 回调函数的入参：其他任意类型。入参个数可以是不定的。 返回值 无。

云日志服务提供手机号号码函数，用于获取手机号的运营商，归属省份以及归属城市。 函数列表 函数名称 语法 说明 mobilecarrier mobilecarrier(x) 获取手机号号码运营商。 mobilecity mobilecity(x) 获取手机号号码运所属城市。 mobileprovince mobileprovince(x) 获取手机号号码运所属省份。 mobilecarrier函数 获取手机号号码运营商。 语法 mobilecarrier(x) 参数说明 参数名称 说明 类型 是否必选 x 手机号号码 string类型 是 返回值类型 string 示例 类型 示例 统计分析语句 select mobilecarrier('18922732377') 返回结果 mobilecity函数 获取手机号号码运所属城市。 语法 mobilecity(x) 参数说明 参数名称 说明 类型 是否必选 x 手机号号码 string类型 是 返回值类型 string类型 示例 类型 示例 统计分析语句 select mobilecity('18922732377') 返回结果 mobileprovince函数 获取手机号号码运所属省份。 语法 mobileprovince(x) 参数说明 参数名称 说明 类型 是否必选 x 手机号号码 string类型 是

本章主要介绍创建自定义认证。 操作场景 自定义认证包含两种认证：前端自定义认证和后端自定义认证。 前端自定义认证：如果您希望使用自己的认证系统，而不是APP认证/IAM认证对API的访问进行认证鉴权时，您可以使用自定义认证，通过您自定义的函数进行认证鉴权。 后端自定义认证：当不同的后端服务使用不同的认证系统时，导致您需要为不同的认证系统定制化开发API，而APIG通过自定义认证功能，将多种认证系统集成，简化API开发的复杂度。您只需要在APIG中创建自定义的函数认证，APIG通过此函数对接后端认证系统，获取后端服务的访问授权。 说明 自定义认证依赖函数工作流服务。如果当前Region没有上线函数工作流服务，则不支持使用自定义认证。 使用自定义认证调用API的流程如下图所示： 图 使用自定义认证调用API 前提条件 已在函数工作流服务中完成函数创建。 创建自定义认证 步骤 1 进入API网关控制台页面。 步骤 2 根据实际业务在左侧导航栏上方选择实例。 步骤 3 在左侧导航栏选择“API管理 > API策略”。 步骤 4 在“自定义认证”页面，单击“创建自定义认证”。 配置自定义认证参数。 表 自定义认证参数说明 信息项 描述 认证名称 您自定义的认证名称，用于区分不同的自定义认证。 类型 前端：对API的访问进行认证鉴权。 后端：对后端服务的访问授权。 函数地址 选择在FunctionGraph中创建的函数。 版本或别名 选择函数的版本或别名。 缓存时间(秒) 设置认证结果缓存的时间。 值为0时代表不缓存，最大支持3600秒。 身份来源 设置用于认证的请求参数。 当“类型”为“前端”，且“缓存时间”不为0时，必须设置此参数。使用缓存时，此参数将作为搜索条件来查询认证结果。 是否发送body 指是否将API请求的body体内容传递给认证函数。body体内容传给函数的方式，与header、query内容传递一致。 用户数据 您自定义的请求参数，APIG调用函数时，与“身份来源”一同作为请求参数。 步骤 5 单击“确定”，完成自定义认证的创建。

如果您需要对您所拥有的FunctionGraph进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以： 根据企业的业务组织，在您的帐号中，给企业中不同职能部门的员工创建IAM用户，让员工拥有唯一安全凭证，并使用FunctionGraph资源。 根据企业用户的职能，设置不同的访问权限，以达到用户之间的权限隔离。 将FunctionGraph资源委托给更专业、高效的其他帐号或者云服务，这些帐号或者云服务可以根据权限进行代运维。 如果帐号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用FunctionGraph服务的其它功能。 本章节为您介绍对用户授权的方法，操作流程如下图所示。 前提条件 给用户组授权之前，请您了解用户组可以添加的FunctionGraph权限，并结合实际需求进行选择。 实例流程 1. 在IAM控制台创建用户组，并授予FunctionGraph查询及调用权限“FunctionGraph Invoker”。 2. 在IAM控制台创建用户，并将其加入步骤1中创建的用户组。 3. 新创建的用户登录管理控制台，验证FunctionGraph的函数查询权限。 1. 在“服务列表”中选择“函数工作流 FunctionGraph”，进入“函数 > 函数列表”，单击“创建函数”进入到创建函数界面，发现无法创建函数，表示“FunctionGraph Invoker”已生效。 2. 在“服务列表”中选择除FunctionGraph外的任一服务，若提示权限不足，表示“FunctionGraph Invoker”已生效。

本文主要介绍云日志服务中的数据加工常见问题。 基本语法错误 问题：编写了不符合日志加工 DSL语法的加工规则，例如：多或者少写括号、逗号（,），漏打回车符等。 排查方法：通过加工预览检测语法错误，页面会提示SyntaxError等错误信息。 非法运算符 问题：日志加工DSL中所有的操作都需要通过 DSL提供的函数来完成。比如数值运算、比较等操作都需要通过op函数完成，而不能直接使用python运算符。 排查方法：通过加工预览检测运算符等错误；可将算术运算符和比较操作符等运算符替换为DSL提供的函数完成。 调用不存在的函数 问题：调用了不存在的函数，通过加工预览即可检测出来，并提示unknown function。 排查方法：通过加工预览即可检测出是否调用了不存在的函数；建议检查是否拼写错误。 函数参数传递错误 问题：参数类型错误或参数个数错误等，加工预览会有错误结果输出，比如TypeError、ValueError、"xx takes at least x arguments (xx given)"等。 排查方法：通过加工预览和构造测试日志发现参数传递问题。

本文介绍如何在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 查看日志 函数执行完成后，您可以在函数详情页的日志页签查看日志信息。

您可以通过本页了解天翼云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

本章介绍函数工作流在同步调用或异步调用执行失败时如何重试。 函数在同步调用或异步调用执行失败时，您可以参见以下重试机制进行操作。 同步调用 同步调用执行失败，建议您自行尝试重试。 异步调用 异步调用可在界面配置最大重试次数和消息最大有限期，具体配置方法请参见配置函数异步。函数平台会根据您配置的最大重试次数和消息最大有限期（最大有限期为24小时），进行重试。重试次数和配置的最大重试次数一致，重试有效期和配置的消息最大有效期一致。

函数访问的VPC没有限制，但每个函数最多只可以配置一个VPC，同时只能访问一个VPC内的资源。

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 语法。

本文简述时间关函数的语法、作用、入参、返回值、示例。 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"

您可以通过本页了解天翼云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

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

本文简述响应处理可以使用的相关函数的语法、作用、入参、返回值、示例。 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在内的多表操作。

本文介绍函数运行时中的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

本节主要介绍本地裸盘及其创建操作。 简介 本地裸盘（Raw Disk，RW）是为宿主物理机上的计算实例提供直接读写本机物理硬盘的高IO存储服务。对于操作系统来说，就是一个类型为block的文件或称块设备。裸盘未经分区和格式化，跨过了文件系统层的调用，具备更高IO性能。用户只能直接按照物理硬盘本身的容量规格整块购买使用本地裸盘。本地裸盘目前提供SATA HDD、SATA SSD、NVMe SSD三种类型的介质，可购买规格以实际库存为准。本地裸盘仅支持数据盘挂载到虚拟机实例、容器实例或函数服务。 创建本地裸盘 1. 登录ECX控制台。 2. 单击【边缘存储>本地裸盘】，在本地裸盘页右上角点击【购买本地裸盘】。 3. 【基础配置>计费模式】选择【包年包月】或者【按需计费】。 4. 【地域】和【可用区】选择需要创建本地裸盘的地域和可用区。 5. 点击【增加一块数据盘】，选择本地裸盘的类型、大小以及驱动。 6. 本地裸盘只能选择立即挂载，点击下拉列表【请选择挂载虚机】，列表中显示当前集群运行中和已关机的虚拟机，点击【选择】需要挂载的虚拟机。 7. 选择磁盘后，单击【下单购买】完成支付，即创建成功。 注意 实际可购买的地域和可用区以库存展示为准

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

本文简述时间相关函数的语法、作用、入参、返回值、示例。 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支持任意请求方法。