ExcelでOceanBaseに接続してデータを取得する

はじめに

Excelは広く使われているスプレッドシートおよびデータ可視化ツールです。OceanBase ODBCドライバーを使用することで、OceanBaseデータベースに直接接続し、効率的なデータクエリと分析を実現できます。 本記事では、WPS Office ExcelおよびMicrosoft Excelにおいて、ODBCデータソースを利用してOceanBaseデータベースに接続する方法を紹介します。

バージョン互換性

• OceanBaseデータベースのバージョン：V4.2.5 BP2以上。

前提条件

Excelを使用してOceanBaseに接続する前に、次のことを確認してください：

• Excel（WPS Office ExcelまたはMicrosoft Excel）がインストールされていること。
• OceanBase ODBCドライバー（バージョン ≥ 2.0.9.5hotfix）がインストールされていること。現在、ダウンロードは公開されていません。サポートチームにお問い合わせください。
• OceanBaseデータベースのデプロイが完了し、Oracle/MySQLモードのユーザーテナントが作成されていること。テナントの作成方法の詳細については、テナントの作成を参照してください。

手順

ステップ１：データベース接続文字列の取得

OceanBaseデータベースのデプロイ担当者から接続文字列を取得します。例：

obclient -h$host -P$port -u$user_name -p$password -D$database_name

パラメータ説明：

• $host：接続IPアドレス。ODP接続はODPアドレスを使用し、直接接続はOBServer IPを使用します。
• $port：接続ポート。ODPのデフォルトは2883、直接接続のデフォルトは2881です。
• $database_name：データベース名。

  注意

  テナントに接続するユーザーには、データベースに対する CREATE、INSERT、DROP、および SELECT 権限が付与されていなければなりません。ユーザー権限の詳細については、MySQLモードの権限分類を参照してください。

• $user_name：接続アカウント。ODP形式：ユーザー@テナント#クラスタまたはクラスタ:テナント:ユーザー。直接接続形式：ユーザー@テナント。
• $password：アカウントのパスワード。

接続文字列の詳細については、OBClientを使用してOceanBaseテナントに接続するを参照してください。

例：

obclient -h$host -P2881 -u$user_name -p$password -D$database_name

ステップ2：ODBC DSNの設定

本記事では、OceanBase Oracleモードのユーザーテナントを例にODBC DSNの設定方法を説明します（OceanBase MySQLモードのユーザーテナントも同様です）。手順は以下のとおりです：

1. システムODBCデータソースエクスプローラーを開きます。
2. システムDSNまたはユーザーDSNタブで、追加をクリックします。
3. OceanBase ODBC 2.0 Driverドライバーを選択します。
4. 接続パラメータを設定します：
   • Data Source Name：DSN名（例：OBORACLE）を入力します。
   • Description：任意の説明を追加します。
   • Server name：OceanBaseサーバーのアドレス（$hostに対応）。
   • Port：ポート番号（$portに対応）。
   • Database：データベース名（$database_nameに対応）。
   • User name：ユーザー名（$user_nameに対応）。
   • Password：パスワード（$passwordに対応）。

ステップ3：OceanBaseに接続する

WPS Office Excel

1. WPS Office Excelを開きます。
2. データ → データの取得 → データのインポート → ODBC DSN の順に移動します。
3. データソースの選択ダイアログで、設定済みの ODBC DSN（例：OBORACLE）を選択します。
4. インポートする テーブルとフィールド を選択します。
5. データのフィルタリングとソートのステップでは、直接 SQLステートメントを入力 してクエリを実行できます。
6. データのインポート をプレビューし、完了します。

Microsoft Excel

1. Microsoft Excelを開きます。
2. データ → データの取得 → その他のソースから → ODBCから の順に移動します。
3. 設定済みの ODBC DSN（例：OBORACLE）を選択します。
4. 上級オプションでは、直接 SQLステートメントを入力 できます。例：

SELECT * FROM T1;

5. OK をクリックしてデータを読み込みます。

よくある質問

Q1：OceanBaseデータベースに接続する際に文字化けが発生します。どうすればよいですか？ 原因：ODBCドライバーのバージョンが古すぎます。 解決策：OceanBase ODBC 2.0.9.5hotfix以降のバージョンにアップグレードしてください。