MySQL :: MySQL 8.4 參考手冊 :: 14.9.7 為全文索引新增使用者定義的排序規則

版本 8.4

8.0 日文

MySQL 8.4 參考手冊 / ... / 為全文索引新增使用者定義的排序規則

14.9.7 為全文索引新增使用者定義的排序規則

警告

使用者定義的排序規則已棄用；您應該預期在未來版本的 MySQL 中會移除對它們的支援。伺服器會在 SQL 陳述式中使用任何 COLLATE user_defined_collation 時發出警告；當伺服器啟動時，若 --collation-server 設定為等於使用者定義排序規則的名稱時，也會發出警告。

本節說明如何使用內建全文剖析器為全文搜尋新增使用者定義的排序規則。範例排序規則類似於 latin1_swedish_ci，但將 '-' 字元視為字母而非標點符號，以便可以將其索引為單字字元。有關新增排序規則的一般資訊，請參閱第 12.14 節〈為字元集新增排序規則〉；假設您已閱讀並熟悉相關檔案。

若要為全文索引新增排序規則，請使用下列程序。此處的說明為簡單字元集新增排序規則，如第 12.14 節〈為字元集新增排序規則〉中所述，可以使用描述字元集屬性的組態檔建立。對於複雜的字元集（例如 Unicode），請使用描述字元集屬性的 C 原始檔建立排序規則。

將排序規則新增至 Index.xml 檔案。使用者定義排序規則允許的 ID 範圍在第 12.14.2 節〈選擇排序規則 ID〉中提供。ID 必須是未使用的，因此，如果您的系統已使用 ID 1025，請選擇不同的值。
```
<charset name="latin1">
...
<collation name="latin1_fulltext_ci" id="1025"/>
</charset>
```

在 latin1.xml 檔案中宣告排序規則的排序順序。在這種情況下，可以從 latin1_swedish_ci 複製順序。

<collation name="latin1_fulltext_ci">
<map>
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F
20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F
30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F
40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F
50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F
60 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F
50 51 52 53 54 55 56 57 58 59 5A 7B 7C 7D 7E 7F
80 81 82 83 84 85 86 87 88 89 8A 8B 8C 8D 8E 8F
90 91 92 93 94 95 96 97 98 99 9A 9B 9C 9D 9E 9F
A0 A1 A2 A3 A4 A5 A6 A7 A8 A9 AA AB AC AD AE AF
B0 B1 B2 B3 B4 B5 B6 B7 B8 B9 BA BB BC BD BE BF
41 41 41 41 5C 5B 5C 43 45 45 45 45 49 49 49 49
44 4E 4F 4F 4F 4F 5D D7 D8 55 55 55 59 59 DE DF
41 41 41 41 5C 5B 5C 43 45 45 45 45 49 49 49 49
44 4E 4F 4F 4F 4F 5D F7 D8 55 55 55 59 59 DE FF
</map>
</collation>

修改 latin1.xml 中的 ctype 陣列。將對應於 0x2D（即 '-' 字元的代碼）的值從 10（標點符號）變更為 01（大寫字母）。在下列陣列中，這是第四列往下、從最後一個值算起第三個元素。

<ctype>
<map>
00
20 20 20 20 20 20 20 20 20 28 28 28 28 28 20 20
20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
48 10 10 10 10 10 10 10 10 10 10 10 10 01 10 10
84 84 84 84 84 84 84 84 84 84 10 10 10 10 10 10
10 81 81 81 81 81 81 01 01 01 01 01 01 01 01 01
01 01 01 01 01 01 01 01 01 01 01 10 10 10 10 10
10 82 82 82 82 82 82 02 02 02 02 02 02 02 02 02
02 02 02 02 02 02 02 02 02 02 02 10 10 10 10 20
10 00 10 02 10 10 10 10 10 10 01 10 01 00 01 00
00 10 10 10 10 10 10 10 10 10 02 10 02 00 02 01
48 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01
01 01 01 01 01 01 01 10 01 01 01 01 01 01 01 02
02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02
02 02 02 02 02 02 02 10 02 02 02 02 02 02 02 02
</map>
</ctype>

重新啟動伺服器。

若要採用新的排序規則，請將其包含在要使用它的資料行定義中

mysql> DROP TABLE IF EXISTS t1;
Query OK, 0 rows affected (0.13 sec)

mysql> CREATE TABLE t1 (
    a TEXT CHARACTER SET latin1 COLLATE latin1_fulltext_ci,
    FULLTEXT INDEX(a)
    ) ENGINE=InnoDB;
Query OK, 0 rows affected (0.47 sec)

測試排序規則以驗證連字號是否被視為單字字元

mysql> INSERT INTO t1 VALUEs ('----'),('....'),('abcd');
Query OK, 3 rows affected (0.22 sec)
Records: 3  Duplicates: 0  Warnings: 0

mysql> SELECT * FROM t1 WHERE MATCH a AGAINST ('----' IN BOOLEAN MODE);
+------+
| a    |
+------+
| ---- |
+------+
1 row in set (0.00 sec)