Package software.amazon.awssdk.services.redshiftdata.model

Class DescribeStatementResponse

    • Method Detail

      • clusterIdentifier

        public final String clusterIdentifier()

        The cluster identifier.

        Returns:
        The cluster identifier.

      • createdAt

        public final Instant createdAt()

        The date and time (UTC) when the SQL statement was submitted to run.

        Returns:
        The date and time (UTC) when the SQL statement was submitted to run.

      • database

        public final String database()

        The name of the database.

        Returns:
        The name of the database.

      • dbUser

        public final String dbUser()

        The database user name.

        Returns:
        The database user name.

      • duration

        public final Long duration()

        The amount of time in nanoseconds that the statement ran.

        Returns:
        The amount of time in nanoseconds that the statement ran.

      • error

        public final String error()

        The error message from the cluster if the SQL statement encountered an error while running.

        Returns:
        The error message from the cluster if the SQL statement encountered an error while running.

      • hasResultSet

        public final Boolean hasResultSet()

        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.

        Returns:
        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.

      • id

        public final String id()

        The identifier of the SQL statement described. This value is a universally unique identifier (UUID) generated by Amazon Redshift Data API.

        Returns:
        The identifier of the SQL statement described. This value is a universally unique identifier (UUID) generated by Amazon Redshift Data API.

      • hasQueryParameters

        public final boolean hasQueryParameters()
        For responses, this returns true if the service returned a value for the QueryParameters property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

      • queryParameters

        public final List<SqlParameter> queryParameters()

        The parameters for the SQL statement.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasQueryParameters() method.

        Returns:
        The parameters for the SQL statement.

      • queryString

        public final String queryString()

        The SQL statement text.

        Returns:
        The SQL statement text.

      • redshiftPid

        public final Long redshiftPid()

        The process identifier from Amazon Redshift.

        Returns:
        The process identifier from Amazon Redshift.

      • redshiftQueryId

        public final Long redshiftQueryId()

        The identifier of the query generated by Amazon Redshift. These identifiers are also available in the query column of the STL_QUERY system view.

        Returns:
        The identifier of the query generated by Amazon Redshift. These identifiers are also available in the query column of the STL_QUERY system view.

      • resultFormatAsString

        public final String resultFormatAsString()

        The data format of the result of the SQL statement.

        If the service returns an enum value that is not available in the current SDK version, resultFormat will return ResultFormatString.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from resultFormatAsString().

        Returns:
        The data format of the result of the SQL statement.
        See Also:
        ResultFormatString

      • resultRows

        public final Long resultRows()

        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.

        Returns:
        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.

      • resultSize

        public final Long resultSize()

        The size in bytes of the returned results. A -1 indicates the value is null.

        Returns:
        The size in bytes of the returned results. A -1 indicates the value is null.

      • secretArn

        public final String secretArn()

        The name or Amazon Resource Name (ARN) of the secret that enables access to the database.

        Returns:
        The name or Amazon Resource Name (ARN) of the secret that enables access to the database.

      • sessionId

        public final String sessionId()

        The session identifier of the query.

        Returns:
        The session identifier of the query.

      • status

        public final StatusString 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.

        If the service returns an enum value that is not available in the current SDK version, status will return StatusString.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from statusAsString().

        Returns:
        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.

        See Also:
        StatusString

      • statusAsString

        public final String statusAsString()

        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.

        If the service returns an enum value that is not available in the current SDK version, status will return StatusString.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from statusAsString().

        Returns:
        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.

        See Also:
        StatusString

      • hasSubStatements

        public final boolean hasSubStatements()
        For responses, this returns true if the service returned a value for the SubStatements property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

      • subStatements

        public final List<SubStatementData> subStatements()

        The SQL statements from a multiple statement run.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasSubStatements() method.

        Returns:
        The SQL statements from a multiple statement run.

      • updatedAt

        public final Instant updatedAt()

        The date and time (UTC) that the metadata for the SQL statement was last updated. An example is the time the status last changed.

        Returns:
        The date and time (UTC) that the metadata for the SQL statement was last updated. An example is the time the status last changed.

      • workgroupName

        public final String workgroupName()

        The serverless workgroup name or Amazon Resource Name (ARN).

        Returns:
        The serverless workgroup name or Amazon Resource Name (ARN).

      • toString

        public final String toString()
        Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
        Overrides:
        toString in class Object