Azure Cosmos DB for Apache Cassandra 中的次要索引編制

  • 發行項

適用於： Cassandra

Azure Cosmos DB 中的 API for Cassandra 利用基礎索引結構來公開平台中固有的索引編製強度。 不過，不同於核心 API for NoSQL，Azure Cosmos DB 中的 API for Cassandra 不會預設編製所有屬性的索引。 而是支援使用次要索引編製來建立特定屬性的索引，其行為方式與 Apache Cassandra 相同。

一般情況下，不建議在未分割的資料行上執行篩選查詢。 您必須明確使用 ALLOW FILTERING 語法，而這可能會導致某項作業無法順利執行。 在 Azure Cosmos DB 中，您可以對低基數屬性執行這類查詢，因為這些查詢會在資料分割區之間展開以擷取結果。

不建議您對經常更新的資料行建立索引。 在定義資料表時建立索引是明智的做法。 這可確保資料和索引處於一致的狀態。 如果您對現有的資料建立新索引，目前無法追蹤資料表的索引進度變更。 如果您需要追蹤此作業的進度，必須透過支援票證索取進度變更資訊。

注意

次要索引只能使用本文所提及的 CQL 命令來建立，而不是透過資源提供者公用程式 (ARM 範本、Azure CLI、PowerShell 或 Terraform)。 下列物件不支援次要索引：

  • 凍結集合類型、十進位和變體類型等資料類型。
  • 靜態資料行
  • 群集索引鍵

警告

在 API for Cassandra 中，預設不會編制分割區索引鍵的索引。 如果您的資料表中有複合主索引鍵，而且您同時篩選分割區索引鍵和叢集索引鍵，或只篩選分割區索引鍵，這將提供所需的行為。 不過，如果您篩選分割區索引鍵和叢集索引鍵以外的任何其他非索引欄位，這會導致分割區索引鍵展開，即使其他非索引欄位具有次要索引也會導致相同問題。 如果您的資料表中有複合主索引鍵，而您想要同時篩選複合主索引鍵的分割區索引鍵值元素及其他非分割區索引鍵或叢集索引鍵的欄位，請確定您已明確對分割區索引鍵新增次要索引。 此案例中的索引應會大幅改善查詢效能，即使其他非分割區索引鍵和非叢集索引鍵欄位沒有索引也一樣。 如需詳細資訊，請參閱有關資料分割的文章。

編製索引範例

首先，在 CQL 殼層提示字元中執行下列命令，建立 Keyspace 範例和資料表：

CREATE KEYSPACE sampleks WITH REPLICATION = {'class' : 'SimpleStrategy'};
CREATE TABLE sampleks.t1(user_id int PRIMARY KEY, lastname text) WITH cosmosdb_provisioned_throughput=400;

然後，使用下列命令插入使用者資料範例：

insert into sampleks.t1(user_id,lastname) values (1, 'nishu');
insert into sampleks.t1(user_id,lastname) values (2, 'vinod');
insert into sampleks.t1(user_id,lastname) values (3, 'bat');
insert into sampleks.t1(user_id,lastname) values (5, 'vivek');
insert into sampleks.t1(user_id,lastname) values (6, 'siddhesh');
insert into sampleks.t1(user_id,lastname) values (7, 'akash');
insert into sampleks.t1(user_id,lastname) values (8, 'Theo');
insert into sampleks.t1(user_id,lastname) values (9, 'jagan');

如果您嘗試執行下列陳述式，將會出現錯誤訊息，要求您使用 ALLOW FILTERING：

select user_id, lastname from sampleks.t1 where lastname='nishu';

雖然 API for Cassandra 支援 ALLOW FILTERING，如上一節所述，但不建議使用。 您應改為建立索引，如下列範例所示：

CREATE INDEX ON sampleks.t1 (lastname);

在 [lastname] 欄位上建立索引之後，現在可以成功執行先前的查詢。 在 Azure Cosmos DB 中使用 API for Cassandra，您不需要提供索引名稱。 系統會使用格式為 tablename_columnname_idx 的預設索引。 例如， t1_lastname_idx 是上一個資料表的索引名稱。

卸除索引

若要卸除索引，您需知道索引的名稱。 執行 desc schema 命令，取得資料表的描述。 此命令的輸出會包含格式為 CREATE INDEX tablename_columnname_idx ON keyspacename.tablename(columnname) 的索引名稱。 接著您可以使用索引名稱來卸除索引，如下列範例所示：

drop index sampleks.t1_lastname_idx;

下一步