config

package
v3.66.3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 3, 2024 License: Apache-2.0 Imports: 17 Imported by: 2

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	// DefaultKeepaliveInterval contains default duration between grpc keepalive
	DefaultKeepaliveInterval    = 10 * time.Second
	MinKeepaliveInterval        = 10 * time.Second
	DefaultDialTimeout          = 5 * time.Second
	DefaultGRPCMsgSize          = 64 * 1024 * 1024 // 64MB
	DefaultGrpcConnectionPolicy = keepalive.ClientParameters{
		Time:                DefaultKeepaliveInterval,
		Timeout:             MinKeepaliveInterval,
		PermitWithoutStream: true,
	}
)

Functions

This section is empty.

Types

type Config 

type Config struct {
	config.Common
	// contains filtered or unexported fields
}

Config contains driver configuration.

func New 

func New(opts ...Option) *Config

func (*Config) Balancer added in v3.6.0 

func (c *Config) Balancer() *balancerConfig.Config

Balancer is an optional configuration related to selected balancer. That is, some balancing methods allow to be configured.

func (*Config) ConnectionTTL added in v3.7.0 

func (c *Config) ConnectionTTL() time.Duration

ConnectionTTL defines interval for parking grpc connections.

If ConnectionTTL is zero - connections are not park.

func (*Config) Credentials 

func (c *Config) Credentials() credentials.Credentials

func (*Config) Database 

func (c *Config) Database() string

Database is a required database name.

func (*Config) DialTimeout 

func (c *Config) DialTimeout() time.Duration

DialTimeout is the maximum amount of time a dial will wait for a connect to complete.

If DialTimeout is zero then no timeout is used.

func (*Config) Endpoint 

func (c *Config) Endpoint() string

Endpoint is a required starting endpoint for connect

func (*Config) ExcludeGRPCCodesForPessimization added in v3.16.8 

func (c *Config) ExcludeGRPCCodesForPessimization() []grpcCodes.Code

ExcludeGRPCCodesForPessimization defines grpc codes for exclude its from pessimization trigger

func (*Config) GrpcDialOptions added in v3.5.0 

func (c *Config) GrpcDialOptions() []grpc.DialOption

GrpcDialOptions reports about used grpc dialing options

func (*Config) Meta added in v3.7.0 

func (c *Config) Meta() *meta.Meta

Meta reports meta information about database connection

func (*Config) Secure 

func (c *Config) Secure() bool

Secure is a flag for secure connection

func (*Config) TLSConfig 

func (c *Config) TLSConfig() *tls.Config

TLSConfig reports about TLS configuration

func (*Config) Trace 

func (c *Config) Trace() *trace.Driver

Trace contains driver tracing options.

func (*Config) With added in v3.34.0 

func (c *Config) With(opts ...Option) *Config

With makes copy of current Config with specified options

type Option 

type Option func(c *Config)

func ExcludeGRPCCodesForPessimization added in v3.16.8 

func ExcludeGRPCCodesForPessimization(codes ...grpcCodes.Code) Option

func WithApplicationName added in v3.57.4 

func WithApplicationName(applicationName string) Option

WithApplicationName add provided application name to all api requests

func WithBalancer added in v3.6.0 

func WithBalancer(balancer *balancerConfig.Config) Option

func WithCertificate 

func WithCertificate(certificate *x509.Certificate) Option

WithCertificate appends certificate to TLS config root certificates

func WithConnectionTTL added in v3.7.0 

func WithConnectionTTL(ttl time.Duration) Option

func WithCredentials 

func WithCredentials(credentials credentials.Credentials) Option

func WithDatabase 

func WithDatabase(database string) Option

func WithDialTimeout 

func WithDialTimeout(timeout time.Duration) Option

func WithEndpoint 

func WithEndpoint(endpoint string) Option

func WithGrpcOptions added in v3.5.0 

func WithGrpcOptions(option ...grpc.DialOption) Option

WithGrpcOptions appends custom grpc dial options to defaults

func WithInternalDNSResolver deprecated added in v3.16.0 

func WithInternalDNSResolver() Option

WithInternalDNSResolver

Deprecated: always used internal dns-resolver. Will be removed after Oct 2024. Read about versioning policy: https://github.com/ydb-platform/ydb-go-sdk/blob/master/VERSIONING.md#deprecated

func WithMinTLSVersion added in v3.9.1 

func WithMinTLSVersion(minVersion uint16) Option

WithMinTLSVersion applies minimum TLS version that is acceptable.

func WithNoAutoRetry added in v3.24.0 

func WithNoAutoRetry() Option

WithNoAutoRetry disable auto-retry calls from YDB sub-clients

func WithOperationCancelAfter 

func WithOperationCancelAfter(operationCancelAfter time.Duration) Option

WithOperationCancelAfter sets the maximum amount of time a YDB server will process an operation. After timeout exceeds YDB will try to cancel operation and if it succeeds appropriate error will be returned to the client; otherwise processing will be continued.

If OperationCancelAfter is zero then no timeout is used.

func WithOperationTimeout 

func WithOperationTimeout(operationTimeout time.Duration) Option

WithOperationTimeout defines the maximum amount of time a YDB server will process an operation. After timeout exceeds YDB will try to cancel operation and regardless of the cancellation appropriate error will be returned to the client.

If OperationTimeout is zero then no timeout is used.

func WithPanicCallback added in v3.21.0 

func WithPanicCallback(panicCallback func(e interface{})) Option

WithPanicCallback applies panic callback to config

func WithRequestsType 

func WithRequestsType(requestsType string) Option

func WithRetryBudget added in v3.66.0 

func WithRetryBudget(b budget.Budget) Option

Experimental: https://github.com/ydb-platform/ydb-go-sdk/blob/master/VERSIONING.md#experimental

func WithSecure 

func WithSecure(secure bool) Option

WithSecure changes secure connection flag.

Warning: if secure is false - TLS config options has no effect.

func WithTLSConfig added in v3.23.0 

func WithTLSConfig(tlsConfig *tls.Config) Option

WithTLSConfig replaces older TLS config

Warning: all early changes of TLS config will be lost

func WithTLSSInsecureSkipVerify added in v3.11.0 

func WithTLSSInsecureSkipVerify() Option

WithTLSSInsecureSkipVerify applies InsecureSkipVerify flag to TLS config

func WithTrace 

func WithTrace(t trace.Driver, opts ...trace.DriverComposeOption) Option

func WithTraceRetry added in v3.54.0 

func WithTraceRetry(t *trace.Retry, opts ...trace.RetryComposeOption) Option

func WithUserAgent deprecated added in v3.7.0 

func WithUserAgent(userAgent string) Option

WithUserAgent add provided user agent to all api requests

Deprecated: use WithApplicationName instead. Will be removed after Oct 2024. Read about versioning policy: https://github.com/ydb-platform/ydb-go-sdk/blob/master/VERSIONING.md#deprecated

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.