gosnowflake

Feb 5, 2025

Changes in this version

+ const ErrCodeFailedToFindDSNInToml

+ const ErrCodeInvalidFilePermission

+ const ErrCodeTomlFileParsingFailed

+ const ErrNonArrowResponseInArrowBatches

+ var S3LoggingMode aws.ClientLogMode

type Config

+ CloudStorageTimeout time.Duration

+ DisableOCSPChecks bool

type SnowflakeDriver

+ func (d SnowflakeDriver) OpenConnector(dsn string) (driver.Connector, error)

type SnowflakeFileTransferOptions

+ GetFileToStream bool

Sep 24, 2024

Changes in this version

+ const ErrNullValueInArray

+ const ErrNullValueInMap

+ var DataTypeNilArray = []byte

+ var DataTypeNilMap = []byte

+ var DataTypeNilObject = []byte

+ var OcspCacheServerTimeout = defaultOCSPCacheServerTimeout

+ var OcspMaxRetryCount = defaultOCSPMaxRetryCount

+ var OcspResponderTimeout = defaultOCSPResponderTimeout

+ func RegisterLogContextHook(contextKey string, ctxExtractor ClientLogContextHook)

+ func StringToValueWithContext(ctx context.Context, dest *driver.Value, srcColumnMeta execResponseRowType, ...) error

+ func WithArrayValuesNullable(ctx context.Context) context.Context

+ func WithFileGetStream(ctx context.Context, writer io.Writer) context.Context

+ func WithMapValuesNullable(ctx context.Context) context.Context

+ func WithStructuredTypesEnabled(ctx context.Context) context.Context

+ type ArrayOfScanners []T

+ func ScanArrayOfScanners[T sql.Scanner](value *[]T) *ArrayOfScanners[T]

+ func (st *ArrayOfScanners[T]) Scan(val any) error

+ type ClientLogContextHook func(context.Context) string

type Config

+ DisableSamlURLCheck ConfigBool

+ type GoroutineWrapperFunc func(ctx context.Context, f func())

+ var GoroutineWrapper GoroutineWrapperFunc = noopGoroutineWrapper

+ type MapOfScanners map[K]V

+ func ScanMapOfScanners[K comparable, V sql.Scanner](m *map[K]V) *MapOfScanners[K, V]

+ func (st *MapOfScanners[K, V]) Scan(val any) error

+ type NilMapTypes struct

+ Key reflect.Type

+ Value reflect.Type

+ type ObjectType struct

+ type StructuredObject interface

+ GetBigFloat func(fieldName string) (*big.Float, error)

+ GetBigInt func(fieldName string) (*big.Int, error)

+ GetBool func(fieldName string) (bool, error)

+ GetByte func(fieldName string) (byte, error)

+ GetBytes func(fieldName string) ([]byte, error)

+ GetFloat32 func(fieldName string) (float32, error)

+ GetFloat64 func(fieldName string) (float64, error)

+ GetInt16 func(fieldName string) (int16, error)

+ GetInt32 func(fieldName string) (int32, error)

+ GetInt64 func(fieldName string) (int64, error)

+ GetNullBool func(fieldName string) (sql.NullBool, error)

+ GetNullByte func(fieldName string) (sql.NullByte, error)

+ GetNullFloat64 func(fieldName string) (sql.NullFloat64, error)

+ GetNullInt16 func(fieldName string) (sql.NullInt16, error)

+ GetNullInt32 func(fieldName string) (sql.NullInt32, error)

+ GetNullInt64 func(fieldName string) (sql.NullInt64, error)

+ GetNullString func(fieldName string) (sql.NullString, error)

+ GetNullTime func(fieldName string) (sql.NullTime, error)

+ GetRaw func(fieldName string) (any, error)

+ GetString func(fieldName string) (string, error)

+ GetStruct func(fieldName string, scanner sql.Scanner) (sql.Scanner, error)

+ GetTime func(fieldName string) (time.Time, error)

+ ScanTo func(sc sql.Scanner) error

+ type StructuredObjectWriter interface

+ Write func(sowc StructuredObjectWriterContext) error

+ type StructuredObjectWriterContext interface

+ WriteAll func(sow StructuredObjectWriter) error

+ WriteBool func(fieldName string, value bool) error

+ WriteByt func(fieldName string, value byte) error

+ WriteBytes func(fieldName string, value []byte) error

+ WriteFloat32 func(fieldName string, value float32) error

+ WriteFloat64 func(fieldName string, value float64) error

+ WriteInt16 func(fieldName string, value int16) error

+ WriteInt32 func(fieldName string, value int32) error

+ WriteInt64 func(fieldName string, value int64) error

+ WriteNullBool func(fieldName string, value sql.NullBool) error

+ WriteNullByte func(fieldName string, value sql.NullByte) error

+ WriteNullFloat64 func(fieldName string, value sql.NullFloat64) error

+ WriteNullInt16 func(fieldName string, value sql.NullInt16) error

+ WriteNullInt32 func(fieldName string, value sql.NullInt32) error

+ WriteNullInt64 func(fieldName string, value sql.NullInt64) error

+ WriteNullRaw func(fieldName string, typ reflect.Type, tsmode ...[]byte) error

+ WriteNullString func(fieldName string, value sql.NullString) error

+ WriteNullTime func(fieldName string, value sql.NullTime, tsmode []byte) error

+ WriteNullableStruct func(fieldName string, value StructuredObjectWriter, typ reflect.Type) error

+ WriteRaw func(fieldName string, value any, tsmode ...[]byte) error

+ WriteString func(fieldName string, value string) error

+ WriteStruct func(fieldName string, value StructuredObjectWriter) error

+ WriteTime func(fieldName string, value time.Time, tsmode []byte) error

Sep 23, 2024

Changes in this version

+ func ExecResponseRowTypeEquals(a, b ExecResponseRowType) bool

Mar 28, 2024

Changes in this version

+ const UseMicrosecondTimestamp

+ const UseMillisecondTimestamp

+ const UseNanosecondTimestamp

+ const UseOriginalTimestamp

+ const UseSecondTimestamp

+ func WithArrowBatchesTimestampOption(ctx context.Context, option snowflakeArrowBatchesTimestampOption) context.Context

+ func WithArrowBatchesUtf8Validation(ctx context.Context) context.Context

type Config

+ DisableConsoleLogin ConfigBool

Dec 12, 2023

Changes in this version

+ func WithQueryTag(ctx context.Context, tag string) context.Context

Nov 14, 2023

Changes in this version

+ const ErrCodeClientConfigFailed

+ const ErrTooHighTimestampPrecision

+ func WithOriginalTimestamp(ctx context.Context) context.Context

type ArrowBatch

+ func (rb *ArrowBatch) ArrowSnowflakeTimestampToTime(rec arrow.Record, colIdx int, recIdx int) *time.Time

+ type ClientConfig struct

+ Common *ClientConfigCommonProps

+ type ClientConfigCommonProps struct

+ LogLevel string

+ LogPath string

type Config

+ ClientConfigFile string

+ IncludeRetryReason ConfigBool

+ MaxRetryCount int

type SFLogger

+ CloseFileOnLoggerReplace func(file *os.File) error

+ GetLogLevel func() string

+ Replace func(newLogger *SFLogger)

Oct 27, 2023

Changes in this version

+ const DateType

+ const ErrAsync

+ const ErrBindSerialization

+ const ErrBindUpload

+ const ErrCommandNotRecognized

+ const ErrCompressionNotSupported

+ const ErrFailedToConvertToS3Client

+ const ErrFailedToDownloadFromStage

+ const ErrFailedToUploadToStage

+ const ErrFileNotExists

+ const ErrInternalNotMatchEncryptMaterial

+ const ErrInvalidPadding

+ const ErrInvalidStageFs

+ const ErrInvalidStageLocation

+ const ErrLocalPathNotDirectory

+ const ErrNoResultIDs

+ const ErrNotImplemented

+ const ErrQueryIDFormat

+ const ErrQueryIsRunning

+ const ErrQueryReportedError

+ const ErrQueryStatus

+ const QueryFailed

+ const QueryStatusComplete

+ const QueryStatusInProgress

+ const SFQueryAborted

+ const SFQueryAborting

+ const SFQueryBlocked

+ const SFQueryDisconnected

+ const SFQueryFailedWithError

+ const SFQueryFailedWithIncident

+ const SFQueryNoData

+ const SFQueryQueueRepairingWarehouse

+ const SFQueryQueued

+ const SFQueryRestarted

+ const SFQueryResumingWarehouse

+ const SFQueryRunning

+ const SFQuerySuccess

+ const SFSessionIDKey

+ const SFSessionUserKey

+ const TimeType

+ const TimestampLTZType

+ const TimestampNTZType

+ const TimestampTZType

+ var ArrowToValue = arrowToValue

+ var LogKeys = [...]contextKey

+ func Array(a interface{}, typ ...timezoneType) interface

+ func GetFromEnv(name string, failOnMissing bool) (string, error)

+ func SFCallerPrettyfier(frame *runtime.Frame) (string, string)

+ func SetLogger(inLogger *SFLogger)

+ func StringToValue(dest *driver.Value, srcColumnMeta execResponseRowType, srcValue *string, ...) error

+ func WithArrowAllocator(ctx context.Context, pool memory.Allocator) context.Context

+ func WithArrowBatches(ctx context.Context) context.Context

+ func WithAsyncMode(ctx context.Context) context.Context

+ func WithDescribeOnly(ctx context.Context) context.Context

+ func WithFetchResultByID(ctx context.Context, queryID string) context.Context

+ func WithFileStream(ctx context.Context, reader io.Reader) context.Context

+ func WithFileTransferOptions(ctx context.Context, options *SnowflakeFileTransferOptions) context.Context

+ func WithHigherPrecision(ctx context.Context) context.Context

+ func WithQueryIDChan(ctx context.Context, c chan<- string) context.Context

+ func WithRequestID(ctx context.Context, requestID UUID) context.Context

+ func WithStreamDownloader(ctx context.Context) context.Context

+ type ArrowBatch struct

+ func (rb *ArrowBatch) Fetch() (*[]arrow.Record, error)

+ func (rb *ArrowBatch) GetRowCount() int

+ func (rb *ArrowBatch) WithContext(ctx context.Context) *ArrowBatch

+ type ArrowStreamBatch struct

+ Loc *time.Location

+ func (asb *ArrowStreamBatch) GetStream(ctx context.Context) (io.ReadCloser, error)

+ func (asb *ArrowStreamBatch) NumRows() int64

+ type ArrowStreamLoader interface

+ GetBatches func() ([]ArrowStreamBatch, error)

+ JSONData func() [][]*string

+ Location func() *time.Location

+ RowTypes func() []execResponseRowType

+ TotalRows func() int64

type AuthType

+ const AuthTypeTokenAccessor

+ const AuthTypeUsernamePasswordMFA

+ type ChunkRowType = chunkRowType

type Config

+ ClientIP net.IP

+ ClientRequestMfaToken ConfigBool

+ ClientStoreTemporaryCredential ConfigBool

+ ClientTimeout time.Duration

+ DisableQueryContextCache bool

+ DisableTelemetry bool

+ ExternalBrowserTimeout time.Duration

+ IDToken string

+ JWTClientTimeout time.Duration

+ KeepSessionAlive bool

+ MfaToken string

+ TmpDirPath string

+ TokenAccessor TokenAccessor

+ Tracing string

+ Transporter http.RoundTripper

+ func GetConfigFromEnv(properties []*ConfigParam) (*Config, error)

+ func (c *Config) Validate() error

+ type ConfigParam struct

+ EnvName string

+ FailOnMissing bool

+ Name string

+ type Connector struct

+ func NewConnector(driver InternalSnowflakeDriver, config Config) Connector

+ func (t Connector) Connect(ctx context.Context) (driver.Conn, error)

+ func (t Connector) Driver() driver.Driver

+ type InternalClient interface

+ Get func(context.Context, *url.URL, map[string]string, time.Duration) (*http.Response, error)

+ Post func(context.Context, *url.URL, map[string]string, []byte, time.Duration, bool, ...) (*http.Response, error)

+ type InternalSnowflakeDriver interface

+ Open func(dsn string) (driver.Conn, error)

+ OpenWithConfig func(ctx context.Context, config Config) (driver.Conn, error)

+ type RawSnowflakeRows = snowflakeRows

+ type SFLogger interface

+ SetLogLevel func(level string) error

+ SetOutput func(output io.Writer)

+ WithContext func(ctx context.Context) *rlog.Entry

+ func CreateDefaultLogger() SFLogger

+ func GetLogger() SFLogger

+ type SimpleTokenAccessor = simpleTokenAccessor

+ type SnowflakeConnection interface

+ GetQueryStatus func(ctx context.Context, queryID string) (*SnowflakeQueryStatus, error)

type SnowflakeDriver

+ func (d SnowflakeDriver) OpenWithConfig(ctx context.Context, config Config) (driver.Conn, error)

+ type SnowflakeFileTransferOptions struct

+ DisablePutOverwrite bool

+ MultiPartThreshold int64

+ RaisePutGetError bool

+ type SnowflakeQueryStatus struct

+ EndTime int64

+ ErrorCode string

+ ErrorMessage string

+ ProducedRows int64

+ SQLText string

+ ScanBytes int64

+ StartTime int64

+ type SnowflakeResult interface

+ GetArrowBatches func() ([]*ArrowBatch, error)

+ GetQueryID func() string

+ GetStatus func() queryStatus

type SnowflakeRows

+ GetArrowBatches func() ([]*ArrowBatch, error)

+ GetQueryID func() string

+ GetStatus func() queryStatus

+ type SnowflakeStmt interface

+ GetQueryID func() string

+ type SnowflakeValue = snowflakeValue

+ type TokenAccessor interface

+ GetTokens func() (token string, masterToken string, sessionID int64)

+ Lock func() error

+ SetTokens func(token string, masterToken string, sessionID int64)

+ Unlock func()

+ type TypedNullTime struct

+ Time sql.NullTime

+ TzType timezoneType

+ type UUID [16]byte

+ func NewUUID() UUID

+ func ParseUUID(str string) UUID

+ func (u UUID) String() string

Aug 11, 2020

Changes in this version

+ const ErrCodeFailedToParseAuthenticator

+ const ErrCodeRegionOverlap

+ const ErrOCSPInvalidValidity

+ const ErrOCSPNoOCSPResponderURL

+ const ErrOCSPStatusRevoked

+ const ErrOCSPStatusUnknown

+ const ErrObjectNotExistOrAuthorized

+ const ErrRoleNotExist

+ const ErrSessionGone

+ const MultiStatementCount

+ const ResponseBodyLimit

+ var ErrInvalidRegion = &SnowflakeError

+ var ErrResponseTooLarge = fmt.Errorf("response is too large")

+ func WithMultiStatement(ctx context.Context, num int) (context.Context, error)

+ type AuthType int

+ const AuthTypeExternalBrowser

+ const AuthTypeJwt

+ const AuthTypeOAuth

+ const AuthTypeOkta

+ const AuthTypeSnowflake

+ func (authType AuthType) String() string

type Config

+ OCSPFailOpen OCSPFailOpenMode

+ OktaURL *url.URL

+ ValidateDefaultParameters ConfigBool

+ type ConfigBool uint8

+ const ConfigBoolFalse

+ const ConfigBoolTrue

+ type ExecResponse = execResponse

+ type ExecResponseChunk = execResponseChunk

+ type ExecResponseRowType = execResponseRowType

+ type OCSPFailOpenMode uint8

+ const OCSPFailOpenFalse

+ const OCSPFailOpenTrue

+ type SnowflakeChunkDownloader = snowflakeChunkDownloader

type SnowflakeParameter

+ ActivateVersion string

+ ExpiresAt string

+ IsExpired string

+ PartialRollout string

+ SetByControllingParameter string

+ type SnowflakeRestful = snowflakeRestful

+ type SnowflakeRows = snowflakeRows

Nov 27, 2018

Changes in this version

type SnowflakeParameter

+ Type string

+ Unknown string

Sep 6, 2018

Changes in this version

+ const ErrCodePrivateKeyParseError

+ var CustomJSONDecoderEnabled = false

+ var MaxChunkDownloadWorkers = 10

type Config

+ JWTExpireTimeout time.Duration

+ PrivateKey *rsa.PrivateKey

Aug 14, 2018

Changes in this version

+ type SnowflakeParameter struct

+ Default string

+ Description string

+ Key string

+ Level string

+ ParameterComment string

+ SetByClass string

+ SetByThreadID string

+ SetByThreadName string

+ SetByUser string

+ SetInJob string

+ SetOn string

+ Value string

+ func ScanSnowflakeParameter(rows *sql.Rows) (*SnowflakeParameter, error)

May 23, 2018

Changes in this version

+ const ErrFailedToHeartbeat

Feb 7, 2018

Changes in this version

+ const ErrFailedToGetExternalBrowserResponse

+ const ErrFailedToParseResponse

type Config

+ Token string

Dec 1, 2017

Changes in this version

+ const ErrCodeFailedToConnect

+ const ErrCodeObjectNotExists

+ const ErrCodeServiceUnavailable

Oct 25, 2017

Changes in this version

+ const ErrCodeEmptyAccountCode

+ const ErrCodeEmptyPasswordCode

+ const ErrCodeEmptyUsernameCode

+ const ErrCodeFailedToParseHost

+ const ErrCodeFailedToParsePort

+ const ErrCodeIdpConnectionError

+ const ErrCodeSSOURLNotMatch

+ const ErrFailedToAuth

+ const ErrFailedToAuthOKTA

+ const ErrFailedToAuthSAML

+ const ErrFailedToCancelQuery

+ const ErrFailedToCloseSession

+ const ErrFailedToConnect

+ const ErrFailedToGetChunk

+ const ErrFailedToGetSSO

+ const ErrFailedToPostQuery

+ const ErrFailedToRenewSession

+ const ErrInvalidBinaryHexForm

+ const ErrInvalidOffsetStr

+ const ErrInvalidTimestampTz

+ const ErrNoDefaultTransactionIsolationLevel

+ const ErrNoReadOnlyTransaction

+ const ErrServiceUnavailable

+ const SQLStateConnectionFailure

+ const SQLStateConnectionRejected

+ const SQLStateConnectionWasNotEstablished

+ const SQLStateFeatureNotSupported

+ const SQLStateInvalidDataTimeFormat

+ const SQLStateNumericValueOutOfRange

+ const SnowflakeGoDriverVersion

+ var DataTypeArray = []byte

+ var DataTypeBinary = []byte

+ var DataTypeBoolean = []byte

+ var DataTypeDate = []byte

+ var DataTypeFixed = []byte

+ var DataTypeObject = []byte

+ var DataTypeReal = []byte

+ var DataTypeText = []byte

+ var DataTypeTime = []byte

+ var DataTypeTimestampLtz = []byte

+ var DataTypeTimestampNtz = []byte

+ var DataTypeTimestampTz = []byte

+ var DataTypeVariant = []byte

+ var ErrEmptyAccount = &SnowflakeError

+ var ErrEmptyPassword = &SnowflakeError

+ var ErrEmptyUsername = &SnowflakeError

+ var SnowflakeTransport = &http.Transport

+ var SnowflakeTransportSerial = &http.Transport

+ var SnowflakeTransportTest = SnowflakeTransport

+ func DSN(cfg *Config) (dsn string, err error)

+ func Location(offset int) *time.Location

+ func LocationWithOffsetString(offsets string) (loc *time.Location, err error)

+ type Config struct

+ Account string

+ Application string

+ Authenticator string

+ Database string

+ Host string

+ InsecureMode bool

+ LoginTimeout time.Duration

+ Params map[string]*string

+ Passcode string

+ PasscodeInPassword bool

+ Password string

+ Port int

+ Protocol string

+ Region string

+ RequestTimeout time.Duration

+ Role string

+ Schema string

+ User string

+ Warehouse string

+ func ParseDSN(dsn string) (cfg *Config, err error)

+ type SnowflakeDriver struct

+ func (d SnowflakeDriver) Open(dsn string) (driver.Conn, error)

+ type SnowflakeError struct

+ IncludeQueryID bool

+ Message string

+ MessageArgs []interface{}

+ Number int

+ QueryID string

+ SQLState string

+ func (se *SnowflakeError) Error() string