/AWS1/CL_ATH=>GETQUERYRESULTS()
¶
About GetQueryResults¶
Streams the results of a single query execution specified by
QueryExecutionId
from the Athena query results location in
Amazon S3. For more information, see Working with query results, recent queries, and
output files in the Amazon Athena User Guide.
This request does not execute the query but returns results. Use StartQueryExecution to run a query.
To stream query results successfully, the IAM principal with permission to call
GetQueryResults
also must have permissions to the Amazon S3
GetObject
action for the Athena query results location.
IAM principals with permission to the Amazon S3
GetObject
action for the query results location are able to retrieve
query results from Amazon S3 even if permission to the
GetQueryResults
action is denied. To restrict user or role access,
ensure that Amazon S3 permissions to the Athena query location
are denied.
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_QUERYEXECUTIONID
TYPE /AWS1/ATHQUERYEXECUTIONID
/AWS1/ATHQUERYEXECUTIONID
¶
The unique ID of the query execution.
Optional arguments:¶
IV_NEXTTOKEN
TYPE /AWS1/ATHTOKEN
/AWS1/ATHTOKEN
¶
A token generated by the Athena service that specifies where to continue pagination if a previous request was truncated. To obtain the next set of pages, pass in the
NextToken
from the response object of the previous page call.
IV_MAXRESULTS
TYPE /AWS1/ATHMAXQUERYRESULTS
/AWS1/ATHMAXQUERYRESULTS
¶
The maximum number of results (rows) to return in this request.
RETURNING¶
OO_OUTPUT
TYPE REF TO /AWS1/CL_ATHGETQUERYRSLTSOUT
/AWS1/CL_ATHGETQUERYRSLTSOUT
¶
Domain /AWS1/RT_ACCOUNT_ID Primitive Type NUMC