@aws-sdk/client-athena 3.817.0 → 3.822.0

package/dist-cjs/index.js

@@ -93,6 +93,7 @@ __export(index_exports, {
   NotebookType: () => NotebookType,
   PutCapacityAssignmentConfigurationCommand: () => PutCapacityAssignmentConfigurationCommand,
   QueryExecutionState: () => QueryExecutionState,
+  QueryResultType: () => QueryResultType,
   ResourceNotFoundException: () => ResourceNotFoundException,
   S3AclOption: () => S3AclOption,
   SessionAlreadyExistsException: () => SessionAlreadyExistsException,
@@ -517,6 +518,10 @@ var MetadataException = class _MetadataException extends AthenaServiceException
     this.Message = opts.Message;
   }
 };
+var QueryResultType = {
+  DATA_MANIFEST: "DATA_MANIFEST",
+  DATA_ROWS: "DATA_ROWS"
+};
 var ColumnNullable = {
   NOT_NULL: "NOT_NULL",
   NULLABLE: "NULLABLE",
@@ -2224,6 +2229,7 @@ var de_QueryExecution = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
     EngineVersion: import_smithy_client._json,
     ExecutionParameters: import_smithy_client._json,
+    ManagedQueryResultsConfiguration: import_smithy_client._json,
     Query: import_smithy_client.expectString,
     QueryExecutionContext: import_smithy_client._json,
     QueryExecutionId: import_smithy_client.expectString,
@@ -3656,6 +3662,7 @@ var paginateListWorkGroups = (0, import_core.createPaginator)(AthenaClient, List
   CapacityAllocationStatus,
   CapacityReservationStatus,
   MetadataException,
+  QueryResultType,
   ColumnNullable,
   SessionState,
   WorkGroupState,

package/dist-es/models/models_0.js

@@ -166,6 +166,10 @@ export class MetadataException extends __BaseException {
         this.Message = opts.Message;
     }
 }
+export const QueryResultType = {
+    DATA_MANIFEST: "DATA_MANIFEST",
+    DATA_ROWS: "DATA_ROWS",
+};
 export const ColumnNullable = {
     NOT_NULL: "NOT_NULL",
     NULLABLE: "NULLABLE",

package/dist-es/protocols/Aws_json1_1.js

@@ -1669,6 +1669,7 @@ const de_QueryExecution = (output, context) => {
     return take(output, {
         EngineVersion: _json,
         ExecutionParameters: _json,
+        ManagedQueryResultsConfiguration: _json,
         Query: __expectString,
         QueryExecutionContext: _json,
         QueryExecutionId: __expectString,

package/dist-types/commands/BatchGetQueryExecutionCommand.d.ts

@@ -52,6 +52,12 @@ declare const BatchGetQueryExecutionCommand_base: {
  * //       QueryExecutionId: "STRING_VALUE",
  * //       Query: "STRING_VALUE",
  * //       StatementType: "DDL" || "DML" || "UTILITY",
+ * //       ManagedQueryResultsConfiguration: { // ManagedQueryResultsConfiguration
+ * //         Enabled: true || false, // required
+ * //         EncryptionConfiguration: { // ManagedQueryResultsEncryptionConfiguration
+ * //           KmsKey: "STRING_VALUE", // required
+ * //         },
+ * //       },
  * //       ResultConfiguration: { // ResultConfiguration
  * //         OutputLocation: "STRING_VALUE",
  * //         EncryptionConfiguration: { // EncryptionConfiguration

package/dist-types/commands/CreateWorkGroupCommand.d.ts

@@ -49,6 +49,12 @@ declare const CreateWorkGroupCommand_base: {
  *         S3AclOption: "BUCKET_OWNER_FULL_CONTROL", // required
  *       },
  *     },
+ *     ManagedQueryResultsConfiguration: { // ManagedQueryResultsConfiguration
+ *       Enabled: true || false, // required
+ *       EncryptionConfiguration: { // ManagedQueryResultsEncryptionConfiguration
+ *         KmsKey: "STRING_VALUE", // required
+ *       },
+ *     },
  *     EnforceWorkGroupConfiguration: true || false,
  *     PublishCloudWatchMetricsEnabled: true || false,
  *     BytesScannedCutoffPerQuery: Number("long"),

package/dist-types/commands/GetQueryExecutionCommand.d.ts

@@ -46,6 +46,12 @@ declare const GetQueryExecutionCommand_base: {
  * //     QueryExecutionId: "STRING_VALUE",
  * //     Query: "STRING_VALUE",
  * //     StatementType: "DDL" || "DML" || "UTILITY",
+ * //     ManagedQueryResultsConfiguration: { // ManagedQueryResultsConfiguration
+ * //       Enabled: true || false, // required
+ * //       EncryptionConfiguration: { // ManagedQueryResultsEncryptionConfiguration
+ * //         KmsKey: "STRING_VALUE", // required
+ * //       },
+ * //     },
  * //     ResultConfiguration: { // ResultConfiguration
  * //       OutputLocation: "STRING_VALUE",
  * //       EncryptionConfiguration: { // EncryptionConfiguration

package/dist-types/commands/GetQueryResultsCommand.d.ts

@@ -53,6 +53,7 @@ declare const GetQueryResultsCommand_base: {
  *   QueryExecutionId: "STRING_VALUE", // required
  *   NextToken: "STRING_VALUE",
  *   MaxResults: Number("int"),
+ *   QueryResultType: "DATA_MANIFEST" || "DATA_ROWS",
  * };
  * const command = new GetQueryResultsCommand(input);
  * const response = await client.send(command);

package/dist-types/commands/GetWorkGroupCommand.d.ts

@@ -55,6 +55,12 @@ declare const GetWorkGroupCommand_base: {
  * //           S3AclOption: "BUCKET_OWNER_FULL_CONTROL", // required
  * //         },
  * //       },
+ * //       ManagedQueryResultsConfiguration: { // ManagedQueryResultsConfiguration
+ * //         Enabled: true || false, // required
+ * //         EncryptionConfiguration: { // ManagedQueryResultsEncryptionConfiguration
+ * //           KmsKey: "STRING_VALUE", // required
+ * //         },
+ * //       },
  * //       EnforceWorkGroupConfiguration: true || false,
  * //       PublishCloudWatchMetricsEnabled: true || false,
  * //       BytesScannedCutoffPerQuery: Number("long"),

package/dist-types/commands/UpdateWorkGroupCommand.d.ts

@@ -55,6 +55,13 @@ declare const UpdateWorkGroupCommand_base: {
  *       },
  *       RemoveAclConfiguration: true || false,
  *     },
+ *     ManagedQueryResultsConfigurationUpdates: { // ManagedQueryResultsConfigurationUpdates
+ *       Enabled: true || false,
+ *       EncryptionConfiguration: { // ManagedQueryResultsEncryptionConfiguration
+ *         KmsKey: "STRING_VALUE", // required
+ *       },
+ *       RemoveEncryptionConfiguration: true || false,
+ *     },
  *     PublishCloudWatchMetricsEnabled: true || false,
  *     BytesScannedCutoffPerQuery: Number("long"),
  *     RemoveBytesScannedCutoffPerQuery: true || false,

package/dist-types/models/models_0.d.ts

@@ -288,6 +288,43 @@ export interface EngineVersion {
      */
     EffectiveEngineVersion?: string | undefined;
 }
+/**
+ * <p>If you encrypt query and calculation results in Athena owned storage, this field
+ *             indicates the encryption option (for example, SSE_KMS or CSE_KMS) and key
+ *             information.</p>
+ * @public
+ */
+export interface ManagedQueryResultsEncryptionConfiguration {
+    /**
+     * <p>The ARN of an KMS key for encrypting managed query results.</p>
+     * @public
+     */
+    KmsKey: string | undefined;
+}
+/**
+ * <p>
+ *             The configuration for storing results in Athena owned storage, which includes whether this feature is enabled; whether encryption configuration, if any, is used for encrypting query results.
+ *         </p>
+ * @public
+ */
+export interface ManagedQueryResultsConfiguration {
+    /**
+     * <p>If set to true, allows you to store query results in Athena owned storage. If set to
+     *             false, workgroup member stores query results in location specified under
+     *                 <code>ResultConfiguration$OutputLocation</code>. The default is false. A workgroup
+     *             cannot have the <code>ResultConfiguration$OutputLocation</code> parameter when you set
+     *             this field to true. </p>
+     * @public
+     */
+    Enabled: boolean | undefined;
+    /**
+     * <p>If you encrypt query and calculation results in Athena owned storage, this field
+     *             indicates the encryption option (for example, SSE_KMS or CSE_KMS) and key
+     *             information.</p>
+     * @public
+     */
+    EncryptionConfiguration?: ManagedQueryResultsEncryptionConfiguration | undefined;
+}
 /**
  * <p>The database and data catalog context in which the query execution occurs.</p>
  * @public
@@ -672,11 +709,18 @@ export interface QueryExecution {
      * <p>The type of query statement that was run. <code>DDL</code> indicates DDL query
      *             statements. <code>DML</code> indicates DML (Data Manipulation Language) query
      *             statements, such as <code>CREATE TABLE AS SELECT</code>. <code>UTILITY</code> indicates
-     *             query statements other than DDL and DML, such as <code>SHOW CREATE TABLE</code>,
-     *                 <code>EXPLAIN</code>, <code>DESCRIBE</code>, or <code>SHOW TABLES</code>.</p>
+     *             query statements other than DDL and DML, such as <code>SHOW CREATE TABLE</code>, or
+     *                 <code>DESCRIBE TABLE</code>.</p>
      * @public
      */
     StatementType?: StatementType | undefined;
+    /**
+     * <p> The configuration for storing results in Athena owned storage, which includes whether
+     *             this feature is enabled; whether encryption configuration, if any, is used for
+     *             encrypting query results. </p>
+     * @public
+     */
+    ManagedQueryResultsConfiguration?: ManagedQueryResultsConfiguration | undefined;
     /**
      * <p>The location in Amazon S3 where query and calculation results are stored and
      *             the encryption option, if any, used for query results. These are known as "client-side
@@ -1518,6 +1562,13 @@ export interface WorkGroupConfiguration {
      * @public
      */
     ResultConfiguration?: ResultConfiguration | undefined;
+    /**
+     * <p> The configuration for storing results in Athena owned storage, which includes whether
+     *             this feature is enabled; whether encryption configuration, if any, is used for
+     *             encrypting query results. </p>
+     * @public
+     */
+    ManagedQueryResultsConfiguration?: ManagedQueryResultsConfiguration | undefined;
     /**
      * <p>If set to "true", the settings for the workgroup override client-side settings. If set
      *             to "false", client-side settings are used. 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>
@@ -2382,6 +2433,18 @@ export interface GetQueryExecutionOutput {
      */
     QueryExecution?: QueryExecution | undefined;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const QueryResultType: {
+    readonly DATA_MANIFEST: "DATA_MANIFEST";
+    readonly DATA_ROWS: "DATA_ROWS";
+};
+/**
+ * @public
+ */
+export type QueryResultType = (typeof QueryResultType)[keyof typeof QueryResultType];
 /**
  * @public
  */
@@ -2403,6 +2466,15 @@ export interface GetQueryResultsInput {
      * @public
      */
     MaxResults?: number | undefined;
+    /**
+     * <p> When you set this to <code>DATA_ROWS</code> or empty, <code>GetQueryResults</code>
+     *             returns the query results in rows. If set to <code>DATA_MANIFEST</code>, it returns the
+     *             manifest file in rows. Only the query types <code>CREATE TABLE AS SELECT</code>,
+     *                 <code>UNLOAD</code>, and <code>INSERT</code> can generate a manifest file. If you
+     *             use <code>DATA_MANIFEST</code> for other query types, the query will fail. </p>
+     * @public
+     */
+    QueryResultType?: QueryResultType | undefined;
 }
 /**
  * @public
@@ -4771,6 +4843,32 @@ export interface UpdatePreparedStatementInput {
  */
 export interface UpdatePreparedStatementOutput {
 }
+/**
+ * <p>Updates the configuration for managed query results.</p>
+ * @public
+ */
+export interface ManagedQueryResultsConfigurationUpdates {
+    /**
+     * <p>If set to true, specifies that Athena manages query results in Athena owned
+     *             storage.</p>
+     * @public
+     */
+    Enabled?: boolean | undefined;
+    /**
+     * <p>If you encrypt query and calculation results in Athena owned storage, this field
+     *             indicates the encryption option (for example, SSE_KMS or CSE_KMS) and key
+     *             information.</p>
+     * @public
+     */
+    EncryptionConfiguration?: ManagedQueryResultsEncryptionConfiguration | undefined;
+    /**
+     * <p>If set to true, it removes workgroup from Athena owned storage. The existing query
+     *             results are cleaned up after 24hrs. You must provide query results in location specified
+     *             under <code>ResultConfiguration$OutputLocation</code>.</p>
+     * @public
+     */
+    RemoveEncryptionConfiguration?: boolean | undefined;
+}
 /**
  * <p>The information about the updates in the query results, such as output location and
  *             encryption configuration for the query results.</p>
@@ -4880,6 +4978,11 @@ export interface WorkGroupConfigurationUpdates {
      * @public
      */
     ResultConfigurationUpdates?: ResultConfigurationUpdates | undefined;
+    /**
+     * <p>Updates configuration information for managed query results in the workgroup.</p>
+     * @public
+     */
+    ManagedQueryResultsConfigurationUpdates?: ManagedQueryResultsConfigurationUpdates | undefined;
     /**
      * <p>Indicates whether this workgroup enables publishing metrics to Amazon CloudWatch.</p>
      * @public

package/dist-types/ts3.4/models/models_0.d.ts

@@ -73,6 +73,15 @@ export interface EngineVersion {
   SelectedEngineVersion?: string | undefined;
   EffectiveEngineVersion?: string | undefined;
 }
+export interface ManagedQueryResultsEncryptionConfiguration {
+  KmsKey: string | undefined;
+}
+export interface ManagedQueryResultsConfiguration {
+  Enabled: boolean | undefined;
+  EncryptionConfiguration?:
+    | ManagedQueryResultsEncryptionConfiguration
+    | undefined;
+}
 export interface QueryExecutionContext {
   Database?: string | undefined;
   Catalog?: string | undefined;
@@ -157,6 +166,9 @@ export interface QueryExecution {
   QueryExecutionId?: string | undefined;
   Query?: string | undefined;
   StatementType?: StatementType | undefined;
+  ManagedQueryResultsConfiguration?:
+    | ManagedQueryResultsConfiguration
+    | undefined;
   ResultConfiguration?: ResultConfiguration | undefined;
   ResultReuseConfiguration?: ResultReuseConfiguration | undefined;
   QueryExecutionContext?: QueryExecutionContext | undefined;
@@ -323,6 +335,9 @@ export interface IdentityCenterConfiguration {
 }
 export interface WorkGroupConfiguration {
   ResultConfiguration?: ResultConfiguration | undefined;
+  ManagedQueryResultsConfiguration?:
+    | ManagedQueryResultsConfiguration
+    | undefined;
   EnforceWorkGroupConfiguration?: boolean | undefined;
   PublishCloudWatchMetricsEnabled?: boolean | undefined;
   BytesScannedCutoffPerQuery?: number | undefined;
@@ -549,10 +564,17 @@ export interface GetQueryExecutionInput {
 export interface GetQueryExecutionOutput {
   QueryExecution?: QueryExecution | undefined;
 }
+export declare const QueryResultType: {
+  readonly DATA_MANIFEST: "DATA_MANIFEST";
+  readonly DATA_ROWS: "DATA_ROWS";
+};
+export type QueryResultType =
+  (typeof QueryResultType)[keyof typeof QueryResultType];
 export interface GetQueryResultsInput {
   QueryExecutionId: string | undefined;
   NextToken?: string | undefined;
   MaxResults?: number | undefined;
+  QueryResultType?: QueryResultType | undefined;
 }
 export declare const ColumnNullable: {
   readonly NOT_NULL: "NOT_NULL";
@@ -1049,6 +1071,13 @@ export interface UpdatePreparedStatementInput {
   Description?: string | undefined;
 }
 export interface UpdatePreparedStatementOutput {}
+export interface ManagedQueryResultsConfigurationUpdates {
+  Enabled?: boolean | undefined;
+  EncryptionConfiguration?:
+    | ManagedQueryResultsEncryptionConfiguration
+    | undefined;
+  RemoveEncryptionConfiguration?: boolean | undefined;
+}
 export interface ResultConfigurationUpdates {
   OutputLocation?: string | undefined;
   RemoveOutputLocation?: boolean | undefined;
@@ -1062,6 +1091,9 @@ export interface ResultConfigurationUpdates {
 export interface WorkGroupConfigurationUpdates {
   EnforceWorkGroupConfiguration?: boolean | undefined;
   ResultConfigurationUpdates?: ResultConfigurationUpdates | undefined;
+  ManagedQueryResultsConfigurationUpdates?:
+    | ManagedQueryResultsConfigurationUpdates
+    | undefined;
   PublishCloudWatchMetricsEnabled?: boolean | undefined;
   BytesScannedCutoffPerQuery?: number | undefined;
   RemoveBytesScannedCutoffPerQuery?: boolean | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-athena",
   "description": "AWS SDK for JavaScript Athena Client for Node.js, Browser and React Native",
-  "version": "3.817.0",
+  "version": "3.822.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-athena",
@@ -20,41 +20,41 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/core": "3.816.0",
-    "@aws-sdk/credential-provider-node": "3.817.0",
-    "@aws-sdk/middleware-host-header": "3.804.0",
-    "@aws-sdk/middleware-logger": "3.804.0",
-    "@aws-sdk/middleware-recursion-detection": "3.804.0",
-    "@aws-sdk/middleware-user-agent": "3.816.0",
-    "@aws-sdk/region-config-resolver": "3.808.0",
-    "@aws-sdk/types": "3.804.0",
-    "@aws-sdk/util-endpoints": "3.808.0",
-    "@aws-sdk/util-user-agent-browser": "3.804.0",
-    "@aws-sdk/util-user-agent-node": "3.816.0",
-    "@smithy/config-resolver": "^4.1.2",
-    "@smithy/core": "^3.3.3",
-    "@smithy/fetch-http-handler": "^5.0.2",
-    "@smithy/hash-node": "^4.0.2",
-    "@smithy/invalid-dependency": "^4.0.2",
-    "@smithy/middleware-content-length": "^4.0.2",
-    "@smithy/middleware-endpoint": "^4.1.6",
-    "@smithy/middleware-retry": "^4.1.7",
-    "@smithy/middleware-serde": "^4.0.5",
-    "@smithy/middleware-stack": "^4.0.2",
-    "@smithy/node-config-provider": "^4.1.1",
-    "@smithy/node-http-handler": "^4.0.4",
-    "@smithy/protocol-http": "^5.1.0",
-    "@smithy/smithy-client": "^4.2.6",
-    "@smithy/types": "^4.2.0",
-    "@smithy/url-parser": "^4.0.2",
+    "@aws-sdk/core": "3.821.0",
+    "@aws-sdk/credential-provider-node": "3.821.0",
+    "@aws-sdk/middleware-host-header": "3.821.0",
+    "@aws-sdk/middleware-logger": "3.821.0",
+    "@aws-sdk/middleware-recursion-detection": "3.821.0",
+    "@aws-sdk/middleware-user-agent": "3.821.0",
+    "@aws-sdk/region-config-resolver": "3.821.0",
+    "@aws-sdk/types": "3.821.0",
+    "@aws-sdk/util-endpoints": "3.821.0",
+    "@aws-sdk/util-user-agent-browser": "3.821.0",
+    "@aws-sdk/util-user-agent-node": "3.821.0",
+    "@smithy/config-resolver": "^4.1.4",
+    "@smithy/core": "^3.5.1",
+    "@smithy/fetch-http-handler": "^5.0.4",
+    "@smithy/hash-node": "^4.0.4",
+    "@smithy/invalid-dependency": "^4.0.4",
+    "@smithy/middleware-content-length": "^4.0.4",
+    "@smithy/middleware-endpoint": "^4.1.9",
+    "@smithy/middleware-retry": "^4.1.10",
+    "@smithy/middleware-serde": "^4.0.8",
+    "@smithy/middleware-stack": "^4.0.4",
+    "@smithy/node-config-provider": "^4.1.3",
+    "@smithy/node-http-handler": "^4.0.6",
+    "@smithy/protocol-http": "^5.1.2",
+    "@smithy/smithy-client": "^4.4.1",
+    "@smithy/types": "^4.3.1",
+    "@smithy/url-parser": "^4.0.4",
     "@smithy/util-base64": "^4.0.0",
     "@smithy/util-body-length-browser": "^4.0.0",
     "@smithy/util-body-length-node": "^4.0.0",
-    "@smithy/util-defaults-mode-browser": "^4.0.14",
-    "@smithy/util-defaults-mode-node": "^4.0.14",
-    "@smithy/util-endpoints": "^3.0.4",
-    "@smithy/util-middleware": "^4.0.2",
-    "@smithy/util-retry": "^4.0.3",
+    "@smithy/util-defaults-mode-browser": "^4.0.17",
+    "@smithy/util-defaults-mode-node": "^4.0.17",
+    "@smithy/util-endpoints": "^3.0.6",
+    "@smithy/util-middleware": "^4.0.4",
+    "@smithy/util-retry": "^4.0.5",
     "@smithy/util-utf8": "^4.0.0",
     "@types/uuid": "^9.0.1",
     "tslib": "^2.6.2",