このページでは、Azureプライベートネットワーク接続を使用してデータベースに接続する方法について説明します。
前提条件
- Azureアカウントに登録済みであり、Azureサブスクリプションを使用してAzureマーケットプレイスのOceanBase Cloud商品を購読していること。また、Azureサブスクリプションに有効な仮想ネットワーク(Virtual Network)とサブネット(Subnets)が存在すること。
- OceanBase Cloudアカウントに登録済みで、クラスタインスタンスとテナントを作成していること。詳細については、クラスタインスタンスの作成およびテナントの作成を参照してください。本記事ではMySQL互換テナントを例に説明します。
- クライアントIPアドレスがテナントの許可リストに追加されていることを確認してください。具体的な操作については、IPアドレスの許可リストの設定を参照してください。
手順
ステップ1：エンドポイントサービスを作成する
OceanBase Cloudコンソールにログインし、左側のナビゲーションバーで**ネットワーキング**をクリックします。
**プライベート接続タブで、プライベート接続を作成**をクリックします。
**ステップ1：エンドポイントサービスを作成で、クラウドサービスプロバイダーとしてAzure**を選択し、ターゲットインスタンスとテナントを選択します。
Azureコンソールを開き、ページ内の**Subscriptionsの下にあるNavigate**をクリックします。
Subscriptionsページで、ターゲットサブスクリプション名を確認します。
OceanBase Cloudコンソールに戻り、**Step 1のAzure Account ID**にそのサブスクリプション名を入力します。
ステップ2：Azure上でエンドポイントを作成し、接続する
Azureコンソールにログインしてプライベートエンドポイントを作成します。このプロセスには約10分かかります。
Azureコンソールにログインします。
Network foundation > Private Link > Private endpoints画面にアクセスします。
Createをクリックします。
Create a private endpoint画面で、ユーザーの設定に基づいて以下の情報を入力します：
basic
パラメータ説明Subscription サブスクリプションを選択します。 Resource group リソースグループを選択します。 Name プライベートエンドポイントの名前を入力します。 Network Interface Name Nameに基づいて自動生成されます。 Region 地域情報。 Resource
パラメータ説明Connection method Connect to an Azure resource by resource ID or aliasを選択します。 Resource ID or alias OceanBase CloudコンソールのStep 2で提供されたService IDを入力します。 Virtual Network
パラメータ説明Virtual network 接続するVnetを選択します。 Subnet ターゲットVnetのサブネット設定を行います。 DNS
現在のAzure Private Endpointは、このモードではDNS統合をサポートしていません。
Tags
必要に応じてTagsを設定します。
詳細確認ページで、createをクリックします。
Private Endpointの詳細ページで、StatusがOkに変わるのを待ち、リソース名をクリックして詳細に進みます。
Endpointの設定情報を取得します。
詳細ページで右上のJSON Viewボタンをクリックします。
表示されたResource JSONのポップアップウィンドウで、Resource IDをコピーします。
詳細ページでNetwork interfaceをクリックし、NICの詳細に進みます。
詳細ページで、Private IPv4 addressのIPアドレスを確認します。このアドレスはOceanBase Cloudデータベースインスタンスへのアクセスに使用されます。
OceanBase Cloudコンソールで、Endpoint IDとEndpoint IP Addressを入力します。
- Endpoint ID：手順7-2で取得したResource IDです。
- Endpoint IP Address：手順7-4で取得したPrivate IPv4 addressのIPアドレスです。
Step 3: Access Database
Private Linkの設定が完了したら、**Step 3: Access Database**画面でアクセス情報を選択し、接続文字列を生成してアクセスを検証します。
以下のコマンドでデータベースへのアクセスを検証します：
mysql -h<host> -P<port> -u<username>@<tenantId> -p
パラメータ説明：
- host：Private EndpointのIPアドレス。
- port：データベースアクセスポート。デフォルトは3306。
- username：接続に使用するデータベースアカウント。
- tenantId：テナントID。テナント一覧ページおよびテナント詳細ページで確認・コピーできます。
例：
mysql -h10.0.0.5 -P3306 -utest@t70zh******** -p
ページ内の**単一接続文字列を有効にする**ボタンをクリックすると、一段式接続文字列機能を有効にできます。有効になると、接続文字列の形式は次のとおりに変わります：
obclient -h <host> -P <port> -u <username> --ssl-ca=<path>/ca.pem -p
説明
- 二段式接続文字列ではODPホストのアドレスとポートを同時に指定する必要がありますが、一段式接続文字列ではデータベースサービスのアドレスのみを使用するため、形式がより簡潔です。
- 一段式接続文字列を有効にするボタンをクリックすると、ページに一段式接続文字列が表示され、コピーして使用できます。
- 一段式接続文字列を使用する前に、クライアント側のIPアドレスがホワイトリストに追加されていることを確認してください。追加されていない場合は、データベースに正常にアクセスできません。
- 一段式接続文字列機能を有効にした後も、既存の二段式接続文字列は引き続き正常に使用でき、影響はありません。
- 一段式接続文字列を有効にするボタンがグレーアウトされている場合は、現在のODPバージョンがv4.3.6未満で、この機能をサポートしていないことを意味します。OceanBase Cloudのテクニカルサポートに連絡し、アップグレードを依頼してください。