集合索引是提取集合中文件資料的虛擬資料行上的普通 MySQL 索引。因為 MySQL 無法直接為 JSON 值建立索引，為了能夠為集合建立索引，您必須提供 JSON 文件，其中指定索引要使用的文件欄位。您將定義索引的 JSON 文件當作 IndexDefinition 參數傳遞給 Collection.createIndex(name, IndexDefinition) 方法。此通用範例（針對不同的程式設計語言，實際語法可能會有所不同）示範如何根據 count 欄位建立強制整數類型索引

myCollection.createIndex("count", {fields:[{"field": "$.count", "type":"INT", required:true}]});

此範例示範如何根據文字欄位（在此情況下為郵遞區號）建立索引。針對文字欄位，您必須指定索引的前置長度，這是 MySQL Server 的要求

myCollection.createIndex("zip", {fields: [{field: "$.zip", type: "TEXT(10)"}]})

如需關於 IndexDefinition 格式和索引支援的欄位類型資訊，請參閱定義索引。

如果已存在相同名稱的索引，或索引定義格式不正確，Collection.createIndex() 方法會失敗並產生錯誤。name 參數為必要參數，且必須是 SQL 陳述式 CREATE INDEX 接受的有效索引名稱。

若要移除現有索引，請使用 collection.dropIndex(string name) 方法。這會刪除具有傳入名稱的索引，且如果指定的索引不存在，則作業會靜默成功。

集合的索引會儲存為虛擬資料行。若要驗證已建立的索引，請使用 SHOW INDEX 陳述式。例如，從 MySQL Shell 使用此 SQL

session.runSql('SHOW INDEX FROM mySchema.myCollection');

若要根據集合中的文件建立索引，您需要建立 IndexDefinition JSON 文件。本節說明您可以在此類 JSON 文件中使用哪些有效的欄位來定義索引。

若要定義要為其建立索引的集合文件欄位，該欄位的類型在整個集合中必須是一致的。換句話說，類型必須一致。用於定義索引的 JSON 文件，例如 {fields: [{field: '$.username', type: 'TEXT'}]}，可以包含下列內容

在 IndexDefinition 或 IndexField JSON 文件中包含任何未在上述說明的其他欄位，都會導致 collection.createIndex() 失敗並產生錯誤。

如果未指定索引類型或設定為 INDEX，則建立的索引方式與發出 CREATE INDEX 的方式相同。如果索引類型設定為 SPATIAL，則建立的索引與發出帶有 SPATIAL 關鍵字的 CREATE INDEX 所建立的索引相同，請參閱SPATIAL 索引最佳化和建立空間索引。例如

myCollection.createIndex('myIndex', //
{fields: [{field: '$.myGeoJsonField', type: 'GEOJSON', required: true}], type:'SPATIAL'})

以下範例示範如何根據多個欄位建立索引

myCollection.createIndex('myIndex', {fields: [{field: '$.myField', type: 'TEXT'}, //
{field: '$.myField2', type: 'TEXT(10)'}, {field: '$.myField3', type: 'INT'}]})

索引欄位的值會使用標準 MySQL 類型轉換（請參閱運算式評估中的類型轉換）從 JSON 轉換為 IndexField 描述中指定的類型，但 GEOJSON 類型除外，該類型使用 ST_GeomFromGeoJSON() 函數進行轉換。這表示當在 IndexField 描述中使用數值類型時，非數值的實際欄位值會轉換為 0。

IndexField 中的 options 和 srid 欄位只有在 type 設定為 GEOJSON 時才能存在。如果存在，則在將 GEOJSON 資料轉換為 MySQL 原生 GEOMETRY 值時，會將它們用作 ST_GeomFromGeoJSON() 的參數。

文件欄位支援下列資料類型。在 type 欄位中使用類型名稱時，不區分大小寫。

X DevAPI 支援根據陣列欄位建立索引，方法是在 IndexField 描述中將布林值 array 欄位設定為 true。例如，要在 emails 陣列欄位上建立索引：

collection.createIndex("emails_idx", //
    {fields: [{"field": "$.emails", "type":"CHAR(128)", "array": true}]});

以下限制適用於根據陣列建立索引：