CREATE：創(chuàng)建一個(gè)集合

/admin/collections?action=CREATE&name=name

創(chuàng)建參數(shù)

CREATE操作允許以下參數(shù)：

• name
  

  要?jiǎng)?chuàng)建的集合的名稱(chēng)。該參數(shù)是必需的。

• router.name
  

  將使用的路由器名稱(chēng)。路由器定義文件如何在碎片之間分配?？赡艿闹凳?code>implicit或者 compositeId，這是默認(rèn)值。

  該implicit路由器不會(huì)自動(dòng)將文檔路由到不同的碎片。無(wú)論您在索引請(qǐng)求中（或在每個(gè)文檔中）指明的分片都將被用作這些文檔的目標(biāo)。

  該compositeId路由器對(duì) uniqueKey 字段中的值進(jìn)行哈希處理，并在集合的 clusterstate 中查找該哈希，以確定哪些碎片會(huì)收到該文件，并具有手動(dòng)引導(dǎo)路由的額外功能。

  使用implicit路由器時(shí)，該shards參數(shù)是必需的。使用compositeId路由器時(shí)，該numShards參數(shù)是必需的。

  有關(guān)更多信息，另請(qǐng)參閱文檔路由一節(jié)。

• numShards
  

  要作為集合的一部分創(chuàng)建的分片的數(shù)量。當(dāng)router.name是compositeId時(shí)，這是一個(gè)必需的參數(shù)。

• shards
  

  以逗號(hào)分隔的分片名稱(chēng)列表，例如shard-x,shard-y,shard-z。當(dāng)router.name是implicit時(shí)，這是一個(gè)必需的參數(shù)。

• replicationFactor
  

  要為每個(gè)分片創(chuàng)建的副本數(shù)量。默認(rèn)是1。這將創(chuàng)建一個(gè)NRT類(lèi)型的副本。如果您需要其他類(lèi)型的副本，請(qǐng)參閱tlogReplicas和pullReplica參數(shù)。有關(guān)副本類(lèi)型的更多信息，請(qǐng)參閱副本類(lèi)型。

• nrtReplicas
  

  為此集合創(chuàng)建的NRT（近實(shí)時(shí)）副本的數(shù)量。這種副本維護(hù)一個(gè)事務(wù)日志，并在本地更新其索引。如果你想要所有的副本都是這種類(lèi)型的，你可以直接使用replicationFactor。

• tlogReplicas
  

  要為此集合創(chuàng)建的TLOG副本的數(shù)量。這種副本維護(hù)一個(gè)事務(wù)日志，但只通過(guò)從leader的副本來(lái)更新其索引。有關(guān)副本類(lèi)型的更多信息，請(qǐng)參閱副本類(lèi)型。

• pullReplicas
  

  為此集合創(chuàng)建的PULL副本的數(shù)量。這種類(lèi)型的副本不維護(hù)事務(wù)日志，只通過(guò)從leader的副本來(lái)更新其索引。這種類(lèi)型沒(méi)有資格成為leader，不應(yīng)該是集合中唯一的副本。有關(guān)副本類(lèi)型的更多信息，請(qǐng)參閱副本類(lèi)型。

• maxShardsPerNode
  

  創(chuàng)建集合時(shí)，分片或副本分布在所有可用（即活動(dòng)）節(jié)點(diǎn)上，并且同一分片的兩個(gè)副本永遠(yuǎn)不會(huì)在同一個(gè)節(jié)點(diǎn)上。

  如果一個(gè)節(jié)點(diǎn)在調(diào)用CREATE操作時(shí)不存在，它將不會(huì)獲得新集合的任何部分，這可能會(huì)導(dǎo)致在單個(gè)活動(dòng)節(jié)點(diǎn)上創(chuàng)建太多副本。定義maxShardsPerNode對(duì)CREATE操作將傳播到每個(gè)節(jié)點(diǎn)的副本數(shù)量設(shè)置限制。

  如果整個(gè)集合不能適應(yīng)實(shí)時(shí)節(jié)點(diǎn)，則根本不會(huì)創(chuàng)建任何集合。默認(rèn)maxShardsPerNode值是1。

• createNodeSet
  

  允許定義節(jié)點(diǎn)來(lái)傳播新的集合。格式是以逗號(hào)分隔的node_name列表，例如localhost:8983_solr,localhost:8984_solr,localhost:8985_solr。

  如果未提供，則CREATE操作將在所有的活動(dòng) Solr 節(jié)點(diǎn)上創(chuàng)建碎片副本。

  或者，使用特殊值EMPTY在新集合中初始創(chuàng)建無(wú)碎片副本，然后使用ADDREPLICA操作在需要時(shí)添加分片副本。

• createNodeSet.shuffle
  

  控制是否為該集合創(chuàng)建的分片副本將按照順序分配給由createNodeSet所指定的節(jié)點(diǎn)，或者在創(chuàng)建單個(gè)副本之前應(yīng)該對(duì)節(jié)點(diǎn)列表進(jìn)行分配。

  一個(gè)false值，使得集合創(chuàng)造可預(yù)見(jiàn)的結(jié)果，并對(duì)單個(gè)碎片副本的位置提供更精確的控制，但如果為true可以確保副本跨節(jié)點(diǎn)分布均勻更好的選擇。默認(rèn)是true。

  如果createNodeSet沒(méi)有指定，則忽略此參數(shù)。

• collection.configName
  

  定義用于此集合的配置的名稱(chēng)（必須已經(jīng)存儲(chǔ)在ZooKeeper中）。如果沒(méi)有提供，Solr將默認(rèn)為集合名稱(chēng)作為配置名稱(chēng)。

• router.field
  

  如果指定了這個(gè)參數(shù)，則路由器將查看輸入文檔中字段的值來(lái)計(jì)算哈希，并標(biāo)識(shí)分片而不是查看uniqueKey字段。如果文檔中指定的字段為空，則文檔將被拒絕。

  請(qǐng)注意，通過(guò)文檔ID實(shí)時(shí)獲取或檢索也需要參數(shù)_route_（或shard.keys）來(lái)避免分布式搜索。

• property.name=value
  

  將核心屬性名稱(chēng)設(shè)置為值。有關(guān)受支持的屬性和值的詳細(xì)信息，請(qǐng)參閱定義core.properties一節(jié)。

• autoAddReplicas
  

  設(shè)置為true時(shí)，僅允許在共享文件系統(tǒng)（如HDFS）上自動(dòng)添加副本。有關(guān)設(shè)置和覆蓋的更多詳細(xì)信息，請(qǐng)參閱autoAddReplicas設(shè)置一節(jié)。默認(rèn)值是false。

• async
  

  請(qǐng)求ID來(lái)跟蹤這個(gè)將被異步處理的動(dòng)作。

• rule
  

  副本放置規(guī)則。有關(guān)詳細(xì)信息，請(qǐng)參閱基于規(guī)則的副本放置部分。

• snitch
  

  snitch 提供者的細(xì)節(jié)。有關(guān)詳細(xì)信息，請(qǐng)參閱基于規(guī)則的副本放置部分。

• policy
  

  集合級(jí)別策略的名稱(chēng)。有關(guān)詳細(xì)信息，請(qǐng)參閱定義集合特定的策略

創(chuàng)建響應(yīng)

響應(yīng)將包括請(qǐng)求的狀態(tài)和新的核心名稱(chēng)。如果狀態(tài)不是“success”，則會(huì)顯示錯(cuò)誤消息，說(shuō)明請(qǐng)求失敗的原因。

使用CREATE的例子

輸入：

http://localhost:8983/solr/admin/collections?action=CREATE&name=newCollection&numShards=2&replicationFactor=1

輸出：

<response>
  <lst name="responseHeader">
    <int name="status">0</int>
    <int name="QTime">3764</int>
  </lst>
  <lst name="success">
    <lst>
      <lst name="responseHeader">
        <int name="status">0</int>
        <int name="QTime">3450</int>
      </lst>
      <str name="core">newCollection_shard1_replica1</str>
    </lst>
    <lst>
      <lst name="responseHeader">
        <int name="status">0</int>
        <int name="QTime">3597</int>
      </lst>
      <str name="core">newCollection_shard2_replica1</str>
    </lst>
  </lst>
</response>