各製品の資料を入手。
詳細はこちら →
製品をチェック
MySQL Workbench からConfluence のデータをクエリする方法
MySQL Workbench からConfluence のリアルタイムデータにクエリを実行します。
最終更新日：2022-06-10
この記事で実現できるConfluence 連携のシナリオ
こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。
ODBC Driver for Confluence とSQL Gateway を使用することで、MySQL インターフェースを使ってConfluence にクエリを実行できます。この記事では、MySQL Workbench からConfluence のデータにSQL クエリを投げてデータを取得する方法をご紹介します。
CData ODBC ドライバとは？
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- Confluence をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにConfluence のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてConfluence の接続を設定、2.MySQL Workbench 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとConfluence への接続設定
まずは、本記事右側のサイドバーからConfluence ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
未指定の場合は、データソース名（DSN）で必要な接続プロパティの値を指定します。ドライバーのインストールの最後にODBC アドミニストレーターが開きます。Microsoft ODBC データソースアドミニストレーターでDSN を作成及び設定する方法については、ヘルプドキュメントの［はじめに］チャプターを参照してください。
Confluence 接続プロパティの取得・設定方法
任意のConfluence Cloud またはConfluence Server インスタンスへの接続を確立できます。接続するにはURL 接続プロパティを設定します。例えば、https://yoursitename.atlassian.net です。
Confluence への認証
Confluence は、次の認証メソッドをサポートしています：API トークン、Basic 認証、OAuth 2.0、SSO。
API トークン - Confluence Cloud アカウント
トークンの取得
アカウント認証にはAPI トークンが必要です。API トークンを生成するには、Atlassian アカウントにログインしてAPI トークン -> API トークンの作成を選択します。生成されたトークンが表示されます。
トークンを使用する認証
Cloud アカウントへの認証を行うには、以下を入力します。
- AuthScheme：APIToken に設定。
- User：Confluence サーバーに認証する際に使用されるユーザー。
- APIToken：現在認証されているユーザーに紐づくAPI トークン。
- Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。
Basic 認証 - Confluence Server インスタンス
Server インスタンスへの認証を行うには、以下のように指定します。
- AuthScheme：Basic に設定。
- User：Confluence インスタンスに認証する際に使用されるユーザー。
- Password：Confluence サーバーに認証する際に使われるパスワード。
- Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。
SQL Gateway を構成する
Confluence への接続を仮想MySQL データベースとして設定する方法については、SQL Gateway の解説記事 を参照してください。クライアントからのMySQL リクエストを受けるMySQL リモートサービスを構築します。このサービスは、SQL Gateway のUI で構成できます。
MySQL Workbench からConfluence をクエリ
以下のステップでは、MySQL Workbench からSQL Gateway で作成された仮想Confluence のデータベースに接続し、Confluence のデータをリアルタイムで操作するための基本的なクエリを発行する方法を説明します。
SQL Gateway を介してConfluence に接続
- MySQL Workbench で、［add a new MySQL connection］をクリックします。
- 接続（CData SQL Gateway for Confluence）に名前を付けます。
- Hostname、Port、Username のパラメータを設定し、SQL Gateway に接続します。
- Store in Vault をクリックしてパスワードを設定し、保存します。
- Test Connection をクリックして接続が正しく構成されていることを確認し、OK をクリックします。
Confluence のデータをクエリしてみる
- 作成した接続（CData SQL Gateway for Confluence）を開きます。
- ［File］->［New Query Tab］と進みます。
- SELECT * FROM `CData Confluence Sys`.Pages; のようなConfluence のデータを取得するSQL を書いて、実行します。
- 無事、Confluence のデータが取得できました。
おわりに
MySQL Workbench からリアルタイムConfluence のデータにアクセスすることで、MySQL データベースと同じようにConfluence をクエリおよび更新できます。CData ODBC Driver for Confluence とCData SQL Gateway の30日の無償評価版はこちらです。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。
関連コンテンツ
