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



333
334
335
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 333

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>>) 


302
303
304
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 302

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>) 


307
308
309
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 307

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) 


325
326
327
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 325

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:



291
292
293
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 291

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>) 


331
332
333
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 331

def spec
  @spec
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



338
339
340
341
342
343
344
 
# File 'generated/google/apis/dataflow_v1b3/classes.rb', line 338

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