快速体验
快速部署仅适用于本地开发。请勿将该种部署方式用于生产环境:
-
使用 Docker 方式快速部署,当 Docker 实例销毁时,相应的数据也会释放。
-
通过手动部署单副本 Doris 实例,不具有数据多副本存储能力,单台机器宕机可能会造成数据丢失。
-
本示例中的建表均为单副本,在生产中请使用多副本存储数据。
使用 Docker 快速部署
第 1 步:创建 docker-compose.yaml 文件
复制以下内容到 docker-compose.yaml,替换 DORIS_QUICK_START_VERSION 参数为指定版本,如 3.0.1
。
version: "3"
services:
fe:
image: apache/doris.fe-ubuntu:${DORIS_QUICK_START_VERSION}
hostname: fe
environment:
- FE_SERVERS=fe1:127.0.0.1:9010
- FE_ID=1
network_mode: host
be:
image: apache/doris.be-ubuntu:${DORIS_QUICK_START_VERSION}
hostname: be
environment:
- FE_SERVERS=fe1:127.0.0.1:9010
- BE_ADDR=127.0.0.1:9050
depends_on:
- fe
network_mode: host
第 2 步:启动集群
使用 docker-compose 命令启动集群
docker-compose -f ./docker-compose.yaml up -d
第 3 步:使用 MySQL 客户端连接集群,并检查集群状态
## 检查 FE 状态,确定 Join 与 Alive 列都为 true
mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `join`, `alive` FROM frontends()'
+-----------+------+-------+
| host | join | alive |
+-----------+------+-------+
| 127.0.0.1 | true | true |
+-----------+------+-------+
## 检查 BE 状态,确定 Alive 列为 true
mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `alive` FROM backends()'
+-----------+-------+
| host | alive |
+-----------+-------+
| 127.0.0.1 | 1 |
+-----------+-------+
本地快速部署
-
选择一个 AMD/ARM 上的主流 Linux 环境,推荐 CentOS 7.1 或者 Ubuntu 16.04 以上版本。更多运行环境请参考安装部署部分。
-
Java 8 运行环境(非 Oracle JDK 商业授权用户,建议使用免费的 Oracle JDK 8u300 以后版本,立即下载)。
-
建议在 Linux 上新建一个 Doris 用户。请避免使用 Root 用户,以防对操作系统误操作。
第 1 步:下载二进制包
从 Apache Doris 网站上下载相应的二进制安装包,并解压。
第 2 步:修改环境变量
-
修改系统最大打开文件句柄数
通过以下命令可以调整最大文件句柄数。在调整后,需要重启会话以生效配置:
vi /etc/security/limits.conf
* soft nofile 1000000
* hard nofile 1000000 -
修改虚拟内存区域
通过以下命令可以永久修改虚拟内存区域至少为 2000000,并立即生效:
cat >> /etc/sysctl.conf << EOF
vm.max_map_count = 2000000
EOF
Take effect immediately
sysctl -p
第 3 步:安装 FE
-
配置 FE
修改 FE 配置文件
apache-doris/fe/conf/fe.conf
的以下内容:## 指定 Java 环境
JAVA_HOME=/home/doris/jdk
# 指定 FE 监听 IP 的 CIDR 网段
priority_networks=127.0.0.1/32 -
启动 FE
通过 start_fe.sh 脚本运行 FE 进程:
apache-doris/fe/bin/start_fe.sh --daemon
-
检查 FE 状态
使用 MySQL 客户端连接集群,并检查集群状态:
## 检查 FE 状态,确定 Join 与 Alive 列都为 true
mysql -uroot -P9030 -h127.0.0.1 -e "show frontends;"
+-----------------------------------------+-----------+-------------+----------+-----------+---------+----------+----------+-----------+------+-------+-------------------+---------------------+----------+--------+-------------------------+------------------+
| Name | Host | EditLogPort | HttpPort | QueryPort | RpcPort | Role | IsMaster | ClusterId | Join | Alive | ReplayedJournalId | LastHeartbeat | IsHelper | ErrMsg | Version | CurrentConnected |
+-----------------------------------------+-----------+-------------+----------+-----------+---------+----------+----------+-----------+------+-------+-------------------+---------------------+----------+--------+-------------------------+------------------+
| fe_9d0169c5_b01f_478c_96ab_7c4e8602ec57 | 127.0.0.1 | 9010 | 8030 | 9030 | 9020 | FOLLOWER | true | 656872880 | true | true | 276 | 2024-07-28 18:07:39 | true | | doris-2.0.12-2971efd194 | Yes |
+-----------------------------------------+-----------+-------------+----------+-----------+---------+----------+----------+-----------+------+-------+-------------------+---------------------+----------+--------+-------------------------+------------------+
第 4 步:安装 BE
-
配置 BE
修改 BE 配置文件
apache-doris/be/conf/be.conf
的以下内容:## 指定 Java 环境
JAVA_HOME=/home/doris/jdk
# 指定 FE 监听 IP 的 CIDR 网段
priority_networks=127.0.0.1/32 -
启动 BE
通过以下命令启动 BE 进程:
apache-doris/fe/bin/start_be.sh --daemon
-
在集群中注册 BE 节点
使用 MySQL 客户端连接集群:
mysql -uroot -P9030 -h127.0.0.1
使用 ADD BACKEND 命令注册 BE 节点:
ALTER SYSTEM ADD BACKEND "127.0.0.1:9050";
-
检查 BE 状态
使用 MySQL 客户端连接集群,并检查集群状态:
## 检查 BE 状态,确定 Alive 列为 true
mysql -uroot -P9030 -h127.0.0.1 -e "show backends;"
+-----------+-----------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------+------------------+--------------------+---------------+---------------+---------+----------------+--------------------+--------------------------+--------+-------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------------------------+----------+
| BackendId | Host | HeartbeatPort | BePort | HttpPort | BrpcPort | LastStartTime | LastHeartbeat | Alive | SystemDecommissioned | TabletNum | DataUsedCapacity | TrashUsedCapcacity | AvailCapacity | TotalCapacity | UsedPct | MaxDiskUsedPct | RemoteUsedCapacity | Tag | ErrMsg | Version | Status | HeartbeatFailureCounter | NodeRole |
+-----------+-----------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------+------------------+--------------------+---------------+---------------+---------+----------------+--------------------+--------------------------+--------+-------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------------------------+----------+
| 10156 | 127.0.0.1 | 9050 | 9060 | 8040 | 8060 | 2024-07-28 17:59:14 | 2024-07-28 18:08:24 | true | false | 14 | 0.000 | 0.000 | 8.342 GB | 19.560 GB | 57.35 % | 57.35 % | 0.000 | {"location" : "default"} | | doris-2.0.12-2971efd194 | {"lastSuccessReportTabletsTime":"2024-07-28 18:08:14","lastStreamLoadTime":-1,"isQueryDisabled":false,"isLoadDisabled":false} | 0 | mix |
+-----------+-----------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------+------------------+--------------------+---------------+---------------+---------+----------------+--------------------+--------------------------+--------+-------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------------------------+----------+
运行查询
-
使用 MySQL 客户端连接集群
mysql -uroot -P9030 -h127.0.0.1
-
创建数据库与测试表
create database demo;
use demo;
create table mytable
(
k1 TINYINT,
k2 DECIMAL(10, 2) DEFAULT "10.05",
k3 CHAR(10) COMMENT "string column",
k4 INT NOT NULL DEFAULT "1" COMMENT "int column"
)
COMMENT "my first table"
DISTRIBUTED BY HASH(k1) BUCKETS 1; -
导入测试数据
使用 Insert Into 语句插入测试数据
insert into mytable values
(1,0.14,'a1',20),
(2,1.04,'b2',21),
(3,3.14,'c3',22),
(4,4.35,'d4',23); -
在 MySQL 客户端中执行以下 SQL 语句可以查看到已导入的数据:
MySQL [demo]> select * from demo.mytable;
+------+------+------+------+
| k1 | k2 | k3 | k4 |
+------+------+------+------+
| 1 | 0.14 | a1 | 20 |
| 2 | 1.04 | b2 | 21 |
| 3 | 3.14 | c3 | 22 |
| 4 | 4.35 | d4 | 23 |
+------+------+------+------+
4 rows in set (0.10 sec)