8.51. BIT_AND
用法：
功能：
聚集函数，盘算所有非空值按位与。如果没有非空值传入，返回空值。
例子：
- CREATE TABLE tinyint_fun(a tinyint);
- INSERT INTO tinyint_fun values('55');
- INSERT INTO tinyint_fun values('100');
- SELECT bit_and(a) from tinyint_fun;
用法：
功能：
返回 string 中的位数
例子：
- SELECT bit_length('jose');
用法：
功能：
聚集函数，对输入的非空值按位或运算，如果没有输入非空值，则返回空值。
例子：
- CREATE TABLE tinyint_fun(a tinyint);
- INSERT INTO tinyint_fun values('55');
- INSERT INTO tinyint_fun values('100');
- SELECT bit_or(a) from tinyint_fun;
用法：
功能：
该BITAND函数将其输入和输出视为位向量；输出是AND输入的按位。expr1和的类型expr2是NUMBER，结果是类型NUMBER。如果任一参数BITAND为NULL，则结果为NULL。参数必须在 -(2 (n-1) ) .. ((2 (n-1) )-1) 范围内。如果参数超出此范围，则结果未定义。
结果分几个步调盘算。首先，每个参数 A 都被替换为 value SIGN(A)*FLOOR(ABS(A))。这种转换具有将每个参数截断为零的结果。接下来，每个参数 A（现在必须是整数值）被转换为 n 位二进制补码二进制整数值。使用按位运算组合这两个位值AND。末了，将得到的 n 位二进制补码值转换回NUMBER.
BITAND 函数的注意事项
- BITAND定义的当前实现n= 128。
- PL/SQL 支持重载，BITAND此中输入和结果的类型都为 all BINARY_INTEGER，并且n= 32。
例子：
以下示例AND对数字 6（二进制 1,1,0）和 3（二进制 0,1,1）实验操纵：
SELECT BITAND(6,3);
8.55. BLOB_EXPORT
用法：
blob_export(blob ,string )
功能：
将 blob 大对象的内容导出到磁盘文件。
例子：
将test_blob表的lob列导入到blob_out.data文件中。
- SELECT blob_export(lob, 'blob_out.data') FROM test_blob;
用法：
blob_import(string )
功能：
将指定文件 blob 大对象的情势导入到数据库。
例子：
将blob_out.data文件导入到test_blob表的lob列中。
- INSERT INTO test_blob VALUES (2, blob_import('./blob.data'));
用法：
bool_and(expression)
功能：
聚集函数，求逻辑与，如果所有输入值为真则结果为真，否则为假。
例子：
对表 table 的列boolcol所有值求逻辑与。
- SELECT bool_and(boolcol) FROM table;
用法：
bool_or(expression)
功能：
聚集函数，求逻辑或，如果有输入值为真则结果为真，否则为假。
例子：
对表 table 的列boolcol所有值求逻辑或。
- SELECT bool_or(boolcol) FROM table;
用法：
bound_box(box, box)
功能：
几何函数，方框到外包框。
例子：
对表 table 的列boolcol所有值求逻辑或。
- SELECT bound_box(box '((0,0),(1,1))', box '((3,3),(4,4))');
用法：
- box(circle)
- box(point)
- box(point, point)
- box(polygon)
几何函数，根据参数差异。
- circle 圆到方框
- point 点到空方框
- point,point 点到方框
- polygon 多边形到方框
例子：
- SELECT box(circle '((0,0),2.0)')；
- SELECT box(point '(0,0)')；
- SELECT box(point '(0,0)', point '(1,1)')；
- SELECT box(polygon '((0,0),(1,1),(2,0))')；
用法：
- btrim(string text [,characters text])
- btrim(string bytea, bytes bytea)
- 字符串函数，从 string 的开头或结尾删除最长的只包含 characters （默认是一个空格）的串。
- 二进制串函数，从 string 的开头或结尾删除值出现在 bytes 中字节组成的最长串。
例子：
处置惩罚二进制串
- SELECT btrim('\000trim\001'::bytea, '\000\001'::bytea);
- SELECT btrim('xyxtrimyyx', 'xyz');
用法：
cardinality(anyarray)
功能：
数组函数，返回数组中元素总数，如果数组为空则返回0。
例子：
- SELECT cardinality( ARRAY[[1,2], [3,4]]);
用法：
cbrt(dp)
功能：
数学函数，返回 dp 的立方根。
例子：
求 27 的立方根
8.64. CEIL
用法：
功能：
数学函数 ，CEIL返回大于或等于n的最小整数。该数字n始终可以写为整数k和正分数的差f，使得 0 <= f< 1 和n= k- f。CEIL的值是整数k。因此，当且仅当的值恰好是一个整数 时，它的值CEIL就是它本身。此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。该函数返回与参数的数值数据类型相同的数据类型。
例子：
8.65. CEILING
用法：
- ceiling({dp|numeric})
- ceiling()
- 数学函数 ，CEIL返回大于或等于dp的最小整数。 ceil 函数的别名。
- json函数 ，返回大于或等于 SQL/JSON 数字的最接近整数。
例子：
- SELECT ceiling(-95.3)；
- SELECT jsonb_path_query('[0, 1, -2, -3.4, 5.6]', '$[*].ceiling()');
用法：
功能：
几何函数 ，返回图形 object 的中心点。
例子：
- SELECT center(box '((0,0),(1,2))');
用法：
功能：
字符串函数 ，返回字符串 string 的字符数。
例子：
- SELECT char_length('hello');
用法：
功能：
字符串函数 ，返回字符串 string 的字符数,同 char_length 。
例子：
- SELECT character_length('hello');
用法：
- charindex(sub_str varchar, src_str varchar[, start_location int default 1])
字符串函数 ，返回 sub_str 在 src_str 中第一次出现的位置，从 start_location 位置开始查找，start_location 小于等于 0 大概为空时默认为 1。不存在则返回 0。
例子：
- SELECT charindex('bar', 'foobarbar', 5);
用法：
功能：
字符串函数，返回给定代码的字符。对于 UTF8 该参数被视作一个 Unicode 代码点。对于其他多字节编码该参数必须指定一个 ASCII 字符。 NULL (0)字符不被允许， 因为文本数据类型不能 存储这种字节。
例子：
8.71. CIRCLE
用法：
- circle(box)
- circle(point ,double precision)
- circle(polygon)
几何类型转换函数，将输入图形转换到圆形。
例子：
方框到圆
- SELECT circle(box '((0,0),(1,1))');
- SELECT circle(point'(0,0)', 2.0);
- SELECT circle(polygon '((0,0),(1,1),(2,0))');
用法：
- clob_export(clob, string, encode)
将 clob 大对象的内容导出到文件。 string 指定导出的文件路径，encode 指定编码格式，可以为空。
例子：
- SELECT clob_export (lob, 'clob_asc_out.data','sqlascii') FROM test_clob;
用法：
- clob_import(string, encode)
将 clob 大对象的内容从文件导入到数据库。 string 指定导出的文件路径，encode 指定编码格式，可以为空。
例子：
- SELECT clob_import ('clob_asc_out.data','sqlascii') FROM dual;
用法：
功能：
日期/时间函数，返回当前日期和时间（在语句实验期间变化）。
例子：
- SELECT clock_timestamp()
- ;
用法：
功能：
COALESCE 函数返回它的第一个非空参数的值。当且仅当所有参数都为空时才会返回空。它常用于在为显示目的检索数据时用缺省值替换空值。
如果description不为空，这将会返回它的值，否则如果short_description非空则返回short_description的值，如果前两个都为空则返回(none)。 和CASE表达式一样，COALESCE将不会 盘算无助于判断结果的参数；也就是说，在第一个非空参数右边的参数不会被盘算。这个 SQL标准函数提供了类似于NVL和IFNULL的能力，它们被用在某些其他数据库系统中。
例子：
以下示例使用示例oe.product_information表来组织产物清仓贩卖。它为所有标价的产物提供 10% 的折扣。如果没有标价，则贩卖价格为最低价格。如果没有最低价格，则贩卖价格为“5”：
- SELECT product_id, list_price, min_price, COALESCE(0.9*list_price, min_price, 5) "Sale" FROM product_information WHERE supplier_id = 102050 ORDER BY product_id;
用法：
- col_description(table_oid, column_number)
col_description为一个表列返回注释，该表列由所在表的 OID 和它的列号指定（obj_description不能被用在表列，因为表列没有本身的 OID）。
例子：
- CREATE TABLE comment_test (
- id int,
- positive_col int CHECK (positive_col > 0),
- indexed_col int,
- CONSTRAINT comment_test_pk PRIMARY KEY (id));
- COMMENT ON COLUMN comment_test.id IS 'Column ''id'' on comment_test';
- SELECT col_description('comment_test'::regclass, 1) as comment;
用法：
concat(str ”any” [, str ”any” [, ...] ])
功能：
字符串函数，串接所有参数的文本表现。 NULL 参数被忽略.
例子：
此示例使用嵌套连接三个字符串：
- SELECT concat('abcde',2, NULL, 22);
用法：
- concat_ws(sep text,str ” any” [,str ” any” [, ...]])
字符串函数，将除了第一个参数 seq 外的其他参数用分隔符串接在一起。第一个参数被用作分隔符字符串。NULL 参数被忽略。
例子：
此示例使用分隔符连接三个字符串：
- SELECT concat_ws(',','abcde', 2,NULL, 22)；
用法：
功能：
返回数据库服务器当前的用户连接数。
例子：
8.80. CONTAINS
用法：
- contains(expr text,expr2 text [,expr3 varchar])
字符串函数，依据参数expr3 所给出的全文检索的设置信息，以参数 expr2 为查询条件在参数 expr1 中进行 匹 配 查 找，如果找到则返回 true，否则返回 false。
例子：
- SELECT CONTAINS('test of contains','contain');
用法：
convert(string bytea,src_encoding name,dest_encoding name)
功能：
字符串函数，将字符串转换为dest_encoding。原始编码由src_encoding指定。 string在这个编 码中必须可用。转换可以使用 CREATECONVERSION 定义。也有一些预定义的转换。
例子：
用Latin-1 encoding (ISO 8859-1) 表现的 text_in_utf8
- SELECT convert('text_in_utf8','UTF8','LATIN1');
用法：
- convert_from(string bytea, src_encoding name)
字符串函数，将字符串转换为数据库编码。 原始编码 由src_encoding指定。 string在这个编码中必须可用。
例子：
用当前数据库编码表现的text_in_utf8
- SELECT convert_from(’text_in_utf8’,’UTF8’);
用法：
- convert_to(string text,dest_encoding name)
字符串函数，将字符串 string 转换为 dest_encoding 指定的编码格式。
例子：
用 UTF8 编码表达的 sometext .. code:
- SELECT convert_to(’some text’, ’UTF8’);
用法：
corr(y,x)
功能：
CORR返回一组数字对的相关系数。您可以将其用作聚合或分析函数。
此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。
例子：
- CREATE TABLE aggtest (
- a int2,
- b float4
- );
- SELECT corr(b, a) FROM aggtest;
用法：
功能：
三角函数，COS返回n的余弦（以弧度表现的角度）。
此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。
例子：
以下示例返回 180 度的余弦：
- SELECT COS(180 * 3.14159265359/180) ;
用法：
功能：
三角函数，COSH返回n的双曲余弦。
此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。
例子：
以下示例返回零的双曲余弦：
..code:
8.87. COT
用法：
功能：
三角函数，COSH返回n的余切。n以弧度表现。
例子：
..code:
8.88. COUNT
用法：
功能：
count 返回查询返回的行数。您可以将其用作聚合或分析函数。
如果指定expr，则返回不为空COUNT的行数。您可以盘算expr所有行，也可以只盘算expr的差异值。
如果您指定星号 (*)，则此函数返回所有行，包罗重复行和空行。COUNT从不返回 null。
例子：
以下示例COUNT用作聚合函数：
- SELECT count(*) "Total" FROM students;
下面的示例为employees表中的每个员工盘算在低于员工工资 50 到高于员工工资 150 范围内得到工资的员工的移动计数。
- SELECT last_name, salary, COUNT(*) OVER (ORDER BY salary RANGE BETWEEN 50 PRECEDING AND 150 FOLLOWING) AS mov_count FROM employees ORDER BY salary, last_name;
用法：
功能：
covar_pop返回一组数字对的总体协方差。您可以将其用作聚集或分析函数。
此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。
例子：
- CREATE TABLE aggtest (
- a int2,
- b float4
- );
- SELECT covar_pop(b, a) FROM aggtest;
用法：
功能：
COVAR_SAMP返回一组数字对的样本协方差。您可以将其用作聚合或分析函数。
此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。KingBase确定具有最高数值优先级的参数，将别的参数隐式转换为该数据类型，并返回该数据类型。
(SUM(expr1 * expr2) - SUM(expr1) * SUM(expr2) / n) / (n-1)
此中n是 ( expr1, expr2) 对的数量，此中既不为空expr1也不expr2为空。
该函数返回一个类型的值NUMBER。如果函数应用于空集，则返回 null。
例子：
- CREATE TABLE aggtest (
- a int2,
- b float4
- );
- SELECT covar_samp(b, a) FROM aggtest;
用法：
- cume_dist()
- cume_dist(args)
CUME_DIST盘算一组值中某个值的累积分布。返回值的范围CUME_DIST是 >0 到 <=1。领带值始终评估为相同的累积分布值。
此函数将任何数值数据类型或任何可以隐式转换为数值数据类型的非数值数据类型作为参数。KingBase数据库确定具有最高数值优先级的参数，将剩余参数隐式转换为该数据类型，进行盘算并返回NUMBER。
- 作为聚合函数，对于由函数的参数和相应的排序规范标识CUME_DIST的假设行，盘算行在聚合组中的行之间的相对位置。KingBase进行此盘算，就好像假设行被插入到要聚合的行组中一样。该函数的参数标识每个聚合组中的单个假设行。因此，它们必须全部盘算为每个聚合组中的常量表达式。常量参数表达式和聚合子句中的表达式按位置匹配。因此，参数的数量必须相同，并且它们的类型必须兼容。
- 作为分析函数，CUME_DIST盘算一组值中指定值的相对位置。对于 row r，假设升序分列，CUME_DISTofr是值小于或等于行数r除以正在评估的行数的值（整个查询结果集或分区）。
例子：
下面的例子盘算了一个假设雇员在样本表中的雇员中的累积分布，该雇员的薪水为 $15,500，佣金率为 5% oe.employees：
- SELECT CUME_DIST(15500, .05) WITHIN GROUP (ORDER BY salary, commission_pct) "Cume-Dist of 15500" FROM employees;
以下示例盘算采购部门中每个员工的工资百分比。比方，40% 的文员工资低于或等于冰室。
- SELECT job_id, last_name, salary, CUME_DIST() OVER (PARTITION BY job_id ORDER BY salary) AS cume_dist FROM employees WHERE job_id LIKE 'PU%' ORDER BY job_id, last_name, salary, cume_dist;
用法：
功能：
会话信息函数，返回当前数据库名。
例子：
- SELECT current_database()
- ;
用法：
功能：
current_date以数据类型的公历中的值返回会话时区中的当前日期DATE。
例子：
8.94. CURRENT_QUERY
用法：
功能：
当前正在实验的查询的文本，和客户端提交的一样（可能包含多于一个语句）.
例子：
8.95. CURRENT_SCHEMA
用法：
功能：
返回当前模式名 。
例子：
8.96. CURRENT_SCHEMAS
用法：
功能：
返回搜刮路径中的模式名， boolean 参数指定是否包含隐含模式。
例子：
- SELECT current_schemas(true);
用法：
- current_setting(setting_name [, missing_ok])
设置设定函数，得到设置的当前值。 current_setting`得到``setting_name``设置的当前值。它对应于SQL下令SHOW。 如果没有名为``setting_name``的设置，除非提供``missing_ok``并且其值为true，current_setting会抛堕落误。
例子：
- SELECT current_setting('datestyle');
用法：
功能：
根据 precision 指定的精度参数，返回带偶然区的时间。
例子：
8.99. CURRENT_TIMESTAMP
用法：
- current_timestamp(precision)
CURRENT_TIMESTAMP以数据类型的值返回会话时区中的当前日期和时间TIMESTAMP WITH TIME ZONE。时区偏移反映了 SQL 会话的当前当地时间。如果省略precision，则默认值为6。此函数与返回值的区别在于LOCALTIMESTAMP返回值。 CURRENT_TIMESTAMPTIMESTAMP WITH TIME ZONELOCALTIMESTAMPTIMESTAMP在可选参数中，precision指定返回的时间值的小数秒精度。
例子：
- SELECT current_timestamp(8);
用法：
功能：
序列操纵函数，返回最近一次用nextval获取的指定序列的值 。
例子：
- CREATE TEMP SEQUENCE testseq;
- SELECT nextval('testseq');
- SELECT currval('testseq');
- SELECT nextval('testseq');
- SELECT currval('testseq');
用法：
- cursor_to_xml(cursor refcursor, count int, nulls boolean,tableforest boolean, targetns text)
XML操纵函数，把关系表的内容映射成 XML 值。它们可以被看成是 XML 导出功能
例子：
- CREATE TABLE xmltbl (a int, b text);
- INSERT INTO xmltbl VALUES (1, 'one'), (2, 'two'), (-1, null);
- DECLARE xc CURSOR WITH HOLD FOR SELECT * FROM xmltbl ORDER BY 1, 2;
- SELECT cursor_to_xml('xc'::refcursor, 5, false, true, '');
|
