機械翻訳について

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

Simple Oracle Document Access (SODA)は、Autonomous AI DatabaseでJSONドキュメントのコレクションを使用し、構造化問合せ言語(SQL)やドキュメントをデータベースに格納する方法を知る必要なく、それらを取得して問い合せることができるNoSQLスタイルのAPIのセットです。

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 DatabaseOracle AI Database 26aiとともに使用している場合は、SODAドライバの互換性の問題を回避するために、Oracleは次のことをお薦めします:
  • SODAドライバで指定されているJSONタイプの操作に必要なドライバ・バージョンを使用します。 詳細については、「SODAドライバ」を参照してください。

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

SODA API ダウンロードおよびインストール 詳細情報

JavaのためのSODA

SODA for Javaのダウンロード

JavaのためのSODAの前提条件

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

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

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

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

JavaのためのSODA

SODA for REST

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

Autonomous AI 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 AI Databaseに含まれています。

SODA for PL/SQL

SODA for Node.js

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

Quick Start node-oracledbのインストール

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

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ノート

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

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

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