org.apache.beam.sdk.extensions.gcp.options

Interface GcsOptions

All Superinterfaces:

ApplicationNameOptions, GcpOptions, GoogleApiDebugOptions, HasDisplayData, PipelineOptions

All Known Subinterfaces:

DataflowPipelineOptions, DataflowWorkerHarnessOptions, TestDataflowPipelineOptions

public interface GcsOptions
extends ApplicationNameOptions, GcpOptions, PipelineOptions

Options used to configure Google Cloud Storage.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	GcsOptions.ExecutorServiceFactory Returns the default ExecutorService to use within the Apache Beam SDK.
static class	GcsOptions.PathValidatorFactory Creates a PathValidator object using the class specified in getPathValidatorClass().

Nested classes/interfaces inherited from interface org.apache.beam.sdk.extensions.gcp.options.GcpOptions

GcpOptions.DefaultProjectFactory, GcpOptions.EnableStreamingEngineFactory, GcpOptions.GcpTempLocationFactory, GcpOptions.GcpUserCredentialsFactory

Nested classes/interfaces inherited from interface org.apache.beam.sdk.extensions.gcp.options.GoogleApiDebugOptions

GoogleApiDebugOptions.GoogleApiTracer

Nested classes/interfaces inherited from interface org.apache.beam.sdk.options.PipelineOptions

PipelineOptions.AtomicLongFactory, PipelineOptions.CheckEnabled, PipelineOptions.DirectRunner, PipelineOptions.JobNameFactory, PipelineOptions.UserAgentFactory

Field Summary

Fields inherited from interface org.apache.beam.sdk.extensions.gcp.options.GcpOptions

STREAMING_ENGINE_EXPERIMENT, WINDMILL_SERVICE_EXPERIMENT

Method Summary

Modifier and Type	Method and Description
java.util.concurrent.ExecutorService	getExecutorService() The ExecutorService instance to use to create threads, can be overridden to specify an ExecutorService that is compatible with the user's environment.
java.lang.String	getGcsEndpoint() GCS endpoint to use.
java.lang.Boolean	getGcsPerformanceMetrics() If true, reports metrics of certain operations, such as batch copies.
java.lang.Integer	getGcsUploadBufferSizeBytes() The buffer size (in bytes) to use when uploading files to GCS.
GcsUtil	getGcsUtil() The GcsUtil instance that should be used to communicate with Google Cloud Storage.
PathValidator	getPathValidator() The path validator instance that should be used to validate paths.
java.lang.Class<? extends PathValidator>	getPathValidatorClass() The class of the validator that should be created and used to validate paths.
java.lang.Boolean	getUseGrpcForGcs() If true, uses gRPC as the transport.
void	setExecutorService(java.util.concurrent.ExecutorService value)
void	setGcsEndpoint(java.lang.String value)
void	setGcsPerformanceMetrics(java.lang.Boolean reportPerformanceMetrics)
void	setGcsUploadBufferSizeBytes(java.lang.Integer bytes)
void	setGcsUtil(GcsUtil value)
void	setPathValidator(PathValidator validator)
void	setPathValidatorClass(java.lang.Class<? extends PathValidator> validatorClass)
void	setUseGrpcForGcs(java.lang.Boolean useGrpc)

Methods inherited from interface org.apache.beam.sdk.options.ApplicationNameOptions

getAppName, setAppName

Methods inherited from interface org.apache.beam.sdk.extensions.gcp.options.GcpOptions

getCredentialFactoryClass, getDataflowKmsKey, getGcpCredential, getGcpTempLocation, getProject, getWorkerRegion, getWorkerZone, getZone, isEnableStreamingEngine, setCredentialFactoryClass, setDataflowKmsKey, setEnableStreamingEngine, setGcpCredential, setGcpTempLocation, setProject, setWorkerRegion, setWorkerZone, setZone

Methods inherited from interface org.apache.beam.sdk.extensions.gcp.options.GoogleApiDebugOptions

getGoogleApiTrace, setGoogleApiTrace

Methods inherited from interface org.apache.beam.sdk.options.PipelineOptions

as, getJobName, getOptionsId, getRunner, getStableUniqueNames, getTempLocation, getUserAgent, outputRuntimeOptions, setJobName, setOptionsId, setRunner, setStableUniqueNames, setTempLocation, setUserAgent

Methods inherited from interface org.apache.beam.sdk.transforms.display.HasDisplayData

populateDisplayData

Method Detail

getGcsUtil

@Default.InstanceFactory(value=GcsUtil.GcsUtilFactory.class)
 @Hidden
GcsUtil getGcsUtil()

The GcsUtil instance that should be used to communicate with Google Cloud Storage.

setGcsUtil

void setGcsUtil(GcsUtil value)

getExecutorService

@Default.InstanceFactory(value=GcsOptions.ExecutorServiceFactory.class)
 @Hidden
java.util.concurrent.ExecutorService getExecutorService()

The ExecutorService instance to use to create threads, can be overridden to specify an ExecutorService that is compatible with the user's environment. If unset, the default is to create an ExecutorService with an unbounded number of threads; this is compatible with Google AppEngine.

setExecutorService

void setExecutorService(java.util.concurrent.ExecutorService value)

getGcsEndpoint

@Hidden
java.lang.String getGcsEndpoint()

GCS endpoint to use. If unspecified, uses the default endpoint.

setGcsEndpoint

void setGcsEndpoint(java.lang.String value)

getGcsUploadBufferSizeBytes

@Nullable
java.lang.Integer getGcsUploadBufferSizeBytes()

The buffer size (in bytes) to use when uploading files to GCS. Please see the documentation for AbstractGoogleAsyncWriteChannel.setUploadBufferSize(int) for more information on the restrictions and performance implications of this value.

setGcsUploadBufferSizeBytes

void setGcsUploadBufferSizeBytes(@Nullable
                                 java.lang.Integer bytes)

getPathValidatorClass

@Default.Class(value=GcsPathValidator.class)
java.lang.Class<? extends PathValidator> getPathValidatorClass()

The class of the validator that should be created and used to validate paths. If pathValidator has not been set explicitly, an instance of this class will be constructed and used as the path validator.

setPathValidatorClass

void setPathValidatorClass(java.lang.Class<? extends PathValidator> validatorClass)

getPathValidator

@Default.InstanceFactory(value=GcsOptions.PathValidatorFactory.class)
PathValidator getPathValidator()

The path validator instance that should be used to validate paths. If no path validator has been set explicitly, the default is to use the instance factory that constructs a path validator based upon the currently set pathValidatorClass.

setPathValidator

void setPathValidator(PathValidator validator)

getGcsPerformanceMetrics

@Default.Boolean(value=false)
 @Experimental(value=FILESYSTEM)
java.lang.Boolean getGcsPerformanceMetrics()

If true, reports metrics of certain operations, such as batch copies.

setGcsPerformanceMetrics

void setGcsPerformanceMetrics(java.lang.Boolean reportPerformanceMetrics)

getUseGrpcForGcs

@Default.Boolean(value=false)
java.lang.Boolean getUseGrpcForGcs()

If true, uses gRPC as the transport.

setUseGrpcForGcs

void setUseGrpcForGcs(java.lang.Boolean useGrpc)