@aws-sdk/client-athena 3.216.0 → 3.221.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (135) hide show
  1. package/dist-cjs/Athena.js +345 -0
  2. package/dist-cjs/commands/CreateNotebookCommand.js +46 -0
  3. package/dist-cjs/commands/CreatePresignedNotebookUrlCommand.js +46 -0
  4. package/dist-cjs/commands/DeleteNotebookCommand.js +46 -0
  5. package/dist-cjs/commands/ExportNotebookCommand.js +46 -0
  6. package/dist-cjs/commands/GetCalculationExecutionCodeCommand.js +46 -0
  7. package/dist-cjs/commands/GetCalculationExecutionCommand.js +46 -0
  8. package/dist-cjs/commands/GetCalculationExecutionStatusCommand.js +46 -0
  9. package/dist-cjs/commands/GetNotebookMetadataCommand.js +46 -0
  10. package/dist-cjs/commands/GetSessionCommand.js +46 -0
  11. package/dist-cjs/commands/GetSessionStatusCommand.js +46 -0
  12. package/dist-cjs/commands/ImportNotebookCommand.js +46 -0
  13. package/dist-cjs/commands/ListApplicationDPUSizesCommand.js +46 -0
  14. package/dist-cjs/commands/ListCalculationExecutionsCommand.js +46 -0
  15. package/dist-cjs/commands/ListExecutorsCommand.js +46 -0
  16. package/dist-cjs/commands/ListNotebookMetadataCommand.js +46 -0
  17. package/dist-cjs/commands/ListNotebookSessionsCommand.js +46 -0
  18. package/dist-cjs/commands/ListSessionsCommand.js +46 -0
  19. package/dist-cjs/commands/StartCalculationExecutionCommand.js +46 -0
  20. package/dist-cjs/commands/StartSessionCommand.js +46 -0
  21. package/dist-cjs/commands/StopCalculationExecutionCommand.js +46 -0
  22. package/dist-cjs/commands/TerminateSessionCommand.js +46 -0
  23. package/dist-cjs/commands/UpdateNotebookCommand.js +46 -0
  24. package/dist-cjs/commands/UpdateNotebookMetadataCommand.js +46 -0
  25. package/dist-cjs/commands/index.js +23 -0
  26. package/dist-cjs/models/models_0.js +322 -18
  27. package/dist-cjs/pagination/ListApplicationDPUSizesPaginator.js +36 -0
  28. package/dist-cjs/pagination/ListCalculationExecutionsPaginator.js +36 -0
  29. package/dist-cjs/pagination/ListExecutorsPaginator.js +36 -0
  30. package/dist-cjs/pagination/ListSessionsPaginator.js +36 -0
  31. package/dist-cjs/pagination/index.js +4 -0
  32. package/dist-cjs/protocols/Aws_json1_1.js +1908 -183
  33. package/dist-es/Athena.js +345 -0
  34. package/dist-es/commands/CreateNotebookCommand.js +42 -0
  35. package/dist-es/commands/CreatePresignedNotebookUrlCommand.js +42 -0
  36. package/dist-es/commands/DeleteNotebookCommand.js +42 -0
  37. package/dist-es/commands/ExportNotebookCommand.js +42 -0
  38. package/dist-es/commands/GetCalculationExecutionCodeCommand.js +42 -0
  39. package/dist-es/commands/GetCalculationExecutionCommand.js +42 -0
  40. package/dist-es/commands/GetCalculationExecutionStatusCommand.js +42 -0
  41. package/dist-es/commands/GetNotebookMetadataCommand.js +42 -0
  42. package/dist-es/commands/GetSessionCommand.js +42 -0
  43. package/dist-es/commands/GetSessionStatusCommand.js +42 -0
  44. package/dist-es/commands/ImportNotebookCommand.js +42 -0
  45. package/dist-es/commands/ListApplicationDPUSizesCommand.js +42 -0
  46. package/dist-es/commands/ListCalculationExecutionsCommand.js +42 -0
  47. package/dist-es/commands/ListExecutorsCommand.js +42 -0
  48. package/dist-es/commands/ListNotebookMetadataCommand.js +42 -0
  49. package/dist-es/commands/ListNotebookSessionsCommand.js +42 -0
  50. package/dist-es/commands/ListSessionsCommand.js +42 -0
  51. package/dist-es/commands/StartCalculationExecutionCommand.js +42 -0
  52. package/dist-es/commands/StartSessionCommand.js +42 -0
  53. package/dist-es/commands/StopCalculationExecutionCommand.js +42 -0
  54. package/dist-es/commands/TerminateSessionCommand.js +42 -0
  55. package/dist-es/commands/UpdateNotebookCommand.js +42 -0
  56. package/dist-es/commands/UpdateNotebookMetadataCommand.js +42 -0
  57. package/dist-es/commands/index.js +23 -0
  58. package/dist-es/models/models_0.js +254 -14
  59. package/dist-es/pagination/ListApplicationDPUSizesPaginator.js +32 -0
  60. package/dist-es/pagination/ListCalculationExecutionsPaginator.js +32 -0
  61. package/dist-es/pagination/ListExecutorsPaginator.js +32 -0
  62. package/dist-es/pagination/ListSessionsPaginator.js +32 -0
  63. package/dist-es/pagination/index.js +4 -0
  64. package/dist-es/protocols/Aws_json1_1.js +1835 -157
  65. package/dist-types/Athena.d.ts +212 -8
  66. package/dist-types/AthenaClient.d.ts +25 -2
  67. package/dist-types/commands/BatchGetPreparedStatementCommand.d.ts +5 -1
  68. package/dist-types/commands/CreateNotebookCommand.d.ts +39 -0
  69. package/dist-types/commands/CreatePresignedNotebookUrlCommand.d.ts +39 -0
  70. package/dist-types/commands/CreateWorkGroupCommand.d.ts +4 -1
  71. package/dist-types/commands/DeleteNotebookCommand.d.ts +37 -0
  72. package/dist-types/commands/ExportNotebookCommand.d.ts +37 -0
  73. package/dist-types/commands/GetCalculationExecutionCodeCommand.d.ts +38 -0
  74. package/dist-types/commands/GetCalculationExecutionCommand.d.ts +37 -0
  75. package/dist-types/commands/GetCalculationExecutionStatusCommand.d.ts +37 -0
  76. package/dist-types/commands/GetNotebookMetadataCommand.d.ts +37 -0
  77. package/dist-types/commands/GetQueryRuntimeStatisticsCommand.d.ts +4 -4
  78. package/dist-types/commands/GetSessionCommand.d.ts +38 -0
  79. package/dist-types/commands/GetSessionStatusCommand.d.ts +37 -0
  80. package/dist-types/commands/ImportNotebookCommand.d.ts +39 -0
  81. package/dist-types/commands/ListApplicationDPUSizesCommand.d.ts +38 -0
  82. package/dist-types/commands/ListCalculationExecutionsCommand.d.ts +38 -0
  83. package/dist-types/commands/ListExecutorsCommand.d.ts +39 -0
  84. package/dist-types/commands/ListNotebookMetadataCommand.d.ts +37 -0
  85. package/dist-types/commands/ListNotebookSessionsCommand.d.ts +40 -0
  86. package/dist-types/commands/ListSessionsCommand.d.ts +40 -0
  87. package/dist-types/commands/StartCalculationExecutionCommand.d.ts +38 -0
  88. package/dist-types/commands/StartSessionCommand.d.ts +38 -0
  89. package/dist-types/commands/StopCalculationExecutionCommand.d.ts +46 -0
  90. package/dist-types/commands/TerminateSessionCommand.d.ts +41 -0
  91. package/dist-types/commands/UpdateNotebookCommand.d.ts +37 -0
  92. package/dist-types/commands/UpdateNotebookMetadataCommand.d.ts +37 -0
  93. package/dist-types/commands/UpdateWorkGroupCommand.d.ts +5 -2
  94. package/dist-types/commands/index.d.ts +23 -0
  95. package/dist-types/models/models_0.d.ts +1511 -101
  96. package/dist-types/pagination/ListApplicationDPUSizesPaginator.d.ts +4 -0
  97. package/dist-types/pagination/ListCalculationExecutionsPaginator.d.ts +4 -0
  98. package/dist-types/pagination/ListExecutorsPaginator.d.ts +4 -0
  99. package/dist-types/pagination/ListSessionsPaginator.d.ts +4 -0
  100. package/dist-types/pagination/index.d.ts +4 -0
  101. package/dist-types/protocols/Aws_json1_1.d.ts +69 -0
  102. package/dist-types/ts3.4/Athena.d.ts +391 -0
  103. package/dist-types/ts3.4/AthenaClient.d.ts +138 -0
  104. package/dist-types/ts3.4/commands/CreateNotebookCommand.d.ts +34 -0
  105. package/dist-types/ts3.4/commands/CreatePresignedNotebookUrlCommand.d.ts +41 -0
  106. package/dist-types/ts3.4/commands/DeleteNotebookCommand.d.ts +34 -0
  107. package/dist-types/ts3.4/commands/ExportNotebookCommand.d.ts +34 -0
  108. package/dist-types/ts3.4/commands/GetCalculationExecutionCodeCommand.d.ts +41 -0
  109. package/dist-types/ts3.4/commands/GetCalculationExecutionCommand.d.ts +41 -0
  110. package/dist-types/ts3.4/commands/GetCalculationExecutionStatusCommand.d.ts +41 -0
  111. package/dist-types/ts3.4/commands/GetNotebookMetadataCommand.d.ts +38 -0
  112. package/dist-types/ts3.4/commands/GetSessionCommand.d.ts +34 -0
  113. package/dist-types/ts3.4/commands/GetSessionStatusCommand.d.ts +37 -0
  114. package/dist-types/ts3.4/commands/ImportNotebookCommand.d.ts +34 -0
  115. package/dist-types/ts3.4/commands/ListApplicationDPUSizesCommand.d.ts +41 -0
  116. package/dist-types/ts3.4/commands/ListCalculationExecutionsCommand.d.ts +41 -0
  117. package/dist-types/ts3.4/commands/ListExecutorsCommand.d.ts +37 -0
  118. package/dist-types/ts3.4/commands/ListNotebookMetadataCommand.d.ts +41 -0
  119. package/dist-types/ts3.4/commands/ListNotebookSessionsCommand.d.ts +41 -0
  120. package/dist-types/ts3.4/commands/ListSessionsCommand.d.ts +34 -0
  121. package/dist-types/ts3.4/commands/StartCalculationExecutionCommand.d.ts +41 -0
  122. package/dist-types/ts3.4/commands/StartSessionCommand.d.ts +34 -0
  123. package/dist-types/ts3.4/commands/StopCalculationExecutionCommand.d.ts +41 -0
  124. package/dist-types/ts3.4/commands/TerminateSessionCommand.d.ts +37 -0
  125. package/dist-types/ts3.4/commands/UpdateNotebookCommand.d.ts +34 -0
  126. package/dist-types/ts3.4/commands/UpdateNotebookMetadataCommand.d.ts +41 -0
  127. package/dist-types/ts3.4/commands/index.d.ts +23 -0
  128. package/dist-types/ts3.4/models/models_0.d.ts +538 -21
  129. package/dist-types/ts3.4/pagination/ListApplicationDPUSizesPaginator.d.ts +11 -0
  130. package/dist-types/ts3.4/pagination/ListCalculationExecutionsPaginator.d.ts +11 -0
  131. package/dist-types/ts3.4/pagination/ListExecutorsPaginator.d.ts +11 -0
  132. package/dist-types/ts3.4/pagination/ListSessionsPaginator.d.ts +11 -0
  133. package/dist-types/ts3.4/pagination/index.d.ts +4 -0
  134. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +276 -0
  135. package/package.json +3 -3
@@ -168,8 +168,8 @@ export interface UnprocessedPreparedStatementName {
168
168
  */
169
169
  ErrorCode?: string;
170
170
  /**
171
- * <p>The error message containing the reason why the prepared statement could not be returned.
172
- * The following error messages are possible:</p>
171
+ * <p>The error message containing the reason why the prepared statement could not be
172
+ * returned. The following error messages are possible:</p>
173
173
  * <ul>
174
174
  * <li>
175
175
  * <p>
@@ -196,7 +196,8 @@ export interface BatchGetPreparedStatementOutput {
196
196
  */
197
197
  PreparedStatements?: PreparedStatement[];
198
198
  /**
199
- * <p>A list of one or more prepared statements that were requested but could not be returned.</p>
199
+ * <p>A list of one or more prepared statements that were requested but could not be
200
+ * returned.</p>
200
201
  */
201
202
  UnprocessedPreparedStatementNames?: UnprocessedPreparedStatementName[];
202
203
  }
@@ -210,7 +211,8 @@ export interface BatchGetQueryExecutionInput {
210
211
  QueryExecutionIds: string[] | undefined;
211
212
  }
212
213
  /**
213
- * <p>The Athena engine version for running queries.</p>
214
+ * <p>The Athena engine version for running queries, or the PySpark engine
215
+ * version for running sessions.</p>
214
216
  */
215
217
  export interface EngineVersion {
216
218
  /**
@@ -537,7 +539,8 @@ export interface QueryExecution {
537
539
  */
538
540
  EngineVersion?: EngineVersion;
539
541
  /**
540
- * <p>A list of values for the parameters in a query. The values are applied sequentially to the parameters in the query in the order in which the parameters occur.</p>
542
+ * <p>A list of values for the parameters in a query. The values are applied sequentially to
543
+ * the parameters in the query in the order in which the parameters occur.</p>
541
544
  */
542
545
  ExecutionParameters?: string[];
543
546
  }
@@ -738,6 +741,54 @@ export interface CreateNamedQueryOutput {
738
741
  */
739
742
  NamedQueryId?: string;
740
743
  }
744
+ export interface CreateNotebookInput {
745
+ /**
746
+ * <p>The name of the Spark enabled workgroup in which the notebook will be created.</p>
747
+ */
748
+ WorkGroup: string | undefined;
749
+ /**
750
+ * <p>The name of the <code>ipynb</code> file to be created in the Spark workgroup, without
751
+ * the <code>.ipynb</code> extension.</p>
752
+ */
753
+ Name: string | undefined;
754
+ /**
755
+ * <p>A unique case-sensitive string used to ensure the request to create the notebook is
756
+ * idempotent (executes only once).</p>
757
+ * <important>
758
+ * <p>This token is listed as not required because Amazon Web Services SDKs (for example
759
+ * the Amazon Web Services SDK for Java) auto-generate the token for you. If you are not
760
+ * using the Amazon Web Services SDK or the Amazon Web Services CLI, you must provide
761
+ * this token or the action will fail.</p>
762
+ * </important>
763
+ */
764
+ ClientRequestToken?: string;
765
+ }
766
+ export interface CreateNotebookOutput {
767
+ /**
768
+ * <p>A unique identifier for the notebook.</p>
769
+ */
770
+ NotebookId?: string;
771
+ }
772
+ export declare enum ThrottleReason {
773
+ CONCURRENT_QUERY_LIMIT_EXCEEDED = "CONCURRENT_QUERY_LIMIT_EXCEEDED"
774
+ }
775
+ /**
776
+ * <p>Indicates that the request was throttled.</p>
777
+ */
778
+ export declare class TooManyRequestsException extends __BaseException {
779
+ readonly name: "TooManyRequestsException";
780
+ readonly $fault: "client";
781
+ Message?: string;
782
+ /**
783
+ * <p>The reason for the query throttling, for example, when it exceeds the concurrent query
784
+ * limit.</p>
785
+ */
786
+ Reason?: ThrottleReason | string;
787
+ /**
788
+ * @internal
789
+ */
790
+ constructor(opts: __ExceptionOptionType<TooManyRequestsException, __BaseException>);
791
+ }
741
792
  export interface CreatePreparedStatementInput {
742
793
  /**
743
794
  * <p>The name of the prepared statement.</p>
@@ -758,6 +809,52 @@ export interface CreatePreparedStatementInput {
758
809
  }
759
810
  export interface CreatePreparedStatementOutput {
760
811
  }
812
+ export interface CreatePresignedNotebookUrlRequest {
813
+ /**
814
+ * <p>The session ID.</p>
815
+ */
816
+ SessionId: string | undefined;
817
+ }
818
+ export interface CreatePresignedNotebookUrlResponse {
819
+ /**
820
+ * <p>The URL of the notebook. The URL includes the authentication token and notebook file
821
+ * name and points directly to the opened notebook.</p>
822
+ */
823
+ NotebookUrl: string | undefined;
824
+ /**
825
+ * <p>The authentication token for the notebook.</p>
826
+ */
827
+ AuthToken: string | undefined;
828
+ /**
829
+ * <p>The UTC epoch time when the authentication token expires.</p>
830
+ */
831
+ AuthTokenExpirationTime: number | undefined;
832
+ }
833
+ /**
834
+ * <p>A resource, such as a workgroup, was not found.</p>
835
+ */
836
+ export declare class ResourceNotFoundException extends __BaseException {
837
+ readonly name: "ResourceNotFoundException";
838
+ readonly $fault: "client";
839
+ Message?: string;
840
+ /**
841
+ * <p>The name of the Amazon resource.</p>
842
+ */
843
+ ResourceName?: string;
844
+ /**
845
+ * @internal
846
+ */
847
+ constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
848
+ }
849
+ /**
850
+ * <p>Specifies the KMS key that is used to encrypt the user's data stores in Athena.</p>
851
+ */
852
+ export interface CustomerContentEncryptionConfiguration {
853
+ /**
854
+ * <p>The KMS key that is used to encrypt the user's data stores in Athena.</p>
855
+ */
856
+ KmsKey: string | undefined;
857
+ }
761
858
  /**
762
859
  * <p>The configuration of the workgroup, which includes the location in Amazon S3
763
860
  * where query results are stored, the encryption option, if any, used for query results,
@@ -808,6 +905,18 @@ export interface WorkGroupConfiguration {
808
905
  * regardless of this setting.</p>
809
906
  */
810
907
  EngineVersion?: EngineVersion;
908
+ /**
909
+ * <p>Specifies a user defined JSON string that is passed to the notebook engine.</p>
910
+ */
911
+ AdditionalConfiguration?: string;
912
+ /**
913
+ * <p>Role used in a notebook session for accessing the user's resources.</p>
914
+ */
915
+ ExecutionRole?: string;
916
+ /**
917
+ * <p>Specifies the KMS key that is used to encrypt the user's data stores in Athena.</p>
918
+ */
919
+ CustomerContentEncryptionConfiguration?: CustomerContentEncryptionConfiguration;
811
920
  }
812
921
  export interface CreateWorkGroupInput {
813
922
  /**
@@ -815,12 +924,11 @@ export interface CreateWorkGroupInput {
815
924
  */
816
925
  Name: string | undefined;
817
926
  /**
818
- * <p>The configuration for the workgroup, which includes the location in Amazon S3
819
- * where query results are stored, the encryption configuration, if any, used for
820
- * encrypting query results, whether the Amazon CloudWatch Metrics are enabled for the
821
- * workgroup, the limit for the amount of bytes scanned (cutoff) per query, if it is
822
- * specified, and whether workgroup's settings (specified with
823
- * <code>EnforceWorkGroupConfiguration</code>) in the
927
+ * <p>Contains configuration information for creating an Athena SQL workgroup,
928
+ * which includes the location in Amazon S3 where query results are stored, the
929
+ * encryption configuration, if any, used for encrypting query results, whether the Amazon CloudWatch Metrics are enabled for the workgroup, the limit for the amount of
930
+ * bytes scanned (cutoff) per query, if it is specified, and whether workgroup's settings
931
+ * (specified with <code>EnforceWorkGroupConfiguration</code>) in the
824
932
  * <code>WorkGroupConfiguration</code> override client-side settings. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>.</p>
825
933
  */
826
934
  Configuration?: WorkGroupConfiguration;
@@ -851,6 +959,14 @@ export interface DeleteNamedQueryInput {
851
959
  }
852
960
  export interface DeleteNamedQueryOutput {
853
961
  }
962
+ export interface DeleteNotebookInput {
963
+ /**
964
+ * <p>The ID of the notebook to delete.</p>
965
+ */
966
+ NotebookId: string | undefined;
967
+ }
968
+ export interface DeleteNotebookOutput {
969
+ }
854
970
  export interface DeletePreparedStatementInput {
855
971
  /**
856
972
  * <p>The name of the prepared statement to delete.</p>
@@ -863,22 +979,6 @@ export interface DeletePreparedStatementInput {
863
979
  }
864
980
  export interface DeletePreparedStatementOutput {
865
981
  }
866
- /**
867
- * <p>A resource, such as a workgroup, was not found.</p>
868
- */
869
- export declare class ResourceNotFoundException extends __BaseException {
870
- readonly name: "ResourceNotFoundException";
871
- readonly $fault: "client";
872
- Message?: string;
873
- /**
874
- * <p>The name of the Amazon resource.</p>
875
- */
876
- ResourceName?: string;
877
- /**
878
- * @internal
879
- */
880
- constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
881
- }
882
982
  export interface DeleteWorkGroupInput {
883
983
  /**
884
984
  * <p>The unique name of the workgroup to delete.</p>
@@ -892,6 +992,207 @@ export interface DeleteWorkGroupInput {
892
992
  }
893
993
  export interface DeleteWorkGroupOutput {
894
994
  }
995
+ export interface ExportNotebookInput {
996
+ /**
997
+ * <p>The ID of the notebook to export.</p>
998
+ */
999
+ NotebookId: string | undefined;
1000
+ }
1001
+ export declare enum NotebookType {
1002
+ IPYNB = "IPYNB"
1003
+ }
1004
+ /**
1005
+ * <p>Contains metadata for notebook, including the notebook name, ID, workgroup, and time
1006
+ * created.</p>
1007
+ */
1008
+ export interface NotebookMetadata {
1009
+ /**
1010
+ * <p>The notebook ID.</p>
1011
+ */
1012
+ NotebookId?: string;
1013
+ /**
1014
+ * <p>The name of the notebook.</p>
1015
+ */
1016
+ Name?: string;
1017
+ /**
1018
+ * <p>The name of the Spark enabled workgroup to which the notebook belongs.</p>
1019
+ */
1020
+ WorkGroup?: string;
1021
+ /**
1022
+ * <p>The time when the notebook was created.</p>
1023
+ */
1024
+ CreationTime?: Date;
1025
+ /**
1026
+ * <p>The type of notebook. Currently, the only valid type is <code>IPYNB</code>.</p>
1027
+ */
1028
+ Type?: NotebookType | string;
1029
+ /**
1030
+ * <p>The time when the notebook was last modified.</p>
1031
+ */
1032
+ LastModifiedTime?: Date;
1033
+ }
1034
+ export interface ExportNotebookOutput {
1035
+ /**
1036
+ * <p>The notebook metadata, including notebook ID, notebook name, and workgroup
1037
+ * name.</p>
1038
+ */
1039
+ NotebookMetadata?: NotebookMetadata;
1040
+ /**
1041
+ * <p>The content of the exported notebook.</p>
1042
+ */
1043
+ Payload?: string;
1044
+ }
1045
+ export interface GetCalculationExecutionRequest {
1046
+ /**
1047
+ * <p>The calculation execution UUID.</p>
1048
+ */
1049
+ CalculationExecutionId: string | undefined;
1050
+ }
1051
+ /**
1052
+ * <p>Contains information about an application-specific calculation result.</p>
1053
+ */
1054
+ export interface CalculationResult {
1055
+ /**
1056
+ * <p>The Amazon S3 location of the <code>stdout</code> file for the calculation.</p>
1057
+ */
1058
+ StdOutS3Uri?: string;
1059
+ /**
1060
+ * <p>The Amazon S3 location of the <code>stderr</code> error messages file for the
1061
+ * calculation.</p>
1062
+ */
1063
+ StdErrorS3Uri?: string;
1064
+ /**
1065
+ * <p>The Amazon S3 location of the folder for the calculation results.</p>
1066
+ */
1067
+ ResultS3Uri?: string;
1068
+ /**
1069
+ * <p>The data format of the calculation result.</p>
1070
+ */
1071
+ ResultType?: string;
1072
+ }
1073
+ /**
1074
+ * <p>Contains statistics for a notebook calculation.</p>
1075
+ */
1076
+ export interface CalculationStatistics {
1077
+ /**
1078
+ * <p>The data processing unit execution time in milliseconds for the calculation.</p>
1079
+ */
1080
+ DpuExecutionInMillis?: number;
1081
+ /**
1082
+ * <p>The progress of the calculation.</p>
1083
+ */
1084
+ Progress?: string;
1085
+ }
1086
+ export declare enum CalculationExecutionState {
1087
+ CANCELED = "CANCELED",
1088
+ CANCELING = "CANCELING",
1089
+ COMPLETED = "COMPLETED",
1090
+ CREATED = "CREATED",
1091
+ CREATING = "CREATING",
1092
+ FAILED = "FAILED",
1093
+ QUEUED = "QUEUED",
1094
+ RUNNING = "RUNNING"
1095
+ }
1096
+ /**
1097
+ * <p>Contains information about the status of a notebook calculation.</p>
1098
+ */
1099
+ export interface CalculationStatus {
1100
+ /**
1101
+ * <p>The date and time the calculation was submitted for processing.</p>
1102
+ */
1103
+ SubmissionDateTime?: Date;
1104
+ /**
1105
+ * <p>The date and time the calculation completed processing.</p>
1106
+ */
1107
+ CompletionDateTime?: Date;
1108
+ /**
1109
+ * <p>The state of the calculation execution. A description of each state follows.</p>
1110
+ * <p>
1111
+ * <code>CREATING</code> - The calculation is in the process of being created.</p>
1112
+ * <p>
1113
+ * <code>CREATED</code> - The calculation has been created and is ready to run.</p>
1114
+ * <p>
1115
+ * <code>QUEUED</code> - The calculation has been queued for processing.</p>
1116
+ * <p>
1117
+ * <code>RUNNING</code> - The calculation is running.</p>
1118
+ * <p>
1119
+ * <code>CANCELING</code> - A request to cancel the calculation has been received and the
1120
+ * system is working to stop it.</p>
1121
+ * <p>
1122
+ * <code>CANCELED</code> - The calculation is no longer running as the result of a cancel
1123
+ * request.</p>
1124
+ * <p>
1125
+ * <code>COMPLETED</code> - The calculation has completed without error.</p>
1126
+ * <p>
1127
+ * <code>FAILED</code> - The calculation failed and is no longer running.</p>
1128
+ */
1129
+ State?: CalculationExecutionState | string;
1130
+ /**
1131
+ * <p>The reason for the calculation state change (for example, the calculation was canceled
1132
+ * because the session was terminated).</p>
1133
+ */
1134
+ StateChangeReason?: string;
1135
+ }
1136
+ export interface GetCalculationExecutionResponse {
1137
+ /**
1138
+ * <p>The calculation execution UUID.</p>
1139
+ */
1140
+ CalculationExecutionId?: string;
1141
+ /**
1142
+ * <p>The session ID that the calculation ran in.</p>
1143
+ */
1144
+ SessionId?: string;
1145
+ /**
1146
+ * <p>The description of the calculation execution.</p>
1147
+ */
1148
+ Description?: string;
1149
+ /**
1150
+ * <p>The Amazon S3 location in which calculation results are stored.</p>
1151
+ */
1152
+ WorkingDirectory?: string;
1153
+ /**
1154
+ * <p>Contains information about the status of the calculation.</p>
1155
+ */
1156
+ Status?: CalculationStatus;
1157
+ /**
1158
+ * <p>Contains information about the data processing unit (DPU) execution time and progress.
1159
+ * This field is populated only when statistics are available.</p>
1160
+ */
1161
+ Statistics?: CalculationStatistics;
1162
+ /**
1163
+ * <p>Contains result information. This field is populated only if the calculation is
1164
+ * completed.</p>
1165
+ */
1166
+ Result?: CalculationResult;
1167
+ }
1168
+ export interface GetCalculationExecutionCodeRequest {
1169
+ /**
1170
+ * <p>The calculation execution UUID.</p>
1171
+ */
1172
+ CalculationExecutionId: string | undefined;
1173
+ }
1174
+ export interface GetCalculationExecutionCodeResponse {
1175
+ /**
1176
+ * <p>A pre-signed URL to the code that executed the calculation.</p>
1177
+ */
1178
+ CodeBlock?: string;
1179
+ }
1180
+ export interface GetCalculationExecutionStatusRequest {
1181
+ /**
1182
+ * <p>The calculation execution UUID.</p>
1183
+ */
1184
+ CalculationExecutionId: string | undefined;
1185
+ }
1186
+ export interface GetCalculationExecutionStatusResponse {
1187
+ /**
1188
+ * <p>Contains information about the calculation execution status.</p>
1189
+ */
1190
+ Status?: CalculationStatus;
1191
+ /**
1192
+ * <p>Contains information about the DPU execution time and progress.</p>
1193
+ */
1194
+ Statistics?: CalculationStatistics;
1195
+ }
895
1196
  export interface GetDatabaseInput {
896
1197
  /**
897
1198
  * <p>The name of the data catalog that contains the database to return.</p>
@@ -1054,6 +1355,18 @@ export interface GetNamedQueryOutput {
1054
1355
  */
1055
1356
  NamedQuery?: NamedQuery;
1056
1357
  }
1358
+ export interface GetNotebookMetadataInput {
1359
+ /**
1360
+ * <p>The ID of the notebook whose metadata is to be retrieved.</p>
1361
+ */
1362
+ NotebookId: string | undefined;
1363
+ }
1364
+ export interface GetNotebookMetadataOutput {
1365
+ /**
1366
+ * <p>The metadata that is returned for the specified notebook ID.</p>
1367
+ */
1368
+ NotebookMetadata?: NotebookMetadata;
1369
+ }
1057
1370
  export interface GetPreparedStatementInput {
1058
1371
  /**
1059
1372
  * <p>The name of the prepared statement to retrieve.</p>
@@ -1210,26 +1523,6 @@ export interface GetQueryResultsOutput {
1210
1523
  */
1211
1524
  NextToken?: string;
1212
1525
  }
1213
- export declare enum ThrottleReason {
1214
- CONCURRENT_QUERY_LIMIT_EXCEEDED = "CONCURRENT_QUERY_LIMIT_EXCEEDED"
1215
- }
1216
- /**
1217
- * <p>Indicates that the request was throttled.</p>
1218
- */
1219
- export declare class TooManyRequestsException extends __BaseException {
1220
- readonly name: "TooManyRequestsException";
1221
- readonly $fault: "client";
1222
- Message?: string;
1223
- /**
1224
- * <p>The reason for the query throttling, for example, when it exceeds the concurrent query
1225
- * limit.</p>
1226
- */
1227
- Reason?: ThrottleReason | string;
1228
- /**
1229
- * @internal
1230
- */
1231
- constructor(opts: __ExceptionOptionType<TooManyRequestsException, __BaseException>);
1232
- }
1233
1526
  export interface GetQueryRuntimeStatisticsInput {
1234
1527
  /**
1235
1528
  * <p>The unique ID of the query execution.</p>
@@ -1237,8 +1530,8 @@ export interface GetQueryRuntimeStatisticsInput {
1237
1530
  QueryExecutionId: string | undefined;
1238
1531
  }
1239
1532
  /**
1240
- * <p>Statistics such as input rows and bytes read by the query, rows and bytes output by the query,
1241
- * and the number of rows written by the query.</p>
1533
+ * <p>Statistics such as input rows and bytes read by the query, rows and bytes output by
1534
+ * the query, and the number of rows written by the query.</p>
1242
1535
  */
1243
1536
  export interface QueryRuntimeStatisticsRows {
1244
1537
  /**
@@ -1259,8 +1552,8 @@ export interface QueryRuntimeStatisticsRows {
1259
1552
  OutputRows?: number;
1260
1553
  }
1261
1554
  /**
1262
- * <p>Timeline statistics such as query queue time, planning time, execution time, service processing
1263
- * time, and total execution time.</p>
1555
+ * <p>Timeline statistics such as query queue time, planning time, execution time, service
1556
+ * processing time, and total execution time.</p>
1264
1557
  */
1265
1558
  export interface QueryRuntimeStatisticsTimeline {
1266
1559
  /**
@@ -1290,54 +1583,236 @@ export interface QueryRuntimeStatisticsTimeline {
1290
1583
  */
1291
1584
  TotalExecutionTimeInMillis?: number;
1292
1585
  }
1293
- export interface GetTableMetadataInput {
1294
- /**
1295
- * <p>The name of the data catalog that contains the database and table metadata to
1296
- * return.</p>
1297
- */
1298
- CatalogName: string | undefined;
1586
+ export interface GetSessionRequest {
1299
1587
  /**
1300
- * <p>The name of the database that contains the table metadata to return.</p>
1301
- */
1302
- DatabaseName: string | undefined;
1303
- /**
1304
- * <p>The name of the table for which metadata is returned.</p>
1588
+ * <p>The session ID.</p>
1305
1589
  */
1306
- TableName: string | undefined;
1590
+ SessionId: string | undefined;
1307
1591
  }
1308
1592
  /**
1309
- * <p>Contains metadata for a column in a table.</p>
1593
+ * <p>Contains data processing unit (DPU) configuration settings and parameter mappings for
1594
+ * a notebook engine.</p>
1310
1595
  */
1311
- export interface Column {
1596
+ export interface EngineConfiguration {
1312
1597
  /**
1313
- * <p>The name of the column.</p>
1598
+ * <p>The number of DPUs to use for the coordinator. A coordinator is a special executor
1599
+ * that orchestrates processing work and manages other executors in a notebook
1600
+ * session.</p>
1314
1601
  */
1315
- Name: string | undefined;
1602
+ CoordinatorDpuSize?: number;
1316
1603
  /**
1317
- * <p>The data type of the column.</p>
1604
+ * <p>The maximum number of DPUs that can run concurrently.</p>
1318
1605
  */
1319
- Type?: string;
1606
+ MaxConcurrentDpus: number | undefined;
1320
1607
  /**
1321
- * <p>Optional information about the column.</p>
1608
+ * <p>The default number of DPUs to use for executors. An executor is the smallest unit of
1609
+ * compute that a notebook session can request from Athena.</p>
1322
1610
  */
1323
- Comment?: string;
1611
+ DefaultExecutorDpuSize?: number;
1612
+ /**
1613
+ * <p>Contains additional notebook engine <code>MAP<string, string></code> parameter
1614
+ * mappings in the form of key-value pairs. To specify an Amazon S3 URI that the
1615
+ * Jupyter server will download and serve, specify a value for the <a>StartSessionRequest$NotebookVersion</a> field, and then add a key named
1616
+ * <code>NotebookFileURI</code> to <code>AdditionalConfigs</code> that has value of the
1617
+ * Amazon S3 URI.</p>
1618
+ */
1619
+ AdditionalConfigs?: Record<string, string>;
1324
1620
  }
1325
1621
  /**
1326
- * <p>Contains metadata for a table.</p>
1622
+ * <p>Contains session configuration information.</p>
1327
1623
  */
1328
- export interface TableMetadata {
1624
+ export interface SessionConfiguration {
1329
1625
  /**
1330
- * <p>The name of the table.</p>
1626
+ * <p>The ARN of the execution role used for the session.</p>
1331
1627
  */
1332
- Name: string | undefined;
1628
+ ExecutionRole?: string;
1333
1629
  /**
1334
- * <p>The time that the table was created.</p>
1630
+ * <p>The Amazon S3 location that stores information for the notebook.</p>
1335
1631
  */
1336
- CreateTime?: Date;
1632
+ WorkingDirectory?: string;
1337
1633
  /**
1338
- * <p>The last time the table was accessed.</p>
1634
+ * <p>The idle timeout in seconds for the session.</p>
1339
1635
  */
1340
- LastAccessTime?: Date;
1636
+ IdleTimeoutSeconds?: number;
1637
+ /**
1638
+ * <p>If query results are encrypted in Amazon S3, indicates the encryption option
1639
+ * used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) and key
1640
+ * information.</p>
1641
+ */
1642
+ EncryptionConfiguration?: EncryptionConfiguration;
1643
+ }
1644
+ /**
1645
+ * <p>Contains statistics for a notebook session.</p>
1646
+ */
1647
+ export interface SessionStatistics {
1648
+ /**
1649
+ * <p>The data processing unit execution time for a session in milliseconds.</p>
1650
+ */
1651
+ DpuExecutionInMillis?: number;
1652
+ }
1653
+ export declare enum SessionState {
1654
+ BUSY = "BUSY",
1655
+ CREATED = "CREATED",
1656
+ CREATING = "CREATING",
1657
+ DEGRADED = "DEGRADED",
1658
+ FAILED = "FAILED",
1659
+ IDLE = "IDLE",
1660
+ TERMINATED = "TERMINATED",
1661
+ TERMINATING = "TERMINATING"
1662
+ }
1663
+ /**
1664
+ * <p>Contains information about the status of a notebook session.</p>
1665
+ */
1666
+ export interface SessionStatus {
1667
+ /**
1668
+ * <p>The date and time that the session started.</p>
1669
+ */
1670
+ StartDateTime?: Date;
1671
+ /**
1672
+ * <p>The most recent date and time that the session was modified.</p>
1673
+ */
1674
+ LastModifiedDateTime?: Date;
1675
+ /**
1676
+ * <p>The date and time that the session ended.</p>
1677
+ */
1678
+ EndDateTime?: Date;
1679
+ /**
1680
+ * <p>The date and time starting at which the session became idle. Can be empty if the
1681
+ * session is not currently idle.</p>
1682
+ */
1683
+ IdleSinceDateTime?: Date;
1684
+ /**
1685
+ * <p>The state of the session. A description of each state follows.</p>
1686
+ * <p>
1687
+ * <code>CREATING</code> - The session is being started, including acquiring
1688
+ * resources.</p>
1689
+ * <p>
1690
+ * <code>CREATED</code> - The session has been started.</p>
1691
+ * <p>
1692
+ * <code>IDLE</code> - The session is able to accept a calculation.</p>
1693
+ * <p>
1694
+ * <code>BUSY</code> - The session is processing another task and is unable to accept a
1695
+ * calculation.</p>
1696
+ * <p>
1697
+ * <code>TERMINATING</code> - The session is in the process of shutting down.</p>
1698
+ * <p>
1699
+ * <code>TERMINATED</code> - The session and its resources are no longer running.</p>
1700
+ * <p>
1701
+ * <code>DEGRADED</code> - The session has no healthy coordinators.</p>
1702
+ * <p>
1703
+ * <code>FAILED</code> - Due to a failure, the session and its resources are no longer
1704
+ * running.</p>
1705
+ */
1706
+ State?: SessionState | string;
1707
+ /**
1708
+ * <p>The reason for the session state change (for example, canceled because the session was
1709
+ * terminated).</p>
1710
+ */
1711
+ StateChangeReason?: string;
1712
+ }
1713
+ export interface GetSessionResponse {
1714
+ /**
1715
+ * <p>The session ID.</p>
1716
+ */
1717
+ SessionId?: string;
1718
+ /**
1719
+ * <p>The session description.</p>
1720
+ */
1721
+ Description?: string;
1722
+ /**
1723
+ * <p>The workgroup to which the session belongs.</p>
1724
+ */
1725
+ WorkGroup?: string;
1726
+ /**
1727
+ * <p>The engine version used by the session (for example, <code>PySpark engine version
1728
+ * 3</code>). You can get a list of engine versions by calling <a>ListEngineVersions</a>.</p>
1729
+ */
1730
+ EngineVersion?: string;
1731
+ /**
1732
+ * <p>Contains engine configuration information like DPU usage.</p>
1733
+ */
1734
+ EngineConfiguration?: EngineConfiguration;
1735
+ /**
1736
+ * <p>The notebook version.</p>
1737
+ */
1738
+ NotebookVersion?: string;
1739
+ /**
1740
+ * <p>Contains the workgroup configuration information used by the session.</p>
1741
+ */
1742
+ SessionConfiguration?: SessionConfiguration;
1743
+ /**
1744
+ * <p>Contains information about the status of the session.</p>
1745
+ */
1746
+ Status?: SessionStatus;
1747
+ /**
1748
+ * <p>Contains the DPU execution time.</p>
1749
+ */
1750
+ Statistics?: SessionStatistics;
1751
+ }
1752
+ export interface GetSessionStatusRequest {
1753
+ /**
1754
+ * <p>The session ID.</p>
1755
+ */
1756
+ SessionId: string | undefined;
1757
+ }
1758
+ export interface GetSessionStatusResponse {
1759
+ /**
1760
+ * <p>The session ID.</p>
1761
+ */
1762
+ SessionId?: string;
1763
+ /**
1764
+ * <p>Contains information about the status of the session.</p>
1765
+ */
1766
+ Status?: SessionStatus;
1767
+ }
1768
+ export interface GetTableMetadataInput {
1769
+ /**
1770
+ * <p>The name of the data catalog that contains the database and table metadata to
1771
+ * return.</p>
1772
+ */
1773
+ CatalogName: string | undefined;
1774
+ /**
1775
+ * <p>The name of the database that contains the table metadata to return.</p>
1776
+ */
1777
+ DatabaseName: string | undefined;
1778
+ /**
1779
+ * <p>The name of the table for which metadata is returned.</p>
1780
+ */
1781
+ TableName: string | undefined;
1782
+ }
1783
+ /**
1784
+ * <p>Contains metadata for a column in a table.</p>
1785
+ */
1786
+ export interface Column {
1787
+ /**
1788
+ * <p>The name of the column.</p>
1789
+ */
1790
+ Name: string | undefined;
1791
+ /**
1792
+ * <p>The data type of the column.</p>
1793
+ */
1794
+ Type?: string;
1795
+ /**
1796
+ * <p>Optional information about the column.</p>
1797
+ */
1798
+ Comment?: string;
1799
+ }
1800
+ /**
1801
+ * <p>Contains metadata for a table.</p>
1802
+ */
1803
+ export interface TableMetadata {
1804
+ /**
1805
+ * <p>The name of the table.</p>
1806
+ */
1807
+ Name: string | undefined;
1808
+ /**
1809
+ * <p>The time that the table was created.</p>
1810
+ */
1811
+ CreateTime?: Date;
1812
+ /**
1813
+ * <p>The last time the table was accessed.</p>
1814
+ */
1815
+ LastAccessTime?: Date;
1341
1816
  /**
1342
1817
  * <p>The type of table. In Athena, only <code>EXTERNAL_TABLE</code> is
1343
1818
  * supported.</p>
@@ -1416,6 +1891,147 @@ export interface GetWorkGroupOutput {
1416
1891
  */
1417
1892
  WorkGroup?: WorkGroup;
1418
1893
  }
1894
+ export interface ImportNotebookInput {
1895
+ /**
1896
+ * <p>The name of the Spark enabled workgroup to import the notebook to.</p>
1897
+ */
1898
+ WorkGroup: string | undefined;
1899
+ /**
1900
+ * <p>The name of the notebook to import.</p>
1901
+ */
1902
+ Name: string | undefined;
1903
+ /**
1904
+ * <p>The notebook content to be imported.</p>
1905
+ */
1906
+ Payload: string | undefined;
1907
+ /**
1908
+ * <p>The notebook content type. Currently, the only valid type is
1909
+ * <code>IPYNB</code>.</p>
1910
+ */
1911
+ Type: NotebookType | string | undefined;
1912
+ /**
1913
+ * <p>A unique case-sensitive string used to ensure the request to import the notebook is
1914
+ * idempotent (executes only once).</p>
1915
+ * <important>
1916
+ * <p>This token is listed as not required because Amazon Web Services SDKs (for example
1917
+ * the Amazon Web Services SDK for Java) auto-generate the token for you. If you are not
1918
+ * using the Amazon Web Services SDK or the Amazon Web Services CLI, you must provide
1919
+ * this token or the action will fail.</p>
1920
+ * </important>
1921
+ */
1922
+ ClientRequestToken?: string;
1923
+ }
1924
+ export interface ImportNotebookOutput {
1925
+ /**
1926
+ * <p>The ID of the notebook to import.</p>
1927
+ */
1928
+ NotebookId?: string;
1929
+ }
1930
+ export interface ListApplicationDPUSizesInput {
1931
+ /**
1932
+ * <p>Specifies the maximum number of results to return.</p>
1933
+ */
1934
+ MaxResults?: number;
1935
+ /**
1936
+ * <p>A token generated by the Athena service that specifies where to continue
1937
+ * pagination if a previous request was truncated.</p>
1938
+ */
1939
+ NextToken?: string;
1940
+ }
1941
+ /**
1942
+ * <p>Contains the application runtime IDs and their supported DPU sizes.</p>
1943
+ */
1944
+ export interface ApplicationDPUSizes {
1945
+ /**
1946
+ * <p>The name of the supported application runtime (for example, <code>Jupyter
1947
+ * 1.0</code>).</p>
1948
+ */
1949
+ ApplicationRuntimeId?: string;
1950
+ /**
1951
+ * <p>A list of the supported DPU sizes that the application runtime supports.</p>
1952
+ */
1953
+ SupportedDPUSizes?: number[];
1954
+ }
1955
+ export interface ListApplicationDPUSizesOutput {
1956
+ /**
1957
+ * <p>A list of the supported DPU sizes that the application runtime supports.</p>
1958
+ */
1959
+ ApplicationDPUSizes?: ApplicationDPUSizes[];
1960
+ /**
1961
+ * <p>A token generated by the Athena service that specifies where to continue
1962
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
1963
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
1964
+ */
1965
+ NextToken?: string;
1966
+ }
1967
+ export interface ListCalculationExecutionsRequest {
1968
+ /**
1969
+ * <p>The session ID.</p>
1970
+ */
1971
+ SessionId: string | undefined;
1972
+ /**
1973
+ * <p>A filter for a specific calculation execution state. A description of each state
1974
+ * follows.</p>
1975
+ * <p>
1976
+ * <code>CREATING</code> - The calculation is in the process of being created.</p>
1977
+ * <p>
1978
+ * <code>CREATED</code> - The calculation has been created and is ready to run.</p>
1979
+ * <p>
1980
+ * <code>QUEUED</code> - The calculation has been queued for processing.</p>
1981
+ * <p>
1982
+ * <code>RUNNING</code> - The calculation is running.</p>
1983
+ * <p>
1984
+ * <code>CANCELING</code> - A request to cancel the calculation has been received and the
1985
+ * system is working to stop it.</p>
1986
+ * <p>
1987
+ * <code>CANCELED</code> - The calculation is no longer running as the result of a cancel
1988
+ * request.</p>
1989
+ * <p>
1990
+ * <code>COMPLETED</code> - The calculation has completed without error.</p>
1991
+ * <p>
1992
+ * <code>FAILED</code> - The calculation failed and is no longer running.</p>
1993
+ */
1994
+ StateFilter?: CalculationExecutionState | string;
1995
+ /**
1996
+ * <p>The maximum number of calculation executions to return.</p>
1997
+ */
1998
+ MaxResults?: number;
1999
+ /**
2000
+ * <p>A token generated by the Athena service that specifies where to continue
2001
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2002
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2003
+ */
2004
+ NextToken?: string;
2005
+ }
2006
+ /**
2007
+ * <p>Summary information for a notebook calculation.</p>
2008
+ */
2009
+ export interface CalculationSummary {
2010
+ /**
2011
+ * <p>The calculation execution UUID.</p>
2012
+ */
2013
+ CalculationExecutionId?: string;
2014
+ /**
2015
+ * <p>A description of the calculation.</p>
2016
+ */
2017
+ Description?: string;
2018
+ /**
2019
+ * <p>Contains information about the status of the calculation.</p>
2020
+ */
2021
+ Status?: CalculationStatus;
2022
+ }
2023
+ export interface ListCalculationExecutionsResponse {
2024
+ /**
2025
+ * <p>A token generated by the Athena service that specifies where to continue
2026
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2027
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2028
+ */
2029
+ NextToken?: string;
2030
+ /**
2031
+ * <p>A list of <a>CalculationSummary</a> objects.</p>
2032
+ */
2033
+ Calculations?: CalculationSummary[];
2034
+ }
1419
2035
  export interface ListDatabasesInput {
1420
2036
  /**
1421
2037
  * <p>The name of the data catalog that contains the databases to return.</p>
@@ -1507,6 +2123,113 @@ export interface ListEngineVersionsOutput {
1507
2123
  */
1508
2124
  NextToken?: string;
1509
2125
  }
2126
+ export declare enum ExecutorState {
2127
+ CREATED = "CREATED",
2128
+ CREATING = "CREATING",
2129
+ FAILED = "FAILED",
2130
+ REGISTERED = "REGISTERED",
2131
+ TERMINATED = "TERMINATED",
2132
+ TERMINATING = "TERMINATING"
2133
+ }
2134
+ export interface ListExecutorsRequest {
2135
+ /**
2136
+ * <p>The session ID.</p>
2137
+ */
2138
+ SessionId: string | undefined;
2139
+ /**
2140
+ * <p>A filter for a specific executor state. A description of each state follows.</p>
2141
+ * <p>
2142
+ * <code>CREATING</code> - The executor is being started, including acquiring
2143
+ * resources.</p>
2144
+ * <p>
2145
+ * <code>CREATED</code> - The executor has been started.</p>
2146
+ * <p>
2147
+ * <code>REGISTERED</code> - The executor has been registered.</p>
2148
+ * <p>
2149
+ * <code>TERMINATING</code> - The executor is in the process of shutting down.</p>
2150
+ * <p>
2151
+ * <code>TERMINATED</code> - The executor is no longer running.</p>
2152
+ * <p>
2153
+ * <code>FAILED</code> - Due to a failure, the executor is no longer running.</p>
2154
+ */
2155
+ ExecutorStateFilter?: ExecutorState | string;
2156
+ /**
2157
+ * <p>The maximum number of executors to return.</p>
2158
+ */
2159
+ MaxResults?: number;
2160
+ /**
2161
+ * <p>A token generated by the Athena service that specifies where to continue
2162
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2163
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2164
+ */
2165
+ NextToken?: string;
2166
+ }
2167
+ export declare enum ExecutorType {
2168
+ COORDINATOR = "COORDINATOR",
2169
+ GATEWAY = "GATEWAY",
2170
+ WORKER = "WORKER"
2171
+ }
2172
+ /**
2173
+ * <p>Contains summary information about an executor.</p>
2174
+ */
2175
+ export interface ExecutorsSummary {
2176
+ /**
2177
+ * <p>The UUID of the executor.</p>
2178
+ */
2179
+ ExecutorId: string | undefined;
2180
+ /**
2181
+ * <p>The type of executor used for the application (<code>COORDINATOR</code>,
2182
+ * <code>GATEWAY</code>, or <code>WORKER</code>).</p>
2183
+ */
2184
+ ExecutorType?: ExecutorType | string;
2185
+ /**
2186
+ * <p>The date and time that the executor started.</p>
2187
+ */
2188
+ StartDateTime?: number;
2189
+ /**
2190
+ * <p>The date and time that the executor was terminated.</p>
2191
+ */
2192
+ TerminationDateTime?: number;
2193
+ /**
2194
+ * <p>The processing state of the executor. A description of each state follows.</p>
2195
+ * <p>
2196
+ * <code>CREATING</code> - The executor is being started, including acquiring
2197
+ * resources.</p>
2198
+ * <p>
2199
+ * <code>CREATED</code> - The executor has been started.</p>
2200
+ * <p>
2201
+ * <code>REGISTERED</code> - The executor has been registered.</p>
2202
+ * <p>
2203
+ * <code>TERMINATING</code> - The executor is in the process of shutting down.</p>
2204
+ * <p>
2205
+ * <code>TERMINATED</code> - The executor is no longer running.</p>
2206
+ * <p>
2207
+ * <code>FAILED</code> - Due to a failure, the executor is no longer running.</p>
2208
+ */
2209
+ ExecutorState?: ExecutorState | string;
2210
+ /**
2211
+ * <p>The smallest unit of compute that a session can request from Athena. Size
2212
+ * is measured in data processing unit (DPU) values, a relative measure of processing
2213
+ * power.</p>
2214
+ */
2215
+ ExecutorSize?: number;
2216
+ }
2217
+ export interface ListExecutorsResponse {
2218
+ /**
2219
+ * <p>The session ID.</p>
2220
+ */
2221
+ SessionId: string | undefined;
2222
+ /**
2223
+ * <p>A token generated by the Athena service that specifies where to continue
2224
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2225
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2226
+ */
2227
+ NextToken?: string;
2228
+ /**
2229
+ * <p>Contains summary information about the executor.</p>
2230
+ */
2231
+ ExecutorsSummary?: ExecutorsSummary[];
2232
+ }
1510
2233
  export interface ListNamedQueriesInput {
1511
2234
  /**
1512
2235
  * <p>A token generated by the Athena service that specifies where to continue
@@ -1537,6 +2260,87 @@ export interface ListNamedQueriesOutput {
1537
2260
  */
1538
2261
  NextToken?: string;
1539
2262
  }
2263
+ /**
2264
+ * <p>A string for searching notebook names.</p>
2265
+ */
2266
+ export interface FilterDefinition {
2267
+ /**
2268
+ * <p>The name of the notebook to search for.</p>
2269
+ */
2270
+ Name?: string;
2271
+ }
2272
+ export interface ListNotebookMetadataInput {
2273
+ /**
2274
+ * <p>Search filter string.</p>
2275
+ */
2276
+ Filters?: FilterDefinition;
2277
+ /**
2278
+ * <p>A token generated by the Athena service that specifies where to continue
2279
+ * pagination if a previous request was truncated.</p>
2280
+ */
2281
+ NextToken?: string;
2282
+ /**
2283
+ * <p>Specifies the maximum number of results to return.</p>
2284
+ */
2285
+ MaxResults?: number;
2286
+ /**
2287
+ * <p>The name of the Spark enabled workgroup to retrieve notebook metadata for.</p>
2288
+ */
2289
+ WorkGroup: string | undefined;
2290
+ }
2291
+ export interface ListNotebookMetadataOutput {
2292
+ /**
2293
+ * <p>A token generated by the Athena service that specifies where to continue
2294
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2295
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2296
+ */
2297
+ NextToken?: string;
2298
+ /**
2299
+ * <p>The list of notebook metadata for the specified workgroup.</p>
2300
+ */
2301
+ NotebookMetadataList?: NotebookMetadata[];
2302
+ }
2303
+ export interface ListNotebookSessionsRequest {
2304
+ /**
2305
+ * <p>The ID of the notebook to list sessions for.</p>
2306
+ */
2307
+ NotebookId: string | undefined;
2308
+ /**
2309
+ * <p>The maximum number of notebook sessions to return.</p>
2310
+ */
2311
+ MaxResults?: number;
2312
+ /**
2313
+ * <p>A token generated by the Athena service that specifies where to continue
2314
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2315
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2316
+ */
2317
+ NextToken?: string;
2318
+ }
2319
+ /**
2320
+ * <p>Contains the notebook session ID and notebook session creation time.</p>
2321
+ */
2322
+ export interface NotebookSessionSummary {
2323
+ /**
2324
+ * <p>The notebook session ID.</p>
2325
+ */
2326
+ SessionId?: string;
2327
+ /**
2328
+ * <p>The time when the notebook session was created.</p>
2329
+ */
2330
+ CreationTime?: Date;
2331
+ }
2332
+ export interface ListNotebookSessionsResponse {
2333
+ /**
2334
+ * <p>A list of the sessions belonging to the notebook.</p>
2335
+ */
2336
+ NotebookSessionsList: NotebookSessionSummary[] | undefined;
2337
+ /**
2338
+ * <p>A token generated by the Athena service that specifies where to continue
2339
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2340
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2341
+ */
2342
+ NextToken?: string;
2343
+ }
1540
2344
  export interface ListPreparedStatementsInput {
1541
2345
  /**
1542
2346
  * <p>The workgroup to list the prepared statements for.</p>
@@ -1606,6 +2410,83 @@ export interface ListQueryExecutionsOutput {
1606
2410
  */
1607
2411
  NextToken?: string;
1608
2412
  }
2413
+ export interface ListSessionsRequest {
2414
+ /**
2415
+ * <p>The workgroup to which the session belongs.</p>
2416
+ */
2417
+ WorkGroup: string | undefined;
2418
+ /**
2419
+ * <p>A filter for a specific session state. A description of each state follows.</p>
2420
+ * <p>
2421
+ * <code>CREATING</code> - The session is being started, including acquiring
2422
+ * resources.</p>
2423
+ * <p>
2424
+ * <code>CREATED</code> - The session has been started.</p>
2425
+ * <p>
2426
+ * <code>IDLE</code> - The session is able to accept a calculation.</p>
2427
+ * <p>
2428
+ * <code>BUSY</code> - The session is processing another task and is unable to accept a
2429
+ * calculation.</p>
2430
+ * <p>
2431
+ * <code>TERMINATING</code> - The session is in the process of shutting down.</p>
2432
+ * <p>
2433
+ * <code>TERMINATED</code> - The session and its resources are no longer running.</p>
2434
+ * <p>
2435
+ * <code>DEGRADED</code> - The session has no healthy coordinators.</p>
2436
+ * <p>
2437
+ * <code>FAILED</code> - Due to a failure, the session and its resources are no longer
2438
+ * running.</p>
2439
+ */
2440
+ StateFilter?: SessionState | string;
2441
+ /**
2442
+ * <p>The maximum number of sessions to return.</p>
2443
+ */
2444
+ MaxResults?: number;
2445
+ /**
2446
+ * <p>A token generated by the Athena service that specifies where to continue
2447
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2448
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2449
+ */
2450
+ NextToken?: string;
2451
+ }
2452
+ /**
2453
+ * <p>Contains summary information about a notebook session.</p>
2454
+ */
2455
+ export interface SessionSummary {
2456
+ /**
2457
+ * <p>The session ID.</p>
2458
+ */
2459
+ SessionId?: string;
2460
+ /**
2461
+ * <p>The session description.</p>
2462
+ */
2463
+ Description?: string;
2464
+ /**
2465
+ * <p>The engine version used by the session (for example, <code>PySpark engine version
2466
+ * 3</code>).</p>
2467
+ */
2468
+ EngineVersion?: EngineVersion;
2469
+ /**
2470
+ * <p>The notebook version.</p>
2471
+ */
2472
+ NotebookVersion?: string;
2473
+ /**
2474
+ * <p>Contains information about the session status.</p>
2475
+ */
2476
+ Status?: SessionStatus;
2477
+ }
2478
+ export interface ListSessionsResponse {
2479
+ /**
2480
+ * <p>A token generated by the Athena service that specifies where to continue
2481
+ * pagination if a previous request was truncated. To obtain the next set of pages, pass in
2482
+ * the <code>NextToken</code> from the response object of the previous page call.</p>
2483
+ */
2484
+ NextToken?: string;
2485
+ /**
2486
+ * <p>A list of sessions.</p>
2487
+ */
2488
+ Sessions?: SessionSummary[];
2489
+ }
1609
2490
  export interface ListTableMetadataInput {
1610
2491
  /**
1611
2492
  * <p>The name of the data catalog for which table metadata should be returned.</p>
@@ -1723,6 +2604,76 @@ export interface ListWorkGroupsOutput {
1723
2604
  */
1724
2605
  NextToken?: string;
1725
2606
  }
2607
+ /**
2608
+ * <p>Contains configuration information for the calculation.</p>
2609
+ */
2610
+ export interface CalculationConfiguration {
2611
+ /**
2612
+ * <p>A string that contains the code for the calculation.</p>
2613
+ */
2614
+ CodeBlock?: string;
2615
+ }
2616
+ export interface StartCalculationExecutionRequest {
2617
+ /**
2618
+ * <p>The session ID.</p>
2619
+ */
2620
+ SessionId: string | undefined;
2621
+ /**
2622
+ * <p>A description of the calculation.</p>
2623
+ */
2624
+ Description?: string;
2625
+ /**
2626
+ * @deprecated
2627
+ *
2628
+ * <p>Contains configuration information for the calculation.</p>
2629
+ */
2630
+ CalculationConfiguration?: CalculationConfiguration;
2631
+ /**
2632
+ * <p>A string that contains the code of the calculation.</p>
2633
+ */
2634
+ CodeBlock?: string;
2635
+ /**
2636
+ * <p>A unique case-sensitive string used to ensure the request to create the calculation is
2637
+ * idempotent (executes only once). If another
2638
+ * <code>StartCalculationExecutionRequest</code> is received, the same response is
2639
+ * returned and another calculation is not created. If a parameter has changed, an error is
2640
+ * returned.</p>
2641
+ * <important>
2642
+ * <p>This token is listed as not required because Amazon Web Services SDKs (for example
2643
+ * the Amazon Web Services SDK for Java) auto-generate the token for users. If you are
2644
+ * not using the Amazon Web Services SDK or the Amazon Web Services CLI, you must provide
2645
+ * this token or the action will fail.</p>
2646
+ * </important>
2647
+ */
2648
+ ClientRequestToken?: string;
2649
+ }
2650
+ export interface StartCalculationExecutionResponse {
2651
+ /**
2652
+ * <p>The calculation execution UUID.</p>
2653
+ */
2654
+ CalculationExecutionId?: string;
2655
+ /**
2656
+ * <p>
2657
+ * <code>CREATING</code> - The calculation is in the process of being created.</p>
2658
+ * <p>
2659
+ * <code>CREATED</code> - The calculation has been created and is ready to run.</p>
2660
+ * <p>
2661
+ * <code>QUEUED</code> - The calculation has been queued for processing.</p>
2662
+ * <p>
2663
+ * <code>RUNNING</code> - The calculation is running.</p>
2664
+ * <p>
2665
+ * <code>CANCELING</code> - A request to cancel the calculation has been received and the
2666
+ * system is working to stop it.</p>
2667
+ * <p>
2668
+ * <code>CANCELED</code> - The calculation is no longer running as the result of a cancel
2669
+ * request.</p>
2670
+ * <p>
2671
+ * <code>COMPLETED</code> - The calculation has completed without error.</p>
2672
+ * <p>
2673
+ * <code>FAILED</code> - The calculation failed and is no longer running.</p>
2674
+ */
2675
+ State?: CalculationExecutionState | string;
2676
+ }
1726
2677
  export interface StartQueryExecutionInput {
1727
2678
  /**
1728
2679
  * <p>The SQL query statements to be executed.</p>
@@ -1757,19 +2708,128 @@ export interface StartQueryExecutionInput {
1757
2708
  */
1758
2709
  WorkGroup?: string;
1759
2710
  /**
1760
- * <p>A list of values for the parameters in a query. The values are applied sequentially to the parameters in the query in the order in which the parameters occur.</p>
2711
+ * <p>A list of values for the parameters in a query. The values are applied sequentially to
2712
+ * the parameters in the query in the order in which the parameters occur.</p>
2713
+ */
2714
+ ExecutionParameters?: string[];
2715
+ /**
2716
+ * <p>Specifies the query result reuse behavior for the query.</p>
2717
+ */
2718
+ ResultReuseConfiguration?: ResultReuseConfiguration;
2719
+ }
2720
+ export interface StartQueryExecutionOutput {
2721
+ /**
2722
+ * <p>The unique ID of the query that ran as a result of this request.</p>
2723
+ */
2724
+ QueryExecutionId?: string;
2725
+ }
2726
+ /**
2727
+ * <p>The specified session already exists.</p>
2728
+ */
2729
+ export declare class SessionAlreadyExistsException extends __BaseException {
2730
+ readonly name: "SessionAlreadyExistsException";
2731
+ readonly $fault: "client";
2732
+ Message?: string;
2733
+ /**
2734
+ * @internal
2735
+ */
2736
+ constructor(opts: __ExceptionOptionType<SessionAlreadyExistsException, __BaseException>);
2737
+ }
2738
+ export interface StartSessionRequest {
2739
+ /**
2740
+ * <p>The session description.</p>
2741
+ */
2742
+ Description?: string;
2743
+ /**
2744
+ * <p>The workgroup to which the session belongs.</p>
2745
+ */
2746
+ WorkGroup: string | undefined;
2747
+ /**
2748
+ * <p>Contains engine data processing unit (DPU) configuration settings and parameter
2749
+ * mappings.</p>
2750
+ */
2751
+ EngineConfiguration: EngineConfiguration | undefined;
2752
+ /**
2753
+ * <p>The notebook version. This value is required only when requesting that a notebook
2754
+ * server be started for the session. The only valid notebook version is
2755
+ * <code>Jupyter1.0</code>.</p>
2756
+ */
2757
+ NotebookVersion?: string;
2758
+ /**
2759
+ * <p>The idle timeout in minutes for the session.</p>
2760
+ */
2761
+ SessionIdleTimeoutInMinutes?: number;
2762
+ /**
2763
+ * <p>A unique case-sensitive string used to ensure the request to create the session is
2764
+ * idempotent (executes only once). If another <code>StartSessionRequest</code> is
2765
+ * received, the same response is returned and another session is not created. If a
2766
+ * parameter has changed, an error is returned.</p>
2767
+ * <important>
2768
+ * <p>This token is listed as not required because Amazon Web Services SDKs (for example
2769
+ * the Amazon Web Services SDK for Java) auto-generate the token for users. If you are
2770
+ * not using the Amazon Web Services SDK or the Amazon Web Services CLI, you must provide
2771
+ * this token or the action will fail.</p>
2772
+ * </important>
2773
+ */
2774
+ ClientRequestToken?: string;
2775
+ }
2776
+ export interface StartSessionResponse {
2777
+ /**
2778
+ * <p>The session ID.</p>
2779
+ */
2780
+ SessionId?: string;
2781
+ /**
2782
+ * <p>The state of the session. A description of each state follows.</p>
2783
+ * <p>
2784
+ * <code>CREATING</code> - The session is being started, including acquiring
2785
+ * resources.</p>
2786
+ * <p>
2787
+ * <code>CREATED</code> - The session has been started.</p>
2788
+ * <p>
2789
+ * <code>IDLE</code> - The session is able to accept a calculation.</p>
2790
+ * <p>
2791
+ * <code>BUSY</code> - The session is processing another task and is unable to accept a
2792
+ * calculation.</p>
2793
+ * <p>
2794
+ * <code>TERMINATING</code> - The session is in the process of shutting down.</p>
2795
+ * <p>
2796
+ * <code>TERMINATED</code> - The session and its resources are no longer running.</p>
2797
+ * <p>
2798
+ * <code>DEGRADED</code> - The session has no healthy coordinators.</p>
2799
+ * <p>
2800
+ * <code>FAILED</code> - Due to a failure, the session and its resources are no longer
2801
+ * running.</p>
1761
2802
  */
1762
- ExecutionParameters?: string[];
2803
+ State?: SessionState | string;
2804
+ }
2805
+ export interface StopCalculationExecutionRequest {
1763
2806
  /**
1764
- * <p>Specifies the query result reuse behavior for the query.</p>
2807
+ * <p>The calculation execution UUID.</p>
1765
2808
  */
1766
- ResultReuseConfiguration?: ResultReuseConfiguration;
2809
+ CalculationExecutionId: string | undefined;
1767
2810
  }
1768
- export interface StartQueryExecutionOutput {
2811
+ export interface StopCalculationExecutionResponse {
1769
2812
  /**
1770
- * <p>The unique ID of the query that ran as a result of this request.</p>
2813
+ * <p>
2814
+ * <code>CREATING</code> - The calculation is in the process of being created.</p>
2815
+ * <p>
2816
+ * <code>CREATED</code> - The calculation has been created and is ready to run.</p>
2817
+ * <p>
2818
+ * <code>QUEUED</code> - The calculation has been queued for processing.</p>
2819
+ * <p>
2820
+ * <code>RUNNING</code> - The calculation is running.</p>
2821
+ * <p>
2822
+ * <code>CANCELING</code> - A request to cancel the calculation has been received and the
2823
+ * system is working to stop it.</p>
2824
+ * <p>
2825
+ * <code>CANCELED</code> - The calculation is no longer running as the result of a cancel
2826
+ * request.</p>
2827
+ * <p>
2828
+ * <code>COMPLETED</code> - The calculation has completed without error.</p>
2829
+ * <p>
2830
+ * <code>FAILED</code> - The calculation failed and is no longer running.</p>
1771
2831
  */
1772
- QueryExecutionId?: string;
2832
+ State?: CalculationExecutionState | string;
1773
2833
  }
1774
2834
  export interface StopQueryExecutionInput {
1775
2835
  /**
@@ -1792,6 +2852,37 @@ export interface TagResourceInput {
1792
2852
  }
1793
2853
  export interface TagResourceOutput {
1794
2854
  }
2855
+ export interface TerminateSessionRequest {
2856
+ /**
2857
+ * <p>The session ID.</p>
2858
+ */
2859
+ SessionId: string | undefined;
2860
+ }
2861
+ export interface TerminateSessionResponse {
2862
+ /**
2863
+ * <p>The state of the session. A description of each state follows.</p>
2864
+ * <p>
2865
+ * <code>CREATING</code> - The session is being started, including acquiring
2866
+ * resources.</p>
2867
+ * <p>
2868
+ * <code>CREATED</code> - The session has been started.</p>
2869
+ * <p>
2870
+ * <code>IDLE</code> - The session is able to accept a calculation.</p>
2871
+ * <p>
2872
+ * <code>BUSY</code> - The session is processing another task and is unable to accept a
2873
+ * calculation.</p>
2874
+ * <p>
2875
+ * <code>TERMINATING</code> - The session is in the process of shutting down.</p>
2876
+ * <p>
2877
+ * <code>TERMINATED</code> - The session and its resources are no longer running.</p>
2878
+ * <p>
2879
+ * <code>DEGRADED</code> - The session has no healthy coordinators.</p>
2880
+ * <p>
2881
+ * <code>FAILED</code> - Due to a failure, the session and its resources are no longer
2882
+ * running.</p>
2883
+ */
2884
+ State?: SessionState | string;
2885
+ }
1795
2886
  export interface UntagResourceInput {
1796
2887
  /**
1797
2888
  * <p>Specifies the ARN of the resource from which tags are to be removed.</p>
@@ -1888,6 +2979,61 @@ export interface UpdateNamedQueryInput {
1888
2979
  }
1889
2980
  export interface UpdateNamedQueryOutput {
1890
2981
  }
2982
+ export interface UpdateNotebookInput {
2983
+ /**
2984
+ * <p>The ID of the notebook to update.</p>
2985
+ */
2986
+ NotebookId: string | undefined;
2987
+ /**
2988
+ * <p>The updated content for the notebook.</p>
2989
+ */
2990
+ Payload?: string;
2991
+ /**
2992
+ * <p>The notebook content type. Currently, the only valid type is
2993
+ * <code>IPYNB</code>.</p>
2994
+ */
2995
+ Type?: NotebookType | string;
2996
+ /**
2997
+ * <p>The ID of the session in which the notebook will be updated.</p>
2998
+ */
2999
+ SessionId?: string;
3000
+ /**
3001
+ * <p>A unique case-sensitive string used to ensure the request to create the notebook is
3002
+ * idempotent (executes only once).</p>
3003
+ * <important>
3004
+ * <p>This token is listed as not required because Amazon Web Services SDKs (for example
3005
+ * the Amazon Web Services SDK for Java) auto-generate the token for you. If you are not
3006
+ * using the Amazon Web Services SDK or the Amazon Web Services CLI, you must provide
3007
+ * this token or the action will fail.</p>
3008
+ * </important>
3009
+ */
3010
+ ClientRequestToken?: string;
3011
+ }
3012
+ export interface UpdateNotebookOutput {
3013
+ }
3014
+ export interface UpdateNotebookMetadataInput {
3015
+ /**
3016
+ * <p>The ID of the notebook to update the metadata for.</p>
3017
+ */
3018
+ NotebookId: string | undefined;
3019
+ /**
3020
+ * <p>A unique case-sensitive string used to ensure the request to create the notebook is
3021
+ * idempotent (executes only once).</p>
3022
+ * <important>
3023
+ * <p>This token is listed as not required because Amazon Web Services SDKs (for example
3024
+ * the Amazon Web Services SDK for Java) auto-generate the token for you. If you are not
3025
+ * using the Amazon Web Services SDK or the Amazon Web Services CLI, you must provide
3026
+ * this token or the action will fail.</p>
3027
+ * </important>
3028
+ */
3029
+ ClientRequestToken?: string;
3030
+ /**
3031
+ * <p>The name to update the notebook to.</p>
3032
+ */
3033
+ Name: string | undefined;
3034
+ }
3035
+ export interface UpdateNotebookMetadataOutput {
3036
+ }
1891
3037
  export interface UpdatePreparedStatementInput {
1892
3038
  /**
1893
3039
  * <p>The name of the prepared statement.</p>
@@ -1956,7 +3102,6 @@ export interface ResultConfigurationUpdates {
1956
3102
  * <code>ExpectedBucketOwner</code>
1957
3103
  * Amazon Web Services account ID does not match the actual owner of the Amazon S3
1958
3104
  * bucket, the call fails with a permissions error.</p>
1959
- *
1960
3105
  * <p>If workgroup settings override client-side settings, then the query uses the
1961
3106
  * <code>ExpectedBucketOwner</code> setting that is specified for the workgroup, and
1962
3107
  * 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>
@@ -2036,6 +3181,22 @@ export interface WorkGroupConfigurationUpdates {
2036
3181
  * workgroup run on the preview engine regardless of this setting.</p>
2037
3182
  */
2038
3183
  EngineVersion?: EngineVersion;
3184
+ /**
3185
+ * <p>Removes content encryption configuration for a workgroup.</p>
3186
+ */
3187
+ RemoveCustomerContentEncryptionConfiguration?: boolean;
3188
+ /**
3189
+ * <p>Contains a user defined string in JSON format for a Spark-enabled workgroup.</p>
3190
+ */
3191
+ AdditionalConfiguration?: string;
3192
+ /**
3193
+ * <p>Contains the ARN of the execution role for the workgroup</p>
3194
+ */
3195
+ ExecutionRole?: string;
3196
+ /**
3197
+ * <p>Specifies the KMS key that is used to encrypt the user's data stores in Athena.</p>
3198
+ */
3199
+ CustomerContentEncryptionConfiguration?: CustomerContentEncryptionConfiguration;
2039
3200
  }
2040
3201
  export interface UpdateWorkGroupInput {
2041
3202
  /**
@@ -2047,7 +3208,7 @@ export interface UpdateWorkGroupInput {
2047
3208
  */
2048
3209
  Description?: string;
2049
3210
  /**
2050
- * <p>The workgroup configuration that will be updated for the given workgroup.</p>
3211
+ * <p>Contains configuration updates for an Athena SQL workgroup.</p>
2051
3212
  */
2052
3213
  ConfigurationUpdates?: WorkGroupConfigurationUpdates;
2053
3214
  /**
@@ -2062,8 +3223,8 @@ export interface UpdateWorkGroupOutput {
2062
3223
  */
2063
3224
  export interface QueryStagePlanNode {
2064
3225
  /**
2065
- * <p>Name of the query stage plan that describes the operation this stage is performing as part of
2066
- * query execution.</p>
3226
+ * <p>Name of the query stage plan that describes the operation this stage is performing as
3227
+ * part of query execution.</p>
2067
3228
  */
2068
3229
  Name?: string;
2069
3230
  /**
@@ -2071,7 +3232,8 @@ export interface QueryStagePlanNode {
2071
3232
  */
2072
3233
  Identifier?: string;
2073
3234
  /**
2074
- * <p>Stage plan information such as name, identifier, sub plans, and remote sources of child plan nodes/</p>
3235
+ * <p>Stage plan information such as name, identifier, sub plans, and remote sources of
3236
+ * child plan nodes/</p>
2075
3237
  */
2076
3238
  Children?: QueryStagePlanNode[];
2077
3239
  /**
@@ -2080,8 +3242,8 @@ export interface QueryStagePlanNode {
2080
3242
  RemoteSources?: string[];
2081
3243
  }
2082
3244
  /**
2083
- * <p>Stage statistics such as input and output rows and bytes, execution time and stage state. This
2084
- * information also includes substages and the query stage plan.</p>
3245
+ * <p>Stage statistics such as input and output rows and bytes, execution time and stage
3246
+ * state. This information also includes substages and the query stage plan.</p>
2085
3247
  */
2086
3248
  export interface QueryStage {
2087
3249
  /**
@@ -2122,23 +3284,23 @@ export interface QueryStage {
2122
3284
  SubStages?: QueryStage[];
2123
3285
  }
2124
3286
  /**
2125
- * <p>The query execution timeline, statistics on input and output rows and bytes, and the different
2126
- * query stages that form the query execution plan.</p>
3287
+ * <p>The query execution timeline, statistics on input and output rows and bytes, and the
3288
+ * different query stages that form the query execution plan.</p>
2127
3289
  */
2128
3290
  export interface QueryRuntimeStatistics {
2129
3291
  /**
2130
- * <p>Timeline statistics such as query queue time, planning time, execution time, service processing
2131
- * time, and total execution time.</p>
3292
+ * <p>Timeline statistics such as query queue time, planning time, execution time, service
3293
+ * processing time, and total execution time.</p>
2132
3294
  */
2133
3295
  Timeline?: QueryRuntimeStatisticsTimeline;
2134
3296
  /**
2135
- * <p>Statistics such as input rows and bytes read by the query, rows and bytes output by the query,
2136
- * and the number of rows written by the query.</p>
3297
+ * <p>Statistics such as input rows and bytes read by the query, rows and bytes output by
3298
+ * the query, and the number of rows written by the query.</p>
2137
3299
  */
2138
3300
  Rows?: QueryRuntimeStatisticsRows;
2139
3301
  /**
2140
- * <p>Stage statistics such as input and output rows and bytes, execution time, and stage state. This
2141
- * information also includes substages and the query stage plan.</p>
3302
+ * <p>Stage statistics such as input and output rows and bytes, execution time, and stage
3303
+ * state. This information also includes substages and the query stage plan.</p>
2142
3304
  */
2143
3305
  OutputStage?: QueryStage;
2144
3306
  }
@@ -2260,6 +3422,14 @@ export declare const CreateNamedQueryInputFilterSensitiveLog: (obj: CreateNamedQ
2260
3422
  * @internal
2261
3423
  */
2262
3424
  export declare const CreateNamedQueryOutputFilterSensitiveLog: (obj: CreateNamedQueryOutput) => any;
3425
+ /**
3426
+ * @internal
3427
+ */
3428
+ export declare const CreateNotebookInputFilterSensitiveLog: (obj: CreateNotebookInput) => any;
3429
+ /**
3430
+ * @internal
3431
+ */
3432
+ export declare const CreateNotebookOutputFilterSensitiveLog: (obj: CreateNotebookOutput) => any;
2263
3433
  /**
2264
3434
  * @internal
2265
3435
  */
@@ -2268,6 +3438,18 @@ export declare const CreatePreparedStatementInputFilterSensitiveLog: (obj: Creat
2268
3438
  * @internal
2269
3439
  */
2270
3440
  export declare const CreatePreparedStatementOutputFilterSensitiveLog: (obj: CreatePreparedStatementOutput) => any;
3441
+ /**
3442
+ * @internal
3443
+ */
3444
+ export declare const CreatePresignedNotebookUrlRequestFilterSensitiveLog: (obj: CreatePresignedNotebookUrlRequest) => any;
3445
+ /**
3446
+ * @internal
3447
+ */
3448
+ export declare const CreatePresignedNotebookUrlResponseFilterSensitiveLog: (obj: CreatePresignedNotebookUrlResponse) => any;
3449
+ /**
3450
+ * @internal
3451
+ */
3452
+ export declare const CustomerContentEncryptionConfigurationFilterSensitiveLog: (obj: CustomerContentEncryptionConfiguration) => any;
2271
3453
  /**
2272
3454
  * @internal
2273
3455
  */
@@ -2296,6 +3478,14 @@ export declare const DeleteNamedQueryInputFilterSensitiveLog: (obj: DeleteNamedQ
2296
3478
  * @internal
2297
3479
  */
2298
3480
  export declare const DeleteNamedQueryOutputFilterSensitiveLog: (obj: DeleteNamedQueryOutput) => any;
3481
+ /**
3482
+ * @internal
3483
+ */
3484
+ export declare const DeleteNotebookInputFilterSensitiveLog: (obj: DeleteNotebookInput) => any;
3485
+ /**
3486
+ * @internal
3487
+ */
3488
+ export declare const DeleteNotebookOutputFilterSensitiveLog: (obj: DeleteNotebookOutput) => any;
2299
3489
  /**
2300
3490
  * @internal
2301
3491
  */
@@ -2312,6 +3502,54 @@ export declare const DeleteWorkGroupInputFilterSensitiveLog: (obj: DeleteWorkGro
2312
3502
  * @internal
2313
3503
  */
2314
3504
  export declare const DeleteWorkGroupOutputFilterSensitiveLog: (obj: DeleteWorkGroupOutput) => any;
3505
+ /**
3506
+ * @internal
3507
+ */
3508
+ export declare const ExportNotebookInputFilterSensitiveLog: (obj: ExportNotebookInput) => any;
3509
+ /**
3510
+ * @internal
3511
+ */
3512
+ export declare const NotebookMetadataFilterSensitiveLog: (obj: NotebookMetadata) => any;
3513
+ /**
3514
+ * @internal
3515
+ */
3516
+ export declare const ExportNotebookOutputFilterSensitiveLog: (obj: ExportNotebookOutput) => any;
3517
+ /**
3518
+ * @internal
3519
+ */
3520
+ export declare const GetCalculationExecutionRequestFilterSensitiveLog: (obj: GetCalculationExecutionRequest) => any;
3521
+ /**
3522
+ * @internal
3523
+ */
3524
+ export declare const CalculationResultFilterSensitiveLog: (obj: CalculationResult) => any;
3525
+ /**
3526
+ * @internal
3527
+ */
3528
+ export declare const CalculationStatisticsFilterSensitiveLog: (obj: CalculationStatistics) => any;
3529
+ /**
3530
+ * @internal
3531
+ */
3532
+ export declare const CalculationStatusFilterSensitiveLog: (obj: CalculationStatus) => any;
3533
+ /**
3534
+ * @internal
3535
+ */
3536
+ export declare const GetCalculationExecutionResponseFilterSensitiveLog: (obj: GetCalculationExecutionResponse) => any;
3537
+ /**
3538
+ * @internal
3539
+ */
3540
+ export declare const GetCalculationExecutionCodeRequestFilterSensitiveLog: (obj: GetCalculationExecutionCodeRequest) => any;
3541
+ /**
3542
+ * @internal
3543
+ */
3544
+ export declare const GetCalculationExecutionCodeResponseFilterSensitiveLog: (obj: GetCalculationExecutionCodeResponse) => any;
3545
+ /**
3546
+ * @internal
3547
+ */
3548
+ export declare const GetCalculationExecutionStatusRequestFilterSensitiveLog: (obj: GetCalculationExecutionStatusRequest) => any;
3549
+ /**
3550
+ * @internal
3551
+ */
3552
+ export declare const GetCalculationExecutionStatusResponseFilterSensitiveLog: (obj: GetCalculationExecutionStatusResponse) => any;
2315
3553
  /**
2316
3554
  * @internal
2317
3555
  */
@@ -2344,6 +3582,14 @@ export declare const GetNamedQueryInputFilterSensitiveLog: (obj: GetNamedQueryIn
2344
3582
  * @internal
2345
3583
  */
2346
3584
  export declare const GetNamedQueryOutputFilterSensitiveLog: (obj: GetNamedQueryOutput) => any;
3585
+ /**
3586
+ * @internal
3587
+ */
3588
+ export declare const GetNotebookMetadataInputFilterSensitiveLog: (obj: GetNotebookMetadataInput) => any;
3589
+ /**
3590
+ * @internal
3591
+ */
3592
+ export declare const GetNotebookMetadataOutputFilterSensitiveLog: (obj: GetNotebookMetadataOutput) => any;
2347
3593
  /**
2348
3594
  * @internal
2349
3595
  */
@@ -2400,6 +3646,38 @@ export declare const QueryRuntimeStatisticsRowsFilterSensitiveLog: (obj: QueryRu
2400
3646
  * @internal
2401
3647
  */
2402
3648
  export declare const QueryRuntimeStatisticsTimelineFilterSensitiveLog: (obj: QueryRuntimeStatisticsTimeline) => any;
3649
+ /**
3650
+ * @internal
3651
+ */
3652
+ export declare const GetSessionRequestFilterSensitiveLog: (obj: GetSessionRequest) => any;
3653
+ /**
3654
+ * @internal
3655
+ */
3656
+ export declare const EngineConfigurationFilterSensitiveLog: (obj: EngineConfiguration) => any;
3657
+ /**
3658
+ * @internal
3659
+ */
3660
+ export declare const SessionConfigurationFilterSensitiveLog: (obj: SessionConfiguration) => any;
3661
+ /**
3662
+ * @internal
3663
+ */
3664
+ export declare const SessionStatisticsFilterSensitiveLog: (obj: SessionStatistics) => any;
3665
+ /**
3666
+ * @internal
3667
+ */
3668
+ export declare const SessionStatusFilterSensitiveLog: (obj: SessionStatus) => any;
3669
+ /**
3670
+ * @internal
3671
+ */
3672
+ export declare const GetSessionResponseFilterSensitiveLog: (obj: GetSessionResponse) => any;
3673
+ /**
3674
+ * @internal
3675
+ */
3676
+ export declare const GetSessionStatusRequestFilterSensitiveLog: (obj: GetSessionStatusRequest) => any;
3677
+ /**
3678
+ * @internal
3679
+ */
3680
+ export declare const GetSessionStatusResponseFilterSensitiveLog: (obj: GetSessionStatusResponse) => any;
2403
3681
  /**
2404
3682
  * @internal
2405
3683
  */
@@ -2428,6 +3706,38 @@ export declare const WorkGroupFilterSensitiveLog: (obj: WorkGroup) => any;
2428
3706
  * @internal
2429
3707
  */
2430
3708
  export declare const GetWorkGroupOutputFilterSensitiveLog: (obj: GetWorkGroupOutput) => any;
3709
+ /**
3710
+ * @internal
3711
+ */
3712
+ export declare const ImportNotebookInputFilterSensitiveLog: (obj: ImportNotebookInput) => any;
3713
+ /**
3714
+ * @internal
3715
+ */
3716
+ export declare const ImportNotebookOutputFilterSensitiveLog: (obj: ImportNotebookOutput) => any;
3717
+ /**
3718
+ * @internal
3719
+ */
3720
+ export declare const ListApplicationDPUSizesInputFilterSensitiveLog: (obj: ListApplicationDPUSizesInput) => any;
3721
+ /**
3722
+ * @internal
3723
+ */
3724
+ export declare const ApplicationDPUSizesFilterSensitiveLog: (obj: ApplicationDPUSizes) => any;
3725
+ /**
3726
+ * @internal
3727
+ */
3728
+ export declare const ListApplicationDPUSizesOutputFilterSensitiveLog: (obj: ListApplicationDPUSizesOutput) => any;
3729
+ /**
3730
+ * @internal
3731
+ */
3732
+ export declare const ListCalculationExecutionsRequestFilterSensitiveLog: (obj: ListCalculationExecutionsRequest) => any;
3733
+ /**
3734
+ * @internal
3735
+ */
3736
+ export declare const CalculationSummaryFilterSensitiveLog: (obj: CalculationSummary) => any;
3737
+ /**
3738
+ * @internal
3739
+ */
3740
+ export declare const ListCalculationExecutionsResponseFilterSensitiveLog: (obj: ListCalculationExecutionsResponse) => any;
2431
3741
  /**
2432
3742
  * @internal
2433
3743
  */
@@ -2456,6 +3766,18 @@ export declare const ListEngineVersionsInputFilterSensitiveLog: (obj: ListEngine
2456
3766
  * @internal
2457
3767
  */
2458
3768
  export declare const ListEngineVersionsOutputFilterSensitiveLog: (obj: ListEngineVersionsOutput) => any;
3769
+ /**
3770
+ * @internal
3771
+ */
3772
+ export declare const ListExecutorsRequestFilterSensitiveLog: (obj: ListExecutorsRequest) => any;
3773
+ /**
3774
+ * @internal
3775
+ */
3776
+ export declare const ExecutorsSummaryFilterSensitiveLog: (obj: ExecutorsSummary) => any;
3777
+ /**
3778
+ * @internal
3779
+ */
3780
+ export declare const ListExecutorsResponseFilterSensitiveLog: (obj: ListExecutorsResponse) => any;
2459
3781
  /**
2460
3782
  * @internal
2461
3783
  */
@@ -2464,6 +3786,30 @@ export declare const ListNamedQueriesInputFilterSensitiveLog: (obj: ListNamedQue
2464
3786
  * @internal
2465
3787
  */
2466
3788
  export declare const ListNamedQueriesOutputFilterSensitiveLog: (obj: ListNamedQueriesOutput) => any;
3789
+ /**
3790
+ * @internal
3791
+ */
3792
+ export declare const FilterDefinitionFilterSensitiveLog: (obj: FilterDefinition) => any;
3793
+ /**
3794
+ * @internal
3795
+ */
3796
+ export declare const ListNotebookMetadataInputFilterSensitiveLog: (obj: ListNotebookMetadataInput) => any;
3797
+ /**
3798
+ * @internal
3799
+ */
3800
+ export declare const ListNotebookMetadataOutputFilterSensitiveLog: (obj: ListNotebookMetadataOutput) => any;
3801
+ /**
3802
+ * @internal
3803
+ */
3804
+ export declare const ListNotebookSessionsRequestFilterSensitiveLog: (obj: ListNotebookSessionsRequest) => any;
3805
+ /**
3806
+ * @internal
3807
+ */
3808
+ export declare const NotebookSessionSummaryFilterSensitiveLog: (obj: NotebookSessionSummary) => any;
3809
+ /**
3810
+ * @internal
3811
+ */
3812
+ export declare const ListNotebookSessionsResponseFilterSensitiveLog: (obj: ListNotebookSessionsResponse) => any;
2467
3813
  /**
2468
3814
  * @internal
2469
3815
  */
@@ -2484,6 +3830,18 @@ export declare const ListQueryExecutionsInputFilterSensitiveLog: (obj: ListQuery
2484
3830
  * @internal
2485
3831
  */
2486
3832
  export declare const ListQueryExecutionsOutputFilterSensitiveLog: (obj: ListQueryExecutionsOutput) => any;
3833
+ /**
3834
+ * @internal
3835
+ */
3836
+ export declare const ListSessionsRequestFilterSensitiveLog: (obj: ListSessionsRequest) => any;
3837
+ /**
3838
+ * @internal
3839
+ */
3840
+ export declare const SessionSummaryFilterSensitiveLog: (obj: SessionSummary) => any;
3841
+ /**
3842
+ * @internal
3843
+ */
3844
+ export declare const ListSessionsResponseFilterSensitiveLog: (obj: ListSessionsResponse) => any;
2487
3845
  /**
2488
3846
  * @internal
2489
3847
  */
@@ -2512,6 +3870,18 @@ export declare const WorkGroupSummaryFilterSensitiveLog: (obj: WorkGroupSummary)
2512
3870
  * @internal
2513
3871
  */
2514
3872
  export declare const ListWorkGroupsOutputFilterSensitiveLog: (obj: ListWorkGroupsOutput) => any;
3873
+ /**
3874
+ * @internal
3875
+ */
3876
+ export declare const CalculationConfigurationFilterSensitiveLog: (obj: CalculationConfiguration) => any;
3877
+ /**
3878
+ * @internal
3879
+ */
3880
+ export declare const StartCalculationExecutionRequestFilterSensitiveLog: (obj: StartCalculationExecutionRequest) => any;
3881
+ /**
3882
+ * @internal
3883
+ */
3884
+ export declare const StartCalculationExecutionResponseFilterSensitiveLog: (obj: StartCalculationExecutionResponse) => any;
2515
3885
  /**
2516
3886
  * @internal
2517
3887
  */
@@ -2520,6 +3890,22 @@ export declare const StartQueryExecutionInputFilterSensitiveLog: (obj: StartQuer
2520
3890
  * @internal
2521
3891
  */
2522
3892
  export declare const StartQueryExecutionOutputFilterSensitiveLog: (obj: StartQueryExecutionOutput) => any;
3893
+ /**
3894
+ * @internal
3895
+ */
3896
+ export declare const StartSessionRequestFilterSensitiveLog: (obj: StartSessionRequest) => any;
3897
+ /**
3898
+ * @internal
3899
+ */
3900
+ export declare const StartSessionResponseFilterSensitiveLog: (obj: StartSessionResponse) => any;
3901
+ /**
3902
+ * @internal
3903
+ */
3904
+ export declare const StopCalculationExecutionRequestFilterSensitiveLog: (obj: StopCalculationExecutionRequest) => any;
3905
+ /**
3906
+ * @internal
3907
+ */
3908
+ export declare const StopCalculationExecutionResponseFilterSensitiveLog: (obj: StopCalculationExecutionResponse) => any;
2523
3909
  /**
2524
3910
  * @internal
2525
3911
  */
@@ -2536,6 +3922,14 @@ export declare const TagResourceInputFilterSensitiveLog: (obj: TagResourceInput)
2536
3922
  * @internal
2537
3923
  */
2538
3924
  export declare const TagResourceOutputFilterSensitiveLog: (obj: TagResourceOutput) => any;
3925
+ /**
3926
+ * @internal
3927
+ */
3928
+ export declare const TerminateSessionRequestFilterSensitiveLog: (obj: TerminateSessionRequest) => any;
3929
+ /**
3930
+ * @internal
3931
+ */
3932
+ export declare const TerminateSessionResponseFilterSensitiveLog: (obj: TerminateSessionResponse) => any;
2539
3933
  /**
2540
3934
  * @internal
2541
3935
  */
@@ -2560,6 +3954,22 @@ export declare const UpdateNamedQueryInputFilterSensitiveLog: (obj: UpdateNamedQ
2560
3954
  * @internal
2561
3955
  */
2562
3956
  export declare const UpdateNamedQueryOutputFilterSensitiveLog: (obj: UpdateNamedQueryOutput) => any;
3957
+ /**
3958
+ * @internal
3959
+ */
3960
+ export declare const UpdateNotebookInputFilterSensitiveLog: (obj: UpdateNotebookInput) => any;
3961
+ /**
3962
+ * @internal
3963
+ */
3964
+ export declare const UpdateNotebookOutputFilterSensitiveLog: (obj: UpdateNotebookOutput) => any;
3965
+ /**
3966
+ * @internal
3967
+ */
3968
+ export declare const UpdateNotebookMetadataInputFilterSensitiveLog: (obj: UpdateNotebookMetadataInput) => any;
3969
+ /**
3970
+ * @internal
3971
+ */
3972
+ export declare const UpdateNotebookMetadataOutputFilterSensitiveLog: (obj: UpdateNotebookMetadataOutput) => any;
2563
3973
  /**
2564
3974
  * @internal
2565
3975
  */