CLOSE

Закрывает курсор.

Синтаксис

CLOSE { <cursor_name> | ALL }

Описание

Оператор CLOSE освобождает ресурсы, связанные с открытым курсором. После закрытия курсора никакие последующие операции с ним недопустимы. Курсор следует закрывать, когда он больше не нужен.

Каждый непереносимый открытый курсор неявно закрывается при завершении транзакции командой COMMIT или ROLLBACK. Переносимый курсор неявно закрывается, если транзакция, в которой он был создан, преждевременно завершена командой ROLLBACK. Если транзакция, создавшая переносимый курсор, успешно зафиксирована, курсор остаётся открытым до тех пор, пока явно не будет выполнен оператор CLOSE либо пока клиент не отключится.

Параметры

  • ursor_name
    • Имя открытого курсора, который необходимо закрыть.
  • ALL
    • Закрыть все открытые курсоры.

Замечания

Курсор считается открытым с момента его объявления. Для объявления (и открытия) курсора используйте оператор DECLARE.

Если курсор был закрыт после точки сохранения, которая впоследствии была откатана, то операция CLOSE не откатывается; то есть курсор остаётся закрытым.

Примеры

Закрыть курсор portala:

CLOSE portala;

Совместимость

Оператор CLOSE полностью соответствует стандарту SQL. CLOSE ALL является расширением YMatrix Database.

Смотрите также

DECLARE, FETCH, MOVE, RETRIEVE