|
| |
| Sun Java(TM) System Directory Server 5 2004Q2 管理指南 | |
第 10 章
編製目錄資料索引Directory Server 的索引就像書本的索引頁一樣，藉由把要搜尋的字串跟目錄內容的參考產生關聯，可以加快搜尋的速度。索引是屬性值的表格，儲存在單獨的資料庫檔案內。目錄中每個尾碼的索引建立與管理彼此獨立。一旦在尾碼組態中建立索引後，伺服器就會自動維護索引。
如需索引簡介、索引成本與效益、nsslapd-allidsthreshold 屬性說明以及提昇 Directory Server 效能的方法，請參閱《Directory Server Performance Tuning Guide》中的 Chapter 4 "Tuning Indexing"。
本章包含下列章節：
編製索引概論每個尾碼的索引分別儲存在對應的資料庫目錄檔案內。每個索引檔案包含尾碼中為指定屬性定義的所有索引。例如，為一般名稱 (cn) 屬性維護的所有索引儲存在 databaseName_cn.db3 檔中。
當您初始化尾碼或使用本章所述的指令時，就會建立索引檔案。在用戶端搜尋作業與內部作業期間，伺服器會存取索引，以更快速地找到目錄中的項目。修改作業期間，目錄必須藉由更新索引檔案來更新目錄內容及維護索引。
Directory Server 支援下列索引類型：
Directory Server 為子字串編製索引，以便能夠在索引中找到要搜尋的最短雙字元子字串。因此使用索引，可以加快搜尋 (sn=*ab) 的速度，但是搜尋 (sn=*a) 卻不會加快速度。Directory Server 提供進一步的最佳化，允許對萬用字元前只有一個字元時進行起始的子字串搜尋。因此，在子字串索引可用時，也可以加速搜尋 (sn=a*)的速度，但不能加速搜尋 (sn=*a)) 的速度。如需有關子字串索引的詳細資訊，請參閱《Directory Server Performance Tuning Guide》中的 "Substring Indexes"。
系統索引
系統索引是不得刪除或修改的索引。Directory Server 需要有這些索引才能正確有效率地運作。下表列出每個尾碼中自動建立的系統索引：
預設索引
當您在目錄中建立新尾碼時，伺服器會在對應的資料庫目錄中設定一組預設索引。您可以依編製索引的需要修改預設索引，但在取消設定索引之前，應該確定沒有任何伺服器 Plug-in 或您公司的其他伺服器會需要依靠該索引的屬性。
若要修改新尾碼建立時將使用的預設索引組，請參閱「修改預設索引組」。
下表列出 Directory Server 中預先設定的預設索引：
表 10-2 每個新尾碼的預設索引
屬性
相等索引
存在索引
子字串索引
目的
cn
X
X
X
改善最常使用類型的使用者目錄搜尋效能。
givenName
X
X
X
改善最常使用類型的使用者目錄搜尋效能。
X
X
X
改善最常使用類型的使用者目錄搜尋效能。
mailAlternateAddress
X
由 Sun Java System Messaging Server 使用。
mailHost
X
由 Sun Java System Messaging Server 所使用。
member
X
改善 Sun Java System 伺服器效能。參考的完整性 Plug-in 也會使用此索引。如需詳細資訊，請參閱「維護參考的完整性」。
nsCalXItemId
X
X
X
由 Sun Java System Calendar Server 使用。
nsLIProfileName
X
由 Sun Java System Messaging Server 的漫遊功能使用。
nsRoleDN
X
改善以角色為基礎的作業效能。
nswcalCALID
X
由 Sun Java System Calendar Server 所使用。
owner
X
改善 Sun Java System 伺服器效能。參考的完整性 Plug-in 也會使用此索引。如需詳細資訊，請參閱「維護參考的完整性」。
pipstatus
X
由 Sun Java System Server 使用。
pipuid
X
由 Sun Java System Server 所使用。
seeAlso
X
改善 Sun Java System 伺服器效能。參考的完整性 Plug-in 也會使用此索引。如需詳細資訊，請參閱「維護參考的完整性」。
sn
X
X
X
改善最常使用類型的使用者目錄搜尋效能。
telephoneNumber
X
X
X
改善最常使用類型的使用者目錄搜尋效能。
uid
X
改善 Sun Java System 伺服器效能。
uniquemember
X
改善 Sun Java System 伺服器效能。參考的完整性 Plug-in 也會使用此索引。如需詳細資訊，請參閱「維護參考的完整性」。
屬性名稱快速參考表
下表列出所有具有主要或真實名稱以及別名的屬性。建立索引時，請確認使用主要名稱。
管理索引本節描述如何使用 Directory Server Console 和指令行為特定屬性建立及移除存在、相等、近似、子字串與國際索引。如需關於虛擬清單檢視 (VLV) 作業所需的獨立程序，請參閱「管理瀏覽索引」。
建立新索引前，請先衡量維護索引的成本與效益。請記住：
使用主控台管理索引
如果您計劃在許多屬性上修改或加入索引，您應該先將尾碼設為唯讀，再將其內容匯出到 LDIF。接著利用從 LDIF 檔案重新初始化尾碼的方式，將會比尾碼重新編製索引的速度快。
- 在 Directory Server Console 最上層的 [組態] 標籤上，展開 [資料] 節點，並選擇要編製索引的尾碼。然後選擇右面板上的 [索引] 標籤。
「系統索引」表不得修改。請在「額外索引」表中的屬性上加入、修改或移除索引。
- 若要在尚未編製索引的屬性上加入索引，請按一下 [加入屬性] 按鈕。在顯示的對話方塊中，選擇一或多個要編製索引的屬性，再按一下 [確定]。
新屬性出現在「額外索引」表中。
- 若要修改屬性的索引，請在「額外索引」表中選擇或取消選取要為該屬性維護之每種索引類型旁的核取方塊。
- 如果要為包含非英文值的屬性建立索引，請在 [對應規則] 欄位中輸入要使用之定序排序的 OID。
您可以用逗號分隔 (但不可以有空格) 列出多個 OID，來用多種語言為屬性編製索引。如需支援的地區設定清單，及其關聯定序排序的 OID，請參閱《Directory Server Administration Reference》中的 Chapter 5 "Directory Internationalization Reference"。
- 若要移除屬性的所有索引，請在表格中選擇它的列，再按一下 [刪除屬性] 按鈕。
- 按一下 [儲存] 以儲存新的索引組態。
如果移除屬性的所有索引，伺服器將移除該屬性的每個索引檔案，至此組態就已完成。如果您修改屬性的索引，或加入新索引，請繼續進行下一個步驟。
- 出現警告對話方塊，通知您必須更新資料庫檔案，才能開始使用新索引。您可以重新編製尾碼索引，或將尾碼重新初始化。
- 如果只加入或修改一或兩個索引，或是您的尾碼不得設為無法使用，您應該重新編製尾碼索引。請按一下 [重新索引尾碼]，以顯示重新編製索引對話方塊。預設狀況下會選擇您對索引組態修改或加入的屬性。按一下 [確定] 以開啟重新編製這些屬性的索引。對於有幾百萬筆項目的目錄，若重新編製許多屬性的索引可能要花費幾個小時的時間才能完成，但在重新編製索引期間，尾碼將始終處於線上的狀態。
- 如果在幾個屬性上加入或修改索引，而且您有一個從這個尾碼匯出的最新 LDIF 檔案，請按一下 [初始化尾碼] 按鈕。在 [初始化尾碼] 對話方塊中，輸入或瀏覽 LDIF 檔案的路徑與名稱，再按一下 [確定]。伺服器將從 LDIF 檔案重新初始化尾碼，並根據新組態建立所有索引。依目錄大小而定，重新初始化尾碼通常會比重新編製兩個或多個屬性的索引快，但在初始化過程中，尾碼將無法使用。
- 如果不將尾碼重新編製索引或初始化，所有資料仍將可以使用，但不會建立新索引，也不會改善目錄存取效能。
從指令行管理索引
從指令行建立或修改索引分為兩個步驟：
建立索引組態項目
若要為尚未編製索引的屬性建立索引，您必須在對應資料庫的組態中為該屬性建立新的項目。
索引組態項目擁有下列 DN：
cn=attributeName,cn=index,cn=databaseName,cn=ldbm database,
cn=plugins,cn=config其中 databaseName 是要建立索引之尾碼的對應資料庫名稱。例如，下列指令將為法文的 sn (姓氏) 屬性值建立存在、相等、子字串和「發音類似」索引：
ldapmodify -a -h host -p port -D "cn=Directory Manager" -w password
dn:cn=sn,cn=index,cn=databaseName,cn=ldbm database,
cn=plugins,cn=config
objectClass:top
objectClass:nsIndex
cn:sn
nsSystemIndex:false
nsIndexType:pres
nsIndexType:eq
nsIndexType:sub
nsIndexType:approx
nsMatchingRule: 1.3.6.1.4.1.42.2.27.9.4.76.1
^D索引組態項目擁有 nsIndex 物件類別，而且 nsSystemIndex 屬性必須存在，它的值必須是 false。您無法建立新的系統索引。系統只維護由 Directory Server 內部定義的現有系統索引。
nsIndexType 屬性值列出將為指定屬性維護的索引。請使用上述任何值定義對應的索引。
您也可以用單一值 none 明確停用屬性的索引，例如，暫時停用屬性的索引編製工作。如果索引組態項目中不包含 nsIndexType 屬性，將預設為維護所有索引。
選用的 nsMatchingRule 屬性包含國際化索引的語言定序排序 OID。如需支援的地區設定清單，及其關聯定序排序的 OID，請參閱《 Directory Server Administration Reference》中的 Chapter 5 "Directory Internationalization Reference"。
如需關於索引組態屬性的詳細資料，請參閱《 Directory Server Administration Reference》Chapter 2 的 "Default Index Attributes"。
備註
建立索引時，您應該永遠使用屬性的主要名稱 (不是屬性別名)。屬性的主要名稱為該結構中之屬性所列示的第一個名稱，例如 userid 屬性的 uid。如需所有主要與別名屬性名稱清單，請參閱表 10-3。
修改索引組態項目
若要設定屬性上已定義的索引，請修改對應的索引項目。例如，以下在先前定義的 sn 索引組態上執行的指令將移除「發音類似」索引，並將語言改為加拿大法文：
ldapmodify -h host -p port -D "cn=Directory Manager" -w password
dn:cn=sn,cn=index,cn=databaseName,cn=ldbm database,
cn=plugins,cn=config
changetype:modify
delete:nsIndexType
nsIndexType:approx
-
replace:nsMatchingRule
nsMatchingRule: 1.3.6.1.4.1.42.2.27.9.4.78.1
^D執行 db2index-task
建立索引項目後，若在現有索引項目上加入其他索引類型，或修改其定序排序，則執行 directoryserver db2index-task 指令以產生新的索引。此指令會根據其組態項目讀取尾碼內容，為指定屬性編製索引。
在執行此指令時，使用者仍然可以透過伺服器取得尾碼內容，但在指令完成之前，將不進行索引搜尋。重新編製索引作業需要耗費大量資源，因此可能會影響伺服器上其他作業的效能。依目錄大小而定，重新初始化尾碼通常會比重新編製兩個或多個屬性的索引快，但在初始化過程中，尾碼將無法使用。如需詳細資訊，請參閱「重新初始化尾碼」。
下列範例會在 databaseName 對應的尾碼中重新產生 sn 索引。
# /usr/sbin/directoryserver db2index-task
-D "cn=Directory Manager" -w password -n databaseName -t sn如需詳細資訊，請參閱《Directory Server Administration Reference》Chapter 1 "db2index-task"。
刪除屬性的所有索引
如果要移除為屬性設定的所有索引，您可以移除其組態項目和資料庫檔案。例如，下列指令將取消設定 databaseName 資料庫中 sn 屬性的所有索引。
ldapdelete -h host -p port -D "cn=Directory Manager" -w password \
"cn=sn,cn=index,cn=databaseName,cn=ldbm database,cn=plugins, \
cn=config"一旦刪除這個項目後，databaseName 資料庫對應的尾碼中將不再維護 sn 屬性的索引。若要節省磁碟空間，您也可以刪除對應的索引檔案，因為伺服器將再也用不到該檔案。在此範例中，您可以刪除下列檔案：
ServerRoot/slapd-serverID/db/databaseName/databaseName_sn.db3
重新編製尾碼索引
如果您的索引檔案毀損，您必須重新編製尾碼索引，在對應的資料庫目錄中重新建立索引檔案。使用 Directory Server Console 重新編製尾碼索引的方式有二：重新編製索引或重新初始化。
重新編製尾碼索引
當您重新編製尾碼索引時，伺服器會檢查它包含的所有項目，並重新建立索引檔案。重新編製索引期間，尾碼的內容仍可供讀取與寫入作業使用。但伺服器必須掃描每個已重新編製索引的整個尾碼。依您設定的索引而定，可能花費數小時重新編製數百萬個項目的尾碼。而且，在重新編製索引期間，索引將無法使用，伺服器效能會受到影響。
若要使用主控台重新編製尾碼索引：
- 在 Directory Server Console 最上層的 [組態] 標籤上，展開 [資料] 節點，顯示您要重新編製索引的尾碼。
- 以滑鼠右鍵按一下尾碼組態節點，再選擇快顯功能表中的 [重新索引]。或者，在節點上按一下滑鼠左鍵以選擇節點，再從 [物件] 功能表中選擇 [重新索引]。
出現 [重新索引尾碼] 對話方塊，列出所選尾碼上已編製索引的所有屬性清單。
- 選擇要重新編製索引的每個屬性旁的核取方塊。使用 [全部檢查] 和 [不檢查] 按鈕可幫您選擇項目。因為指定屬性的所有索引都儲存在同一個資料庫檔案中，您必須一起將它們全部重新編製索引。
- 按一下「確定」。主控台顯示確認訊息，說明重新編製索引過程中可能發生非預期的搜尋結果，以及對效能的影響等。
- 按一下 [是] 開始重新編製索引。
主控台顯示對話方塊，內含有關重新編製索引的任何訊息。完成後請關閉對話方塊。
若要從指令行重新編製尾碼索引，請依照「執行 db2index-task」中的指示進行，並指定所有要重新建立索引檔案的屬性。
重新初始化尾碼
當您重新初始化尾碼時，其內容會被取代，並在匯入新內容時建立新的索引檔案。重新初始化尾碼通常會比重新編製多於一個屬性的索引快，因為在載入項目的同時，只要一個階段即完成屬性的索引編製。但是在重新初始化期間，尾碼將無法使用。
以下所有步驟都可以使用 Directory Server Console 或從指令行執行：
- 依「設定存取權限及參照」所述將尾碼設為唯讀狀態。您必須先將尾碼設為無法寫入，這樣在匯出內容後才不會發生任何修改。
- 依「使用主控台將單一尾碼匯出到 LDIF」所述將整個尾碼匯出到 LDIF 檔案。
- 依「初始化尾碼」所述匯入同一個 LDIF 檔案，以重新初始化尾碼。
初始化期間，尾碼將無法使用。當初始化完成時，所有設定的索引將已準備好可供使用。
- 依「設定存取權限及參照」所述重新將尾碼設為可寫入。
修改預設索引組
建立新尾碼時所用的預設索引組是在下列項目下定義：
cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config
每當您使用主控台或從指令行建立尾碼時，就會依原狀複製預設索引定義，成為對應資料庫的初始索引組態。
預設索引組只可用指令行公用程式進行設定。預設索引項目的語法與「從指令行管理索引」中所述的索引組態項目完全一樣。例如，使用下列 ldapmodify 指令即可加入預設索引組態項目：
ldapmodify -a -h host -p port -D "cn=Directory Manager" -w password
dn:cn=drink,cn=default indexes,cn=config,cn=ldbm database,
cn=plugins,cn=config
objectClass:top
objectClass:nsIndex
cn:drink
nsSystemIndex:false
nsIndexType:eq
nsIndexType:sub
nsMatchingRule: 1.3.6.1.4.1.42.2.27.9.4.76.1
^D加入此項目後，任何新尾碼都會將 drink 屬性的值編製索引，以進行法文的相等和子字串搜尋。
若要修改或刪除預設索引項目，請使用 ldapmodify 或 ldapdelete 指令編輯 cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config 中的索引組。
管理瀏覽索引瀏覽索引是特殊的索引，只供要求伺服器端排序或虛擬清單檢視 (VLV) 結果的搜尋作業使用。對於要求將大量結果進行伺服器端排序的搜尋，使用瀏覽索引可以改善搜尋的效能。在未定義瀏覽索引時，伺服器可拒絕執行要求排序的搜尋要求 (依目錄組態而定)；以防止大量的排序作業導致伺服器資源負載過重。
瀏覽索引套用在作為搜尋基礎的項目，而且您必須為排序要求中使用的每一個搜尋條件各建立一個索引。例如，如果用戶端應用程式經常要求所有使用者的排序清單，您可以針對用戶端所用的篩選字串在 ou=People 上建立瀏覽索引。
就如同其他索引一樣，為維護瀏覽索引所需的更新作業過程中會有效能變慢的問題。您應該小心規劃並測試瀏覽索引的部署。
主控台的瀏覽索引
Directory Server Console 經常執行整個目錄的搜尋，以重新整理面板內容。如果您已依「樹狀目錄檢視選項」所述將主控台設成會排序樹狀目錄中的項目，您應該為主控台建立瀏覽索引。
主控台的瀏覽索引是主控台所執行的搜尋特有的。它們也是使用主控台來建立。若要為主控台建立瀏覽索引：
- 在 Directory Server Console 最上層的 [目錄] 標籤上，瀏覽樹狀目錄，以顯示必須排序的大型樹狀子目錄的父項，例如包含數千筆使用者項目的 ou=People,dc=example,dc=com。
- 以滑鼠右鍵按一下父項，再選擇快顯功能表中的 [建立瀏覽索引]。或者，以滑鼠左鍵按一下項目以選擇項目，再從 [物件] 功能表中選擇 [建立瀏覽索引]。
[建立瀏覽索引] 對話方塊顯示索引建立的狀態。主控台會建立以下所示的瀏覽索引組態項目，然後產生索引檔案的內容。
- 按一下 [關閉] 以關閉 [建立瀏覽索引] 對話方塊。
對於任何主控台重新整理作業，新索引會立即生效，而且加入目錄的任何新資料都將受到維護。您不需要重新啟動伺服器。
主控台的瀏覽索引組態由下列項目組成。vlvSearch 項目定義即將編製索引之搜尋的基礎、範圍與篩選。vlvIndex 項目 vlvSort 屬性顯示支援以其排序的順序排序的屬性：
dn:cn=MCC entryDN,cn=databaseName,cn=ldbm database,
cn=plugins,cn=config
objectClass:top
objectClass:vlvSearch
cn:MCC entryDN
vlvBase:"entryDN"
vlvScope: 1
vlvFilter:(|(objectclass=*)(objectclass=ldapsubentry))
dn:cn=by MCC entryDN, cn=MCC entryDN,cn=databaseName,
cn=ldbm database,cn=plugins,cn=config
objectClass:top
objectClass:vlvIndex
cn:by MCC entryDN
vlvSort:cn givenname o ou sn uid若要刪除 Directory Server Console 的瀏覽索引：
用戶端搜尋的瀏覽索引
排序用戶端搜尋結果的自訂瀏覽索引必須手動定義。從指令行建立瀏覽索引或虛擬清單檢視 (virtual list view, VLV) 包括兩個步驟：
指定瀏覽索引項目
瀏覽索引是指定基礎項目及其樹狀子目錄上的指定搜尋特有的。瀏覽索引組態定義於包含項目的尾碼的資料庫組態中。
有兩個可用於設定瀏覽索引的項目。第一個使用 vlvSearch 物件類別，並指定將編製索引之搜尋作業的基礎、範圍與篩選。第二個項目是第一個項目的子項，並使用 vlvIndex 物件類別指定要排序的屬性，以及排序的順序。
以下範例使用 ldapmodify 公用程式建立瀏覽索引組態項目：
ldapmodify -a -h host -p port -D "cn=Directory Manager" -w password
dn:cn=Browsing ou=People, cn=databaseName,
cn=ldbm database,cn=plugins,cn=config
objectClass:top
objectClass:vlvSearch
cn:Browsing ou=People
vlvbase:ou=People,dc=example,dc=com
vlvscope: 1
vlvfilter:(objectclass=inetOrgPerson)
dn:cn=Sort rev employeenumber, cn=Browsing ou=People,
cn=databaseName,cn=ldbm database,cn=plugins,cn=config
objectClass:top
objectClass:vlvIndex
cn:Sort rev employeenumber
vlvSort:-employeenumber
^Dvlvscope 可能是 0 代表僅限基礎項目、1 代表基礎的下一層子項或 2 代表以基礎為根部的整個樹狀子目錄。vlvfilter 是用戶端搜尋作業中即將使用的同一個 LDAP 篩選。因為所有瀏覽索引項目位於同一位置，您應該使用描述性的 cn 值為您的瀏覽索引命名。
每個 vlvSearch 項目必須至少擁有一個 vlvIndex 項目。vlvSort 屬性是定義排序屬性及排序順序的屬性名稱清單。屬性名稱前的虛線 (-) 指示反向排序。您可以定義數個 vlvIndex 項目，即可為搜尋定義多個索引。延續上個範例，您可以加入下列項目：
ldapmodify -a -h host -p port -D "cn=Directory Manager" -w password
dn:cn=Sort sn givenname uid, cn=Browsing ou=People,
cn=databaseName,cn=ldbm database,cn=plugins,cn=config
objectClass:top
objectClass:vlvIndex
cn:Sort sn givenname uid
vlvSort:sn givenname uid
^D若要修改瀏覽索引組態，請編輯對應的 vlvSearch 或 vlvIndex 項目。若要移除瀏覽索引，讓伺服器不再維護此索引，請移除個別的 vlvIndex 項目，或如果只有一個這類項目，請同時移除 vlvSearch 項目和 vlvIndex 項目。當您移除 vlvIndex 項目時，您也可以移除對應的資料庫檔案，例如：
ServerRoot/slapd-serverID/db/dbName/dbName_vlv#Sortsngivennameuid.db3
執行 vlvindex 指令
建立瀏覽索引項目或修改瀏覽索引項目後，您必須執行 directoryserver vlvindex 指令以產生新的瀏覽索引組。這個指令將掃描目錄內容，並為瀏覽索引建立資料庫檔案。
若要產生瀏覽索引，請使用下列指令：
以下範例會產生上一節定義的瀏覽索引：
# /usr/sbin/directoryserver vlvindex -n databaseName -T "Browsing ou=People"
表 10-4 範例中使用的 vlvindex 選項描述
選項
描述
-n
請指定含有需要索引項目的資料庫名稱。
-T
指定對應的瀏覽索引的 vlvSearch 項目的命名屬性值。將產生對應到指定 vlvSearch 項目的 vlvIndex 項目的所有索引。
如需詳細資訊，請參閱《Directory Server Administration Reference》Chapter 1 的 "vlvindex"。