Apache Ignite SQL数据定义语言(DDL)详解

原创于 2025-06-09 09:05:30 发布

· 357 阅读

7 ·

版权

Apache Ignite SQL数据定义语言(DDL)详解

ignite Apache Ignite 项目地址: https://gitcode.com/gh_mirrors/ignite15/ignite

概述

Apache Ignite作为一个分布式内存计算平台，提供了完整的SQL支持。本文将深入解析Ignite中的数据定义语言(DDL)功能，帮助开发者更好地管理和操作分布式数据库结构。

CREATE TABLE命令

基本语法与功能

CREATE TABLE命令在Ignite中具有双重功能：

创建一个新的分布式缓存
在该缓存上定义一个SQL表

CREATE TABLE [IF NOT EXISTS] 表名 (
  列名 数据类型 [DEFAULT 默认值] [PRIMARY KEY],
  ...
  [, PRIMARY KEY (列名,...)]
) [WITH "参数名=参数值,..."]

关键参数解析

TEMPLATE：指定缓存模板，默认为PARTITIONED
- TEMPLATE=PARTITIONED：分区缓存
- TEMPLATE=REPLICATED：复制缓存
BACKUPS：设置分区备份数，默认为0
ATOMICITY：原子性模式
- ATOMIC：原子模式
- TRANSACTIONAL：事务模式
CACHE_GROUP：指定缓存所属的组
AFFINITY_KEY：设置亲和键，用于数据并置

实际应用示例

基础表示例

CREATE TABLE Person (
  id INT PRIMARY KEY,
  name VARCHAR,
  age INT
) WITH "backups=1,atomicity=transactional";

使用自定义键值类型

CREATE TABLE Employee (
  emp_id INT,
  dept_id INT,
  name VARCHAR,
  salary DOUBLE,
  PRIMARY KEY (emp_id, dept_id)
) WITH "KEY_TYPE=EmployeeKey,VALUE_TYPE=EmployeeValue";

非大写列名处理

CREATE TABLE Product (
  id INT,
  "prodName" VARCHAR,
  price DECIMAL,
  PRIMARY KEY (id)
);

ALTER TABLE命令

功能限制

当前Ignite仅支持以下操作：

添加列
删除列
修改日志配置

语法结构

ALTER TABLE [IF EXISTS] 表名 {
    ADD [COLUMN] {[IF NOT EXISTS] 列定义 | (列定义,...)}
  | DROP [COLUMN] {[IF EXISTS] 列名 | (列名,...)}
  | {LOGGING | NOLOGGING}
}

注意事项

删除列不会物理删除数据
不能删除主键列
如果列已索引，需要先手动删除索引
操作期间会短暂阻塞其他DDL操作

实用示例

-- 添加单列
ALTER TABLE Person ADD COLUMN email VARCHAR;

-- 添加多列
ALTER TABLE Employee ADD (address VARCHAR, phone VARCHAR);

-- 条件删除列
ALTER TABLE Product DROP COLUMN IF EXISTS obsolete_flag;

-- 禁用WAL日志
ALTER TABLE Orders NOLOGGING;

DROP TABLE命令

基本语法

DROP TABLE [IF EXISTS] 表名

重要特性

会同时删除底层缓存及其所有数据
操作期间会阻塞其他DDL操作
如果启用了持久化，变更会持久保存

CREATE INDEX命令

索引类型

普通索引：默认创建的B+树索引
空间索引：用于地理空间数据

语法详解

CREATE [SPATIAL] INDEX [[IF NOT EXISTS] 索引名] ON 表名
    (列名 [ASC|DESC],...)
    [(INLINE_SIZE 大小 | PARALLEL 并行度)]

关键参数

INLINE_SIZE：索引内联大小(字节)
- 优化查询性能
- 设为0可禁用内联(不推荐)
PARALLEL：并行创建索引的线程数
- 默认为CPU核心数的25%

创建示例

-- 基本索引
CREATE INDEX idx_person_name ON Person(name);

-- 降序索引
CREATE INDEX idx_employee_salary ON Employee(salary DESC);

-- 空间索引
CREATE SPATIAL INDEX idx_city_geom ON City(geometry);

-- 带参数的索引
CREATE INDEX idx_product_composite ON Product(category, price) 
  WITH "INLINE_SIZE=64,PARALLEL=4";