options

package
v3.18.3-rc0 Latest Latest
Warning

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

Go to latest
Published: Apr 7, 2022 License: Apache-2.0 Imports: 7 Imported by: 24

Documentation

Index

Constants

View Source
const (
	FeatureEnabled  = feature.Enabled
	FeatureDisabled = feature.Disabled
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AlterTableDesc

type AlterTableDesc Ydb_Table.AlterTableRequest

type AlterTableOption

type AlterTableOption func(*AlterTableDesc)

func WithAddColumn

func WithAddColumn(name string, typ types.Type) AlterTableOption

func WithAddColumnFamilies

func WithAddColumnFamilies(cf ...ColumnFamily) AlterTableOption

func WithAddColumnMeta

func WithAddColumnMeta(column Column) AlterTableOption

func WithAlterAttribute

func WithAlterAttribute(key, value string) AlterTableOption

func WithAlterColumnFamilies

func WithAlterColumnFamilies(cf ...ColumnFamily) AlterTableOption

func WithAlterKeyBloomFilter

func WithAlterKeyBloomFilter(f FeatureFlag) AlterTableOption

func WithAlterPartitionSettingsObject

func WithAlterPartitionSettingsObject(ps PartitioningSettings) AlterTableOption

func WithAlterReadReplicasSettings

func WithAlterReadReplicasSettings(rr ReadReplicasSettings) AlterTableOption

func WithAlterStorageSettings

func WithAlterStorageSettings(ss StorageSettings) AlterTableOption

func WithDropColumn

func WithDropColumn(name string) AlterTableOption

func WithDropTimeToLive

func WithDropTimeToLive() AlterTableOption

func WithSetTimeToLiveSettings

func WithSetTimeToLiveSettings(settings TimeToLiveSettings) AlterTableOption

type CachingPolicyDescription

type CachingPolicyDescription struct {
	Name   string
	Labels map[string]string
}

type CachingPolicyOption

type CachingPolicyOption func(*cachingPolicy)

func WithCachingPolicyPreset

func WithCachingPolicyPreset(name string) CachingPolicyOption

type Column

type Column struct {
	Name   string
	Type   types.Type
	Family string
}

func NewTableColumn

func NewTableColumn(name string, typ types.Type, family string) Column

type ColumnFamily

type ColumnFamily struct {
	Name         string
	Data         StoragePool
	Compression  ColumnFamilyCompression
	KeepInMemory FeatureFlag
}

func NewColumnFamily

func NewColumnFamily(c *Ydb_Table.ColumnFamily) ColumnFamily

type ColumnFamilyCompression

type ColumnFamilyCompression byte
const (
	ColumnFamilyCompressionUnknown ColumnFamilyCompression = iota
	ColumnFamilyCompressionNone
	ColumnFamilyCompressionLZ4
)

func (ColumnFamilyCompression) String

func (c ColumnFamilyCompression) String() string

type CommitTransactionOption

type CommitTransactionOption func(*CommitTransactionDesc)

func WithCommitCollectStatsModeBasic

func WithCommitCollectStatsModeBasic() CommitTransactionOption

func WithCommitCollectStatsModeNone

func WithCommitCollectStatsModeNone() CommitTransactionOption

type CompactionPolicyDescription

type CompactionPolicyDescription struct {
	Name   string
	Labels map[string]string
}

type CompactionPolicyOption

type CompactionPolicyOption func(*compactionPolicy)

func WithCompactionPolicyPreset

func WithCompactionPolicyPreset(name string) CompactionPolicyOption

type CopyTableDesc

type CopyTableDesc Ydb_Table.CopyTableRequest

type CopyTableOption

type CopyTableOption func(*CopyTableDesc)

type CreateTableDesc

type CreateTableDesc Ydb_Table.CreateTableRequest

type CreateTableOption

type CreateTableOption func(d *CreateTableDesc)

func WithAttribute

func WithAttribute(key, value string) CreateTableOption

func WithColumn

func WithColumn(name string, typ types.Type) CreateTableOption

func WithColumnFamilies

func WithColumnFamilies(cf ...ColumnFamily) CreateTableOption

func WithColumnMeta

func WithColumnMeta(column Column) CreateTableOption

func WithIndex

func WithIndex(name string, opts ...IndexOption) CreateTableOption

func WithKeyBloomFilter

func WithKeyBloomFilter(f FeatureFlag) CreateTableOption

func WithPartitioningSettings added in v3.3.2

func WithPartitioningSettings(opts ...PartitioningSettingsOption) CreateTableOption

func WithPartitioningSettingsObject

func WithPartitioningSettingsObject(ps PartitioningSettings) CreateTableOption

func WithPrimaryKeyColumn

func WithPrimaryKeyColumn(columns ...string) CreateTableOption

func WithProfile

func WithProfile(opts ...ProfileOption) CreateTableOption

func WithReadReplicasSettings

func WithReadReplicasSettings(rr ReadReplicasSettings) CreateTableOption

func WithStorageSettings

func WithStorageSettings(ss StorageSettings) CreateTableOption

func WithTimeToLiveSettings

func WithTimeToLiveSettings(settings TimeToLiveSettings) CreateTableOption

type DescribeTableDesc

type DescribeTableDesc Ydb_Table.DescribeTableRequest

type DescribeTableOption

type DescribeTableOption func(d *DescribeTableDesc)

func WithPartitionStats

func WithPartitionStats() DescribeTableOption

func WithShardKeyBounds

func WithShardKeyBounds() DescribeTableOption

func WithTableStats

func WithTableStats() DescribeTableOption

type Description

type Description struct {
	Name                 string
	Columns              []Column
	PrimaryKey           []string
	KeyRanges            []KeyRange
	Stats                *TableStats
	ColumnFamilies       []ColumnFamily
	Attributes           map[string]string
	ReadReplicaSettings  ReadReplicasSettings
	StorageSettings      StorageSettings
	KeyBloomFilter       FeatureFlag
	PartitioningSettings PartitioningSettings
	Indexes              []IndexDescription
	TimeToLiveSettings   *TimeToLiveSettings
}

type DropTableDesc

type DropTableDesc Ydb_Table.DropTableRequest

type DropTableOption

type DropTableOption func(*DropTableDesc)

type ExecuteDataQueryDesc

type ExecuteDataQueryDesc Ydb_Table.ExecuteDataQueryRequest

type ExecuteDataQueryOption

type ExecuteDataQueryOption func(*ExecuteDataQueryDesc)

func WithCollectStatsModeBasic

func WithCollectStatsModeBasic() ExecuteDataQueryOption

func WithCollectStatsModeNone

func WithCollectStatsModeNone() ExecuteDataQueryOption

func WithQueryCachePolicy

func WithQueryCachePolicy(opts ...QueryCachePolicyOption) ExecuteDataQueryOption

type ExecuteScanQueryDesc

type ExecuteScanQueryDesc Ydb_Table.ExecuteScanQueryRequest

type ExecuteScanQueryOption

type ExecuteScanQueryOption func(*ExecuteScanQueryDesc)

type ExecuteScanQueryRequestMode

type ExecuteScanQueryRequestMode byte
const (
	ExecuteScanQueryRequestModeExec ExecuteScanQueryRequestMode = iota
	ExecuteScanQueryRequestModeExplain
)

type ExecuteSchemeQueryOption

type ExecuteSchemeQueryOption func(*ExecuteSchemeQueryDesc)

type ExecutionPolicyDescription

type ExecutionPolicyDescription struct {
	Name   string
	Labels map[string]string
}

type ExecutionPolicyOption

type ExecutionPolicyOption func(*executionPolicy)

func WithExecutionPolicyPreset

func WithExecutionPolicyPreset(name string) ExecutionPolicyOption

type FeatureFlag

type FeatureFlag = feature.Flag

type IndexDescription

type IndexDescription struct {
	Name         string
	IndexColumns []string
	Status       Ydb_Table.TableIndexDescription_Status
}

type IndexOption

type IndexOption func(d *indexDesc)

func WithIndexColumns

func WithIndexColumns(columns ...string) IndexOption

func WithIndexType

func WithIndexType(t IndexType) IndexOption

type IndexType

type IndexType interface {
	// contains filtered or unexported methods
}

func GlobalAsyncIndex

func GlobalAsyncIndex() IndexType

func GlobalIndex

func GlobalIndex() IndexType

type KeyRange

type KeyRange struct {
	From types.Value
	To   types.Value
}

func (KeyRange) String added in v3.7.0

func (kr KeyRange) String() string

type PartitionStats

type PartitionStats struct {
	RowsEstimate uint64
	StoreSize    uint64
}

type PartitioningMode

type PartitioningMode byte
const (
	PartitioningUnknown PartitioningMode = iota
	PartitioningDisabled
	PartitioningAutoSplit
	PartitioningAutoSplitMerge
)

type PartitioningPolicyDescription

type PartitioningPolicyDescription struct {
	Name   string
	Labels map[string]string
}

type PartitioningPolicyOption

type PartitioningPolicyOption func(*partitioningPolicy)

func WithPartitioningPolicyExplicitPartitions

func WithPartitioningPolicyExplicitPartitions(splitPoints ...types.Value) PartitioningPolicyOption

func WithPartitioningPolicyMode

func WithPartitioningPolicyMode(mode PartitioningMode) PartitioningPolicyOption

func WithPartitioningPolicyPreset

func WithPartitioningPolicyPreset(name string) PartitioningPolicyOption

func WithPartitioningPolicyUniformPartitions

func WithPartitioningPolicyUniformPartitions(n uint64) PartitioningPolicyOption

type PartitioningSettings

type PartitioningSettings struct {
	PartitioningBySize FeatureFlag
	PartitionSizeMb    uint64
	PartitioningByLoad FeatureFlag
	MinPartitionsCount uint64
	MaxPartitionsCount uint64
}

type PartitioningSettingsOption

type PartitioningSettingsOption func(settings *ydbPartitioningSettings)

func WithMaxPartitionsCount

func WithMaxPartitionsCount(maxPartitionsCount uint64) PartitioningSettingsOption

func WithMinPartitionsCount

func WithMinPartitionsCount(minPartitionsCount uint64) PartitioningSettingsOption

func WithPartitionSizeMb

func WithPartitionSizeMb(partitionSizeMb uint64) PartitioningSettingsOption

func WithPartitioningByLoad

func WithPartitioningByLoad(flag FeatureFlag) PartitioningSettingsOption

func WithPartitioningBySize

func WithPartitioningBySize(flag FeatureFlag) PartitioningSettingsOption

type ProfileOption

type ProfileOption func(p *profile)

func WithCachingPolicy

func WithCachingPolicy(opts ...CachingPolicyOption) ProfileOption

func WithCompactionPolicy

func WithCompactionPolicy(opts ...CompactionPolicyOption) ProfileOption

func WithExecutionPolicy

func WithExecutionPolicy(opts ...ExecutionPolicyOption) ProfileOption

func WithPartitioningPolicy

func WithPartitioningPolicy(opts ...PartitioningPolicyOption) ProfileOption

func WithProfilePreset

func WithProfilePreset(name string) ProfileOption

func WithReplicationPolicy

func WithReplicationPolicy(opts ...ReplicationPolicyOption) ProfileOption

func WithStoragePolicy

func WithStoragePolicy(opts ...StoragePolicyOption) ProfileOption

type QueryCachePolicyOption

type QueryCachePolicyOption func(*queryCachePolicy)

func WithQueryCachePolicyKeepInCache

func WithQueryCachePolicyKeepInCache() QueryCachePolicyOption

type ReadReplicasSettings

type ReadReplicasSettings struct {
	Type  ReadReplicasType
	Count uint64
}

func (ReadReplicasSettings) ToYDB

type ReadReplicasType

type ReadReplicasType byte
const (
	ReadReplicasPerAzReadReplicas ReadReplicasType = iota
	ReadReplicasAnyAzReadReplicas
)

type ReadTableDesc

type ReadTableDesc Ydb_Table.ReadTableRequest

Read table options

type ReadTableOption

type ReadTableOption func(*ReadTableDesc)

Read table options

func ReadColumn

func ReadColumn(name string) ReadTableOption

func ReadGreater

func ReadGreater(x types.Value) ReadTableOption

func ReadGreaterOrEqual

func ReadGreaterOrEqual(x types.Value) ReadTableOption

func ReadKeyRange

func ReadKeyRange(x KeyRange) ReadTableOption

ReadKeyRange returns ReadTableOption which makes ReadTable read values in range [x.From, x.To).

Both x.From and x.To may be nil.

func ReadLess

func ReadLess(x types.Value) ReadTableOption

func ReadLessOrEqual

func ReadLessOrEqual(x types.Value) ReadTableOption

func ReadOrdered

func ReadOrdered() ReadTableOption

func ReadRowLimit

func ReadRowLimit(n uint64) ReadTableOption

type ReplicationPolicyDescription

type ReplicationPolicyDescription struct {
	Name   string
	Labels map[string]string
}

type ReplicationPolicyOption

type ReplicationPolicyOption func(*replicationPolicy)

func WithReplicationPolicyAllowPromotion

func WithReplicationPolicyAllowPromotion(flag FeatureFlag) ReplicationPolicyOption

func WithReplicationPolicyCreatePerAZ

func WithReplicationPolicyCreatePerAZ(flag FeatureFlag) ReplicationPolicyOption

func WithReplicationPolicyPreset

func WithReplicationPolicyPreset(name string) ReplicationPolicyOption

func WithReplicationPolicyReplicasCount

func WithReplicationPolicyReplicasCount(n uint32) ReplicationPolicyOption

type SessionStatus

type SessionStatus byte
const (
	SessionStatusUnknown SessionStatus = iota
	SessionReady
	SessionBusy
	SessionClosing
)

func (SessionStatus) String

func (s SessionStatus) String() string

type StoragePolicyDescription

type StoragePolicyDescription struct {
	Name   string
	Labels map[string]string
}

type StoragePolicyOption

type StoragePolicyOption func(*storagePolicy)

func WithStoragePolicyData

func WithStoragePolicyData(kind string) StoragePolicyOption

func WithStoragePolicyExternal

func WithStoragePolicyExternal(kind string) StoragePolicyOption

func WithStoragePolicyKeepInMemory

func WithStoragePolicyKeepInMemory(flag FeatureFlag) StoragePolicyOption

func WithStoragePolicyLog

func WithStoragePolicyLog(kind string) StoragePolicyOption

func WithStoragePolicyPreset

func WithStoragePolicyPreset(name string) StoragePolicyOption

func WithStoragePolicySyslog

func WithStoragePolicySyslog(kind string) StoragePolicyOption

type StoragePool

type StoragePool struct {
	Media string
}

type StorageSettings

type StorageSettings struct {
	TableCommitLog0    StoragePool
	TableCommitLog1    StoragePool
	External           StoragePool
	StoreExternalBlobs FeatureFlag
}

func NewStorageSettings

func NewStorageSettings(ss *Ydb_Table.StorageSettings) StorageSettings

func (StorageSettings) ToYDB

type TTLSettings deprecated

type TTLSettings struct {
	DateTimeColumn string
	TTLSeconds     uint32
}

Deprecated: use TimeToLiveSettings instead. Will be removed after Jan 2022.

type TableOptionsDescription

type TableOptionsDescription struct {
	TableProfilePresets       []TableProfileDescription
	StoragePolicyPresets      []StoragePolicyDescription
	CompactionPolicyPresets   []CompactionPolicyDescription
	PartitioningPolicyPresets []PartitioningPolicyDescription
	ExecutionPolicyPresets    []ExecutionPolicyDescription
	ReplicationPolicyPresets  []ReplicationPolicyDescription
	CachingPolicyPresets      []CachingPolicyDescription
}

type TableProfileDescription

type TableProfileDescription struct {
	Name   string
	Labels map[string]string

	DefaultStoragePolicy      string
	DefaultCompactionPolicy   string
	DefaultPartitioningPolicy string
	DefaultExecutionPolicy    string
	DefaultReplicationPolicy  string
	DefaultCachingPolicy      string

	AllowedStoragePolicies      []string
	AllowedCompactionPolicies   []string
	AllowedPartitioningPolicies []string
	AllowedExecutionPolicies    []string
	AllowedReplicationPolicies  []string
	AllowedCachingPolicies      []string
}

type TableStats

type TableStats struct {
	PartitionStats   []PartitionStats
	RowsEstimate     uint64
	StoreSize        uint64
	Partitions       uint64
	CreationTime     time.Time
	ModificationTime time.Time
}

type TimeToLiveMode

type TimeToLiveMode byte
const (
	TimeToLiveModeDateType TimeToLiveMode = iota
	TimeToLiveModeValueSinceUnixEpoch
)

type TimeToLiveSettings

type TimeToLiveSettings struct {
	ColumnName string

	// Mode specified mode
	Mode TimeToLiveMode

	// ExpireAfterSeconds specified expiration in seconds
	ExpireAfterSeconds uint32

	// ColumnUnit valid with Mode = TimeToLiveModeValueSinceUnixEpoch
	ColumnUnit *TimeToLiveUnit
}

func NewTimeToLiveSettings

func NewTimeToLiveSettings(settings *Ydb_Table.TtlSettings) *TimeToLiveSettings

func (*TimeToLiveSettings) ToYDB

type TimeToLiveUnit

type TimeToLiveUnit int32
const (
	TimeToLiveUnitUnspecified TimeToLiveUnit = iota
	TimeToLiveUnitSeconds
	TimeToLiveUnitMilliseconds
	TimeToLiveUnitMicroseconds
	TimeToLiveUnitNanoseconds
)

func (*TimeToLiveUnit) ToYDB

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL