本ドキュメントでは、Amazon Web Services (AWS) PrivateLink を使用して OceanBase Cloud に接続する方法について説明します。
前提条件
- AWS アカウントを登録済みであること。
- OceanBase Cloud アカウントを登録し、クラスタインスタンスとテナントを作成済みであること。詳細については、インスタンスの作成 および テナントの作成 をご参照ください。本ドキュメントでは、MySQL 互換テナントを例として説明します。
- クライアントの IP アドレスがテナントの許可リストに追加されていることを確認してください。具体的な操作については、IPアドレスの許可リストの設定 をご参照ください。
初めてプライベートネットワーク接続を使用する場合
インスタンスに利用可能なプライベートネットワークアドレスがない場合は、まずプライベートネットワークアドレスを作成してから、接続文字列を取得する必要があります。
OB Cloudクラウドデータベースコンソール にログインし、左側のナビゲーションペインで ネットワーキング をクリックします。
ネットワーク設定ページで、プライベート接続を作成 をクリックします。
表示されたダイアログで、以下の情報に従って 作成する の設定を完了し、作成 をクリックします。
パラメータ説明AWS AWS を選択します。 インスタンスまたはテナントの選択 接続するインスタンスとテナントを選択します。 ピアメインアカウントの入力 AWS アカウント ID です。AWSクラウドコンソール にアクセスし、右上のユーザー名をクリックして、ドロップダウンメニューからアカウント ID をコピーします。 AWS エンドポイントを作成します。
AWS コンソールを使用して作成する
ステップ 2：エンドポイントの作成 で、サービス ID をコピーして保存します。
AWS マネジメントコンソール にアクセスし、検索バーで「エンドポイント」を検索して、機能 > エンドポイント を選択します。
エンドポイントページで、エンドポイントの作成 をクリックし、以下の設定情報を入力して、エンドポイントの作成 をクリックします。
パラメータ説明名前 カスタム名を入力します。 タイプ NLB および GWLB を使用するエンドポイントサービス を選択します。 サービス名 ステップ2: エンドポイントを作成 でコピーしたサービス ID を入力し、サービスの検証 をクリックします。 VPC エンドポイントを作成する VPC を選択し、ターゲットサブネットにチェックを入れます。 AWS エンドポイントが正常に作成されたら、VPC エンドポイント ID をコピーします。エンドポイントページで、作成したエンドポイントにチェックを入れ、アクション > プライベート DNS 名の変更 を選択します。開いた画面の プライベート DNS 名の有効化 で、このエンドポイントで有効にする にチェックを入れ、保存します。
コマンドラインを使用して作成する
AWS コンソール にアクセスし、VPC ID とサブネット ID を取得して入力します。
ステップ3：プライベートDNSを有効化 > AWS CLI を使用して作成 タブで、エンドポイントを作成するコマンドをコピーします。
AWS コンソールのコマンドラインページで、コピーしたコマンドを実行します。
作成が完了したら、エンドポイントページにアクセスし、VPC エンドポイント ID をコピーします。エンドポイントページで、作成したエンドポイントにチェックを入れ、アクション > プライベート DNS 名の変更 を選択します。開いた画面の プライベート DNS 名の有効化 で、このエンドポイントで有効にする にチェックを入れ、保存します。
OceanBase Cloud コンソールに戻り、ステップ 2：エンドポイントの作成 にコピーした VPC エンドポイント ID を入力し、エンドポイントの作成 をクリックします。
エンドポイントの作成が完了したら、プライベート DNS が有効になっていることを確認し、ステップ 3：プライベート DNS の有効化 で 確認 をクリックします。
ステップ 4：データベースへのアクセス で、既存のデータベースとアカウントを選択するか、新しいデータベースとアカウントを作成します。
注意
アカウントを作成する際は、生成されたパスワードを安全な場所に保管してください。
OBClient などの接続方法を必要に応じて選択し、生成された接続文字列をクライアントにコピーして接続します。接続が成功すると、データベースにアクセスして使用できるようになります。
利用可能なプライベートネットワークアドレスがすでにある場合
利用可能なプライベートネットワークアドレスがすでにある場合は、作成済みのプライベートネットワーク接続を選択して直接接続できます。以下では、作成済みのプライベートネットワーク接続を使用して接続する方法について説明します。新しいプライベートネットワーク接続を作成する必要がある場合は、前述の プライベート接続の初回使用 セクションを参照して作成してください。
OB Cloudデータベースコンソール にログインします。インスタンスリストページで、ターゲットインスタンスの情報を展開し、ターゲットテナントの下で 接続 > 接続文字列を取得 を選択します。
表示されたダイアログで プライベートネットワークアドレスを使用 を選択します。
ステップ4：データベースにアクセス で、データベースとアカウントを選択するか、新しいデータベースとアカウントを作成することを選択します。
注意
新しいアカウントを作成することを選択した場合は、アカウント作成時に生成されたパスワードを適切に記録してください。
OBClient などの接続方法を必要に応じて選択し、生成された接続文字列をクライアントにコピーして接続します。接続が成功すると、データベースにアクセスして使用できるようになります。
次のステップ
エンドポイントの作成が完了すると、テナントワークスペースのトポロジ図で作成されたエンドポイント情報を確認できます。VPC の変更などの理由で作成済みのエンドポイントを変更する必要がある場合、現在 OceanBase Cloud では既存のエンドポイントを削除して再作成することがサポートされています。エンドポイントを削除する操作は以下のとおりです。
OceanBase Cloud コンソールのインスタンスリストページで、ターゲットテナント名をクリックしてテナントワークスペースに入ります。
テナントワークスペースの トポロジー で、削除ボタンをクリックして作成済みのエンドポイントを削除します。