com.amazonaws.services.athena.model.ResultConfiguration Maven / Gradle / Ivy
Show all versions of aws-java-sdk-athena Show documentation
/*
* Copyright 2015-2020 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.model;
import java.io.Serializable;
import javax.annotation.Generated;
import com.amazonaws.protocol.StructuredPojo;
import com.amazonaws.protocol.ProtocolMarshaller;
/**
*
* The location in Amazon S3 where query results are stored and the encryption option, if any, used for query results.
* These are known as "client-side settings". If workgroup settings override client-side settings, then the query uses
* the workgroup settings.
*
*
* @see AWS API
* Documentation
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class ResultConfiguration implements Serializable, Cloneable, StructuredPojo {
/**
*
* The location in Amazon S3 where your query results are stored, such as s3://path/to/query/bucket/.
* To run the query, you must specify the query results location using one of the ways: either for individual
* queries using either this setting (client-side), or in the workgroup, using WorkGroupConfiguration. If
* none of them is set, Athena issues an error that no output location is provided. For more information, see Query Results. If workgroup settings
* override client-side settings, then the query uses the settings specified for the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration.
*
*/
private String outputLocation;
/**
*
* If query results are encrypted in Amazon S3, indicates the encryption option used (for example,
* SSE-KMS or CSE-KMS) and key information. This is a client-side setting. If workgroup
* settings override client-side settings, then the query uses the encryption configuration that is specified for
* the workgroup, and also uses the location for storing query results specified in the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings Override
* Client-Side Settings.
*
*/
private EncryptionConfiguration encryptionConfiguration;
/**
*
* The location in Amazon S3 where your query results are stored, such as s3://path/to/query/bucket/.
* To run the query, you must specify the query results location using one of the ways: either for individual
* queries using either this setting (client-side), or in the workgroup, using WorkGroupConfiguration. If
* none of them is set, Athena issues an error that no output location is provided. For more information, see Query Results. If workgroup settings
* override client-side settings, then the query uses the settings specified for the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration.
*
*
* @param outputLocation
* The location in Amazon S3 where your query results are stored, such as
* s3://path/to/query/bucket/. To run the query, you must specify the query results location
* using one of the ways: either for individual queries using either this setting (client-side), or in the
* workgroup, using WorkGroupConfiguration. If none of them is set, Athena issues an error that no
* output location is provided. For more information, see Query Results. If workgroup settings
* override client-side settings, then the query uses the settings specified for the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration.
*/
public void setOutputLocation(String outputLocation) {
this.outputLocation = outputLocation;
}
/**
*
* The location in Amazon S3 where your query results are stored, such as s3://path/to/query/bucket/.
* To run the query, you must specify the query results location using one of the ways: either for individual
* queries using either this setting (client-side), or in the workgroup, using WorkGroupConfiguration. If
* none of them is set, Athena issues an error that no output location is provided. For more information, see Query Results. If workgroup settings
* override client-side settings, then the query uses the settings specified for the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration.
*
*
* @return The location in Amazon S3 where your query results are stored, such as
* s3://path/to/query/bucket/. To run the query, you must specify the query results location
* using one of the ways: either for individual queries using either this setting (client-side), or in the
* workgroup, using WorkGroupConfiguration. If none of them is set, Athena issues an error that no
* output location is provided. For more information, see Query Results. If workgroup
* settings override client-side settings, then the query uses the settings specified for the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration.
*/
public String getOutputLocation() {
return this.outputLocation;
}
/**
*
* The location in Amazon S3 where your query results are stored, such as s3://path/to/query/bucket/.
* To run the query, you must specify the query results location using one of the ways: either for individual
* queries using either this setting (client-side), or in the workgroup, using WorkGroupConfiguration. If
* none of them is set, Athena issues an error that no output location is provided. For more information, see Query Results. If workgroup settings
* override client-side settings, then the query uses the settings specified for the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration.
*
*
* @param outputLocation
* The location in Amazon S3 where your query results are stored, such as
* s3://path/to/query/bucket/. To run the query, you must specify the query results location
* using one of the ways: either for individual queries using either this setting (client-side), or in the
* workgroup, using WorkGroupConfiguration. If none of them is set, Athena issues an error that no
* output location is provided. For more information, see Query Results. If workgroup settings
* override client-side settings, then the query uses the settings specified for the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ResultConfiguration withOutputLocation(String outputLocation) {
setOutputLocation(outputLocation);
return this;
}
/**
*
* If query results are encrypted in Amazon S3, indicates the encryption option used (for example,
* SSE-KMS or CSE-KMS) and key information. This is a client-side setting. If workgroup
* settings override client-side settings, then the query uses the encryption configuration that is specified for
* the workgroup, and also uses the location for storing query results specified in the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings Override
* Client-Side Settings.
*
*
* @param encryptionConfiguration
* If query results are encrypted in Amazon S3, indicates the encryption option used (for example,
* SSE-KMS or CSE-KMS) and key information. This is a client-side setting. If
* workgroup settings override client-side settings, then the query uses the encryption configuration that is
* specified for the workgroup, and also uses the location for storing query results specified in the
* workgroup. See WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings
* Override Client-Side Settings.
*/
public void setEncryptionConfiguration(EncryptionConfiguration encryptionConfiguration) {
this.encryptionConfiguration = encryptionConfiguration;
}
/**
*
* If query results are encrypted in Amazon S3, indicates the encryption option used (for example,
* SSE-KMS or CSE-KMS) and key information. This is a client-side setting. If workgroup
* settings override client-side settings, then the query uses the encryption configuration that is specified for
* the workgroup, and also uses the location for storing query results specified in the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings Override
* Client-Side Settings.
*
*
* @return If query results are encrypted in Amazon S3, indicates the encryption option used (for example,
* SSE-KMS or CSE-KMS) and key information. This is a client-side setting. If
* workgroup settings override client-side settings, then the query uses the encryption configuration that
* is specified for the workgroup, and also uses the location for storing query results specified in the
* workgroup. See WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings
* Override Client-Side Settings.
*/
public EncryptionConfiguration getEncryptionConfiguration() {
return this.encryptionConfiguration;
}
/**
*
* If query results are encrypted in Amazon S3, indicates the encryption option used (for example,
* SSE-KMS or CSE-KMS) and key information. This is a client-side setting. If workgroup
* settings override client-side settings, then the query uses the encryption configuration that is specified for
* the workgroup, and also uses the location for storing query results specified in the workgroup. See
* WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings Override
* Client-Side Settings.
*
*
* @param encryptionConfiguration
* If query results are encrypted in Amazon S3, indicates the encryption option used (for example,
* SSE-KMS or CSE-KMS) and key information. This is a client-side setting. If
* workgroup settings override client-side settings, then the query uses the encryption configuration that is
* specified for the workgroup, and also uses the location for storing query results specified in the
* workgroup. See WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings
* Override Client-Side Settings.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ResultConfiguration withEncryptionConfiguration(EncryptionConfiguration encryptionConfiguration) {
setEncryptionConfiguration(encryptionConfiguration);
return this;
}
/**
* Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
* redacted from this string using a placeholder value.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getOutputLocation() != null)
sb.append("OutputLocation: ").append(getOutputLocation()).append(",");
if (getEncryptionConfiguration() != null)
sb.append("EncryptionConfiguration: ").append(getEncryptionConfiguration());
sb.append("}");
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof ResultConfiguration == false)
return false;
ResultConfiguration other = (ResultConfiguration) obj;
if (other.getOutputLocation() == null ^ this.getOutputLocation() == null)
return false;
if (other.getOutputLocation() != null && other.getOutputLocation().equals(this.getOutputLocation()) == false)
return false;
if (other.getEncryptionConfiguration() == null ^ this.getEncryptionConfiguration() == null)
return false;
if (other.getEncryptionConfiguration() != null && other.getEncryptionConfiguration().equals(this.getEncryptionConfiguration()) == false)
return false;
return true;
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getOutputLocation() == null) ? 0 : getOutputLocation().hashCode());
hashCode = prime * hashCode + ((getEncryptionConfiguration() == null) ? 0 : getEncryptionConfiguration().hashCode());
return hashCode;
}
@Override
public ResultConfiguration clone() {
try {
return (ResultConfiguration) super.clone();
} catch (CloneNotSupportedException e) {
throw new IllegalStateException("Got a CloneNotSupportedException from Object.clone() " + "even though we're Cloneable!", e);
}
}
@com.amazonaws.annotation.SdkInternalApi
@Override
public void marshall(ProtocolMarshaller protocolMarshaller) {
com.amazonaws.services.athena.model.transform.ResultConfigurationMarshaller.getInstance().marshall(this, protocolMarshaller);
}
}