免费看午夜无码福利专区,亚洲欧美成人精品视频,中国国产激情一区

使用CreateSearchIndex接口在數據表上創建一個多元索引。一個數據表支持創建多個多元索引。創建多元索引時，您需要將要查詢的字段添加到多元索引中，您還可以配置多元索引路由鍵、預排序等高級選項。

前提條件

已初始化Client。具體操作，請參見初始化OTSClient。
已創建數據表，并且數據表的最大版本數（max Versions）必須為1，數據生命周期（Time to Live）必須滿足如下條件中的任意一個。具體操作，請參見創建數據表。
- 數據表的數據生命周期為-1（數據永不過期）。
- 數據表的數據生命周期不為-1時，數據表為禁止更新狀態（即是否允許更新為否）。

注意事項

創建多元索引時，多元索引中字段的數據類型必須與數據表中字段的數據類型相匹配。更多信息，請參見基礎數據類型及映射。
如果要修改多元索引為指定數據生命周期（即取值不為-1），則您必須禁用數據表的UpdateRow更新寫入功能。同時多元索引的TTL值必須小于或等于數據表的TTL值。更多信息，請參見生命周期管理。

參數

創建多元索引時，需要指定數據表名稱（TableName）、多元索引名稱（IndexName）和索引的結構信息（IndexSchema），其中IndexSchema包含FieldSchemas（Index的所有字段的設置）、IndexSetting（索引設置）和IndexSort（索引預排序設置）。詳細參數說明請參見下表。

參數	說明
TableName	數據表名稱。
IndexName	多元索引名稱。
FieldSchemas	FieldSchema的列表，每個FieldSchema包含如下內容： FieldName（必選）：創建多元索引的字段名，即列名，類型為String。多元索引中的字段可以是主鍵列或屬性列。 FieldType（必選）：字段類型，類型為tablestore.FieldType_XXX。更多信息，請參見基礎數據類型及映射。 Array（可選）：是否為數組，類型為Boolean。如果設置為true，則表示該列是一個數組，在寫入時，必須按照JSON數組格式寫入，例如["a","b","c"]。由于Nested類型是一個數組，當FieldType為Nested類型時，無需設置此參數。 Index（可選）：是否開啟索引，類型為Boolean。默認為true，表示對該列構建倒排索引或者空間索引；如果設置為false，則不會對該列構建索引。 Analyzer（可選）：分詞器類型。當字段類型為Text時，可以設置此參數；如果不設置，則默認分詞器類型為單字分詞。關于分詞的更多信息，請參見分詞。 EnableSortAndAgg（可選）：是否開啟排序與統計聚合功能，類型為Boolean。只有EnableSortAndAgg設置為true的字段才能進行排序。關于排序的更多信息，請參見排序和翻頁。重要 Nested類型的字段不支持開啟排序與統計聚合功能，但是Nested類型內部的子列支持開啟排序與統計聚合功能。 Store（可選）：是否在多元索引中附加存儲該字段的值，類型為Boolean。開啟后，可以直接從多元索引中讀取該字段的值，而不必反查數據表，可用于查詢性能優化。 DateFormats（可選）：日期的格式，類型為String。當字段類型為Date時，必須設置此參數。更多信息，請參見日期時間類型。 EnableHighlighting（可選）：是否開啟查詢高亮功能，類型為Boolean。默認值為false，表示不開啟查詢高亮。如果要使用查詢高亮，請設置此參數為true。僅Text類型字段支持查詢高亮功能。關于查詢高亮的更多信息，請參見查詢高亮。重要目前此參數只支持通過表格存儲SDK進行配置。 VectorOptions（可選）：向量字段類型的屬性參數。當字段類型為Vector時，必須設置此參數。包括如下內容： DataType：向量數據類型。當前僅支持float32。如果有其他類型需求，請提交工單聯系我們。 Dimension：向量維度。關于維度限制說明請參見多元索引限制。 MetricType：向量之間距離度量的算法，支持歐氏距離（euclidean）、余弦相似度（cosine）、點積（dot_product）。歐氏距離（euclidean）：多維空間中兩個向量之間的直線距離。出于性能考慮，表格存儲中的歐氏距離算法未進行最后的平方根計算。歐氏距離的評分越大表示兩個向量的相似度越大。余弦相似度（cosine）：向量空間中兩個向量間夾角的余弦值。余弦相似度的評分越高表示兩個向量的相似度越大。常用于文本數據的相似度計算。點積（dot_product）：維度相同的兩個向量的對應坐標相乘，然后將結果相加。點積的評分越高標識兩個向量的相似度越大。關于如何選用距離度量算法的更多信息，請參見附錄：距離度量算法說明。
IndexSetting	索引設置，包含RoutingFields設置。 RoutingFields（可選）：自定義路由字段。可以選擇部分主鍵列作為路由字段，在進行索引數據寫入時，會根據路由字段的值計算索引數據的分布位置，路由字段的值相同的記錄會被索引到相同的數據分區中。
IndexSort	索引預排序設置，包含Sorters設置。如果不設置，則默認按照主鍵排序。說明含有Nested類型的索引不支持IndexSort，沒有預排序。 Sorters（必選）：索引的預排序方式，支持按照主鍵排序和字段值排序。關于排序的更多信息，請參見排序和翻頁。 PrimaryKeySort表示按照主鍵排序，包含如下設置： Order：排序的順序，可按升序或者降序排序，默認為升序。 FieldSort表示按照字段值排序，包含如下設置：只有建立索引且開啟排序與統計聚合功能的字段才能進行預排序。 FieldName：排序的字段名。 Order：排序的順序，可按照升序或者降序排序，默認為升序。 Mode：當字段存在多個值時的排序方式。
TimeToLive	可選參數，默認值為-1。數據生命周期（TTL），即數據的保存時間。當數據的保存時間超過設置的數據生命周期時，系統會自動清理超過數據生命周期的數據。數據生命周期至少為86400秒（一天）或-1（數據永不過期）。多元索引生命周期的使用方式，請參見生命周期管理。

示例

創建多元索引時使用默認配置

以下示例用于創建一個多元索引。該多元索引包含col_keyword（Keyword類型）、col_long（Long類型）和col_vector（Vector類型）三列。

func createSearchIndex(client *tablestore.TableStoreClient) {
    request := &tablestore.CreateSearchIndexRequest{}
    request.TableName = "<TABLE_NAME>"
    request.IndexName = "<SEARCH_INDEX_NAME>"
    request.IndexSchema = &tablestore.IndexSchema{
        FieldSchemas: []*tablestore.FieldSchema{
            {
                FieldName:        proto.String("col_keyword"),
                FieldType:        tablestore.FieldType_KEYWORD, // 字符串類型
                Index:            proto.Bool(true),
                EnableSortAndAgg: proto.Bool(true),
            },
            {
                FieldName:        proto.String("col_long"),
                FieldType:        tablestore.FieldType_LONG, // 數字類型
                Index:            proto.Bool(true),
                EnableSortAndAgg: proto.Bool(true),
            },
            {
                FieldName: proto.String("col_vector"),
                FieldType: tablestore.FieldType_VECTOR, // 向量類型
                Index:     proto.Bool(true),
                VectorOptions: &tablestore.VectorOptions{
                    VectorDataType:   tablestore.VectorDataType_FLOAT_32.Enum(),
                    Dimension:        proto.Int32(4), // 向量維度為4，相似度算法為點積
                    VectorMetricType: tablestore.VectorMetricType_DOT_PRODUCT.Enum(),
                },
            },
        },
    }
    _, err := client.CreateSearchIndex(request)
    if err != nil {
        fmt.Println("Failed to create searchIndex with error:", err)
        return
    }
}

創建多元索引時指定IndexSort

以下示例用于創建一個多元索引，同時指定索引預排序。該多元索引包含col1（Keyword類型）和col2（Long類型）兩列。

func createSearchIndex_withIndexSort(client *tablestore.TableStoreClient){
    request := &tablestore.CreateSearchIndexRequest{}
    request.TableName = "<TABLE_NAME>" //設置數據表名稱。
    request.IndexName = "<SEARCH_INDEX_NAME>" //設置多元索引名稱。

    schemas := []*tablestore.FieldSchema{}
    field1 := &tablestore.FieldSchema{
        FieldName: proto.String("col1"), //設置字段名，使用proto.String用于獲取字符串指針。
        FieldType: tablestore.FieldType_KEYWORD, //設置字段類型。
        Index:     proto.Bool(true), //設置開啟索引。
        EnableSortAndAgg: proto.Bool(true), //設置開啟排序與統計聚合功能。
    }
    field2 := &tablestore.FieldSchema{
        FieldName: proto.String("col2"),
        FieldType: tablestore.FieldType_LONG,
        Index:     proto.Bool(true),
        EnableSortAndAgg: proto.Bool(true),
    }

    schemas = append(schemas, field1, field2)
    request.IndexSchema = &tablestore.IndexSchema{
        FieldSchemas: schemas, //設置多元索引包含的字段。
        IndexSort: &search.Sort{ // 指定索引預排序。先按照col2升序，再按照col1降序排序。
            Sorters: []search.Sorter{
                &search.FieldSort{
                    FieldName: "col2",
                    Order:     search.SortOrder_ASC.Enum(),
                },
                &search.FieldSort{
                    FieldName: "col1",
                    Order:     search.SortOrder_DESC.Enum(),
                },
            },
        },
    }
    resp, err := client.CreateSearchIndex(request) //調用client創建多元索引。
    if err != nil {
        fmt.Println("error :", err)
        return
    }
    fmt.Println("CreateSearchIndex finished, requestId:", resp.ResponseInfo.RequestId)
}

創建多元索引時設置數據生命周期

重要

請確保數據表的更新狀態為禁止。

func createIndexWithTTL(client *tablestore.TableStoreClient) {
    request := &tablestore.CreateSearchIndexRequest{}
    request.TableName = "<TABLE_NAME>"
    request.IndexName = "<SEARCH_INDEX_NAME>"
    schemas := []*tablestore.FieldSchema{}
    field1 := &tablestore.FieldSchema{
        FieldName:        proto.String("col1"),         //設置字段名，使用proto.String用于獲取字符串指針。
        FieldType:        tablestore.FieldType_KEYWORD, //設置字段類型。
        Index:            proto.Bool(true),             //設置開啟索引。
        EnableSortAndAgg: proto.Bool(true),             //設置開啟排序與統計聚合功能。
    }
    field2 := &tablestore.FieldSchema{
        FieldName:        proto.String("col2"),
        FieldType:        tablestore.FieldType_LONG,
        Index:            proto.Bool(true),
        EnableSortAndAgg: proto.Bool(true),
    }
    schemas = append(schemas, field1, field2)
    request.IndexSchema = &tablestore.IndexSchema{
        FieldSchemas: schemas, //設置多元索引包含的字段。
    }
    request.TimeToLive = proto.Int32(3600 * 24 * 7) // 設置多元索引TTL為7天過期。
    resp, err := client.CreateSearchIndex(request)
    if err != nil {
       fmt.Println("error :", err)
       return
   }
    fmt.Println("createIndexWithTTL finished, requestId:", resp.ResponseInfo.RequestId)
}

創建多元索引時開啟查詢高亮

以下示例用于創建一個多元索引。該多元索引包含col_keyword（Keyword類型）、col_long（Long類型）、col_text（Text類型）和col_nested（Nested類型）四列，其中col_nested包括level1_text（Text類型）和level1_nested（Nested類型）兩個子列，level1_nested子列還包含了level2_text（Text類型）一個子列。同時為col_text列、col_nested中的level1_text列、col_nested.level1_nested中的level2_text列開啟查詢高亮功能。

func createSearchIndexwithHighlighting(client *tablestore.TableStoreClient) {
    request := &tablestore.CreateSearchIndexRequest{}
    request.TableName = "<TABLE_NAME>"
    request.IndexName = "<SEARCH_INDEX_NAME>"
    request.IndexSchema = &tablestore.IndexSchema{
        FieldSchemas: []*tablestore.FieldSchema{
            {
                FieldName:        proto.String("col_keyword"),
                FieldType:        tablestore.FieldType_KEYWORD, // 字符串類型。
                Index:            proto.Bool(true),
                EnableSortAndAgg: proto.Bool(true),
            },
            {
                FieldName:        proto.String("col_long"),
                FieldType:        tablestore.FieldType_LONG, // 數字類型。
                Index:            proto.Bool(true),
                EnableSortAndAgg: proto.Bool(true),
            },
            {//為非嵌套類型開啟查詢高亮功能。
                FieldName: proto.String("col_text"),
                FieldType: tablestore.FieldType_TEXT, // 可分詞字符串類型。
                Index:     proto.Bool(true),
                EnableSortAndAgg: proto.Bool(true),
                EnableHighlighting: proto.Bool(true),
            },
            {//為嵌套類型字段中的子列開啟查詢高亮功能。
                FieldName: proto.String("col_nested"),
                FieldType: tablestore.FieldType_NESTED,
                FieldSchemas: []*tablestore.FieldSchema{
                    {
                        FieldName:          proto.String("level1_text"),
                        FieldType:          tablestore.FieldType_TEXT,
                        Index:              proto.Bool(true),
                        EnableHighlighting: proto.Bool(true),
                    },
                    {
                        FieldName: proto.String("level1_nested"),
                        FieldType: tablestore.FieldType_NESTED,
                        FieldSchemas: []*tablestore.FieldSchema{
                            {
                                FieldName:          proto.String("level2_text"),
                                FieldType:          tablestore.FieldType_TEXT,
                                Index:              proto.Bool(true),
                                EnableHighlighting: proto.Bool(true),
                            },
                        },
                    },
                },
            },
        },
    }
    _, err := client.CreateSearchIndex(request)
    if err != nil {
        fmt.Println("Failed to create searchIndex with error:", err)
        return
    }
}

日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

創建多元索引