Go-SQL-Driver/MySQLを使用してOB Cloudに接続する

本記事では、Go-SQL-Driver/MySQLドライバーを使用してOB Cloudに接続する方法について説明します。

前提条件

• OB Cloudデータベースアカウントに登録済みで、クラスタインスタンスとOB Cloud MySQLテナントを作成していること。詳細については、クラスタインスタンスの作成およびテナントの作成を参照してください。

• 本記事で使用されているサンプルプロジェクトをダウンロード済みであること。

  go-oceanbaseサンプルプロジェクトをダウンロード

手順

ステップ１：(オプション) Go言語とドライバーのインストール

Go言語とGo-SQL-Driver/MySQLドライバーが既にインストールされている場合は、この手順をスキップしてください。インストールされていない場合は、以下の手順に従ってインストールしてください。

1. Go言語のインストール

   1. Go公式サイトからGo言語のインストーラーをダウンロードし、インストールします。

      説明

      本記事で使用しているGoのインストーラーはgo1.22.2.darwin-amd64.pkgです。

   2. 環境変数の設定。Go言語のインストールパスをシステムのPATH環境変数に追加します。

      • LinuxまたはmacOS環境では、~/.bashrcまたは~/.bash_profileファイルを編集し、以下の内容を追加します：

        export PATH=$PATH:/usr/local/go/bin
        

      • Windows環境では、コントロールパネル > システムとセキュリティ > システム > 詳細なシステム設定 > 環境変数 > システム変数 でPathの値に C:\usr\local\go\bin を追加します。

      説明

      \usr\local\go\binはデフォルトのインストールディレクトリです。Go言語のインストール時にインストールディレクトリを変更した場合は、対応するディレクトリに置き換えてください。

   3. コマンドラインツールで以下のコマンドを入力し、Go言語のバージョン情報を確認して、インストールが成功したかどうかを確認します：

      go version
      

      実行結果の例：

      
      go version go1.22.2 darwin/amd64
      

2. Go-SQL-Driver/MySQLドライバーのインストール。

   Go言語のバージョンに応じて、異なるインストール方法を選択できます。Go-SQL-Driver/MySQLドライバーをインストールする際は、まず対応するプロジェクトディレクトリに移動する必要があります。本記事のサンプルプロジェクトの場合、go-oceanbase フォルダ内にドライバーをインストールする必要があります。Go-SQL-Driver/MySQL の詳細については、GitHubを参照してください。

   インストールコマンドは以下のとおりです：

   cd go-oceanbase
   go get -u github.com/go-sql-driver/mysql
   

   バージョンやネットワークの問題で go get コマンドでインストールできない場合は、go install コマンドで go-sql-driver/mysql をインストールできます。

   1. go/src ディレクトリで、GitHub上の go-sql-driver/mysql リポジトリをクローンします。

      cd /usr/local/go/src
      git clone https://github.com/go-sql-driver/mysql.git
      

      注意

      /usr/local/go/src は、Goが実際にインストールされているディレクトリに置き換えて操作してください。

   2. go install でインストールします。

      go install mysql
      

      注意

      一部のバージョンでは、go install のデフォルトの実行ディレクトリが /src ではない場合があります。go install 実行後のエラーから実際のディレクトリを判断できます。例えば、cannot find package "mysql" in: /usr/local/go/src/vendor/mysql エラーが発生した場合は、mysqlフォルダを /src/vendor ディレクトリに配置してからインストールコマンドを再度実行してください。

   3. Go-SQL-Driver/MySQLドライバーがインストールされているか確認します。インストールに失敗した場合は、エラーメッセージに従って修正してください。

      go list -m github.com/go-sql-driver/mysql
      

ステップ2：OB Cloudデータベース接続文字列を取得する

1. OB Cloudコンソールにログインします。クラスターリストページで、対象クラスタの情報を展開し、対象テナントの下で、接続 をクリックします。

   

2. ポップアップウィンドウで、パブリックネットワークを使用する を選択します。

3. パブリックIPを使用してデータベースに接続します ページで以下の設定を完了し、接続文字列を生成します：

   

   パラメータ		説明
   IPアドレスの追加		追加をクリックして、エグジットIPをホワイトリストに追加します。
   証書のダウンロード		（オプション）証書をダウンロードをクリックして、CA証書をダウンロードし、認証を完了します。
   テナントへの接続	データベース	ドロップダウンボックスをクリックした後、+ データベースの作成をクリックし、表示された手順に従ってデータベースの作成を完了します。
   	アカウント	ドロップダウンボックスをクリックした後、+ アカウントの作成をクリックし、表示された手順に従ってアカウントの作成を完了します。
   	接続方式	接続方式として MySQL CLI を選択します。

   注意

   アカウント作成後、作成時に生成されたパスワードを適切に保管してください。

ステップ3：go-oceanbase サンプルプロジェクトのデータベース接続情報を修正する

ステップ2：OB Cloudデータベース接続文字列を取得するで取得した接続文字列情報に基づき、test.go ファイル内の以下の内容を修正して保存します：

conn := "user_name:password@tcp(host:port)/schema_name"
// データベース接続パラメータ

• user_name：接続文字列の -u パラメータから取得したアカウント名です。
• password：接続文字列の -p パラメータから取得したアカウントのパスワードです。
• host：接続文字列の -h パラメータから取得したOB Cloudデータベースの接続アドレスです。
• port：接続文字列の -P パラメータから取得したOB Cloudデータベースの接続ポートです。
• schema_name：test に変更します。アクセスするSchema名は test です。

例：

conn := "testaccount:111****QW@tcp(t5******.aws-ap-southeast-1.oceanbase.cloud:3306)/test"

ステップ4：go-oceanbase サンプルプロジェクトを実行する

コードの編集が完了したら、go-oceanbase フォルダ内で以下のコマンドを使用してサンプルプロジェクトを実行します：

go run test.go

実行後、以下の内容が返された場合、データベースへの接続に成功し、サンプル文が正しく実行されたことを意味します：

success to connect OceanBase with go_mysql driver
Hello OceanBase

関連ドキュメント

Go-SQL-Driver/MySQLに関する情報は、OceanBaseデータベースのオープンソースコミュニティにも多数存在します。詳細については、Go-SQL-Driver/MySQLを参照してください。