Class: Aws::Firehose::Types::IcebergDestinationUpdate

Inherits:

Struct

• Object
• Struct
• Aws::Firehose::Types::IcebergDestinationUpdate

Defined in:

gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb

Overview

Describes an update for a destination in Apache Iceberg Tables.

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #append_only ⇒ Boolean

  Describes whether all incoming data for this delivery stream will be append only (inserts only and not for updates and deletes) for Iceberg delivery.

• #buffering_hints ⇒ Types::BufferingHints

  Describes hints for the buffering to perform before delivering data to the destination.

• #catalog_configuration ⇒ Types::CatalogConfiguration

  Configuration describing where the destination Iceberg tables are persisted.

• #cloud_watch_logging_options ⇒ Types::CloudWatchLoggingOptions

  Describes the Amazon CloudWatch logging options for your Firehose stream.

• #destination_table_configuration_list ⇒ Array<Types::DestinationTableConfiguration>

  Provides a list of DestinationTableConfigurations which Firehose uses to deliver data to Apache Iceberg Tables.

• #processing_configuration ⇒ Types::ProcessingConfiguration

  Describes a data processing configuration.

• #retry_options ⇒ Types::RetryOptions

  The retry behavior in case Firehose is unable to deliver data to a destination.

• #role_arn ⇒ String

  The Amazon Resource Name (ARN) of the IAM role to be assumed by Firehose for calling Apache Iceberg Tables.

• #s3_backup_mode ⇒ String

  Describes how Firehose will backup records.

• #s3_configuration ⇒ Types::S3DestinationConfiguration

  Describes the configuration of a destination in Amazon S3.

• #schema_evolution_configuration ⇒ Types::SchemaEvolutionConfiguration

  The configuration to enable automatic schema evolution.

• #table_creation_configuration ⇒ Types::TableCreationConfiguration

  The configuration to enable automatic table creation.

Instance Attribute Details

#append_only ⇒ Boolean

Describes whether all incoming data for this delivery stream will be append only (inserts only and not for updates and deletes) for Iceberg delivery. This feature is only applicable for Apache Iceberg Tables.

The default value is false. If you set this value to true, Firehose automatically increases the throughput limit of a stream based on the throttling levels of the stream. If you set this parameter to true for a stream with updates and deletes, you will see out of order delivery.

Returns:

• (Boolean)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#buffering_hints ⇒ Types::BufferingHints

Describes hints for the buffering to perform before delivering data to the destination. These options are treated as hints, and therefore Firehose might choose to use different values when it is optimal. The SizeInMBs and IntervalInSeconds parameters are optional. However, if specify a value for one of them, you must also provide a value for the other.

Returns:

• (Types::BufferingHints)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#catalog_configuration ⇒ Types::CatalogConfiguration

Configuration describing where the destination Iceberg tables are persisted.

Returns:

• (Types::CatalogConfiguration)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#cloud_watch_logging_options ⇒ Types::CloudWatchLoggingOptions

Describes the Amazon CloudWatch logging options for your Firehose stream.

Returns:

• (Types::CloudWatchLoggingOptions)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#destination_table_configuration_list ⇒ Array<Types::DestinationTableConfiguration>

Provides a list of DestinationTableConfigurations which Firehose uses to deliver data to Apache Iceberg Tables. Firehose will write data with insert if table specific configuration is not provided here.

Returns:

• (Array<Types::DestinationTableConfiguration>)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#processing_configuration ⇒ Types::ProcessingConfiguration

Describes a data processing configuration.

Returns:

• (Types::ProcessingConfiguration)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#retry_options ⇒ Types::RetryOptions

The retry behavior in case Firehose is unable to deliver data to a destination.

Returns:

• (Types::RetryOptions)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#role_arn ⇒ String

The Amazon Resource Name (ARN) of the IAM role to be assumed by Firehose for calling Apache Iceberg Tables.

Returns:

• (String)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#s3_backup_mode ⇒ String

Describes how Firehose will backup records. Currently,Firehose only supports FailedDataOnly.

Returns:

• (String)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#s3_configuration ⇒ Types::S3DestinationConfiguration

Describes the configuration of a destination in Amazon S3.

Returns:

• (Types::S3DestinationConfiguration)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#schema_evolution_configuration ⇒ Types::SchemaEvolutionConfiguration

The configuration to enable automatic schema evolution.

Amazon Data Firehose is in preview release and is subject to change.

Returns:

• (Types::SchemaEvolutionConfiguration)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#table_creation_configuration ⇒ Types::TableCreationConfiguration

The configuration to enable automatic table creation.

Amazon Data Firehose is in preview release and is subject to change.

Returns:

• (Types::TableCreationConfiguration)

# File 'gems/aws-sdk-firehose/lib/aws-sdk-firehose/types.rb', line 3329

class IcebergDestinationUpdate < Struct.new(
  :destination_table_configuration_list,
  :schema_evolution_configuration,
  :table_creation_configuration,
  :buffering_hints,
  :cloud_watch_logging_options,
  :processing_configuration,
  :s3_backup_mode,
  :retry_options,
  :role_arn,
  :append_only,
  :catalog_configuration,
  :s3_configuration)
  SENSITIVE = []
  include Aws::Structure
end