Manages Google Cloud Dataflow projects on Google Cloud Platform.

Obsolete in favor of ApproximateReportedProgress and ApproximateSplitRequest.

A progress measurement of a WorkItem by a worker.

A suggestion by the service to the worker to dynamically split the WorkItem.

A structured message reporting an autoscaling decision made by the Dataflow service.

Settings for WorkerPool autoscaling.

Exponential buckets where the growth factor between buckets is 2**(2**-scale). e.g. for scale=1 growth factor is 2**(2**(-1))=sqrt(2). n buckets will have the following boundaries. - 0th: [0, gf) - i in [1, n-1]: [gf^(i), gf^(i+1))

Metadata for a BigQuery connector used by the job.

Metadata for a Cloud Bigtable connector used by the job.

BucketOptions describes the bucket boundaries used in the histogram.

Description of an interstitial value between transforms in an execution stage.

Description of a transform executed as part of an execution stage.

All configuration data for a particular Computation.

A position that encapsulates an inner position and an index for the inner position. A ConcatPosition can be used by a reader of a source that encapsulates a set of other sources.

Container Spec.

CounterMetadata includes all static non-name non-value counter attributes.

Identifies a counter within a per-job namespace. Counters whose structured names are the same get merged into a single value for the job.

A single message which encapsulates structured name and metadata for a given counter.

An update to a Counter sent from a worker.

Modeled after information exposed by /proc/stat.

A request to create a Cloud Dataflow job from a template.

Defines the root interface for all clients that generate credentials for calling Google APIs. All clients should implement this interface.

Identifies the location of a custom souce.

Data disk assignment for a given VM instance.

Summary statistics for a population of values. HistogramValue contains a sequence of buckets and gives a count of values that fall into each bucket. Bucket boundares are defined by a formula and bucket widths are either fixed or exponentially increasing.

Configuration options for sampling elements.

Contains per-worker telemetry about the data sampling feature.

Metadata for a Datastore connector used by the job.

Describes any options that have an effect on the debugging of pipelines.

Response from deleting a snapshot.

Specification of one of the bundles produced as a result of splitting a Source (e.g. when executing a SourceSplitRequest, or when splitting an active task using WorkItemStatus.dynamic_source_split), relative to the source being split.

Describes the data disk used by a workflow job.

Data provided with a pipeline or transform to provide descriptive info.

A metric value representing a distribution.

When a task splits using WorkItemStatus.dynamic_source_split, this message describes the two parts of the split relative to the description of the current task's input.

Describes the environment in which a Dataflow Job runs.

A message describing the state of a particular execution stage.

Description of the composing transforms, names/ids, and input/outputs of a stage of execution. Some composing transforms and sources may have been generated by the Dataflow service during execution planning.

Indicates which [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) failed to respond to a request for data.

Metadata for a File connector used by the job.

An instruction that copies its inputs (zero or more) to its (single) output.

The environment values to be set at runtime for flex template. LINT.IfChange

A metric value representing a list of floating point numbers.

A representation of a floating point mean metric contribution.

Request to get updated debug configuration for component.

Response to a get debug configuration request.

The response to a GetTemplate request.

Histogram of value counts for a distribution. Buckets have an inclusive lower bound and exclusive upper bound and use "1,2,5 bucketing": The first bucket range is from [0,1) and all subsequent bucket boundaries are powers of ten multiplied by 1, 2, or 5. Thus, bucket boundaries are 0, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000, ... Negative values are not supported.

Information useful for debugging a hot key detection.

Proto describing a hot key detected on a given WorkItem.

Information about a hot key.

An input of an instruction, as a reference to an output of a producer instruction.

An output of an instruction.

A metric value representing temporal values of a variable.

A metric value representing a list of integers.

A representation of an integer mean metric contribution.

Defines a job to be run by the Cloud Dataflow service. Do not enter confidential information when you supply string values using the API.

Information about the execution of a job.

Additional information about how a Cloud Dataflow job will be executed that isn't contained in the submitted job.

Contains information about how a particular google.dataflow.v1beta3.Step will be executed.

A particular message pertaining to a Dataflow job.

Metadata available primarily for filtering jobs. Will be included in the ListJob response and Job SUMMARY view.

JobMetrics contains a collection of metrics describing the detailed progress of a Dataflow job. Metrics correspond to user-defined and system-defined metrics in the job. For more information, see [Dataflow job metrics] (https://cloud.google.com/dataflow/docs/guides/using-monitoring-intf). This resource captures only the most recent values of each metric; time-series data can be queried for them (under the same metric names) from Cloud Monitoring.

Data disk assignment information for a specific key-range of a sharded computation. Currently we only support UTF-8 character splits to simplify encoding into JSON.

Location information for a specific key-range of a sharded computation. Currently we only support UTF-8 character splits to simplify encoding into JSON.

Launch FlexTemplate Parameter.

A request to launch a Cloud Dataflow job from a FlexTemplate.

Response to the request to launch a job from Flex Template.

Parameters to provide to the template being launched. Note that the [metadata in the pipeline code] (https://cloud.google.com/dataflow/docs/guides/templates/creating-templates#metadata) determines which runtime parameters are valid.

Response to the request to launch a template.

Request to lease WorkItems.

Response to a request to lease WorkItems.

Linear buckets with the following boundaries for indices in 0 to n-1. - i in [0, n-1]: [start + (i)*width, start + (i+1)*width)

Response to a request to list job messages.

Response to a request to list Cloud Dataflow jobs in a project. This might be a partial response, depending on the page size in the ListJobsRequest. However, if the project does not have any jobs, an instance of ListJobsResponse is not returned and the requests's response body is empty {}.

List of snapshots.

MapTask consists of an ordered set of instructions, each of which describes one particular low-level operation for the worker to perform in order to accomplish the MapTask's WorkItem. Each instruction must appear in the list before any instructions which depends on its output.

Information about the memory usage of a worker or a container within a worker.

The metric short id is returned to the user alongside an offset into ReportWorkItemStatusRequest

Identifies a metric, by describing the source which generated the metric.

Describes the state of a metric.

The value of a metric along with its name and labels.

Describes mounted data disk.

Information about an output of a multi-output DoFn.

Basic metadata about a counter.

Statistics for the underflow and overflow bucket.

The packages that must be installed in order for a worker to run the steps of the Cloud Dataflow job that will be assigned to its worker pool. This is the mechanism by which the Cloud Dataflow SDK causes code to be loaded onto the workers. For example, the Cloud Dataflow Java SDK might use this to install jars containing the user's code and all of the various dependencies (libraries, data files, etc.) required in order for that code to run.

Describes a particular operation comprising a MapTask.

Structured data associated with this message.

Metadata for a specific parameter.

ParameterMetadataEnumOption specifies the option shown in the enum form.

An instruction that does a ParDo operation. Takes one main input and zero or more side inputs, and produces zero or more outputs. Runs user code.

An instruction that does a partial group-by-key. One input and one output.

Metrics for a particular unfused step and namespace. A metric is uniquely identified by the metrics_namespace, original_step, metric name and metric_labels.

Per worker metrics.

A descriptive representation of submitted pipeline as well as the executed form. This data is provided by the Dataflow service for ease of visualizing the pipeline and interpreting Dataflow provided metrics.

A point in the timeseries.

Position defines a position within a collection of data. The value can be either the end position, a key (used with ordered collections), a byte offset, or a record index.

Information about the progress of some component of job execution.

Additional options for Dataflow#projectsDeleteSnapshots.

Additional options for Dataflow#projectsJobsAggregated.

Additional options for Dataflow#projectsJobsCreate.

Additional options for Dataflow#projectsJobsGetMetrics.

Additional options for Dataflow#projectsJobsGet.

Additional options for Dataflow#projectsJobsList.

Additional options for Dataflow#projectsJobsMessagesList.

Additional options for Dataflow#projectsJobsUpdate.

Additional options for Dataflow#projectsLocationsJobsCreate.

Additional options for Dataflow#projectsLocationsJobsGetExecutionDetails.

Additional options for Dataflow#projectsLocationsJobsGetMetrics.

Additional options for Dataflow#projectsLocationsJobsGet.

Additional options for Dataflow#projectsLocationsJobsList.

Additional options for Dataflow#projectsLocationsJobsMessagesList.

Additional options for Dataflow#projectsLocationsJobsStagesGetExecutionDetails.

Additional options for Dataflow#projectsLocationsJobsUpdate.

Additional options for Dataflow#projectsLocationsSnapshotsList.

Additional options for Dataflow#projectsLocationsTemplatesGet.

Additional options for Dataflow#projectsLocationsTemplatesLaunch.

Additional options for Dataflow#projectsSnapshotsGet.

Additional options for Dataflow#projectsSnapshotsList.

Additional options for Dataflow#projectsTemplatesGet.

Additional options for Dataflow#projectsTemplatesLaunch.

Metadata for a Pub/Sub connector used by the job.

Identifies a pubsub location to use for transferring data into or out of a streaming Dataflow job.

Represents a Pubsub snapshot.

An instruction that reads records. Takes no inputs, produces one output.

Represents the level of parallelism in a WorkItem's input, reported by the worker.

Request to report the status of WorkItems.

Response from a request to report the status of WorkItems.

Worker metrics exported from workers. This contains resource utilization metrics accumulated from a variety of sources. For more information, see go/df-resource-signals.

Service-side response to WorkerMessage reporting resource utilization.

The environment values to set at runtime. LINT.IfChange

RuntimeMetadata describing a runtime environment.

Additional job parameters that can only be updated during runtime using the projects.jobs.update method. These fields have no effect when specified during job creation.

A bug found in the Dataflow SDK.

Defines an SDK harness container for executing Dataflow pipelines.

SDK Information.

The version of the SDK used to run the job.

Request to send encoded debug information. Next ID: 8

Response to a send capture request. nothing

A request for sending worker messages to the service.

The response to the worker messages.

Describes a particular function to invoke.

Information about an output of a SeqMapTask.

A task which consists of a shell command for the worker to execute.

Information about a side input of a DoFn or an input of a SeqDoFn.

A sink that records can be encoded and written to.

Represents a snapshot of a job.

Request to create a snapshot of a job.

A source that records can be read and decoded from.

DEPRECATED in favor of DynamicSourceSplit.

A request to compute the SourceMetadata of a Source.

The result of a SourceGetMetadataOperation.

Metadata about a Source useful for automatically optimizing and tuning the pipeline, etc.

A work item that represents the different operations that can be performed on a user-defined Source specification.

The result of a SourceOperationRequest, specified in ReportWorkItemStatusRequest.source_operation when the work item is completed.

Hints for splitting a Source into bundles (parts for parallel processing) using SourceSplitRequest.

Represents the operation to split a high-level Source specification into bundles (parts for parallel processing). At a high level, splitting of a source into bundles happens as follows: SourceSplitRequest is applied to the source. If it returns SOURCE_SPLIT_OUTCOME_USE_CURRENT, no further splitting happens and the source is used "as is". Otherwise, splitting is applied recursively to each produced DerivedSource. As an optimization, for any Source, if its does_not_need_splitting is true, the framework assumes that splitting this source would return SOURCE_SPLIT_OUTCOME_USE_CURRENT, and doesn't initiate a SourceSplitRequest. This applies both to the initial source being split and to bundles produced from it.

The response to a SourceSplitRequest.

DEPRECATED in favor of DerivedSource.

Metadata for a Spanner connector used by the job.

A representation of an int64, n, that is immune to precision loss when encoded in JSON.

Information about the workers and work items within a stage.

Description of an input or output of an execution stage.

Information about a particular execution stage of a job.

State family configuration.

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.

Defines a particular step within a Cloud Dataflow job. A job consists of multiple steps, each of which performs some specific operation as part of the overall job. Data is typically passed from one step to another as part of the job. Note: The properties of this object are not stable and might change. Here's an example of a sequence of steps which together implement a Map-Reduce job: * Read a collection of data from some source, parsing the collection's elements. * Validate the elements. * Apply a user-defined function to map each element to some value and extract an element-specific key value. * Group elements with the same key into a single element with that key, transforming a multiply-keyed collection into a uniquely-keyed collection. * Write the elements out to some data sink. Note that the Cloud Dataflow service may be used to run many different types of jobs, not just Map-Reduce.

Information for a straggler.

Information useful for debugging a straggler. Each type will provide specialized debugging information relevant for a particular cause. The StragglerDebuggingInfo will be 1:1 mapping to the StragglerCause enum.

Information useful for straggler identification and debugging.

Summarized straggler identification details.

Streaming appliance snapshot configuration.

Configuration information for a single streaming computation.

Describes full or partial data disk assignment information of the computation ranges.

A task which describes what action should be performed for the specified streaming computation ranges.

A task that carries configuration information for streaming computations.

Contains per-user worker telemetry used in streaming autoscaling.

Contains per-user-worker streaming scaling recommendation from the backend.

A task which initializes part of a streaming Dataflow job.

Identifies the location of a streaming side input.

Identifies the location of a streaming computation stage, for stage-to-stage communication.

Information useful for streaming straggler identification and debugging.

Describes a stream of data, either as input to be processed or as output of a streaming Dataflow job.

A metric value representing a list of strings.

A rich message format, including a human readable string, a key for identifying the message, and structured data associated with the message for programmatic consumption.

Taskrunner configuration settings.

Metadata describing a template.

Global topology of the streaming Dataflow job, including all computations and their sharded locations.

Description of the type, names/ids, and input/outputs for a transform.

Information about a worker

WorkerHealthReport contains information about the health of a worker. The VM should be identified by the labels attached to the WorkerMessage that this health ping belongs to.

WorkerHealthReportResponse contains information returned to the worker in response to a health ping.

A report of an event in a worker's lifecycle. The proto contains one event, because the worker is expected to asynchronously send each message immediately after the event. Due to this asynchrony, messages may arrive out of order (or missing), and it is up to the consumer to interpret. The timestamp of the event is in the enclosing WorkerMessage proto.

WorkerMessage provides information to the backend about a worker.

A message code is used to report status and error messages to the service. The message codes are intended to be machine readable. The service will take care of translating these into user understandable messages if necessary. Example use cases: 1. Worker processes reporting successful startup. 2. Worker processes reporting specific errors (e.g. package staging failure).

A worker_message response allows the server to pass information to the sender.

Describes one particular pool of Cloud Dataflow workers to be instantiated by the Cloud Dataflow service in order to perform the computations required by a job. Note that a workflow job may use multiple pools, in order to match the various computational requirements of the various stages of the job.

Provides data to pass through to the worker harness.

Shutdown notification from workers. This is to be sent by the shutdown script of the worker VM so that the backend knows that the VM is being shut down.

Service-side response to WorkerMessage issuing shutdown notice.

Contains information about the thread scaling information of a worker.

Contains the thread scaling recommendation for a worker from the backend.

WorkItem represents basic information about a WorkItem to be executed in the cloud.

Information about an individual work item execution.

The Dataflow service's idea of the current state of a WorkItem being processed by a worker.

Conveys a worker's progress through the work described by a WorkItem.

An instruction that writes records. Takes one input, produces no outputs.