aws_sdk_finspacedata/client/
update_changeset.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`UpdateChangeset`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`client_token(impl Into<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::set_client_token):<br>required: **false**<br><p>A token that ensures idempotency. This token expires in 10 minutes.</p><br>
7    ///   - [`dataset_id(impl Into<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::dataset_id) / [`set_dataset_id(Option<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::set_dataset_id):<br>required: **true**<br><p>The unique identifier for the FinSpace Dataset in which the Changeset is created.</p><br>
8    ///   - [`changeset_id(impl Into<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::changeset_id) / [`set_changeset_id(Option<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::set_changeset_id):<br>required: **true**<br><p>The unique identifier for the Changeset to update.</p><br>
9    ///   - [`source_params(impl Into<String>, impl Into<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::source_params) / [`set_source_params(Option<HashMap::<String, String>>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::set_source_params):<br>required: **true**<br><p>Options that define the location of the data being ingested (<code>s3SourcePath</code>) and the source of the changeset (<code>sourceType</code>).</p> <p>Both <code>s3SourcePath</code> and <code>sourceType</code> are required attributes.</p> <p>Here is an example of how you could specify the <code>sourceParams</code>:</p> <p><code> "sourceParams": { "s3SourcePath": "s3://finspace-landing-us-east-2-bk7gcfvitndqa6ebnvys4d/scratch/wr5hh8pwkpqqkxa4sxrmcw/ingestion/equity.csv", "sourceType": "S3" } </code></p> <p>The S3 path that you specify must allow the FinSpace role access. To do that, you first need to configure the IAM policy on S3 bucket. For more information, see <a href="https://docs.aws.amazon.com/finspace/latest/data-api/fs-using-the-finspace-api.html#access-s3-buckets">Loading data from an Amazon S3 Bucket using the FinSpace API</a>section.</p><br>
10    ///   - [`format_params(impl Into<String>, impl Into<String>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::format_params) / [`set_format_params(Option<HashMap::<String, String>>)`](crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::set_format_params):<br>required: **true**<br><p>Options that define the structure of the source file(s) including the format type (<code>formatType</code>), header row (<code>withHeader</code>), data separation character (<code>separator</code>) and the type of compression (<code>compression</code>).</p> <p><code>formatType</code> is a required attribute and can have the following values:</p> <ul>  <li>   <p><code>PARQUET</code> – Parquet source file format.</p></li>  <li>   <p><code>CSV</code> – CSV source file format.</p></li>  <li>   <p><code>JSON</code> – JSON source file format.</p></li>  <li>   <p><code>XML</code> – XML source file format.</p></li> </ul> <p>Here is an example of how you could specify the <code>formatParams</code>:</p> <p><code> "formatParams": { "formatType": "CSV", "withHeader": "true", "separator": ",", "compression":"None" } </code></p> <p>Note that if you only provide <code>formatType</code> as <code>CSV</code>, the rest of the attributes will automatically default to CSV values as following:</p> <p><code> { "withHeader": "true", "separator": "," } </code></p> <p>For more information about supported file formats, see <a href="https://docs.aws.amazon.com/finspace/latest/userguide/supported-data-types.html">Supported Data Types and File Formats</a> in the FinSpace User Guide.</p><br>
11    /// - On success, responds with [`UpdateChangesetOutput`](crate::operation::update_changeset::UpdateChangesetOutput) with field(s):
12    ///   - [`changeset_id(Option<String>)`](crate::operation::update_changeset::UpdateChangesetOutput::changeset_id): <p>The unique identifier for the Changeset to update.</p>
13    ///   - [`dataset_id(Option<String>)`](crate::operation::update_changeset::UpdateChangesetOutput::dataset_id): <p>The unique identifier for the FinSpace Dataset in which the Changeset is created.</p>
14    /// - On failure, responds with [`SdkError<UpdateChangesetError>`](crate::operation::update_changeset::UpdateChangesetError)
15    #[deprecated(note = "This method will be discontinued.")]
16    pub fn update_changeset(&self) -> crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder {
17        crate::operation::update_changeset::builders::UpdateChangesetFluentBuilder::new(self.handle.clone())
18    }
19}