Frees all resources (local and Athena) associated with result set. It does this by removing query output in AWS S3 Bucket, stopping query execution if still running and removed the connection resource locally.
# S4 method for AthenaResult
dbClearResult(res, ...)
An object inheriting from DBIResult.
Other arguments passed on to methods.
dbClearResult()
returns TRUE
, invisibly.
If a user does not have permission to remove AWS S3 resource from AWS Athena output location, then an AWS warning will be returned.
For example AccessDenied (HTTP 403). Access Denied
.
It is better use query caching or optionally prevent clear AWS S3 resource using noctua_options
so that the warning doesn't repeatedly show.
if (FALSE) {
# Note:
# - Require AWS Account to run below example.
# - Different connection methods can be used please see `noctua::dbConnect` documnentation
library(DBI)
# Demo connection to Athena using profile name
con <- dbConnect(noctua::athena())
res <- dbSendQuery(con, "show databases")
dbClearResult(res)
# Check if connection if valid after closing connection
dbDisconnect(con)
}