Умный выбор полей
В GORM вы можете эффективно выбирать конкретные поля, используя метод Select
. Это особенно полезно при работе с большими моделями, когда требуется только подмножество полей, особенно в ответах API.
type User struct { |
ПРИМЕЧАНИЕ В режиме
QueryFields
, все поля модели выбираются по их именам.
db, err := gorm.Open(sqlite.Open("gorm.db"), &gorm.Config{ |
Блокировка
GORM поддерживает различные типы блокировок, например:
// Базовая блокировка FOR UPDATE |
Приведённое выше выражение заблокирует выбранные строки на протяжении всей транзакции. Это может быть полезно в сценариях, когда вы готовитесь обновить строки и хотите предотвратить их изменение другими транзакциями до завершения вашей транзакции.
Параметр Strength
также можно установить в значение SHARE
, который блокирует строки таким образом, чтобы другие транзакции могли читать заблокированные строки, но не могли их обновлять или удалять.
db.Clauses(clause.Locking{ |
Параметр Table
может быть использован для указания таблицы для блокировки. Это полезно, когда вы объединяете несколько таблиц и хотите заблокировать только одну из них.
Можно указать опцию NOWAIT
, которая пытается получить блокировку и немедленно завершится с ошибкой, если блокировка недоступна. Это предотвращает ожидание транзакцией других транзакций для освобождения их блокировок.
db.Clauses(clause.Locking{ |
Другая опция SKIP LOCKED
пропускает строки, уже заблокированные другими транзакциями. Это полезно в условиях высокой конкуренции, когда вы хотите обрабатывать строки, которые в данный момент не заблокированы другими транзакциями.
Более продвинутые стратегии блокировки смотрите в Raw SQL и SQL Builder.
Подзапрос
Подзапросы — это мощная функция в SQL, позволяющая использовать вложенные запросы. GORM может автоматически генерировать подзапросы при использовании объекта *gorm.DB в качестве параметра.
// Простой подзапрос |
Из SubQuery (под запроса)
GORM позволяет использовать подзапросы в оговорке “FROM”, позволяя сложные запросы и организацию данных.
// Использование подзапроса в FROM |
Группировка условий
Групповые условия в GORM обеспечивают более читаемый и поддерживаемый способ записи сложных SQL-запросов с несколькими условиями.
// Сложный SQL запрос с использованием групповых условий |
IN с несколькими столбцами
GORM поддерживает оператор IN с несколькими колонками, позволяя фильтровать данные на основе нескольких значений полей в одном запросе.
// Использование IN с несколькими столбцами |
Именованные аргументы
GORM улучшает читаемость и сопровождаемость SQL-запросов, поддерживая именованные аргументы. Эта функция позволяет создавать более понятные и организованные запросы, особенно в сложных запросах с множественными параметрами. Именованные аргументы можно использовать либо через sql.NamedArg
, либо через map[string]interface{}{}
, что обеспечивает гибкость при построении запросов.
// Пример использования sql.NamedArg для именованных аргументов |
Для дополнительных примеров и подробностей смотрите Raw SQL и SQL Builder
Find с картами
GORM provides flexibility in querying data by allowing results to be scanned into a map[string]interface{}
or []map[string]interface{}
, which can be useful for dynamic data structures.
When using Find To Map
, it’s crucial to include Model
or Table
in your query to explicitly specify the table name. This ensures that GORM understands which table to query against.
// Scanning the first result into a map with Model |
FirstOrInit
GORM’s FirstOrInit
method is utilized to fetch the first record that matches given conditions, or initialize a new instance if no matching record is found. This method is compatible with both struct and map conditions and allows additional flexibility with the Attrs
and Assign
methods.
// If no User with the name "non_existing" is found, initialize a new User |
Using Attrs
for Initialization
When no record is found, you can use Attrs
to initialize a struct with additional attributes. These attributes are included in the new struct but are not used in the SQL query.
// If no User is found, initialize with given conditions and additional attributes |
Using Assign
for Attributes
The Assign
method allows you to set attributes on the struct regardless of whether the record is found or not. These attributes are set on the struct but are not used to build the SQL query and the final data won’t be saved into the database.
// Initialize with given conditions and Assign attributes, regardless of record existence |
FirstOrInit
, along with Attrs
and Assign
, provides a powerful and flexible way to ensure a record exists and is initialized or updated with specific attributes in a single step.
FirstOrCreate
FirstOrCreate
in GORM is used to fetch the first record that matches given conditions or create a new one if no matching record is found. This method is effective with both struct and map conditions. The RowsAffected
property is useful to determine the number of records created or updated.
// Create a new record if not found |
Using Attrs
with FirstOrCreate
Attrs
can be used to specify additional attributes for the new record if it is not found. These attributes are used for creation but not in the initial search query.
// Create a new record with additional attributes if not found |
Using Assign
with FirstOrCreate
The Assign
method sets attributes on the record regardless of whether it is found or not, and these attributes are saved back to the database.
// Initialize and save new record with `Assign` attributes if not found |
Оптимизатор/Индексы
GORM includes support for optimizer and index hints, allowing you to influence the query optimizer’s execution plan. This can be particularly useful in optimizing query performance or when dealing with complex queries.
Optimizer hints are directives that suggest how a database’s query optimizer should execute a query. GORM facilitates the use of optimizer hints through the gorm.io/hints package.
import "gorm.io/hints" |
Index Hints
Index hints provide guidance to the database about which indexes to use. They can be beneficial if the query planner is not selecting the most efficient indexes for a query.
import "gorm.io/hints" |
These hints can significantly impact query performance and behavior, especially in large databases or complex data models. For more detailed information and additional examples, refer to Optimizer Hints/Index/Comment in the GORM documentation.
Итерация
GORM supports the iteration over query results using the Rows
method. This feature is particularly useful when you need to process large datasets or perform operations on each record individually.
You can iterate through rows returned by a query, scanning each row into a struct. This method provides granular control over how each record is handled.
rows, err := db.Model(&User{}).Where("name = ?", "jinzhu").Rows() |
This approach is ideal for complex data processing that cannot be easily achieved with standard query methods.
FindInBatches
FindInBatches
allows querying and processing records in batches. This is especially useful for handling large datasets efficiently, reducing memory usage and improving performance.
With FindInBatches
, GORM processes records in specified batch sizes. Inside the batch processing function, you can apply operations to each batch of records.
// Processing records in batches of 100 |
FindInBatches
is an effective tool for processing large volumes of data in manageable chunks, optimizing resource usage and performance.
Хуки запросов
GORM offers the ability to use hooks, such as AfterFind
, which are triggered during the lifecycle of a query. These hooks allow for custom logic to be executed at specific points, such as after a record has been retrieved from the database.
This hook is useful for post-query data manipulation or default value settings. For more detailed information and additional hook types, refer to Hooks in the GORM documentation.
func (u *User) AfterFind(tx *gorm.DB) (err error) { |
Pluck
The Pluck
method in GORM is used to query a single column from the database and scan the result into a slice. This method is ideal for when you need to retrieve specific fields from a model.
If you need to query more than one column, you can use Select
with Scan or Find instead.
// Retrieving ages of all users |
Scopes
Scopes
in GORM are a powerful feature that allows you to define commonly-used query conditions as reusable methods. These scopes can be easily referenced in your queries, making your code more modular and readable.
Defining Scopes
Scopes
are defined as functions that modify and return a gorm.DB
instance. You can define a variety of conditions as scopes based on your application’s requirements.
// Scope for filtering records where amount is greater than 1000 |
Applying Scopes in Queries
You can apply one or more scopes to a query by using the Scopes
method. This allows you to chain multiple conditions dynamically.
// Applying scopes to find all credit card orders with an amount greater than 1000 |
Scopes
are a clean and efficient way to encapsulate common query logic, enhancing the maintainability and readability of your code. For more detailed examples and usage, refer to Scopes in the GORM documentation.
Count
The Count
method in GORM is used to retrieve the number of records that match a given query. It’s a useful feature for understanding the size of a dataset, particularly in scenarios involving conditional queries or data analysis.
Getting the Count of Matched Records
You can use Count
to determine the number of records that meet specific criteria in your queries.
var count int64 |
Count with Distinct and Group
GORM also allows counting distinct values and grouping results.
// Counting distinct names |