- 投稿日：2020-08-14T18:37:30+09:00
GoでOSの環境変数を利用する
os.Getenv("INSTANCE_ID")のように書くimport "os" func getInstanceID() string{ var instanceId = os.Getenv("INSTANCE_ID") return instanceId }
- 投稿日：2020-08-14T12:46:32+09:00
GORM公式ドキュメントのメモ・その2「CRUDについて(Query)」
はじめに
GORM公式ドキュメントを読んだ際、頭に残すために書き写したものです。
ほとんど公式通りですが、パッと見で理解しづらかった言い回しなどを書き直しています。
この記事ではGORM公式ドキュメントのメモ・その１「モデル、CRUDについて」に書ききれなかったCRUDのQuery部分について。
のメモを載せています。Query
// 主キーでソートし、最初のレコードを取得する db.First(&user) //// SELECT * FROM users ORDER BY id LIMIT 1; // ソートせずにレコードを1行取得する db.Take(&user) //// SELECT * FROM users LIMIT 1; // 主キーでソートし、最後のレコードを取得する db.Last(&user) //// SELECT * FROM users ORDER BY id DESC LIMIT 1; // 全てのレコードを取得する db.Find(&users) //// SELECT * FROM users; // 主キーを指定してレコードを取得する（主キーがinteger型の場合のみ使用可能） db.First(&user, 10) //// SELECT * FROM users WHERE id = 10;where
// Get first matched record db.Where("name = ?", "jinzhu").First(&user) //// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1; // Get all matched records db.Where("name = ?", "jinzhu").Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu'; // <> db.Where("name <> ?", "jinzhu").Find(&users) //// SELECT * FROM users WHERE name <> 'jinzhu'; // IN db.Where("name IN (?)", []string{"jinzhu", "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name in ('jinzhu','jinzhu 2'); // LIKE db.Where("name LIKE ?", "%jin%").Find(&users) //// SELECT * FROM users WHERE name LIKE '%jin%'; // AND db.Where("name = ? AND age >= ?", "jinzhu", "22").Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu' AND age >= 22; // Time db.Where("updated_at > ?", lastWeek).Find(&users) //// SELECT * FROM users WHERE updated_at > '2000-01-01 00:00:00'; // BETWEEN db.Where("created_at BETWEEN ? AND ?", lastWeek, today).Find(&users) //// SELECT * FROM users WHERE created_at BETWEEN '2000-01-01 00:00:00' AND '2000-01-08 00:00:00';構造体 & マップを使用する
// Struct db.Where(&User{Name: "jinzhu", Age: 20}).First(&user) //// SELECT * FROM users WHERE name = "jinzhu" AND age = 20 ORDER BY id LIMIT 1; // Map db.Where(map[string]interface{}{"name": "jinzhu", "age": 20}).Find(&users) //// SELECT * FROM users WHERE name = "jinzhu" AND age = 20; // Slice of primary keys db.Where([]int64{20, 21, 22}).Find(&users) //// SELECT * FROM users WHERE id IN (20, 21, 22);※注意
Where句にstructを指定した場合、ゼロ値のフィールドはWehre句に反映されません。db.Where(&User{Name: "jinzhu", Age: 0}).Find(&users) //// SELECT * FROM users WHERE name = "jinzhu";これはポインタか
scanner/valuerを利用することで回避することができます。// ポインタを利用する場合 type User struct { gorm.Model Name string Age *int } // scanner/valuerを利用する場合 type User struct { gorm.Model Name string Age sql.NullInt64 }Not
Whereと同じように利用できます。
db.Not("name", "jinzhu").First(&user) //// SELECT * FROM users WHERE name <> "jinzhu" ORDER BY id LIMIT 1; // Not In db.Not("name", []string{"jinzhu", "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name NOT IN ("jinzhu", "jinzhu 2"); // Not In slice of primary keys db.Not([]int64{1,2,3}).First(&user) //// SELECT * FROM users WHERE id NOT IN (1,2,3) ORDER BY id LIMIT 1; db.Not([]int64{}).First(&user) //// SELECT * FROM users ORDER BY id LIMIT 1; // Plain SQL db.Not("name = ?", "jinzhu").First(&user) //// SELECT * FROM users WHERE NOT(name = "jinzhu") ORDER BY id LIMIT 1; // Struct db.Not(User{Name: "jinzhu"}).First(&user) //// SELECT * FROM users WHERE name <> "jinzhu" ORDER BY id LIMIT 1;Or
db.Where("role = ?", "admin").Or("role = ?", "super_admin").Find(&users) //// SELECT * FROM users WHERE role = 'admin' OR role = 'super_admin'; // Struct db.Where("name = 'jinzhu'").Or(User{Name: "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2'; // Map db.Where("name = 'jinzhu'").Or(map[string]interface{}{"name": "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2';Inline Condition
Whereと同じように利用できます。
// Get by primary key (only works for integer primary key) db.First(&user, 23) //// SELECT * FROM users WHERE id = 23; // Get by primary key if it were a non-integer type db.First(&user, "id = ?", "string_primary_key") //// SELECT * FROM users WHERE id = 'string_primary_key'; // Plain SQL db.Find(&user, "name = ?", "jinzhu") //// SELECT * FROM users WHERE name = "jinzhu"; db.Find(&users, "name <> ? AND age > ?", "jinzhu", 20) //// SELECT * FROM users WHERE name <> "jinzhu" AND age > 20; // Struct db.Find(&users, User{Age: 20}) //// SELECT * FROM users WHERE age = 20; // Map db.Find(&users, map[string]interface{}{"age": 20}) //// SELECT * FROM users WHERE age = 20;FirstOrInit
最初にマッチしたレコードを取得、または渡された条件(構造体、マップの場合のみ機能)を元に
オブジェクトを作成します。// Unfound db.FirstOrInit(&user, User{Name: "non_existing"}) //// user -> User{Name: "non_existing"} // Found db.Where(User{Name: "Jinzhu"}).FirstOrInit(&user) //// user -> User{Id: 111, Name: "Jinzhu", Age: 20} db.FirstOrInit(&user, map[string]interface{}{"name": "jinzhu"}) //// user -> User{Id: 111, Name: "Jinzhu", Age: 20}Attrs
レコードが存在しない場合に初期化します。
// Unfound db.Where(User{Name: "non_existing"}).Attrs(User{Age: 20}).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// user -> User{Name: "non_existing", Age: 20} db.Where(User{Name: "non_existing"}).Attrs("age", 20).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// user -> User{Name: "non_existing", Age: 20} // Found db.Where(User{Name: "Jinzhu"}).Attrs(User{Age: 30}).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = jinzhu' ORDER BY id LIMIT 1; //// user -> User{Id: 111, Name: "Jinzhu", Age: 20}Assign
レコードの存在有無に関係なく初期化します。
// Unfound db.Where(User{Name: "non_existing"}).Assign(User{Age: 20}).FirstOrInit(&user) //// user -> User{Name: "non_existing", Age: 20} // Found db.Where(User{Name: "Jinzhu"}).Assign(User{Age: 30}).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = jinzhu' ORDER BY id LIMIT 1; //// user -> User{Id: 111, Name: "Jinzhu", Age: 30}FirstOrCreate
最初にマッチしたレコードを取得、または渡された条件(構造体、マップの場合のみ機能)を元に
レコードを作成します。// Unfound db.FirstOrCreate(&user, User{Name: "non_existing"}) //// INSERT INTO "users" (name) VALUES ("non_existing"); //// user -> User{Id: 112, Name: "non_existing"} // Found db.Where(User{Name: "Jinzhu"}).FirstOrCreate(&user) //// user -> User{Id: 111, Name: "Jinzhu"}Attrs
レコードが存在しない場合にinsertします。
// Unfound db.Where(User{Name: "non_existing"}).Attrs(User{Age: 20}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// INSERT INTO "users" (name, age) VALUES ("non_existing", 20); //// user -> User{Id: 112, Name: "non_existing", Age: 20} // Found db.Where(User{Name: "jinzhu"}).Attrs(User{Age: 30}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1; //// user -> User{Id: 111, Name: "jinzhu", Age: 20}Assign
レコードの存在有無に関係なくinsertもしくはupdateします。
// Unfound db.Where(User{Name: "non_existing"}).Assign(User{Age: 20}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// INSERT INTO "users" (name, age) VALUES ("non_existing", 20); //// user -> User{Id: 112, Name: "non_existing", Age: 20} // Found db.Where(User{Name: "jinzhu"}).Assign(User{Age: 30}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1; //// UPDATE users SET age=30 WHERE id = 111; //// user -> User{Id: 111, Name: "jinzhu", Age: 30}SubQuery
db.Where("amount > ?", db.Table("orders").Select("AVG(amount)").Where("state = ?", "paid").SubQuery()).Find(&orders) // SELECT * FROM "orders" WHERE "orders"."deleted_at" IS NULL AND (amount > (SELECT AVG(amount) FROM "orders" WHERE (state = 'paid')));Select
取得したいカラムを指定します。
デフォルトでは全てのカラムが取得対象になっています。db.Select("name, age").Find(&users) //// SELECT name, age FROM users; db.Select([]string{"name", "age"}).Find(&users) //// SELECT name, age FROM users; db.Table("users").Select("COALESCE(age,?)", 42).Rows() //// SELECT COALESCE(age,'42') FROM users;Order
db.Order("age desc, name").Find(&users) //// SELECT * FROM users ORDER BY age desc, name; // Multiple orders db.Order("age desc").Order("name").Find(&users) //// SELECT * FROM users ORDER BY age desc, name; // ReOrder db.Order("age desc").Find(&users1).Order("age", true).Find(&users2) //// SELECT * FROM users ORDER BY age desc; (users1) //// SELECT * FROM users ORDER BY age; (users2)※TODO
ReOrderの用途がピンと来なかったので実際に使ってみる。Limit
取得するレコードの最大数を指定します。
db.Limit(3).Find(&users) //// SELECT * FROM users LIMIT 3; // Cancel limit condition with -1 db.Limit(10).Find(&users1).Limit(-1).Find(&users2) //// SELECT * FROM users LIMIT 10; (users1) //// SELECT * FROM users; (users2)Offset
db.Offset(3).Find(&users) //// SELECT * FROM users OFFSET 3; // 「-1」を指定するとoffsetをキャンセルします。 db.Offset(10).Find(&users1).Offset(-1).Find(&users2) //// SELECT * FROM users OFFSET 10; (users1) //// SELECT * FROM users; (users2)Count
db.Where("name = ?", "jinzhu").Or("name = ?", "jinzhu 2").Find(&users).Count(&count) //// SELECT * from USERS WHERE name = 'jinzhu' OR name = 'jinzhu 2'; (users) //// SELECT count(*) FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2'; (count) db.Model(&User{}).Where("name = ?", "jinzhu").Count(&count) //// SELECT count(*) FROM users WHERE name = 'jinzhu'; (count) db.Table("deleted_users").Count(&count) //// SELECT count(*) FROM deleted_users; db.Table("deleted_users").Select("count(distinct(name))").Count(&count) //// SELECT count( distinct(name) ) FROM deleted_users; (count)Group & Having
rows, err := db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Rows() for rows.Next() { ... } rows, err := db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Having("sum(amount) > ?", 100).Rows() for rows.Next() { ... } type Result struct { Date time.Time Total int64 } db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Having("sum(amount) > ?", 100).Scan(&results)Joins
rows, err := db.Table("users").Select("users.name, emails.email").Joins("left join emails on emails.user_id = users.id").Rows() for rows.Next() { ... } db.Table("users").Select("users.name, emails.email").Joins("left join emails on emails.user_id = users.id").Scan(&results) // 複数のJoin db.Joins("JOIN emails ON emails.user_id = users.id AND emails.email = ?", "jinzhu@example.org").Joins("JOIN credit_cards ON credit_cards.user_id = users.id").Where("credit_cards.number = ?", "411111111111").Find(&user)Pluck
モデルから単一のカラムをマップとして取得します。
複数のカラムを取得する場合は、代わりにスキャンを使用する必要があります。var ages []int64 db.Find(&users).Pluck("age", &ages) var names []string db.Model(&User{}).Pluck("name", &names) db.Table("deleted_users").Pluck("name", &names) // 複数カラムを取得したい場合はSelectでも同様の事ができます。 db.Select("name, age").Find(&users)Scan
スキャンは結果を構造体にマッピングします。
type Result struct { Name string Age int } var result Result db.Table("users").Select("name, age").Where("name = ?", "Antonio").Scan(&result) // 生SQL db.Raw("SELECT name, age FROM users WHERE name = ?", "Antonio").Scan(&result)
- 投稿日：2020-08-14T12:46:32+09:00
【GORM】公式ドキュメントのメモ・その2「CRUDについて(Query)」
はじめに
GORM公式ドキュメントを読んだ際、頭に残すために書き写したものです。
ほとんど公式通りですが、パッと見で理解しづらかった言い回しなどを書き直しています。
この記事では【GORM】公式ドキュメントのメモ・その１「モデル、CRUDについて」に書ききれなかったCRUDのQuery部分についてのメモを載せています。Query
// 主キーでソートし、最初のレコードを取得する db.First(&user) //// SELECT * FROM users ORDER BY id LIMIT 1; // ソートせずにレコードを1行取得する db.Take(&user) //// SELECT * FROM users LIMIT 1; // 主キーでソートし、最後のレコードを取得する db.Last(&user) //// SELECT * FROM users ORDER BY id DESC LIMIT 1; // 全てのレコードを取得する db.Find(&users) //// SELECT * FROM users; // 主キーを指定してレコードを取得する（主キーがinteger型の場合のみ使用可能） db.First(&user, 10) //// SELECT * FROM users WHERE id = 10;where
// Get first matched record db.Where("name = ?", "jinzhu").First(&user) //// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1; // Get all matched records db.Where("name = ?", "jinzhu").Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu'; // <> db.Where("name <> ?", "jinzhu").Find(&users) //// SELECT * FROM users WHERE name <> 'jinzhu'; // IN db.Where("name IN (?)", []string{"jinzhu", "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name in ('jinzhu','jinzhu 2'); // LIKE db.Where("name LIKE ?", "%jin%").Find(&users) //// SELECT * FROM users WHERE name LIKE '%jin%'; // AND db.Where("name = ? AND age >= ?", "jinzhu", "22").Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu' AND age >= 22; // Time db.Where("updated_at > ?", lastWeek).Find(&users) //// SELECT * FROM users WHERE updated_at > '2000-01-01 00:00:00'; // BETWEEN db.Where("created_at BETWEEN ? AND ?", lastWeek, today).Find(&users) //// SELECT * FROM users WHERE created_at BETWEEN '2000-01-01 00:00:00' AND '2000-01-08 00:00:00';構造体 & マップを使用する
// Struct db.Where(&User{Name: "jinzhu", Age: 20}).First(&user) //// SELECT * FROM users WHERE name = "jinzhu" AND age = 20 ORDER BY id LIMIT 1; // Map db.Where(map[string]interface{}{"name": "jinzhu", "age": 20}).Find(&users) //// SELECT * FROM users WHERE name = "jinzhu" AND age = 20; // Slice of primary keys db.Where([]int64{20, 21, 22}).Find(&users) //// SELECT * FROM users WHERE id IN (20, 21, 22);※注意
Where句にstructを指定した場合、ゼロ値のフィールドはWehre句に反映されません。db.Where(&User{Name: "jinzhu", Age: 0}).Find(&users) //// SELECT * FROM users WHERE name = "jinzhu";これはポインタか
scanner/valuerを利用することで回避することができます。// ポインタを利用する場合 type User struct { gorm.Model Name string Age *int } // scanner/valuerを利用する場合 type User struct { gorm.Model Name string Age sql.NullInt64 }Not
Whereと同じように利用できます。
db.Not("name", "jinzhu").First(&user) //// SELECT * FROM users WHERE name <> "jinzhu" ORDER BY id LIMIT 1; // Not In db.Not("name", []string{"jinzhu", "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name NOT IN ("jinzhu", "jinzhu 2"); // Not In slice of primary keys db.Not([]int64{1,2,3}).First(&user) //// SELECT * FROM users WHERE id NOT IN (1,2,3) ORDER BY id LIMIT 1; db.Not([]int64{}).First(&user) //// SELECT * FROM users ORDER BY id LIMIT 1; // Plain SQL db.Not("name = ?", "jinzhu").First(&user) //// SELECT * FROM users WHERE NOT(name = "jinzhu") ORDER BY id LIMIT 1; // Struct db.Not(User{Name: "jinzhu"}).First(&user) //// SELECT * FROM users WHERE name <> "jinzhu" ORDER BY id LIMIT 1;Or
db.Where("role = ?", "admin").Or("role = ?", "super_admin").Find(&users) //// SELECT * FROM users WHERE role = 'admin' OR role = 'super_admin'; // Struct db.Where("name = 'jinzhu'").Or(User{Name: "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2'; // Map db.Where("name = 'jinzhu'").Or(map[string]interface{}{"name": "jinzhu 2"}).Find(&users) //// SELECT * FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2';Inline Condition
Whereと同じように利用できます。
// Get by primary key (only works for integer primary key) db.First(&user, 23) //// SELECT * FROM users WHERE id = 23; // Get by primary key if it were a non-integer type db.First(&user, "id = ?", "string_primary_key") //// SELECT * FROM users WHERE id = 'string_primary_key'; // Plain SQL db.Find(&user, "name = ?", "jinzhu") //// SELECT * FROM users WHERE name = "jinzhu"; db.Find(&users, "name <> ? AND age > ?", "jinzhu", 20) //// SELECT * FROM users WHERE name <> "jinzhu" AND age > 20; // Struct db.Find(&users, User{Age: 20}) //// SELECT * FROM users WHERE age = 20; // Map db.Find(&users, map[string]interface{}{"age": 20}) //// SELECT * FROM users WHERE age = 20;FirstOrInit
最初にマッチしたレコードを取得、または渡された条件(構造体、マップの場合のみ機能)を元に
オブジェクトを作成します。// Unfound db.FirstOrInit(&user, User{Name: "non_existing"}) //// user -> User{Name: "non_existing"} // Found db.Where(User{Name: "Jinzhu"}).FirstOrInit(&user) //// user -> User{Id: 111, Name: "Jinzhu", Age: 20} db.FirstOrInit(&user, map[string]interface{}{"name": "jinzhu"}) //// user -> User{Id: 111, Name: "Jinzhu", Age: 20}Attrs
レコードが存在しない場合に初期化します。
// Unfound db.Where(User{Name: "non_existing"}).Attrs(User{Age: 20}).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// user -> User{Name: "non_existing", Age: 20} db.Where(User{Name: "non_existing"}).Attrs("age", 20).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// user -> User{Name: "non_existing", Age: 20} // Found db.Where(User{Name: "Jinzhu"}).Attrs(User{Age: 30}).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = jinzhu' ORDER BY id LIMIT 1; //// user -> User{Id: 111, Name: "Jinzhu", Age: 20}Assign
レコードの存在有無に関係なく初期化します。
// Unfound db.Where(User{Name: "non_existing"}).Assign(User{Age: 20}).FirstOrInit(&user) //// user -> User{Name: "non_existing", Age: 20} // Found db.Where(User{Name: "Jinzhu"}).Assign(User{Age: 30}).FirstOrInit(&user) //// SELECT * FROM USERS WHERE name = jinzhu' ORDER BY id LIMIT 1; //// user -> User{Id: 111, Name: "Jinzhu", Age: 30}FirstOrCreate
最初にマッチしたレコードを取得、または渡された条件(構造体、マップの場合のみ機能)を元に
レコードを作成します。// Unfound db.FirstOrCreate(&user, User{Name: "non_existing"}) //// INSERT INTO "users" (name) VALUES ("non_existing"); //// user -> User{Id: 112, Name: "non_existing"} // Found db.Where(User{Name: "Jinzhu"}).FirstOrCreate(&user) //// user -> User{Id: 111, Name: "Jinzhu"}Attrs
レコードが存在しない場合にinsertします。
// Unfound db.Where(User{Name: "non_existing"}).Attrs(User{Age: 20}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// INSERT INTO "users" (name, age) VALUES ("non_existing", 20); //// user -> User{Id: 112, Name: "non_existing", Age: 20} // Found db.Where(User{Name: "jinzhu"}).Attrs(User{Age: 30}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1; //// user -> User{Id: 111, Name: "jinzhu", Age: 20}Assign
レコードの存在有無に関係なくinsertもしくはupdateします。
// Unfound db.Where(User{Name: "non_existing"}).Assign(User{Age: 20}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'non_existing' ORDER BY id LIMIT 1; //// INSERT INTO "users" (name, age) VALUES ("non_existing", 20); //// user -> User{Id: 112, Name: "non_existing", Age: 20} // Found db.Where(User{Name: "jinzhu"}).Assign(User{Age: 30}).FirstOrCreate(&user) //// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1; //// UPDATE users SET age=30 WHERE id = 111; //// user -> User{Id: 111, Name: "jinzhu", Age: 30}SubQuery
db.Where("amount > ?", db.Table("orders").Select("AVG(amount)").Where("state = ?", "paid").SubQuery()).Find(&orders) // SELECT * FROM "orders" WHERE "orders"."deleted_at" IS NULL AND (amount > (SELECT AVG(amount) FROM "orders" WHERE (state = 'paid')));Select
取得したいカラムを指定します。
デフォルトでは全てのカラムが取得対象になっています。db.Select("name, age").Find(&users) //// SELECT name, age FROM users; db.Select([]string{"name", "age"}).Find(&users) //// SELECT name, age FROM users; db.Table("users").Select("COALESCE(age,?)", 42).Rows() //// SELECT COALESCE(age,'42') FROM users;Order
db.Order("age desc, name").Find(&users) //// SELECT * FROM users ORDER BY age desc, name; // Multiple orders db.Order("age desc").Order("name").Find(&users) //// SELECT * FROM users ORDER BY age desc, name; // ReOrder db.Order("age desc").Find(&users1).Order("age", true).Find(&users2) //// SELECT * FROM users ORDER BY age desc; (users1) //// SELECT * FROM users ORDER BY age; (users2)※TODO
ReOrderの用途がピンと来なかったので実際に使ってみる。Limit
取得するレコードの最大数を指定します。
db.Limit(3).Find(&users) //// SELECT * FROM users LIMIT 3; // Cancel limit condition with -1 db.Limit(10).Find(&users1).Limit(-1).Find(&users2) //// SELECT * FROM users LIMIT 10; (users1) //// SELECT * FROM users; (users2)Offset
db.Offset(3).Find(&users) //// SELECT * FROM users OFFSET 3; // 「-1」を指定するとoffsetをキャンセルします。 db.Offset(10).Find(&users1).Offset(-1).Find(&users2) //// SELECT * FROM users OFFSET 10; (users1) //// SELECT * FROM users; (users2)Count
db.Where("name = ?", "jinzhu").Or("name = ?", "jinzhu 2").Find(&users).Count(&count) //// SELECT * from USERS WHERE name = 'jinzhu' OR name = 'jinzhu 2'; (users) //// SELECT count(*) FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2'; (count) db.Model(&User{}).Where("name = ?", "jinzhu").Count(&count) //// SELECT count(*) FROM users WHERE name = 'jinzhu'; (count) db.Table("deleted_users").Count(&count) //// SELECT count(*) FROM deleted_users; db.Table("deleted_users").Select("count(distinct(name))").Count(&count) //// SELECT count( distinct(name) ) FROM deleted_users; (count)Group & Having
rows, err := db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Rows() for rows.Next() { ... } rows, err := db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Having("sum(amount) > ?", 100).Rows() for rows.Next() { ... } type Result struct { Date time.Time Total int64 } db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Having("sum(amount) > ?", 100).Scan(&results)Joins
rows, err := db.Table("users").Select("users.name, emails.email").Joins("left join emails on emails.user_id = users.id").Rows() for rows.Next() { ... } db.Table("users").Select("users.name, emails.email").Joins("left join emails on emails.user_id = users.id").Scan(&results) // 複数のJoin db.Joins("JOIN emails ON emails.user_id = users.id AND emails.email = ?", "jinzhu@example.org").Joins("JOIN credit_cards ON credit_cards.user_id = users.id").Where("credit_cards.number = ?", "411111111111").Find(&user)Pluck
モデルから単一のカラムをマップとして取得します。
複数のカラムを取得する場合は、代わりにスキャンを使用する必要があります。var ages []int64 db.Find(&users).Pluck("age", &ages) var names []string db.Model(&User{}).Pluck("name", &names) db.Table("deleted_users").Pluck("name", &names) // 複数カラムを取得したい場合はSelectでも同様の事ができます。 db.Select("name, age").Find(&users)Scan
スキャンは結果を構造体にマッピングします。
type Result struct { Name string Age int } var result Result db.Table("users").Select("name, age").Where("name = ?", "Antonio").Scan(&result) // 生SQL db.Raw("SELECT name, age FROM users WHERE name = ?", "Antonio").Scan(&result)
- 投稿日：2020-08-14T12:44:55+09:00
GORM公式ドキュメントのメモ・その１「モデル、CRUDについて」
はじめに
GORM公式ドキュメントを読んだ際、頭に残すために書き写したものです。
ほとんど公式通りですが、パッと見で理解しづらかった言い回しなどを書き直しています。インストール
go get -u github.com/jinzhu/gormモデル
モデルの例
type User struct { gorm.Model Name string Age sql.NullInt64 Birthday *time.Time Email string `gorm:"type:varchar(100);unique_index"` Role string `gorm:"size:255"` // フィールドサイズを255にセットします MemberNumber *string `gorm:"unique;not null"` // MemberNumberをuniqueかつnot nullにセットします Num int `gorm:"AUTO_INCREMENT"` // Numを自動インクリメントにセットします Address string `gorm:"index:addr"` // `addr`という名前のインデックスを作ります IgnoreMe int `gorm:"-"` // このフィールドは無視します }サポートされている構造体(struct)のタグ
上記モデルの
gorm:"type:varchar(100);unique_index"
でにある
・type
・unique_index
などがタグ。
タグ 説明 Column カラム名を指定します Type カラムのデータ型を指定します Size カラムサイズのサイズを指定します。デフォルトは255です PRIMARY_KEY カラムを主キーに指定します UNIQUE カラムにユニーク制約を指定します DEFAULT カラムのデフォルト値を指定します PRECISION カラムの精度を指定します NOT NULL カラムにNOT NULL制約を指定します AUTO_INCREMENT カラムに自動インクリメントかそうでないかを指定します INDEX 名前有りか名前無しでインデックスを作成します。同名のインデックスは複合インデックスになります。 UNIQUE_INDEX INDEXと同様にユニークインデックスを作成します EMBEDDED 埋め込み構造体に設定します EMBEDDED_PREFIX 埋め込み構造体のプレフィックス名を設定します - このフィールドを無視します モデルの作成
// gorm.Modelの定義 type Model struct { ID uint `gorm:"primary_key"` CreatedAt time.Time UpdatedAt time.Time DeletedAt *time.Time } // `ID`, `CreatedAt`, `UpdatedAt`, `DeletedAt`フィールドを`User`モデルに注入します type User struct { gorm.Model Name string } // gorm.Model無しにモデルを宣言する場合 type User struct { ID int // `ID`という名前のフィールドはデフォルトで主キーとして扱われます Name string }テーブル名
テーブル名は、デフォルトではStruct名の複数形が使われます。
type User struct {} // デフォルトのテーブル名は`users`です // Userのテーブル名を`profiles`にする func (User) TableName() string { return "profiles" } func (u User) TableName() string { if u.Role == "admin" { return "admin_users" } else { return "users" } } // テーブル名を複数形にしない。trueにすると、`User`のテーブル名は`user`になります db.SingularTable(true)カラム
カラム名はスネークケースになります。
type User struct { ID uint // カラム名は `id` Name string // カラム名は `name` Birthday time.Time // カラム名は `birthday` CreatedAt time.Time // カラム名は `created_at` }カラム名をオーバーライドする事も可能。
type Animal struct { AnimalId int64 `gorm:"column:beast_id"` // カラム名を `beast_id` に設定する Birthday time.Time `gorm:"column:day_of_the_beast"` // カラム名を `day_of_the_beast` に設定する Age int64 `gorm:"column:age_of_the_beast"` // カラム名を `age_of_the_beast` に設定する }タイムスタンプ
CreatedAt
CreatedAtフィールドの持つモデルでは、レコードの初回生成時に現在時刻が設定されます。
db.Create(&user) // `CreatedAt`には現在時刻が設定されますUpdatedAt
UpdatedAtフィールドを持つモデルでは、レコード保存時に現在時刻が設定されます。
db.Save(&user) // `UpdatedAt`に現在時刻を設定します db.Model(&user).Update("name", "jinzhu") // `UpdatedAt`に現在時刻を設定しますDeletedAt
モデルにDeletedAtフィールドが存在する場合、Deleteが呼ばれても実際にはデータベースからデータは削除されません。
代わりにDeletedAtにDeleteが呼ばれた時の時刻がセットされます。db.Delete(&user) //// UPDATE users SET deleted_at="2013-10-29 10:23" WHERE id = 111; // ソフトデリートされたレコードはクエリ実行時に無視されます db.Where("age = 20").Find(&user) //// SELECT * FROM users WHERE age = 20 AND deleted_at IS NULL;削除された(deleted_at IS NOT NULL)レコードも取得したい場合は
Unscopedを使用します。db.Unscoped().Where("age = 20").Find(&users) //// SELECT * FROM users WHERE age = 20;また、ソフトデリートではなく完全に削除したい場合も
Unscopedを使用します。db.Unscoped().Delete(&order) //// DELETE FROM orders WHERE id=10;データベース
公式にサポートされているのは以下4つです。
* MySQL
* PostgreSQL
* SQLite
* SQL ServerMySQL
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/mysql" ) func main() { db, err := gorm.Open("mysql", "user:password@/dbname?charset=utf8&parseTime=True&loc=Local") defer db.Close() }PostgreSQL
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/postgres" ) func main() { db, err := gorm.Open("postgres", "host=myhost port=myport user=gorm dbname=gorm password=mypassword") defer db.Close() }SQLite3
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/sqlite" ) func main() { db, err := gorm.Open("sqlite3", "/tmp/gorm.db") defer db.Close() }SQL Server
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/mssql" ) func main() { db, err := gorm.Open("mssql", "sqlserver://username:password@localhost:1433?database=dbname") defer db.Close() }CRUD
Create
user := User{Name: "Jinzhu", Age: 18, Birthday: time.Now()} db.NewRecord(user) // => 主キーが空の場合に `true` を返します。 db.Create(&user) db.NewRecord(user) // => `user` が作られた後に `false` を返します。デフォルト値を設定する事もできます。
type Animal struct { ID int64 Name string `gorm:"default:'galeone'"` Age int64 }また、値がない場合やゼロ値の場合、そのフィールドはinsert時に実行されるSQLには含まれません。
レコードの挿入後の戻り値には含まれます。
go
var animal = Animal{Age: 99, Name: ""}
db.Create(&animal)
//// INSERT INTO animals("age") values('99');
//// SELECT name from animals WHERE ID=111; // 返却された主キーは111です。
//// animal.Name => 'galeone'
デフォルト値ではなくゼロ値をそのまま保存したい場合は、ポインタかscanner/valuerを利用します。// ポインタを利用する場合 type User struct { gorm.Model Name string Age *int `gorm:"default:18"` } // scanner/valuerを利用する場合 type User struct { gorm.Model Name string Age sql.NullInt64 `gorm:"default:18"` }フック(BeforeCreate)
BeforeCreate フックでフィールドの値を更新したい場合、scope.SetColumnが利用できます。
func (user *User) BeforeCreate(scope *gorm.Scope) error { scope.SetColumn("ID", uuid.New()) return nil }重複時のオプションをSQLに設定する場合
// InsertのSQLに、オプションを設定できます。 db.Set("gorm:insert_option", "ON CONFLICT").Create(&product) //// INSERT INTO products (name, code) VALUES ("name", "code") ON CONFLICT;Update
Save
すべてのフィールドを更新します。
db.First(&user) user.Name = "jinzhu 2" user.Age = 100 db.Save(&user) //// UPDATE users SET name='jinzhu 2', age=100, birthday='2016-01-01', updated_at = '2013-11-17 21:34:10' WHERE id=111;Update
特定のフィールドだけ更新したい場合、 Update と Updates を使うことができます。
// ひとつのフィールドを更新します db.Model(&user).Update("name", "hello") //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111; // 条件付きでひとつのフィールドを更新します db.Model(&user).Where("active = ?", true).Update("name", "hello") //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111 AND active=true; // `map` で複数のフィールドを更新します(対象のフィールドのみ) db.Model(&user).Updates(map[string]interface{}{"name": "hello", "age": 18, "actived": false}) //// UPDATE users SET name='hello', age=18, actived=false, updated_at='2013-11-17 21:34:10' WHERE id=111; // `struct` で複数のフィールドを更新します(空ではないフィールドのみ) db.Model(&user).Updates(User{Name: "hello", Age: 18}) //// UPDATE users SET name='hello', age=18, updated_at = '2013-11-17 21:34:10' WHERE id = 111;
selectとomitを使って下記のような事もできます。db.Model(&user).Select("name").Updates(map[string]interface{}{"name": "hello", "age": 18, "actived": false}) //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111; db.Model(&user).Omit("name").Updates(map[string]interface{}{"name": "hello", "age": 18, "actived": false}) //// UPDATE users SET age=18, actived=false, updated_at='2013-11-17 21:34:10' WHERE id=111;フック
BeforeUpdate,BeforeSaveを使ってフック時に値を更新したい場合にはscope.SetColumnが使えます。func (user *User) BeforeSave(scope *gorm.Scope) (err error) { if pw, err := bcrypt.GenerateFromPassword(user.Password, 0); err == nil { scope.SetColumn("EncryptedPassword", pw) } }フックをスキップしたい場合
上記の更新処理は、BeforeUpdate, AfterUpdateメソッドを実行します。その結果更新時にUpdatedAtのタイムスタンプや 持っている Associations が更新されます。もしそれらのメソッドを呼びたくない場合はUpdateColumnとUpdateColumnsが使えます。
// Update single attribute, similar with `Update` db.Model(&user).UpdateColumn("name", "hello") //// UPDATE users SET name='hello' WHERE id = 111; // Update multiple attributes, similar with `Updates` db.Model(&user).UpdateColumns(User{Name: "hello", Age: 18}) //// UPDATE users SET name='hello', age=18 WHERE id = 111;また、フックはバッチアップデート時は実行されません。
クエリをともなう更新
DB.Model(&product).Update("price", gorm.Expr("price * ? + ?", 2, 100)) //// UPDATE "products" SET "price" = price * '2' + '100', "updated_at" = '2013-11-17 21:34:10' WHERE "id" = '2'; DB.Model(&product).Updates(map[string]interface{}{"price": gorm.Expr("price * ? + ?", 2, 100)}) //// UPDATE "products" SET "price" = price * '2' + '100', "updated_at" = '2013-11-17 21:34:10' WHERE "id" = '2'; DB.Model(&product).UpdateColumn("quantity", gorm.Expr("quantity - ?", 1)) //// UPDATE "products" SET "quantity" = quantity - 1 WHERE "id" = '2'; DB.Model(&product).Where("quantity > 1").UpdateColumn("quantity", gorm.Expr("quantity - ?", 1)) //// UPDATE "products" SET "quantity" = quantity - 1 WHERE "id" = '2' AND quantity > 1;Delete
db.Delete(&email) //// DELETE from emails where id=10;※注意
GORMはレコードを削除する際に主キーを使うので、主キーが空の場合、GORMはそのモデルの全レコードを削除してしまいます。まとめて削除する
db.Where("email LIKE ?", "%jinzhu%").Delete(Email{}) //// DELETE from emails where email LIKE "%jinzhu%"; db.Delete(Email{}, "email LIKE ?", "%jinzhu%") //// DELETE from emails where email LIKE "%jinzhu%";¥Soft Delete
モデルに
DeletedAtフィールドがある場合、レコードはデータベースから物理削除されるのではなく、 DeletedAtに現在の時間がセットされます。Query
- 投稿日：2020-08-14T12:44:55+09:00
【GORM】公式ドキュメントのメモ・その１「モデル、CRUDについて」
はじめに
GORM公式ドキュメントを読んだ際、頭に残すために書き写したものです。
ほとんど公式通りですが、パッと見で理解しづらかった言い回しなどを書き直しています。インストール
go get -u github.com/jinzhu/gormモデル
モデルの例
type User struct { gorm.Model Name string Age sql.NullInt64 Birthday *time.Time Email string `gorm:"type:varchar(100);unique_index"` Role string `gorm:"size:255"` // フィールドサイズを255にセットします MemberNumber *string `gorm:"unique;not null"` // MemberNumberをuniqueかつnot nullにセットします Num int `gorm:"AUTO_INCREMENT"` // Numを自動インクリメントにセットします Address string `gorm:"index:addr"` // `addr`という名前のインデックスを作ります IgnoreMe int `gorm:"-"` // このフィールドは無視します }サポートされている構造体(struct)のタグ
上記モデルの
gorm:"type:varchar(100);unique_index"
でにある
・type
・unique_index
などがタグ。
タグ 説明 Column カラム名を指定します Type カラムのデータ型を指定します Size カラムサイズのサイズを指定します。デフォルトは255です PRIMARY_KEY カラムを主キーに指定します UNIQUE カラムにユニーク制約を指定します DEFAULT カラムのデフォルト値を指定します PRECISION カラムの精度を指定します NOT NULL カラムにNOT NULL制約を指定します AUTO_INCREMENT カラムに自動インクリメントかそうでないかを指定します INDEX 名前有りか名前無しでインデックスを作成します。同名のインデックスは複合インデックスになります。 UNIQUE_INDEX INDEXと同様にユニークインデックスを作成します EMBEDDED 埋め込み構造体に設定します EMBEDDED_PREFIX 埋め込み構造体のプレフィックス名を設定します - このフィールドを無視します モデルの作成
// gorm.Modelの定義 type Model struct { ID uint `gorm:"primary_key"` CreatedAt time.Time UpdatedAt time.Time DeletedAt *time.Time } // `ID`, `CreatedAt`, `UpdatedAt`, `DeletedAt`フィールドを`User`モデルに注入します type User struct { gorm.Model Name string } // gorm.Model無しにモデルを宣言する場合 type User struct { ID int // `ID`という名前のフィールドはデフォルトで主キーとして扱われます Name string }テーブル名
テーブル名は、デフォルトではStruct名の複数形が使われます。
type User struct {} // デフォルトのテーブル名は`users`です // Userのテーブル名を`profiles`にする func (User) TableName() string { return "profiles" } func (u User) TableName() string { if u.Role == "admin" { return "admin_users" } else { return "users" } } // テーブル名を複数形にしない。trueにすると、`User`のテーブル名は`user`になります db.SingularTable(true)カラム
カラム名はスネークケースになります。
type User struct { ID uint // カラム名は `id` Name string // カラム名は `name` Birthday time.Time // カラム名は `birthday` CreatedAt time.Time // カラム名は `created_at` }カラム名をオーバーライドする事も可能。
type Animal struct { AnimalId int64 `gorm:"column:beast_id"` // カラム名を `beast_id` に設定する Birthday time.Time `gorm:"column:day_of_the_beast"` // カラム名を `day_of_the_beast` に設定する Age int64 `gorm:"column:age_of_the_beast"` // カラム名を `age_of_the_beast` に設定する }タイムスタンプ
CreatedAt
CreatedAtフィールドの持つモデルでは、レコードの初回生成時に現在時刻が設定されます。
db.Create(&user) // `CreatedAt`には現在時刻が設定されますUpdatedAt
UpdatedAtフィールドを持つモデルでは、レコード保存時に現在時刻が設定されます。
db.Save(&user) // `UpdatedAt`に現在時刻を設定します db.Model(&user).Update("name", "jinzhu") // `UpdatedAt`に現在時刻を設定しますDeletedAt
モデルにDeletedAtフィールドが存在する場合、Deleteが呼ばれても実際にはデータベースからデータは削除されません。
代わりにDeletedAtにDeleteが呼ばれた時の時刻がセットされます。db.Delete(&user) //// UPDATE users SET deleted_at="2013-10-29 10:23" WHERE id = 111; // ソフトデリートされたレコードはクエリ実行時に無視されます db.Where("age = 20").Find(&user) //// SELECT * FROM users WHERE age = 20 AND deleted_at IS NULL;削除された(deleted_at IS NOT NULL)レコードも取得したい場合は
Unscopedを使用します。db.Unscoped().Where("age = 20").Find(&users) //// SELECT * FROM users WHERE age = 20;また、ソフトデリートではなく完全に削除したい場合も
Unscopedを使用します。db.Unscoped().Delete(&order) //// DELETE FROM orders WHERE id=10;データベース
公式にサポートされているのは以下4つです。
* MySQL
* PostgreSQL
* SQLite
* SQL ServerMySQL
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/mysql" ) func main() { db, err := gorm.Open("mysql", "user:password@/dbname?charset=utf8&parseTime=True&loc=Local") defer db.Close() }PostgreSQL
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/postgres" ) func main() { db, err := gorm.Open("postgres", "host=myhost port=myport user=gorm dbname=gorm password=mypassword") defer db.Close() }SQLite3
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/sqlite" ) func main() { db, err := gorm.Open("sqlite3", "/tmp/gorm.db") defer db.Close() }SQL Server
import ( "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/mssql" ) func main() { db, err := gorm.Open("mssql", "sqlserver://username:password@localhost:1433?database=dbname") defer db.Close() }CRUD
Create
user := User{Name: "Jinzhu", Age: 18, Birthday: time.Now()} db.NewRecord(user) // => 主キーが空の場合に `true` を返します。 db.Create(&user) db.NewRecord(user) // => `user` が作られた後に `false` を返します。デフォルト値を設定する事もできます。
type Animal struct { ID int64 Name string `gorm:"default:'galeone'"` Age int64 }また、値がない場合やゼロ値の場合、そのフィールドはinsert時に実行されるSQLには含まれません。
レコードの挿入後の戻り値には含まれます。
go
var animal = Animal{Age: 99, Name: ""}
db.Create(&animal)
//// INSERT INTO animals("age") values('99');
//// SELECT name from animals WHERE ID=111; // 返却された主キーは111です。
//// animal.Name => 'galeone'
デフォルト値ではなくゼロ値をそのまま保存したい場合は、ポインタかscanner/valuerを利用します。// ポインタを利用する場合 type User struct { gorm.Model Name string Age *int `gorm:"default:18"` } // scanner/valuerを利用する場合 type User struct { gorm.Model Name string Age sql.NullInt64 `gorm:"default:18"` }フック(BeforeCreate)
BeforeCreate フックでフィールドの値を更新したい場合、scope.SetColumnが利用できます。
func (user *User) BeforeCreate(scope *gorm.Scope) error { scope.SetColumn("ID", uuid.New()) return nil }重複時のオプションをSQLに設定する場合
// InsertのSQLに、オプションを設定できます。 db.Set("gorm:insert_option", "ON CONFLICT").Create(&product) //// INSERT INTO products (name, code) VALUES ("name", "code") ON CONFLICT;Update
Save
すべてのフィールドを更新します。
db.First(&user) user.Name = "jinzhu 2" user.Age = 100 db.Save(&user) //// UPDATE users SET name='jinzhu 2', age=100, birthday='2016-01-01', updated_at = '2013-11-17 21:34:10' WHERE id=111;Update
特定のフィールドだけ更新したい場合、 Update と Updates を使うことができます。
// ひとつのフィールドを更新します db.Model(&user).Update("name", "hello") //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111; // 条件付きでひとつのフィールドを更新します db.Model(&user).Where("active = ?", true).Update("name", "hello") //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111 AND active=true; // `map` で複数のフィールドを更新します(対象のフィールドのみ) db.Model(&user).Updates(map[string]interface{}{"name": "hello", "age": 18, "actived": false}) //// UPDATE users SET name='hello', age=18, actived=false, updated_at='2013-11-17 21:34:10' WHERE id=111; // `struct` で複数のフィールドを更新します(空ではないフィールドのみ) db.Model(&user).Updates(User{Name: "hello", Age: 18}) //// UPDATE users SET name='hello', age=18, updated_at = '2013-11-17 21:34:10' WHERE id = 111;
selectとomitを使って下記のような事もできます。db.Model(&user).Select("name").Updates(map[string]interface{}{"name": "hello", "age": 18, "actived": false}) //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111; db.Model(&user).Omit("name").Updates(map[string]interface{}{"name": "hello", "age": 18, "actived": false}) //// UPDATE users SET age=18, actived=false, updated_at='2013-11-17 21:34:10' WHERE id=111;フック
BeforeUpdate,BeforeSaveを使ってフック時に値を更新したい場合にはscope.SetColumnが使えます。func (user *User) BeforeSave(scope *gorm.Scope) (err error) { if pw, err := bcrypt.GenerateFromPassword(user.Password, 0); err == nil { scope.SetColumn("EncryptedPassword", pw) } }フックをスキップしたい場合
上記の更新処理は、BeforeUpdate, AfterUpdateメソッドを実行します。その結果更新時にUpdatedAtのタイムスタンプや 持っている Associations が更新されます。もしそれらのメソッドを呼びたくない場合はUpdateColumnとUpdateColumnsが使えます。
// Update single attribute, similar with `Update` db.Model(&user).UpdateColumn("name", "hello") //// UPDATE users SET name='hello' WHERE id = 111; // Update multiple attributes, similar with `Updates` db.Model(&user).UpdateColumns(User{Name: "hello", Age: 18}) //// UPDATE users SET name='hello', age=18 WHERE id = 111;また、フックはバッチアップデート時は実行されません。
クエリをともなう更新
DB.Model(&product).Update("price", gorm.Expr("price * ? + ?", 2, 100)) //// UPDATE "products" SET "price" = price * '2' + '100', "updated_at" = '2013-11-17 21:34:10' WHERE "id" = '2'; DB.Model(&product).Updates(map[string]interface{}{"price": gorm.Expr("price * ? + ?", 2, 100)}) //// UPDATE "products" SET "price" = price * '2' + '100', "updated_at" = '2013-11-17 21:34:10' WHERE "id" = '2'; DB.Model(&product).UpdateColumn("quantity", gorm.Expr("quantity - ?", 1)) //// UPDATE "products" SET "quantity" = quantity - 1 WHERE "id" = '2'; DB.Model(&product).Where("quantity > 1").UpdateColumn("quantity", gorm.Expr("quantity - ?", 1)) //// UPDATE "products" SET "quantity" = quantity - 1 WHERE "id" = '2' AND quantity > 1;Delete
db.Delete(&email) //// DELETE from emails where id=10;※注意
GORMはレコードを削除する際に主キーを使うので、主キーが空の場合、GORMはそのモデルの全レコードを削除してしまいます。まとめて削除する
db.Where("email LIKE ?", "%jinzhu%").Delete(Email{}) //// DELETE from emails where email LIKE "%jinzhu%"; db.Delete(Email{}, "email LIKE ?", "%jinzhu%") //// DELETE from emails where email LIKE "%jinzhu%";¥Soft Delete
モデルに
DeletedAtフィールドがある場合、レコードはデータベースから物理削除されるのではなく、 DeletedAtに現在の時間がセットされます。Query