Java tutorial
/* * Copyright 2014-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.athena; import org.w3c.dom.*; import java.net.*; import java.util.*; import javax.annotation.Generated; import org.apache.commons.logging.*; import com.amazonaws.*; import com.amazonaws.annotation.SdkInternalApi; import com.amazonaws.auth.*; import com.amazonaws.handlers.*; import com.amazonaws.http.*; import com.amazonaws.internal.*; import com.amazonaws.internal.auth.*; import com.amazonaws.metrics.*; import com.amazonaws.regions.*; import com.amazonaws.transform.*; import com.amazonaws.util.*; import com.amazonaws.protocol.json.*; import com.amazonaws.util.AWSRequestMetrics.Field; import com.amazonaws.annotation.ThreadSafe; import com.amazonaws.client.AwsSyncClientParams; import com.amazonaws.client.builder.AdvancedConfig; import com.amazonaws.services.athena.AmazonAthenaClientBuilder; import com.amazonaws.AmazonServiceException; import com.amazonaws.services.athena.model.*; import com.amazonaws.services.athena.model.transform.*; /** * Client for accessing Amazon Athena. All service calls made using this client are blocking, and will not return until * the service call completes. * <p> * <p> * Amazon Athena is an interactive query service that lets you use standard SQL to analyze data directly in Amazon S3. * You can point Athena at your data in Amazon S3 and run ad-hoc queries and get results in seconds. Athena is * serverless, so there is no infrastructure to set up or manage. You pay only for the queries you run. Athena scales * automaticallyexecuting queries in parallelso results are fast, even with large datasets and complex queries. For * more information, see <a href="http://docs.aws.amazon.com/athena/latest/ug/what-is.html">What is Amazon Athena</a> in * the <i>Amazon Athena User Guide</i>. * </p> * <p> * If you connect to Athena using the JDBC driver, use version 1.1.0 of the driver or later with the Amazon Athena API. * Earlier version drivers do not support the API. For more information and to download the driver, see <a * href="https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html">Accessing Amazon Athena with JDBC</a>. * </p> * <p> * For code samples using the AWS SDK for Java, see <a * href="https://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and Code Samples</a> in the <i>Amazon * Athena User Guide</i>. * </p> */ @ThreadSafe @Generated("com.amazonaws:aws-java-sdk-code-generator") public class AmazonAthenaClient extends AmazonWebServiceClient implements AmazonAthena { /** Provider for AWS credentials. */ private final AWSCredentialsProvider awsCredentialsProvider; private static final Log log = LogFactory.getLog(AmazonAthena.class); /** Default signing name for the service. */ private static final String DEFAULT_SIGNING_NAME = "athena"; /** Client configuration factory providing ClientConfigurations tailored to this client */ protected static final ClientConfigurationFactory configFactory = new ClientConfigurationFactory(); private final AdvancedConfig advancedConfig; private static final com.amazonaws.protocol.json.SdkJsonProtocolFactory protocolFactory = new com.amazonaws.protocol.json.SdkJsonProtocolFactory( new JsonClientMetadata().withProtocolVersion("1.1").withSupportsCbor(false).withSupportsIon(false) .addErrorMetadata(new JsonErrorShapeMetadata().withErrorCode("InvalidRequestException") .withExceptionUnmarshaller( com.amazonaws.services.athena.model.transform.InvalidRequestExceptionUnmarshaller .getInstance())) .addErrorMetadata(new JsonErrorShapeMetadata().withErrorCode("ResourceNotFoundException") .withExceptionUnmarshaller( com.amazonaws.services.athena.model.transform.ResourceNotFoundExceptionUnmarshaller .getInstance())) .addErrorMetadata(new JsonErrorShapeMetadata().withErrorCode("InternalServerException") .withExceptionUnmarshaller( com.amazonaws.services.athena.model.transform.InternalServerExceptionUnmarshaller .getInstance())) .addErrorMetadata(new JsonErrorShapeMetadata().withErrorCode("TooManyRequestsException") .withExceptionUnmarshaller( com.amazonaws.services.athena.model.transform.TooManyRequestsExceptionUnmarshaller .getInstance())) .withBaseServiceExceptionClass( com.amazonaws.services.athena.model.AmazonAthenaException.class)); public static AmazonAthenaClientBuilder builder() { return AmazonAthenaClientBuilder.standard(); } /** * Constructs a new client to invoke service methods on Amazon Athena using the specified parameters. * * <p> * All service calls made using this new client object are blocking, and will not return until the service call * completes. * * @param clientParams * Object providing client parameters. */ AmazonAthenaClient(AwsSyncClientParams clientParams) { this(clientParams, false); } /** * Constructs a new client to invoke service methods on Amazon Athena using the specified parameters. * * <p> * All service calls made using this new client object are blocking, and will not return until the service call * completes. * * @param clientParams * Object providing client parameters. */ AmazonAthenaClient(AwsSyncClientParams clientParams, boolean endpointDiscoveryEnabled) { super(clientParams); this.awsCredentialsProvider = clientParams.getCredentialsProvider(); this.advancedConfig = clientParams.getAdvancedConfig(); init(); } private void init() { setServiceNameIntern(DEFAULT_SIGNING_NAME); setEndpointPrefix(ENDPOINT_PREFIX); // calling this.setEndPoint(...) will also modify the signer accordingly setEndpoint("athena.us-east-1.amazonaws.com"); HandlerChainFactory chainFactory = new HandlerChainFactory(); requestHandler2s .addAll(chainFactory.newRequestHandlerChain("/com/amazonaws/services/athena/request.handlers")); requestHandler2s .addAll(chainFactory.newRequestHandler2Chain("/com/amazonaws/services/athena/request.handler2s")); requestHandler2s.addAll(chainFactory.getGlobalHandlers()); } /** * <p> * Returns the details of a single named query or a list of up to 50 queries, which you provide as an array of query * ID strings. Requires you to have access to the workgroup in which the queries were saved. Use * <a>ListNamedQueriesInput</a> to get the list of named query IDs in the specified workgroup. If information could * not be retrieved for a submitted query ID, information about the query ID submitted is listed under * <a>UnprocessedNamedQueryId</a>. Named queries differ from executed queries. Use * <a>BatchGetQueryExecutionInput</a> to get details about each unique query execution, and * <a>ListQueryExecutionsInput</a> to get a list of query execution IDs. * </p> * * @param batchGetNamedQueryRequest * @return Result of the BatchGetNamedQuery operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.BatchGetNamedQuery * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetNamedQuery" target="_top">AWS API * Documentation</a> */ @Override public BatchGetNamedQueryResult batchGetNamedQuery(BatchGetNamedQueryRequest request) { request = beforeClientExecution(request); return executeBatchGetNamedQuery(request); } @SdkInternalApi final BatchGetNamedQueryResult executeBatchGetNamedQuery(BatchGetNamedQueryRequest batchGetNamedQueryRequest) { ExecutionContext executionContext = createExecutionContext(batchGetNamedQueryRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<BatchGetNamedQueryRequest> request = null; Response<BatchGetNamedQueryResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new BatchGetNamedQueryRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(batchGetNamedQueryRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "BatchGetNamedQuery"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<BatchGetNamedQueryResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new BatchGetNamedQueryResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Returns the details of a single query execution or a list of up to 50 query executions, which you provide as an * array of query execution ID strings. Requires you to have access to the workgroup in which the queries ran. To * get a list of query execution IDs, use <a>ListQueryExecutionsInput$WorkGroup</a>. Query executions differ from * named (saved) queries. Use <a>BatchGetNamedQueryInput</a> to get details about named queries. * </p> * * @param batchGetQueryExecutionRequest * @return Result of the BatchGetQueryExecution operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.BatchGetQueryExecution * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetQueryExecution" target="_top">AWS * API Documentation</a> */ @Override public BatchGetQueryExecutionResult batchGetQueryExecution(BatchGetQueryExecutionRequest request) { request = beforeClientExecution(request); return executeBatchGetQueryExecution(request); } @SdkInternalApi final BatchGetQueryExecutionResult executeBatchGetQueryExecution( BatchGetQueryExecutionRequest batchGetQueryExecutionRequest) { ExecutionContext executionContext = createExecutionContext(batchGetQueryExecutionRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<BatchGetQueryExecutionRequest> request = null; Response<BatchGetQueryExecutionResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new BatchGetQueryExecutionRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(batchGetQueryExecutionRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "BatchGetQueryExecution"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<BatchGetQueryExecutionResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new BatchGetQueryExecutionResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Creates a named query in the specified workgroup. Requires that you have access to the workgroup. * </p> * <p> * For code samples using the AWS SDK for Java, see <a * href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and Code Samples</a> in the * <i>Amazon Athena User Guide</i>. * </p> * * @param createNamedQueryRequest * @return Result of the CreateNamedQuery operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.CreateNamedQuery * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateNamedQuery" target="_top">AWS API * Documentation</a> */ @Override public CreateNamedQueryResult createNamedQuery(CreateNamedQueryRequest request) { request = beforeClientExecution(request); return executeCreateNamedQuery(request); } @SdkInternalApi final CreateNamedQueryResult executeCreateNamedQuery(CreateNamedQueryRequest createNamedQueryRequest) { ExecutionContext executionContext = createExecutionContext(createNamedQueryRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<CreateNamedQueryRequest> request = null; Response<CreateNamedQueryResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new CreateNamedQueryRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(createNamedQueryRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateNamedQuery"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<CreateNamedQueryResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new CreateNamedQueryResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Creates a workgroup with the specified name. * </p> * * @param createWorkGroupRequest * @return Result of the CreateWorkGroup operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.CreateWorkGroup * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateWorkGroup" target="_top">AWS API * Documentation</a> */ @Override public CreateWorkGroupResult createWorkGroup(CreateWorkGroupRequest request) { request = beforeClientExecution(request); return executeCreateWorkGroup(request); } @SdkInternalApi final CreateWorkGroupResult executeCreateWorkGroup(CreateWorkGroupRequest createWorkGroupRequest) { ExecutionContext executionContext = createExecutionContext(createWorkGroupRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<CreateWorkGroupRequest> request = null; Response<CreateWorkGroupResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new CreateWorkGroupRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(createWorkGroupRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateWorkGroup"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<CreateWorkGroupResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new CreateWorkGroupResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Deletes the named query if you have access to the workgroup in which the query was saved. * </p> * <p> * For code samples using the AWS SDK for Java, see <a * href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and Code Samples</a> in the * <i>Amazon Athena User Guide</i>. * </p> * * @param deleteNamedQueryRequest * @return Result of the DeleteNamedQuery operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.DeleteNamedQuery * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteNamedQuery" target="_top">AWS API * Documentation</a> */ @Override public DeleteNamedQueryResult deleteNamedQuery(DeleteNamedQueryRequest request) { request = beforeClientExecution(request); return executeDeleteNamedQuery(request); } @SdkInternalApi final DeleteNamedQueryResult executeDeleteNamedQuery(DeleteNamedQueryRequest deleteNamedQueryRequest) { ExecutionContext executionContext = createExecutionContext(deleteNamedQueryRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<DeleteNamedQueryRequest> request = null; Response<DeleteNamedQueryResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new DeleteNamedQueryRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(deleteNamedQueryRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteNamedQuery"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<DeleteNamedQueryResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new DeleteNamedQueryResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Deletes the workgroup with the specified name. The primary workgroup cannot be deleted. * </p> * * @param deleteWorkGroupRequest * @return Result of the DeleteWorkGroup operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.DeleteWorkGroup * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteWorkGroup" target="_top">AWS API * Documentation</a> */ @Override public DeleteWorkGroupResult deleteWorkGroup(DeleteWorkGroupRequest request) { request = beforeClientExecution(request); return executeDeleteWorkGroup(request); } @SdkInternalApi final DeleteWorkGroupResult executeDeleteWorkGroup(DeleteWorkGroupRequest deleteWorkGroupRequest) { ExecutionContext executionContext = createExecutionContext(deleteWorkGroupRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<DeleteWorkGroupRequest> request = null; Response<DeleteWorkGroupResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new DeleteWorkGroupRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(deleteWorkGroupRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteWorkGroup"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<DeleteWorkGroupResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new DeleteWorkGroupResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Returns information about a single query. Requires that you have access to the workgroup in which the query was * saved. * </p> * * @param getNamedQueryRequest * @return Result of the GetNamedQuery operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.GetNamedQuery * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetNamedQuery" target="_top">AWS API * Documentation</a> */ @Override public GetNamedQueryResult getNamedQuery(GetNamedQueryRequest request) { request = beforeClientExecution(request); return executeGetNamedQuery(request); } @SdkInternalApi final GetNamedQueryResult executeGetNamedQuery(GetNamedQueryRequest getNamedQueryRequest) { ExecutionContext executionContext = createExecutionContext(getNamedQueryRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<GetNamedQueryRequest> request = null; Response<GetNamedQueryResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new GetNamedQueryRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(getNamedQueryRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetNamedQuery"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<GetNamedQueryResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new GetNamedQueryResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Returns information about a single execution of a query if you have access to the workgroup in which the query * ran. Each time a query executes, information about the query execution is saved with a unique ID. * </p> * * @param getQueryExecutionRequest * @return Result of the GetQueryExecution operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.GetQueryExecution * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution" target="_top">AWS API * Documentation</a> */ @Override public GetQueryExecutionResult getQueryExecution(GetQueryExecutionRequest request) { request = beforeClientExecution(request); return executeGetQueryExecution(request); } @SdkInternalApi final GetQueryExecutionResult executeGetQueryExecution(GetQueryExecutionRequest getQueryExecutionRequest) { ExecutionContext executionContext = createExecutionContext(getQueryExecutionRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<GetQueryExecutionRequest> request = null; Response<GetQueryExecutionResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new GetQueryExecutionRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(getQueryExecutionRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetQueryExecution"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<GetQueryExecutionResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new GetQueryExecutionResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Streams the results of a single query execution specified by <code>QueryExecutionId</code> from the Athena query * results location in Amazon S3. For more information, see <a * href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Query Results</a> in the <i>Amazon Athena User * Guide</i>. This request does not execute the query but returns results. Use <a>StartQueryExecution</a> to run a * query. * </p> * <p> * To stream query results successfully, the IAM principal with permission to call <code>GetQueryResults</code> also * must have permissions to the Amazon S3 <code>GetObject</code> action for the Athena query results location. * </p> * <important> * <p> * IAM principals with permission to the Amazon S3 <code>GetObject</code> action for the query results location are * able to retrieve query results from Amazon S3 even if permission to the <code>GetQueryResults</code> action is * denied. To restrict user or role access, ensure that Amazon S3 permissions to the Athena query location are * denied. * </p> * </important> * * @param getQueryResultsRequest * @return Result of the GetQueryResults operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.GetQueryResults * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryResults" target="_top">AWS API * Documentation</a> */ @Override public GetQueryResultsResult getQueryResults(GetQueryResultsRequest request) { request = beforeClientExecution(request); return executeGetQueryResults(request); } @SdkInternalApi final GetQueryResultsResult executeGetQueryResults(GetQueryResultsRequest getQueryResultsRequest) { ExecutionContext executionContext = createExecutionContext(getQueryResultsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<GetQueryResultsRequest> request = null; Response<GetQueryResultsResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new GetQueryResultsRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(getQueryResultsRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetQueryResults"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<GetQueryResultsResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new GetQueryResultsResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Returns information about the workgroup with the specified name. * </p> * * @param getWorkGroupRequest * @return Result of the GetWorkGroup operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.GetWorkGroup * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetWorkGroup" target="_top">AWS API * Documentation</a> */ @Override public GetWorkGroupResult getWorkGroup(GetWorkGroupRequest request) { request = beforeClientExecution(request); return executeGetWorkGroup(request); } @SdkInternalApi final GetWorkGroupResult executeGetWorkGroup(GetWorkGroupRequest getWorkGroupRequest) { ExecutionContext executionContext = createExecutionContext(getWorkGroupRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<GetWorkGroupRequest> request = null; Response<GetWorkGroupResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new GetWorkGroupRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(getWorkGroupRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetWorkGroup"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<GetWorkGroupResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new GetWorkGroupResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Provides a list of available query IDs only for queries saved in the specified workgroup. Requires that you have * access to the workgroup. * </p> * <p> * For code samples using the AWS SDK for Java, see <a * href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and Code Samples</a> in the * <i>Amazon Athena User Guide</i>. * </p> * * @param listNamedQueriesRequest * @return Result of the ListNamedQueries operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.ListNamedQueries * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListNamedQueries" target="_top">AWS API * Documentation</a> */ @Override public ListNamedQueriesResult listNamedQueries(ListNamedQueriesRequest request) { request = beforeClientExecution(request); return executeListNamedQueries(request); } @SdkInternalApi final ListNamedQueriesResult executeListNamedQueries(ListNamedQueriesRequest listNamedQueriesRequest) { ExecutionContext executionContext = createExecutionContext(listNamedQueriesRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<ListNamedQueriesRequest> request = null; Response<ListNamedQueriesResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new ListNamedQueriesRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(listNamedQueriesRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListNamedQueries"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<ListNamedQueriesResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new ListNamedQueriesResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Provides a list of available query execution IDs for the queries in the specified workgroup. Requires you to have * access to the workgroup in which the queries ran. * </p> * <p> * For code samples using the AWS SDK for Java, see <a * href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and Code Samples</a> in the * <i>Amazon Athena User Guide</i>. * </p> * * @param listQueryExecutionsRequest * @return Result of the ListQueryExecutions operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.ListQueryExecutions * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListQueryExecutions" target="_top">AWS API * Documentation</a> */ @Override public ListQueryExecutionsResult listQueryExecutions(ListQueryExecutionsRequest request) { request = beforeClientExecution(request); return executeListQueryExecutions(request); } @SdkInternalApi final ListQueryExecutionsResult executeListQueryExecutions( ListQueryExecutionsRequest listQueryExecutionsRequest) { ExecutionContext executionContext = createExecutionContext(listQueryExecutionsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<ListQueryExecutionsRequest> request = null; Response<ListQueryExecutionsResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new ListQueryExecutionsRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(listQueryExecutionsRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListQueryExecutions"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<ListQueryExecutionsResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new ListQueryExecutionsResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Lists the tags associated with this workgroup. * </p> * * @param listTagsForResourceRequest * @return Result of the ListTagsForResource operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @throws ResourceNotFoundException * A resource, such as a workgroup, was not found. * @sample AmazonAthena.ListTagsForResource * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListTagsForResource" target="_top">AWS API * Documentation</a> */ @Override public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request) { request = beforeClientExecution(request); return executeListTagsForResource(request); } @SdkInternalApi final ListTagsForResourceResult executeListTagsForResource( ListTagsForResourceRequest listTagsForResourceRequest) { ExecutionContext executionContext = createExecutionContext(listTagsForResourceRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<ListTagsForResourceRequest> request = null; Response<ListTagsForResourceResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new ListTagsForResourceRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(listTagsForResourceRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListTagsForResource"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<ListTagsForResourceResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new ListTagsForResourceResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Lists available workgroups for the account. * </p> * * @param listWorkGroupsRequest * @return Result of the ListWorkGroups operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.ListWorkGroups * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListWorkGroups" target="_top">AWS API * Documentation</a> */ @Override public ListWorkGroupsResult listWorkGroups(ListWorkGroupsRequest request) { request = beforeClientExecution(request); return executeListWorkGroups(request); } @SdkInternalApi final ListWorkGroupsResult executeListWorkGroups(ListWorkGroupsRequest listWorkGroupsRequest) { ExecutionContext executionContext = createExecutionContext(listWorkGroupsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<ListWorkGroupsRequest> request = null; Response<ListWorkGroupsResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new ListWorkGroupsRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(listWorkGroupsRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListWorkGroups"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<ListWorkGroupsResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new ListWorkGroupsResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Runs the SQL query statements contained in the <code>Query</code>. Requires you to have access to the workgroup * in which the query ran. * </p> * <p> * For code samples using the AWS SDK for Java, see <a * href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and Code Samples</a> in the * <i>Amazon Athena User Guide</i>. * </p> * * @param startQueryExecutionRequest * @return Result of the StartQueryExecution operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @throws TooManyRequestsException * Indicates that the request was throttled. * @sample AmazonAthena.StartQueryExecution * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecution" target="_top">AWS API * Documentation</a> */ @Override public StartQueryExecutionResult startQueryExecution(StartQueryExecutionRequest request) { request = beforeClientExecution(request); return executeStartQueryExecution(request); } @SdkInternalApi final StartQueryExecutionResult executeStartQueryExecution( StartQueryExecutionRequest startQueryExecutionRequest) { ExecutionContext executionContext = createExecutionContext(startQueryExecutionRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<StartQueryExecutionRequest> request = null; Response<StartQueryExecutionResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new StartQueryExecutionRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(startQueryExecutionRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "StartQueryExecution"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<StartQueryExecutionResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new StartQueryExecutionResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Stops a query execution. Requires you to have access to the workgroup in which the query ran. * </p> * <p> * For code samples using the AWS SDK for Java, see <a * href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and Code Samples</a> in the * <i>Amazon Athena User Guide</i>. * </p> * * @param stopQueryExecutionRequest * @return Result of the StopQueryExecution operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.StopQueryExecution * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StopQueryExecution" target="_top">AWS API * Documentation</a> */ @Override public StopQueryExecutionResult stopQueryExecution(StopQueryExecutionRequest request) { request = beforeClientExecution(request); return executeStopQueryExecution(request); } @SdkInternalApi final StopQueryExecutionResult executeStopQueryExecution(StopQueryExecutionRequest stopQueryExecutionRequest) { ExecutionContext executionContext = createExecutionContext(stopQueryExecutionRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<StopQueryExecutionRequest> request = null; Response<StopQueryExecutionResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new StopQueryExecutionRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(stopQueryExecutionRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "StopQueryExecution"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<StopQueryExecutionResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new StopQueryExecutionResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Adds one or more tags to the resource, such as a workgroup. A tag is a label that you assign to an AWS Athena * resource (a workgroup). Each tag consists of a key and an optional value, both of which you define. Tags enable * you to categorize resources (workgroups) in Athena, for example, by purpose, owner, or environment. Use a * consistent set of tag keys to make it easier to search and filter workgroups in your account. For best practices, * see <a href="https://aws.amazon.com/answers/account-management/aws-tagging-strategies/">AWS Tagging * Strategies</a>. The key length is from 1 (minimum) to 128 (maximum) Unicode characters in UTF-8. The tag value * length is from 0 (minimum) to 256 (maximum) Unicode characters in UTF-8. You can use letters and numbers * representable in UTF-8, and the following characters: + - = . _ : / @. Tag keys and values are case-sensitive. * Tag keys must be unique per resource. If you specify more than one, separate them by commas. * </p> * * @param tagResourceRequest * @return Result of the TagResource operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @throws ResourceNotFoundException * A resource, such as a workgroup, was not found. * @sample AmazonAthena.TagResource * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/TagResource" target="_top">AWS API * Documentation</a> */ @Override public TagResourceResult tagResource(TagResourceRequest request) { request = beforeClientExecution(request); return executeTagResource(request); } @SdkInternalApi final TagResourceResult executeTagResource(TagResourceRequest tagResourceRequest) { ExecutionContext executionContext = createExecutionContext(tagResourceRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<TagResourceRequest> request = null; Response<TagResourceResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new TagResourceRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(tagResourceRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "TagResource"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<TagResourceResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new TagResourceResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Removes one or more tags from the workgroup resource. Takes as an input a list of TagKey Strings separated by * commas, and removes their tags at the same time. * </p> * * @param untagResourceRequest * @return Result of the UntagResource operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @throws ResourceNotFoundException * A resource, such as a workgroup, was not found. * @sample AmazonAthena.UntagResource * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UntagResource" target="_top">AWS API * Documentation</a> */ @Override public UntagResourceResult untagResource(UntagResourceRequest request) { request = beforeClientExecution(request); return executeUntagResource(request); } @SdkInternalApi final UntagResourceResult executeUntagResource(UntagResourceRequest untagResourceRequest) { ExecutionContext executionContext = createExecutionContext(untagResourceRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<UntagResourceRequest> request = null; Response<UntagResourceResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new UntagResourceRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(untagResourceRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "UntagResource"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<UntagResourceResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new UntagResourceResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * <p> * Updates the workgroup with the specified name. The workgroup's name cannot be changed. * </p> * * @param updateWorkGroupRequest * @return Result of the UpdateWorkGroup operation returned by the service. * @throws InternalServerException * Indicates a platform issue, which may be due to a transient condition or outage. * @throws InvalidRequestException * Indicates that something is wrong with the input to the request. For example, a required parameter may be * missing or out of range. * @sample AmazonAthena.UpdateWorkGroup * @see <a href="http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateWorkGroup" target="_top">AWS API * Documentation</a> */ @Override public UpdateWorkGroupResult updateWorkGroup(UpdateWorkGroupRequest request) { request = beforeClientExecution(request); return executeUpdateWorkGroup(request); } @SdkInternalApi final UpdateWorkGroupResult executeUpdateWorkGroup(UpdateWorkGroupRequest updateWorkGroupRequest) { ExecutionContext executionContext = createExecutionContext(updateWorkGroupRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request<UpdateWorkGroupRequest> request = null; Response<UpdateWorkGroupResult> response = null; try { awsRequestMetrics.startEvent(Field.RequestMarshallTime); try { request = new UpdateWorkGroupRequestProtocolMarshaller(protocolFactory) .marshall(super.beforeMarshalling(updateWorkGroupRequest)); // Binds the request metrics to the current request. request.setAWSRequestMetrics(awsRequestMetrics); request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion()); request.addHandlerContext(HandlerContextKey.SERVICE_ID, "Athena"); request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "UpdateWorkGroup"); request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig); } finally { awsRequestMetrics.endEvent(Field.RequestMarshallTime); } HttpResponseHandler<AmazonWebServiceResponse<UpdateWorkGroupResult>> responseHandler = protocolFactory .createResponseHandler(new JsonOperationMetadata().withPayloadJson(true) .withHasStreamingSuccessResponse(false), new UpdateWorkGroupResultJsonUnmarshaller()); response = invoke(request, responseHandler, executionContext); return response.getAwsResponse(); } finally { endClientExecution(awsRequestMetrics, request, response); } } /** * Returns additional metadata for a previously executed successful, request, typically used for debugging issues * where a service isn't acting as expected. This data isn't considered part of the result data returned by an * operation, so it's available through this separate, diagnostic interface. * <p> * Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic * information for an executed request, you should use this method to retrieve it as soon as possible after * executing the request. * * @param request * The originally executed request * * @return The response metadata for the specified request, or null if none is available. */ public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request) { return client.getResponseMetadataForRequest(request); } /** * Normal invoke with authentication. Credentials are required and may be overriden at the request level. **/ private <X, Y extends AmazonWebServiceRequest> Response<X> invoke(Request<Y> request, HttpResponseHandler<AmazonWebServiceResponse<X>> responseHandler, ExecutionContext executionContext) { return invoke(request, responseHandler, executionContext, null, null); } /** * Normal invoke with authentication. Credentials are required and may be overriden at the request level. **/ private <X, Y extends AmazonWebServiceRequest> Response<X> invoke(Request<Y> request, HttpResponseHandler<AmazonWebServiceResponse<X>> responseHandler, ExecutionContext executionContext, URI cachedEndpoint, URI uriFromEndpointTrait) { executionContext.setCredentialsProvider( CredentialUtils.getCredentialsProvider(request.getOriginalRequest(), awsCredentialsProvider)); return doInvoke(request, responseHandler, executionContext, cachedEndpoint, uriFromEndpointTrait); } /** * Invoke with no authentication. Credentials are not required and any credentials set on the client or request will * be ignored for this operation. **/ private <X, Y extends AmazonWebServiceRequest> Response<X> anonymousInvoke(Request<Y> request, HttpResponseHandler<AmazonWebServiceResponse<X>> responseHandler, ExecutionContext executionContext) { return doInvoke(request, responseHandler, executionContext, null, null); } /** * Invoke the request using the http client. Assumes credentials (or lack thereof) have been configured in the * ExecutionContext beforehand. **/ private <X, Y extends AmazonWebServiceRequest> Response<X> doInvoke(Request<Y> request, HttpResponseHandler<AmazonWebServiceResponse<X>> responseHandler, ExecutionContext executionContext, URI discoveredEndpoint, URI uriFromEndpointTrait) { if (discoveredEndpoint != null) { request.setEndpoint(discoveredEndpoint); request.getOriginalRequest().getRequestClientOptions().appendUserAgent("endpoint-discovery"); } else if (uriFromEndpointTrait != null) { request.setEndpoint(uriFromEndpointTrait); } else { request.setEndpoint(endpoint); } request.setTimeOffset(timeOffset); HttpResponseHandler<AmazonServiceException> errorResponseHandler = protocolFactory .createErrorResponseHandler(new JsonErrorResponseMetadata()); return client.execute(request, responseHandler, errorResponseHandler, executionContext); } @com.amazonaws.annotation.SdkInternalApi static com.amazonaws.protocol.json.SdkJsonProtocolFactory getProtocolFactory() { return protocolFactory; } }