跳到主要内容

快速体验

警告:

快速部署仅适用于本地开发。请勿将该种部署方式用于生产环境:

  1. 使用 Docker 方式快速部署,当 Docker 实例销毁时,相应的数据也会释放。

  2. 通过手动部署单副本 Doris 实例,不具有数据多副本存储能力,单台机器宕机可能会造成数据丢失。

  3. 本示例中的建表均为单副本,在生产中请使用多副本存储数据。

使用 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 步:修改环境变量

  1. 修改系统最大打开文件句柄数

    通过以下命令可以调整最大文件句柄数。在调整后,需要重启会话以生效配置:

    vi /etc/security/limits.conf 
    * soft nofile 1000000
    * hard nofile 1000000
  2. 修改虚拟内存区域

    通过以下命令可以永久修改虚拟内存区域至少为 2000000,并立即生效:

    cat >> /etc/sysctl.conf << EOF
    vm.max_map_count = 2000000
    EOF

    Take effect immediately
    sysctl -p

第 3 步:安装 FE

  1. 配置 FE

    修改 FE 配置文件 apache-doris/fe/conf/fe.conf 的以下内容:

    ## 指定 Java 环境
    JAVA_HOME=/home/doris/jdk

    # 指定 FE 监听 IP 的 CIDR 网段
    priority_networks=127.0.0.1/32
  2. 启动 FE

    通过 start_fe.sh 脚本运行 FE 进程:

    apache-doris/fe/bin/start_fe.sh --daemon
  3. 检查 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

  1. 配置 BE

    修改 BE 配置文件 apache-doris/be/conf/be.conf 的以下内容:

    ## 指定 Java 环境
    JAVA_HOME=/home/doris/jdk

    # 指定 FE 监听 IP 的 CIDR 网段
    priority_networks=127.0.0.1/32
  2. 启动 BE

    通过以下命令启动 BE 进程:

    apache-doris/fe/bin/start_be.sh --daemon
  3. 在集群中注册 BE 节点

    使用 MySQL 客户端连接集群:

    mysql -uroot -P9030 -h127.0.0.1

    使用 ADD BACKEND 命令注册 BE 节点:

    ALTER SYSTEM ADD BACKEND "127.0.0.1:9050";
  4. 检查 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 |
    +-----------+-----------+---------------+--------+----------+----------+---------------------+---------------------+-------+----------------------+-----------+------------------+--------------------+---------------+---------------+---------+----------------+--------------------+--------------------------+--------+-------------------------+-------------------------------------------------------------------------------------------------------------------------------+-------------------------+----------+

运行查询

  1. 使用 MySQL 客户端连接集群

    mysql -uroot -P9030 -h127.0.0.1
  2. 创建数据库与测试表

    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;
  3. 导入测试数据

    使用 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);
  4. 在 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)