前提條件

• 已初始化Client。具體操作，請(qǐng)參見初始化Client。

• 已創(chuàng)建數(shù)據(jù)表并寫入數(shù)據(jù)。具體操作，請(qǐng)參見創(chuàng)建數(shù)據(jù)表和寫入數(shù)據(jù)。

• 已在數(shù)據(jù)表上創(chuàng)建多元索引。具體操作，請(qǐng)參見創(chuàng)建多元索引。

地理距離查詢（GeoDistanceQuery）

GeoDistanceQuery根據(jù)一個(gè)中心點(diǎn)和距離條件查詢表中的數(shù)據(jù)，當(dāng)一個(gè)地理位置點(diǎn)到指定的中心點(diǎn)的距離不超過指定的值時(shí)，滿足查詢條件。

• 參數(shù)

  參數(shù)	說明
  tableName	數(shù)據(jù)表名稱。
  indexName	多元索引名稱。
  query	多元索引的查詢語句。設(shè)置查詢類型為TableStore.QueryType.GEO_DISTANCE_QUERY。
  fieldName	列名，類型為Geopoint。
  centerPoint	中心地理坐標(biāo)點(diǎn)，是一個(gè)經(jīng)緯度值。 格式為“緯度,經(jīng)度”，緯度在前，經(jīng)度在后，且緯度范圍為-90～+90，經(jīng)度范圍-180～+180。例如“35.8,-45.91”。
  distance	距離中心點(diǎn)的距離，類型為Double。單位為米。

• 示例

  以下示例用于查詢表中Col_GeoPoint列的值距離中心點(diǎn)不超過一定距離的數(shù)據(jù)。

  client.search({
      tableName: TABLE_NAME,
      indexName: INDEX_NAME,
      searchQuery: {
          offset: 0,
          limit: 10, //如果只為了獲取行數(shù)，無需獲取具體數(shù)據(jù)，可以設(shè)置limit=0，即不返回任意一行數(shù)據(jù)。
          query: { //設(shè)置查詢類型為TableStore.QueryType.GEO_DISTANCE_QUERY。
              queryType: TableStore.QueryType.GEO_DISTANCE_QUERY,
              query: {
                  fieldName: "Col_GeoPoint",
                  centerPoint: "1,1", //設(shè)置中心點(diǎn)。
                  distance: 10000 //設(shè)置條件為到中心點(diǎn)的距離不超過10000米。
              }
          },
          getTotalCount: true //結(jié)果中的TotalCount可以表示表中數(shù)據(jù)的總行數(shù)，默認(rèn)為false，表示不返回。
      },
      columnToGet: { //返回列設(shè)置，可設(shè)置為RETURN_SPECIFIED（自定義返回列）、RETURN_ALL（返回所有列）、RETURN_ALL_FROM_INDEX（返回多元索引中的所有列）、RETURN_NONE（不返回）。
          returnType: TableStore.ColumnReturnType.RETURN_ALL
      }
  }, function (err, data) {
      if (err) {
          console.log('error:', err);
          return;
      }
      console.log('success:', JSON.stringify(data, null, 2));
  });

地理長方形范圍查詢（GeoBoundingBoxQuery）

GeoBoundingBoxQuery根據(jù)一個(gè)長方形范圍的地理位置邊界條件查詢表中的數(shù)據(jù)，當(dāng)一個(gè)地理位置點(diǎn)落在給出的長方形范圍內(nèi)時(shí)滿足查詢條件。

• 參數(shù)

  參數(shù)	說明
  tableName	數(shù)據(jù)表名稱。
  indexName	多元索引名稱。
  query	多元索引的查詢語句。設(shè)置查詢類型為TableStore.QueryType.GEO_BOUNDING_BOX_QUERY。
  fieldName	列名，類型為Geopoint。
  topLeft	長方形框的左上角的坐標(biāo)。
  bottomRight	長方形框的右下角的坐標(biāo)，通過左上角和右下角就可以確定一個(gè)唯一的長方形。 格式為“緯度,經(jīng)度”，緯度在前，經(jīng)度在后，且緯度范圍為-90～+90，經(jīng)度范圍-180～+180。例如“35.8,-45.91”。

• 示例

  以下示例用于查詢表中Col_GeoPoint列的值在左上角為"10,0"，右下角為"0,10"的長方形范圍內(nèi)的數(shù)據(jù)。

  client.search({
      tableName: TABLE_NAME,
      indexName: INDEX_NAME,
      searchQuery: {
          offset: 0,
          limit: 10, //如果只為了獲取行數(shù)，無需獲取具體數(shù)據(jù)，可以設(shè)置limit=0，即不返回任意一行數(shù)據(jù)。
          query: { //設(shè)置查詢類型為TableStore.QueryType.GEO_BOUNDING_BOX_QUERY。
              queryType: TableStore.QueryType.GEO_BOUNDING_BOX_QUERY,
              query: {
                  fieldName: "Col_GeoPoint", //設(shè)置列名。
                  topLeft: "10,0", //設(shè)置長方形左上角。
                  bottomRight: "0,10" //設(shè)置長方形右下角。
              }
          },
          getTotalCount: true //結(jié)果中的TotalCount可以表示表中數(shù)據(jù)的總行數(shù)，默認(rèn)為false，表示不返回。
      },
      columnToGet: { //返回列設(shè)置，可設(shè)置為RETURN_SPECIFIED（自定義返回列）、RETURN_ALL（返回所有列）、RETURN_ALL_FROM_INDEX（返回多元索引中的所有列）、RETURN_NONE（不返回）。
          returnType: TableStore.ColumnReturnType.RETURN_ALL
      }
  }, function (err, data) {
      if (err) {
          console.log('error:', err);
          return;
      }
      console.log('success:', JSON.stringify(data, null, 2));
  });

地理多邊形范圍查詢（GeoPolygonQuery）

GeoPolygonQuery根據(jù)一個(gè)多邊形范圍條件查詢表中的數(shù)據(jù)，當(dāng)一個(gè)地理位置點(diǎn)落在指定的多邊形范圍內(nèi)時(shí)滿足查詢條件。

• 參數(shù)

  參數(shù)	說明
  tableName	數(shù)據(jù)表名稱。
  indexName	多元索引名稱。
  query	多元索引的查詢語句。設(shè)置查詢類型為TableStore.QueryType.GEO_POLYGON_QUERY。
  fieldName	列名，類型為Geopoint。
  points	組成多邊形的距離坐標(biāo)點(diǎn)。 格式為“緯度,經(jīng)度”，緯度在前，經(jīng)度在后，且緯度范圍為-90～+90，經(jīng)度范圍-180～+180。例如“35.8,-45.91”。

• 示例

  以下示例用于查詢表中Col_GeoPoint列的值在一個(gè)給定多邊形范圍內(nèi)的數(shù)據(jù)。

  client.search({
      tableName: TABLE_NAME,
      indexName: INDEX_NAME,
      searchQuery: {
          offset: 0,
          limit: 10, //如果只為了獲取行數(shù)，無需獲取具體數(shù)據(jù)，可以設(shè)置limit=0，即不返回任意一行數(shù)據(jù)。
          query: { //設(shè)置查詢類型為TableStore.QueryType.GEO_POLYGON_QUERY。
              queryType: TableStore.QueryType.GEO_POLYGON_QUERY,
              query: {
                  fieldName: "Col_GeoPoint",
                  points: ["0,0","5,5","5,0"] //設(shè)置多邊形的頂點(diǎn)。
              }
          },
          getTotalCount: true //結(jié)果中的TotalCount可以表示表中數(shù)據(jù)的總行數(shù)，默認(rèn)為false，表示不返回。
      },
      columnToGet: { //返回列設(shè)置，可設(shè)置為RETURN_SPECIFIED（自定義返回列）、RETURN_ALL（返回所有列）、RETURN_ALL_FROM_INDEX（返回多元索引中的所有列）、RETURN_NONE（不返回）。
          returnType: TableStore.ColumnReturnType.RETURN_ALL
      }
  }, function (err, data) {
      if (err) {
          console.log('error:', err);
          return;
      }
      console.log('success:', JSON.stringify(data, null, 2));
  });

常見問題

• 使用多元索引Search接口查不到數(shù)據(jù)

• 為什么使用多元索引翻頁查詢時(shí)Token失效了？

相關(guān)文檔

• 多元索引查詢類型包括精確查詢、多詞精確查詢、全匹配查詢、匹配查詢、短語匹配查詢、前綴查詢、范圍查詢、通配符查詢、多條件組合查詢、地理位置查詢、嵌套類型查詢、向量檢索和列存在性查詢，您可以選擇合適的查詢類型進(jìn)行多維度數(shù)據(jù)查詢。

  如果要對(duì)結(jié)果集進(jìn)行排序或者翻頁，您可以使用排序和翻頁功能來實(shí)現(xiàn)。具體操作，請(qǐng)參見排序和翻頁。

  如果要按照某一列對(duì)結(jié)果集做折疊，使對(duì)應(yīng)類型的數(shù)據(jù)在結(jié)果展示中只出現(xiàn)一次，您可以使用折疊（去重）功能來實(shí)現(xiàn)。具體操作，請(qǐng)參見折疊（去重）。

• 如果要進(jìn)行數(shù)據(jù)分析，例如求最值、求和、統(tǒng)計(jì)行數(shù)等，您可以使用Search接口的統(tǒng)計(jì)聚合功能或者SQL查詢來實(shí)現(xiàn)。具體操作，請(qǐng)參見統(tǒng)計(jì)聚合和SQL查詢。

• 如果要快速導(dǎo)出數(shù)據(jù)，而不關(guān)心整個(gè)結(jié)果集的順序時(shí)，您可以使用ParallelScan接口和ComputeSplits接口實(shí)現(xiàn)多并發(fā)導(dǎo)出數(shù)據(jù)。具體操作，請(qǐng)參見并發(fā)導(dǎo)出數(shù)據(jù)。