tests

package
v2.39.0 Latest Latest
Warning

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

 Go to latest Published: Jul 23, 2025 License: Apache-2.0 Imports: 31 Imported by: 48

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var CloudClickHouse = false
View Source 
var JSONTestDate, _ = time.Parse(time.RFC3339, "2024-12-13T02:09:30.123Z")
View Source 
var LocalClickHouse = false
View Source 
var RemoteClickHouse = false

Functions

func AssertIsTimeoutError added in v2.39.0 

func AssertIsTimeoutError(t *testing.T, err error)

AssertIsTimeoutError ensures that the error provided is a timeout error. It recursively unwraps the provided error and ensures the core error implements the Timeout() method and it returns true. context deadline error, os deadline error and poll deadline error each implement this and return true.

func BuildTestJSONPaths added in v2.31.0 

func BuildTestJSONPaths() *chcol.JSON

func CheckMinServerServerVersion added in v2.4.0 

func CheckMinServerServerVersion(conn driver.Conn, major, minor, patch uint64) bool

func CleanupNativeConn added in v2.37.0 

func CleanupNativeConn(t *testing.T, conn driver.Conn)

func ClientOptionsFromEnv added in v2.10.0 

func ClientOptionsFromEnv(env ClickHouseTestEnvironment, settings clickhouse.Settings, useHTTP bool) clickhouse.Options

func CreateDatabase added in v2.4.0 

func CreateDatabase(testSet string) error

func GetClickHouseTestVersion added in v2.4.0 

func GetClickHouseTestVersion() string

func GetConnection added in v2.4.0 

func GetConnection(testSet string, t *testing.T, protocol clickhouse.Protocol, settings clickhouse.Settings, tlsConfig *tls.Config, compression *clickhouse.Compression) (driver.Conn, error)

func GetConnectionHTTP added in v2.37.0 

func GetConnectionHTTP(testSet string, t *testing.T, settings clickhouse.Settings, tlsConfig *tls.Config, compression *clickhouse.Compression) (driver.Conn, error)

func GetConnectionTCP added in v2.37.0 

func GetConnectionTCP(testSet string, settings clickhouse.Settings, tlsConfig *tls.Config, compression *clickhouse.Compression) (driver.Conn, error)

func GetConnectionWithOptions added in v2.4.0 

func GetConnectionWithOptions(options *clickhouse.Options) (driver.Conn, error)

func GetEnv added in v2.4.0 

func GetEnv(key, fallback string) string

func GetJWTConnection added in v2.35.0 

func GetJWTConnection(testSet string, settings clickhouse.Settings, tlsConfig *tls.Config, maxConnLifetime time.Duration, jwtFunc clickhouse.GetJWTFunc) (driver.Conn, error)

func IsSetInEnv added in v2.4.0 

func IsSetInEnv(key string) bool

func OptionsToDSN added in v2.27.0 

func OptionsToDSN(o *clickhouse.Options) string

func PrintMemUsage 

func PrintMemUsage()

PrintMemUsage outputs the current, total and OS memory being used. As well as the number of garbage collection cycles completed. thanks to https://golangcode.com/print-the-current-memory-usage/

func RandAsciiString 

func RandAsciiString(n int) string

func RandIPv4 

func RandIPv4() net.IP

func RandIPv6 

func RandIPv6() net.IP

func RandIntString 

func RandIntString(n int) string

func ResetRandSeed added in v2.33.0 

func ResetRandSeed()

func Runtime added in v2.23.1 

func Runtime(m *testing.M, ts string) (exitCode int)

func SetTestEnvironment added in v2.4.0 

func SetTestEnvironment(testSet string, environment ClickHouseTestEnvironment)

func SkipNotCloud added in v2.35.0 

func SkipNotCloud(t *testing.T, reasons ...string)

SkipNotCloud skips the test if it's not run on ClickHouse Cloud

func SkipOnCloud added in v2.20.0 

func SkipOnCloud(t *testing.T, reasons ...string)

SkipOnCloud skips the test if it's run on ClickHouse Cloud

func SkipOnHTTP added in v2.37.0 

func SkipOnHTTP(t *testing.T, protocol clickhouse.Protocol, reasons ...string)

SkipOnHTTP skips the test if the protocol is HTTP

func TestClientDefaultSettings added in v2.22.3 

func TestClientDefaultSettings(env ClickHouseTestEnvironment) clickhouse.Settings

func TestClientWithDefaultOptions added in v2.28.0 

func TestClientWithDefaultOptions(env ClickHouseTestEnvironment, settings clickhouse.Settings) (driver.Conn, error)

func TestClientWithDefaultSettings added in v2.10.0 

func TestClientWithDefaultSettings(env ClickHouseTestEnvironment) (driver.Conn, error)

func TestDatabaseSQLClientWithDefaultOptions added in v2.22.3 

func TestDatabaseSQLClientWithDefaultOptions(env ClickHouseTestEnvironment, settings clickhouse.Settings) (*sql.DB, error)

func TestDatabaseSQLClientWithDefaultSettings added in v2.22.3 

func TestDatabaseSQLClientWithDefaultSettings(env ClickHouseTestEnvironment) (*sql.DB, error)

func TestProtocols added in v2.37.0 

func TestProtocols(rootT *testing.T, testFunc func(t *testing.T, protocol clickhouse.Protocol))

Types

type ClickHouseTestEnvironment added in v2.4.0 

type ClickHouseTestEnvironment struct {
	ContainerID string
	Port        int
	HttpPort    int
	SslPort     int
	HttpsPort   int
	Host        string
	Username    string
	Password    string
	JWT         string
	Database    string
	Version     proto.Version
	ContainerIP string
	Container   testcontainers.Container `json:"-"`
}

func CreateClickHouseTestEnvironment added in v2.4.0 

func CreateClickHouseTestEnvironment(testSet string) (ClickHouseTestEnvironment, error)

func GetExternalTestEnvironment added in v2.4.0 

func GetExternalTestEnvironment(testSet string) (ClickHouseTestEnvironment, error)

func GetTestEnvironment added in v2.4.0 

func GetTestEnvironment(testSet string) (ClickHouseTestEnvironment, error)

type FastTestStruct added in v2.31.0 

type FastTestStruct struct {
	// contains filtered or unexported fields
}

FastTestStruct is a distinctly separate type that implements clickhouse.JSONSerializer and clickhouse.JSONDeserializer The struct must be a separate type since the JSON column is unable to ignore the interface implementation.

func BuildFastTestJSONStruct added in v2.31.0 

func BuildFastTestJSONStruct() FastTestStruct

func (*FastTestStruct) DeserializeClickHouseJSON added in v2.31.0 

func (fts *FastTestStruct) DeserializeClickHouseJSON(obj *clickhouse.JSON) error

DeserializeClickHouseJSON implements clickhouse.JSONDeserializer for faster struct scanning

func (*FastTestStruct) SerializeClickHouseJSON added in v2.31.0 

func (fts *FastTestStruct) SerializeClickHouseJSON() (*clickhouse.JSON, error)

SerializeClickHouseJSON implements clickhouse.JSONSerializer for faster struct appending

type NginxReverseHTTPProxyTestEnvironment added in v2.8.0 

type NginxReverseHTTPProxyTestEnvironment struct {
	HttpPort       int
	NginxContainer testcontainers.Container `json:"-"`
}

func CreateNginxReverseProxyTestEnvironment added in v2.8.0 

func CreateNginxReverseProxyTestEnvironment(clickhouseEnv ClickHouseTestEnvironment) (NginxReverseHTTPProxyTestEnvironment, error)

type TestStruct added in v2.31.0 

type TestStruct struct {
	Name   string
	Age    int64
	Active bool
	Score  float64

	Tags    []string
	Numbers []int64

	Address TestStructAddress

	KeysNumbers map[string]int64
	Metadata    map[string]interface{}

	Timestamp time.Time `chType:"DateTime64(3)"`

	DynamicString chcol.Dynamic
	DynamicInt    chcol.Dynamic
	DynamicMap    chcol.Dynamic
}

func BuildTestJSONStruct added in v2.31.0 

func BuildTestJSONStruct() TestStruct

type TestStructAddress added in v2.31.0 

type TestStructAddress struct {
	Street  string `chType:"String"`
	City    string `chType:"String"`
	Country string `chType:"String"`
}

type TinyProxyTestEnvironment added in v2.9.2 

type TinyProxyTestEnvironment struct {
	HttpPort  int
	Container testcontainers.Container `json:"-"`
}

func CreateTinyProxyTestEnvironment added in v2.9.2 

func CreateTinyProxyTestEnvironment(t *testing.T) (TinyProxyTestEnvironment, error)

func (TinyProxyTestEnvironment) ProxyUrl added in v2.9.2 

func (e TinyProxyTestEnvironment) ProxyUrl(t *testing.T) string

Source Files

View all Source files

Directories

Path Synopsis
issues
209
360
470
476
484
485

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.