Help us shape the future of Go! Take the 2026 Go Developer Survey

cherr

package
v1.35.0 Latest Latest
Warning

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

 Go to latest Published: Oct 20, 2026 License: MIT Imports: 5 Imported by: 0

Documentation

Overview

Package cherr holds the ClickHouse adapter error type and the one error-code registry that the driver, the client, Lookout and the grants reference share.

Index

Constants

View Source 
const (
	CodeConfigInvalid         = "CH_CONFIG_INVALID"
	CodeCAInvalid             = "CH_CA_INVALID"
	CodeWorkspaceNotEnabled   = "CH_WORKSPACE_NOT_ENABLED"
	CodeHostNotAllowed        = "CH_HOST_NOT_ALLOWED"
	CodeDNSFailed             = "CH_DNS_FAILED"
	CodeRedirectRefused       = "CH_REDIRECT_REFUSED"
	CodeSortingKeyUnavailable = "CH_SORTING_KEY_UNAVAILABLE"

	CodeTLS         = "CH_TLS"
	CodeRateLimited = "CH_RATE_LIMITED"

	CodeClusterUnsupported      = "CH_CLUSTER_UNSUPPORTED"
	CodeVersionBelowFloor       = "CH_VERSION_BELOW_FLOOR"
	CodeCatalogUnsupported      = "CH_CATALOG_UNSUPPORTED"
	CodeCrossDatabaseMove       = "CH_CROSS_DATABASE_MOVE_UNSUPPORTED"
	CodeTransactionsUnsupported = "CH_TRANSACTIONS_UNSUPPORTED"
	CodePrepareUnsupported      = "CH_PREPARE_UNSUPPORTED"
	CodeTypeUnsupported         = "CH_TYPE_UNSUPPORTED"

	CodeInvalidReference  = "CH_INVALID_REFERENCE"
	CodeInvalidIdentifier = "CH_INVALID_IDENTIFIER"
	CodeQueryInvalid      = "CH_QUERY_INVALID"

	CodeObjectNotFound = "CH_OBJECT_NOT_FOUND"

	CodeValueEncoding   = "CH_VALUE_ENCODING"
	CodeDuplicateColumn = "CH_DUPLICATE_COLUMN"
	CodeCountOverflow   = "CH_COUNT_OVERFLOW"

	CodeDDLNotVisible    = "CH_DDL_NOT_VISIBLE"
	CodeRowCountMismatch = "CH_ROW_COUNT_MISMATCH"
	CodeBaselineMissing  = "CH_BASELINE_MISSING"
	CodeSchemaMismatch   = "CH_SCHEMA_MISMATCH"
	CodeLostResponse     = "CH_LOST_RESPONSE"
	CodeOutcomeUnknown   = "CH_OUTCOME_UNKNOWN"

	CodeScratchCleanupFailed = "CH_SCRATCH_CLEANUP_FAILED"

	CodeAuthentication = "CH_AUTHENTICATION"
	CodePermission     = "CH_PERMISSION"
	CodeTimeout        = "CH_TIMEOUT"
	CodeResource       = "CH_RESOURCE"
	CodeNetwork        = "CH_NETWORK"
	CodeCancelled      = "CH_CANCELLED"
	CodeUnavailable    = "CH_UNAVAILABLE"
	CodeUnknown        = "CH_UNKNOWN"
)

Variables

This section is empty.

Functions

func Category 

func Category(code string) string

Category returns the registry category of code, or "unknown" for a code outside the registry.

func Codes 

func Codes() []string

Codes returns every registry code, sorted.

Types

type Error 

type Error struct {
	Code, Field, Detail string
	ServerCode          int32
	RetryAfter          time.Duration
	// contains filtered or unexported fields
}

Error is an adapter error. Its text is built from bounded fields only; the cause stays reachable through errors.Is and errors.As but is never printed, because a server message can echo SQL text or credentials.

func New 

func New(code, field, detail string) *Error

func Wrap 

func Wrap(code, field, detail string, cause error) *Error

func (*Error) Error 

func (e *Error) Error() string

func (*Error) Format 

func (e *Error) Format(f fmt.State, verb rune)

Format prints only Error() for every verb, so %+v and %#v never expose the cause or the struct fields.

func (*Error) Unwrap 

func (e *Error) Unwrap() error

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.