Tomcat のコネクションプールで CData JDBC Driver for Smartsheet を構成
CData JDBC Driver は、JVM 上で動作するWeb アプリケーションと連携するための標準JDBC インターフェースをサポートしています。ここでは、Tomcat のコネクションプールから Smartsheet のデータ に接続する方法を説明します。
Smartsheet データ連携について
CData は、Smartsheet のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- 添付ファイル、カラム、コメント、ディスカッションの読み取りと書き込みができます。
- 個々のセルのデータを表示したり、セルの履歴をレポートしたりできます。
- 添付ファイルの削除やダウンロード、シートの作成・コピー・削除・移動、行の別のシートへの移動やコピーなど、Smartsheet 固有のアクションを実行できます。
ユーザーは、Tableau、Crystal Reports、Excel などの分析ツールと Smartsheet を統合しています。また、当社のツールを活用して Smartsheet データをデータベースやデータウェアハウスにレプリケートしているお客様もいます。
はじめに
Tomcat のコネクションプールから Smartsheet のデータ に接続
- CData JAR ファイルと CData .lic ファイルを $CATALINA_HOME/lib にコピーします。CData JAR ファイルは、インストールディレクトリの lib サブフォルダにあります。
- コンテキストにリソースの定義を追加します。ここでJDBC URL を指定します。
個人用トークンを使用して、自分のデータをテストし、アクセスします。個人用トークンを取得する方法は次のとおりです。
- Smartsheet にログインします。
- 「アカウント」をクリックして「個人用の設定」を選択します。
- 「API アクセス」をクリックし、フォームを使用して新しいアクセストークンを生成するか、既存のアクセストークンを管理します。
その後、OAuthAccessToken を生成したトークンに設定します。
組み込みの接続文字列デザイナー
JDBC URL の構成については、Smartsheet JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.smartsheet.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
以下のリソース定義で指定されたJDBC URL を確認できます。
<Resource name="jdbc/smartsheet" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.smartsheet.SmartsheetDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:smartsheet:OAuthClientId=MyOauthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;" maxActive="20" maxIdle="10" maxWait="-1" />
特定のアプリケーションのみに Smartsheet のデータ へのアクセスを許可するには、上記のコードをアプリケーションのMETA-INF ディレクトリにあるcontext.xml に追加します。
共有リソースの構成の場合は、上記のコードを $CATALINA_BASE/conf にあるcontext.xml に追加します。共有リソースの構成では、すべてのアプリケーションが Smartsheet に接続できるようになります。
- アプリケーションの web.xml にリソースへの参照を追加します。
Smartsheet のデータ JSP jdbc/Smartsheet javax.sql.DataSource Container
-
コネクションプールから接続を初期化します。
Context initContext = new InitialContext(); Context envContext = (Context)initContext.lookup("java:/comp/env"); DataSource ds = (DataSource)envContext.lookup("jdbc/Smartsheet"); Connection conn = ds.getConnection();
Tomcat との連携について
上記の手順では、シンプルなコネクションプーリングのシナリオで Smartsheet のデータ に接続する方法を説明しました。その他のユースケースや詳細については、Tomcat のドキュメントに記載されている JNDI Datasource How-To を参照してください。