# frozen_string_literal: true # WARNING ABOUT GENERATED CODE # # This file is generated. See the contributing guide for more information: # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md # # WARNING ABOUT GENERATED CODE module Aws::RedshiftDataAPIService module Types # The Amazon Redshift Data API operation failed because the maximum # number of active sessions exceeded. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ActiveSessionsExceededException AWS API Documentation # class ActiveSessionsExceededException < Struct.new( :message) SENSITIVE = [] include Aws::Structure end # The number of active statements exceeds the limit. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ActiveStatementsExceededException AWS API Documentation # class ActiveStatementsExceededException < Struct.new( :message) SENSITIVE = [] include Aws::Structure end # An SQL statement encountered an environmental error while running. # # @!attribute [rw] message # @return [String] # # @!attribute [rw] statement_id # Statement identifier of the exception. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/BatchExecuteStatementException AWS API Documentation # class BatchExecuteStatementException < Struct.new( :message, :statement_id) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] client_token # A unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option. # @return [String] # # @!attribute [rw] cluster_identifier # The cluster identifier. This parameter is required when connecting # to a cluster and authenticating using either Secrets Manager or # temporary credentials. # @return [String] # # @!attribute [rw] database # The name of the database. This parameter is required when # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @!attribute [rw] db_user # The database user name. This parameter is required when connecting # to a cluster as a database user and authenticating using temporary # credentials. # @return [String] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # This parameter is required when authenticating using Secrets # Manager. # @return [String] # # @!attribute [rw] session_id # The session identifier of the query. # @return [String] # # @!attribute [rw] session_keep_alive_seconds # The number of seconds to keep the session alive after the query # finishes. The maximum time a session can keep alive is 24 hours. # After 24 hours, the session is forced closed and the query is # terminated. # @return [Integer] # # @!attribute [rw] sqls # One or more SQL statements to run. The SQL statements are run # as a single transaction. They run serially in the order of the # array. Subsequent SQL statements don't start until the previous # statement in the array completes. If any SQL statement fails, then # because they are run as one transaction, all work is rolled # back.

# @return [Array] # # @!attribute [rw] statement_name # The name of the SQL statements. You can name the SQL statements when # you create them to identify the query. # @return [String] # # @!attribute [rw] with_event # A value that indicates whether to send an event to the Amazon # EventBridge event bus after the SQL statements run. # @return [Boolean] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # parameter is required when connecting to a serverless workgroup and # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/BatchExecuteStatementInput AWS API Documentation # class BatchExecuteStatementInput < Struct.new( :client_token, :cluster_identifier, :database, :db_user, :secret_arn, :session_id, :session_keep_alive_seconds, :sqls, :statement_name, :with_event, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] cluster_identifier # The cluster identifier. This element is not returned when connecting # to a serverless workgroup. # @return [String] # # @!attribute [rw] created_at # The date and time (UTC) the statement was created. # @return [Time] # # @!attribute [rw] database # The name of the database. # @return [String] # # @!attribute [rw] db_groups # A list of colon (:) separated names of database groups. # @return [Array] # # @!attribute [rw] db_user # The database user name. # @return [String] # # @!attribute [rw] id # The identifier of the SQL statement whose results are to be fetched. # This value is a universally unique identifier (UUID) generated by # Amazon Redshift Data API. This identifier is returned by # `BatchExecuteStatment`. # @return [String] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # @return [String] # # @!attribute [rw] session_id # The session identifier of the query. # @return [String] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # element is not returned when connecting to a provisioned cluster. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/BatchExecuteStatementOutput AWS API Documentation # class BatchExecuteStatementOutput < Struct.new( :cluster_identifier, :created_at, :database, :db_groups, :db_user, :id, :secret_arn, :session_id, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] id # The identifier of the SQL statement to cancel. This value is a # universally unique identifier (UUID) generated by Amazon Redshift # Data API. This identifier is returned by `BatchExecuteStatment`, # `ExecuteStatment`, and `ListStatements`. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/CancelStatementRequest AWS API Documentation # class CancelStatementRequest < Struct.new( :id) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] status # A value that indicates whether the cancel statement succeeded # (true). # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/CancelStatementResponse AWS API Documentation # class CancelStatementResponse < Struct.new( :status) SENSITIVE = [] include Aws::Structure end # The properties (metadata) of a column. # # @!attribute [rw] column_default # The default value of the column. # @return [String] # # @!attribute [rw] is_case_sensitive # A value that indicates whether the column is case-sensitive. # @return [Boolean] # # @!attribute [rw] is_currency # A value that indicates whether the column contains currency values. # @return [Boolean] # # @!attribute [rw] is_signed # A value that indicates whether an integer column is signed. # @return [Boolean] # # @!attribute [rw] label # The label for the column. # @return [String] # # @!attribute [rw] length # The length of the column. # @return [Integer] # # @!attribute [rw] name # The name of the column. # @return [String] # # @!attribute [rw] nullable # A value that indicates whether the column is nullable. # @return [Integer] # # @!attribute [rw] precision # The precision value of a decimal number column. # @return [Integer] # # @!attribute [rw] scale # The scale value of a decimal number column. # @return [Integer] # # @!attribute [rw] schema_name # The name of the schema that contains the table that includes the # column. # @return [String] # # @!attribute [rw] table_name # The name of the table that includes the column. # @return [String] # # @!attribute [rw] type_name # The database-specific data type of the column. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ColumnMetadata AWS API Documentation # class ColumnMetadata < Struct.new( :column_default, :is_case_sensitive, :is_currency, :is_signed, :label, :length, :name, :nullable, :precision, :scale, :schema_name, :table_name, :type_name) SENSITIVE = [] include Aws::Structure end # Connection to a database failed. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/DatabaseConnectionException AWS API Documentation # class DatabaseConnectionException < Struct.new( :message) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] id # The identifier of the SQL statement to describe. This value is a # universally unique identifier (UUID) generated by Amazon Redshift # Data API. A suffix indicates the number of the SQL statement. For # example, `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has a suffix of # `:2` that indicates the second SQL statement of a batch query. This # identifier is returned by `BatchExecuteStatment`, # `ExecuteStatement`, and `ListStatements`. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/DescribeStatementRequest AWS API Documentation # class DescribeStatementRequest < Struct.new( :id) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] cluster_identifier # The cluster identifier. # @return [String] # # @!attribute [rw] created_at # The date and time (UTC) when the SQL statement was submitted to run. # @return [Time] # # @!attribute [rw] database # The name of the database. # @return [String] # # @!attribute [rw] db_user # The database user name. # @return [String] # # @!attribute [rw] duration # The amount of time in nanoseconds that the statement ran. # @return [Integer] # # @!attribute [rw] error # The error message from the cluster if the SQL statement encountered # an error while running. # @return [String] # # @!attribute [rw] has_result_set # A value that indicates whether the statement has a result set. The # result set can be empty. The value is true for an empty result set. # The value is true if any substatement returns a result set. # @return [Boolean] # # @!attribute [rw] id # The identifier of the SQL statement described. This value is a # universally unique identifier (UUID) generated by Amazon Redshift # Data API. # @return [String] # # @!attribute [rw] query_parameters # The parameters for the SQL statement. # @return [Array] # # @!attribute [rw] query_string # The SQL statement text. # @return [String] # # @!attribute [rw] redshift_pid # The process identifier from Amazon Redshift. # @return [Integer] # # @!attribute [rw] redshift_query_id # The identifier of the query generated by Amazon Redshift. These # identifiers are also available in the `query` column of the # `STL_QUERY` system view. # @return [Integer] # # @!attribute [rw] result_rows # Either the number of rows returned from the SQL statement or the # number of rows affected. If result size is greater than zero, the # result rows can be the number of rows affected by SQL statements # such as INSERT, UPDATE, DELETE, COPY, and others. A `-1` indicates # the value is null. # @return [Integer] # # @!attribute [rw] result_size # The size in bytes of the returned results. A `-1` indicates the # value is null. # @return [Integer] # # @!attribute [rw] secret_arn # The name or Amazon Resource Name (ARN) of the secret that enables # access to the database. # @return [String] # # @!attribute [rw] session_id # The session identifier of the query. # @return [String] # # @!attribute [rw] status # The status of the SQL statement being described. Status values are # defined as follows: # # * ABORTED - The query run was stopped by the user. # # * ALL - A status value that includes all query statuses. This value # can be used to filter results. # # * FAILED - The query run failed. # # * FINISHED - The query has finished running. # # * PICKED - The query has been chosen to be run. # # * STARTED - The query run has started. # # * SUBMITTED - The query was submitted, but not yet processed. # @return [String] # # @!attribute [rw] sub_statements # The SQL statements from a multiple statement run. # @return [Array] # # @!attribute [rw] updated_at # The date and time (UTC) that the metadata for the SQL statement was # last updated. An example is the time the status last changed. # @return [Time] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/DescribeStatementResponse AWS API Documentation # class DescribeStatementResponse < Struct.new( :cluster_identifier, :created_at, :database, :db_user, :duration, :error, :has_result_set, :id, :query_parameters, :query_string, :redshift_pid, :redshift_query_id, :result_rows, :result_size, :secret_arn, :session_id, :status, :sub_statements, :updated_at, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] cluster_identifier # The cluster identifier. This parameter is required when connecting # to a cluster and authenticating using either Secrets Manager or # temporary credentials. # @return [String] # # @!attribute [rw] connected_database # A database name. The connected database is specified when you # connect with your authentication credentials. # @return [String] # # @!attribute [rw] database # The name of the database that contains the tables to be described. # If `ConnectedDatabase` is not specified, this is also the database # to connect to with your authentication credentials. # @return [String] # # @!attribute [rw] db_user # The database user name. This parameter is required when connecting # to a cluster as a database user and authenticating using temporary # credentials. # @return [String] # # @!attribute [rw] max_results # The maximum number of tables to return in the response. If more # tables exist than fit in one response, then `NextToken` is returned # to page through the results. # @return [Integer] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] schema # The schema that contains the table. If no schema is specified, then # matching tables for all schemas are returned. # @return [String] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # This parameter is required when authenticating using Secrets # Manager. # @return [String] # # @!attribute [rw] table # The table name. If no table is specified, then all tables for all # matching schemas are returned. If no table and no schema is # specified, then all tables for all schemas in the database are # returned # @return [String] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # parameter is required when connecting to a serverless workgroup and # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/DescribeTableRequest AWS API Documentation # class DescribeTableRequest < Struct.new( :cluster_identifier, :connected_database, :database, :db_user, :max_results, :next_token, :schema, :secret_arn, :table, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] column_list # A list of columns in the table. # @return [Array] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] table_name # The table name. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/DescribeTableResponse AWS API Documentation # class DescribeTableResponse < Struct.new( :column_list, :next_token, :table_name) SENSITIVE = [] include Aws::Structure end # The SQL statement encountered an environmental error while running. # # @!attribute [rw] message # The exception message. # @return [String] # # @!attribute [rw] statement_id # Statement identifier of the exception. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ExecuteStatementException AWS API Documentation # class ExecuteStatementException < Struct.new( :message, :statement_id) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] client_token # A unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option. # @return [String] # # @!attribute [rw] cluster_identifier # The cluster identifier. This parameter is required when connecting # to a cluster and authenticating using either Secrets Manager or # temporary credentials. # @return [String] # # @!attribute [rw] database # The name of the database. This parameter is required when # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @!attribute [rw] db_user # The database user name. This parameter is required when connecting # to a cluster as a database user and authenticating using temporary # credentials. # @return [String] # # @!attribute [rw] parameters # The parameters for the SQL statement. # @return [Array] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # This parameter is required when authenticating using Secrets # Manager. # @return [String] # # @!attribute [rw] session_id # The session identifier of the query. # @return [String] # # @!attribute [rw] session_keep_alive_seconds # The number of seconds to keep the session alive after the query # finishes. The maximum time a session can keep alive is 24 hours. # After 24 hours, the session is forced closed and the query is # terminated. # @return [Integer] # # @!attribute [rw] sql # The SQL statement text to run. # @return [String] # # @!attribute [rw] statement_name # The name of the SQL statement. You can name the SQL statement when # you create it to identify the query. # @return [String] # # @!attribute [rw] with_event # A value that indicates whether to send an event to the Amazon # EventBridge event bus after the SQL statement runs. # @return [Boolean] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # parameter is required when connecting to a serverless workgroup and # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ExecuteStatementInput AWS API Documentation # class ExecuteStatementInput < Struct.new( :client_token, :cluster_identifier, :database, :db_user, :parameters, :secret_arn, :session_id, :session_keep_alive_seconds, :sql, :statement_name, :with_event, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] cluster_identifier # The cluster identifier. This element is not returned when connecting # to a serverless workgroup. # @return [String] # # @!attribute [rw] created_at # The date and time (UTC) the statement was created. # @return [Time] # # @!attribute [rw] database # The name of the database. # @return [String] # # @!attribute [rw] db_groups # A list of colon (:) separated names of database groups. # @return [Array] # # @!attribute [rw] db_user # The database user name. # @return [String] # # @!attribute [rw] id # The identifier of the SQL statement whose results are to be fetched. # This value is a universally unique identifier (UUID) generated by # Amazon Redshift Data API. # @return [String] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # @return [String] # # @!attribute [rw] session_id # The session identifier of the query. # @return [String] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # element is not returned when connecting to a provisioned cluster. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ExecuteStatementOutput AWS API Documentation # class ExecuteStatementOutput < Struct.new( :cluster_identifier, :created_at, :database, :db_groups, :db_user, :id, :secret_arn, :session_id, :workgroup_name) SENSITIVE = [] include Aws::Structure end # A data value in a column. # # @note Field is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Field corresponding to the set member. # # @!attribute [rw] blob_value # A value of the BLOB data type. # @return [String] # # @!attribute [rw] boolean_value # A value of the Boolean data type. # @return [Boolean] # # @!attribute [rw] double_value # A value of the double data type. # @return [Float] # # @!attribute [rw] is_null # A value that indicates whether the data is NULL. # @return [Boolean] # # @!attribute [rw] long_value # A value of the long data type. # @return [Integer] # # @!attribute [rw] string_value # A value of the string data type. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/Field AWS API Documentation # class Field < Struct.new( :blob_value, :boolean_value, :double_value, :is_null, :long_value, :string_value, :unknown) SENSITIVE = [] include Aws::Structure include Aws::Structure::Union class BlobValue < Field; end class BooleanValue < Field; end class DoubleValue < Field; end class IsNull < Field; end class LongValue < Field; end class StringValue < Field; end class Unknown < Field; end end # @!attribute [rw] id # The identifier of the SQL statement whose results are to be fetched. # This value is a universally unique identifier (UUID) generated by # Amazon Redshift Data API. A suffix indicates then number of the SQL # statement. For example, `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has # a suffix of `:2` that indicates the second SQL statement of a batch # query. This identifier is returned by `BatchExecuteStatment`, # `ExecuteStatment`, and `ListStatements`. # @return [String] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/GetStatementResultRequest AWS API Documentation # class GetStatementResultRequest < Struct.new( :id, :next_token) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] column_metadata # The properties (metadata) of a column. # @return [Array] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] records # The results of the SQL statement. # @return [Array>] # # @!attribute [rw] total_num_rows # The total number of rows in the result set returned from a query. # You can use this number to estimate the number of calls to the # `GetStatementResult` operation needed to page through the results. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/GetStatementResultResponse AWS API Documentation # class GetStatementResultResponse < Struct.new( :column_metadata, :next_token, :records, :total_num_rows) SENSITIVE = [] include Aws::Structure end # The Amazon Redshift Data API operation failed due to invalid input. # # @!attribute [rw] message # The exception message. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/InternalServerException AWS API Documentation # class InternalServerException < Struct.new( :message) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] cluster_identifier # The cluster identifier. This parameter is required when connecting # to a cluster and authenticating using either Secrets Manager or # temporary credentials. # @return [String] # # @!attribute [rw] database # The name of the database. This parameter is required when # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @!attribute [rw] db_user # The database user name. This parameter is required when connecting # to a cluster as a database user and authenticating using temporary # credentials. # @return [String] # # @!attribute [rw] max_results # The maximum number of databases to return in the response. If more # databases exist than fit in one response, then `NextToken` is # returned to page through the results. # @return [Integer] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # This parameter is required when authenticating using Secrets # Manager. # @return [String] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # parameter is required when connecting to a serverless workgroup and # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListDatabasesRequest AWS API Documentation # class ListDatabasesRequest < Struct.new( :cluster_identifier, :database, :db_user, :max_results, :next_token, :secret_arn, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] databases # The names of databases. # @return [Array] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListDatabasesResponse AWS API Documentation # class ListDatabasesResponse < Struct.new( :databases, :next_token) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] cluster_identifier # The cluster identifier. This parameter is required when connecting # to a cluster and authenticating using either Secrets Manager or # temporary credentials. # @return [String] # # @!attribute [rw] connected_database # A database name. The connected database is specified when you # connect with your authentication credentials. # @return [String] # # @!attribute [rw] database # The name of the database that contains the schemas to list. If # `ConnectedDatabase` is not specified, this is also the database to # connect to with your authentication credentials. # @return [String] # # @!attribute [rw] db_user # The database user name. This parameter is required when connecting # to a cluster as a database user and authenticating using temporary # credentials. # @return [String] # # @!attribute [rw] max_results # The maximum number of schemas to return in the response. If more # schemas exist than fit in one response, then `NextToken` is returned # to page through the results. # @return [Integer] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] schema_pattern # A pattern to filter results by schema name. Within a schema pattern, # "%" means match any substring of 0 or more characters and "\_" # means match any one character. Only schema name entries matching the # search pattern are returned. # @return [String] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # This parameter is required when authenticating using Secrets # Manager. # @return [String] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # parameter is required when connecting to a serverless workgroup and # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListSchemasRequest AWS API Documentation # class ListSchemasRequest < Struct.new( :cluster_identifier, :connected_database, :database, :db_user, :max_results, :next_token, :schema_pattern, :secret_arn, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] schemas # The schemas that match the request pattern. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListSchemasResponse AWS API Documentation # class ListSchemasResponse < Struct.new( :next_token, :schemas) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] max_results # The maximum number of SQL statements to return in the response. If # more SQL statements exist than fit in one response, then `NextToken` # is returned to page through the results. # @return [Integer] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] role_level # A value that filters which statements to return in the response. If # true, all statements run by the caller's IAM role are returned. If # false, only statements run by the caller's IAM role in the current # IAM session are returned. The default is true. # @return [Boolean] # # @!attribute [rw] statement_name # The name of the SQL statement specified as input to # `BatchExecuteStatement` or `ExecuteStatement` to identify the query. # You can list multiple statements by providing a prefix that matches # the beginning of the statement name. For example, to list # myStatement1, myStatement2, myStatement3, and so on, then provide # the a value of `myStatement`. Data API does a case-sensitive match # of SQL statement names to the prefix value you provide. # @return [String] # # @!attribute [rw] status # The status of the SQL statement to list. Status values are defined # as follows: # # * ABORTED - The query run was stopped by the user. # # * ALL - A status value that includes all query statuses. This value # can be used to filter results. # # * FAILED - The query run failed. # # * FINISHED - The query has finished running. # # * PICKED - The query has been chosen to be run. # # * STARTED - The query run has started. # # * SUBMITTED - The query was submitted, but not yet processed. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListStatementsRequest AWS API Documentation # class ListStatementsRequest < Struct.new( :max_results, :next_token, :role_level, :statement_name, :status) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] statements # The SQL statements. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListStatementsResponse AWS API Documentation # class ListStatementsResponse < Struct.new( :next_token, :statements) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] cluster_identifier # The cluster identifier. This parameter is required when connecting # to a cluster and authenticating using either Secrets Manager or # temporary credentials. # @return [String] # # @!attribute [rw] connected_database # A database name. The connected database is specified when you # connect with your authentication credentials. # @return [String] # # @!attribute [rw] database # The name of the database that contains the tables to list. If # `ConnectedDatabase` is not specified, this is also the database to # connect to with your authentication credentials. # @return [String] # # @!attribute [rw] db_user # The database user name. This parameter is required when connecting # to a cluster as a database user and authenticating using temporary # credentials. # @return [String] # # @!attribute [rw] max_results # The maximum number of tables to return in the response. If more # tables exist than fit in one response, then `NextToken` is returned # to page through the results. # @return [Integer] # # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] schema_pattern # A pattern to filter results by schema name. Within a schema pattern, # "%" means match any substring of 0 or more characters and "\_" # means match any one character. Only schema name entries matching the # search pattern are returned. If `SchemaPattern` is not specified, # then all tables that match `TablePattern` are returned. If neither # `SchemaPattern` or `TablePattern` are specified, then all tables are # returned. # @return [String] # # @!attribute [rw] secret_arn # The name or ARN of the secret that enables access to the database. # This parameter is required when authenticating using Secrets # Manager. # @return [String] # # @!attribute [rw] table_pattern # A pattern to filter results by table name. Within a table pattern, # "%" means match any substring of 0 or more characters and "\_" # means match any one character. Only table name entries matching the # search pattern are returned. If `TablePattern` is not specified, # then all tables that match `SchemaPattern`are returned. If neither # `SchemaPattern` or `TablePattern` are specified, then all tables are # returned. # @return [String] # # @!attribute [rw] workgroup_name # The serverless workgroup name or Amazon Resource Name (ARN). This # parameter is required when connecting to a serverless workgroup and # authenticating using either Secrets Manager or temporary # credentials. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListTablesRequest AWS API Documentation # class ListTablesRequest < Struct.new( :cluster_identifier, :connected_database, :database, :db_user, :max_results, :next_token, :schema_pattern, :secret_arn, :table_pattern, :workgroup_name) SENSITIVE = [] include Aws::Structure end # @!attribute [rw] next_token # A value that indicates the starting point for the next set of # response records in a subsequent request. If a value is returned in # a response, you can retrieve the next set of records by providing # this returned NextToken value in the next NextToken parameter and # retrying the command. If the NextToken field is empty, all response # records have been retrieved for the request. # @return [String] # # @!attribute [rw] tables # The tables that match the request pattern. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ListTablesResponse AWS API Documentation # class ListTablesResponse < Struct.new( :next_token, :tables) SENSITIVE = [] include Aws::Structure end # The Amazon Redshift Data API operation failed due to timeout. # # @!attribute [rw] message # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/QueryTimeoutException AWS API Documentation # class QueryTimeoutException < Struct.new( :message) SENSITIVE = [] include Aws::Structure end # The Amazon Redshift Data API operation failed due to a missing # resource. # # @!attribute [rw] message # The exception message. # @return [String] # # @!attribute [rw] resource_id # Resource identifier associated with the exception. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ResourceNotFoundException AWS API Documentation # class ResourceNotFoundException < Struct.new( :message, :resource_id) SENSITIVE = [] include Aws::Structure end # A parameter used in a SQL statement. # # @!attribute [rw] name # The name of the parameter. # @return [String] # # @!attribute [rw] value # The value of the parameter. Amazon Redshift implicitly converts to # the proper data type. For more information, see [Data types][1] in # the *Amazon Redshift Database Developer Guide*. # # # # [1]: https://docs.aws.amazon.com/redshift/latest/dg/c_Supported_data_types.html # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/SqlParameter AWS API Documentation # class SqlParameter < Struct.new( :name, :value) SENSITIVE = [] include Aws::Structure end # The SQL statement to run. # # @!attribute [rw] created_at # The date and time (UTC) the statement was created. # @return [Time] # # @!attribute [rw] id # The SQL statement identifier. This value is a universally unique # identifier (UUID) generated by Amazon Redshift Data API. # @return [String] # # @!attribute [rw] is_batch_statement # A value that indicates whether the statement is a batch query # request. # @return [Boolean] # # @!attribute [rw] query_parameters # The parameters used in a SQL statement. # @return [Array] # # @!attribute [rw] query_string # The SQL statement. # @return [String] # # @!attribute [rw] query_strings # One or more SQL statements. Each query string in the array # corresponds to one of the queries in a batch query request. # @return [Array] # # @!attribute [rw] secret_arn # The name or Amazon Resource Name (ARN) of the secret that enables # access to the database. # @return [String] # # @!attribute [rw] session_id # The session identifier of the query. # @return [String] # # @!attribute [rw] statement_name # The name of the SQL statement. # @return [String] # # @!attribute [rw] status # The status of the SQL statement. An example is the that the SQL # statement finished. # @return [String] # # @!attribute [rw] updated_at # The date and time (UTC) that the statement metadata was last # updated. # @return [Time] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/StatementData AWS API Documentation # class StatementData < Struct.new( :created_at, :id, :is_batch_statement, :query_parameters, :query_string, :query_strings, :secret_arn, :session_id, :statement_name, :status, :updated_at) SENSITIVE = [] include Aws::Structure end # Information about an SQL statement. # # @!attribute [rw] created_at # The date and time (UTC) the statement was created. # @return [Time] # # @!attribute [rw] duration # The amount of time in nanoseconds that the statement ran. # @return [Integer] # # @!attribute [rw] error # The error message from the cluster if the SQL statement encountered # an error while running. # @return [String] # # @!attribute [rw] has_result_set # A value that indicates whether the statement has a result set. The # result set can be empty. The value is true for an empty result set. # @return [Boolean] # # @!attribute [rw] id # The identifier of the SQL statement. This value is a universally # unique identifier (UUID) generated by Amazon Redshift Data API. A # suffix indicates the number of the SQL statement. For example, # `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has a suffix of `:2` that # indicates the second SQL statement of a batch query. # @return [String] # # @!attribute [rw] query_string # The SQL statement text. # @return [String] # # @!attribute [rw] redshift_query_id # The SQL statement identifier. This value is a universally unique # identifier (UUID) generated by Amazon Redshift Data API. # @return [Integer] # # @!attribute [rw] result_rows # Either the number of rows returned from the SQL statement or the # number of rows affected. If result size is greater than zero, the # result rows can be the number of rows affected by SQL statements # such as INSERT, UPDATE, DELETE, COPY, and others. A `-1` indicates # the value is null. # @return [Integer] # # @!attribute [rw] result_size # The size in bytes of the returned results. A `-1` indicates the # value is null. # @return [Integer] # # @!attribute [rw] status # The status of the SQL statement. An example is the that the SQL # statement finished. # @return [String] # # @!attribute [rw] updated_at # The date and time (UTC) that the statement metadata was last # updated. # @return [Time] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/SubStatementData AWS API Documentation # class SubStatementData < Struct.new( :created_at, :duration, :error, :has_result_set, :id, :query_string, :redshift_query_id, :result_rows, :result_size, :status, :updated_at) SENSITIVE = [] include Aws::Structure end # The properties of a table. # # @!attribute [rw] name # The name of the table. # @return [String] # # @!attribute [rw] schema # The schema containing the table. # @return [String] # # @!attribute [rw] type # The type of the table. Possible values include TABLE, VIEW, SYSTEM # TABLE, GLOBAL TEMPORARY, LOCAL TEMPORARY, ALIAS, and SYNONYM. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/TableMember AWS API Documentation # class TableMember < Struct.new( :name, :schema, :type) SENSITIVE = [] include Aws::Structure end # The Amazon Redshift Data API operation failed due to invalid input. # # @!attribute [rw] message # The exception message. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/ValidationException AWS API Documentation # class ValidationException < Struct.new( :message) SENSITIVE = [] include Aws::Structure end end end