CQL语句

CQL中默认忽略大小写，若需要大小写敏感，可使用双引号将对象包起来，引用的时候也要用双引号包住

tips: 使用CQL需要预装Python环境

Ⅰ、基本知识点

1.1 数据类型

这边和关系型数据库相近的就不列出来了，只列出Cassandra特色的，重要的

CQL类型	常用类型	说明
list(T)	n/a	有序集合，T可以是任意分集合CQL数据类型，例如，int，text等
map(K,V)	n/a	哈希表，K和V可以是任意非集合CQL数据类型，例如，int，text等
set(T)	n/a	无序集合，T可以是任意分集合CQL数据类型，例如，int，text等

1.2 命名规则

字母或数字开头，满足正则表达式[a-zA-Z0-9_]*

1.3 注释

• 单行注释：//或者-
• 多行注释：/** xxx **/

1.4 关键字和保留字

定义column和keyspace时候不能使用关键字和保留字，一定要用可以使用双引号包起来，但不建议这么用

具体的关键字和保留字见官网表格

Ⅱ、数据定义语句

2.1 KeySpace

语法：create keyspace (if not exists)? <identifier> with <properties>;
注意：identifier长度需要小于等于32，默认大小写不敏感，可以使用双引号让它对大小写敏感
create keyspace test 
with replication = {'class':'SimpleStrategy', 'replication_factor': 3} 
and durable_writes = true;

查看当前所有KeySpace
desc keyspaces;

查看KeySpace的创建语句
desc <identifier>;

修改KeySpace
alter keyspace <identifier> with <properties>;

切换KeySpace
use <identifier>;

删除名为teset的KeySpace
drop keyspace (if exsits)? <identifier>;

create keyspace的两个属性

• replication

复制策略(SimpleStrategy(单一数据中心，测试用)，NetworkTopologyStrategy(默认，强烈推荐，方便数据扩展)，OldNetworkTopologyStrategy(官方已弃用))
这个属性是强制的，至少包括class属性，其他属性依class改变，replication决定了多节点的情况下，新写入的数据如何在节点之间复制保存
replication_factor属性，他是SimpleStrategy这种策略的一个属性，叫做副本因子，决定了每个row有多少个副本，这个值不可以超过节点数

• durable_writes

是否使用commit log持久化写入，默认为true

2.2 Column Family

语法：create (table|columnfamily) (if not exists)? <tablename>
	'('<column-definition>(','<column-definiton>)*')'
	(with<option>(and <option>)*)?;

一般把第一个column作为primary key，当作行的标识，也就是row key，也可以指定多个列组成复合键

create table timeline(
	userid uuid,
	posted_month int,
	poster_time uuid,
	body text,
	poster_by text,
	primary key(userid, posted_month, posted_time)
)with compaction = {'class':'LeveldCompactionStrategy'};

查看column family的创建语句
desc <tablename>;

修改column family
alter (table|columnfamily)<tablename><instruction>;

alter table table_name
add columnname varchar;

alter table table_name
drop columnname;

alter table table_name
with comment = 'xxx'
and read_repair_chance = 0.2;

alter table table_name
rename old_column_name to new_column_name;

下面这种修改column数据类型的语法新版本已不再支持
alter table table_name
alter column_name type uuid;

删除column family
drop table (if exists)? <tablename>;

清空column family
truncate <tablename>;

column family的属性

接在with后面，了解即可

属性	说明
commnet	对column family的描述信息
bloom_filter_fp_chance	指定bloom_filter算法的容错率，一般设置为0.01或者0.1
caching	设置缓存方案
compactioin	数据压缩策略
compression	数据压缩算法
default_time_to_live	存活时间，单位是秒，默认0(永久存活)
memtable_flush_period_in_ms	内存数据刷新时间间隔
read_repair_chance	0-1之间的数值，与数据一致性有关

注意

• create table也可以写成create columnfamily，但建议使用前者
• 可使用if not exists规避错误
• 名字和keyspace一样不能超过32个字符
• 可使用create table keyspace.tablename在指定keyspace中创建，不指定则代表在当前keyspace创建

2.3 create index

语法：create (custom)? index (if not exists)? (<indexname>)?
	on <tablename> '('<index-identifier>')'
	(using<string>(with options=<map-literal>)?)?;
	
create index idx_name on columnfamily_name(column_name);
create index on columnfamily_name(column_name); 给一个默认idx_name
create index on columnfamily_name(keys(column_name)); 针对map类型column的键值进行索引
create custom index on columnfamily_name(column_name) using 'path.to.the.IndexClass';
create custom index on columnfamily_name(column_name) using 'path.to.the.IndexClass' with options = {'storage':'/mnt/ssd/indexes'};

删除index
drop index(if exsists)?(<keyspace>'.')?<identifier>;

2.4 create type

语法：create type (if not exists)? <typename>
	'('<field-definition>(',' <field-definiton>)*')';
	
修改type
alter type <typename> <instruction>;

alter type type_name alter zip type varint;
alter type type_name add xxx text;
alter type type_name rename old_name to new_name and old2_name to new2_name;

查看当前所有自定义type
desc types;

查看指定type信息
desc type type_name;

删除type
drop type (if exsists)? <typename>;
注意：如果type还在使用，drop会报错

Ⅲ、数据操作语句

3.1 增删改

INSERT
insert into <tablename>
'('<identifier>(',' <identifier>)*')'
values '('<term-or-literal>(',' <term-or-literal>)*')'
(if not exists)?
(using <option> (AND <option>)*)?

using ttl 86400	表示这行数据过了86400秒自动删除
cassandra中没有duplicate，插入数据的主键已经存在，则会将老数据直接覆盖

UPDATE
update <tablename>
(using <option> (AND <option>*))?
set <assignment> (',' <assignment>)*
where <where-clause>
(if <condition> (AND condition)*)?

update的using语句是放在set之前，不在最后，这点要和insert区别

DELETE
delete (<selection> (',' <selection>)*)?
from <tablename>
(using timestamp <integer>)?
where <where-clause>
(if (exists|(<condition> (AND <condition>)*)))?

delete from column_family_name where column_name = xxx;
delete column_name from column_family_name where column_name = xxx;

BATCH 批量操作，要么全部成功，要么全部失败
begin (unlogged|counter) batch
(using <option> (and <options>)*)?
<modification_statement> (';' <modification_statement>)* 
apply batch

3.2 查询

语法：
select <select-clause>
from <tablename>
(where <where-clause>)?
(order by <order-by>)?
(limit <integer>)?
(allow filtering)?

select column_name from column_family_name where column_name in (xxx,xxx,xxx);
select column_name as xxx from column_family_name;
select column_name from column_family_name where column_name = 'xxx' and column_name > 'xxx';
select count(*) from column_family_name;
select count(*) as xxx from column_family_name;

select注意点

• 可以使用count计算函数，目前唯一一个函数
• 可以使用limit关键字限制返回行数
• where中出现的column必须是primary key中的第一个列，或者是建立了索引的column，若两者都不满足，则须在结尾加上allow filtering关键字
• 通常primary key中指定的第一个column叫parition key，它对数据在节点上的分布起关键作用
• where中对于类型为set/list的column可以使用contains关键字，对于类型为map的column可以使用contains key关键字，对于partition key可以用in关键字
• 集合类型不能用作primary key，但是可以create index