CData ODBC Driver for Azure Data Lake Storage のセットアップ

このガイドでは、CData ODBC Driver for Azure Data Lake Storage を使い始めるために必要なすべてのステップを解説します。ドライバーのインストールとライセンス認証、初めての接続設定、そしてアプリケーションでAzure Data Lake Storage のデータを活用するための次のステップを学ぶことができます。

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

システム要件

• Windows: Windows 10/11 または Windows Server 2016 以降
• Linux: UnixODBC がインストールされた主要なディストリビューション

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

Windows でのインストール

1. CData アカウントまたは評価版ダウンロードページから ODBC ドライバーのインストーラーをダウンロードします。
2. インストーラーを実行し、インストールウィザードの指示に従って進めます。
3. セットアッププロセスが自動的に進み、ドライバーがシステムに登録されます。
4. インストール中に、ライセンスを有効化するためのライセンスキーの入力を求められます。ライセンスキーは CData 注文チームからメールで届いているはずです。ライセンスキーは次のような形式です： XXXX-XXXX-XXXX-XXXX-XXXX
   • 注意：トライアル版をご利用の場合は、Trial Key オプションを選択してください。
5. 32 ビット版と 64 ビット版の両方のドライバーが含まれています。異なるアーキテクチャのアプリケーションを使用する場合は、両方をインストールしてください。

Linux でのインストール

1. UnixODBC がインストールされていることを確認します： sudo apt-get install unixodbc unixodbc-dev (Debian/Ubuntu) sudo yum install unixODBC unixODBC-devel (RHEL/CentOS)
2. ドライバーパッケージを /opt/cdata/ に展開します
3. ドライバーは自動的に /etc/odbcinst.ini に登録されます

ライセンスの有効化

ライセンスキーは CData 注文チームからメールで届いているはずです。ライセンスキーは次のような形式です： XXXX-XXXX-XXXX-XXXX-XXXX

Windows でのライセンス認証

通常、ライセンスはインストール時に有効化されます。ただし、手動で有効化が必要な場合もあります。以下の手順で手動認証を行います：

1. スタートメニューから ODBC ドライバーアプリケーションを開きます。
2. Help > Licensing に移動します
3. 表示されたフィールドにライセンスキーを入力します。
4. Activate をクリックします
5. 「Licensed」ステータスが表示されれば、認証は完了です。

Linux でのライセンス認証

1. ドライバーパッケージを展開したインストールディレクトリに移動します（例：cd /opt/cdata/cdata-odbc-driver-for-acumatica/bin/）
2. 次のコマンドを実行してライセンスファイルを作成します：sudo ./install-license.sh
3. を実際のライセンスキーに置き換えてください。
4. トライアル版を有効化する場合は、 を省略してください。

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

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

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

ライセンスを別のマシンに移行できますか？
はい、可能です。別のマシンへの移行時には、以下のリンクからライセンス移行リクエストを送信してください：

https://jp.cdata.com/lic/transfer/

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

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

接続設定

ドライバーのインストールとライセンス認証が完了したら、Azure Data Lake Storage への接続を設定しましょう。ODBC ドライバーは DSN（データソース名）を使用して接続プロパティを保存します。

DSN の作成

Windows：ODBC データソースアドミニストレーターを使用

1. ODBC データソースアドミニストレーター（64 ビット）を開きます
   注意：64 ビットアプリケーションには 64 ビット版、32 ビットアプリケーションには 32 ビット版を使用してください。
   • Windows のスタートメニューで「ODBC」を検索
   • または、コントロールパネル > 管理ツール > ODBC データソースから開きます
2. システム DSN または ユーザー DSN タブをクリックします
   • システム DSN：マシン上のすべてのユーザーが利用可能（サービス用に推奨）
   • ユーザー DSN：現在のユーザーのみ利用可能
3. リストから CData ODBC Driver for Azure Data Lake Storage を選択するか、追加 をクリックして新しいデータソースを作成します。
4. OK または 完了 をクリックして接続設定ダイアログを開きます。

Linux：設定ファイルの編集（odbcinst.ini と odbc.ini）

1. odbcinst.ini ファイルに以下のセクションを追加してドライバーを登録します。
[CData ODBC Driver for Azure Data Lake Storage] Driver=/opt/cdata/cdata-odbc-driver-for-adls/lib/libadlsodbc.x64.so Description=CData ODBC Driver for Azure Data Lake Storage
2. ファイルを保存します。
3. odbc.ini ファイルに以下のエントリを追加して DSN を作成します：
[CData Azure Data Lake Storage Source] Driver=/opt/cdata/cdata-odbc-driver-for-adls/lib/libadlsodbc.x64.so ConnectionProperty1=Value1 ConnectionProperty2=Value2 Schema = ADLSGen2 Account = myAccount FileSystem = myFileSystem AccessKey = myAccessKey
4. ファイルを保存します。

接続プロパティの設定

Azure Data Lake Storage 接続プロパティの取得・設定方法

Azure Data Lake Storage Gen2 への接続

それでは、Gen2 Data Lake Storage アカウントに接続していきましょう。接続するには、以下のプロパティを設定します。

• Account：ストレージアカウントの名前
• FileSystem：このアカウントに使用されるファイルシステム名。例えば、Azure Blob コンテナの名前
• Directory（オプション）：レプリケートされたファイルが保存される場所へのパス。パスが指定されない場合、ファイルはルートディレクトリに保存されます

Azure Data Lake Storage Gen2への認証

続いて、認証方法を設定しましょう。CData 製品では、5つの認証方法をサポートしています：アクセスキー（AccessKey）の使用、共有アクセス署名（SAS）の使用、Azure Active Directory OAuth（AzureAD）経由、Azure サービスプリンシパル（AzureServicePrincipal またはAzureServicePrincipalCert）経由、およびManaged Service Identity（AzureMSI）経由です。

アクセスキー

アクセスキーを使用して接続するには、まずADLS Gen2ストレージアカウントで利用可能なアクセスキーを取得する必要があります。

Azure ポータルでの手順は以下のとおりです：

1. ADLS Gen2ストレージアカウントにアクセスします
2. 設定でアクセスキーを選択します
3. 利用可能なアクセスキーの1つの値をAccessKey 接続プロパティにコピーします

接続の準備ができたら、以下のプロパティを設定してください。

• AuthScheme：AccessKey
• AccessKey：先ほどAzure ポータルで取得したアクセスキーの値

共有アクセス署名（SAS）

共有アクセス署名を使用して接続するには、まずAzure Storage Explorer ツールを使用して署名を生成する必要があります。

接続の準備ができたら、以下のプロパティを設定してください。

• AuthScheme：SAS
• SharedAccessSignature：先ほど生成した共有アクセス署名の値

その他の認証方法については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Azure Data Lake Storage Gen2への認証」セクションをご確認ください。

接続のテスト

1. 接続プロパティを入力したら、Test Connection をクリックします。
2. テストが成功すると、以下が確認できます：
   • 認証情報が正しい
   • ネットワーク接続が確立されている
   • 必要な権限が設定されている
3. テストが失敗した場合、エラーメッセージに修正すべき点が表示されます。
4. OK をクリックして DSN を保存します。

よくある接続の問題

認証に失敗

解決策：認証情報が最新であることを確認してください。OAuth アプリケーションの場合、アプリケーションのセキュリティ設定で CData を認可する必要があるかもしれません。認可に関するサポートは [email protected] までお問い合わせください。

サーバーに接続できない

解決策：ファイアウォールとプロキシの設定を確認してください。特定のポート要件については [email protected] までお問い合わせください。

テーブルが見つからない

解決策：データベース名とスキーマ名を確認してください。DSN 設定の Data Model タブで利用可能なテーブルを確認できます。

ドライバーが見つからない（Linux）

解決策：ドライバーが odbcinst.ini に正しく登録されていることを確認してください。詳しいサポートは [email protected] までお問い合わせください。

その他の接続に関するトラブルシューティングは、具体的なエラーメッセージを添えて [email protected] までお問い合わせください。

次のステップ

ドライバーのインストール、ライセンス認証、接続設定が完了したので、ODBC ドライバーを活用できるシナリオをご紹介します：

サポート

お困りの際はお気軽にお問い合わせください：

• テクニカルサポート：[email protected]
• コミュニティフォーラム：CData Community Site
• ヘルプドキュメント：ローカルインストール版とオンライン版があります

よくある質問

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

• ドライバーのインストールに管理者権限は必要ですか？
  はい、Windows と Linux のどちらでもシステム全体へのインストールには管理者権限が必要です。
• 32 ビットと 64 ビットのドライバーを同じマシンにインストールできますか？
  はい、デフォルトで両方のバージョンがインストールされます。

接続

• システム DSN とユーザー DSN の違いは何ですか？
  システム DSN はマシン上のすべてのユーザーが利用でき、サービスで必要です。ユーザー DSN は作成したユーザーのみが利用できます。
• DSN を作成せずに DSN レス接続文字列を使用できますか？
  はい。多くのアプリケーションは DSN レス接続文字列をサポートしています。以下の接続文字列の例をご参照ください：

  Driver={CData ODBC Driver for Azure Data Lake Storage};RequiredConnectionProperty1=Value1;RequiredConnectionProperty2=Value2;

• 複数の Azure Data Lake Storage アカウントに接続するにはどうすればよいですか？
  アカウントごとに個別の DSN を作成し、それぞれに認証情報を設定してください。
• プロキシサーバー経由で接続できますか？
  はい。DSN の接続プロパティでプロキシ設定を行ってください。プロキシ設定の詳細はヘルプドキュメントの Firewall & Proxy セクションをご参照ください。

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

• クエリが遅いのはなぜですか？
  以下を確認してください：
  • 変更頻度の低いデータにはキャッシュを使用します。詳細はヘルプドキュメントの Caching Data セクションをご参照ください。
  • フィルタ（WHERE 句）を追加して結果セットのサイズを小さくします。
  • クエリ最適化のサポートは [email protected] までお問い合わせください。
• トラブルシューティング用のログを有効にするにはどうすればよいですか？
  DSN に以下を追加してください：
  • Logfile: /path/to/logfile.log
  • Verbosity: 3

  [email protected] にトラブルシューティングをご依頼の際は、ログファイルを安全にアップロードできるようご準備ください。

• ドライバーにはどのポートへのアクセスが必要ですか？
  データソースによって異なります。ほとんどのクラウドアプリケーションは HTTPS（ポート 443）を使用します。具体的なファイアウォール要件については [email protected] までお問い合わせください。
• Linux コンテナや Docker でドライバーを使用できますか？
  はい。コンテナイメージにドライバーをインストールし、コンテナの /etc/odbc.ini ファイルで DSN を設定してください。

その他

• サポートされている SQL 操作の完全なリストはどこで確認できますか？
  完全な SQL リファレンスについてはヘルプドキュメントの SQL Compliance の章をご参照ください。
• ドライバーの更新頻度は？
  CData は年に一度、ドライバーのメジャーバージョンアップデートをリリースしています。最新バージョンについてはアカウントポータルを確認するか、[email protected] までお問い合わせください。
• プログラミング言語ごとのコード例はどこで確認できますか？
  言語固有の例（Python、PHP、C# など）についてはヘルプドキュメントの Using ODBC セクションをご確認ください。

この FAQ で解決しないご質問は [email protected] までお問い合わせください。