本記事では、ユースケースに基づき、OceanBaseデータベースを迅速にデプロイする方法を詳しく説明します。これにより、OceanBaseデータベースをすぐに習得し、スムーズに利用できるようになります。
説明
このドキュメントは本番環境には適用されません。本番環境でOceanBaseデータベースをデプロイする場合は、OceanBaseデータベースCommunity Editionデプロイの概要を参照し、適切なデプロイ方法を選択してください。
コンポーネント紹介
obd
OceanBase Deployer、OceanBaseのインストールおよびデプロイツールで、略称はobdです。詳細については、公式ドキュメントOceanBaseインストール・デプロイツールを参照してください。
ODP
OceanBase Database Proxy、OceanBaseデータベースプロキシは、OceanBaseデータベース専用のプロキシサーバーで、略称はODP(OBProxyとも呼ばれます)。詳細については、公式ドキュメントOceanBaseデータベースプロキシを参照してください。
OBAgent
OBAgentはOceanBaseデータベース監視収集フレームワークで、プッシュ型とプル型の2種類のデータ収集モードをサポートし、さまざまなアプリケーションシナリオに対応できます。
Grafana
Grafanaはオープンソースのデータ可視化ツールで、データソース内のさまざまな指標データを視覚的に表示し、システムの稼働状態やパフォーマンス指標をより直感的に理解することができます。詳細については、Grafana公式Webサイトを参照してください。
Prometheus
Prometheusはオープンソースのサービス監視システムおよび時系列データベースで、汎用的なデータモデルと、迅速なデータ収集・保存・クエリのためのインターフェースを提供します。詳細については、Prometheus公式Webサイトを参照してください。
前提条件
本記事を参考にOceanBaseデータベースをインストールする前に、お使いのソフトウェアおよびハードウェア環境が以下の要件を満たしていることを確認してください:
項目 |
説明 |
|---|---|
| システム |
|
| CPU | 最低 2 コア、推奨 4 コア以上。 |
| メモリ | 最低 6 GB、推奨 16 GB ~ 1024 GB の範囲で設定。 |
| ディスクタイプ | SSDストレージを使用します。 |
| ディスク容量 | 最低 20 GB。 |
| ファイルシステム | EXT4 または XFS。データが 16 TB を超える場合は XFS を使用します。 |
| ポート | コンポーネントのデフォルトポートが使用されていないことを確認する必要があります:
|
| all-in-one インストールパッケージ | all-in-one インストールパッケージは V4.1.0 以降を選択する必要があります。 |
| Docker | Docker を使用して OceanBase データベースをデプロイする場合は、事前に Docker をインストールし、Docker サービスを起動しておく必要があります。詳細な操作手順については、Docker ドキュメントを参照してください。
説明x86 アーキテクチャの Mac マシンを使用する場合、OceanBase データベースのデプロイには V4.9.0 以下の Docker バージョンのみがサポートされます。このリンク をクリックして Docker をダウンロードしてください。 |
OceanBaseデータベースをすぐに試す
この方法は、マシンが1台しかない場合に、手早く利用可能なOceanBaseデータベース環境を構築するのに適しています。デプロイされるOceanBaseデータベース環境はデータベースの基本機能を備えており、OceanBaseデータベースを理解するのに役立ちます。ただし、分散機能や高可用性は備えていないため、長期間の使用は推奨されません。
以下のいずれかの方法で、OceanBaseデータベースをすぐに試すことができます。
方法1:All in Oneインストールパッケージを使用する
以下のコマンドを実行してOceanBase All in Oneをダウンロードし、インストールします。このコマンドは、最新バージョンのOceanBase All in Oneパッケージをオンラインでダウンロードしてインストールします。
bash -c "$(curl -s https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/download-center/opensource/oceanbase-all-in-one/installer.sh)"
source ~/.oceanbase-all-in-one/bin/env.sh
obdは以下の2種類のクイックデプロイコマンドを提供します:
最小構成デプロイ
OceanBaseデータベースの最小構成で、単一ノードのOceanBaseデータベースおよび関連コンポーネントをデプロイして起動します。
obd demo最大構成デプロイ
OceanBaseデータベースの最大構成で、単一ノードのOceanBaseデータベースおよび関連コンポーネントをデプロイして起動します。
obd perf説明
obd V3.4.0から最大構成デプロイコマンド(
obd pref)が提供され、V4.0.0からはコマンドがobd perfに更新されました。
上記はクイック体験コマンドであり、現在のアカウントを使用してOceanBaseデータベース、ODP、監視コンポーネント(OBAgent、Grafana、Prometheus)を直接デプロイします。その後、obdコマンドを使用してOceanBaseデータベースおよびコンポーネントを管理できます。OceanBase All in Oneのオフラインインストール手順とobd demo/obd perfコマンドの詳細については、公式サイトの「OceanBaseインストール・デプロイツール」ドキュメントクイックスタート/obdのインストールおよびobdコマンド/クイックデプロイコマンドを参照してください。
obd demo/obd perfコマンドが正常に実行されると、デプロイされたコンポーネントへの接続方法が出力されます。oceanbase-ceコンポーネントの下にある接続文字列をコピーして実行し、rootユーザーでクラスタのsysテナントにログインしてください。クラスタにログイン後、SQLステートメントを実行して簡単な機能を体験できます。詳細については、SQL基本操作(MySQLモード)を参照してください。
方法2:RPMパッケージを直接使用する
説明
- この方法はsystemctlコマンドに依存しています。コンテナ環境以外で操作を行ってください。
この方法でOceanBaseデータベースをインストールできるのは、以下のシステムのみです:
- Anolis OS 8.X系(カーネルLinux 4.19以降)
- CentOS Linux 8.X系(カーネルLinux 4.19以降)
- Debian 10、11、12系(カーネルLinux 4.19以降)
- openEuler 22.03および24.03(カーネルLinux 5.10.0以降)
- Ubuntu 18.04、20.04、22.04(カーネルLinux 4.19以降)
sudo bash -c "$(curl -s https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/download-center/opensource/service/installer.sh)"
上記はクイック体験コマンドです。オンラインで最新版のRPMパッケージをダウンロードし、rootアカウントで直接インストールします。その後、systemctlコマンドを使用してOceanBaseデータベースを管理できます。詳細な設定とオフラインインストールの手順については、公式サイトの「OceanBaseデータベース」ドキュメントsystemdを使用したOceanBaseデータベースのデプロイを参照してください。
コマンドが正常に実行されると、OceanBaseデータベースの接続情報が出力されます。出力された接続文字列をコピーして実行し、rootユーザーでクラスタのsysテナントにログインしてください。クラスタにログイン後、SQLステートメントを実行して簡単な機能を体験できます。詳細については、SQLの基本操作(MySQLモード)を参照してください。
方法3:Dockerを使用したクイック体験
この方法は、Linux以外のOS(WindowsやmacOSなど)を使用し、コンテナを利用してOceanBaseデータベースのデプロイや管理を実現したいユーザーに適しています。この方法は大規模環境での検証が行われていないため、慎重にご利用ください。
説明
x86アーキテクチャのMACマシンを使用する場合、OceanBaseデータベースのデプロイはV4.9.0以降のDockerバージョンではサポートされません。Dockerをダウンロードするには、こちら をクリックしてください。
sudo docker run -p 2881:2881 --name obstandalone -e MODE=MINI -d quay.io/oceanbase/oceanbase-ce
上記はクイック体験用のコマンドです。オンラインで 最新のイメージをダウンロードし、最小構成のOceanBaseデータベースを起動します。その後、dockerコマンドを使用してOceanBaseデータベースを管理できます。詳細な設定については、公式ドキュメント「OceanBaseデータベース」のOceanBaseデータベースコンテナ環境のデプロイを参照してください。
デプロイが成功したら、以下のコマンドを実行してrootユーザーでクラスタのsysテナントにログインします。クラスタにログイン後、SQLステートメントを実行して簡単な機能を体験できます。詳細については、SQLの基本操作(MySQLモード)を参照してください。
# Dockerコンテナに入る
sudo docker exec -it obstandalone bash
# クラスタに接続する。パスワードはデフォルトで空。
obclient -uroot@sys -h127.0.0.1 -Doceanbase -P2881 -p
関連ドキュメント
OceanBaseデータベースCommunity Editionのデプロイ方法および適用シナリオについては、OceanBaseデータベースCommunity Editionデプロイの概要を参照してください。
クラスタのクリーンアップに関する具体的な操作については、古いクラスタのクリーンアップを参照してください。