跳到主要内容
版本：V1.0.0

部署 OceanBase Desktop

本文分别介绍如何在 Windows 或 macOS 操作系统下部署 OceanBase Desktop。

背景介绍​

OceanBase Desktop 是一个用于管理和操作 seekdb 的桌面应用程序。它提供了图形化界面，使用户能够方便地进行数据库管理、查询执行、数据导入导出等操作。

OceanBase Desktop 具有如下特性：

  • 图形化界面： 直观易用的图形化界面，简化数据库管理任务。

  • 数据库管理： 支持创建和管理数据库实例。

  • 查询执行： 提供 SQL 查询命令行。

  • 监控与日志： 实时监控数据库状态。

检查配置​

执行下文在 Windows 操作系统下安装 OceanBase Desktop 操作前，您需确保所用机器满足如下要求：

  • 所用操作系统为 Windows（x86-64 芯片）。WSL 2 需要 Windows 10 1903 或更高版本（内部版本 18362 或更高版本），或 Windows 11。

  • 至少需要 1vCPU、2 GB 内存、5 GB 磁盘的可用资源。

可按照如下操作查看自身机器是否满足要求。

  • 检查 Windows 版本

    您可同时按下键盘 [Win] + [Q] 键，搜索 设置，单击进入 设置。在 设置 页面单击 系统，下滑找到 关于，即可查看 Windows 操作系统内部版本。

    版本

  • 查看内存和 CPU

    同时按下键盘 [Win] + [Q] 键，搜索 任务管理器，单击打开后进入 性能 界面。性能 界面下切换到 CPU 标签页可以查看 CPU 的核数；切换到 内存 标签页可以查看内存的使用情况。

    CPU

  • 检查磁盘

    您可同时按下键盘 [Win] + [Q] 键，搜索 文件资源管理器，单击打开。在 文件资源管理器 中单击左侧 此电脑，查看 设备和驱动器 下展示的磁盘情况。

操作步骤​

  1. 安装依赖

Windows 操作系统中安装 OceanBase Desktop 需依赖 WSL（Windows Subsystem for Linux，适用于 Linux 的 Windows 子系统）。WSL 是 Microsoft 公司于 2016 年在 Windows 10 平台发布的一项功能，其使得用户可以在 Windows 操作系统上运行 ELF 格式的 Linux 可执行文件。

WSL 目前已发布两代产品：WSL 1 和 WSL 2。WSL 1 实现了 Linux 兼容层，将 Linux 系统调用转换为 Windows NT 系统调用；而 WSL 2 则利用 Windows 的 Hyper-V 功能，通过虚拟化技术直接运行 Linux 虚拟机，更接近原生 Linux 操作系统体验。

提示

WSL 2 并不是 WSL 1 的升级版本，因此安装 WSL 2 不需要先安装 WSL 1， OceanBase Desktop 镜像只能使用 WSL 2。

  1. 查看是否已开启虚拟化

    同时按下键盘 [Win] + [Q] 键，搜索 任务管理器，单击打开后进入 性能 界面，查看 CPU。如下图所示，若已开启虚拟化，虚拟化 一栏显示为 已启用。如果 虚拟化 一栏显示为 已禁用，则参考下文开启 BIOS 中虚拟化功能。

    虚拟化

  2. 开启主板虚拟化

    本节以 ThinkPad（联想旗下品牌）中操作为例介绍如何进入 BIOS 并开启主板虚拟化。计算机不同品牌计算机进入 BIOS 和开启主板虚拟化的操作略有不同，您可访问各自品牌的官网查看具体操作，如 戴尔（Dell）、联想（Lenovo）、ThinkPad（联想旗下品牌）、惠普（HP）、和 华为（Huawei），或通过浏览器搜索自己计算机对应的型号操作。

    1. 打开 开始 菜单，单击 电源 按钮，单击 重启。

    2. 计算机重启后，立即按键盘 F1 键访问 BIOS 设置。

    3. 在 BIOS 页面中单击 Security 选项，并在 Security 页面单击 Security Virtualization。

    4. 进入对应设置页面后，将 Virtualization Technology 后的按钮调到 no。

    5. 调整后单击 Save and Exit 保存修改并退出 BIOS 设置，等待系统重新启动。

    信息

    开启后可参照上一步操作再次验证虚拟化是否已开启。

  3. 安装 OceanBase Desktop

  4. 下载安装包

    访问 OceanBase seekdb 软件下载中心，找到 OceanBase Desktop，选择需要下载的版本、操作系统、CPU 架构，再单击 下载 即可下载。

  5. 安装应用

    1. 双击下载的 OceanBase-Desktop-Setup-x.x.x.exe 文件。

    2. 在弹出的 用户帐户控制 窗口单击 是 允许应用对设备进行更改。

    3. 在弹出的 Installer Language 页面选择安装语言，默认为中文(简体)。

    Installer Language

    1. 选择应用安装位置，默认安装在 C 盘，您可单击 浏览 选择其他文件夹进行安装，确认后单击 安装。

    安装目录

    1. 安装完成后，单击 完成，将会自动运行 OceanBase Desktop 。

    完成安装

  6. 启动 OceanBase Desktop

    安装完成后，打开桌面版，会出现一个登录 obshell Dashboard 的登录界面。登录密码默认为空，直接点击 登录 即可进入。

    登录

    进入 obshell Dashboard 页面后，实例自动启动，您可以在该页面查看实例的信息以及进行实例管理。

    启动

  7. 连接 OceanBase Desktop

OceanBase Desktop 启动成功后，您可以通过黑屏界面连接 OceanBase Desktop，连接串示例如下：

wsl.exe -d oceanbase-desktop --exec bash -c "mysql -h127.0.0.1 -P2881 -uroot -Doceanbase -A"

Contents

编辑此页