{"id":483420,"date":"2026-06-12T11:29:52","date_gmt":"2026-06-12T11:29:52","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=483420"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=483420","title":{"rendered":"sqlh \u2014 SQL \u0432 Go \u0431\u0435\u0437 boilerplate: \u043f\u0438\u0448\u0435\u043c CRUD \u0437\u0430 50 \u0441\u0442\u0440\u043e\u043a"},"content":{"rendered":"
\n

> Zero-boilerplate SQL \u0434\u043b\u044f Go. \u041e\u043f\u0438\u0448\u0438 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443 \u0442\u0435\u0433\u0430\u043c\u0438 \u2014 \u0438 \u044d\u0442\u043e \u0432\u0441\u0451.<\/em><\/p>\n

\u0415\u0441\u043b\u0438 \u0432\u044b \u043f\u0438\u0448\u0435\u0442\u0435 \u043d\u0430 Go \u0438 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442\u0435 \u0441 SQL-\u0431\u0430\u0437\u0430\u043c\u0438, \u0432\u044b \u0437\u043d\u0430\u0435\u0442\u0435 \u044d\u0442\u0443 \u0431\u043e\u043b\u044c. \u041a\u0430\u0436\u0434\u044b\u0439 CRUD-\u0437\u0430\u043f\u0440\u043e\u0441 \u2014 \u0440\u0443\u0447\u043d\u043e\u0439 SQL-\u0441\u0442\u0440\u043e\u043a\u0430, rows.Scan<\/code> \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u043e\u043b\u044f, Begin\/Commit\/Rollback<\/code> \u0432\u043e\u043a\u0440\u0443\u0433 \u0437\u0430\u043f\u0438\u0441\u0438, \u0438 \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u0430\u044f \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0430\u0446\u0438\u044f DDL-\u0441\u0445\u0435\u043c\u044b \u0441 \u043a\u043e\u0434\u043e\u043c. \u0428\u0430\u0431\u043b\u043e\u043d\u043d\u044b\u0439 \u043a\u043e\u0434 \u043d\u0435 \u0437\u0430\u043a\u0430\u043d\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u043d\u0438\u043a\u043e\u0433\u0434\u0430.<\/p>\n

\u042d\u0442\u043e \u0440\u0430\u0441\u0441\u043a\u0430\u0437 \u043e sqlh<\/code> \u2014 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0435, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0443\u0431\u0438\u0440\u0430\u0435\u0442 \u0432\u0441\u0451 \u044d\u0442\u043e, \u043e\u0441\u0442\u0430\u0432\u0430\u044f\u0441\u044c \u0432 \u00ab\u0437\u043e\u043b\u043e\u0442\u043e\u0439 \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0435\u00bb \u043c\u0435\u0436\u0434\u0443 raw SQL (\u0441\u043b\u0438\u0448\u043a\u043e\u043c \u043c\u043d\u043e\u0433\u043e \u0440\u0430\u0431\u043e\u0442\u044b) \u0438 \u0442\u044f\u0436\u0451\u043b\u044b\u043c\u0438 ORM (\u0441\u043b\u0438\u0448\u043a\u043e\u043c \u043c\u043d\u043e\u0433\u043e \u043c\u0430\u0433\u0438\u0438).<\/p>\n

## \u00a71. \u041f\u0440\u043e\u0431\u043b\u0435\u043c\u0430: Go + SQL = \u0441\u043c\u0435\u0440\u0442\u044c \u043e\u0442 \u0442\u044b\u0441\u044f\u0447\u0438 <\/strong>rows.Scan<\/strong><\/code><\/p>\n

\u0421\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0439 database\/sql<\/code> \u0432 Go \u043e\u0442\u043b\u0438\u0447\u0435\u043d. \u041e\u043d \u0434\u0430\u0451\u0442 \u043f\u0440\u043e\u0447\u043d\u044b\u0439, \u043f\u0435\u0440\u0435\u043d\u043e\u0441\u0438\u043c\u044b\u0439 \u0444\u0443\u043d\u0434\u0430\u043c\u0435\u043d\u0442 \u0434\u043b\u044f \u043b\u044e\u0431\u043e\u0439 SQL-\u0431\u0430\u0437\u044b. \u041d\u043e \u043e\u043d \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u043d\u043e \u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0442\u044f\u0436\u0451\u043b\u0443\u044e \u0440\u0430\u0431\u043e\u0442\u0443 \u0437\u0430 \u0432\u0430\u043c\u0438.<\/p>\n

\u0412\u043e\u0442 \u043a\u0430\u043a \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043f\u0440\u043e\u0441\u0442\u043e\u0439 CRUD \u043d\u0430 \u0447\u0438\u0441\u0442\u043e\u043c database\/sql<\/code>:<\/p>\n

«`go<\/p>\n

\/\/ 1. CREATE TABLE \u2014 raw DDL-\u0441\u0442\u0440\u043e\u043a\u0430<\/p>\n

_, err := db.Exec(`CREATE TABLE IF NOT EXISTS user (<\/p>\n

\u00a0 \u00a0 id INTEGER PRIMARY KEY AUTOINCREMENT,<\/p>\n

\u00a0 \u00a0 name TEXT UNIQUE,<\/p>\n

\u00a0 \u00a0 email TEXT,<\/p>\n

\u00a0 \u00a0 age INTEGER<\/p>\n

)`)<\/p>\n

\/\/ 2. INSERT \u2014 \u044f\u0432\u043d\u044b\u0435 placeholder \u0438 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b<\/p>\n

_, err = db.Exec(<\/p>\n

\u00a0 \u00a0 «INSERT INTO user (name, email, age) VALUES (?, ?, ?)»,<\/p>\n

\u00a0 \u00a0 «Alice», «alice@example.com<\/a>«, 30,<\/p>\n

)<\/p>\n

\/\/ 3. GET \u043f\u043e ID \u2014 QueryRow + \u0440\u0443\u0447\u043d\u043e\u0439 Scan<\/p>\n

var u User<\/p>\n

err = db.QueryRow(«SELECT id, name, email, age FROM user WHERE id = ?», 1).<\/p>\n

\u00a0 \u00a0 Scan(&u.ID<\/a>, &u.Name<\/a>, &u.Email<\/a>, &u.Age)<\/p>\n

\/\/ 4. LIST \u0432\u0441\u0435\u0445 \u2014 Query + rows.Next<\/a> + rows.Scan \u0432 \u0446\u0438\u043a\u043b\u0435<\/p>\n

rows, err := db.Query(«SELECT id, name, email, age FROM user ORDER BY name ASC»)<\/p>\n

var users []User<\/p>\n

for rows.Next<\/a>() {<\/p>\n

\u00a0 \u00a0 var u User<\/p>\n

\u00a0 \u00a0 if err := rows.Scan(&u.ID<\/a>, &u.Name<\/a>, &u.Email<\/a>, &u.Age); err != nil {<\/p>\n

\u00a0 \u00a0 \u00a0 \u00a0 log.Fatal(err)<\/p>\n

\u00a0 \u00a0 }<\/p>\n

\u00a0 \u00a0 users = append(users, u)<\/p>\n

}<\/p>\n

rows.Close()<\/p>\n

\/\/ 5. UPDATE \u2014 raw SQL \u0441 placeholder<\/p>\n

_, err = db.Exec(<\/p>\n

\u00a0 \u00a0 «UPDATE user SET email = ?, age = ? WHERE id = ?»,<\/p>\n

\u00a0 \u00a0 «alice.new@example.com<\/a>«, 31, 1,<\/p>\n

)<\/p>\n

\/\/ 6. DELETE \u2014 raw SQL<\/p>\n

_, err = db.Exec(«DELETE FROM user WHERE id = ?», 1)<\/p>\n

«`<\/p>\n

\u042d\u0442\u043e ~115 \u0441\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430<\/strong> \u0434\u043b\u044f \u0448\u0435\u0441\u0442\u0438 \u0431\u0430\u0437\u043e\u0432\u044b\u0445 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439. \u0418 \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437, \u043a\u043e\u0433\u0434\u0430 \u0432\u044b \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0435 \u0441\u0442\u043e\u043b\u0431\u0435\u0446, \u043d\u0443\u0436\u043d\u043e \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u044c \u0441\u0442\u0440\u043e\u043a\u0443 CREATE TABLE<\/code>, \u0441\u043f\u0438\u0441\u043e\u043a \u043a\u043e\u043b\u043e\u043d\u043e\u043a \u0432 INSERT<\/code>, \u0441\u043f\u0438\u0441\u043e\u043a \u0432 SELECT<\/code>, \u0438 \u0432\u044b\u0437\u043e\u0432 rows.Scan<\/code>. \u041e\u043f\u0435\u0447\u0430\u0442\u043a\u0430 \u0432 \u043b\u044e\u0431\u043e\u043c \u043c\u0435\u0441\u0442\u0435 \u2014 runtime-\u043e\u0448\u0438\u0431\u043a\u0430, compile-time \u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u0438 \u043d\u0435\u0442.<\/p>\n

| \u0411\u043e\u043b\u044c | \u041f\u043e\u0447\u0435\u043c\u0443 \u0431\u043e\u043b\u044c\u043d\u043e |<\/p>\n

|——|—————|<\/p>\n

| \u0420\u0443\u0447\u043d\u043e\u0439 SQL | \u041a\u0430\u0436\u0434\u044b\u0439 CRUD \u2014 raw SQL-\u0441\u0442\u0440\u043e\u043a\u0430, \u043d\u0435\u0442 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043d\u0430 \u044d\u0442\u0430\u043f\u0435 \u043a\u043e\u043c\u043f\u0438\u043b\u044f\u0446\u0438\u0438 |<\/p>\n

| rows.Scan<\/code> | 4\u20135 \u0441\u0442\u0440\u043e\u043a \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u043c\u0430\u043f\u043f\u0438\u043d\u0433\u0430 \u043a\u043e\u043b\u043e\u043d\u043e\u043a \u043d\u0430 \u043f\u043e\u043b\u044f |<\/p>\n

| \u0422\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 | db.Begin()<\/code> + defer tx.Rollback()<\/code> + tx.Commit()<\/code> \u2014 \u0432\u0435\u0437\u0434\u0435 |<\/p>\n

| \u041d\u0435\u0442 \u0441\u0432\u044f\u0437\u0438 \u0441\u043e \u0441\u0445\u0435\u043c\u043e\u0439 | DDL \u0432 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u044f\u0445, \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b \u0432 Go \u2014 \u043e\u043d\u0438 \u0440\u0430\u0441\u0445\u043e\u0434\u044f\u0442\u0441\u044f |<\/p>\n

| \u041f\u043e\u0440\u044f\u0434\u043e\u043a \u043a\u043e\u043b\u043e\u043d\u043e\u043a | \u041d\u043e\u0432\u044b\u0439 \u0441\u0442\u043e\u043b\u0431\u0435\u0446 \u2192 \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c SQL-\u0441\u0442\u0440\u043e\u043a\u0438 \u0438<\/strong> Scan<\/code>-\u0432\u044b\u0437\u043e\u0432\u044b |<\/p>\n

## \u00a72. \u0421\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u044f: sqlx \u0438 GORM<\/strong><\/p>\n

\u0412 \u044d\u043a\u043e\u0441\u0438\u0441\u0442\u0435\u043c\u0435 Go \u0435\u0441\u0442\u044c \u0434\u0432\u0430 \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0445 \u043f\u0443\u0442\u0438. \u0423 \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u0441\u0432\u043e\u0438 \u043a\u043e\u043c\u043f\u0440\u043e\u043c\u0438\u0441\u0441\u044b.<\/p>\n

### sqlx: \u043b\u0443\u0447\u0448\u0435, \u043d\u043e \u0432\u0441\u0451 \u0435\u0449\u0451 \u0440\u0443\u0447\u043d\u043e\u0439 SQL<\/strong><\/p>\n

[sqlx](https:\/\/github.com\/jmoiron\/sqlx<\/a>) \u2014 \u043f\u043e\u043f\u0443\u043b\u044f\u0440\u043d\u043e\u0435 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435 database\/sql<\/code>. \u041e\u043d \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 StructScan<\/code>, Get<\/code>, Select<\/code>, \u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b. SQL \u043f\u0438\u0448\u0435\u0442\u0435 \u043f\u043e-\u043f\u0440\u0435\u0436\u043d\u0435\u043c\u0443 \u0440\u0443\u043a\u0430\u043c\u0438, \u043d\u043e rows.Scan<\/code> \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d.<\/p>\n

«`go<\/p>\n

\/\/ sqlx: \u0432\u0441\u0451 \u0435\u0449\u0451 \u0440\u0443\u0447\u043d\u043e\u0439 SQL, \u043d\u043e StructScan \u0443\u0431\u0438\u0440\u0430\u0435\u0442 Scan<\/p>\n

var u User<\/p>\n

dbx.Get(&u, «SELECT id, name, email, age FROM user WHERE id = ?», 1)<\/p>\n

«`<\/p>\n

sqlx \u0441\u044d\u043a\u043e\u043d\u043e\u043c\u0438\u0442 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e 30% boilerplate<\/strong> (\u0434\u043e ~80 \u0441\u0442\u0440\u043e\u043a). \u041d\u043e CREATE TABLE<\/code>, INSERT<\/code>, SELECT<\/code>, UPDATE<\/code>, DELETE<\/code> \u2014 \u0432\u0441\u0451 \u0435\u0449\u0451 \u043f\u0438\u0448\u0435\u0442\u0435 \u0432\u0440\u0443\u0447\u043d\u0443\u044e. \u0413\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f SQL \u2014 \u043d\u0435 \u0435\u0433\u043e \u0437\u0430\u0434\u0430\u0447\u0430.<\/p>\n

### GORM: \u043f\u043e\u043b\u043d\u044b\u0439 ORM, \u043f\u043e\u043b\u043d\u0430\u044f \u043c\u0430\u0433\u0438\u044f<\/strong><\/p>\n

[GORM](https:\/\/gorm.io\/<\/a>) \u2014 \u0442\u044f\u0436\u0435\u043b\u043e\u0432\u0435\u0441. \u0413\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 \u0432\u0441\u0451 \u2014 \u0441\u0445\u0435\u043c\u0443, \u0437\u0430\u043f\u0440\u043e\u0441\u044b, \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438 \u2014 \u0438 \u0434\u0430\u0451\u0442 \u0431\u043e\u0433\u0430\u0442\u044b\u0439 chainable API. \u041d\u043e \u0446\u0435\u043d\u0430 \u0432\u044b\u0441\u043e\u043a\u0430:<\/p>\n

— \u0422\u044f\u0436\u0451\u043b\u044b\u0439 reflection<\/strong> \u0432 runtime<\/p>\n

— \u041a\u0440\u0443\u0442\u0430\u044f \u043a\u0440\u0438\u0432\u0430\u044f \u043e\u0431\u0443\u0447\u0435\u043d\u0438\u044f<\/strong> \u2014 \u0442\u0435\u0433\u0438, \u0445\u0443\u043a\u0438, scopes, \u0430\u0441\u0441\u043e\u0446\u0438\u0430\u0446\u0438\u0438<\/p>\n

— ~4 MB \u0443\u0432\u0435\u043b\u0438\u0447\u0435\u043d\u0438\u0435 \u0431\u0438\u043d\u0430\u0440\u043d\u0438\u043a\u0430<\/strong> \u0442\u043e\u043b\u044c\u043a\u043e \u0437\u0430 ORM<\/p>\n

— \u041c\u0430\u0433\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0441\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0441\u043b\u043e\u0436\u043d\u043e\u0441\u0442\u044c<\/strong> \u2014 \u043f\u043e\u043a\u0430 \u043d\u0435 \u0441\u043b\u043e\u043c\u0430\u0435\u0442\u0441\u044f, \u0438 \u0432\u044b \u0447\u0430\u0441\u0430\u043c\u0438 \u0434\u0435\u0431\u0430\u0436\u0438\u0442\u0435<\/p>\n

\u0414\u043b\u044f \u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u043a\u043e\u043c\u0430\u043d\u0434 \u0441 \u0432\u044b\u0434\u0435\u043b\u0435\u043d\u043d\u044b\u043c\u0438 DBA \u0438 \u0441\u043b\u043e\u0436\u043d\u044b\u043c\u0438 \u043c\u043e\u0434\u0435\u043b\u044f\u043c\u0438 GORM \u2014 solid choice. \u0414\u043b\u044f CLI-\u0443\u0442\u0438\u043b\u0438\u0442, \u0441\u0442\u0430\u0440\u0442\u0430\u043f\u043e\u0432 \u0438 \u043c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u2014 overkill.<\/p>\n

### sqlh: \u0437\u043e\u043b\u043e\u0442\u0430\u044f \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0430<\/strong><\/p>\n

| \u0424\u0438\u0447\u0430 | database\/sql<\/code> | sqlx | GORM | sqlh<\/strong> |<\/p>\n

|—|—|—|—|—|<\/p>\n

| SQL-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f | \u274c \u0420\u0443\u0447\u043d\u0430\u044f | \u274c \u0420\u0443\u0447\u043d\u0430\u044f | \u2705 \u041f\u043e\u043b\u043d\u0430\u044f | \u2705 \u041f\u043e\u043b\u043d\u0430\u044f |<\/p>\n

| rows.Scan<\/code> | \u2705 \u041d\u0443\u0436\u0435\u043d | \u274c StructScan<\/code> | \u274c \u0410\u0432\u0442\u043e | \u274c \u0410\u0432\u0442\u043e |<\/p>\n

| \u0422\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u044c (generics) | \u274c | \u274c | \u274c | \u2705 |<\/p>\n

| \u0410\u0432\u0442\u043e-\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 | \u274c | \u274c | \u2705 | \u2705 |<\/p>\n

| \u0420\u0435\u0442\u0440\u0430\u0439 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u043e\u043a | \u274c | \u274c | \u274c | \u2705 |<\/p>\n

| \u041a\u0440\u0438\u0432\u0430\u044f \u043e\u0431\u0443\u0447\u0435\u043d\u0438\u044f | \u0421\u0440\u0435\u0434\u043d\u044f\u044f | \u0421\u0440\u0435\u0434\u043d\u044f\u044f | \u0412\u044b\u0441\u043e\u043a\u0430\u044f | \u041d\u0438\u0437\u043a\u0430\u044f<\/strong> |<\/p>\n

| \u041e\u0432\u0435\u0440\u0445\u0435\u0434 \u0431\u0438\u043d\u0430\u0440\u043d\u0438\u043a\u0430 | 0 | ~200 KB | ~4 MB | ~200 KB |<\/p>\n

sqlh \u0436\u0438\u0432\u0451\u0442 \u043c\u0435\u0436\u0434\u0443 sqlx \u0438 GORM:<\/p>\n

— Zero-boilerplate CRUD<\/strong> \u2014 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u044b\u0435 \u0442\u0435\u0433\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u044e\u0442 \u0432\u0435\u0441\u044c SQL<\/p>\n

— \u0422\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u044c \u0447\u0435\u0440\u0435\u0437 Go generics<\/strong> \u2014 Get[User]()<\/code> \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 *User<\/code>, \u043d\u0435 interface{}<\/code><\/p>\n

— \u041d\u0438\u043a\u0430\u043a\u043e\u0439 \u043c\u0430\u0433\u0438\u0438<\/strong> \u2014 \u0447\u0442\u043e \u0432\u0438\u0434\u0438\u0442\u0435 \u0432 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0435, \u0442\u043e \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 \u0432 \u0431\u0430\u0437\u0435<\/p>\n

— \u041b\u0451\u0433\u043a\u0438\u0439<\/strong> \u2014 \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 reflection, \u043a\u0435\u0448 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0445, \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u0441\u043a\u0440\u044b\u0442\u043e\u0439 \u0441\u043b\u043e\u0436\u043d\u043e\u0441\u0442\u0438<\/p>\n

## \u00a73. \u041a\u0430\u043a sqlh \u0440\u0435\u0448\u0430\u0435\u0442 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0443: \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u044b\u0435 \u0442\u0435\u0433\u0438 \u043a\u0430\u043a \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043f\u0440\u0430\u0432\u0434\u044b<\/strong><\/p>\n

\u0418\u0434\u0435\u044f \u043f\u0440\u043e\u0441\u0442\u0430: \u0432\u0430\u0448\u0430 Go-\u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u2014 \u044d\u0442\u043e \u0432\u0430\u0448\u0430 \u0441\u0445\u0435\u043c\u0430<\/strong>.<\/p>\n

«`go<\/p>\n

type User struct {<\/p>\n

\u00a0 \u00a0 ID \u00a0 \u00a0int64 \u00a0db:\"id\" db_key:\"not null primary key autoincrement\"<\/code><\/p>\n

\u00a0 \u00a0 Name \u00a0string db:\"name\" db_key:\"unique\"<\/code><\/p>\n

\u00a0 \u00a0 Email string db:\"email\"<\/code><\/p>\n

\u00a0 \u00a0 Age \u00a0 int \u00a0 \u00a0db:\"age\"<\/code><\/p>\n

}<\/p>\n

«`<\/p>\n

\u0422\u0440\u0438 \u0442\u0435\u0433\u0430 \u0443\u043f\u0440\u0430\u0432\u043b\u044f\u044e\u0442 \u0432\u0441\u0435\u043c:<\/p>\n

| \u0422\u0435\u0433 | \u041d\u0430\u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 | \u041f\u0440\u0438\u043c\u0435\u0440 |<\/p>\n

|——|————|———|<\/p>\n

| db<\/code> | \u0418\u043c\u044f \u043a\u043e\u043b\u043e\u043d\u043a\u0438 | db:\"user_name\"<\/code> |<\/p>\n

| db_key<\/code> | \u041e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u044f, \u0438\u043d\u0434\u0435\u043a\u0441\u044b | db_key:\"primary key autoincrement\"<\/code> |<\/p>\n

| db_type<\/code> | \u041f\u0435\u0440\u0435\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u0442\u0438\u043f\u0430 SQL | db_type:\"TEXT\"<\/code> |<\/p>\n

\u0418\u0437 \u044d\u0442\u043e\u0433\u043e \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0433\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f sqlh \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442:<\/p>\n

— CREATE TABLE<\/strong> \u2014 sqlh.Create[User](db)<\/code> \u2192 CREATE TABLE IF NOT EXISTS user (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT UNIQUE, email TEXT, age INTEGER)<\/code><\/p>\n

— INSERT<\/strong> \u2014 sqlh.Insert(db, User{Name: \"Alice\"})<\/code> \u2192 INSERT INTO user (name, email, age) VALUES (?, ?, ?)<\/code><\/p>\n

— SELECT<\/strong> \u2014 sqlh.Get[User](db, ...)<\/code> \u2192 SELECT id, name, email, age FROM user WHERE ... LIMIT 2<\/code><\/p>\n

— UPDATE<\/strong> \u2014 sqlh.Update(db, ...)<\/code> \u2192 UPDATE user SET name=?, email=?, age=? WHERE ...<\/code><\/p>\n

— DELETE<\/strong> \u2014 sqlh.Delete[User](db, ...)<\/code> \u2192 DELETE FROM user WHERE ...<\/code><\/p>\n

### \u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430<\/strong><\/p>\n

«`<\/p>\n

\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<\/p>\n

\u2502 \u00a0sqlh package \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2502<\/p>\n

\u2502 \u00a0Insert, Get, List, Update, Delete, Set, \u00a0 \u00a0\u2502<\/p>\n

\u2502 \u00a0Create \u2014 \u0441 \u0430\u0432\u0442\u043e-\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f\u043c\u0438 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2502<\/p>\n

\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524<\/p>\n

\u2502 \u00a0query package \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2502<\/p>\n

\u2502 \u00a0SQL-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f, \u043a\u0435\u0448 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0445, JOIN \u00a0 \u00a0 \u00a0 \u00a0\u2502<\/p>\n

\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524<\/p>\n

\u2502 \u00a0database\/sql (stdlib) \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2502<\/p>\n

\u2502 \u00a0\u041f\u0443\u043b \u0441\u043e\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u0439, \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435 raw-\u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u00a0 \u00a0\u2502<\/p>\n

\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/p>\n

«`<\/p>\n

### \u041a\u043b\u044e\u0447\u0435\u0432\u044b\u0435 \u0434\u0438\u0437\u0430\u0439\u043d-\u0440\u0435\u0448\u0435\u043d\u0438\u044f<\/strong><\/p>\n

1. Generics-first (Go 1.25+)<\/strong> \u2014 Get[User]()<\/code> \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 *User<\/code> \u0441 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u043e\u0439 \u0442\u0438\u043f\u043e\u0432 \u043d\u0430 \u044d\u0442\u0430\u043f\u0435 \u043a\u043e\u043c\u043f\u0438\u043b\u044f\u0446\u0438\u0438. \u041d\u0438\u043a\u0430\u043a\u0438\u0445 interface{}<\/code>, \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u0438\u0439 \u0442\u0438\u043f\u043e\u0432.<\/p>\n

2. \u0420\u0435\u0444\u043b\u0435\u043a\u0441\u0438\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437<\/strong> \u2014 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b \u043f\u0430\u0440\u0441\u044f\u0442\u0441\u044f \u0438 \u043a\u0435\u0448\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u0432 sync.Map<\/code><\/a> \u043f\u043e reflect.Type<\/code>. \u041f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0435 \u0432\u044b\u0437\u043e\u0432\u044b \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442 \u0438\u043c\u0435\u043d\u0430 \u0442\u0430\u0431\u043b\u0438\u0446, \u0441\u043f\u0438\u0441\u043a\u0438 \u043f\u043e\u043b\u0435\u0439, scan-\u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435.<\/p>\n

3. \u0410\u0432\u0442\u043e-\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 \u043d\u0430 \u0437\u0430\u043f\u0438\u0441\u044c<\/strong> \u2014 \u043a\u0430\u0436\u0434\u044b\u0439 Insert<\/code>, Update<\/code>, Delete<\/code>, Set<\/code> \u043e\u0431\u0451\u0440\u043d\u0443\u0442 \u0432 BEGIN...COMMIT<\/code> \u0441 ROLLBACK<\/code> \u043f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0435. \u0422\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 \u043d\u0438\u043a\u043e\u0433\u0434\u0430 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u0435\u0442\u0435.<\/p>\n

4. \u0420\u0435\u0442\u0440\u0430\u0439 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u043e\u043a SQLite<\/strong> \u2014 \u043e\u0448\u0438\u0431\u043a\u0438 \u00abdatabase is locked\u00bb \u0440\u0435\u0442\u0440\u0430\u044f\u0442\u0441\u044f \u0434\u043e 20 \u0440\u0430\u0437 \u0441 backoff 100 ms. Production-\u0443\u0441\u0442\u043e\u0439\u0447\u0438\u0432\u043e\u0441\u0442\u044c \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438.<\/p>\n

5. \u041c\u0443\u043b\u044c\u0442\u0438-\u0411\u0414<\/strong> \u2014 SQLite (\u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439), MySQL, PostgreSQL (\u043e\u0431\u0430 \u0432 CI), SQL Server (\u044d\u043a\u0441\u043f\u0435\u0440\u0438\u043c\u0435\u043d\u0442\u0430\u043b\u044c\u043d\u043e).<\/p>\n

## \u00a74. CRUD \u0437\u0430 50 \u0441\u0442\u0440\u043e\u043a: \u0431\u044b\u0441\u0442\u0440\u044b\u0439 \u0441\u0442\u0430\u0440\u0442<\/strong><\/p>\n

\u0422\u043e\u0442 \u0436\u0435 CRUD, \u0447\u0442\u043e \u0432 \u043d\u0430\u0447\u0430\u043b\u0435 \u2014 \u043d\u043e ~57% \u043a\u043e\u0440\u043e\u0447\u0435<\/strong>:<\/p>\n

«`go<\/p>\n

package main<\/p>\n

import (<\/p>\n

\u00a0 \u00a0 «database\/sql»<\/p>\n

\u00a0 \u00a0 «fmt»<\/p>\n

\u00a0 \u00a0 «github.com\/kirill-scherba\/sqlh»<\/p>\n

\u00a0 \u00a0 _ «github.com\/mattn\/go-sqlite3»<\/p>\n

)<\/p>\n

type User struct {<\/p>\n

\u00a0 \u00a0 ID \u00a0 \u00a0int64 \u00a0db:\"id\" db_key:\"not null primary key autoincrement\"<\/code><\/p>\n

\u00a0 \u00a0 Name \u00a0string db:\"name\" db_key:\"unique\"<\/code><\/p>\n

\u00a0 \u00a0 Email string db:\"email\"<\/code><\/p>\n

\u00a0 \u00a0 Age \u00a0 int \u00a0 \u00a0db:\"age\"<\/code><\/p>\n

}<\/p>\n

func main() {<\/p>\n

\u00a0 \u00a0 db, _ := sql.Open<\/a>(«sqlite3», «file::memory:?cache=shared»)<\/p>\n

\u00a0 \u00a0 defer db.Close()<\/p>\n

\u00a0 \u00a0 \/\/ 1. CREATE TABLE \u0438\u0437 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b<\/p>\n

\u00a0 \u00a0 sqlh.Create[User](db)<\/p>\n

\u00a0 \u00a0 \/\/ 2. INSERT<\/p>\n

\u00a0 \u00a0 sqlh.Insert(db, User{Name: «Alice», Email: «alice@example.com<\/a>«, Age: 30})<\/p>\n

\u00a0 \u00a0 bobID, _ := sqlh.InsertId(db, User{Name: «Bob», Email: «bob@example.com<\/a>«, Age: 25})<\/p>\n

\u00a0 \u00a0 \/\/ 3. GET \u043f\u043e ID \u2014 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 *User, \u043d\u0435 interface{}<\/p>\n

\u00a0 \u00a0 u, _ := sqlh.Get[User](db, sqlh.Eq(«id», bobID))<\/p>\n

\u00a0 \u00a0 fmt.Println(u.Name<\/a>) \/\/ «Bob»<\/p>\n

\u00a0 \u00a0 \/\/ 4. LIST \u0432\u0441\u0435\u0445 \u2014 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 []User + next offset<\/p>\n

\u00a0 \u00a0 users, , <\/em> := sqlh.List[User](db, 0, «», «name ASC»)<\/p>\n

\u00a0 \u00a0 fmt.Println(len(users)) \/\/ 2<\/p>\n

\u00a0 \u00a0 \/\/ 5. UPDATE \u2014 \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u043c \u043f\u043e\u043b\u043d\u0443\u044e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443, \u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u0437\u0430\u043d\u0443\u043b\u0438\u0442\u044c \u0434\u0440\u0443\u0433\u0438\u0435 \u043a\u043e\u043b\u043e\u043d\u043a\u0438<\/p>\n

\u00a0 \u00a0 sqlh.Update(db, sqlh.UpdateAttr[User]{<\/p>\n

\u00a0 \u00a0 \u00a0 \u00a0 Row: \u00a0 \u00a0User{Name: «Alice», Email: «alice.new@example.com<\/a>«, Age: 31},<\/p>\n

\u00a0 \u00a0 \u00a0 \u00a0 Wheres: []sqlh.Where{sqlh.Eq(«id», 1)},<\/p>\n

\u00a0 \u00a0 })<\/p>\n

\u00a0 \u00a0 \/\/ 6. DELETE<\/p>\n

\u00a0 \u00a0 sqlh.Delete[User](db, sqlh.Eq(«id», bobID))<\/p>\n

}<\/p>\n

«`<\/p>\n

~50 \u0441\u0442\u0440\u043e\u043a.<\/strong> \u041d\u0438\u043a\u0430\u043a\u043e\u0433\u043e raw SQL. \u041d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e rows.Scan<\/code>. \u041d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e BEGIN\/COMMIT<\/code>. \u041d\u0438 \u043e\u0434\u043d\u043e\u0439 \u043e\u0448\u0438\u0431\u043a\u0438 \u0432 \u043f\u043e\u0440\u044f\u0434\u043a\u0435 \u043a\u043e\u043b\u043e\u043d\u043e\u043a.<\/p>\n

### \u0421\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u0435 \u0431\u043e\u043a-\u043e-\u0431\u043e\u043a<\/strong><\/p>\n

| \u041e\u043f\u0435\u0440\u0430\u0446\u0438\u044f | Raw database\/sql<\/code> | sqlx | sqlh<\/strong> |<\/p>\n

|———-|——————|——|———-|<\/p>\n

| CREATE TABLE | Raw SQL-\u0441\u0442\u0440\u043e\u043a\u0430 | Raw SQL-\u0441\u0442\u0440\u043e\u043a\u0430 | sqlh.Create[User](db)<\/code> |<\/p>\n

| INSERT | Exec(?,?,?)<\/code> | NamedExec<\/code> | Insert(T)<\/code> |<\/p>\n

| GET | QueryRow + Scan<\/code> | Get(&T)<\/code> | Get[T](where)<\/code> |<\/p>\n

| LIST | rows.Next<\/code><\/a> + Scan<\/code> | Select<\/code> | List[T](...)<\/code> |<\/p>\n

| UPDATE | Exec(?,?,?,?)<\/code> | NamedExec<\/code> | Update(attr)<\/code> |<\/p>\n

| DELETE | Exec(?)<\/code> | Exec(?)<\/code> | Delete[T](where)<\/code> |<\/p>\n

| COUNT | QueryRow + Scan<\/code> | Get(&int)<\/code> | Count[T]()<\/code> |<\/p>\n

| | \u0421\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430 | \u0421\u043e\u043a\u0440\u0430\u0449\u0435\u043d\u0438\u0435 |<\/p>\n

|—|—|—|<\/p>\n

| Raw database\/sql<\/code> | ~115 | baseline |<\/p>\n

| sqlx | ~80 | \u221230% |<\/p>\n

| sqlh<\/strong> | ~50<\/strong> | \u221257%<\/strong> |<\/p>\n

### Table[T]: \u0443\u0434\u043e\u0431\u043d\u044b\u0439 method-based API<\/strong><\/p>\n

\u0414\u043b\u044f \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u043e\u0432, \u0433\u0434\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439 \u043d\u0430\u0434 \u043e\u0434\u043d\u043e\u0439 \u0442\u0430\u0431\u043b\u0438\u0446\u0435\u0439 \u2014 \u043c\u043e\u0436\u043d\u043e \u043e\u0431\u0435\u0440\u043d\u0443\u0442\u044c \u0432 Table[T]<\/code>:<\/p>\n

«`go<\/p>\n

tbl, _ := sqlh.CreateTable[User](db)<\/p>\n

tbl.Insert(User{Name: «Charlie», Email: «charlie@example.com<\/a>«, Age: 28})<\/p>\n

c, _ := tbl.Get(sqlh.Eq(«name», «Charlie»))<\/p>\n

fmt.Println(c.Name<\/a>)<\/p>\n

for _, user := range tbl.List(0, «», «name ASC», 0) {<\/p>\n

\u00a0 \u00a0 fmt.Println(user.Name<\/a>)<\/p>\n

}<\/p>\n

«`<\/p>\n

Table[T]<\/code> \u2014 \u043b\u0451\u0433\u043a\u0438\u0439 wrapper \u043d\u0430\u0434 \u043e\u0431\u0449\u0438\u043c *sql.DB<\/code>. \u041e\u043d \u043d\u0435 \u0432\u043b\u0430\u0434\u0435\u0435\u0442<\/strong> \u0441\u043e\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u0435\u043c, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 Close()<\/code> \u2014 no-op (\u0434\u043b\u044f \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438). \u0420\u0435\u0441\u0443\u0440\u0441\u044b \u043e\u0447\u0438\u0449\u0430\u0435\u0442 \u0432\u044b\u0437\u044b\u0432\u0430\u044e\u0449\u0438\u0439 \u0447\u0435\u0440\u0435\u0437 db.Close()<\/code>.<\/p>\n

### Set (upsert): \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 UPSERT<\/strong><\/p>\n

Set<\/code> \u2014 \u0430\u0442\u043e\u043c\u0430\u0440\u043d\u044b\u0439 upsert. \u0414\u043b\u044f PostgreSQL, SQLite \u0438 MySQL \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u0441\u0438\u043d\u0442\u0430\u043a\u0441\u0438\u0441 \u0431\u0430\u0437\u044b:<\/p>\n

— PostgreSQL<\/strong>: INSERT ... ON CONFLICT (...) DO UPDATE SET ...<\/code><\/p>\n

— SQLite<\/strong>: INSERT ... ON CONFLICT (...) DO UPDATE SET ...<\/code><\/p>\n

— MySQL<\/strong>: INSERT ... ON DUPLICATE KEY UPDATE ...<\/code><\/p>\n

\u0414\u043b\u044f \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0445 \u0434\u0440\u0430\u0439\u0432\u0435\u0440\u043e\u0432 \u2014 fallback \u043d\u0430 SELECT-then-INSERT\/UPDATE \u0432 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438.<\/p>\n

«`go<\/p>\n

\/\/ name \u043f\u043e\u043c\u0435\u0447\u0435\u043d db_key:»unique» \u2014 Set \u0441\u0434\u0435\u043b\u0430\u0435\u0442 UPDATE \u043f\u0440\u0438 \u0441\u043e\u0432\u043f\u0430\u0434\u0435\u043d\u0438\u0438<\/p>\n

err := sqlh.Set(db, User{Name: «Dave», Email: «dave@example.com<\/a>«}, sqlh.Eq(«name», «Dave»))<\/p>\n

«`<\/p>\n

### ListRange: Go 1.25 iterators<\/strong><\/p>\n

\u0412\u043c\u0435\u0441\u0442\u043e List<\/code> \u0441 \u0441\u043b\u0430\u0439\u0441\u043e\u043c \u2014 \u043b\u0435\u043d\u0438\u0432\u044b\u0439 \u0438\u0442\u0435\u0440\u0430\u0442\u043e\u0440 ListRange<\/code>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 iter.Seq2[int, T]<\/code>. \u041d\u0435 \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u0435\u0442 \u0432\u0441\u0451 \u0432 \u043f\u0430\u043c\u044f\u0442\u044c \u2014 \u0438\u0434\u0435\u0430\u043b\u0435\u043d \u0434\u043b\u044f \u0441\u0442\u0440\u0438\u043c\u0438\u043d\u0433\u0430, JOIN \u0438 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u043e\u0432 \u0441 \u0442\u0430\u0439\u043c\u0430\u0443\u0442\u043e\u043c.<\/p>\n

«`go<\/p>\n

ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)<\/p>\n

defer cancel()<\/p>\n

var listErr error<\/p>\n

for i, user := range sqlh.ListRange[User](db, 0, «», «name ASC», 0,<\/p>\n

\u00a0 \u00a0 func(err error) { listErr = err },<\/p>\n

\u00a0 \u00a0 ctx,<\/p>\n

) {<\/p>\n

\u00a0 \u00a0 fmt.Printf(«%d: %s\\n», i, user.Name<\/a>)<\/p>\n

}<\/p>\n

«`<\/p>\n

### \u0422\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u044b\u0435 WHERE-\u0445\u0435\u043b\u043f\u0435\u0440\u044b<\/strong><\/p>\n

\u0412\u043c\u0435\u0441\u0442\u043e \u0440\u0443\u0447\u043d\u043e\u0433\u043e SQL \u0432 Where.Field<\/code> \u2014 \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0442\u043e\u0440\u044b \u0434\u043b\u044f \u0442\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u044b\u0445 \u0443\u0441\u043b\u043e\u0432\u0438\u0439:<\/p>\n

«`go<\/p>\n

sqlh.Eq(«name», «Alice») \u00a0 \u00a0 \u00a0 \u00a0 \/\/ name = ?<\/p>\n

sqlh.Ne<\/a>(«status», «deleted») \u00a0 \u00a0 \/\/ status <> ?<\/p>\n

sqlh.Gt<\/a>(«age», 18) \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \/\/ age > ?<\/p>\n

sqlh.Like<\/a>(«name», «%Alice%») \u00a0 \u00a0 \/\/ name LIKE ?<\/p>\n

sqlh.In<\/a>(«id», 1, 2, 3) \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \/\/ id IN (?, ?, ?)<\/p>\n

sqlh.IsNull(«deleted_at») \u00a0 \u00a0 \u00a0 \u00a0\/\/ deleted_at IS NULL<\/p>\n

«`<\/p>\n

\u0417\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u043f\u0435\u0440\u0435\u0434\u0430\u044e\u0442\u0441\u044f \u043a\u0430\u043a bind-\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b (\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e). \u041d\u0438\u0437\u043a\u043e\u0443\u0440\u043e\u0432\u043d\u0435\u0432\u044b\u0439 Where{Field, Value}<\/code> \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0434\u043b\u044f \u043a\u0430\u0441\u0442\u043e\u043c\u043d\u044b\u0445 \u043e\u043f\u0435\u0440\u0430\u0442\u043e\u0440\u043e\u0432.<\/p>\n

### JOIN: composite-\u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b<\/strong><\/p>\n

«`go<\/p>\n

type UserWithOrders struct {<\/p>\n

\u00a0 \u00a0 *UserTable \u00a0 \/\/ \u043e\u0441\u043d\u043e\u0432\u043d\u0430\u044f \u0442\u0430\u0431\u043b\u0438\u0446\u0430<\/p>\n

\u00a0 \u00a0 *OrderTable \u00a0\/\/ JOIN-\u0442\u0430\u0431\u043b\u0438\u0446\u0430<\/p>\n

}<\/p>\n

join := query.MakeJoin[OrderTable](query.Join{<\/p>\n

\u00a0 \u00a0 Join: \u00a0«LEFT», Alias: «o», On: «t.id<\/a> = o.user_id»,<\/p>\n

})<\/p>\n

for _, row := range sqlh.ListRange[UserWithOrders](db, 0, «», «t.name<\/a> ASC», 0,<\/p>\n

\u00a0 \u00a0 sqlh.SetAlias(«t»), join, func(err error) { log.Fatal(err) },<\/p>\n

) {<\/p>\n

\u00a0 \u00a0 if row.OrderTable != nil {<\/p>\n

\u00a0 \u00a0 \u00a0 \u00a0 fmt.Println(row.UserTable.Name<\/a>, row.OrderTable.Total<\/a>)<\/p>\n

\u00a0 \u00a0 }<\/p>\n

}<\/p>\n

«`<\/p>\n

## \u00a75. \u0411\u0435\u043d\u0447\u043c\u0430\u0440\u043a\u0438: \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0441\u0442\u044c \u0432 \u0446\u0438\u0444\u0440\u0430\u0445<\/strong><\/p>\n

\u041d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0431\u044b\u0441\u0442\u0440 sqlh \u043d\u0430 \u043f\u0440\u0430\u043a\u0442\u0438\u043a\u0435? \u0412 \u043c\u043e\u0434\u0443\u043b\u0435 bench\/<\/code> \u2014 \u0432\u043e\u0441\u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u043c\u044b\u0435 Go-\u0431\u0435\u043d\u0447\u043c\u0430\u0440\u043a\u0438 \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u044e\u0442 raw database\/sql<\/code>, sqlx<\/code>, GORM \u0438 sqlh \u043d\u0430 \u043e\u0434\u043d\u043e\u043c \u0438 \u0442\u043e\u043c \u0436\u0435 CRUD-\u0432\u043e\u0440\u043a\u043b\u043e\u0430\u0434\u0435. \u0412\u0441\u0435 \u0442\u0435\u0441\u0442\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442 in-memory SQLite \u2014 \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u0432\u043d\u0435\u0448\u043d\u0435\u0439 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438.<\/p>\n

\u0412\u043e\u0441\u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0441\u0442\u0438 \u043d\u0430 \u0441\u0432\u043e\u0435\u0439 \u043c\u0430\u0448\u0438\u043d\u0435:<\/p>\n

«`bash<\/p>\n

cd bench && go test -bench=. -benchmem -benchtime=1s<\/p>\n

«`<\/p>\n

### CRUD Throughput (ops\/sec)<\/strong><\/p>\n

| \u041e\u043f\u0435\u0440\u0430\u0446\u0438\u044f | raw sql | sqlx | GORM | sqlh<\/strong> |<\/p>\n

|———-|———|——|——|———-|<\/p>\n

| Insert<\/strong> | 158,041 | 131,596 | 34,971 | 87,085<\/strong> |<\/p>\n

| Get by PK<\/strong> | 169,232 | 152,415 | 78,666 | 68,675<\/strong> |<\/p>\n

| List all<\/strong> | 11,807 | 9,261 | 6,779 | 7,573<\/strong> |<\/p>\n

| List limit 10<\/strong> | 51,500 | 43,691 | 37,821 | 44,142<\/strong> |<\/p>\n

| Update<\/strong> | 228,728 | 180,505 | 65,933 | 85,543<\/strong> |<\/p>\n

| Delete<\/strong> | 172,128 | 166,279 | 41,162 | 60,650<\/strong> |<\/p>\n

### Memory Allocations (bytes\/op, allocs\/op)<\/strong><\/p>\n

| \u041e\u043f\u0435\u0440\u0430\u0446\u0438\u044f | raw sql | sqlx | GORM | sqlh<\/strong> |<\/p>\n

|———-|———|——|——|———-|<\/p>\n

| Insert<\/strong> | 328 B, 12 | 721 B, 20 | 5,534 B, 82 | 1,274 B, 39<\/strong> |<\/p>\n

| Get by PK<\/strong> | 792 B, 27 | 976 B, 31 | 3,952 B, 66 | 2,592 B, 78<\/strong> |<\/p>\n

| List all<\/strong> | 23,744 B, 528 | 26,376 B, 632 | 27,668 B, 946 | 26,391 B, 745<\/strong> |<\/p>\n

| List limit<\/strong> | 3,120 B, 76 | 3,624 B, 91 | 6,145 B, 141 | 3,958 B, 115<\/strong> |<\/p>\n

| Update<\/strong> | 296 B, 9 | 680 B, 19 | 5,079 B, 68 | 1,393 B, 43<\/strong> |<\/p>\n

| Delete<\/strong> | 216 B, 7 | 216 B, 7 | 5,484 B, 67 | 1,136 B, 37<\/strong> |<\/p>\n

### \u0427\u0442\u043e \u0433\u043e\u0432\u043e\u0440\u044f\u0442 \u0446\u0438\u0444\u0440\u044b<\/strong><\/p>\n

— GORM<\/strong> \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u043d\u0430\u0438\u0431\u043e\u043b\u044c\u0448\u0443\u044e latency \u0438 \u0441\u0430\u043c\u044b\u0439 \u0442\u044f\u0436\u0451\u043b\u044b\u0439 allocation footprint \u2014 \u0441\u043b\u0435\u0434\u0441\u0442\u0432\u0438\u0435 \u0431\u043e\u0433\u0430\u0442\u043e\u0433\u043e feature set \u0438 reflection-\u043e\u0432\u0435\u0440\u0445\u0435\u0434\u0430.<\/p>\n

— sqlh<\/strong> \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u043c\u0435\u0436\u0434\u0443 raw\/sqlx \u0438 GORM. \u0423\u043c\u0435\u0440\u0435\u043d\u043d\u044b\u0439 \u043e\u0432\u0435\u0440\u0445\u0435\u0434 \u2014 \u043f\u043b\u0430\u0442\u0430 \u0437\u0430 \u0430\u0432\u0442\u043e-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e SQL, \u043f\u0430\u0440\u0441\u0438\u043d\u0433 \u0442\u0435\u0433\u043e\u0432 \u0438 \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u0435 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 \u043d\u0430 \u0437\u0430\u043f\u0438\u0441\u044c.<\/p>\n

— sqlh \u0442\u043e\u0440\u0433\u0443\u0435\u0442 \u0441\u043a\u043e\u0440\u043e\u0441\u0442\u044c\u044e \u043d\u0430 \u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u043e\u0441\u0442\u044c<\/strong>: \u043a\u0430\u0436\u0434\u0430\u044f \u0437\u0430\u043f\u0438\u0441\u044c \u0430\u0442\u043e\u043c\u0430\u0440\u043d\u0430 (auto-transact \u0441 rollback), \u0447\u0442\u043e \u0443\u0441\u0442\u0440\u0430\u043d\u044f\u0435\u0442 \u0446\u0435\u043b\u044b\u0439 \u043a\u043b\u0430\u0441\u0441 \u0431\u0430\u0433\u043e\u0432 \u0446\u0435\u043d\u043e\u0439 \u043e\u0432\u0435\u0440\u0445\u0435\u0434\u0430 ~2\u20136x vs raw SQL \u0434\u043b\u044f \u043e\u0434\u043d\u043e\u0441\u0442\u0440\u043e\u0447\u043d\u044b\u0445 \u043c\u0443\u0442\u0430\u0446\u0438\u0439.<\/p>\n

— ListAll<\/strong> \u0434\u043e\u043c\u0438\u043d\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0441\u043a\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435\u043c 100 \u0441\u0442\u0440\u043e\u043a. \u0412\u0441\u0435 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u0437\u0434\u0435\u0441\u044c \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u044e\u0442 \u0441\u0445\u043e\u0436\u0443\u044e \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0441\u0442\u044c.<\/p>\n

> \u041e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u0435:<\/strong> Linux AMD Ryzen 9 3900, Go 1.26.3, SQLite in-memory.<\/p>\n

> \u0417\u0430\u043f\u0443\u0441\u0442\u0438\u0442\u0435 cd bench && go test -bench=. -benchmem -benchtime=1s<\/code> \u043d\u0430 \u0441\u0432\u043e\u0451\u043c \u0436\u0435\u043b\u0435\u0437\u0435 \u0434\u043b\u044f \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u044f.<\/p>\n

## \u00a76. \u041a\u043e\u0433\u0434\u0430 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c sqlh<\/strong><\/p>\n

sqlh \u2014 \u043d\u0435 \u0441\u0435\u0440\u0435\u0431\u0440\u044f\u043d\u0430\u044f \u043f\u0443\u043b\u044f. \u0412\u043e\u0442 \u0433\u0434\u0435 \u043e\u043d \u0441\u0438\u044f\u0435\u0442, \u0430 \u0433\u0434\u0435 \u043b\u0443\u0447\u0448\u0435 \u0447\u0442\u043e-\u0442\u043e \u0434\u0440\u0443\u0433\u043e\u0435:<\/p>\n

| \u0421\u0446\u0435\u043d\u0430\u0440\u0438\u0439 | \u0420\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0430\u0446\u0438\u044f |<\/p>\n

|———-|—————|<\/p>\n

| CLI-\u0443\u0442\u0438\u043b\u0438\u0442\u044b | \u2705 \u0418\u0434\u0435\u0430\u043b\u044c\u043d\u043e \u2014 \u043d\u043e\u043b\u044c \u0444\u0430\u0439\u043b\u043e\u0432 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0439, \u043e\u0434\u0438\u043d \u0431\u0438\u043d\u0430\u0440\u043d\u0438\u043a |<\/p>\n

| \u0421\u0442\u0430\u0440\u0442\u0430\u043f\u044b \u0438 MVP | \u2705 \u0411\u044b\u0441\u0442\u0440\u0435\u0435 \u043f\u0438\u0448\u0435\u0442\u0435, \u043f\u043e\u0442\u043e\u043c \u0440\u0435\u0444\u0430\u043a\u0442\u043e\u0440\u0438\u0442\u0435 |<\/p>\n

| \u041c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u044b \u0441 \u043f\u0440\u043e\u0441\u0442\u044b\u043c\u0438 \u0441\u0445\u0435\u043c\u0430\u043c\u0438 | \u2705 \u041d\u0438\u0437\u043a\u0438\u0439 \u043e\u0432\u0435\u0440\u0445\u0435\u0434, \u0442\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u044c |<\/p>\n

| High-throughput OLTP (>100K writes\/sec) | \u26a0\ufe0f \u0422\u0435\u0441\u0442\u0438\u0440\u0443\u0439\u0442\u0435 \u2014 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e, raw SQL |<\/p>\n

| \u0421\u043b\u043e\u0436\u043d\u0430\u044f \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 | \u26a0\ufe0f \u041f\u0440\u0435\u0434\u043f\u043e\u0447\u0442\u0438\u0442\u0435\u043b\u044c\u043d\u043e raw SQL \u0438\u043b\u0438 query builder |<\/p>\n

| \u0411\u043e\u043b\u044c\u0448\u0438\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0441 DBA | \u26a0\ufe0f GORM \u0438\u043b\u0438 sqlx \u043c\u043e\u0433\u0443\u0442 \u043f\u043e\u0434\u043e\u0439\u0442\u0438 \u043b\u0443\u0447\u0448\u0435 |<\/p>\n

| \u041e\u0431\u0443\u0447\u0435\u043d\u0438\u0435 Go + SQL | \u2705 \u041e\u0442\u043b\u0438\u0447\u043d\u044b\u0439 \u0443\u0447\u0435\u0431\u043d\u044b\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u2014 \u043d\u0438\u0437\u043a\u0430\u044f \u043a\u043e\u0433\u043d\u0438\u0442\u0438\u0432\u043d\u0430\u044f \u043d\u0430\u0433\u0440\u0443\u0437\u043a\u0430 |<\/p>\n

## \u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435<\/strong><\/p>\n

sqlh \u0430\u043a\u0442\u0438\u0432\u043d\u043e \u0440\u0430\u0437\u0432\u0438\u0432\u0430\u0435\u0442\u0441\u044f. \u041d\u0430 \u043c\u043e\u043c\u0435\u043d\u0442 v0.8.0 (\u0438\u044e\u043d\u044c 2026) \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442:<\/p>\n

— \u2705 \u041f\u043e\u043b\u043d\u044b\u0439 CRUD \u0441 \u0430\u0432\u0442\u043e-\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f\u043c\u0438<\/p>\n

— \u2705 \u041d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 UPSERT (PostgreSQL, SQLite, MySQL)<\/p>\n

— \u2705 JOIN-\u0437\u0430\u043f\u0440\u043e\u0441\u044b \u0441\u043e \u0441\u043a\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435\u043c \u0432 composite-\u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b<\/p>\n

— \u2705 Go 1.25 iterators (ListRange<\/code>) \u0434\u043b\u044f \u043b\u0435\u043d\u0438\u0432\u043e\u0433\u043e \u0441\u0442\u0440\u0438\u043c\u0438\u043d\u0433\u0430<\/p>\n

— \u2705 \u0422\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u044b\u0435 WHERE-\u0445\u0435\u043b\u043f\u0435\u0440\u044b (Eq<\/code>, Ne<\/code>, Gt<\/code>, Like<\/code>, In<\/code> \u0438 \u0434\u0440.)<\/p>\n

— \u2705 \u0420\u0435\u0442\u0440\u0430\u0439 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u043e\u043a \u0434\u043b\u044f SQLite<\/p>\n

— \u2705 \u041c\u0443\u043b\u044c\u0442\u0438-\u0411\u0414 (SQLite, MySQL, PostgreSQL)<\/p>\n

\u0412 \u043f\u043b\u0430\u043d\u0430\u0445: \u0430\u0433\u0440\u0435\u0433\u0430\u0442\u043d\u044b\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u0438 (SUM<\/code>, AVG<\/code>), \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438 \u0441\u0445\u0435\u043c\u044b, batch-\u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438. API \u0441\u0442\u0430\u0431\u0438\u043b\u0438\u0437\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043a v1.0.0.<\/p>\n

\u0415\u0441\u043b\u0438 \u0432\u044b \u0441\u0442\u0440\u043e\u0438\u0442\u0435 Go-\u043f\u0440\u043e\u0435\u043a\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043e\u0431\u0449\u0430\u0435\u0442\u0441\u044f \u0441 SQL, \u0438 \u0443\u0441\u0442\u0430\u043b\u0438 \u043f\u0438\u0441\u0430\u0442\u044c \u043e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 boilerplate \u0441\u043d\u043e\u0432\u0430 \u0438 \u0441\u043d\u043e\u0432\u0430 \u2014 \u0434\u0430\u0439\u0442\u0435 sqlh \u0448\u0430\u043d\u0441. \u041e\u043f\u0438\u0448\u0438\u0442\u0435 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443. \u042d\u0442\u043e \u0432\u0441\u0451.<\/p>\n

«`bash<\/p>\n

go get github.com\/kirill-scherba\/sqlh<\/p>\n

«`<\/p>\n

— \ud83d\udcd6 [README & Quick Start](https:\/\/github.com\/kirill-scherba\/sqlh<\/a>)<\/p>\n

— \ud83d\udce6 [pkg.go.dev<\/a> reference](https:\/\/pkg.go.dev\/github.com\/kirill-scherba\/sqlh<\/a>)<\/p>\n

— \ud83c\udfd7\ufe0f [\u0418\u0441\u0445\u043e\u0434\u043d\u044b\u0439 \u043a\u043e\u0434](https:\/\/github.com\/kirill-scherba\/sqlh<\/a>)<\/p>\n

— \u2b50 [Awesome Go PR](https:\/\/github.com\/avelino\/awesome-go\/pull\/6401<\/a>)<\/p>\n

—<\/p>\n

\u0410\u0432\u0442\u043e\u0440: [Kirill Scherba](<\/em>https:\/\/github.com\/kirill-scherba<\/em><\/a>). sqlh \u2014 open source \u043f\u043e\u0434 BSD-\u043b\u0438\u0446\u0435\u043d\u0437\u0438\u0435\u0439. Contributions welcome.<\/em><\/p>\n<\/div>\n

\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 https:\/\/habr.com\/ru\/articles\/1046836\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

> Zero-boilerplate SQL \u0434\u043b\u044f Go. \u041e\u043f\u0438\u0448\u0438 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443 \u0442\u0435\u0433\u0430\u043c\u0438 \u2014 \u0438 \u044d\u0442\u043e \u0432\u0441\u0451.\u0415\u0441\u043b\u0438 \u0432\u044b \u043f\u0438\u0448\u0435\u0442\u0435 \u043d\u0430 Go \u0438 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442\u0435 \u0441 SQL-\u0431\u0430\u0437\u0430\u043c\u0438, \u0432\u044b \u0437\u043d\u0430\u0435\u0442\u0435 \u044d\u0442\u0443 \u0431\u043e\u043b\u044c. \u041a\u0430\u0436\u0434\u044b\u0439 CRUD-\u0437\u0430\u043f\u0440\u043e\u0441 \u2014 \u0440\u0443\u0447\u043d\u043e\u0439 SQL-\u0441\u0442\u0440\u043e\u043a\u0430, rows.Scan \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u043e\u043b\u044f, Begin\/Commit\/Rollback \u0432\u043e\u043a\u0440\u0443\u0433 \u0437\u0430\u043f\u0438\u0441\u0438, \u0438 \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u0430\u044f \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0430\u0446\u0438\u044f DDL-\u0441\u0445\u0435\u043c\u044b \u0441 \u043a\u043e\u0434\u043e\u043c. \u0428\u0430\u0431\u043b\u043e\u043d\u043d\u044b\u0439 \u043a\u043e\u0434 \u043d\u0435 \u0437\u0430\u043a\u0430\u043d\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u043d\u0438\u043a\u043e\u0433\u0434\u0430.\u042d\u0442\u043e \u0440\u0430\u0441\u0441\u043a\u0430\u0437 \u043e sqlh \u2014 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0435, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0443\u0431\u0438\u0440\u0430\u0435\u0442 \u0432\u0441\u0451 \u044d\u0442\u043e, \u043e\u0441\u0442\u0430\u0432\u0430\u044f\u0441\u044c \u0432 \u00ab\u0437\u043e\u043b\u043e\u0442\u043e\u0439 \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0435\u00bb \u043c\u0435\u0436\u0434\u0443 raw SQL (\u0441\u043b\u0438\u0448\u043a\u043e\u043c \u043c\u043d\u043e\u0433\u043e \u0440\u0430\u0431\u043e\u0442\u044b) \u0438 \u0442\u044f\u0436\u0451\u043b\u044b\u043c\u0438 ORM (\u0441\u043b\u0438\u0448\u043a\u043e\u043c \u043c\u043d\u043e\u0433\u043e \u043c\u0430\u0433\u0438\u0438).## \u00a71. \u041f\u0440\u043e\u0431\u043b\u0435\u043c\u0430: Go + SQL = \u0441\u043c\u0435\u0440\u0442\u044c \u043e\u0442 \u0442\u044b\u0441\u044f\u0447\u0438 rows.Scan\u0421\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0439 database\/sql \u0432 Go \u043e\u0442\u043b\u0438\u0447\u0435\u043d. \u041e\u043d \u0434\u0430\u0451\u0442 \u043f\u0440\u043e\u0447\u043d\u044b\u0439, \u043f\u0435\u0440\u0435\u043d\u043e\u0441\u0438\u043c\u044b\u0439 \u0444\u0443\u043d\u0434\u0430\u043c\u0435\u043d\u0442 \u0434\u043b\u044f \u043b\u044e\u0431\u043e\u0439 SQL-\u0431\u0430\u0437\u044b. \u041d\u043e \u043e\u043d \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u043d\u043e \u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0442\u044f\u0436\u0451\u043b\u0443\u044e \u0440\u0430\u0431\u043e\u0442\u0443 \u0437\u0430 \u0432\u0430\u043c\u0438.\u0412\u043e\u0442 \u043a\u0430\u043a \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043f\u0440\u043e\u0441\u0442\u043e\u0439 CRUD \u043d\u0430 \u0447\u0438\u0441\u0442\u043e\u043c database\/sql:«`go\/\/ 1. CREATE TABLE \u2014 raw DDL-\u0441\u0442\u0440\u043e\u043a\u0430_, err := db.Exec(`CREATE TABLE IF NOT EXISTS user (\u00a0 \u00a0 id INTEGER PRIMARY KEY AUTOINCREMENT,\u00a0 \u00a0 name TEXT UNIQUE,\u00a0 \u00a0 email TEXT,\u00a0 \u00a0 age INTEGER)`)\/\/ 2. INSERT \u2014 \u044f\u0432\u043d\u044b\u0435 placeholder \u0438 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b_, err = db.Exec(\u00a0 \u00a0 «INSERT INTO user (name, email, age) VALUES (?, ?, ?)»,\u00a0 \u00a0 «Alice», «alice@example.com», 30,)\/\/ 3. GET \u043f\u043e ID \u2014 QueryRow + \u0440\u0443\u0447\u043d\u043e\u0439 Scanvar u Usererr = db.QueryRow(«SELECT id, name, email, age FROM user WHERE id = ?», 1).\u00a0 \u00a0 Scan(&u.ID, &u.Name, &u.Email, &u.Age)\/\/ 4. LIST \u0432\u0441\u0435\u0445 \u2014 Query + rows.Next + rows.Scan \u0432 \u0446\u0438\u043a\u043b\u0435rows, err := db.Query(«SELECT id, name, email, age FROM user ORDER BY name ASC»)var users []Userfor rows.Next() {\u00a0 \u00a0 var u User\u00a0 \u00a0 if err := rows.Scan(&u.ID, &u.Name, &u.Email, &u.Age); err != nil {\u00a0 \u00a0 \u00a0 \u00a0 log.Fatal(err)\u00a0 \u00a0 }\u00a0 \u00a0 users = append(users, u)}rows.Close()\/\/ 5. UPDATE \u2014 raw SQL \u0441 placeholder_, err = db.Exec(\u00a0 \u00a0 «UPDATE user SET email = ?, age = ? WHERE id = ?»,\u00a0 \u00a0 «alice.new@example.com», 31, 1,)\/\/ 6. DELETE \u2014 raw SQL_, err = db.Exec(«DELETE FROM user WHERE id = ?», 1)«`\u042d\u0442\u043e ~115 \u0441\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430 \u0434\u043b\u044f \u0448\u0435\u0441\u0442\u0438 \u0431\u0430\u0437\u043e\u0432\u044b\u0445 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439. \u0418 \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437, \u043a\u043e\u0433\u0434\u0430 \u0432\u044b \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0435 \u0441\u0442\u043e\u043b\u0431\u0435\u0446, \u043d\u0443\u0436\u043d\u043e \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u044c \u0441\u0442\u0440\u043e\u043a\u0443 CREATE TABLE, \u0441\u043f\u0438\u0441\u043e\u043a \u043a\u043e\u043b\u043e\u043d\u043e\u043a \u0432 INSERT, \u0441\u043f\u0438\u0441\u043e\u043a \u0432 SELECT, \u0438 \u0432\u044b\u0437\u043e\u0432 rows.Scan. \u041e\u043f\u0435\u0447\u0430\u0442\u043a\u0430 \u0432 \u043b\u044e\u0431\u043e\u043c \u043c\u0435\u0441\u0442\u0435 \u2014 runtime-\u043e\u0448\u0438\u0431\u043a\u0430, compile-time \u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u0438 \u043d\u0435\u0442.| \u0411\u043e\u043b\u044c | \u041f\u043e\u0447\u0435\u043c\u0443 \u0431\u043e\u043b\u044c\u043d\u043e ||——|—————|| \u0420\u0443\u0447\u043d\u043e\u0439 SQL | \u041a\u0430\u0436\u0434\u044b\u0439 CRUD \u2014 raw SQL-\u0441\u0442\u0440\u043e\u043a\u0430, \u043d\u0435\u0442 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043d\u0430 \u044d\u0442\u0430\u043f\u0435 \u043a\u043e\u043c\u043f\u0438\u043b\u044f\u0446\u0438\u0438 || rows.Scan | 4\u20135 \u0441\u0442\u0440\u043e\u043a \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u043c\u0430\u043f\u043f\u0438\u043d\u0433\u0430 \u043a\u043e\u043b\u043e\u043d\u043e\u043a \u043d\u0430 \u043f\u043e\u043b\u044f || \u0422\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 | db.Begin() + defer tx.Rollback() + tx.Commit() \u2014 \u0432\u0435\u0437\u0434\u0435 || \u041d\u0435\u0442 \u0441\u0432\u044f\u0437\u0438 \u0441\u043e \u0441\u0445\u0435\u043c\u043e\u0439 | DDL \u0432 \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u044f\u0445, \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b \u0432 Go \u2014 \u043e\u043d\u0438 \u0440\u0430\u0441\u0445\u043e\u0434\u044f\u0442\u0441\u044f || \u041f\u043e\u0440\u044f\u0434\u043e\u043a \u043a\u043e\u043b\u043e\u043d\u043e\u043a | \u041d\u043e\u0432\u044b\u0439 \u0441\u0442\u043e\u043b\u0431\u0435\u0446 \u2192 \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c SQL-\u0441\u0442\u0440\u043e\u043a\u0438 \u0438 Scan-\u0432\u044b\u0437\u043e\u0432\u044b |## \u00a72. \u0421\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u044f: sqlx \u0438 GORM\u0412 \u044d\u043a\u043e\u0441\u0438\u0441\u0442\u0435\u043c\u0435 Go \u0435\u0441\u0442\u044c \u0434\u0432\u0430 \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0445 \u043f\u0443\u0442\u0438. \u0423 \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u0441\u0432\u043e\u0438 \u043a\u043e\u043c\u043f\u0440\u043e\u043c\u0438\u0441\u0441\u044b.### sqlx: \u043b\u0443\u0447\u0448\u0435, \u043d\u043e \u0432\u0441\u0451 \u0435\u0449\u0451 \u0440\u0443\u0447\u043d\u043e\u0439 SQL[sqlx](https:\/\/github.com\/jmoiron\/sqlx) \u2014 \u043f\u043e\u043f\u0443\u043b\u044f\u0440\u043d\u043e\u0435 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435 database\/sql. \u041e\u043d \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 StructScan, Get, Select, \u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b. SQL \u043f\u0438\u0448\u0435\u0442\u0435 \u043f\u043e-\u043f\u0440\u0435\u0436\u043d\u0435\u043c\u0443 \u0440\u0443\u043a\u0430\u043c\u0438, \u043d\u043e rows.Scan \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d.«`go\/\/ sqlx: \u0432\u0441\u0451 \u0435\u0449\u0451 \u0440\u0443\u0447\u043d\u043e\u0439 SQL, \u043d\u043e StructScan \u0443\u0431\u0438\u0440\u0430\u0435\u0442 Scanvar u Userdbx.Get(&u, «SELECT id, name, email, age FROM user WHERE id = ?», 1)«`sqlx \u0441\u044d\u043a\u043e\u043d\u043e\u043c\u0438\u0442 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e 30% boilerplate (\u0434\u043e ~80 \u0441\u0442\u0440\u043e\u043a). \u041d\u043e CREATE TABLE, INSERT, SELECT, UPDATE, DELETE \u2014 \u0432\u0441\u0451 \u0435\u0449\u0451 \u043f\u0438\u0448\u0435\u0442\u0435 \u0432\u0440\u0443\u0447\u043d\u0443\u044e. \u0413\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f SQL \u2014 \u043d\u0435 \u0435\u0433\u043e \u0437\u0430\u0434\u0430\u0447\u0430.### GORM: \u043f\u043e\u043b\u043d\u044b\u0439 ORM, \u043f\u043e\u043b\u043d\u0430\u044f \u043c\u0430\u0433\u0438\u044f[GORM](https:\/\/gorm.io\/) \u2014 \u0442\u044f\u0436\u0435\u043b\u043e\u0432\u0435\u0441. \u0413\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 \u0432\u0441\u0451 \u2014 \u0441\u0445\u0435\u043c\u0443, \u0437\u0430\u043f\u0440\u043e\u0441\u044b, \u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438 \u2014 \u0438 \u0434\u0430\u0451\u0442 \u0431\u043e\u0433\u0430\u0442\u044b\u0439 chainable API. \u041d\u043e \u0446\u0435\u043d\u0430 \u0432\u044b\u0441\u043e\u043a\u0430:- \u0422\u044f\u0436\u0451\u043b\u044b\u0439 reflection \u0432 runtime- \u041a\u0440\u0443\u0442\u0430\u044f \u043a\u0440\u0438\u0432\u0430\u044f \u043e\u0431\u0443\u0447\u0435\u043d\u0438\u044f \u2014 \u0442\u0435\u0433\u0438, \u0445\u0443\u043a\u0438, scopes, \u0430\u0441\u0441\u043e\u0446\u0438\u0430\u0446\u0438\u0438- ~4 MB \u0443\u0432\u0435\u043b\u0438\u0447\u0435\u043d\u0438\u0435 \u0431\u0438\u043d\u0430\u0440\u043d\u0438\u043a\u0430 \u0442\u043e\u043b\u044c\u043a\u043e \u0437\u0430 ORM- \u041c\u0430\u0433\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0441\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0441\u043b\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u2014 \u043f\u043e\u043a\u0430 \u043d\u0435 \u0441\u043b\u043e\u043c\u0430\u0435\u0442\u0441\u044f, \u0438 \u0432\u044b \u0447\u0430\u0441\u0430\u043c\u0438 \u0434\u0435\u0431\u0430\u0436\u0438\u0442\u0435\u0414\u043b\u044f \u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u043a\u043e\u043c\u0430\u043d\u0434 \u0441 \u0432\u044b\u0434\u0435\u043b\u0435\u043d\u043d\u044b\u043c\u0438 DBA \u0438 \u0441\u043b\u043e\u0436\u043d\u044b\u043c\u0438 \u043c\u043e\u0434\u0435\u043b\u044f\u043c\u0438 GORM \u2014 solid choice. \u0414\u043b\u044f CLI-\u0443\u0442\u0438\u043b\u0438\u0442, \u0441\u0442\u0430\u0440\u0442\u0430\u043f\u043e\u0432 \u0438 \u043c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u2014 overkill.### sqlh: \u0437\u043e\u043b\u043e\u0442\u0430\u044f \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0430| \u0424\u0438\u0447\u0430 | database\/sql | sqlx | GORM | sqlh ||—|—|—|—|—|| SQL-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f | \u274c \u0420\u0443\u0447\u043d\u0430\u044f | \u274c \u0420\u0443\u0447\u043d\u0430\u044f | \u2705 \u041f\u043e\u043b\u043d\u0430\u044f | \u2705 \u041f\u043e\u043b\u043d\u0430\u044f || rows.Scan | \u2705 \u041d\u0443\u0436\u0435\u043d | \u274c StructScan | \u274c \u0410\u0432\u0442\u043e | \u274c \u0410\u0432\u0442\u043e || \u0422\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u044c (generics) | \u274c | \u274c | \u274c | \u2705 || \u0410\u0432\u0442\u043e-\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 | \u274c | \u274c | \u2705 | \u2705 || \u0420\u0435\u0442\u0440\u0430\u0439 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u043e\u043a | \u274c | \u274c | \u274c | \u2705 || \u041a\u0440\u0438\u0432\u0430\u044f \u043e\u0431\u0443\u0447\u0435\u043d\u0438\u044f | \u0421\u0440\u0435\u0434\u043d\u044f\u044f | \u0421\u0440\u0435\u0434\u043d\u044f\u044f | \u0412\u044b\u0441\u043e\u043a\u0430\u044f | \u041d\u0438\u0437\u043a\u0430\u044f || \u041e\u0432\u0435\u0440\u0445\u0435\u0434 \u0431\u0438\u043d\u0430\u0440\u043d\u0438\u043a\u0430 | 0 | ~200 KB | ~4 MB | ~200 KB |sqlh \u0436\u0438\u0432\u0451\u0442 \u043c\u0435\u0436\u0434\u0443 sqlx \u0438 GORM:- Zero-boilerplate CRUD \u2014 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u044b\u0435 \u0442\u0435\u0433\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u044e\u0442 \u0432\u0435\u0441\u044c SQL- \u0422\u0438\u043f\u043e\u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u044c \u0447\u0435\u0440\u0435\u0437 Go generics \u2014 Get[User]() \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 *User, \u043d\u0435 interface{}- \u041d\u0438\u043a\u0430\u043a\u043e\u0439 \u043c\u0430\u0433\u0438\u0438 \u2014 \u0447\u0442\u043e \u0432\u0438\u0434\u0438\u0442\u0435 \u0432 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0435, \u0442\u043e \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 \u0432 \u0431\u0430\u0437\u0435- \u041b\u0451\u0433\u043a\u0438\u0439 \u2014 \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 reflection, \u043a\u0435\u0448 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0445, \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u0441\u043a\u0440\u044b\u0442\u043e\u0439 \u0441\u043b\u043e\u0436\u043d\u043e\u0441\u0442\u0438## \u00a73. \u041a\u0430\u043a sqlh \u0440\u0435\u0448\u0430\u0435\u0442 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0443: \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u044b\u0435 \u0442\u0435\u0433\u0438 \u043a\u0430\u043a \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043f\u0440\u0430\u0432\u0434\u044b\u0418\u0434\u0435\u044f \u043f\u0440\u043e\u0441\u0442\u0430: \u0432\u0430\u0448\u0430 Go-\u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u2014 \u044d\u0442\u043e \u0432\u0430\u0448\u0430 \u0441\u0445\u0435\u043c\u0430.«`gotype User struct {\u00a0 \u00a0 ID \u00a0 \u00a0int64 \u00a0db:»id» db_key:»not null primary key autoincrement»\u00a0 \u00a0 Name \u00a0string db:»name» db_key:»unique»\u00a0 \u00a0 Email string db:»email»\u00a0 \u00a0 Age \u00a0 int \u00a0 \u00a0db:»age»}«`\u0422\u0440\u0438 \u0442\u0435\u0433\u0430 \u0443\u043f\u0440\u0430\u0432\u043b\u044f\u044e\u0442 \u0432\u0441\u0435\u043c:| \u0422\u0435\u0433 | \u041d\u0430\u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 | \u041f\u0440\u0438\u043c\u0435\u0440 ||——|————|———|| db | \u0418\u043c\u044f \u043a\u043e\u043b\u043e\u043d\u043a\u0438 | db:»user_name» || db_key | \u041e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u044f, \u0438\u043d\u0434\u0435\u043a\u0441\u044b | db_key:»primary key autoincrement» || db_type | \u041f\u0435\u0440\u0435\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u0442\u0438\u043f\u0430 SQL | db_type:»TEXT» |\u0418\u0437 \u044d\u0442\u043e\u0433\u043e \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0433\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f sqlh \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442:- CREATE TABLE \u2014 sqlh.Create[User](db) \u2192 CREATE TABLE IF NOT EXISTS user (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT UNIQUE, email TEXT, age INTEGER)- INSERT \u2014 sqlh.Insert(db, User{Name: «Alice»}) \u2192 INSERT INTO user (name, email, age) VALUES (?, ?, ?)- SELECT \u2014 sqlh.Get[User](db, …) \u2192 SELECT id, name, email, age FROM user WHERE … LIMIT 2- UPDATE \u2014 sqlh.Update(db, …) \u2192 UPDATE user SET name=?, email=?, age=? WHERE …- DELETE \u2014 sqlh.Delete[User](db, …) \u2192 DELETE FROM user WHERE …### \u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430«`\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\u2502 \u00a0sqlh package \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2502\u2502 \u00a0Insert, Get, List, Update, Delete, Set, \u00a0 \u00a0\u2502\u2502 \u00a0Create \u2014 \u0441 \u0430\u0432\u0442\u043e-\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u044f\u043c\u0438 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2502\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\u2502 \u00a0query package \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2502\u2502 \u00a0SQL-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f, \u043a\u0435\u0448 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0445, JOIN \u00a0 \u00a0 \u00a0 \u00a0\u2502\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\u2502 \u00a0database\/sql (stdlib) \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2502\u2502 \u00a0\u041f\u0443\u043b \u0441\u043e\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u0439, \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435 raw-\u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u00a0 \u00a0\u2502\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518«`### \u041a\u043b\u044e\u0447\u0435\u0432\u044b\u0435 \u0434\u0438\u0437\u0430\u0439\u043d-\u0440\u0435\u0448\u0435\u043d\u0438\u044f1. Generics-first (Go 1.25+) \u2014 Get[User]() \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 *User \u0441 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u043e\u0439 \u0442\u0438\u043f\u043e\u0432 \u043d\u0430 \u044d\u0442\u0430\u043f\u0435 \u043a\u043e\u043c\u043f\u0438\u043b\u044f\u0446\u0438\u0438. \u041d\u0438\u043a\u0430\u043a\u0438\u0445 interface{}, \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u0438\u0439 \u0442\u0438\u043f\u043e\u0432.2. \u0420\u0435\u0444\u043b\u0435\u043a\u0441\u0438\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u2014 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b \u043f\u0430\u0440\u0441\u044f\u0442\u0441\u044f \u0438 \u043a\u0435\u0448\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u0432 sync.Map \u043f\u043e reflect.Type. \u041f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0435 \u0432\u044b\u0437\u043e\u0432\u044b \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442 \u0438\u043c\u0435\u043d\u0430 \u0442\u0430\u0431\u043b\u0438\u0446, \u0441\u043f\u0438\u0441\u043a\u0438 \u043f\u043e\u043b\u0435\u0439, scan-\u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435.3. \u0410\u0432\u0442\u043e-\u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 \u043d\u0430 \u0437\u0430\u043f\u0438\u0441\u044c \u2014 \u043a\u0430\u0436\u0434\u044b\u0439 Insert, Update, Delete, Set \u043e\u0431\u0451\u0440\u043d\u0443\u0442 \u0432 BEGIN…COMMIT \u0441 ROLLBACK \u043f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0435. \u0422\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438 \u043d\u0438\u043a\u043e\u0433\u0434\u0430 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u0435\u0442\u0435.4. \u0420\u0435\u0442\u0440\u0430\u0439 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u043e\u043a SQLite \u2014 \u043e\u0448\u0438\u0431\u043a\u0438 \u00abdatabase is locked\u00bb \u0440\u0435\u0442\u0440\u0430\u044f\u0442\u0441\u044f \u0434\u043e 20 \u0440\u0430\u0437 \u0441 backoff 100 ms. Production-\u0443\u0441\u0442\u043e\u0439\u0447\u0438\u0432\u043e\u0441\u0442\u044c \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438.5. \u041c\u0443\u043b\u044c\u0442\u0438-\u0411\u0414 \u2014 SQLite (\u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439), MySQL, PostgreSQL (\u043e\u0431\u0430 \u0432 CI), SQL Server (\u044d\u043a\u0441\u043f\u0435\u0440\u0438\u043c\u0435\u043d\u0442\u0430\u043b\u044c\u043d\u043e).## \u00a74. CRUD \u0437\u0430 50 \u0441\u0442\u0440\u043e\u043a: \u0431\u044b\u0441\u0442\u0440\u044b\u0439 \u0441\u0442\u0430\u0440\u0442\u0422\u043e\u0442 \u0436\u0435 CRUD, \u0447\u0442\u043e \u0432 \u043d\u0430\u0447\u0430\u043b\u0435 \u2014 \u043d\u043e ~57% \u043a\u043e\u0440\u043e\u0447\u0435:«`gopackage mainimport (\u00a0 \u00a0 «database\/sql»\u00a0 \u00a0 «fmt»\u00a0 \u00a0 «github.com\/kirill-scherba\/sqlh»\u00a0 \u00a0 _ «github.com\/mattn\/go-sqlite3″)type User struct {\u00a0 \u00a0 ID \u00a0 \u00a0int64 \u00a0db:»id» db_key:»not null primary key autoincrement»\u00a0 \u00a0 Name \u00a0string db:»name» db_key:»unique»\u00a0 \u00a0 Email string db:»email»\u00a0 \u00a0 Age \u00a0 int \u00a0 \u00a0db:»age»}func main() {\u00a0 \u00a0 db, _ := sql.Open(«sqlite3», «file::memory:?cache=shared»)\u00a0 \u00a0 defer db.Close()\u00a0 \u00a0 \/\/ 1. CREATE TABLE \u0438\u0437 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b\u00a0 \u00a0 sqlh.Create[User](db)\u00a0 \u00a0 \/\/ 2. INSERT\u00a0 \u00a0 sqlh.Insert(db, User{Name: «Alice», Email: «alice@example.com», Age: 30})\u00a0 \u00a0 bobID, _ := sqlh.InsertId(db, User{Name: «Bob», Email: «bob@example.com», Age: 25})\u00a0 \u00a0 \/\/ 3. GET \u043f\u043e ID \u2014 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 *User, \u043d\u0435 interface{}\u00a0 \u00a0 u, _ := sqlh.Get[User](db, sqlh.Eq(«id», bobID))\u00a0 \u00a0 fmt.Println(u.Name) \/\/ «Bob»\u00a0 \u00a0 \/\/ 4. LIST \u0432\u0441\u0435\u0445 \u2014 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 []User + next offset\u00a0 \u00a0 users, , := sqlh.List[User](db, 0, «», «name ASC»)\u00a0 \u00a0 fmt.Println(len(users)) \/\/ 2\u00a0 \u00a0 \/\/ 5. UPDATE \u2014 \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u043c \u043f\u043e\u043b\u043d\u0443\u044e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443, \u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u0437\u0430\u043d\u0443\u043b\u0438\u0442\u044c \u0434\u0440\u0443\u0433\u0438\u0435 \u043a\u043e\u043b\u043e\u043d\u043a\u0438\u00a0 \u00a0 sqlh.Update(db, sqlh.UpdateAttr[User]{\u00a0 \u00a0 \u00a0 \u00a0 Row: \u00a0 \u00a0User{Name: «Alice», Email: «alice.new@example.com», Age: 31},\u00a0 \u00a0 \u00a0 \u00a0 Wheres: []sqlh.Where{sqlh.Eq(«id», 1)},\u00a0 \u00a0 })\u00a0 \u00a0 \/\/ 6. DELETE\u00a0 \u00a0 sqlh.Delete[User](db, sqlh.Eq(«id», bobID))}«`~50 \u0441\u0442\u0440\u043e\u043a. \u041d\u0438\u043a\u0430\u043a\u043e\u0433\u043e raw SQL. \u041d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e rows.Scan. \u041d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e BEGIN\/COMMIT. \u041d\u0438 \u043e\u0434\u043d\u043e\u0439 \u043e\u0448\u0438\u0431\u043a\u0438 \u0432 \u043f\u043e\u0440\u044f\u0434\u043a\u0435 \u043a\u043e\u043b\u043e\u043d\u043e\u043a.### \u0421\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u0435 \u0431\u043e\u043a-\u043e-\u0431\u043e\u043a| \u041e\u043f\u0435\u0440\u0430\u0446\u0438\u044f | Raw database\/sql | sqlx | sqlh ||———-|——————|——|———-|| CREATE TABLE | Raw SQL-\u0441\u0442\u0440\u043e\u043a\u0430 | Raw SQL-\u0441\u0442\u0440\u043e\u043a\u0430 | sqlh.Create[User](db) || INSERT | Exec(?,?,?) | NamedExec | Insert(T) || GET | QueryRow + Scan | Get(&T) | Get[T](where) || LIST | rows.Next + Scan | Select | List[T](…) || UPDATE | Exec(?,?,?,?) | NamedExec | Update(attr) || DELETE | Exec(?) | Exec(?) | Delete[T](where) || COUNT | QueryRow + Scan | Get(&int) | Count[T]() || | \u0421\u0442\u0440\u043e\u043a \u043a\u043e\u0434\u0430 | \u0421\u043e\u043a\u0440\u0430\u0449\u0435\u043d\u0438\u0435 ||—|—|—|| Raw database\/sql | ~115 | baseline || sqlx | ~80 | \u221230% || sqlh | ~50 | \u221257% |### Table[T]: \u0443\u0434\u043e\u0431\u043d\u044b\u0439 method-based API\u0414\u043b\u044f \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u043e\u0432, \u0433\u0434\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439 \u043d\u0430\u0434 \u043e\u0434\u043d\u043e\u0439 \u0442\u0430\u0431\u043b\u0438\u0446\u0435\u0439 \u2014 \u043c\u043e\u0436\u043d\u043e \u043e\u0431\u0435\u0440\u043d\u0443\u0442\u044c \u0432 Table[T]:«`gotbl, _ := sqlh.CreateTable[User](db)tbl.Insert(User{Name: «Charlie», Email: «charlie@example.com», Age: 28})c, _ := tbl.Get(sqlh.Eq(«name», «Charlie»))fmt.Println(c.Name)for _, user := range tbl.List(0, «», «name ASC», 0) {\u00a0 \u00a0 fmt.Println(user.Name)}«`Table[T] \u2014 \u043b\u0451\u0433\u043a\u0438\u0439 wrapper \u043d\u0430\u0434 \u043e\u0431\u0449\u0438\u043c *sql.DB. \u041e\u043d \u043d\u0435 \u0432\u043b\u0430\u0434\u0435\u0435\u0442 \u0441\u043e\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u0435\u043c, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 Close() \u2014 no-op (\u0434\u043b\u044f \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u0438). \u0420\u0435\u0441\u0443\u0440\u0441\u044b \u043e\u0447\u0438\u0449\u0430\u0435\u0442 \u0432\u044b\u0437\u044b\u0432\u0430\u044e\u0449\u0438\u0439 \u0447\u0435\u0440\u0435\u0437 db.Close().### Set (upsert): \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 UPSERTSet \u2014 \u0430\u0442\u043e\u043c\u0430\u0440\u043d\u044b\u0439 upsert. \u0414\u043b\u044f PostgreSQL, SQLite \u0438 MySQL \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u0441\u0438\u043d\u0442\u0430\u043a\u0441\u0438\u0441 \u0431\u0430\u0437\u044b:- PostgreSQL: INSERT … ON CONFLICT (…) DO UPDATE SET …- SQLite: INSERT … ON CONFLICT (…) DO UPDATE SET …- MySQL: INSERT … ON DUPLICATE KEY UPDATE …\u0414\u043b\u044f \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0445 \u0434\u0440\u0430\u0439\u0432\u0435\u0440\u043e\u0432 \u2014 fallback \u043d\u0430 SELECT-then-INSERT\/UPDATE \u0432 \u0442\u0440\u0430\u043d\u0437\u0430\u043a\u0446\u0438\u0438.«`go\/\/ name \u043f\u043e\u043c\u0435\u0447\u0435\u043d db_key:»unique» \u2014 Set \u0441\u0434\u0435\u043b\u0430\u0435\u0442 UPDATE \u043f\u0440\u0438 \u0441\u043e\u0432\u043f\u0430\u0434\u0435\u043d\u0438\u0438err := sqlh.Set(db, User{Name: «Dave», Email: «dave@example.com»}, sqlh.Eq(«name», «Dave»))«`### ListRange: Go 1.25 iterators\u0412\u043c\u0435\u0441\u0442\u043e List \u0441 \u0441\u043b\u0430\u0439\u0441\u043e\u043c \u2014 \u043b\u0435\u043d\u0438\u0432\u044b\u0439 \u0438\u0442\u0435\u0440\u0430\u0442\u043e\u0440 ListRange, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 …<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-483420","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/483420","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=483420"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/483420\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=483420"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=483420"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=483420"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}