FETCH

功能描述

FETCH通过已创建的游标来检索数据。

每个游标都有一个供FETCH使用的关联位置。游标的关联位置可以在查询结果的第一行之前,或者在结果中的任意行,或者在结果的最后一行之后:

  • 游标刚创建完之后,关联位置在第一行之前的。
  • 在抓取了一些移动行之后,关联位置在检索到的最后一行上。
  • 如果FETCH抓取完了所有可用行,它就停在最后一行后面,或者在反向抓取的情况下是停在第一行前面。
  • FETCH ALL或FETCH BACKWARD ALL将总是把游标的关联位置放在最后一行或者在第一行前面。

注意事项

  • 如果游标定义了NO SCROLL,则不允许使用例如FETCH BACKWARD之类的反向抓取。
  • NEXT、PRIOR、FIRST、LAST、ABSOLUTE、RELATIVE形式在恰当地移动游标之后抓取一条记录。如果后面没有数据行,就返回一个空的结果,此时游标就会停在查询结果的最后一行之后(向后查询时)或者第一行之前(向前查询时)。
  • FORWARD和BACKWARD形式在向前或者向后移动的过程中抓取指定的行数,然后把游标定位在最后返回的行上;或者是,如果count大于可用的行数,则在所有行之后(向后查询时)或者之前(向前查询时)。
  • RELATIVE 0、FORWARD 0、BACKWARD 0都要求在不移动游标的前提下抓取当前行,也就是重新抓取最近刚抓取过的行。除非游标定位在第一行之前或者最后一行之后,这个动作都应该成功,而在那两种情况下,不返回任何行。
  • 当FETCH的游标上涉及列存表时,不支持BACKWARD、PRIOR等涉及反向获取操作。

语法格式

  1. FETCH [ direction { FROM | IN } ] cursor_name;

其中direction子句为可选参数。

  1. NEXT
  2. | PRIOR
  3. | FIRST
  4. | LAST
  5. | ABSOLUTE count
  6. | RELATIVE count
  7. | count
  8. | ALL
  9. | FORWARD
  10. | FORWARD count
  11. | FORWARD ALL
  12. | BACKWARD
  13. | BACKWARD count
  14. | BACKWARD ALL

参数说明

  • direction_clause

    定义抓取数据的方向。

    取值范围:

    • NEXT(缺省值)

      从当前关联位置开始,抓取下一行。

    • PRIOR

      从当前关联位置开始,抓取上一行。

    • FIRST

      抓取查询的第一行(和ABSOLUTE 1相同)。

    • LAST

      抓取查询的最后一行(和ABSOLUTE -1相同)。

    • ABSOLUTE count

      抓取查询中第count行。

      ABSOLUTE抓取不会比用相对位移移动到需要的数据行更快,因为下层的实现必须遍历所有中间的行。

      count取值范围:有符号的整数

      • count为正数,就从查询结果的第一行开始,抓取第count行。
      • count为负数,就从查询结果末尾抓取第abs(count)行。
      • count为0时,定位在第一行之前。
    • RELATIVE count

      从当前关联位置开始,抓取随后或前面的第count行。

      取值范围:有符号的整数

      • count为正数就抓取当前关联位置之后的第count行。
      • count为负数就抓取当前关联位置之前的第abs(count)行。
      • 如果当前行没有数据的话,RELATIVE 0返回空。
    • count

      抓取随后的count行(和FORWARD count一样)。

    • ALL

      从当前关联位置开始,抓取所有剩余的行(和FORWARD ALL一样)。

    • FORWARD

      抓取下一行(和NEXT一样)。

    • FORWARD count

      从当前关联位置开始,抓取随后或前面的count行。

    • FORWARD ALL

      从当前关联位置开始,抓取所有剩余行。

    • BACKWARD

      从当前关联位置开始,抓取前面一行(和PRIOR一样) 。

    • BACKWARD count

      从当前关联位置开始,抓取前面的count行(向后扫描)。

      取值范围:有符号的整数

      • count为正数就抓取当前关联位置之前的count行。
      • count为负数就抓取当前关联位置之后的abs(count)行。
      • 如果有数据的话,BACKWARD 0重新抓取当前行。
    • BACKWARD ALL

      从当前关联位置开始,抓取所有前面的行(向后扫描) 。

  • { FROM | IN } cursor_name

    使用关键字FROM或IN指定游标名称。

    取值范围:已创建的游标的名称。

示例

  1. --SELECT语句,用一个游标读取一个表。开始一个事务。
  2. openGauss=# START TRANSACTION;
  3. --建立一个名为cursor1的游标。
  4. openGauss=# CURSOR cursor1 FOR SELECT * FROM tpcds.customer_address ORDER BY 1;
  5. --抓取头3行到游标cursor1里。
  6. openGauss=# FETCH FORWARD 3 FROM cursor1;
  7. ca_address_sk | ca_address_id | ca_street_number | ca_street_name | ca_street_type | ca_suite_number | ca_city | ca_county | ca_state | ca_zip | ca_country | ca_gmt_offset | ca_location_type
  8. ---------------+------------------+------------------+--------------------+-----------------+-----------------+-----------------+-----------------+----------+------------+---------------+---------------+----------------------
  9. 1 | AAAAAAAABAAAAAAA | 18 | Jackson | Parkway | Suite 280 | Fairfield | Maricopa County | AZ | 86192 | United States | -7.00 | condo
  10. 2 | AAAAAAAACAAAAAAA | 362 | Washington 6th | RD | Suite 80 | Fairview | Taos County | NM | 85709 | United States | -7.00 | condo
  11. 3 | AAAAAAAADAAAAAAA | 585 | Dogwood Washington | Circle | Suite Q | Pleasant Valley | York County | PA | 12477 | United States | -5.00 | single family
  12. (3 rows)
  13. --关闭游标并提交事务。
  14. openGauss=# CLOSE cursor1;
  15. --结束一个事务。
  16. openGauss=# END;
  17. --VALUES子句,用一个游标读取VALUES子句中的内容。开始一个事务。
  18. openGauss=# START TRANSACTION;
  19. --建立一个名为cursor2的游标。
  20. openGauss=# CURSOR cursor2 FOR VALUES(1,2),(0,3) ORDER BY 1;
  21. --抓取头2行到游标cursor2里。
  22. openGauss=# FETCH FORWARD 2 FROM cursor2;
  23. column1 | column2
  24. ---------+---------
  25. 0 | 3
  26. 1 | 2
  27. (2 rows)
  28. --关闭游标并提交事务。
  29. openGauss=# CLOSE cursor2;
  30. --结束一个事务。
  31. openGauss=# END;
  32. --WITH HOLD游标的使用,开启事务。
  33. openGauss=# START TRANSACTION;
  34. --创建一个with hold游标。
  35. openGauss=# DECLARE cursor1 CURSOR WITH HOLD FOR SELECT * FROM tpcds.customer_address ORDER BY 1;
  36. --抓取头2行到游标cursor1里。
  37. openGauss=# FETCH FORWARD 2 FROM cursor1;
  38. ca_address_sk | ca_address_id | ca_street_number | ca_street_name | ca_street_type | ca_suite_number | ca_city | ca_county | ca_state | ca_zip | ca_country | ca_gmt_offset | ca_location_type
  39. ---------------+------------------+------------------+--------------------+-----------------+-----------------+-----------------+-----------------+----------+------------+---------------+---------------+----------------------
  40. 1 | AAAAAAAABAAAAAAA | 18 | Jackson | Parkway | Suite 280 | Fairfield | Maricopa County | AZ | 86192 | United States | -7.00 | condo
  41. 2 | AAAAAAAACAAAAAAA | 362 | Washington 6th | RD | Suite 80 | Fairview | Taos County | NM | 85709 | United States | -7.00 | condo
  42. (2 rows)
  43. --结束事务。
  44. openGauss=# END;
  45. --抓取下一行到游标cursor1里。
  46. openGauss=# FETCH FORWARD 1 FROM cursor1;
  47. ca_address_sk | ca_address_id | ca_street_number | ca_street_name | ca_street_type | ca_suite_number | ca_city | ca_county | ca_state | ca_zip | ca_country | ca_gmt_offset | ca_location_type
  48. ---------------+------------------+------------------+--------------------+-----------------+-----------------+-----------------+-----------------+----------+------------+---------------+---------------+----------------------
  49. 3 | AAAAAAAADAAAAAAA | 585 | Dogwood Washington | Circle | Suite Q | Pleasant Valley | York County | PA | 12477 | United States | -5.00 | single family
  50. (1 row)
  51. --关闭游标。
  52. openGauss=# CLOSE cursor1;

相关链接

CLOSEMOVE