sql

package
v3.2.12 Latest Latest
Warning

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

Go to latest
Published: Aug 11, 2023 License: MIT Imports: 23 Imported by: 0

Documentation

Overview

Package sql

Package sql

Package sql

Package sql

Package sql

Package sql

Package sql

Package sql

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Free

func Free()

Free Освобождает соединение работы с базой данных. Объект работы с базой данных полностью удаляется из памяти.

func NewLoggerGorm added in v3.2.5

func NewLoggerGorm(parent *impl) gormLogger.Interface

NewLoggerGorm Создание объекта с интерфейсом gorm.logger.Interface.

Types

type Err

type Err interface {
	Anchor() error // Якорь, по которому можно сравнивать две ошибки между собой.
	Code() uint    // Код ошибки.
	Error() string // Сообщение об ошибке или шаблон сообщения об ошибке.
}

Err Интерфейс ошибки приложения.

type Error

type Error struct{}

Error Объект-одиночка со списком ошибок которые можно сравнивать по якорю через '=='.

func Errors

func Errors() *Error

Errors Справочник всех ошибок пакета.

func (*Error) ApplyMigration

func (e *Error) ApplyMigration(code uint, err error) Err

ApplyMigration Применение новых миграций базы данных прервано ошибкой: ...

func (*Error) ConfigurationIsEmpty

func (e *Error) ConfigurationIsEmpty(code uint) Err

ConfigurationIsEmpty Конфигурация подключения к базе данных пустая.

func (*Error) ConnectError

func (e *Error) ConnectError(code uint, err error) Err

ConnectError Подключение к базе данных завершилось ошибкой: ...

func (*Error) DriverUnImplemented

func (e *Error) DriverUnImplemented(code uint, driver string) Err

DriverUnImplemented Подключение к базе данных с помощью драйвера ... не создано.

func (*Error) UnknownDatabaseDriver

func (e *Error) UnknownDatabaseDriver(code uint, driver string) Err

UnknownDatabaseDriver Указан неизвестный или не поддерживаемый драйвер базы данных: ...

func (*Error) UnknownDialect

func (e *Error) UnknownDialect(code uint, dialect string, err error) Err

UnknownDialect Применение миграций базы данных, настройка диалекта ... прервано ошибкой: ...

func (*Error) UsernameIsEmpty

func (e *Error) UsernameIsEmpty(code uint) Err

UsernameIsEmpty Не указано имя пользователя, для подключения к базе данных.

func (*Error) WrongConnectionType

func (e *Error) WrongConnectionType(code uint, connType string) Err

WrongConnectionType Указан неизвестный или не поддерживаемый способ подключения к базе данных: ...

type Implementation

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

Implementation Встраиваемая структура в модель базы данных, для лёгкого подключения "по требованию" к базе данных.

func (*Implementation) Gist

func (db *Implementation) Gist() Interface

Gist Возвращается настроенный и готовый к работе интерфейс подключения к базе данных.

func (*Implementation) Gorm

func (db *Implementation) Gorm(opts ...*Option) (ret *gorm.DB)

Gorm Возвращается настроенный и готовый к работе объект ORM gorm.io/gorm.

func (*Implementation) OptionSilent added in v3.2.4

func (db *Implementation) OptionSilent() *Option

OptionSilent Полное отключение логирования запросов к базе данных.

func (*Implementation) Sqlx

func (db *Implementation) Sqlx() *sqlx.DB

Sqlx Настроенный и готовый к работе объект обёртки над соединением с БД github.com/jmoiron/sqlx.

type Interface

type Interface interface {
	// Close Закрытие соединения с базой данных.
	Close() (err error)

	// E Ошибка соединения с базой данных.
	// Если err==nil - база данных доступна, соединение активно, ошибок нет.
	// Если err!=nil - есть проблема с соединением с базой данных.
	E() (err error)

	// Status Возвращает состояние подключения к базе данных.
	Status() (ret *sql.DBStats)

	// SqlDB Настроенный и готовый к работе бассейн соединений database/sql.
	// Если возвращается nil - есть ошибки, ошибка доступна в функции E()
	SqlDB() (ret *sql.DB)

	// GormDB Настроенный и готовый к работе объект ORM gorm.io/gorm.
	// Если возвращается nil - есть ошибки, ошибка доступна в функции E()
	GormDB() (ret *gorm.DB)

	// SqlxDB Настроенный и готовый к работе объект обёртки над соединением с БД github.com/jmoiron/sqlx.
	// Если возвращается nil - есть ошибки, ошибка доступна в функции E()
	SqlxDB() (ret *sqlx.DB)

	// MigrationUp Применение миграций базы данных.
	MigrationUp() (err error)

	// Errors Справочник всех ошибок пакета.
	Errors() *Error
}

Interface Интерфейс пакета.

func Get

func Get() Interface

Get Возвращается интерфейс для работы с базой данных. Если база данных доступна, тогда возвращается полностью настроенное и готовое к работе соединение с базой данных. Если база данных не доступна, тогда возвращается объект, методы которого заблокированы до момента установки соединения с базой данных. Параллельно запущен процесс подключения к базе данных, по окончании которого, блокировка методов объекта снимается.

type Option added in v3.2.4

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

Option Опциональные настройки работы библиотеки.

Directories

Path Synopsis
Package types
Package types

Jump to

Keyboard shortcuts

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