CREATE REPOSITORY

Description

该语句用于创建仓库。仓库用于属于备份或恢复。仅 admin 用户可以创建仓库。

CREATE [READ ONLY] REPOSITORY `repo_name`
WITH BROKER `bos`
ON LOCATION `repo_location`
PROPERTIES ("key"="value", ...);

• READ ONLY

  如果指定 READ ONLY，则该仓库只读，即只能用户恢复操作，不可用户备份操作。

• WITH BROKER

  创建操作依赖 Broker 服务进程。而之后的 PROPERTIES 里需要填写用于 Broker 访问远端仓库的信息。

• ON LOCATION

  指定远端存储中用于存放数据的路径。

Example

1. 创建名为 bos_repo 的仓库，数据根目录为：bos://my_bucket/doris_backup/

   CREATE REPOSITORY `bos_repo`
   WITH BROKER `bos_broker`
   ON LOCATION "bos://my_bucket/doris_backup/"
   PROPERTIES
   (
       "bos_endpoint" = "http://gz.bcebos.com",
       "bos_accesskey" = "069fc2786e664e63a5f111111114ddbs22",
       "bos_secret_accesskey"="70999999999999de274d59eaa980a"
   );

Keywords

CREATE, REPOSITORY

最佳实践

1. 一个集群可以创建过多个仓库。只有拥有 ADMIN 权限的用户才能创建仓库。
2. 任何用户都可以通过 SHOW REPOSITORIES 命令查看已经创建的仓库。
3. 在做数据迁移操作时，需要在源集群和目的集群创建完全相同的仓库，以便目的集群可以通过这个仓库，查看到源集群备份的数据快照。