django 1.8 官方文档翻译: 2-5-10 数据库函数
2015-09-13 14:36
639 查看
数据库函数
New in Django 1.8.
下面记述的类为用户提供了一些方法,来在Django中使用底层数据库提供的函数用于注解、聚合或者过滤器等操作。函数也是表达式,所以可以像聚合函数一样混合使用它们。
我们会在每个函数的实例中使用下面的模型:
class Author(models.Model): name = models.CharField(max_length=50) age = models.PositiveIntegerField(null=True, blank=True) alias = models.CharField(max_length=50, null=True, blank=True) goes_by = models.CharField(max_length=50, null=True, blank=True)
我们并不推荐在CharField上允许null=True,以后那位这会允许字段有两个“空值”,但是对于下面的Coalesce示例来说它很重要。
Coalesce
class Coalesce(*expressions, **extra)[source]
接受一个含有至少两个字段名称或表达式的列表,返回第一个非空的值(注意空字符串不被认为是一个空值)。每个参与都必须是相似的类型,所以掺杂了文本和数字的列表会导致数据库错误。
使用范例:
>>> # Get a screen name from least to most public >>> from django.db.models import Sum, Value as V >>> from django.db.models.functions import Coalesce >>> Author.objects.create(name='Margaret Smith', goes_by='Maggie') >>> author = Author.objects.annotate( ... screen_name=Coalesce('alias', 'goes_by', 'name')).get() >>> print(author.screen_name) Maggie >>> # Prevent an aggregate Sum() from returning None >>> aggregated = Author.objects.aggregate( ... combined_age=Coalesce(Sum('age'), V(0)), ... combined_age_default=Sum('age')) >>> print(aggregated['combined_age']) 0 >>> print(aggregated['combined_age_default']) None
Concat
class Concat(*expressions, **extra)[source]
接受一个含有至少两个文本字段的或表达式的列表,返回连接后的文本。每个参数都必须是文本或者字符类型。如果你想把一个
TextField()和一个
CharField()连接, 一定要告诉Django
output_field应该为
TextField()类型。在下面连接
Value的例子中,这也是必需的。
这个函数不会返回
null。在后端中,如果一个
null参数导致了整个表达式都是
null,Django会确保把每个
null的部分转换成一个空字符串。
使用范例:
>>> # Get the display name as "name (goes_by)" >>> from django.db.models import CharField, Value as V >>> from django.db.models.functions import Concat >>> Author.objects.create(name='Margaret Smith', goes_by='Maggie') >>> author = Author.objects.annotate( ... screen_name=Concat('name', V(' ('), 'goes_by', V(')'), ... output_field=CharField())).get() >>> print(author.screen_name) Margaret Smith (Maggie)
Length
class Length(expression, **extra)[source]
接受一个文本字段或表达式,返回值的字符个数。如果表达式是
null,长度也会是
null。
使用范例:
>>> # Get the length of the name and goes_by fields >>> from django.db.models.functions import Length >>> Author.objects.create(name='Margaret Smith') >>> author = Author.objects.annotate( ... name_length=Length('name'), ... goes_by_length=Length('goes_by')).get() >>> print(author.name_length, author.goes_by_length) (14, None)
Lower
class Lower(expression, **extra)[source]
接受一个文本字符串或表达式,返回它的小写表示形式。
使用范例:
>>> from django.db.models.functions import Lower >>> Author.objects.create(name='Margaret Smith') >>> author = Author.objects.annotate(name_lower=Lower('name')).get() >>> print(author.name_lower) margaret smith
Substr
class Substr(expression, pos, length=None, **extra)[source]
返回这个字段或者表达式的,以
pos位置开始,长度为
length的子字符串。位置从下标为1开始,所以必须大于0。如果
length是
None,会返回剩余的字符串。
使用范例:
>>> # Set the alias to the first 5 characters of the name as lowercase >>> from django.db.models.functions import Substr, Lower >>> Author.objects.create(name='Margaret Smith') >>> Author.objects.update(alias=Lower(Substr('name', 1, 5))) 1 >>> print(Author.objects.get(name='Margaret Smith').alias) marga
Upper
class Upper(expression, **extra)[source]
接受一个文本字符串或表达式,返回它的大写表示形式。
使用范例:
>>> from django.db.models.functions import Upper >>> Author.objects.create(name='Margaret Smith') >>> author = Author.objects.annotate(name_upper=Upper('name')).get() >>> print(author.name_upper) MARGARET SMITH
译者:Django 文档协作翻译小组,原文:Database Functions。
本文以 CC BY-NC-SA 3.0 协议发布,转载请保留作者署名和文章出处。
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。
相关文章推荐
- [转] SQL Server游标的使用
- 如何为mysql建立索引
- ssh框架+oracle实现将文件保存到服务器
- SQL server数据库的学习内容
- 分享一个Linux下安装ASM+ORACLE的自动化脚本(一)
- Oracle date 类型to_char获取月份英文简写
- 安装oracle11g学习版遇到的几个问题
- 第二篇 Mysql常用操作记录(转载)
- SQLite的使用
- oracle 如何把一个表中的数据复制到另一个表中
- mysql --设置root 密码
- Memcached 源码安装 与 配置
- MVCC实现-MYSQL INNODB MVCC实现
- [EF]vs15+ef6+mysql code first方式
- oracle ocfs2 安装配置
- WINDOWS下运行ORACLE SQLPLUS时报错Message file sp1<lang>.msb not found问题解决
- [Sqlite] Sqlite的基本日常SQL操作语句汇总
- 数据库范式详解
- 海量数据处理的SQL性能优化
- MongoDB学习之在Windows下安装MongoDB