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操作をUniform Resource Locator (URL)パターンにマップするため、ほとんどのプログラミング言語で使用できます。

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

SODAの概要

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

ノート:

Always Free Autonomous DatabaseをOracle Database 23aiとともに使用している場合、SODAドライバの互換性の問題を回避するために、Oracleでは次のことをお薦めします:

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

SODA API	ダウンロードおよびインストール	詳細情報
JavaのためのSODA	JavaのためのSODAのダウンロード JavaのためのSODAの前提条件バージョン: JavaのためのSODA。最新バージョンを使用することをお薦めします。サポートされる最低バージョンは、1.1.4です。 SODA for Javaを`ojdbc8.jar`とともに使用します(「Oracle Database JDBCドライバおよびCompanion Jarsのダウンロード」またはMaven Centralで入手可能)。 Autonomous Databaseはメタデータ・ビルダーをサポートしていません。コレクション・メタデータをカスタマイズするには、コレクション・メタデータ文字列をcreateCollectionメソッドに直接渡します。詳細は、「Autonomous Database上のSODAコレクション・メタデータ」を参照してください。	JavaのためのSODA
SODA for REST	RESTfulサービスおよびSODA for RESTへのアクセス	Autonomous DatabaseでのSODA for RESTの使用
SODA for C	Oracle Instant Clientのダウンロードバージョン: SODA for Cの場合、Oracleクライアント・ライブラリは19.6以上である必要があります。 Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。	SODA for C
PL/SQL用のSODA	ダウンロードする必要はありません。これはAutonomous Databaseに含まれています。	SODA for PL/SQL
SODA for Node.js	インストール手順で説明されている複数のダウンロード: node-oracledbのインストールのクイック・スタートバージョン: SODAのサポートはバージョン3.0で導入されました。最新バージョンを使用することをお薦めします。推奨の最小バージョンは4.0です。 Oracleクライアント・ライブラリは19.6以上である必要があります。 Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。	Node-oracledb SODAの要件
SODA for Python	インストール手順で説明されている複数のダウンロード: cx_Oracle 7のインストールバージョン: SODAのサポートはバージョン7.0で導入されました。最新バージョンを使用することをお薦めします。推奨の最小バージョンは7.1です。 Oracleクライアント・ライブラリは19.6以上である必要があります。 Oracle Instant Clientは、「Oracle Instant Clientのダウンロード」から入手できます。	cx_Oracleの概要

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

親トピック: Autonomous DatabaseでのJSONドキュメントの使用

SODAノート

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

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

親トピック: Autonomous DatabaseでのシンプルなOracle Documentアクセス(SODA)の操作