apache_beam.transforms.combiners module

A library of basic combiner PTransform subclasses.

class apache_beam.transforms.combiners.Mean

Bases: object

Combiners for computing arithmetic means of elements.

class Globally(has_defaults=True)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

combiners.Mean.Globally computes the arithmetic mean of the elements.

expand(pcoll)

class PerKey(label=None)

Bases: apache_beam.transforms.ptransform.PTransform

combiners.Mean.PerKey finds the means of the values for each key.

expand(pcoll)

class apache_beam.transforms.combiners.Count

Bases: object

Combiners for counting elements.

class Globally(has_defaults=True)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

combiners.Count.Globally counts the total number of elements.

expand(pcoll)

class PerKey(label=None)

Bases: apache_beam.transforms.ptransform.PTransform

combiners.Count.PerKey counts how many elements each unique key has.

expand(pcoll)

class PerElement(label=None)

Bases: apache_beam.transforms.ptransform.PTransform

combiners.Count.PerElement counts how many times each element occurs.

expand(pcoll)

class apache_beam.transforms.combiners.Top

Bases: object

Combiners for obtaining extremal elements.

class Of(n, key=None, reverse=False)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

Obtain a list of the compare-most N elements in a PCollection.

This transform will retrieve the n greatest elements in the PCollection to which it is applied, where “greatest” is determined by the comparator function supplied as the compare argument.

Creates a global Top operation.

The arguments ‘key’ and ‘reverse’ may be passed as keyword arguments, and have the same meaning as for Python’s sort functions.

Parameters:

• n – number of elements to extract from pcoll.
• key – (optional) a mapping of elements to a comparable key, similar to the key argument of Python’s sorting methods.
• reverse – (optional) whether to order things smallest to largest, rather than largest to smallest

default_label()

expand(pcoll)

class PerKey(n, key=None, reverse=False)

Bases: apache_beam.transforms.ptransform.PTransform

Identifies the compare-most N elements associated with each key.

This transform will produce a PCollection mapping unique keys in the input PCollection to the n greatest elements with which they are associated, where “greatest” is determined by the comparator function supplied as the compare argument in the initializer.

Creates a per-key Top operation.

The arguments ‘key’ and ‘reverse’ may be passed as keyword arguments, and have the same meaning as for Python’s sort functions.

Parameters:

• n – number of elements to extract from pcoll.
• key – (optional) a mapping of elements to a comparable key, similar to the key argument of Python’s sorting methods.
• reverse – (optional) whether to order things smallest to largest, rather than largest to smallest

default_label()

expand(pcoll)

Expands the transform.

Raises TypeCheckError: If the output type of the input PCollection is not compatible with Tuple[A, B].

Parameters:pcoll – PCollection to process Returns:the PCollection containing the result.

static Largest(pcoll, n, has_defaults=True)

Obtain a list of the greatest N elements in a PCollection.

static Smallest(pcoll, n, has_defaults=True)

Obtain a list of the least N elements in a PCollection.

static LargestPerKey(pcoll, n)

Identifies the N greatest elements associated with each key.

static SmallestPerKey(pcoll, n, reverse=True)

Identifies the N least elements associated with each key.

class apache_beam.transforms.combiners.Sample

Bases: object

Combiners for sampling n elements without replacement.

class FixedSizeGlobally(n)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

Sample n elements from the input PCollection without replacement.

expand(pcoll)

display_data()

default_label()

class FixedSizePerKey(n)

Bases: apache_beam.transforms.ptransform.PTransform

Sample n elements associated with each key without replacement.

expand(pcoll)

display_data()

default_label()

class apache_beam.transforms.combiners.ToList(has_defaults=True)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

A global CombineFn that condenses a PCollection into a single list.

expand(pcoll)

class apache_beam.transforms.combiners.ToDict(has_defaults=True)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

A global CombineFn that condenses a PCollection into a single dict.

PCollections should consist of 2-tuples, notionally (key, value) pairs. If multiple values are associated with the same key, only one of the values will be present in the resulting dict.

expand(pcoll)

class apache_beam.transforms.combiners.ToSet(has_defaults=True)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

A global CombineFn that condenses a PCollection into a set.

expand(pcoll)

class apache_beam.transforms.combiners.Latest

Bases: object

Combiners for computing the latest element

class Globally(has_defaults=True)

Bases: apache_beam.transforms.combiners.CombinerWithoutDefaults

Compute the element with the latest timestamp from a PCollection.

static add_timestamp(element, timestamp=TimestampParam)

expand(pcoll)

class PerKey(label=None)

Bases: apache_beam.transforms.ptransform.PTransform

Compute elements with the latest timestamp for each key from a keyed PCollection

static add_timestamp(element, timestamp=TimestampParam)

expand(pcoll)