Autonomous AI DatabaseでのSimple Oracle Document Access (SODA)の操作
Simple Oracle Document Access (SODA)はNoSQL形式のAPIセットであり、これを使用すると、Autonomous AI DatabaseのJSONドキュメントのコレクションを使用でき、Structured Query Language (SQL)や、ドキュメントがデータベースにどのように格納されているかを理解しなくても、そのドキュメントの取得や問合せを行うことができます。
Autonomous AI Databaseは、JSONドキュメントのネイティブな格納および問合せをサポートしています。SODAドキュメント・コレクションは、通常のデータベース表およびビューによってバックアップされているため、SODAドキュメントのコンテンツで使用するためにデータベース機能を利用できます。
SODAドライバは、Java、Node.js、Python、C (Oracle Call Interfaceを使用)、PL/SQLおよびSODA for RESTを含む複数の言語およびフレームワークで使用できます。SODA for RESTは、SODA操作をUniform Resource Locator (URL)パターンにマップするため、ほとんどのプログラミング言語で使用できます。
SODAの使用を開始するには、次を参照してください:
操作するSODA APIに応じて、次を参照してください:
ノート: Always Free Autonomous AI DatabaseをOracle AI Database 26aiとともに使用している場合は、SODAドライバの互換性の問題を回避するために、Oracleでは、SODAドライバで指定されているJSONタイプの操作に必要なドライバ・バージョンを使用することをお薦めします。詳細は、「SODAドライバ」を参照してください。
ノート
Oracle Database 21cより前のデータベース・リリースを使用して開始されたプロジェクトの場合、SODAドライバの例で指定されているように、デフォルト・コレクション・メタデータを明示的に指定します。リリースOracle Database 21c以降を使用して開始したプロジェクトでは、デフォルト・メタデータのみを使用します。詳細は、「SODAドライバ」を参照してください。
| SODA API | ダウンロードおよびインストール | 詳細情報 |
|---|---|---|
| JavaのためのSODA | バージョン: JavaのためのSODA。最新バージョンを使用することをお薦めします。サポートされる最低バージョンは、1.1.4です。 SODA for Javaを Autonomous AI Databaseはメタデータ・ビルダーをサポートしていません。コレクション・メタデータをカスタマイズするには、コレクション・メタデータ文字列をcreateCollectionメソッドに直接渡します。 詳細は、Autonomous AIデータベース上のSODAコレクション・メタデータを参照してください。 |
JavaのためのSODA |
| RESTのためのSODA | RESTfulサービスおよびSODA for RESTへのアクセス | Autonomous AI DatabaseでのSODA for RESTの使用 |
| SODA (C) | バージョン: SODA for Cの場合、Oracle Clientライブラリは19.6以上である必要があります。Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。 |
SODA for C |
| PL/SQL用のSODA | ダウンロードする必要はありません。これは、Autonomous AI Databaseに含まれています。 | PL/SQL用のSODA |
| Node.jsのSODA | インストール手順で説明されている複数のダウンロード: node-oracledbのインストールのクイック・スタート バージョン: SODAのサポートはバージョン3.0で導入されました。最新バージョンを使用することをお薦めします。推奨の最小バージョンは4.0です。 Oracleクライアント・ライブラリは19.6以上である必要があります。Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。 |
node-oracledb SODAの要件 |
| SODA for Python | インストール手順で説明されている複数のダウンロード: バージョン: SODAのサポートはバージョン7.0で導入されました。最新バージョンを使用することをお薦めします。推奨の最小バージョンは7.1です。 Oracleクライアント・ライブラリは19.6以上である必要があります。Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。 |
cx_Oracleの概要 |
SODAノート
SODAをAutonomous AI Databaseとともに使用する場合、次の制限が適用されます:
-
SQL/JSONファンクション
json_existsを使用するSQLおよびPL/SQLコードでは、自動索引付けはサポートされていません。詳細は、SQL/JSON条件JSON_EXISTSを参照してください。 -
SODAの例による問合せ(QBE)では、自動索引付けはサポートされていません。