このページでは、AlloyDB Omni バージョン 15.5.2 のドキュメントについて説明します。AlloyDB Omni の最新バージョンのドキュメントについては、こちらをクリックしてください。

このページは Cloud Translation API によって翻訳されました。

AlloyDB Omni のインストールをカスタマイズする

このページでは、AlloyDB Omni のダウンロード、インストール、接続方法について説明します。デフォルト構成を使用して AlloyDB Omni をすぐに使用するには、Debian または Ubuntu に AlloyDB Omni をインストールするをご覧ください。

このドキュメントでは、次の方法についても説明します。

新しいディスクパーティションを作成して、データストレージを最適化します。
サーバーを構成します。
Debian、Ubuntu、RHEL との互換性を確認します。

始める前に

システム要件

Debian

Debian ベースの OS（Debian や Ubuntu など）を実行する仮想マシンまたは物理マシン。
x86/AMD64 アーキテクチャの CPU が 2 つ以上。
2 GB 以上の RAM。最適なパフォーマンスを得るには、CPU ごとに 8 GB の RAM を割り当てることをおすすめします。
20 GB 以上の空き容量。
OS 内でのルート権限の無制限の使用。
Docker バージョン 20.10 以降。
Linux カーネルのバージョンが 4.18 以降。最適なパフォーマンスを得るには、カーネルバージョン 5.3 以降を使用することをおすすめします。
Linux cgroup v2 が有効になっている。
ほとんどの最新の Linux システムでは、デフォルトで cgroup v2 が有効になっています。cgroup v2 が有効になっているかどうかを確認するには、シェルで stat -fc %T /sys/fs/cgroup/ を実行します。cgroup v2 が有効になっている場合、コマンドの出力に cgroup2fs と表示されます。
Vertex AI と統合する場合は、環境で使用可能な Google Cloud CLI が必要です。
クラウドプラットフォームに AlloyDB Omni をインストールするには、次のインスタンスタイプを使用することをおすすめします。
- Google Cloudでは、n2-highmem インスタンスを使用することをおすすめします。
- Amazon Web Services では、R6i インスタンスをおすすめします。
- Microsoft Azure では、Ebsv5 インスタンスをおすすめします。
データの保存には専用の SSD ストレージデバイスを使用することをおすすめします。この目的で実機を使用する場合は、ホストマシンに直接接続することをおすすめします。

RHEL

Red Hat Enterprise Linux（RHEL）バージョン 8 以降を実行している仮想マシンまたは物理マシン。AlloyDB Omni の自動メモリ管理機能を使用できるようにするには、RHEL バージョン 9 以降を使用します。
x86/AMD64 アーキテクチャの CPU が 2 つ以上。
2 GB 以上の RAM。最適なパフォーマンスを得るには、CPU ごとに 8 GB の RAM を割り当てることをおすすめします。
20 GB 以上の空き容量。
OS 内でのルート権限の無制限の使用。
Docker バージョン 20.10 以降。
Linux カーネルのバージョンが 4.18 以降。最適なパフォーマンスを得るには、カーネルバージョン 5.3 以降を使用することをおすすめします。
Linux cgroup v2 が有効になっている。
ほとんどの最新の Linux システムでは、デフォルトで cgroup v2 が有効になっています。cgroup v2 が有効になっているかどうかを確認するには、シェルで stat -fc %T /sys/fs/cgroup/ を実行します。cgroup v2 が有効になっている場合、コマンドの出力に cgroup2fs と表示されます。
Vertex AI と統合する場合は、環境で使用可能な Google Cloud CLI が必要です。
クラウドプラットフォームに AlloyDB Omni をインストールするには、次のインスタンスタイプを使用することをおすすめします。
- Google Cloudでは、n2-highmem インスタンスを使用することをおすすめします。
- Amazon Web Services では、R6i インスタンスをおすすめします。
- Microsoft Azure では、Ebsv5 インスタンスをおすすめします。
データの保存には専用の SSD ストレージデバイスを使用することをおすすめします。この目的で実機を使用する場合は、ホストマシンに直接接続することをおすすめします。

AlloyDB Omni をダウンロードしてインストールする

AlloyDB Omni CLI をインストールします。
AlloyDB Omni CLI を使用して、Linux マシンが AlloyDB Omni をインストールする準備ができていることを確認します。
```
sudo alloydb system-check
```
必要に応じて、system-check コマンドの出力でチェックが成功するまでシステムを変更します。
省略可: AlloyDB Omni がデータストレージに使用する新しいディスクパーティションを作成するには、パフォーマンスを最適化するために ext4 ファイルシステムを使用することをおすすめします。
1. ext4 ファイルシステムを作成するには、次のコマンドを使用します。
```
mkfs.ext4 -m 1 -F "$disk_path"
```
2. ディスクをマウントするには、次のコマンドを使用します。
```
mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"
```
次のいずれかのオプションを使用して、サーバーソフトウェアをインストールします。

注: 大規模言語モデル（LLM）のクエリ機能など、ML 関数が有効になっている AlloyDB Omni をインストールするには、AlloyDB AI を使用して AlloyDB Omni をインストールするをご覧ください。
- サーバーをプライマリインスタンスとして構成するには、次のコマンドを実行します。
```
sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)
```
  DATA_DIR は、AlloyDB Omni がデータ、メタデータ、構成ファイルを保存するローカルファイルシステムのディレクトリに置き換えます。AlloyDB Omni は、このディレクトリが存在しない場合は作成しようとします。この値を指定しない場合、AlloyDB Omni はデフォルトで /var/alloydb/main/ になります。
  
  AlloyDB Omni がデフォルトの 5432 以外の TCP ポートで接続をリッスンするようにするには、--pg-port フラグを指定します。
```
sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --pg-port=PORT
```
  PORT は、AlloyDB Omni で接続を受け入れるようにする TCP ポートに置き換えます。
- サーバーをリードレプリカとして構成するには、--replica-source-ip フラグと --replica-source-port フラグを含めます。
```
sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --replica-source-ip=SOURCE_IP \
    --replica-source-port=SOURCE_PORT
```
  次のように置き換えます。
  - DATA_DIR: AlloyDB Omni がデータ、メタデータ、構成ファイルを保存するローカルファイルシステム上のディレクトリ。AlloyDB Omni は、このディレクトリが存在しない場合は作成しようとします。この値を指定しない場合、AlloyDB Omni はデフォルトで /var/alloydb/main/ になります。
  - SOURCE_IP: レプリケート元のプライマリ AlloyDB Omni インスタンスの IP アドレス。
  - SOURCE_PORT: レプリケート元のプライマリ AlloyDB Omni インスタンスの TCP ポート。この値を指定しない場合、AlloyDB Omni はデフォルト値 5432 を適用します。
  AlloyDB Omni リードレプリカの詳細については、読み取り専用レプリカを作成するをご覧ください。
システムで Red Hat Enterprise Linux を実行している場合は、/usr/lib/tuned/virtual-guest/tuned.conf ファイルを次のように更新します。
```
vm.swappiness=1
```

データベースサーバーに接続して使用する

psql を使用して AlloyDB Omni に接続します。

sudo docker exec -it pg-service psql -h localhost -U postgres

ターミナルウィンドウに、postgres=# プロンプトで終わる psql ログインテキストが表示されます。