はじめに
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モードのユーザーテナントも同様です）。手順は以下のとおりです：
- システムODBCデータソースエクスプローラーを開きます。
- システムDSNまたはユーザーDSNタブで、追加をクリックします。
- OceanBase ODBC 2.0 Driverドライバーを選択します。
- 接続パラメータを設定します：
- Data Source Name：DSN名（例：
OBORACLE）を入力します。 - Description：任意の説明を追加します。
- Server name：OceanBaseサーバーのアドレス（
$hostに対応）。 - Port：ポート番号（
$portに対応）。 - Database：データベース名（
$database_nameに対応）。 - User name：ユーザー名（
$user_nameに対応）。 - Password：パスワード（
$passwordに対応）。
- Data Source Name：DSN名（例：
ステップ3：OceanBaseに接続する
WPS Office Excel
- WPS Office Excelを開きます。
- データ → データの取得 → データのインポート → ODBC DSN の順に移動します。
- データソースの選択ダイアログで、設定済みの ODBC DSN（例：
OBORACLE）を選択します。 - インポートする テーブルとフィールド を選択します。
- データのフィルタリングとソートのステップでは、直接 SQLステートメントを入力 してクエリを実行できます。
- データのインポート をプレビューし、完了します。
Microsoft Excel
- Microsoft Excelを開きます。
- データ → データの取得 → その他のソースから → ODBCから の順に移動します。
- 設定済みの ODBC DSN（例：
OBORACLE）を選択します。 - 上級オプションでは、直接 SQLステートメントを入力 できます。例：
SELECT * FROM T1;
- OK をクリックしてデータを読み込みます。
よくある質問
Q1：OceanBaseデータベースに接続する際に文字化けが発生します。どうすればよいですか？ 原因：ODBCドライバーのバージョンが古すぎます。 解決策：OceanBase ODBC 2.0.9.5hotfix以降のバージョンにアップグレードしてください。