/AWS1/CL_ATHRESULTCONFUPDATES

The information about the updates in the query results, such as output location and encryption configuration for the query results.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_outputlocation TYPE /AWS1/ATHRESULTOUTPUTLOCATION /AWS1/ATHRESULTOUTPUTLOCATION

The location in Amazon S3 where your query and calculation results are stored, such as s3://path/to/query/bucket/. If workgroup settings override client-side settings, then the query uses the location for the query results and the encryption configuration that are specified for the workgroup. The "workgroup settings override" is specified in EnforceWorkGroupConfiguration (true/false) in the WorkGroupConfiguration. See WorkGroupConfiguration$EnforceWorkGroupConfiguration.

iv_removeoutputlocation TYPE /AWS1/ATHBOXEDBOOLEAN /AWS1/ATHBOXEDBOOLEAN

If set to "true", indicates that the previously-specified query results location (also known as a client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in the OutputLocation in ResultConfigurationUpdates (the client-side setting), the OutputLocation in the workgroup's ResultConfiguration will be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

io_encryptionconfiguration TYPE REF TO /AWS1/CL_ATHENCRYPTIONCONF /AWS1/CL_ATHENCRYPTIONCONF

The encryption configuration for query and calculation results.

iv_removeencryptionconf TYPE /AWS1/ATHBOXEDBOOLEAN /AWS1/ATHBOXEDBOOLEAN

If set to "true", indicates that the previously-specified encryption configuration (also known as the client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in the EncryptionConfiguration in ResultConfigurationUpdates (the client-side setting), the EncryptionConfiguration in the workgroup's ResultConfiguration will be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

iv_expectedbucketowner TYPE /AWS1/ATHAWSACCOUNTID /AWS1/ATHAWSACCOUNTID

The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by ResultConfiguration$OutputLocation. If set, Athena uses the value for ExpectedBucketOwner when it makes Amazon S3 calls to your specified output location. If the ExpectedBucketOwner Amazon Web Services account ID does not match the actual owner of the Amazon S3 bucket, the call fails with a permissions error.

If workgroup settings override client-side settings, then the query uses the ExpectedBucketOwner setting 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.

iv_removeexpectedbucketowner TYPE /AWS1/ATHBOXEDBOOLEAN /AWS1/ATHBOXEDBOOLEAN

If set to "true", removes the Amazon Web Services account ID previously specified for ResultConfiguration$ExpectedBucketOwner. If set to "false" or not set, and a value is present in the ExpectedBucketOwner in ResultConfigurationUpdates (the client-side setting), the ExpectedBucketOwner in the workgroup's ResultConfiguration is updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

io_aclconfiguration TYPE REF TO /AWS1/CL_ATHACLCONFIGURATION /AWS1/CL_ATHACLCONFIGURATION

The ACL configuration for the query results.

iv_removeaclconfiguration TYPE /AWS1/ATHBOXEDBOOLEAN /AWS1/ATHBOXEDBOOLEAN

If set to true, indicates that the previously-specified ACL configuration for queries in this workgroup should be ignored and set to null. If set to false or not set, and a value is present in the AclConfiguration of ResultConfigurationUpdates, the AclConfiguration in the workgroup's ResultConfiguration is updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

---

Queryable Attributes

OutputLocation

The location in Amazon S3 where your query and calculation results are stored, such as s3://path/to/query/bucket/. If workgroup settings override client-side settings, then the query uses the location for the query results and the encryption configuration that are specified for the workgroup. The "workgroup settings override" is specified in EnforceWorkGroupConfiguration (true/false) in the WorkGroupConfiguration. See WorkGroupConfiguration$EnforceWorkGroupConfiguration.

Accessible with the following methods

Method	Description
GET_OUTPUTLOCATION()	Getter for OUTPUTLOCATION, with configurable default
ASK_OUTPUTLOCATION()	Getter for OUTPUTLOCATION w/ exceptions if field has no valu
HAS_OUTPUTLOCATION()	Determine if OUTPUTLOCATION has a value

RemoveOutputLocation

If set to "true", indicates that the previously-specified query results location (also known as a client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in the OutputLocation in ResultConfigurationUpdates (the client-side setting), the OutputLocation in the workgroup's ResultConfiguration will be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

Accessible with the following methods

Method	Description
GET_REMOVEOUTPUTLOCATION()	Getter for REMOVEOUTPUTLOCATION, with configurable default
ASK_REMOVEOUTPUTLOCATION()	Getter for REMOVEOUTPUTLOCATION w/ exceptions if field has n
HAS_REMOVEOUTPUTLOCATION()	Determine if REMOVEOUTPUTLOCATION has a value

EncryptionConfiguration

The encryption configuration for query and calculation results.

Accessible with the following methods

Method	Description
GET_ENCRYPTIONCONFIGURATION()	Getter for ENCRYPTIONCONFIGURATION

RemoveEncryptionConfiguration

If set to "true", indicates that the previously-specified encryption configuration (also known as the client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in the EncryptionConfiguration in ResultConfigurationUpdates (the client-side setting), the EncryptionConfiguration in the workgroup's ResultConfiguration will be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

Accessible with the following methods

Method	Description
GET_REMOVEENCRYPTIONCONF()	Getter for REMOVEENCRYPTIONCONF, with configurable default
ASK_REMOVEENCRYPTIONCONF()	Getter for REMOVEENCRYPTIONCONF w/ exceptions if field has n
HAS_REMOVEENCRYPTIONCONF()	Determine if REMOVEENCRYPTIONCONF has a value

ExpectedBucketOwner

The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by ResultConfiguration$OutputLocation. If set, Athena uses the value for ExpectedBucketOwner when it makes Amazon S3 calls to your specified output location. If the ExpectedBucketOwner Amazon Web Services account ID does not match the actual owner of the Amazon S3 bucket, the call fails with a permissions error.

If workgroup settings override client-side settings, then the query uses the ExpectedBucketOwner setting 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.

Accessible with the following methods

Method	Description
GET_EXPECTEDBUCKETOWNER()	Getter for EXPECTEDBUCKETOWNER, with configurable default
ASK_EXPECTEDBUCKETOWNER()	Getter for EXPECTEDBUCKETOWNER w/ exceptions if field has no
HAS_EXPECTEDBUCKETOWNER()	Determine if EXPECTEDBUCKETOWNER has a value

RemoveExpectedBucketOwner

If set to "true", removes the Amazon Web Services account ID previously specified for ResultConfiguration$ExpectedBucketOwner. If set to "false" or not set, and a value is present in the ExpectedBucketOwner in ResultConfigurationUpdates (the client-side setting), the ExpectedBucketOwner in the workgroup's ResultConfiguration is updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

Accessible with the following methods

Method	Description
GET_REMOVEEXPECTEDBKTOWNER()	Getter for REMOVEEXPECTEDBUCKETOWNER, with configurable defa
ASK_REMOVEEXPECTEDBKTOWNER()	Getter for REMOVEEXPECTEDBUCKETOWNER w/ exceptions if field
HAS_REMOVEEXPECTEDBKTOWNER()	Determine if REMOVEEXPECTEDBUCKETOWNER has a value

AclConfiguration

The ACL configuration for the query results.

Accessible with the following methods

Method	Description
GET_ACLCONFIGURATION()	Getter for ACLCONFIGURATION

RemoveAclConfiguration

If set to true, indicates that the previously-specified ACL configuration for queries in this workgroup should be ignored and set to null. If set to false or not set, and a value is present in the AclConfiguration of ResultConfigurationUpdates, the AclConfiguration in the workgroup's ResultConfiguration is updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.

Accessible with the following methods

Method	Description
GET_REMOVEACLCONFIGURATION()	Getter for REMOVEACLCONFIGURATION, with configurable default
ASK_REMOVEACLCONFIGURATION()	Getter for REMOVEACLCONFIGURATION w/ exceptions if field has
HAS_REMOVEACLCONFIGURATION()	Determine if REMOVEACLCONFIGURATION has a value