Skip to content

Commit 451e61c

Browse files
author
AWS
committed
Amazon Athena Update: This release updates data types that contain either QueryExecutionId, NamedQueryId or ExpectedBucketOwner. Ids must be between 1 and 128 characters and contain only non-whitespace characters. ExpectedBucketOwner must be 12-digit string.
1 parent 7e6ae57 commit 451e61c

File tree

2 files changed

+33
-8
lines changed

2 files changed

+33
-8
lines changed
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon Athena",
4+
"contributor": "",
5+
"description": "This release updates data types that contain either QueryExecutionId, NamedQueryId or ExpectedBucketOwner. Ids must be between 1 and 128 characters and contain only non-whitespace characters. ExpectedBucketOwner must be 12-digit string."
6+
}

services/athena/src/main/resources/codegen-resources/service-2.json

Lines changed: 27 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -573,6 +573,12 @@
573573
},
574574
"documentation":"<p>Provides information about an Athena query error. The <code>AthenaError</code> feature provides standardized error information to help you understand failed queries and take steps after a query failure occurs. <code>AthenaError</code> includes an <code>ErrorCategory</code> field that specifies whether the cause of the failed query is due to system error, user error, or other error.</p>"
575575
},
576+
"AwsAccountId":{
577+
"type":"string",
578+
"max":12,
579+
"min":12,
580+
"pattern":"^[0-9]+$"
581+
},
576582
"BatchGetNamedQueryInput":{
577583
"type":"structure",
578584
"required":["NamedQueryIds"],
@@ -581,7 +587,8 @@
581587
"shape":"NamedQueryIdList",
582588
"documentation":"<p>An array of query IDs.</p>"
583589
}
584-
}
590+
},
591+
"documentation":"<p>Contains an array of named query IDs.</p>"
585592
},
586593
"BatchGetNamedQueryOutput":{
587594
"type":"structure",
@@ -634,7 +641,8 @@
634641
"shape":"QueryExecutionIdList",
635642
"documentation":"<p>An array of query execution IDs.</p>"
636643
}
637-
}
644+
},
645+
"documentation":"<p>Contains an array of query execution IDs.</p>"
638646
},
639647
"BatchGetQueryExecutionOutput":{
640648
"type":"structure",
@@ -1743,7 +1751,12 @@
17431751
"max":1024,
17441752
"min":0
17451753
},
1746-
"NamedQueryId":{"type":"string"},
1754+
"NamedQueryId":{
1755+
"type":"string",
1756+
"max":128,
1757+
"min":1,
1758+
"pattern":"\\S+"
1759+
},
17471760
"NamedQueryIdList":{
17481761
"type":"list",
17491762
"member":{"shape":"NamedQueryId"},
@@ -1877,7 +1890,12 @@
18771890
},
18781891
"documentation":"<p>The database and data catalog context in which the query execution occurs.</p>"
18791892
},
1880-
"QueryExecutionId":{"type":"string"},
1893+
"QueryExecutionId":{
1894+
"type":"string",
1895+
"max":128,
1896+
"min":1,
1897+
"pattern":"\\S+"
1898+
},
18811899
"QueryExecutionIdList":{
18821900
"type":"list",
18831901
"member":{"shape":"QueryExecutionId"},
@@ -1979,15 +1997,15 @@
19791997
"type":"structure",
19801998
"members":{
19811999
"OutputLocation":{
1982-
"shape":"String",
2000+
"shape":"ResultOutputLocation",
19832001
"documentation":"<p>The location in Amazon S3 where your query results are stored, such as <code>s3://path/to/query/bucket/</code>. 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 <a>WorkGroupConfiguration</a>. If none of them is set, Athena issues an error that no output location is provided. For more information, see <a href=\"https://docs.aws.amazon.com/athena/latest/ug/querying.html\">Query Results</a>. If workgroup settings override client-side settings, then the query uses the settings specified for the workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>.</p>"
19842002
},
19852003
"EncryptionConfiguration":{
19862004
"shape":"EncryptionConfiguration",
19872005
"documentation":"<p>If query results are encrypted in Amazon S3, indicates the encryption option used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) 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 <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a> and <a href=\"https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html\">Workgroup Settings Override Client-Side Settings</a>.</p>"
19882006
},
19892007
"ExpectedBucketOwner":{
1990-
"shape":"String",
2008+
"shape":"AwsAccountId",
19912009
"documentation":"<p>The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by <a>ResultConfiguration$OutputLocation</a>. If set, Athena uses the value for <code>ExpectedBucketOwner</code> when it makes Amazon S3 calls to your specified output location. If the <code>ExpectedBucketOwner</code> Amazon Web Services account ID does not match the actual owner of the Amazon S3 bucket, the call fails with a permissions error.</p> <p>This is a client-side setting. If workgroup settings override client-side settings, then the query uses the <code>ExpectedBucketOwner</code> setting that is specified for the workgroup, and also uses the location for storing query results specified in the workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a> and <a href=\"https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html\">Workgroup Settings Override Client-Side Settings</a>.</p>"
19922010
},
19932011
"AclConfiguration":{
@@ -2001,7 +2019,7 @@
20012019
"type":"structure",
20022020
"members":{
20032021
"OutputLocation":{
2004-
"shape":"String",
2022+
"shape":"ResultOutputLocation",
20052023
"documentation":"<p>The location in Amazon S3 where your query results are stored, such as <code>s3://path/to/query/bucket/</code>. For more information, see <a href=\"https://docs.aws.amazon.com/athena/latest/ug/querying.html\">Query Results</a> 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 <code>EnforceWorkGroupConfiguration</code> (true/false) in the <code>WorkGroupConfiguration</code>. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>.</p>"
20062024
},
20072025
"RemoveOutputLocation":{
@@ -2017,7 +2035,7 @@
20172035
"documentation":"<p>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 <code>EncryptionConfiguration</code> in <code>ResultConfigurationUpdates</code> (the client-side setting), the <code>EncryptionConfiguration</code> in the workgroup's <code>ResultConfiguration</code> will be updated with the new value. For more information, see <a href=\"https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html\">Workgroup Settings Override Client-Side Settings</a>.</p>"
20182036
},
20192037
"ExpectedBucketOwner":{
2020-
"shape":"String",
2038+
"shape":"AwsAccountId",
20212039
"documentation":"<p>The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by <a>ResultConfiguration$OutputLocation</a>. If set, Athena uses the value for <code>ExpectedBucketOwner</code> when it makes Amazon S3 calls to your specified output location. If the <code>ExpectedBucketOwner</code> Amazon Web Services account ID does not match the actual owner of the Amazon S3 bucket, the call fails with a permissions error.</p> <p>If workgroup settings override client-side settings, then the query uses the <code>ExpectedBucketOwner</code> setting that is specified for the workgroup, and also uses the location for storing query results specified in the workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a> and <a href=\"https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html\">Workgroup Settings Override Client-Side Settings</a>.</p>"
20222040
},
20232041
"RemoveExpectedBucketOwner":{
@@ -2035,6 +2053,7 @@
20352053
},
20362054
"documentation":"<p>The information about the updates in the query results, such as output location and encryption configuration for the query results.</p>"
20372055
},
2056+
"ResultOutputLocation":{"type":"string"},
20382057
"ResultSet":{
20392058
"type":"structure",
20402059
"members":{

0 commit comments

Comments
 (0)