wego

大多数情况下您都是在使用worm支提供的Model方式（持结构体字段映射）来访问数据库，但有些时候使用Model方式显然有些笨重。例如您可能只需要查询一个记录的一个字段的值，这种情况下若使用Model方式则比较繁琐。 worm提供了一些快捷查询函数来应对这种需求，例如DbTable的GetString()函数，该函数克用于查询一个记录的一个字符串类型的字段。这些快捷查询函数可以用于原生SQL以及SQLBuilder模式，这些快捷函数的用法以上两种模式下的用法基本上是一致的，这里使用SQLBuilder模式来说明这些快捷函数的使用方法。

查询某个记录是否存在

有些情况下您不需要获取一个记录的数据，而是只需要查询数据库中是否存在某个记录，这种情况下可以使用Exist()函数：


func SQLBuilderExist() {
	has, err := worm.Table("user").ID(1).Exist()
	if err != nil {
		log.Error(err)
		return
	}
	//select * from user where id=? limit 1
}

查询一个记录的指定字段

有些情况下您可能只需要获取一条记录的某几个字段，这种情况在没必要定义一个struct，然后通过Model方式来获取字段的数据。您可以使用DbTable的GetValues函数：


func SQLBuilderGetValues() {
	name := ""; age := 0
	_, err := worm.Table("user").Select("name,age").ID(1).GetValues(&name, &age)
	if err != nil {
		log.Error(err)
		return
	}
	//select name,age from user where id=? limit 1
}

说明：

Get函数的参数是可变长参数，参数的数量与类型必须与Select()中的字段一一对应。
Get函数的第一个返回值是一个bool类型，用于表示是否存在该记录。

查询一个记录的一个字符串字段

GetString()函数用于查询一个记录的一个字符串字段


func SQLBuilderGetString() {
	val, err := worm.Table("user").Select("name").ID(1).GetString()
	if err != nil {
		log.Error(err)
		return
	}
	//select name from user where id=? limit 1
}

说明：

Select()中必须只有一个字段，并且字段的类型为字符串。
GetString()的第一个返回值为sql.NullString类型，其中的Valid变量用于说明是否是一个有效的值。

查询一个记录的一个整形字段

GetInt()函数用于查询一个记录的一个整形字段


func SQLBuilderGetInt() {
	val, err := worm.Table("user").Select("age").ID(1).GetInt()
	if err != nil {
		log.Error(err)
		return
	}
	//select age from user where id=? limit 1
}

说明：

Select()中必须只有一个字段，并且字段的类型为整形。
GetInt()的第一个返回值为sql.NullInt64类型，其中的Valid变量用于说明是否是一个有效的值。

查询一个记录的一个浮点型字段

GetFloat()函数用于查询一个记录的一个浮点型字段


func SQLBuilderGetFloat() {
	val, err := worm.Table("user").Select("weight").ID(1).GetFloat()
	if err != nil {
		log.Error(err)
		return
	}
	//select weight from user where id=? limit 1
}

说明：

Select()中必须只有一个字段，并且字段的类型为浮点型。
GetFloat()的第一个返回值为sql.NullFloat64类型，其中的Valid变量用于说明是否是一个有效的值。

查询一个记录的一个日期/时间型字段

GetTime()函数用于查询一个记录的一个日期/时间型字段


func SQLBuilderGetTime() {
	val, err := worm.Table("user").Select("created").ID(1).GetTime()
	if err != nil {
		log.Error(err)
		return
	}
	//select weight from user where id=? limit 1
}

说明：

Select()中必须只有一个字段，并且字段的类型为datetime。
GetTime()的第一个返回值为sql.NullTime类型，其中的Valid变量用于说明是否是一个有效的值。

查询满足条件的记录数

Count()函数用于查询查询满足条件的记录数


func SQLBuilderCount() {
	val, err := worm.Table("user").Where("id>?", 0).Count()
	if err != nil {
		log.Error(err)
		return
	}
	//select count(1) from user where id>?
}

说明：

Count()若没有参数，则使用count(1)的计数，若需要您也可以指定字段名称来计数：


func SQLBuilderCount() {
	val, err := worm.Table("user").Where("id>?", 0).Count("name")
	if err != nil {
		log.Error(err)
		return
	}
	//select count(name) from user where id>?
}

count_distinct查询

DistinctCount()函数用于统计满足条件的字段的排重后的数量：


func SQLBuilderDistinctCount() {
	val, err := worm.Table("user").Where("id>?", 0).DistinctCount("name")
	if err != nil {
		log.Error(err)
		return
	}
	//select count(distinct name) from user where id>?
}

查询字符串字段到数组

FindString()函数用于查询满足条件的记录，并将字符串字段的值添加到字符串数组：


func SQLBuilderFindString() {
	val, err := worm.Table("user").Select("name").Where("id>?", 0).FindString()
	if err != nil {
		log.Error(err)
		return
	}
	// select name from user where id>?
}

说明：

Select()中必须只有一个字段，并且字段的类型为字符串。

查询整形字段到数组

FindInt()函数用于查询满足条件的记录，并将整形字段的值添加到整形数组：


func SQLBuilderFindInt() {
	val, err := worm.Table("user").Select("age").Where("id>?", 0).FindInt()
	if err != nil {
		log.Error(err)
		return
	}
	log.Debug(val)
	// select age from user where id>?
}

说明：

Select()中必须只有一个字段，并且字段的类型为整形。

查询浮点型字段到数组

FindInt()函数用于查询满足条件的记录，并将浮点型字段的值添加到浮点型数组：


func SQLBuilderFindFloat() {
	val, err := worm.Table("user").Select("weight").Where("id>?", 0).FindFloat()
	if err != nil {
		log.Error(err)
		return
	}
	// select weight from user where id>?
}

说明：

Select()中必须只有一个字段，并且字段的类型为浮点型。

查询datetime型字段到数组

FindTime()函数用于查询满足条件的记录，并将datetime型字段的值添加到Time型数组：


func SQLBuilderFindTime() {
    data, err := worm.Table("user").Select("created").Where("id>?", 0).FindTime()
    if err != nil {
        t.Error(err)
        return
    }
	// select created from user where id>?
}

说明：

Select()中必须只有一个字段，并且字段的类型为datetime。