Tomcat のコネクションプールで CData JDBC Driver for Smartsheet を構成

Jerod Johnson
Jerod Johnson
Senior Technology Evangelist
Tomcat のコネクションプールから Smartsheet のデータ に接続。

CData JDBC Driver は、JVM 上で動作するWeb アプリケーションと連携するための標準JDBC インターフェースをサポートしています。ここでは、Tomcat のコネクションプールから Smartsheet のデータ に接続する方法を説明します。

Smartsheet データ連携について

CData は、Smartsheet のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:

  • 添付ファイル、カラム、コメント、ディスカッションの読み取りと書き込みができます。
  • 個々のセルのデータを表示したり、セルの履歴をレポートしたりできます。
  • 添付ファイルの削除やダウンロード、シートの作成・コピー・削除・移動、行の別のシートへの移動やコピーなど、Smartsheet 固有のアクションを実行できます。

ユーザーは、Tableau、Crystal Reports、Excel などの分析ツールと Smartsheet を統合しています。また、当社のツールを活用して Smartsheet データをデータベースやデータウェアハウスにレプリケートしているお客様もいます。


はじめに


Tomcat のコネクションプールから Smartsheet のデータ に接続

  1. CData JAR ファイルと CData .lic ファイルを $CATALINA_HOME/lib にコピーします。CData JAR ファイルは、インストールディレクトリの lib サブフォルダにあります。
  2. コンテキストにリソースの定義を追加します。ここで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 に接続できるようになります。

  3. アプリケーションの web.xml にリソースへの参照を追加します。
    
      Smartsheet のデータ JSP
      jdbc/Smartsheet
      javax.sql.DataSource
      Container
    
    
  4. コネクションプールから接続を初期化します。
    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 を参照してください。

はじめる準備はできましたか?

Smartsheet Driver の無料トライアルをダウンロードしてお試しください:

 ダウンロード

詳細:

Smartsheet Icon Smartsheet JDBC Driver お問い合わせ

Java/J2EE アプリケーションからSmartsheet データへの連携機能を実装して、Contacts、Folders、Groups、Users などのデータをアプリから利用。