pub struct ExecuteStatementFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to ExecuteStatement
.
Runs an SQL statement, which can be data manipulation language (DML) or data definition language (DDL). This statement must be a single SQL statement. Depending on the authorization method, use one of the following combinations of request parameters:
-
Secrets Manager - when connecting to a cluster, provide the
secret-arn
of a secret stored in Secrets Manager which hasusername
andpassword
. The specified secret contains credentials to connect to thedatabase
you specify. When you are connecting to a cluster, you also supply the database name, If you provide a cluster identifier (dbClusterIdentifier
), it must match the cluster identifier stored in the secret. When you are connecting to a serverless workgroup, you also supply the database name. -
Temporary credentials - when connecting to your data warehouse, choose one of the following options:
-
When connecting to a serverless workgroup, specify the workgroup name and database name. The database user name is derived from the IAM identity. For example,
arn:iam::123456789012:user:foo
has the database user nameIAM:foo
. Also, permission to call theredshift-serverless:GetCredentials
operation is required. -
When connecting to a cluster as an IAM identity, specify the cluster identifier and the database name. The database user name is derived from the IAM identity. For example,
arn:iam::123456789012:user:foo
has the database user nameIAM:foo
. Also, permission to call theredshift:GetClusterCredentialsWithIAM
operation is required. -
When connecting to a cluster as a database user, specify the cluster identifier, the database name, and the database user name. Also, permission to call the
redshift:GetClusterCredentials
operation is required.
-
For more information about the Amazon Redshift Data API and CLI usage examples, see Using the Amazon Redshift Data API in the Amazon Redshift Management Guide.
Implementations§
Source§impl ExecuteStatementFluentBuilder
impl ExecuteStatementFluentBuilder
Sourcepub fn as_input(&self) -> &ExecuteStatementInputBuilder
pub fn as_input(&self) -> &ExecuteStatementInputBuilder
Access the ExecuteStatement as a reference.
Sourcepub async fn send(
self,
) -> Result<ExecuteStatementOutput, SdkError<ExecuteStatementError, HttpResponse>>
pub async fn send( self, ) -> Result<ExecuteStatementOutput, SdkError<ExecuteStatementError, HttpResponse>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
Sourcepub fn customize(
self,
) -> CustomizableOperation<ExecuteStatementOutput, ExecuteStatementError, Self>
pub fn customize( self, ) -> CustomizableOperation<ExecuteStatementOutput, ExecuteStatementError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
Sourcepub fn cluster_identifier(self, input: impl Into<String>) -> Self
pub fn cluster_identifier(self, input: impl Into<String>) -> Self
The cluster identifier. This parameter is required when connecting to a cluster and authenticating using either Secrets Manager or temporary credentials.
Sourcepub fn set_cluster_identifier(self, input: Option<String>) -> Self
pub fn set_cluster_identifier(self, input: Option<String>) -> Self
The cluster identifier. This parameter is required when connecting to a cluster and authenticating using either Secrets Manager or temporary credentials.
Sourcepub fn get_cluster_identifier(&self) -> &Option<String>
pub fn get_cluster_identifier(&self) -> &Option<String>
The cluster identifier. This parameter is required when connecting to a cluster and authenticating using either Secrets Manager or temporary credentials.
Sourcepub fn secret_arn(self, input: impl Into<String>) -> Self
pub fn secret_arn(self, input: impl Into<String>) -> Self
The name or ARN of the secret that enables access to the database. This parameter is required when authenticating using Secrets Manager.
Sourcepub fn set_secret_arn(self, input: Option<String>) -> Self
pub fn set_secret_arn(self, input: Option<String>) -> Self
The name or ARN of the secret that enables access to the database. This parameter is required when authenticating using Secrets Manager.
Sourcepub fn get_secret_arn(&self) -> &Option<String>
pub fn get_secret_arn(&self) -> &Option<String>
The name or ARN of the secret that enables access to the database. This parameter is required when authenticating using Secrets Manager.
Sourcepub fn db_user(self, input: impl Into<String>) -> Self
pub fn db_user(self, input: impl Into<String>) -> Self
The database user name. This parameter is required when connecting to a cluster as a database user and authenticating using temporary credentials.
Sourcepub fn set_db_user(self, input: Option<String>) -> Self
pub fn set_db_user(self, input: Option<String>) -> Self
The database user name. This parameter is required when connecting to a cluster as a database user and authenticating using temporary credentials.
Sourcepub fn get_db_user(&self) -> &Option<String>
pub fn get_db_user(&self) -> &Option<String>
The database user name. This parameter is required when connecting to a cluster as a database user and authenticating using temporary credentials.
Sourcepub fn database(self, input: impl Into<String>) -> Self
pub fn database(self, input: impl Into<String>) -> Self
The name of the database. This parameter is required when authenticating using either Secrets Manager or temporary credentials.
Sourcepub fn set_database(self, input: Option<String>) -> Self
pub fn set_database(self, input: Option<String>) -> Self
The name of the database. This parameter is required when authenticating using either Secrets Manager or temporary credentials.
Sourcepub fn get_database(&self) -> &Option<String>
pub fn get_database(&self) -> &Option<String>
The name of the database. This parameter is required when authenticating using either Secrets Manager or temporary credentials.
Sourcepub fn with_event(self, input: bool) -> Self
pub fn with_event(self, input: bool) -> Self
A value that indicates whether to send an event to the Amazon EventBridge event bus after the SQL statement runs.
Sourcepub fn set_with_event(self, input: Option<bool>) -> Self
pub fn set_with_event(self, input: Option<bool>) -> Self
A value that indicates whether to send an event to the Amazon EventBridge event bus after the SQL statement runs.
Sourcepub fn get_with_event(&self) -> &Option<bool>
pub fn get_with_event(&self) -> &Option<bool>
A value that indicates whether to send an event to the Amazon EventBridge event bus after the SQL statement runs.
Sourcepub fn statement_name(self, input: impl Into<String>) -> Self
pub fn statement_name(self, input: impl Into<String>) -> Self
The name of the SQL statement. You can name the SQL statement when you create it to identify the query.
Sourcepub fn set_statement_name(self, input: Option<String>) -> Self
pub fn set_statement_name(self, input: Option<String>) -> Self
The name of the SQL statement. You can name the SQL statement when you create it to identify the query.
Sourcepub fn get_statement_name(&self) -> &Option<String>
pub fn get_statement_name(&self) -> &Option<String>
The name of the SQL statement. You can name the SQL statement when you create it to identify the query.
Sourcepub fn parameters(self, input: SqlParameter) -> Self
pub fn parameters(self, input: SqlParameter) -> Self
Appends an item to Parameters
.
To override the contents of this collection use set_parameters
.
The parameters for the SQL statement.
Sourcepub fn set_parameters(self, input: Option<Vec<SqlParameter>>) -> Self
pub fn set_parameters(self, input: Option<Vec<SqlParameter>>) -> Self
The parameters for the SQL statement.
Sourcepub fn get_parameters(&self) -> &Option<Vec<SqlParameter>>
pub fn get_parameters(&self) -> &Option<Vec<SqlParameter>>
The parameters for the SQL statement.
Sourcepub fn workgroup_name(self, input: impl Into<String>) -> Self
pub fn workgroup_name(self, input: impl Into<String>) -> Self
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.
Sourcepub fn set_workgroup_name(self, input: Option<String>) -> Self
pub fn set_workgroup_name(self, input: Option<String>) -> Self
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.
Sourcepub fn get_workgroup_name(&self) -> &Option<String>
pub fn get_workgroup_name(&self) -> &Option<String>
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.
Sourcepub fn client_token(self, input: impl Into<String>) -> Self
pub fn client_token(self, input: impl Into<String>) -> Self
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Sourcepub fn set_client_token(self, input: Option<String>) -> Self
pub fn set_client_token(self, input: Option<String>) -> Self
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Sourcepub fn get_client_token(&self) -> &Option<String>
pub fn get_client_token(&self) -> &Option<String>
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Sourcepub fn session_keep_alive_seconds(self, input: i32) -> Self
pub fn session_keep_alive_seconds(self, input: i32) -> Self
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.
Sourcepub fn set_session_keep_alive_seconds(self, input: Option<i32>) -> Self
pub fn set_session_keep_alive_seconds(self, input: Option<i32>) -> Self
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.
Sourcepub fn get_session_keep_alive_seconds(&self) -> &Option<i32>
pub fn get_session_keep_alive_seconds(&self) -> &Option<i32>
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.
Sourcepub fn session_id(self, input: impl Into<String>) -> Self
pub fn session_id(self, input: impl Into<String>) -> Self
The session identifier of the query.
Sourcepub fn set_session_id(self, input: Option<String>) -> Self
pub fn set_session_id(self, input: Option<String>) -> Self
The session identifier of the query.
Sourcepub fn get_session_id(&self) -> &Option<String>
pub fn get_session_id(&self) -> &Option<String>
The session identifier of the query.
Sourcepub fn result_format(self, input: ResultFormatString) -> Self
pub fn result_format(self, input: ResultFormatString) -> Self
The data format of the result of the SQL statement. If no format is specified, the default is JSON.
Sourcepub fn set_result_format(self, input: Option<ResultFormatString>) -> Self
pub fn set_result_format(self, input: Option<ResultFormatString>) -> Self
The data format of the result of the SQL statement. If no format is specified, the default is JSON.
Sourcepub fn get_result_format(&self) -> &Option<ResultFormatString>
pub fn get_result_format(&self) -> &Option<ResultFormatString>
The data format of the result of the SQL statement. If no format is specified, the default is JSON.
Trait Implementations§
Source§impl Clone for ExecuteStatementFluentBuilder
impl Clone for ExecuteStatementFluentBuilder
Source§fn clone(&self) -> ExecuteStatementFluentBuilder
fn clone(&self) -> ExecuteStatementFluentBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for ExecuteStatementFluentBuilder
impl !RefUnwindSafe for ExecuteStatementFluentBuilder
impl Send for ExecuteStatementFluentBuilder
impl Sync for ExecuteStatementFluentBuilder
impl Unpin for ExecuteStatementFluentBuilder
impl !UnwindSafe for ExecuteStatementFluentBuilder
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);