CData JDBC Driver for SharePoint Excel Services はじめに：インストールから接続まで
このガイドでは、CData JDBC Driver for SharePoint Excel Services を使い始めるために必要な情報をすべて説明します。ドライバーのインストール方法とライセンス認証の手順から、最初の接続設定、そして Java アプリケーションで SharePoint Excel Services のデータ を活用するための次のステップまでをご紹介します。
インストールとライセンス
ドライバーのインストール
- CData の Web サイトから JDBC ドライバーのインストーラーをダウンロードします。
- インストーラーを実行し、インストールウィザードに従って進めます。
- ドライバーは次の場所にインストールされます： C:\Program Files\CData\CData JDBC Driver for SharePoint Excel Services 20xx\lib\
- JAR ファイルの名前は cdata.jdbc.excelservices.jar です。
インストールが完了したら、IDE やビルドツールを使用して、JAR ファイルを Java プロジェクトのクラスパスに追加できます。
ライセンスの有効化
CData Orders チームから送付されたメールでライセンスキーをお持ちのはずです。英数字のライセンスキーは次のような形式です：
XXXX-XXXX-XXXX-XXXX-XXXXWindows
Windows では、主なライセンス認証方法はライセンスファイルによる方法です。JDBC ドライバーをインストールすると、ライセンスファイルが自動的に作成され、ドライバーのインストールディレクトリに保存されます。アプリケーションで JAR がロードされると、ドライバーはこのライセンスファイルを自動的に検出して使用します。
ライセンスを手動で有効化または更新する必要がある場合は：
- インストールディレクトリにあるライセンスファイルを見つけます。
- ライセンスファイルをライセンスキーで更新します。
- ドライバーは次回の接続時に更新されたライセンスを自動的に使用します。
macOS/Linux
JAR のインストールディレクトリに移動し、lib フォルダーで次のコマンドを実行します： java -jar cdata.jdbc.excelservices.jar --license
プロンプトに従ってライセンスキーを入力します。これにより、インストールディレクトリにライセンスファイルが作成され、ドライバーがライセンス認証に使用します。
ライセンスファイルの設定方法について詳しくは、ヘルプドキュメントのGetting StartedサブページにあるLicensingセクションをご覧ください。
ライセンスに関するよくある質問
複数のマシンでライセンスを使用できますか？
はい、サブスクリプションのレベルによります。詳細については、注文確認書をご確認いただくか、担当営業にお問い合わせください。担当営業が不明な場合は、[email protected]までご連絡ください。
ライセンスキーを紛失しました。再発行は可能ですか？
注文番号を記載して[email protected]にメールをお送りください。ライセンスキーを再送いたします。
ライセンスを別のマシンに移行できますか？
はい、可能です。ライセンスを別のマシンに移行する際は、以下のリンクからライセンス移行リクエストを提出する必要があります：
https://jp.cdata.com/contact/
ライセンス移行リクエストが提出され、正常に処理されると、プロダクトキーに新しいアクティベーションが追加され、別のマシンで完全なライセンスを有効化できます。この処理が完了すると、以前のマシンのライセンスは無効になります。
ライセンスファイルの代わりに RTK を使用すべき場合は？
コンテナ、クラウドインスタンス、または複数のマシンにアプリケーションを配布する場合など、マシン/ノード ID が動的に変更される環境にデプロイする場合は RTK を使用してください。
ライセンスに関するその他のご質問は、[email protected]までお問い合わせください。ライセンスの確認とアップグレードは、セルフサービスポータル（portal.cdata.com）から行えるようになりました。
接続の設定
ドライバーのインストールとライセンス認証が完了したら、SharePoint Excel Services への接続を設定できます。JDBC 接続は、接続 URL（接続文字列とも呼ばれます）を使用して確立されます。
JDBC 接続 URL の理解
CData ドライバーの JDBC 接続 URL は次のパターンに従います：
jdbc:excelservices:URL=https://myorg.sharepoint.com;[email protected];Password=password;File=Book1.xlsx;接続 URL の構築
おすすめ：内蔵の接続文字列デザイナーを使用
JDBC ドライバーには、必要なすべての接続プロパティを含む正しい JDBC URL を構築するための接続文字列デザイナーツールが含まれています。
接続文字列デザイナーの起動方法：
- ドライバーのインストールディレクトリに移動します： C:\Program Files\CData\CData JDBC Driver for SharePoint Excel Services 20xx\lib\
- JAR ファイルをダブルクリックします：cdata.jdbc.excelservices.jar
または
コマンドラインから実行します： java -jar cdata.jdbc.excelservices.jar - 接続文字列デザイナーが起動します。
- 表示されるフィールドに接続プロパティを入力します。
- Test Connectionをクリックして設定を確認します。
- デザイナーから生成された JDBC URL をコピーします。
接続文字列デザイナーを使用すると、正しい構文で記述でき、SharePoint Excel Services で使用可能なすべての接続プロパティを確認できます。
ドライバークラス名
IntelliJ IDEA、Eclipse、DBeaver などの IDE やその他のツールで JDBC ドライバーを設定する際には、ドライバークラス名を指定する必要があります：
cdata.jdbc.excelservices.ExcelServicesDriver接続プロパティの設定
必要な接続プロパティは、データソースによって異なります。
ワークブックへの接続
どちらのSharePoint エディションをお使いでも、File を Excel ワークブックに設定してください。このパスは以下のプロパティからの相対パスになります。
- Library：デフォルトではShared Documents ライブラリが使用されます。このプロパティを使って、組織内の別のドキュメントライブラリを指定してみてください。例えば、OneDrive for Business に接続する場合は、このプロパティを"Documents" に設定します。
- Folder：このプロパティを使って、ライブラリ内のサブフォルダへのパスを指定できます。パスはLibrary で指定されたライブラリ名に関連します。
テーブルとしてのスプレッドシートデータへの接続
CData 製品では、基底API で利用可能なオブジェクトに基づいて、使用可能なテーブルを検出していきます。
API では異なるAPI オブジェクトを表示します。スプレッドシートの構成とSharePoint のバージョンに基づいてAPI を選択しましょう。
- OData： OData API を使用すると、Excel で［挿入］->［テーブル］をクリックして作成されたExcel テーブルオブジェクト（範囲やスプレッドシートではありません）から定義されたテーブルにアクセスできます。OData API に接続する際、ワークブックにテーブルオブジェクトが定義されていない場合は、CData 製品がテーブルを返さないことがあります。テーブルとしてスプレッドシートまたは範囲に接続するには、UseRESTAPI をtrue に設定してください。
- REST： REST API を使用すると、Excel テーブルオブジェクト、範囲、およびスプレッドシートから定義されたテーブルへアクセスできます。これがデフォルトの API です。範囲およびスプレッドシートから多数の行をリクエストすることは REST API によって制限されており、CData 製品では返される行数をデフォルトで 100 に制限しています。また CData 製品では、デフォルトで1行目からカラム名を検出します。これを無効にするには、Header を設定してください。
DefineTables を追加設定すると、Excel の範囲の構文を使用して、範囲に基づいてテーブルを定義できます。大きすぎる範囲は、API によって制限されます。
SharePoint オンプレミスへの接続
URL をサーバー名もしくはIP アドレスに設定しましょう。さらに、SharePointVersion と認証値を設定します。
SharePoint OnPremises を認証するには、AuthScheme を認証タイプに設定し、必要に応じてUser と Password を設定してください。
Note：SharePoint On-Premises 2010 に接続する場合は、 UseRESTAPI をtrue に設定する必要があります。
Windows（NTLM）
最も一般的な認証タイプです。CData 製品では NTLM をデフォルトとして使用するよう事前設定されています。Windows のUser と Password を設定して接続してください。
その他の認証方法については、ヘルプドキュメントの「はじめに」をご覧ください。
SharePoint Excel Services で使用可能なすべての接続プロパティの詳細については、ヘルプドキュメントのEstablishing a Connectionセクションをご覧ください。
接続のテスト
接続は次の方法でテストできます：
接続文字列デザイナーでのテスト
プロパティを入力後、Test Connectionボタンをクリックします。テストが成功すれば、認証情報と接続設定が正しいことが確認できます。
アプリケーションでのテスト
アプリケーションでドライバー JAR を特定の場所に移動する必要がある場合は、今すぐ移動し、JAR がアプリケーションのクラスパスに含まれていることを確認してください。また、ライセンス認証のために .lic ファイルも同じ場所に移動してください。
注意： DBeaver などの多くの JDBC 対応ツールでは、Test Connection 機能を使用する際にプロバイダーへのライブリクエストは実際には送信されません。 これは表面的なテストのみで、基本的に JAR ファイルが基本レベルで機能することをチェックするだけです。 JDBC 対応ツールを使用する場合は、有効な接続テストを確認するために ConnectOnOpen プロパティを True に設定する必要があります。
IDE で JDBC ドライバーを使用している場合は、簡単なクエリを実行して接続を確認できます：
import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; String url = "jdbc:excelservices:URL=https://myorg.sharepoint.com;[email protected];Password=password;File=Book1.xlsx; Connection conn = DriverManager.getConnection(url); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery("SELECT * FROM Account LIMIT 1"); if (rs.next()) { System.out.println("Connection successful!"); }
接続エラーが発生した場合は：
- 接続文字列デザイナーを使用して、接続プロパティが正しいことを確認します。
- ドライバー JAR がアプリケーションのクラスパスに含まれていることを確認します。
- エラーメッセージを確認し、具体的なガイダンスを参照します。
- トラブルシューティングのサポートが必要な場合は、エラーの詳細を添えて[email protected]にお問い合わせください。
よくある接続の問題
ドライバーが見つからない / ClassNotFoundException
解決方法：JDBC ドライバー JAR（cdata.jdbc.excelservices.jar）がプロジェクトのクラスパスに正しく追加されていることを確認してください。設定方法は IDE やビルドツールによって異なります。開発環境のドキュメントを参照するか、[email protected]にサポートをお問い合わせください。
認証エラー
解決方法：認証情報が正しく、最新であることを確認してください。接続文字列デザイナーを使用して、アプリケーションに追加する前に認証情報をテストしてください。SharePoint Excel Services の認証要件の詳細については、ヘルプドキュメントのEstablishing a Connectionセクションをご覧ください。
ネットワーク接続の問題
解決方法：ファイアウォールが必要なポートでの送信接続を許可していることを確認してください。データソースの具体的なポートとファイアウォール要件については、[email protected]にお問い合わせください。
無効な接続文字列フォーマット
解決方法：接続文字列デザイナーを使用して、正しい形式の JDBC URL を生成してください。デザイナーは正しい構文とプロパティ名を保証します。
その他のトラブルシューティングについては、具体的なエラーメッセージを添えて[email protected]にお問い合わせください。
次のステップ
ドライバーのインストール、ライセンス認証、設定が完了したので、CData JDBC ドライバーを活用する次のシナリオをご覧ください：
サポート
サポートが必要な場合は、以下までお問い合わせください：
- テクニカルサポート： [email protected]
- ナレッジベース： CData ナレッジベース
- コミュニティフォーラム： CData コミュニティサイト
- ヘルプドキュメント： ローカルにインストール済み、およびオンラインでも利用可能
よくある質問
インストールとライセンス
- JDBC ドライバーはどこにインストールされますか？
デフォルトのインストールディレクトリは以下のとおりです：
Windows： C:\Program Files\CData\CData JDBC Driver for SharePoint Excel Services\lib
Mac： /Application/CData JDBC Driver for SharePoint Excel Services/lib
Linux： /home//CData/CData JDBC Driver for SharePoint Excel Services /lib - ライセンスキーを取得するには？
ライセンスキーはご購入時にメールで送信されます。再送が必要な場合は、注文番号を添えて[email protected]にお問い合わせください。 - 複数のアプリケーションでライセンスを使用できますか？
はい、可能です。ライセンスファイルは、マシン上でドライバーを使用するすべての Java アプリケーションで機能します。 - RTK（Runtime Key）を使用すべき場合は？
コンテナ（Docker/Kubernetes）、クラウドインスタンス、または複数のマシンにアプリケーションを配布する場合など、マシン/ノード ID が動的に変更される環境にデプロイする場合は RTK を使用してください。RTK が必要な場合は、担当営業にお問い合わせください。
接続
- JDBC 接続 URL はどのように構築しますか？
内蔵の接続文字列デザイナーツールを使用してください。ドライバー JAR をダブルクリックするか、java -jar cdata.jdbc.excelservices.jar を実行してデザイナーを起動します。正しい形式の接続 URL の構築をサポートします。 - ドライバークラス名は何ですか？
ドライバークラスは次のパターンに従います：cdata.jdbc.excelservices.ExcelServicesDriver
IntelliJ IDEA、Eclipse、DBeaver などの IDE でドライバーを設定する際に必要です。 - SharePoint Excel Services に必要な接続プロパティは何ですか？
SharePoint Excel Services の必須およびオプションの接続プロパティの詳細については、ヘルプドキュメントのEstablishing a Connectionセクションをご覧ください。接続文字列デザイナーでも利用可能なすべてのプロパティを確認できます。 - 複数の SharePoint Excel Services アカウントに接続するには？
アカウントごとに異なる認証情報を使用して、個別の接続 URL を作成します。アプリケーション内で複数の接続を管理できます。 - 認証情報を安全に保存するには？
環境変数、設定ファイル、またはシークレット管理システム（AWS Secrets Manager や Azure Key Vault など）を使用してください。認証情報をソースコードにハードコードしないでください。
使用方法と開発
- どの SQL 操作がサポートされていますか？
サポートされている SQL 操作の一覧については、ヘルプドキュメントのSQL Compliance章をご覧ください。 - マルチスレッドアプリケーションでドライバーを使用できますか？
はい、可能です。スレッドセーフのための標準的な JDBC のベストプラクティスに従ってください。同時アクセスには接続プーリングを使用してください。 - IDE にドライバーを追加するには？
JAR ファイル（cdata.jdbc.excelservices.jar）をプロジェクトのクラスパスに追加します。外部 JAR の追加については、IDE のドキュメントを参照してください。ドライバークラス名は：cdata.jdbc.excelservices.ExcelServicesDriver
パフォーマンスとトラブルシューティング
- クエリが遅いのはなぜですか？
以下を確認してください：- 接続プーリングを使用します。
- フィルター（WHERE 句）を追加して結果セットのサイズを減らします。
- クエリの最適化のサポートについては、[email protected]にお問い合わせください。
- トラブルシューティングのためにログを有効にするには？
接続文字列にログプロパティを追加するか、Logfile プロパティを有効なファイルパスに設定し、Verbosity プロパティを目的のログレベルに設定して、アプリケーションでログを設定します（HTTP リクエストとレスポンスをキャプチャするには Verbosity=3 を推奨します）。ログ設定の詳細については、ヘルプドキュメントのAdvanced Featuresセクションをご覧ください。トラブルシューティングのサポートについては、[email protected]にお問い合わせください。 - どのファイアウォールポートを開く必要がありますか？
ポート要件はデータソースによって異なります。ほとんどのクラウドアプリケーションは HTTPS（ポート 443）を使用します。必要に応じて、ヘルプドキュメントのAdvanced FeaturesセクションでFirewall & Proxy設定を参照してください。SharePoint Excel Services の具体的なファイアウォール要件については、[email protected]にお問い合わせください。 - Docker でドライバーをデプロイするには？
Docker イメージにドライバー JAR を含め、接続文字列で RTK（Runtime Key）を使用してライセンス認証を行います。これにより、動的なコンテナのノード ID が処理されます。 - ClassNotFoundException が発生します。どうすれば修正できますか？
これは、ドライバー JAR がクラスパスにないことを意味します。JAR ファイルの場所を確認し、IDE またはビルド設定でプロジェクトのクラスパスに追加されていることを確認してください。
全般
- ヘルプドキュメントはどこにありますか？
ヘルプドキュメントは、インストールディレクトリ内のドライバーとともにインストールされており、CData の Web サイトでも利用可能です。 - ドライバーはどのくらいの頻度で更新されますか？
CData は年に一度、ドライバーのメジャーバージョンアップデートをリリースしています。最新バージョンについては、アカウントポータルを確認するか、[email protected]にお問い合わせください。 - 特定のユースケースのコード例はありますか？
はい、あります。ヘルプドキュメントには多数のコード例が含まれています。特定のシナリオの例が必要な場合は、[email protected]にお問い合わせください。
この FAQ で取り上げられていないご質問は、[email protected]にお問い合わせください。
はじめる準備はできましたか？
SharePoint Excel Services Driver の無料トライアルをダウンロードしてお試しください：
ダウンロード詳細：
SharePoint Excel Services JDBC Driver
お問い合わせ
SharePoint サーバーでホストされているリアルタイムなExcel スプレッドシートコンテンツを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。