Autonomous Database用のPython Data Studio APIの操作

Python Data Studio APIパッケージは、OMLノートブックでもスタンドアロン・アプリケーションとしても機能します。

Oracle Autonomous DatabaseでホストされているREST APIエンドポイントを表示できます。これらのエンドポイントを使用すると、Machine Learningモデルとそのメタデータとともに格納し、モデルのスコアリング・エンドポイントを作成できます。

Python Data Studio APIのインストール

PyPIから基本パッケージをインストールします。

pip install oracle-data-studio

基本インストールには、Autonomous Database (adp)、Essbase (essbase)およびData Transforms (datatransforms)クライアントが含まれます。オプション機能は追加としてインストールされます。

pip install "oracle-data-studio[mcp]"               # MCP server
pip install "oracle-data-studio[agents]"            # A2A agent runtime
pip install "oracle-data-studio[agents,openai]"     # agents + OpenAI model adapter
pip install "oracle-data-studio[agents,anthropic]"  # agents + Anthropic model adapter
pip install "oracle-data-studio[oracle]"            # Oracle-DB-backed durable agent store
pip install "oracle-data-studio[redis]"             # Redis-backed durable agent store

Autonomous Databaseへの接続

ユーザー名とパスワードを使用してAutonomous Databaseに接続するには、次のコマンドを実行します:

import adp 
adp_instance = adp.login('<url>', '<username>', '<password>')

パラメータとその説明を次に示します。

url: Database Actionsホストを指定します。たとえば、https://abcdefg.oraclecloudapps.comです。

username: スキーマ名を指定します。

password: スキーマのパスワードを指定します。

OMLノートブック内の接続

次のコマンドを入力して、OMLノートブック内でログインします:

import adp
adp_instance = adp.connect()

ログイン・メソッドの戻り値は、すべてのAutonomous Data Platform (ADP)関数を含むクラスのインスタンスです。

Adpクラス・インスタンスは、次のインナー・クラスで構成されます:

• 取込み
• アナリティクス
• インサイト
• その他
• データ共有

後続の章の次の関数を参照してください。

トピック:

• 収集関数
  Adp.Ingestクラスは、様々なソースから表およびビューにデータをロードするために使用されます。
• 分析ビュー関数
  クラスAdp.Analyticsは、Data Studio Suiteのツールの分析ビュー・ツールに対するアプリケーション・プログラミング・インタフェースのクラス、メソッド、属性およびパラメータの構文と説明を提供します。要求された分析ビューが存在しない場合(作成を除く)、すべての関数はAnalytic view does not existメッセージを返します。
• インサイト関数
  インサイト関数は、Data Studioツール・スイートのインサイト・ツールに対するアプリケーション・プログラミング・インタフェースのクラス、メソッド、属性およびパラメータの構文と説明を提供します。インサイトの生成はバックグラウンドで実行され、完了を確認する必要があります。
• その他の関数
  その他の関数は、アプリケーション・プログラミング・インタフェースのクラス、メソッド、属性およびパラメータの構文と説明を提供します。
• データ共有関数
  データ共有関数用のPython Data Studioアプリケーション・プログラミング・インタフェース(API)は、Data Studioツール・スイートのデータ共有ツールに対するアプリケーション・プログラミング・インタフェースのクラス、メソッド、属性およびパラメータの構文と説明を提供します。
• カタログ・ファンクション
  Oracle Data Studioカタログまたはカタログは、現在接続しているAutonomous Database内のデータおよびその他のオブジェクトを検索する方法を提供するマルチカタログ・ツールであり、他の接続されているシステムも幅広く使用できます。