Class: Google::Apis::DataflowV1b3::Source

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
generated/google/apis/dataflow_v1b3/classes.rb,
generated/google/apis/dataflow_v1b3/representations.rb,
generated/google/apis/dataflow_v1b3/representations.rb

Overview

A source that records can be read and decoded from.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Core::JsonObjectSupport

#to_json

Methods included from Core::Hashable

process_value, #to_h

Constructor Details

#initialize(**args) ⇒ Source

Returns a new instance of Source



1677
1678
1679
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 1677

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#base_specs ⇒ Array<Hash<String,Object>>

While splitting, sources may specify the produced bundles as differences against another source, in order to save backend-side memory and allow bigger jobs. For details, see SourceSplitRequest. To support this use case, the full set of parameters of the source is logically obtained by taking the latest explicitly specified value of each parameter in the order: base_specs (later items win), spec (overrides anything in base_specs). Corresponds to the JSON property baseSpecs

Returns:

  • (Array<Hash<String,Object>>) 


1646
1647
1648
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 1646

def base_specs
  @base_specs
end

#codec ⇒ Hash<String,Object>

The codec to use to decode data read from the source. Corresponds to the JSON property codec

Returns:

  • (Hash<String,Object>) 


1651
1652
1653
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 1651

def codec
  @codec
end

#does_not_need_splitting ⇒ Boolean Also known as: does_not_need_splitting?

Setting this value to true hints to the framework that the source doesn't need splitting, and using SourceSplitRequest on it would yield SOURCE_SPLIT_OUTCOME_USE_CURRENT. E.g. a file splitter may set this to true when splitting a single file into a set of byte ranges of appropriate size, and set this to false when splitting a filepattern into individual files. However, for efficiency, a file splitter may decide to produce file subranges directly from the filepattern to avoid a splitting round-trip. See SourceSplitRequest for an overview of the splitting process. This field is meaningful only in the Source objects populated by the user (e.g. when filling in a DerivedSource). Source objects supplied by the framework to the user don't have this field populated. Corresponds to the JSON property doesNotNeedSplitting

Returns:

  • (Boolean) 


1669
1670
1671
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 1669

def does_not_need_splitting
  @does_not_need_splitting
end

#metadata ⇒ Google::Apis::DataflowV1b3::SourceMetadata

Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc. Corresponds to the JSON property metadata

Returns:



1635
1636
1637
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 1635

def metadata
  @metadata
end

#spec ⇒ Hash<String,Object>

The source to read from, plus its parameters. Corresponds to the JSON property spec

Returns:

  • (Hash<String,Object>) 


1675
1676
1677
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 1675

def spec
  @spec
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



1682
1683
1684
1685
1686
1687
1688
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 1682

def update!(**args)
  @metadata = args[:metadata] if args.key?(:metadata)
  @base_specs = args[:base_specs] if args.key?(:base_specs)
  @codec = args[:codec] if args.key?(:codec)
  @does_not_need_splitting = args[:does_not_need_splitting] if args.key?(:does_not_need_splitting)
  @spec = args[:spec] if args.key?(:spec)
end