Click or drag to resize

DseClusterBuilder Class

Helper class to build DseCluster instances.
Inheritance Hierarchy
SystemObject
  DseBuilder
    DseDseClusterBuilder

Namespace:  Dse
Assembly:  Dse (in Dse.dll) Version: 2.6.0
Syntax
C#
public class DseClusterBuilder : Builder

The DseClusterBuilder type exposes the following members.

Constructors
  NameDescription
Public methodDseClusterBuilder
Creates a new instance of DseClusterBuilder.
Top
Properties
  NameDescription
Public propertyApplicationName
The name of the application using the created cluster instance.
Public propertyApplicationVersion
The version of the application using the created cluster instance.
Public propertyClusterId
A unique identifier for the created cluster instance.
Public propertyContactPoints
Gets the contact points that were added as IPEndPoint" instances.

Note that only contact points that were added using AddContactPoint(IPEndPoint) and AddContactPoints(IPEndPoint) are returned by this property, as IP addresses and host names must be resolved and assigned the port number, which is performed on Build.

(Inherited from Builder.)
Public propertyGraphOptions
Gets the DSE Graph options.
Public propertyPoolingOptions
The pooling options used by this builder.
(Inherited from Builder.)
Public propertySocketOptions
The socket options used by this builder.
(Inherited from Builder.)
Top
Methods
  NameDescription
Public methodAddContactPoint(IPAddress)
Add contact point. See AddContactPoint(String) for more details on contact points.
Public methodAddContactPoint(IPEndPoint)
Add contact point. See AddContactPoint(String) for more details on contact points.
Public methodAddContactPoint(String)
Adds a contact point. Contact points are addresses of Cassandra nodes that the driver uses to discover the cluster topology. Only one contact point is required (the driver will retrieve the address of the other nodes automatically), but it is usually a good idea to provide more than one contact point, as if that unique contact point is not available, the driver won't be able to initialize itself correctly.
Public methodAddContactPoints(IEnumerableIPAddress)
Add contact points. See Builder.AddContactPoint for more details on contact points.
Public methodAddContactPoints(IEnumerableIPEndPoint)
Add contact points. See Builder.AddContactPoint for more details on contact points.
Public methodAddContactPoints(IEnumerableString)
Add contact points. See Builder.AddContactPoint for more details on contact points.
Public methodAddContactPoints(IPAddress)
Add contact points. See Builder.AddContactPoint for more details on contact points.
Public methodAddContactPoints(IPEndPoint)
Add contact points. See Builder.AddContactPoint for more details on contact points.
Public methodAddContactPoints(String)
Add contact points. See AddContactPoint(String) for more details on contact points.
Public methodBuild
Builds the cluster with the configured set of initial contact points and policies.
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public methodGetConfiguration
The configuration that will be used for the new cluster.

You should not modify this object directly as change made to the returned object may not be used by the cluster build. Instead, you should use the other methods of this Builder

.
(Inherited from Builder.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodWithAddressTranslator
Configures the address translater to use for the new cluster.
Public methodWithApplicationName

An optional configuration identifying the name of the application using this cluster instance.

This value is passed to DSE and is useful as metadata for describing a client connection.
Public methodWithApplicationVersion

An optional configuration identifying the version of the application using this cluster instance.

This value is passed to DSE and is useful as metadata for describing a client connection.
Public methodWithAuthProvider
Use the specified AuthProvider when connecting to Cassandra hosts.

Use this method when a custom authentication scheme is in place. You shouldn't call both this method and {@code withCredentials}' on the same Builder instance as one will supersede the other

Public methodWithClusterId

An optional configuration for providing a unique identifier for the created cluster instance.

If not provided, an id will generated.

This value is passed to DSE and is useful as metadata for describing a client connection.

Public methodWithCompression
Sets the compression to use for the transport.
Public methodWithConnectionString
Configure the cluster by applying settings from ConnectionString.
Public methodWithCredentials
Uses the provided credentials when connecting to Cassandra hosts.

This should be used if the Cassandra cluster has been configured to use the PasswordAuthenticator. If the the default * AllowAllAuthenticator is used instead, using this method has no effect.

Public methodWithCustomCompressor
Sets a custom compressor to be used for the compression type. If specified, the compression type is mandatory. If not specified the driver default compressor will be use for the compression type.
Public methodWithDefaultKeyspace
Sets default keyspace name for the created cluster.
Public methodWithGraphOptions
Sets the DSE Graph options.
Public methodWithLoadBalancingPolicy
Configures the load balancing policy to use for the new cluster.

If no load balancing policy is set through this method, DseLoadBalancingPolicy will be used instead.

Public methodWithMaxProtocolVersion(Byte)

Limits the maximum protocol version used to connect to the nodes, when it is not set protocol version used between the driver and the Cassandra cluster is negotiated upon establishing the first connection.

Useful for using the driver against a cluster that contains nodes with different major/minor versions of Cassandra. For example, preparing for a rolling upgrade of the Cluster.

Public methodWithMaxProtocolVersion(ProtocolVersion)

Limits the maximum protocol version used to connect to the nodes

When it is not set, the protocol version used is negotiated between the driver and the Cassandra cluster upon establishing the first connection.

Useful when connecting to a cluster that contains nodes with different major/minor versions of Cassandra. For example, preparing for a rolling upgrade of the Cluster.

(Inherited from Builder.)
Public methodWithMaxSchemaAgreementWaitSeconds
Sets the maximum time to wait for schema agreement before returning from a DDL query.

DDL queries introduce schema changes that need to be propagated to all nodes in the cluster. Once they have settled on a common version, we say that they are in agreement.

If not set through this method, the default value (10 seconds) will be used.

(Inherited from Builder.)
Public methodWithMonitorReporting
Configures options related to Monitor Reporting for the new cluster. By default, Monitor Reporting is enabled.
Public methodWithNoCompact
Enables the NO_COMPACT startup option.

When this option is set, SELECT, UPDATE, DELETE, and BATCH statements on COMPACT STORAGE tables function in "compatibility" mode which allows seeing these tables as if they were "regular" CQL tables.

This option only affects interactions with tables using COMPACT STORAGE and it is only supported by DSE 5.1 and 6.0+.

Public methodWithoutRowSetBuffering
Disables row set buffering for the created cluster (row set buffering is enabled by default otherwise).
(Inherited from Builder.)
Public methodWithPoolingOptions
Sets the pooling options for the cluster.
Public methodWithPort
The port to use to connect to all Cassandra hosts. If not set through this method, the default port (9042) will be used instead.
Public methodWithQueryOptions
Sets the QueryOptions to use for the newly created Cluster. If no query options are set through this method, default query options will be used.
Public methodWithQueryTimeout
Specifies the number of milliseconds that the driver should wait for the response before the query times out in a synchronous operation.

This will cause that synchronous operations like Execute(String) to throw a TimeoutException after the specified number of milliseconds.

Default timeout value is set to
20,000
(20 seconds).
Public methodWithReconnectionPolicy
Configure the reconnection policy to use for the new cluster.

If no reconnection policy is set through this method, Policies.DefaultReconnectionPolicy will be used instead.

Public methodWithRetryPolicy
Configure the retry policy to use for the new cluster.

If no retry policy is set through this method, IdempotenceAwareRetryPolicy will be used instead.

Public methodWithSocketOptions
Configures the socket options that are going to be used to create the connections to the hosts.
Public methodWithSpeculativeExecutionPolicy
Configure the speculative execution to use for the new cluster.

If no speculative execution policy is set through this method, DefaultSpeculativeExecutionPolicy will be used instead.

Public methodWithSSL
Enables the use of SSL for the created Cluster. Calling this method will use default SSL options.
Public methodWithSSL(SSLOptions)
Enables the use of SSL for the created Cluster using the provided options.
Public methodWithTimestampGenerator
Configures the generator that will produce the client-side timestamp sent with each query.

This feature is only available with protocol version 3 or above of the native protocol. With earlier versions, timestamps are always generated server-side, and setting a generator through this method will have no effect.

If no generator is set through this method, the driver will default to client-side timestamps by using AtomicMonotonicTimestampGenerator.

(Inherited from Builder.)
Public methodWithTypeSerializers
Top
Fields
  NameDescription
Public fieldStatic memberDefaultApplicationName
Top
See Also

Reference