Django筆記二十七之資料庫函式之文本函式

本文首發于公眾號：Hunter后端
原文鏈接：Django筆記二十七之資料庫函式之文本函式

這篇筆記將介紹如何使用資料庫函式里的文本函式，

顧名思義，文本函式，就是針對文本欄位進行操作的函式，如下是目錄匯總：

1. Concat() —— 合并
2. Left() —— 從左邊開始截取
3. Length() —— 獲取字串長度
4. Lower() —— 小寫處理
5. LPad() —— 從左邊填充指定字串
6. MD5() —— 獲取字串MD5哈希值
7. Repeat() —— 重復指定欄位值
8. Replace() —— 替換指定內容
9. Reverse() —— 欄位內容反轉回傳
10. StrIndex() —— 獲取第一個匹配指定字串的下標
11. SubStr() —— 字串截取
12. Trim() —— 去除給定欄位空格

這一篇筆記記錄的函式有點多，可以慢慢看，慢慢測驗，其中有一些函式是左右都有對應操作的，我這里只介紹一個，另一個對應的函式除了函式名不一樣和作用相反外，用法都是一樣的，

我們這次用到的是 Author 這個 model：

class Author(models.Model):
    name = models.CharField(max_length=200)
    email = models.EmailField(null=True, default=None)
    age = models.IntegerField(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)

1、Concat() —— 合并

Concat() 函式，是合并的作用，接受至少兩個文本欄位或者運算式引數，將其合并成一個欄位回傳，

示例如下：

from django.db.models.functions import Concat
from django.db.models import CharField, Value
from blog.models import Author

author = Author.objects.create(name="hunter", alias="alias")


author = Author.objects.annotate(
    concat_name=Concat('name', Value('_'), 'alias', output_field=CharField()
    )
).get(id=author.id)


print(author.concat_name)

在示例中，我們將 name 欄位和 alias 欄位以及 _ 這個字串用 Value() 函式修飾，傳入 Concat()，并通過 output_field 來指定輸出字串型別，將三者合并成一個字串回傳

注意： 如果是將 TextField() 和 CharField() 欄位進行合并，那么 output_field 必須是 TextField()

2、Left() —— 從左邊開始截取

輸入兩個引數，一個是指定欄位，一個是指定的長度，表示將對該欄位從左邊開始截取指定長度回傳

以下是示例：

from django.db.models.functions import Left

author = Author.objects.annotate(left_three_str=Left('name', 3)).get(id=10)

print(author.left_three_str)

注意一下，我在示例中使用到的 id 的值都是在我自己資料庫的 id值，讀者在自己測驗的時候，需要替換成自己資料的真實 id

同理，django.db.models.functions.Right 是從右邊開始截取

3、Length() —— 獲取字串長度

接受文本欄位或者運算式作為引數，回傳字串長度

如果欄位或者運算式為 null，那么在 Python 里會回傳 None

以下是使用示例：

from django.db.models.functions import Length

author = Author.objects.annotate(name_length=Length("name"), email_length=Length("email")).get(id=10)

print(author.name_length)
# 回傳數字

print(author.email_length)
# 欄位值為 null, 所以回傳 None

這里也可以用于搜索，假設說我想搜索 name 欄位長度大于3的資料，可以如下實作：

from django.db.models import CharField
from django.db.models.functions import Length

CharField.register_lookup(Length)

authors = Author.objects.filter(name__length__gt=3)
print(authors.count())

或者 annotate() 出一個新欄位，然后進行 filter()

Author.objects.annotate(name_length=Length("name")).filter(name_length__gt=3)

4、Lower() —— 小寫處理

接受文本欄位名或者運算式作為引數傳入，然后將其小寫化處理回傳

以下是使用示例：

from django.db.models.functions import Lower

Author.objects.create(name="HUNTER")

author = Author.objects.annotate(name_lower=Lower("name")).get(id=11)

print(author.name_lower)

跟 Length() 函式一樣，也可以使用注冊的方式來搜索：

from django.db.models import CharField
from django.db.models.functions import Lower

CharField.register_lookup(Lower)

authors = Author.objects.filter(name__lower="hunter")
print(authors.values("name"))

同理，大寫化的函式為 django.db.models.functions.Upper()

5、LPad() —— 從左邊填充指定字串

LPad() 意思為從左邊填充指定字串，接受三個引數：

第一個引數為欄位名或運算式

第二個引數為需要填充到的長度，引數名為 length，需要指定值

第三個引數名為 fill_text，值為填充的內容，默認為空字串

假設我們需要將 abc 填充到 name 欄位，需要填充到 10 個字符長度

那么如果 name 的原始值為 hunter，結果則會是 abcahunter

如果需要填充的值短了，那么就會重復填充，如果長了，就會被截取填充，在剛剛的例子里，第二次填充的時候，再重復一次 abc 則超出 10個長度的限制，所以 abc 被截取了，

以下是使用示例：

from django.db.models.functions import LPad
from django.db.models import Value

Author.objects.create(name="HUNTER")

author = Author.objects.annotate(
    name_1=LPad('name', 4, fill_text=Value('abc')),
    name_2=LPad('name', 8, fill_text=Value('abc')),
    name_3=LPad('name', 16, fill_text=Value('abc'))
).get(id=11)


print(author.name_1)
# HUNT

print(author.name_2)
# abHUNTER

print(author.name_3)
# abcabcabcaHUNTER

更新操作

我們還可以利用 LPad() 函式來對欄位進行更新操作

Author.objects.filter(id=11).update(name=LPad('name', 10, Value('abv')))
author = Author.objects.get(id=11)
print(author.name)

這段代碼的含義為，將 name 欄位原有值的左邊填充 abc 字串填充到10個字符長度后更新到 name 欄位

同理，還有一個從右邊開始填充的函式 RPad()，也是同樣的用法

6、MD5() —— 獲取字串MD5哈希值

接受單個文本欄位或者運算式作為引數，回傳字串的 MD5 哈希值

from django.db.models.functions import MD5

author = Author.objects.annotate(name_md5=MD5('name')).get(id=11)

print(author.name_md5)

7、Repeat() —— 重復指定欄位值

Repeat(expression, number)
接受欄位引數，和重復的次數，回傳欄位內容重復 number 遍之后的資料

from django.db.models.functions import Repeat

Author.objects.create(name="Python")
# id = 13

author = Author.objects.annotate(repeat_name=Repeat("name", 3)).get(id=13)
print(author.repeat_name)

# 列印出的值為：PythonPythonPython

更新欄位資料

將 id=13 的資料的 name 欄位重復三遍之后更新到該欄位：

Author.objects.filter(id=13).update(name=Repeat("name", 3))

8、Replace() —— 替換指定內容

Replace(expression, text, replacement=Value(''))
替換，即將 expression 欄位的值的所有內容為 text 的替換成 replacement 的內容，replacement 默認為空字串

在下面的例子中，我們將 name 欄位中所有的 Ma 字串更新為 Je

from django.db.models.functions import Replace
from django.db.models import Value

Author.objects.create(name="Match-Mary")
# id = 14

Author.objects.filter(id=14).update(name=Replace('name', Value('Ma'), Value('Je')))

author = Author.objects.get(id=14)

print(author.name)
# Jetch-Jery

9、Reverse() —— 欄位內容反轉回傳

接受欄位或者運算式為引數，將原欄位內容倒序后回傳

from django.db.models.functions import Reverse

author = Author.objects.annotate(reverse_name=Reverse('name')).get(id=11)
print(author.reverse_name)

10、StrIndex() —— 獲取第一個匹配指定字串的下標

接受兩個引數，一個引數為欄位名，第二個引數為需要匹配的子串

如果子串在欄位中被匹配上了，將會回傳第一個匹配上的子串的下標

注意1：匹配上的下標是從1開始計數的，如果沒有匹配上，那就回回傳0

注意2：這個匹配的程序是忽略大小寫的

from django.db.models.functions import StrIndex
from django.db.models import Value

author = Author.objects.create(name="thIs is a Test")

author = Author.objects.annotate(
    is_index=StrIndex("name", Value("is")),
    test_index=StrIndex("name", Value("test")),
    xx_index=StrIndex("name", Value("xx"))
).get(id=author.id)


print(author.is_index)
# 3，is 字串匹配忽略大小寫，下標從1開始，所以是3

print(author.test_index)
# 11 

print(author.xx_index)
# 0 找不到對應的字串，所以回傳 0，可以根據 0 這個標志位來判斷欄位中是否包含某個特定字符

而這個操作我們可以用來篩選欄位中是否包含某個特定字串的資料，根據回傳的結果是否為 0 來判斷：

authors = Author.objects.annotate(ter_index=StrIndex("name", Value("ter"))).filter(ter_index__gt=0)
print(authors.count())

11、SubStr() —— 字串截取

SunStr(expression, pos, length=None)

這是一個字串截取的函式，給定一個欄位名，和開始的下標（下標從1開始計數），和需要計數的長度

表示將某欄位，從指定下標開始，截取指定長度的字串

from django.db.models.functions import Substr

# 將 name 欄位 從 第二個字符開始往后截取三個長度的字符
author = Author.objects.annotate(name_sub_str=Substr('name', 2, 3)).get(id=12)

print(author.name_sub_str)

可以用于直接更新：

Author.objects.filter(id=12).update(name=Substr('name', 2, 3))

12、Trim() —— 去除給定欄位空格

去除空格給定欄位左右兩邊的空格

Author.objects.create(name=" test trim ")  # id = 15

from django.db.models.functions import Trim

author = Author.objects.annotate(trim_name=Trim("name")).get(id=15)

print(author.trim_name)

也可以直接用于更新：

Author.objects.filter(id=15).update(name=Trim("name"))

同理，還有去除左邊空格的函式 LTrim() 和 去除右邊空格的函式 RTrim()

以上就是本篇筆記全部內容，下一篇將會是比較重要也比較長的一篇筆記，將會對 Django 系統操作的資料庫優化做一次匯總，

如果想獲取更多后端相關文章，可掃碼關注閱讀：

標籤：Python

上一篇：圖片的腐蝕，膨脹，開丶閉運算，梯度計算，禮帽與黑帽

下一篇：返回列表