NetBeans で Confluence のデータ に接続
CData JDBC Driver for Confluence は、JDBC をサポートする IDE にリアルタイム Confluence のデータ 接続を統合します。JDBC 標準により、ビルトインのデータアクセスウィザードや迅速な開発をサポートするその他のツールを使用できます。この記事では、NetBeans で Confluence のデータ に接続する方法を説明します。接続を作成し、テーブルエディターで ロードを行います。
NetBeans で Confluence 用の JDBC データソースを作成
JDBC データソースを作成するには、サービスウィンドウで Database ノードを展開し、Drivers ノードを右クリックして New Driver を選択します。表示される New Driver ウィザードで、以下の情報を入力します:
- Driver File(s):Add をクリックし、表示されるファイルエクスプローラーダイアログで cdata.jdbc.confluence.jar ファイルを選択します。ドライバー JAR はインストールディレクトリの lib サブフォルダにあります。
- Driver Class:Find をクリックして JAR 内のドライバークラスを検索します。次に、メニューから cdata.jdbc.confluence.ConfluenceDriver を選択します。
- Name:ドライバーの名前を入力します。
接続パラメータの定義
以下の手順で、必要な接続プロパティを定義します:
サービスウィンドウで Database ノードを右クリックし、New Connection をクリックします。
New Connection Wizard で、以下の接続プロパティを入力します:
- Driver Name:メニューから CData JDBC Driver for Confluence を選択します。
- User Name:ユーザー名を入力します。これは JDBC URL でも定義できます。
- Password:パスワードを入力します。これは JDBC URL でも定義できます。
JDBC URL:JDBC URL を指定します。
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 です。
ビルトイン接続文字列デザイナー
JDBC URL の作成には、Confluence JDBC Driver にビルトインされている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.confluence.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は次のとおりです:
jdbc:confluence:User=admin;APIToken=myApiToken;Url=https://yoursitename.atlassian.net;Timezone=America/New_York;
Confluence のデータ のクエリ
Confluence のデータ に接続するには、Database ノードで接続を右クリックし、Connect をクリックします。接続が確立されたら、展開してスキーマ情報を確認できます。
Data Views ウィンドウにテーブルをロードするには、テーブルを右クリックして View Data をクリックします。。