CData JDBC Driver for Amazon S3 はじめに：インストールから接続まで

---

このガイドでは、CData JDBC Driver for Amazon S3 を使い始めるために必要な情報をすべて説明します。ドライバーのインストール方法とライセンス認証の手順から、最初の接続設定、そして Java アプリケーションで Amazon S3 のデータ を活用するための次のステップまでをご紹介します。

インストールとライセンス

ドライバーのインストール

1. CData の Web サイトから JDBC ドライバーのインストーラーをダウンロードします。
2. インストーラーを実行し、インストールウィザードに従って進めます。
3. ドライバーは次の場所にインストールされます： C:\Program Files\CData\CData JDBC Driver for Amazon S3 20xx\lib\
4. JAR ファイルの名前は cdata.jdbc.amazons3.jar です。

インストールが完了したら、IDE やビルドツールを使用して、JAR ファイルを Java プロジェクトのクラスパスに追加できます。

---

ライセンスの有効化

CData Orders チームから送付されたメールでライセンスキーをお持ちのはずです。英数字のライセンスキーは次のような形式です：

XXXX-XXXX-XXXX-XXXX-XXXX

Windows

Windows では、主なライセンス認証方法はライセンスファイルによる方法です。JDBC ドライバーをインストールすると、ライセンスファイルが自動的に作成され、ドライバーのインストールディレクトリに保存されます。アプリケーションで JAR がロードされると、ドライバーはこのライセンスファイルを自動的に検出して使用します。

ライセンスを手動で有効化または更新する必要がある場合は：

1. インストールディレクトリにあるライセンスファイルを見つけます。
2. ライセンスファイルをライセンスキーで更新します。
3. ドライバーは次回の接続時に更新されたライセンスを自動的に使用します。

macOS/Linux

JAR のインストールディレクトリに移動し、lib フォルダーで次のコマンドを実行します： java -jar cdata.jdbc.amazons3.jar --license

プロンプトに従ってライセンスキーを入力します。これにより、インストールディレクトリにライセンスファイルが作成され、ドライバーがライセンス認証に使用します。

ライセンスファイルの設定方法について詳しくは、ヘルプドキュメントのGetting StartedサブページにあるLicensingセクションをご覧ください。

---

ライセンスに関するよくある質問

複数のマシンでライセンスを使用できますか？
はい、サブスクリプションのレベルによります。詳細については、注文確認書をご確認いただくか、担当営業にお問い合わせください。担当営業が不明な場合は、[email protected]までご連絡ください。

ライセンスキーを紛失しました。再発行は可能ですか？
注文番号を記載して[email protected]にメールをお送りください。ライセンスキーを再送いたします。

ライセンスを別のマシンに移行できますか？
はい、可能です。ライセンスを別のマシンに移行する際は、以下のリンクからライセンス移行リクエストを提出する必要があります：

https://jp.cdata.com/contact/

ライセンス移行リクエストが提出され、正常に処理されると、プロダクトキーに新しいアクティベーションが追加され、別のマシンで完全なライセンスを有効化できます。この処理が完了すると、以前のマシンのライセンスは無効になります。

ライセンスファイルの代わりに RTK を使用すべき場合は？
コンテナ、クラウドインスタンス、または複数のマシンにアプリケーションを配布する場合など、マシン/ノード ID が動的に変更される環境にデプロイする場合は RTK を使用してください。

ライセンスに関するその他のご質問は、[email protected]までお問い合わせください。ライセンスの確認とアップグレードは、セルフサービスポータル（portal.cdata.com）から行えるようになりました。

---

接続の設定

ドライバーのインストールとライセンス認証が完了したら、Amazon S3 への接続を設定できます。JDBC 接続は、接続 URL（接続文字列とも呼ばれます）を使用して確立されます。

JDBC 接続 URL の理解

CData ドライバーの JDBC 接続 URL は次のパターンに従います：

jdbc:amazons3:AccessKey=a123;SecretKey=s123;

接続 URL の構築

おすすめ：内蔵の接続文字列デザイナーを使用

JDBC ドライバーには、必要なすべての接続プロパティを含む正しい JDBC URL を構築するための接続文字列デザイナーツールが含まれています。

接続文字列デザイナーの起動方法：

1. ドライバーのインストールディレクトリに移動します： C:\Program Files\CData\CData JDBC Driver for Amazon S3 20xx\lib\
2. JAR ファイルをダブルクリックします：cdata.jdbc.amazons3.jar
   または
   コマンドラインから実行します： java -jar cdata.jdbc.amazons3.jar
3. 接続文字列デザイナーが起動します。
4. 表示されるフィールドに接続プロパティを入力します。
5. Test Connectionをクリックして設定を確認します。
6. デザイナーから生成された JDBC URL をコピーします。

接続文字列デザイナーを使用すると、正しい構文で記述でき、Amazon S3 で使用可能なすべての接続プロパティを確認できます。

ドライバークラス名

IntelliJ IDEA、Eclipse、DBeaver などの IDE やその他のツールで JDBC ドライバーを設定する際には、ドライバークラス名を指定する必要があります：

cdata.jdbc.amazons3.AmazonS3Driver

接続プロパティの設定

必要な接続プロパティは、データソースによって異なります。

Amazon S3 リクエストを認可するには、管理者アカウントまたはカスタム権限を持つIAM ユーザーの認証情報を入力します。AccessKey をアクセスキーID に設定します。SecretKey をシークレットアクセスキーに設定します。

Note: AWS アカウント管理者として接続できますが、AWS サービスにアクセスするにはIAM ユーザー認証情報を使用することをお勧めします。

尚、CData 製品はAmazon S3 のファイルの一覧表示やユーザー管理情報の取得用です。S3 に保管されているExcel、CSV、JSON などのファイル内のデータを読み込みたい場合には、Excel Driver、CSV Driver、JSON Driver をご利用ください。

アクセスキーの取得

IAM ユーザーの資格情報を取得するには：

1. IAM コンソールにサインインします。
2. ナビゲーションペインで「ユーザー」を選択します。
3. ユーザーのアクセスキーを作成または管理するには、ユーザーを選択してから「セキュリティ認証情報」タブを選択します。

AWS ルートアカウントの資格情報を取得するには：

1. ルートアカウントの資格情報を使用してAWS 管理コンソールにサインインします。
2. アカウント名または番号を選択し、表示されたメニューで「My Security Credentials」を選択します。
3. 「Continue to Security Credentials」をクリックし、「Access Keys」セクションを展開して、ルートアカウントのアクセスキーを管理または作成します。

AWS ロールとして認証

多くの場合、認証にはAWS ルートユーザーのダイレクトなセキュリティ認証情報ではなく、IAM ロールを使用することをお勧めします。RoleARN を指定することでAWS ロールを代わりに使用できます。これにより、CData 製品は指定されたロールの資格情報を取得しようと試みます。

（すでにEC2 インスタンスなどで接続されているのではなく）AWS に接続している場合は、ロールを引き受けるIAM ユーザーのAccessKey とSecretKey を追加で指定する必要があります。AWS ルートユーザーのAccessKey および SecretKey を指定する場合、ロールは使用できません。

SSO 認証

SSO 認証を必要とするユーザーおよびロールには、RoleARN およびPrincipalArn 接続プロパティを指定してください。各Identity Provider に固有のSSOProperties を指定し、AccessKey とSecretKey を空のままにする必要があります。これにより、CData 製品は一時的な認証資格情報を取得するために、リクエストでSSO 認証情報を送信します。

Amazon S3 で使用可能なすべての接続プロパティの詳細については、ヘルプドキュメントの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:amazons3:AccessKey=a123;SecretKey=s123;
Connection conn = DriverManager.getConnection(url);
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM ObjectsACL LIMIT 1");

if (rs.next()) {
    System.out.println("Connection successful!");
}

接続エラーが発生した場合は：

1. 接続文字列デザイナーを使用して、接続プロパティが正しいことを確認します。
2. ドライバー JAR がアプリケーションのクラスパスに含まれていることを確認します。
3. エラーメッセージを確認し、具体的なガイダンスを参照します。
4. トラブルシューティングのサポートが必要な場合は、エラーの詳細を添えて[email protected]にお問い合わせください。

---

よくある接続の問題

ドライバーが見つからない / ClassNotFoundException

解決方法：JDBC ドライバー JAR（cdata.jdbc.amazons3.jar）がプロジェクトのクラスパスに正しく追加されていることを確認してください。設定方法は IDE やビルドツールによって異なります。開発環境のドキュメントを参照するか、[email protected]にサポートをお問い合わせください。

認証エラー

解決方法：認証情報が正しく、最新であることを確認してください。接続文字列デザイナーを使用して、アプリケーションに追加する前に認証情報をテストしてください。Amazon S3 の認証要件の詳細については、ヘルプドキュメントの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 Amazon S3 \lib
  Mac： /Application/CData JDBC Driver for Amazon S3 /lib
  Linux： /home//CData/CData JDBC Driver for Amazon S3 /lib
• ライセンスキーを取得するには？
  ライセンスキーはご購入時にメールで送信されます。再送が必要な場合は、注文番号を添えて[email protected]にお問い合わせください。
• 複数のアプリケーションでライセンスを使用できますか？
  はい、可能です。ライセンスファイルは、マシン上でドライバーを使用するすべての Java アプリケーションで機能します。
• RTK（Runtime Key）を使用すべき場合は？
  コンテナ（Docker/Kubernetes）、クラウドインスタンス、または複数のマシンにアプリケーションを配布する場合など、マシン/ノード ID が動的に変更される環境にデプロイする場合は RTK を使用してください。RTK が必要な場合は、担当営業にお問い合わせください。

接続

• JDBC 接続 URL はどのように構築しますか？
  内蔵の接続文字列デザイナーツールを使用してください。ドライバー JAR をダブルクリックするか、java -jar cdata.jdbc.amazons3.jar を実行してデザイナーを起動します。正しい形式の接続 URL の構築をサポートします。
• ドライバークラス名は何ですか？
  ドライバークラスは次のパターンに従います：cdata.jdbc.amazons3.AmazonS3Driver
  IntelliJ IDEA、Eclipse、DBeaver などの IDE でドライバーを設定する際に必要です。
• Amazon S3 に必要な接続プロパティは何ですか？
  Amazon S3 の必須およびオプションの接続プロパティの詳細については、ヘルプドキュメントのEstablishing a Connectionセクションをご覧ください。接続文字列デザイナーでも利用可能なすべてのプロパティを確認できます。
• 複数の Amazon S3 アカウントに接続するには？
  アカウントごとに異なる認証情報を使用して、個別の接続 URL を作成します。アプリケーション内で複数の接続を管理できます。
• 認証情報を安全に保存するには？
  環境変数、設定ファイル、またはシークレット管理システム（AWS Secrets Manager や Azure Key Vault など）を使用してください。認証情報をソースコードにハードコードしないでください。

使用方法と開発

• どの SQL 操作がサポートされていますか？
  サポートされている SQL 操作の一覧については、ヘルプドキュメントのSQL Compliance章をご覧ください。
• マルチスレッドアプリケーションでドライバーを使用できますか？
  はい、可能です。スレッドセーフのための標準的な JDBC のベストプラクティスに従ってください。同時アクセスには接続プーリングを使用してください。
• IDE にドライバーを追加するには？
  JAR ファイル（cdata.jdbc.amazons3.jar）をプロジェクトのクラスパスに追加します。外部 JAR の追加については、IDE のドキュメントを参照してください。ドライバークラス名は：cdata.jdbc.amazons3.AmazonS3Driver

パフォーマンスとトラブルシューティング

• クエリが遅いのはなぜですか？
  以下を確認してください：
  • 接続プーリングを使用します。
  • フィルター（WHERE 句）を追加して結果セットのサイズを減らします。
  • クエリの最適化のサポートについては、[email protected]にお問い合わせください。
• トラブルシューティングのためにログを有効にするには？
  接続文字列にログプロパティを追加するか、Logfile プロパティを有効なファイルパスに設定し、Verbosity プロパティを目的のログレベルに設定して、アプリケーションでログを設定します（HTTP リクエストとレスポンスをキャプチャするには Verbosity=3 を推奨します）。ログ設定の詳細については、ヘルプドキュメントのAdvanced Featuresセクションをご覧ください。トラブルシューティングのサポートについては、[email protected]にお問い合わせください。
• どのファイアウォールポートを開く必要がありますか？
  ポート要件はデータソースによって異なります。ほとんどのクラウドアプリケーションは HTTPS（ポート 443）を使用します。必要に応じて、ヘルプドキュメントのAdvanced FeaturesセクションでFirewall & Proxy設定を参照してください。Amazon S3 の具体的なファイアウォール要件については、[email protected]にお問い合わせください。
• Docker でドライバーをデプロイするには？
  Docker イメージにドライバー JAR を含め、接続文字列で RTK（Runtime Key）を使用してライセンス認証を行います。これにより、動的なコンテナのノード ID が処理されます。
• ClassNotFoundException が発生します。どうすれば修正できますか？
  これは、ドライバー JAR がクラスパスにないことを意味します。JAR ファイルの場所を確認し、IDE またはビルド設定でプロジェクトのクラスパスに追加されていることを確認してください。

全般

• ヘルプドキュメントはどこにありますか？
  ヘルプドキュメントは、インストールディレクトリ内のドライバーとともにインストールされており、CData の Web サイトでも利用可能です。
• ドライバーはどのくらいの頻度で更新されますか？
  CData は年に一度、ドライバーのメジャーバージョンアップデートをリリースしています。最新バージョンについては、アカウントポータルを確認するか、[email protected]にお問い合わせください。
• 特定のユースケースのコード例はありますか？
  はい、あります。ヘルプドキュメントには多数のコード例が含まれています。特定のシナリオの例が必要な場合は、[email protected]にお問い合わせください。

この FAQ で取り上げられていないご質問は、[email protected]にお問い合わせください。