Autonomous DatabaseでのSimple Oracle Document Access (SODA)の作業

Simple Oracle Document Access (SODA)は、NoSQLスタイルのAPIセットであり、これを使用すると、Autonomous DatabaseのJSONドキュメントのコレクションを使用でき、Structured Query Language (SQL)や、ドキュメントがどのようにデータベースに格納されているかを理解していなくても、そのコレクションの取得や問合せを行うことができます。

Autonomous Databaseは、JSONドキュメントの格納および問合せをネイティブにサポートしています。SODAドキュメント・コレクションは、通常のデータベース表およびビューを基盤としているため、SODAドキュメントのコンテンツで使用するためにデータベース機能を利用できます。

SODAドライバは、Java、Node.js、Python、C (Oracle Call Interfaceを使用)、PL/SQLおよびSODA for RESTを含む複数の言語およびフレームワークで使用できます。SODA for RESTはSODA操作を統一リソース・ロケータ(URL)パターンにマップするため、ほとんどのプログラミング言語で使用できます。

SODAを開始するには、次を参照してください:

作業するSODA APIに応じて、次を参照してください:

ノート

Oracle Database 23aiでAlways Free Autonomous Databaseを使用している場合、SODAドライバの互換性の問題を回避するために、Oracleでは次をお薦めします:
  • SODAドライバで指定されているように、JSONタイプの作業に必要なドライバ・バージョンを使用します。詳細は、SODAドライバを参照してください。

  • Oracle Database 21cより前のデータベース・リリースを使用して開始されたプロジェクトの場合、SODAドライバの例で指定されているように、デフォルト・コレクションのメタデータを明示的に指定します。Oracle Database 21c以降のリリースを使用して開始されたプロジェクトでは、デフォルト・メタデータのみを使用します。詳細は、SODAドライバを参照してください。

ソーダアピ ダウンロードおよびインストール 詳細情報

JavaのためのSODA

JavaのためのSODAのダウンロード

JavaのためのSODAの前提条件

バージョン: SODA for Javaの最新バージョンを使用することをお薦めします。サポートされる最低バージョンは、1.1.4です。

SODA for Javaをojdbc8.jar for 19.6 (「Oracle Database 19c (19.6) JDBCドライバおよびUCPのダウンロード」またはMaven Centralで入手可能)とともに使用します。

Autonomous Databaseでは、メタデータ・ビルダーはサポートされていません。コレクション・メタデータをカスタマイズするには、コレクション・メタデータ文字列を直接createCollectionメソッドに渡します。

詳細は、「Autonomous Database上のSODAコレクション・メタデータ」を参照してください。

JavaのためのSODA

SODA for REST

RESTfulサービスおよびSODA for RESTへのアクセス

Autonomous DatabaseでのSODA for RESTの使用

C用SODA

Oracle Instant Clientのダウンロード

バージョン: SODA for Cの場合、Oracle Clientライブラリは19.6以上である必要があります。Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。

C用SODA

PL/SQL用のSODA

ダウンロードする必要はありません。これはAutonomous Databaseに含まれています。

PL/SQL用のSODA

Node.jsのSODA

インストール手順で説明されている複数のダウンロード:

Quick Start node-oracledbインストール

バージョン: SODAサポートはバージョン3.0で導入されました。最新バージョンを使用することをお薦めします。推奨の最小バージョンは4です。

Oracle Clientライブラリは、19.6以上である必要があります。Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。

Node-oracledb SODAの要件

Python用SODA

インストール手順で説明されている複数のダウンロード:

cx_Oracle 7インストール

バージョン: SODAサポートはバージョン7.0で導入されました。最新バージョンを使用することをお薦めします。推奨の最小バージョンは7.1です。

Oracle Clientライブラリは、19.6以上である必要があります。Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。

cx_Oracleの概要

SODAのノート

SODAをAutonomous Databaseで使用する場合、次の制限が適用されます:

  • SQL/JSONファンクションjson_existsを使用するSQLおよびPL/SQLコードでは、自動索引付けはサポートされていません。詳細は、SQL/JSON条件JSON_EXISTSを参照してください。

  • SODAの例による問合せ(QBE)では、自動索引付けはサポートされていません。