集合类型的元素访问

在 PQL 中，通过 Sharp 表达式已经能完成所有的数据操作工作，但是有时会因代码过长而显得繁琐，特别是在访问集合元素数据时。PQL 提供了一种与其他高级语言类似的方式访问集合元素。

数组

可使用属性或索引访问数组的元素。

• $list.first 得到数组的第一个元素，first不区分大小写
• $list.last 得到数组的最后一个元素，last不区分大小写
• $list[2] 按索引项获取元素，得到数组中第二个元素，注意索引从0开始
• $list[$i] 方括号中支持变量
• $list[$i * 2] 方括号中支持运算

数据行

可使用属性或索引访问数据行的元素。

• $row.field 得到数据行中字段名为field的值，field命名仅支持英文字母、数字和下划线。
• $row['姓名'] 得到数据行中字段名姓名的值，这和方式可以访问$row.field访问不了的字段或避免解析时的字符冲突。
• $row[$field] 方括号中支持变量。
• $row[$field + '_1'] 方括号中支持运算。

数据表

因为数据表是数组和数据行的整合，所有支持多级访问。

• $table.first 得到数据表的第一行，如果数据表中有名为first的列，则返回这一列值的数组。first不区分大小写。
• $table.last 得到数据表的最后一行，如果数据表中有名为last的列，则返回这一列值的数组。last不区分大小写。
• $table[n] 得到数据表的第n行，n为整数。注意索引从0开始。
• $table.field 得到数据表中名为field的列所有值的数组，field只能由字母、数字和下划线构成。
• $table['姓名'] 得到数据表中名为'姓名'的列所有值的数组。
• $table.first.field 得到第一行field列的值
• $table[$i]['field'] 得到某一行'field'列的值
• $table[n].field 同上
• $table.field[n] 得到列field中第n项的值，
• $table[$i - 1][$field + '_1'] 方括号中支持运算

注意事项

• 索引项找不到元素时会抛出异常，例如超出索引范围，找不到列等。
• 索引方括号中不能再嵌套，$table[$list[1]]会报错，请使用$table ROW $list[i]。
• 在变量名上加小括号会让索引或属性失去作用，如$(list).first。在集合元素访问时，不会出现解析冲突，当然也可以通过这种方式避免集合解析问题。
• 如果变量不是集合类型，则索引或属性规则无效，如$str[1]，其中的[1]会被忽略。
• 集合元素访问可以直接嵌入到其他语句中，如SELECT * FROM table1 WHERE id=$list[2]。
• 当遇到嵌入冲突时，可以使用 Sharp 表达式的嵌入规则，如SELECT name FROM ${ $connection.default_database }.sys.tables;。
• 集合元素访问在执行时优先于 Sharp 表达式的操作。
• 索引数字从0开始而不是像 Sharp 表达式中从1开始是循环语言本身的习惯，类 SQL 语言都是从1开始。像方括号索引这样的语法更像 Java 或 Javascript，从1开始会显得非常奇怪。
• 仍可以使用叹号!忽略数据类型的自动转化，如WHERE $row.condition!。

参考链接

• 更优雅的数据操作方法 - Sharp 表达式
• Sharp 表达式操作 - 数组 ARRAY
• Sharp 表达式操作 - 数据行 ROW
• Sharp 表达式操作 - 数据表 TABLE