ResultConfigurationUpdates
The information about the updates in the query results, such as output location and encryption configuration for the query results.
Contents
- AclConfiguration
-
The ACL configuration for the query results.
Type: AclConfiguration object
Required: No
- EncryptionConfiguration
-
The encryption configuration for query and calculation results.
Type: EncryptionConfiguration object
Required: No
- ExpectedBucketOwner
-
The AWS 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
ExpectedBucketOwnerwhen it makes Amazon S3 calls to your specified output location. If theExpectedBucketOwnerAWS 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
ExpectedBucketOwnersetting 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.Type: String
Length Constraints: Fixed length of 12.
Pattern:
^[0-9]+$Required: No
- 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 inEnforceWorkGroupConfiguration(true/false) in theWorkGroupConfiguration. See WorkGroupConfiguration:EnforceWorkGroupConfiguration.Type: String
Required: No
- 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 tofalseor not set, and a value is present in theAclConfigurationofResultConfigurationUpdates, theAclConfigurationin the workgroup'sResultConfigurationis updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.Type: Boolean
Required: No
- 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
EncryptionConfigurationinResultConfigurationUpdates(the client-side setting), theEncryptionConfigurationin the workgroup'sResultConfigurationwill be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.Type: Boolean
Required: No
- RemoveExpectedBucketOwner
-
If set to "true", removes the AWS account ID previously specified for ResultConfiguration:ExpectedBucketOwner. If set to "false" or not set, and a value is present in the
ExpectedBucketOwnerinResultConfigurationUpdates(the client-side setting), theExpectedBucketOwnerin the workgroup'sResultConfigurationis updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.Type: Boolean
Required: No
- 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
OutputLocationinResultConfigurationUpdates(the client-side setting), theOutputLocationin the workgroup'sResultConfigurationwill be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.Type: Boolean
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: