CData ODBC Driver for Linear のセットアップ

---

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

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

システム要件

• 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/contact/

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

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

---

接続設定

ドライバーのインストールとライセンス認証が完了したら、Linear への接続を設定しましょう。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 Linear を選択するか、追加 をクリックして新しいデータソースを作成します。
4. OK または 完了 をクリックして接続設定ダイアログを開きます。

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

1. odbcinst.ini ファイルに以下のセクションを追加してドライバーを登録します。
[CData ODBC Driver for Linear] Driver=/opt/cdata/cdata-odbc-driver-for-linear/lib/liblinearodbc.x64.so Description=CData ODBC Driver for Linear
2. ファイルを保存します。
3. odbc.ini ファイルに以下のエントリを追加して DSN を作成します：
[CData Linear Source] Driver=/opt/cdata/cdata-odbc-driver-for-linear/lib/liblinearodbc.x64.so ConnectionProperty1=Value1 ConnectionProperty2=Value2 AuthScheme = APIKey APIKey = myAPIKey
4. ファイルを保存します。

---

接続プロパティの設定

Linear への認証には、個人用 API キーまたは OAuth 2.0 を使用できます。ご自身の Linear アカウントで接続する場合は、API キーを使うのが最も手軽です。

API キーによる認証

以下の接続プロパティを設定します。

• AuthScheme：APIKey に設定します。
• APIKey：Linear の個人用 API キー。

個人用 API キーを作成するには、Linear にログインして Settings > Security & access > Personal API keys を開き、New API key を選択して作成します。キーは一度しか表示されないため、すぐにコピーしておきましょう。

OAuth による認証

OAuth を使用するには、Linear にカスタム OAuth アプリケーションを登録する必要があります（Settings > API > OAuth applications）。登録すると OAuthClientId と OAuthClientSecret が発行されます。対応しているフローは以下の 2 つです。

• Authorization code：AuthScheme を OAuth、InitiateOAuth を GETANDREFRESH に設定し、OAuthClientId、OAuthClientSecret、およびアプリケーションで定義した CallbackURL（例：http://localhost:33333）を指定します。ドライバーがブラウザで Linear を開くので、アクセスを許可してください。
• Client credentials：AuthScheme を OAuthClient に設定し、OAuthClientId と OAuthClientSecret を指定します。アプリケーション自体を認証するためブラウザ操作は不要で、マシン間（M2M）連携に適しています。

デフォルトでは、ドライバーは read,write スコープをリクエストします。アクセストークンは有効期限が切れると自動で更新されます。

---

接続のテスト

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 Linear};RequiredConnectionProperty1=Value1;RequiredConnectionProperty2=Value2;

• 複数の Linear アカウントに接続するにはどうすればよいですか？
  アカウントごとに個別の 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] までお問い合わせください。