All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.athena.AmazonAthenaAsync Maven / Gradle / Ivy

Go to download

The AWS Java SDK for Amazon Athena module holds the client classes that are used for communicating with Amazon Athena Service

There is a newer version: 1.12.780
Show newest version
/*
 * Copyright 2017-2022 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 javax.annotation.Generated;

import com.amazonaws.services.athena.model.*;

/**
 * Interface for accessing Amazon Athena asynchronously. Each asynchronous method will return a Java Future object
 * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive
 * notification when an asynchronous operation completes.
 * 

* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.athena.AbstractAmazonAthenaAsync} instead. *

*

*

* 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 * automatically—executing queries in parallel—so results are fast, even with large datasets and complex queries. For * more information, see What is Amazon Athena in * the Amazon Athena User Guide. *

*

* 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 Accessing Amazon Athena with JDBC. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the Amazon * Athena User Guide. *

*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AmazonAthenaAsync extends AmazonAthena { /** *

* 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 * ListNamedQueriesInput 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 * UnprocessedNamedQueryId. Named queries differ from executed queries. Use * BatchGetQueryExecutionInput to get details about each unique query execution, and * ListQueryExecutionsInput to get a list of query execution IDs. *

* * @param batchGetNamedQueryRequest * Contains an array of named query IDs. * @return A Java Future containing the result of the BatchGetNamedQuery operation returned by the service. * @sample AmazonAthenaAsync.BatchGetNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future batchGetNamedQueryAsync(BatchGetNamedQueryRequest batchGetNamedQueryRequest); /** *

* 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 * ListNamedQueriesInput 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 * UnprocessedNamedQueryId. Named queries differ from executed queries. Use * BatchGetQueryExecutionInput to get details about each unique query execution, and * ListQueryExecutionsInput to get a list of query execution IDs. *

* * @param batchGetNamedQueryRequest * Contains an array of named query IDs. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the BatchGetNamedQuery operation returned by the service. * @sample AmazonAthenaAsyncHandler.BatchGetNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future batchGetNamedQueryAsync(BatchGetNamedQueryRequest batchGetNamedQueryRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns the details of a single prepared statement or a list of up to 256 prepared statements for the array of * prepared statement names that you provide. Requires you to have access to the workgroup to which the prepared * statements belong. If a prepared statement cannot be retrieved for the name specified, the statement is listed in * UnprocessedPreparedStatementNames. *

* * @param batchGetPreparedStatementRequest * @return A Java Future containing the result of the BatchGetPreparedStatement operation returned by the service. * @sample AmazonAthenaAsync.BatchGetPreparedStatement * @see AWS API Documentation */ java.util.concurrent.Future batchGetPreparedStatementAsync( BatchGetPreparedStatementRequest batchGetPreparedStatementRequest); /** *

* Returns the details of a single prepared statement or a list of up to 256 prepared statements for the array of * prepared statement names that you provide. Requires you to have access to the workgroup to which the prepared * statements belong. If a prepared statement cannot be retrieved for the name specified, the statement is listed in * UnprocessedPreparedStatementNames. *

* * @param batchGetPreparedStatementRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the BatchGetPreparedStatement operation returned by the service. * @sample AmazonAthenaAsyncHandler.BatchGetPreparedStatement * @see AWS API Documentation */ java.util.concurrent.Future batchGetPreparedStatementAsync( BatchGetPreparedStatementRequest batchGetPreparedStatementRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* 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 ListQueryExecutionsInput$WorkGroup. Query executions differ from * named (saved) queries. Use BatchGetNamedQueryInput to get details about named queries. *

* * @param batchGetQueryExecutionRequest * Contains an array of query execution IDs. * @return A Java Future containing the result of the BatchGetQueryExecution operation returned by the service. * @sample AmazonAthenaAsync.BatchGetQueryExecution * @see AWS * API Documentation */ java.util.concurrent.Future batchGetQueryExecutionAsync(BatchGetQueryExecutionRequest batchGetQueryExecutionRequest); /** *

* 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 ListQueryExecutionsInput$WorkGroup. Query executions differ from * named (saved) queries. Use BatchGetNamedQueryInput to get details about named queries. *

* * @param batchGetQueryExecutionRequest * Contains an array of query execution IDs. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the BatchGetQueryExecution operation returned by the service. * @sample AmazonAthenaAsyncHandler.BatchGetQueryExecution * @see AWS * API Documentation */ java.util.concurrent.Future batchGetQueryExecutionAsync(BatchGetQueryExecutionRequest batchGetQueryExecutionRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates (registers) a data catalog with the specified name and properties. Catalogs created are visible to all * users of the same Amazon Web Services account. *

* * @param createDataCatalogRequest * @return A Java Future containing the result of the CreateDataCatalog operation returned by the service. * @sample AmazonAthenaAsync.CreateDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future createDataCatalogAsync(CreateDataCatalogRequest createDataCatalogRequest); /** *

* Creates (registers) a data catalog with the specified name and properties. Catalogs created are visible to all * users of the same Amazon Web Services account. *

* * @param createDataCatalogRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateDataCatalog operation returned by the service. * @sample AmazonAthenaAsyncHandler.CreateDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future createDataCatalogAsync(CreateDataCatalogRequest createDataCatalogRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates a named query in the specified workgroup. Requires that you have access to the workgroup. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param createNamedQueryRequest * @return A Java Future containing the result of the CreateNamedQuery operation returned by the service. * @sample AmazonAthenaAsync.CreateNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future createNamedQueryAsync(CreateNamedQueryRequest createNamedQueryRequest); /** *

* Creates a named query in the specified workgroup. Requires that you have access to the workgroup. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param createNamedQueryRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateNamedQuery operation returned by the service. * @sample AmazonAthenaAsyncHandler.CreateNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future createNamedQueryAsync(CreateNamedQueryRequest createNamedQueryRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates a prepared statement for use with SQL queries in Athena. *

* * @param createPreparedStatementRequest * @return A Java Future containing the result of the CreatePreparedStatement operation returned by the service. * @sample AmazonAthenaAsync.CreatePreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future createPreparedStatementAsync(CreatePreparedStatementRequest createPreparedStatementRequest); /** *

* Creates a prepared statement for use with SQL queries in Athena. *

* * @param createPreparedStatementRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreatePreparedStatement operation returned by the service. * @sample AmazonAthenaAsyncHandler.CreatePreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future createPreparedStatementAsync(CreatePreparedStatementRequest createPreparedStatementRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates a workgroup with the specified name. *

* * @param createWorkGroupRequest * @return A Java Future containing the result of the CreateWorkGroup operation returned by the service. * @sample AmazonAthenaAsync.CreateWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future createWorkGroupAsync(CreateWorkGroupRequest createWorkGroupRequest); /** *

* Creates a workgroup with the specified name. *

* * @param createWorkGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateWorkGroup operation returned by the service. * @sample AmazonAthenaAsyncHandler.CreateWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future createWorkGroupAsync(CreateWorkGroupRequest createWorkGroupRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes a data catalog. *

* * @param deleteDataCatalogRequest * @return A Java Future containing the result of the DeleteDataCatalog operation returned by the service. * @sample AmazonAthenaAsync.DeleteDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future deleteDataCatalogAsync(DeleteDataCatalogRequest deleteDataCatalogRequest); /** *

* Deletes a data catalog. *

* * @param deleteDataCatalogRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteDataCatalog operation returned by the service. * @sample AmazonAthenaAsyncHandler.DeleteDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future deleteDataCatalogAsync(DeleteDataCatalogRequest deleteDataCatalogRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes the named query if you have access to the workgroup in which the query was saved. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param deleteNamedQueryRequest * @return A Java Future containing the result of the DeleteNamedQuery operation returned by the service. * @sample AmazonAthenaAsync.DeleteNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future deleteNamedQueryAsync(DeleteNamedQueryRequest deleteNamedQueryRequest); /** *

* Deletes the named query if you have access to the workgroup in which the query was saved. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param deleteNamedQueryRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteNamedQuery operation returned by the service. * @sample AmazonAthenaAsyncHandler.DeleteNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future deleteNamedQueryAsync(DeleteNamedQueryRequest deleteNamedQueryRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes the prepared statement with the specified name from the specified workgroup. *

* * @param deletePreparedStatementRequest * @return A Java Future containing the result of the DeletePreparedStatement operation returned by the service. * @sample AmazonAthenaAsync.DeletePreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future deletePreparedStatementAsync(DeletePreparedStatementRequest deletePreparedStatementRequest); /** *

* Deletes the prepared statement with the specified name from the specified workgroup. *

* * @param deletePreparedStatementRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeletePreparedStatement operation returned by the service. * @sample AmazonAthenaAsyncHandler.DeletePreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future deletePreparedStatementAsync(DeletePreparedStatementRequest deletePreparedStatementRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes the workgroup with the specified name. The primary workgroup cannot be deleted. *

* * @param deleteWorkGroupRequest * @return A Java Future containing the result of the DeleteWorkGroup operation returned by the service. * @sample AmazonAthenaAsync.DeleteWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future deleteWorkGroupAsync(DeleteWorkGroupRequest deleteWorkGroupRequest); /** *

* Deletes the workgroup with the specified name. The primary workgroup cannot be deleted. *

* * @param deleteWorkGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteWorkGroup operation returned by the service. * @sample AmazonAthenaAsyncHandler.DeleteWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future deleteWorkGroupAsync(DeleteWorkGroupRequest deleteWorkGroupRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns the specified data catalog. *

* * @param getDataCatalogRequest * @return A Java Future containing the result of the GetDataCatalog operation returned by the service. * @sample AmazonAthenaAsync.GetDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future getDataCatalogAsync(GetDataCatalogRequest getDataCatalogRequest); /** *

* Returns the specified data catalog. *

* * @param getDataCatalogRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetDataCatalog operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future getDataCatalogAsync(GetDataCatalogRequest getDataCatalogRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns a database object for the specified database and data catalog. *

* * @param getDatabaseRequest * @return A Java Future containing the result of the GetDatabase operation returned by the service. * @sample AmazonAthenaAsync.GetDatabase * @see AWS API * Documentation */ java.util.concurrent.Future getDatabaseAsync(GetDatabaseRequest getDatabaseRequest); /** *

* Returns a database object for the specified database and data catalog. *

* * @param getDatabaseRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetDatabase operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetDatabase * @see AWS API * Documentation */ java.util.concurrent.Future getDatabaseAsync(GetDatabaseRequest getDatabaseRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns information about a single query. Requires that you have access to the workgroup in which the query was * saved. *

* * @param getNamedQueryRequest * @return A Java Future containing the result of the GetNamedQuery operation returned by the service. * @sample AmazonAthenaAsync.GetNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future getNamedQueryAsync(GetNamedQueryRequest getNamedQueryRequest); /** *

* Returns information about a single query. Requires that you have access to the workgroup in which the query was * saved. *

* * @param getNamedQueryRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetNamedQuery operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future getNamedQueryAsync(GetNamedQueryRequest getNamedQueryRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves the prepared statement with the specified name from the specified workgroup. *

* * @param getPreparedStatementRequest * @return A Java Future containing the result of the GetPreparedStatement operation returned by the service. * @sample AmazonAthenaAsync.GetPreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future getPreparedStatementAsync(GetPreparedStatementRequest getPreparedStatementRequest); /** *

* Retrieves the prepared statement with the specified name from the specified workgroup. *

* * @param getPreparedStatementRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetPreparedStatement operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetPreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future getPreparedStatementAsync(GetPreparedStatementRequest getPreparedStatementRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* 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. *

* * @param getQueryExecutionRequest * @return A Java Future containing the result of the GetQueryExecution operation returned by the service. * @sample AmazonAthenaAsync.GetQueryExecution * @see AWS API * Documentation */ java.util.concurrent.Future getQueryExecutionAsync(GetQueryExecutionRequest getQueryExecutionRequest); /** *

* 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. *

* * @param getQueryExecutionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetQueryExecution operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetQueryExecution * @see AWS API * Documentation */ java.util.concurrent.Future getQueryExecutionAsync(GetQueryExecutionRequest getQueryExecutionRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Streams the results of a single query execution specified by QueryExecutionId from the Athena query * results location in Amazon S3. For more information, see Query Results 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. *

*
* * @param getQueryResultsRequest * @return A Java Future containing the result of the GetQueryResults operation returned by the service. * @sample AmazonAthenaAsync.GetQueryResults * @see AWS API * Documentation */ java.util.concurrent.Future getQueryResultsAsync(GetQueryResultsRequest getQueryResultsRequest); /** *

* Streams the results of a single query execution specified by QueryExecutionId from the Athena query * results location in Amazon S3. For more information, see Query Results 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. *

*
* * @param getQueryResultsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetQueryResults operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetQueryResults * @see AWS API * Documentation */ java.util.concurrent.Future getQueryResultsAsync(GetQueryResultsRequest getQueryResultsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns query execution runtime statistics related to a single execution of a query if you have access to the * workgroup in which the query ran. The query execution runtime statistics is returned only when * QueryExecutionStatus$State is in a SUCCEEDED or FAILED state. *

* * @param getQueryRuntimeStatisticsRequest * @return A Java Future containing the result of the GetQueryRuntimeStatistics operation returned by the service. * @sample AmazonAthenaAsync.GetQueryRuntimeStatistics * @see AWS API Documentation */ java.util.concurrent.Future getQueryRuntimeStatisticsAsync( GetQueryRuntimeStatisticsRequest getQueryRuntimeStatisticsRequest); /** *

* Returns query execution runtime statistics related to a single execution of a query if you have access to the * workgroup in which the query ran. The query execution runtime statistics is returned only when * QueryExecutionStatus$State is in a SUCCEEDED or FAILED state. *

* * @param getQueryRuntimeStatisticsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetQueryRuntimeStatistics operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetQueryRuntimeStatistics * @see AWS API Documentation */ java.util.concurrent.Future getQueryRuntimeStatisticsAsync( GetQueryRuntimeStatisticsRequest getQueryRuntimeStatisticsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns table metadata for the specified catalog, database, and table. *

* * @param getTableMetadataRequest * @return A Java Future containing the result of the GetTableMetadata operation returned by the service. * @sample AmazonAthenaAsync.GetTableMetadata * @see AWS API * Documentation */ java.util.concurrent.Future getTableMetadataAsync(GetTableMetadataRequest getTableMetadataRequest); /** *

* Returns table metadata for the specified catalog, database, and table. *

* * @param getTableMetadataRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetTableMetadata operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetTableMetadata * @see AWS API * Documentation */ java.util.concurrent.Future getTableMetadataAsync(GetTableMetadataRequest getTableMetadataRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns information about the workgroup with the specified name. *

* * @param getWorkGroupRequest * @return A Java Future containing the result of the GetWorkGroup operation returned by the service. * @sample AmazonAthenaAsync.GetWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future getWorkGroupAsync(GetWorkGroupRequest getWorkGroupRequest); /** *

* Returns information about the workgroup with the specified name. *

* * @param getWorkGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetWorkGroup operation returned by the service. * @sample AmazonAthenaAsyncHandler.GetWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future getWorkGroupAsync(GetWorkGroupRequest getWorkGroupRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists the data catalogs in the current Amazon Web Services account. *

* * @param listDataCatalogsRequest * @return A Java Future containing the result of the ListDataCatalogs operation returned by the service. * @sample AmazonAthenaAsync.ListDataCatalogs * @see AWS API * Documentation */ java.util.concurrent.Future listDataCatalogsAsync(ListDataCatalogsRequest listDataCatalogsRequest); /** *

* Lists the data catalogs in the current Amazon Web Services account. *

* * @param listDataCatalogsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListDataCatalogs operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListDataCatalogs * @see AWS API * Documentation */ java.util.concurrent.Future listDataCatalogsAsync(ListDataCatalogsRequest listDataCatalogsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists the databases in the specified data catalog. *

* * @param listDatabasesRequest * @return A Java Future containing the result of the ListDatabases operation returned by the service. * @sample AmazonAthenaAsync.ListDatabases * @see AWS API * Documentation */ java.util.concurrent.Future listDatabasesAsync(ListDatabasesRequest listDatabasesRequest); /** *

* Lists the databases in the specified data catalog. *

* * @param listDatabasesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListDatabases operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListDatabases * @see AWS API * Documentation */ java.util.concurrent.Future listDatabasesAsync(ListDatabasesRequest listDatabasesRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns a list of engine versions that are available to choose from, including the Auto option. *

* * @param listEngineVersionsRequest * @return A Java Future containing the result of the ListEngineVersions operation returned by the service. * @sample AmazonAthenaAsync.ListEngineVersions * @see AWS API * Documentation */ java.util.concurrent.Future listEngineVersionsAsync(ListEngineVersionsRequest listEngineVersionsRequest); /** *

* Returns a list of engine versions that are available to choose from, including the Auto option. *

* * @param listEngineVersionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListEngineVersions operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListEngineVersions * @see AWS API * Documentation */ java.util.concurrent.Future listEngineVersionsAsync(ListEngineVersionsRequest listEngineVersionsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Provides a list of available query IDs only for queries saved in the specified workgroup. Requires that you have * access to the specified workgroup. If a workgroup is not specified, lists the saved queries for the primary * workgroup. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param listNamedQueriesRequest * @return A Java Future containing the result of the ListNamedQueries operation returned by the service. * @sample AmazonAthenaAsync.ListNamedQueries * @see AWS API * Documentation */ java.util.concurrent.Future listNamedQueriesAsync(ListNamedQueriesRequest listNamedQueriesRequest); /** *

* Provides a list of available query IDs only for queries saved in the specified workgroup. Requires that you have * access to the specified workgroup. If a workgroup is not specified, lists the saved queries for the primary * workgroup. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param listNamedQueriesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListNamedQueries operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListNamedQueries * @see AWS API * Documentation */ java.util.concurrent.Future listNamedQueriesAsync(ListNamedQueriesRequest listNamedQueriesRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists the prepared statements in the specified workgroup. *

* * @param listPreparedStatementsRequest * @return A Java Future containing the result of the ListPreparedStatements operation returned by the service. * @sample AmazonAthenaAsync.ListPreparedStatements * @see AWS * API Documentation */ java.util.concurrent.Future listPreparedStatementsAsync(ListPreparedStatementsRequest listPreparedStatementsRequest); /** *

* Lists the prepared statements in the specified workgroup. *

* * @param listPreparedStatementsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListPreparedStatements operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListPreparedStatements * @see AWS * API Documentation */ java.util.concurrent.Future listPreparedStatementsAsync(ListPreparedStatementsRequest listPreparedStatementsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Provides a list of available query execution IDs for the queries in the specified workgroup. If a workgroup is * not specified, returns a list of query execution IDs for the primary workgroup. Requires you to have access to * the workgroup in which the queries ran. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param listQueryExecutionsRequest * @return A Java Future containing the result of the ListQueryExecutions operation returned by the service. * @sample AmazonAthenaAsync.ListQueryExecutions * @see AWS API * Documentation */ java.util.concurrent.Future listQueryExecutionsAsync(ListQueryExecutionsRequest listQueryExecutionsRequest); /** *

* Provides a list of available query execution IDs for the queries in the specified workgroup. If a workgroup is * not specified, returns a list of query execution IDs for the primary workgroup. Requires you to have access to * the workgroup in which the queries ran. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param listQueryExecutionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListQueryExecutions operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListQueryExecutions * @see AWS API * Documentation */ java.util.concurrent.Future listQueryExecutionsAsync(ListQueryExecutionsRequest listQueryExecutionsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists the metadata for the tables in the specified data catalog database. *

* * @param listTableMetadataRequest * @return A Java Future containing the result of the ListTableMetadata operation returned by the service. * @sample AmazonAthenaAsync.ListTableMetadata * @see AWS API * Documentation */ java.util.concurrent.Future listTableMetadataAsync(ListTableMetadataRequest listTableMetadataRequest); /** *

* Lists the metadata for the tables in the specified data catalog database. *

* * @param listTableMetadataRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTableMetadata operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListTableMetadata * @see AWS API * Documentation */ java.util.concurrent.Future listTableMetadataAsync(ListTableMetadataRequest listTableMetadataRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists the tags associated with an Athena workgroup or data catalog resource. *

* * @param listTagsForResourceRequest * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonAthenaAsync.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest); /** *

* Lists the tags associated with an Athena workgroup or data catalog resource. *

* * @param listTagsForResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists available workgroups for the account. *

* * @param listWorkGroupsRequest * @return A Java Future containing the result of the ListWorkGroups operation returned by the service. * @sample AmazonAthenaAsync.ListWorkGroups * @see AWS API * Documentation */ java.util.concurrent.Future listWorkGroupsAsync(ListWorkGroupsRequest listWorkGroupsRequest); /** *

* Lists available workgroups for the account. *

* * @param listWorkGroupsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListWorkGroups operation returned by the service. * @sample AmazonAthenaAsyncHandler.ListWorkGroups * @see AWS API * Documentation */ java.util.concurrent.Future listWorkGroupsAsync(ListWorkGroupsRequest listWorkGroupsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Runs the SQL query statements contained in the Query. Requires you to have access to the workgroup * in which the query ran. Running queries against an external catalog requires GetDataCatalog permission to * the catalog. For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param startQueryExecutionRequest * @return A Java Future containing the result of the StartQueryExecution operation returned by the service. * @sample AmazonAthenaAsync.StartQueryExecution * @see AWS API * Documentation */ java.util.concurrent.Future startQueryExecutionAsync(StartQueryExecutionRequest startQueryExecutionRequest); /** *

* Runs the SQL query statements contained in the Query. Requires you to have access to the workgroup * in which the query ran. Running queries against an external catalog requires GetDataCatalog permission to * the catalog. For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param startQueryExecutionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the StartQueryExecution operation returned by the service. * @sample AmazonAthenaAsyncHandler.StartQueryExecution * @see AWS API * Documentation */ java.util.concurrent.Future startQueryExecutionAsync(StartQueryExecutionRequest startQueryExecutionRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Stops a query execution. Requires you to have access to the workgroup in which the query ran. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param stopQueryExecutionRequest * @return A Java Future containing the result of the StopQueryExecution operation returned by the service. * @sample AmazonAthenaAsync.StopQueryExecution * @see AWS API * Documentation */ java.util.concurrent.Future stopQueryExecutionAsync(StopQueryExecutionRequest stopQueryExecutionRequest); /** *

* Stops a query execution. Requires you to have access to the workgroup in which the query ran. *

*

* For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples in the * Amazon Athena User Guide. *

* * @param stopQueryExecutionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the StopQueryExecution operation returned by the service. * @sample AmazonAthenaAsyncHandler.StopQueryExecution * @see AWS API * Documentation */ java.util.concurrent.Future stopQueryExecutionAsync(StopQueryExecutionRequest stopQueryExecutionRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Adds one or more tags to an Athena resource. A tag is a label that you assign to a resource. In Athena, a * resource can be a workgroup or data catalog. Each tag consists of a key and an optional value, both of which you * define. For example, you can use tags to categorize Athena workgroups or data catalogs by purpose, owner, or * environment. Use a consistent set of tag keys to make it easier to search and filter workgroups or data catalogs * in your account. For best practices, see Tagging Best Practices. Tag * keys can be from 1 to 128 UTF-8 Unicode characters, and tag values can be from 0 to 256 UTF-8 Unicode characters. * Tags 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 tag, separate * them by commas. *

* * @param tagResourceRequest * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonAthenaAsync.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest); /** *

* Adds one or more tags to an Athena resource. A tag is a label that you assign to a resource. In Athena, a * resource can be a workgroup or data catalog. Each tag consists of a key and an optional value, both of which you * define. For example, you can use tags to categorize Athena workgroups or data catalogs by purpose, owner, or * environment. Use a consistent set of tag keys to make it easier to search and filter workgroups or data catalogs * in your account. For best practices, see Tagging Best Practices. Tag * keys can be from 1 to 128 UTF-8 Unicode characters, and tag values can be from 0 to 256 UTF-8 Unicode characters. * Tags 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 tag, separate * them by commas. *

* * @param tagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonAthenaAsyncHandler.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Removes one or more tags from a data catalog or workgroup resource. *

* * @param untagResourceRequest * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonAthenaAsync.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest); /** *

* Removes one or more tags from a data catalog or workgroup resource. *

* * @param untagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonAthenaAsyncHandler.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates the data catalog that has the specified name. *

* * @param updateDataCatalogRequest * @return A Java Future containing the result of the UpdateDataCatalog operation returned by the service. * @sample AmazonAthenaAsync.UpdateDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future updateDataCatalogAsync(UpdateDataCatalogRequest updateDataCatalogRequest); /** *

* Updates the data catalog that has the specified name. *

* * @param updateDataCatalogRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateDataCatalog operation returned by the service. * @sample AmazonAthenaAsyncHandler.UpdateDataCatalog * @see AWS API * Documentation */ java.util.concurrent.Future updateDataCatalogAsync(UpdateDataCatalogRequest updateDataCatalogRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates a NamedQuery object. The database or workgroup cannot be updated. *

* * @param updateNamedQueryRequest * @return A Java Future containing the result of the UpdateNamedQuery operation returned by the service. * @sample AmazonAthenaAsync.UpdateNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future updateNamedQueryAsync(UpdateNamedQueryRequest updateNamedQueryRequest); /** *

* Updates a NamedQuery object. The database or workgroup cannot be updated. *

* * @param updateNamedQueryRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateNamedQuery operation returned by the service. * @sample AmazonAthenaAsyncHandler.UpdateNamedQuery * @see AWS API * Documentation */ java.util.concurrent.Future updateNamedQueryAsync(UpdateNamedQueryRequest updateNamedQueryRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates a prepared statement. *

* * @param updatePreparedStatementRequest * @return A Java Future containing the result of the UpdatePreparedStatement operation returned by the service. * @sample AmazonAthenaAsync.UpdatePreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future updatePreparedStatementAsync(UpdatePreparedStatementRequest updatePreparedStatementRequest); /** *

* Updates a prepared statement. *

* * @param updatePreparedStatementRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdatePreparedStatement operation returned by the service. * @sample AmazonAthenaAsyncHandler.UpdatePreparedStatement * @see AWS * API Documentation */ java.util.concurrent.Future updatePreparedStatementAsync(UpdatePreparedStatementRequest updatePreparedStatementRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates the workgroup with the specified name. The workgroup's name cannot be changed. *

* * @param updateWorkGroupRequest * @return A Java Future containing the result of the UpdateWorkGroup operation returned by the service. * @sample AmazonAthenaAsync.UpdateWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future updateWorkGroupAsync(UpdateWorkGroupRequest updateWorkGroupRequest); /** *

* Updates the workgroup with the specified name. The workgroup's name cannot be changed. *

* * @param updateWorkGroupRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateWorkGroup operation returned by the service. * @sample AmazonAthenaAsyncHandler.UpdateWorkGroup * @see AWS API * Documentation */ java.util.concurrent.Future updateWorkGroupAsync(UpdateWorkGroupRequest updateWorkGroupRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy