LlamaIndex を使って Python でOData データに自然言語でクエリを実行する方法
CData Python Connector for OData を使用して、OData からリアルタイムデータへのクエリを開始しましょう。LlamaIndex と AI の力を活用して、複雑な SQL クエリを書くことなく、シンプルな自然言語でインサイトを取得できます。意思決定を強化するリアルタイムデータアクセスのメリットを享受しながら、既存の Python アプリケーションと簡単に統合できます。
CData Python Connector は、組み込みの最適化されたデータ処理により、Python でリアルタイムのOData servicesを操作する際に比類のないパフォーマンスを提供します。Python から複雑な SQL クエリを発行すると、ドライバーはフィルターや集計などのサポートされた SQL 操作を直接 OData にプッシュし、埋め込み SQL エンジンを使用してサポートされていない操作(多くの場合 SQL 関数や JOIN 操作)をクライアント側で処理します。
トレンド分析、レポート作成、データの可視化など、CData Python Connector を使用すれば、リアルタイムのデータソースの可能性を最大限に活用できます。
OData データ連携について
CData は、OData サービスのライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています:
- OData バージョン 2.0、3.0、4.0 にアクセスでき、レガシーサービスと最新の機能・性能の両方に対応できます。
- $filter、$select、$expand などの高度なクエリオプションを活用し、サードパーティツールからのデータ取得を強化できます。
- サーバーサイドでの集計とグループ化の実行により、データ転送を最小化し、パフォーマンスを向上させます。
- Azure AD、ダイジェスト、ネゴシエート、NTLM、OAuth など、さまざまなスキームを使用して安全に認証でき、すべての接続でセキュアな認証を実現します。
- SQL ストアドプロシージャを使用して、OData サービスエンティティを管理できます。エンティティ間の関連付けの一覧表示、作成、削除などが可能です。
お客様は、Power BI、MicroStrategy、Tableau などのお気に入りのツールと OData サービスを定期的に統合し、OData サービスからデータベースやデータウェアハウスにデータをレプリケートするために CData のソリューションを使用しています。
はじめに
概要
LlamaIndex を使用して、CData Python Connector forOData servicesでリアルタイムデータにクエリを実行する方法の概要です:
- ロギング、データベース接続、NLP に必要な Python、CData、LlamaIndex モジュールをインポートします。
- アプリケーションからの API リクエストを認証するための OpenAI API キーを取得します。
- CData Python Connector を使用してリアルタイムのOData servicesに接続します。
- OpenAI を初期化し、自然言語クエリを処理するための SQLDatabase と NLSQLTableQueryEngine のインスタンスを作成します。
- クエリエンジンと特定のデータベースインスタンスを作成します。
- 自然言語クエリ(例:「最も稼いでいる従業員は誰ですか?」)を実行して、データベースから構造化されたレスポンスを取得します。
- 取得したデータを分析してインサイトを得て、データドリブンな意思決定に役立てます。
必要なモジュールのインポート
CData、データベース接続、自然言語クエリに必要なモジュールをインポートします。
import os import logging import sys # ロギングの設定 logging.basicConfig(stream=sys.stdout, level=logging.INFO, force=True) logging.getLogger().addHandler(logging.StreamHandler(stream=sys.stdout)) # CData と LlamaIndex に必要なモジュールをインポート import cdata.odata as mod from sqlalchemy import create_engine from llama_index.core.query_engine import NLSQLTableQueryEngine from llama_index.core import SQLDatabase from llama_index.llms.openai import OpenAI
OpenAI API キーの設定
OpenAI の言語モデルを使用するには、API キーを環境変数として設定する必要があります。システムの環境変数で OpenAI API キーが利用可能であることを確認してください。
# 環境変数から OpenAI API キーを取得 OPENAI_API_KEY = os.environ["OPENAI_API_KEY"] ''または、コード内で直接 API キーを追加することもできます(ただし、セキュリティリスクのため、本番環境ではこの方法は推奨されません):'' # API キーを直接設定(本番使用には非推奨) OPENAI_API_KEY = "your-api-key-here"
データベース接続の作成
次に、必要な接続プロパティを含む接続文字列を使用して、CData Connector で OData への接続を確立します。
OData への接続
OData に接続するには、Url を有効なOData サービスルートURI に設定する必要があります。 OData サービスにルートドキュメントがない場合、テーブルとして公開したい特定のエンティティをFeedURL に指定してください。
OData への認証
OData は、以下を経由する認証をサポートします。
- HTTP
- Kerberos
- SharePoint Online
- OAuth
- Azure AD
HTTP 認証スキーム
HTTP で認証する場合は、次の表に従ってAuthScheme を設定します。
| Scheme | AuthScheme | その他の設定 |
| None | None | 認証を必要としない場合に使用。 |
| Basic | Basic | User、Password |
| NTLM | NTLM | User、Password |
| Digest(サポートされている場合) | Digest | User、Password |
その他の認証方法の詳細は、ヘルプドキュメントの「接続の確立」セクションを参照してください。
OData への接続
# CData Python Connector for OData を使用してデータベースエンジンを作成
engine = create_engine("cdata_odata_2:///?User=URL=http://services.odata.org/V4/Northwind/Northwind.svc;UseIdUrl=True;OData Version=4.0;Data Format=ATOM;")
OpenAI インスタンスの初期化
OpenAI 言語モデルのインスタンスを作成します。ここで、temperature やモデルバージョンなどのパラメータを指定できます。
# OpenAI 言語モデルインスタンスを初期化 llm = OpenAI(temperature=0.0, model="gpt-3.5-turbo")
データベースとクエリエンジンの設定
SQL データベースとクエリエンジンを設定します。NLSQLTableQueryEngine を使用すると、SQL データベースに対して自然言語クエリを実行できます。
# SQL データベースインスタンスを作成 sql_db = SQLDatabase(engine) # すべてのテーブルを含む # 自然言語 SQL クエリ用のクエリエンジンを初期化 query_engine = NLSQLTableQueryEngine(sql_database=sql_db)
クエリの実行
これで、リアルタイムのデータソースに対して自然言語クエリを実行できます。この例では、最も稼いでいる従業員上位 2 名をクエリします。
# クエリ文字列を定義 query_str = "Who are the top earning employees?" # クエリエンジンからレスポンスを取得 response = query_engine.query(query_str) # レスポンスを出力 print(response)
CData Python Connector for OData の無料 30 日間トライアルをダウンロードして、リアルタイムデータへのシームレスなクエリを始めましょう。自然言語処理の力を体験し、データから貴重なインサイトを引き出してください。