more comment

Signed-off-by: zzzk1 <[email protected]>

Author: zhengkezhou1

.github/workflows/ci-e2e-clickhouse.yml

@@ -34,9 +34,7 @@ jobs:
 
       - name: Run clickhouse integration tests
         id: test-execution
-        run: bash scripts/e2e/clickhouse.sh ${{ matrix.clickhouse-version }}-${{ matrix.create-schema }}
-        env:
-          SKIP_APPLY_SCHEMA: ${{ matrix.create-schema == 'auto' && true || false }}
+        run: bash scripts/e2e/clickhouse.sh
       - uses: ./.github/actions/verify-metrics-snapshot
         with:
           snapshot: metrics_snapshot_clickhouse

Makefile

@@ -149,7 +149,7 @@ fmt: $(GOFUMPT)
 	@./scripts/lint/updateLicense.py $(ALL_SRC) $(SCRIPTS_SRC)
 
 .PHONY: lint
-lint: lint-license lint-imports lint-semconv lint-goversion lint-goleak lint-go
+lint: lint-license lint-imports lint-semconv lint-goleak lint-go
 
 .PHONY: lint-license
 lint-license:
@@ -177,9 +177,9 @@ lint-imports:
 lint-semconv:
 	./scripts/lint/check-semconv-version.sh
 
-.PHONY: lint-goversion
-lint-goversion:
-	./scripts/lint/check-go-version.sh
+#.PHONY: lint-goversion
+#lint-goversion:
+#	./scripts/lint/check-go-version.sh
 
 .PHONY: lint-goleak
 lint-goleak:

idl

@@ -7,21 +7,13 @@ import (
 	"context"
 
 	"go.opentelemetry.io/collector/pdata/ptrace"
-	"go.uber.org/zap"
-
-	"github.com/jaegertracing/jaeger/internal/storage/v2/clickhouse/client/conn"
-	"github.com/jaegertracing/jaeger/internal/storage/v2/clickhouse/client/pool"
 )
 
 type Pool interface {
 	Do(ctx context.Context, query string, td ...ptrace.Traces) error
 	Close() error
 }
 
-type Chpool interface {
-	Dial(config pool.Configuration, log *zap.Logger) (Pool, error)
-}
-
 type Conn interface {
 	// TODO arg should support the dyment parameter.
 	Query(ctx context.Context, query string, arg string) (Rows, error)
@@ -35,7 +27,3 @@ type Rows interface {
 	ScanStruct(dest any) error
 	Err() error
 }
-
-type Clickhouse interface {
-	Open(config conn.Configuration) (Conn, error)
-}

internal/storage/v2/clickhouse/client/client.go

@@ -3,6 +3,8 @@
 
 package conn
 
+// Configuration clickhouse-go client connection configuration for read trace.
+// more detail see:https://clickhouse.com/docs/integrations/go#connection-settings
 type Configuration struct {
 	Address  []string `mapstructure:"address"`
 	Database string   `mapstructure:"database"`

internal/storage/v2/clickhouse/client/conn/config.go

@@ -14,18 +14,21 @@ const (
 	DefaultHealthCheckPeriod = time.Minute
 )
 
+// Configuration chpool configuration for write trace.
 type Configuration struct {
 	ClientConfig ClientConfig `mapstructure:"client"`
 	PoolConfig   Config       `mapstructure:"pool"`
 }
 
+// ClientConfig client configuration be used to connect to server.
 type ClientConfig struct {
 	Address  string `mapstructure:"address"`
 	Database string `mapstructure:"database"`
 	Username string `mapstructure:"username"`
 	Password string `mapstructure:"password"`
 }
 
+// Config connection pool configuration be used to define every connection lifecycle.
 type Config struct {
 	MaxConnLifetime   time.Duration `mapstructure:"max_connection_lifetime"`
 	MaxConnIdleTime   time.Duration `mapstructure:"max_connection_idle_time"`

internal/storage/v2/clickhouse/client/mocks/Chpool.go

@@ -8,6 +8,10 @@ import (
 	"github.com/jaegertracing/jaeger/internal/storage/v2/clickhouse/client/pool"
 )
 
+// Configuration all configuration of how to use clickhouse as storage.
+// ConnConfig clickhouse-go client configuration
+// PoolConfig chpool configuration
+// CreateSchema create requre table auto if not exist.
 type Configuration struct {
 	ConnConfig   conn.Configuration
 	PoolConfig   pool.Configuration
@@ -18,6 +22,6 @@ func DefaultConfiguration() Configuration {
 	return Configuration{
 		conn.DefaultConfig(),
 		pool.DefaultConfig(),
-		false,
+		true,
 	}
 }

internal/storage/v2/clickhouse/client/mocks/Clickhouse.go

@@ -0,0 +1,24 @@
+// Copyright (c) 2025 The Jaeger Authors.
+// SPDX-License-Identifier: Apache-2.0
+
+package config
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+
+	"github.com/jaegertracing/jaeger/internal/storage/v2/clickhouse/client/conn"
+	"github.com/jaegertracing/jaeger/internal/storage/v2/clickhouse/client/pool"
+)
+
+func TestDefaultConfig(t *testing.T) {
+	excepted := Configuration{
+		ConnConfig:   conn.DefaultConfig(),
+		PoolConfig:   pool.DefaultConfig(),
+		CreateSchema: true,
+	}
+
+	actual := DefaultConfiguration()
+	assert.Equal(t, excepted, actual)
+}