|
| |
| Sun Java(TM) System Directory Server 5.2 2005Q1 管理指南 | |
第 10 章
編製目錄資料索引Directory Server 的索引就像書本的索引頁一樣，藉由把要搜尋的字串跟目錄內容的參考產生關聯，可以加快搜尋的速度。索引是屬性值的表格，儲存在單獨的資料庫檔案內。目錄中 每個尾碼的索引建立與管理彼此獨立。一旦在尾碼配置中建立索引後，伺服器就會自動維護索引。
如需索引簡介、索引成本與效益、nsslapd-allidsthreshold 屬性說明以及提昇 Directory Server 效能的方法，請參閱 Directory Server Performance Tuning Guide。
本章包含下列章節：
編製索引概述每個尾碼的索引分別儲存在對應的資料庫目錄檔案內。每個索引檔案包含尾碼中為指定屬性定義的所有索引。例如，為一般名稱 (cn) 屬性維護的所有索引儲存在 databaseName_cn.db3 檔中。
當您初始化尾碼或使用本章所述的指令時，就會建立索引檔案。在用戶端搜尋作業與內部作業期間，伺服器會存取索引，以更快速地找到目錄中的項目。修改作業期間，目錄必須藉由更新索引檔案來更新目錄內容及維護索引。
Directory Server 支援下列索引類型：
Directory Server 為子字串編製索引，以便能夠在索引中找到要搜尋的最短雙字元子字串。因此，使用索引，(sn=*ab) 的搜尋能夠加快速度 (舉例而言)，但 (sn=*a) 的搜尋則不會。Directory Server 提供進一步的最佳化，允許對萬用字元前只有一個字元時進行起始的子字串搜尋。因此，在子字串索引可用時，也可以加速搜尋 (sn=a*)的速度，但不能加速搜尋 (sn=*a)) 的速度。如需關於子字串索引的詳細資訊，請參閱 Directory Server Performance Tuning Guide。
系統索引
系統索引是不得刪除或修改的索引。Directory Server 需要有這些索引才能正確有效率地運作。下表列出每個尾碼中自動建立的系統索引：
預設索引
當您在目錄中建立新尾碼時，伺服器會在對應的資料庫目錄中配置一組預設索引。您可以依編製索引的需要修改預設索引，但在取消配置索引之前，應該確定沒有任何伺服器外掛程式或您公司的其他伺服器會需要依靠該索引的屬性。
若要修改新尾碼建立時將使用的預設索引組，請參閱修改預設索引組。
下表列出 Directory Server 中預先配置的預設索引：
表 10-2 每個新尾碼的預設索引
屬性
Eq
Pres
Sub
目的
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 伺服器效能。參考的完整性外掛程式也會使用此索引。如需詳細資訊，請參閱維護參考完整性。
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 伺服器效能。參考的完整性外掛程式也會使用此索引。如需詳細資訊，請參閱維護參考完整性。
pipstatus
X
由 Sun Java System Server 所使用。
pipuid
X
由 Sun Java System Server 所使用。
seeAlso
X
改善 Sun Java System 伺服器效能。參考的完整性外掛程式也會使用此索引。如需詳細資訊，請參閱維護參考完整性。
sn
X
X
X
改善最常使用類型的使用者目錄搜尋效能。
telephoneNumber
X
X
X
改善最常使用類型的使用者目錄搜尋效能。
uid
X
改善 Sun Java System 伺服器效能。
uniquemember
X
改善 Sun Java System 伺服器效能。參考的完整性外掛程式也會使用此索引。如需詳細資訊，請參閱維護參考完整性。
屬性名稱快速參考表
下表列出所有具有主要或真實名稱以及別名的屬性。建立索引時，請確認使用主要名稱。
管理索引本節描述如何使用 Directory Server Console 和指令行為特定屬性建立及移除存在、相等、近似、子字串與國際索引。如需關於虛擬清單檢視 (VLV) 作業所需的獨立程序，請參閱管理瀏覽索引。
建立新索引前，請先衡量維護索引的成本與效益。請記住：
使用主控台管理索引
如果您計劃在許多屬性上修改或加入索引，您應該先將尾碼設為唯讀，再將其內容匯出到 LDIF。接著利用從 LDIF 檔案重新初始化尾碼的方式，將會比尾碼重新編製索引的速度快。
- 在 Directory Server Console 最上層的 [配置] 標籤上，展開 [資料] 節點，並選擇要編製索引的尾碼。然後選擇右面板上的 [索引] 標籤。
「系統索引」表不得修改。請在「額外索引」表中的屬性上加入、修改或移除索引。
- 若要在尚未編製索引的屬性上加入索引，請按一下 [加入屬性] 按鈕。在顯示的對話方塊中，選擇一或多個要編製索引的屬性，再按一下 [確定]。
新屬性出現在「額外索引」表中。
- 若要修改屬性的索引，請在「額外索引」表中選擇或取消選取要為該屬性維護之每種索引類型旁的核取方塊。
- 如果要為包含非英文值的屬性建立索引，請在 [對應規則] 欄位中輸入要使用之比較順序的 OID。
您可以用逗號分隔 (但不可以有空格) 列出多個 OID，來用多種語言為屬性編製索引。如需支援的語言環境清單，及其關聯比較順序的 OID，請參閱 Directory Server Administration 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，但也包括其他對應規則，如 CaseExactMatch。如需支援的語言環境清單，及其關聯比較順序的 OID，請參閱 Directory Server Administration Reference。
如需關於索引配置屬性的詳細資訊，請參閱 Directory Server Administration Reference。
備註
建立索引時，您應該永遠使用屬性的主要名稱 (不是屬性別名)。屬性的主要名稱為該模式中之屬性所列示的第一個名稱，例如 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 Man Page Reference。
刪除屬性的所有索引
如果要移除為屬性配置的所有索引，您可以移除其配置項目和資料庫檔案。例如，下列指令將取消配置 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 Man Page Reference。