CData ODBC Driver for Hugging Face のセットアップ

CData ODBC Driver for Hugging Face のインストール、ライセンス認証、接続設定の完全ガイドです。

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

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

システム要件

  • 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 から行えます。

接続設定

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

DSN の作成

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

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

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

  1. odbcinst.ini ファイルに以下のセクションを追加してドライバーを登録します。
    2. [CData API Driver for ODBC] Driver=/opt/cdata/cdata-odbc-driver-for-api/lib/libapiodbc.x64.so Description=CData API Driver for ODBC
  2. ファイルを保存します。
  3. odbc.ini ファイルに以下のエントリを追加して DSN を作成します：
    4. [CData Hugging Face Source] Driver=/opt/cdata/cdata-odbc-driver-for-api/lib/libapiodbc.x64.so ConnectionProperty1=Value1 ConnectionProperty2=Value2 Profile = C:\profiles\HuggingFace.apip ProfileSettings = 'APIKey = hf_xxxxxxxxxxxxxxxxxxxx'
  4. ファイルを保存します。

接続プロパティの設定

HuggingFace Hub は、API へのアクセスを可能にするためにトークンベースの認証を使用します。この API では、HuggingFace Hub プラットフォーム上の機械学習モデル、データセット、スペース、論文、その他のリソースにアクセスできます。

API キー認証の設定

HuggingFace Hub への認証には、API Key（アクセストークン）を指定する必要があります。アクセストークンを取得するには、以下のステップで進めます：

  1. https://huggingface.co で HuggingFace アカウントにログインします
  2. Settings > Access Tokens に移動します
  3. 「New token」をクリックして新しいアクセストークンを作成します
  4. 適切な権限（read または write）を選択します
  5. トークンの値をコピーします

アクセストークンを取得したら、以下の接続プロパティを設定します：

  • AuthScheme：APIKey に設定します。
  • APIKey：HuggingFace のアクセストークンに設定します。

接続文字列の例

Profile=C:\profiles\HuggingFace.apip;ProfileSettings='APIKey=hf_xxxxxxxxxxxxxxxxxxxx';

接続のテスト

  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 ドライバーを活用できるシナリオをご紹介します：

ODBC クライアント記事タイトル
BoardHugging Face のデータをBoard に連携してビジュアライズを作成
Clear AnalyticsClear Analytics でHugging Face のデータを使ってチャートを作成
CoReportsシーオーリポーツ 帳票クリエータでHugging Face のデータを利用した帳票を作成
Crystal ReportsCrystal Reports にHugging Face を連携してHugging Face のデータを使った帳票を作成
DataKnowledge国産セルフサービスBI ツールData Knowledge でHugging Face のデータを分析・可視化する方法
DBxtraDBxtra でHugging Face のデータを使ってダッシュボードを構築
DomoDomo Workbench のHugging Face からデータセットを作成し、Domo からHugging Face データに連携するビジュアライゼーションを作成
Dundas BIDundas BI でHugging Face のデータを使ってダッシュボードを構築
Excel QueryExcel からMicrosoft Query を使ってHugging Face に接続する方法
ExploratoryExploratory でHugging Face のデータを連携する方法
IBM Cognos BICognos BI でHugging Face のデータを使ってデータビジュアライゼーションを作成
MicroStrategy DesktopMicroStrategy Desktop で CData Software ODBC Driver for Hugging Face を使用
MicroStrategy WebMicroStrategy Web でHugging Face ODBC Driver を使用
MySQL AWS QuickSightAmazon QuickSight で MySQL 接続を使用して Hugging Face のデータにアクセス
OBIEEOBIEE での Hugging Face レポーティングとスタースキーマ
Power BI DesignerMicrosoft Power BI Designer でCData ODBC Driver を使ってHugging Face につないでみた
Power BI Report ServerPower BI Report Server でリアルタイム Hugging Face データのレポートを表示
Power MapPower Map で Hugging Face データの地理的関係を探索
Power ViewPower View でのHugging Face のデータのインポートとビジュアライズ
PowerPivotPowerPivot でHugging Face のデータを連携して取得し分析
QlikViewQlikView でHugging Face のデータにODBC 接続で連携してビジュアライズ
RODBC 経由で R から Hugging Face データを分析
SAP BusinessObjectsHugging Face のデータにSAP BusinessObject Universe からリアルタイム連携
SAS【ノーコード】SAS でHugging Face データを可視化・分析する方法
SAS JMPSAS JMP でのCData ODBC Driver for Hugging Face の使用
SharePoint ExcelSharePoint Excel Services からCData ODBC Driver for Hugging Face を使用
SpotfireTIBCO Spotfire から、ODBC 経由でHugging Face のデータに連携してビジュアライズ
SPSS ModelerHugging Face のデータを IBM SPSS Modeler にシームレスにインポート
SSAS TabularHugging Face のデータから SSAS テーブルモデルを作成
Tableau BridgeTableau Bridge でTableau Cloud からのHugging Face のデータ連携を実現
Tableau ServerTableau Server へのHugging Face ダッシュボードの公開・パブリッシュ
A5:SQL Mk-2Hugging Face のデータをA5:SQL Mk-2 でCRUD クエリする方法
CacheHugging Face のデータをSQL Server に同期（キャッシュ）する方法
DB ArtisanDBArtisan でHugging Face のデータに連携
DBeaverDBeaver でHugging Face のデータに接続
MySQL WorkbenchMySQL Workbench で Hugging Face のデータをクエリする方法
OpenOffice BaseOpenOffice Base で Hugging Face のデータを簡単にクエリする方法
RAD Data ExplorerRAD Studio Data Explorer で Hugging Face データを表示
SQL CacheHugging Face のデータをPowerShell script でSQL Server にレプリケートする方法
SQL ComparisonHugging Face のデータをSQL Server に連携して利用する4つの方法を比較
SQL Server【完全ガイド】Hugging FaceからSQL Serverへの接続方法4選 - 用途別におすすめの方法を解説
.NET QueryBuilderActive Query Builder を使用してHugging Face 駆動型アプリを素早く開発
AsprovaCData ODBC Driver を使ってAsprovaをHugging Face と連携
C++BuilderC++Builder でHugging Face のデータにデータバインドするコントロールを作成
ColdFusionColdFusion で ODBC 経由のHugging Face のデータをリアルタイムにインポートしてアプリケーションを構築
Contexer業務アプリ構築ツールコンテキサーで、Hugging Face と連携したアプリを作成する方法
CreateForm帳票作成ツールのCreate!Form でHugging Face のデータを利用した帳票を作成
DelphiDelphi のHugging Face のデータへのデータバインドコントロール
FileMaker ESSClaris FileMaker のESS 機能からHugging Face のデータに連携する方法
Filemaker ProHugging Face のデータをFileMaker Pro にインポートする方法
FileMaker ScriptingClaris FileMaker Pro のスクリプト機能を使ってHugging Face のデータに接続
GoLinux 上でHugging Face のデータに接続するGo アプリケーションを作成する方法
Lazarus IDELazarus Pascal IDE で Hugging Face のデータを簡単に統合
MATLABMATLAB からHugging Face のデータをリアルタイムに連携利用
MySQL Apps ScriptSQL Gateway 経由で Google Apps Script から Hugging Face のデータに接続
MySQL Node.jsNode.js で Hugging Face のデータを MySQL データベースとしてクエリ
MySQL PHPPHP でMySQL からHugging Face のデータにアクセス
PHPPHP からHugging Face のデータに接続する方法
PHP (Linux)Linux/Unix 上でPHP からHugging Face のデータに接続・連携
PowerBuilderODBC 経由で PowerBuilder から Hugging Face データに接続
PrintStreamWeb 帳票ツール PrintStream でHugging Face のデータを利用した帳票を作成
PyCharmPyCharm でCData ODBC Driver を使ってHugging Face に接続
PythonLinux/UNIX 上のPython からHugging Face のデータにデータ連携
RubyRuby でHugging Face のデータ連携アプリを構築
STILLStiLL からCData ODBC Driver を使ってHugging Face につないでみた
VCL App (RAD Studio)Hugging Face データ用のシンプルな VCL アプリケーションを構築
Waha!Waha! Transformer からCData ODBC Driver を使ってHugging Face につないでみた
Access Linked TablesMicrosoft Access リンクテーブルからHugging Face のデータに接続・更新する方法
Gateway SQLSQL Server からHugging Face へストアドプロシージャで自動連携：SQL Gateway
MySQL Federated TablesMySQL のFederated Table としてHugging Face のデータを連携利用する
Oracle DatabaseRemote Oracle Database としてHugging Face のデータにアクセス
PostgreSQL FDWHugging Face のデータのPostgreSQL インターフェース
SQL Server Linked Servers【徹底解説】Hugging Face のデータをSQL Server のリンクサーバーにノーコードで連携する方法
CSA Data UploaderCSA Data Uploader にてHugging Face のデータを、クラウドストレージにアップロード
FoxProFoxPro でHugging Face のデータを操作
InformaticaHugging Face ODBC データソースとの間にInformatica マッピングを作成
Magic xpiMagic xpi からCData ODBC Driver を使ってHugging Face につないでみた
PowerCenter WorkflowInformatica PowerCenter でHugging Face のデータを抽出、変換、ロードする
Qlik Replicateデータ統合ツールQlik Replicate を使ってHugging Face のデータをMySQL にレプリケートする方法
SkyLinkデータベース・ソリューションSkyLink でHugging Face のデータを連携利用
Transpeedデータ変換ツールTranSpeed でHugging Face のデータにアクセスする方法
UiPath StudioRPA ツールUiPath でHugging Face のデータを連携利用する方法
ODBC SetupCData ODBC Driver for Hugging Face のセットアップ
AutomateRPA AutoMate でHugging Face のデータを連携利用
Automation 360クラウドネイティブRPA Automation 360™ でHugging Face のデータを連携利用
Blue PrismインテリジェントオートメーションRPA、Blue Prism でHugging Face のデータを連携利用
WinActor国産RPAツールWinActor でHugging Face のデータを連携したワークフローを作成

サポート

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

よくある質問

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

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

接続

  • システム DSN とユーザー DSN の違いは何ですか？
    システム DSN はマシン上のすべてのユーザーが利用でき、サービスで必要です。ユーザー DSN は作成したユーザーのみが利用できます。
  • DSN を作成せずに DSN レス接続文字列を使用できますか？
    はい。多くのアプリケーションは DSN レス接続文字列をサポートしています。以下の接続文字列の例をご参照ください： 
    Driver={CData API Driver for ODBC};RequiredConnectionProperty1=Value1;RequiredConnectionProperty2=Value2;
  • 複数の Hugging Face アカウントに接続するにはどうすればよいですか？
    アカウントごとに個別の 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] までお問い合わせください。

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

API Driver で Hugging Face のライブデータに接続

Hugging Face に接続

この記事の内容

関連記事