7 SODAコレクション・メタデータ・コンポーネント(参考)

コレクション・メタデータは複数のコンポーネントから構成されます。コンポーネントの詳細な定義を示します。

ノート:

コレクション・メタデータ・コンポーネント(スキーマ名、表名、ビュー名、データベースの順序名および列名)に使用する識別子は有効なOracleの引用符付き識別子にする必要があります。^脚注1Oracleの引用符付き識別子に許可されている一部の文字および単語はお薦めしません。詳細は、『Oracle Database SQL言語リファレンス』を参照してください

• デフォルトのコレクション・メタデータ
  使用するデータベースの種類によって、デフォルトで使用されるコレクション・メタデータと、カスタム・メタデータ用に変更できるフィールド値が決まります。
• スキーマ
  コレクションがマップされる表またはビューを所有するOracle Databaseスキーマの名前を指定するコレクション・メタデータ・コンポーネントです。
• 表またはビュー
  コレクションがマップされる表またはビューの名前を指定するコレクション・メタデータ・コンポーネントです。
• キー列名
  ドキュメント・キーを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。
• キー列の型
  ドキュメント・キーを格納する列のSQLデータ型を指定するコレクション・メタデータ・コンポーネントです。
• キー列の最大長
  キー列の最大長をバイト単位で指定するコレクション・メタデータ・コンポーネントです。このコンポーネントはVARCHAR2型のキーのみに適用されます。
• キー列の割当てメソッド
  コレクションに挿入するオブジェクトにキーを割り当てる際に使用されるメソッドを指定するコレクション・メタデータ・コンポーネントです。
• キー列パス
  埋込みドキュメント・キーとして使用されるフィールドへのトップレベルのドキュメント・パスを指定するコレクション・メタデータ・コンポーネントです。
• キー列の順序名
  キー割当てメソッドがSEQUENCEの場合に、コレクションに挿入するドキュメントのキーを生成するデータベース順序の名前を指定するコレクション・メタデータ・コンポーネントです。
• コンテンツ列名
  データベース・コンテンツを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。
• コンテンツ列の型
  ドキュメント・コンテンツを格納する列のSQLデータ型を指定するコレクション・メタデータ・コンポーネントです。
• コンテンツ列書式
  ドキュメント・コンテンツを格納する列の書式を指定するコレクション・メタデータ・コンポーネントです。
• コンテンツ列の最大長
  コンテンツ列の最大長をバイト単位で指定するコレクション・メタデータ・コンポーネントです。このコンポーネントはVARCHAR2型のコンテンツのみに適用されます。
• コンテンツ列のJSON検証
  JavaScript Object Notation (JSON)のコンテンツが準拠する必要のある構文(厳密構文または緩慢構文)を指定するコレクション・メタデータ・コンポーネントです。
• コンテンツ列のSecureFiles LOB圧縮
  SecureFiles LOB圧縮設定を指定するコレクション・メタデータ・コンポーネントです。
• コンテンツ列のSecureFiles LOBのキャッシュ
  SecureFiles LOBのキャッシュ設定を指定するコレクション・メタデータ・コンポーネントです。
• コンテンツ列のSecureFiles LOBの暗号化
  SecureFiles LOBの暗号化設定を指定するコレクション・メタデータ・コンポーネントです。
• バージョン列名
  ドキュメント・バージョンを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。
• バージョン列の生成メソッド
  コレクションに挿入するか、置き換えるときにオブジェクトのバージョン値の計算に使用されるメソッドを指定するコレクション・メタデータ・コンポーネントです。
• 最終変更のタイムスタンプの列名
  ドキュメントの最終変更のタイムスタンプを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。
• 最終変更の列索引名
  最終変更の列索引の名前を指定するコレクション・メタデータ・コンポーネントです。
• 作成時のタイムスタンプの列名
  ドキュメントの作成時のタイムスタンプを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。このタイムスタンプは、insert、insertAndGet、saveまたはsaveAndGet操作時に生成されます。
• メディア・タイプ列名
  ドキュメントのメディア・タイプを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。異種コレクションの場合、つまり、コレクションがJavaScript Object Notation (JSON)以外のドキュメントを格納できる場合、メディア・タイプ列が必要です。
• 読取り専用
  コレクションが読取り専用かどうかを指定するコレクション・メタデータ・コンポーネントです。

7.1 デフォルトのコレクション・メタデータ

使用するデータベースの種類によって、デフォルトで使用されるコレクション・メタデータと、カスタム・メタデータ用に変更できるフィールド値が決まります。

具体的には、JSONコンテンツを格納するために使用される列のデフォルトのSQLデータ型(コンテンツ列)およびオブジェクト・バージョン値を計算するためのデフォルト・メソッド(バージョン列生成メソッド)は、データベースによって異なります。

使用するOracle DatabaseがOracle Autonomous Database (Autonomous JSON Database (AJD)、Autonomous Transaction Processing (ATP)またはAutonomous Data Warehouse (ADW))の場合、SODAは常にOracleのネイティブJSON形式OSONを使用してJSONコンテンツを格納します。メタデータ内のフィールドcontentColumn.sqlTypeおよびcontentColumn.jsonFormatには、これが反映されます。自律型データベースの場合、これらのフィールドはカスタマイズできません。

• データベース初期化パラメータcompatibleが20以上である場合:

  • デフォルト・メタデータのフィールドcontentColumn.sqlTypeの値は、"JSON"です。JSONデータ型は、OSON形式を使用します。

  • デフォルト・メタデータのフィールドversionColumn.methodの値は、"UUID"です。

• それ以外の場合(パラメータcompatibleが20より小さい)。

  自律型データベースの場合:

  • フィールドcontentColumn.sqlTypeの値は、"BLOB"です。このバイナリ・ラージ・オブジェクト(BLOB)データは、OracleのネイティブJSON形式(OSON)を使用します。(自律型データベースの場合、このフィールドはカスタマイズできません。)

    追加のフィールドcontentColumn.jsonFormatが存在し、値は"OSON"です。(自律型データベースの場合、このフィールドはカスタマイズできません。)

    フィールドversionColumn.methodの値は、"UUID"です。

  非自律型データベースの場合、つまりオンプレミス・データベースまたは非自律型クラウド・データベースの場合:

  • デフォルト・メタデータのフィールドcontentColumn.sqlTypeの値は、"BLOB"です。BLOBテキスト・データは、デフォルトでJSONコンテンツに使用されます。データは、Unicodeエンコーディング(UTF-8またはUTF-16)を使用してエンコードされた文字データです。

  • 追加のcontentColumnフィールドcompress、cache、encryptおよびvalidationがあります。

  • デフォルト・メタデータのフィールドversionColumn.methodの値は、"SHA256"です。

次のように、カスタム・メタデータを定義できます。一部のフィールドの値はデフォルト値とは異なります。

• 使用するデータベースが自律型データベースの場合:

  • メタデータ・フィールドkeyColumn.assignmentMethodを(デフォルト値UUIDではなく) CLIENTに変更して、ドキュメント・キーのクライアント割当てを指定できます。

  • 自律型データベースがAutonomous Transaction Processing (ATP)またはAutonomous Data Warehouse (ADW)で、Autonomous JSON Database (AJD)ではない場合、メタデータ・フィールドmediaTypeColumn.nameを追加して、ドキュメントのメディア・タイプを格納する列の名前を指定できます。(デフォルトでは、このフィールドはありません。)メディア・タイプ列は、異種コレクション、つまり、JSONドキュメント以外のドキュメントを格納できるコレクションに必要です。

• 使用するデータベースが自律型データベースではない場合は、すべてのメタデータ・フィールドをカスタマイズできます。

ノート:

OracleのネイティブJSONバイナリ形式OSON (JSON型またはOSON形式のBLOB型用)を使用するコレクション・コンテンツ・タイプをサポートするには、特定のバージョンのSODAドライバおよび関連ソフトウェアが必要です。SODAドライバを参照してください

7.2 スキーマ

コレクションがマップされる表またはビューを所有するOracle Databaseスキーマの名前を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	なし
指定できる値	Oracleの有効な引用符付き識別子脚注1。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	schemaName

関連項目:

Oracleの有効な引用符付き識別子の詳細は、『Oracle Database SQL言語リファレンス』を参照してください

7.3 表またはビュー

コレクションがマップされる表またはビューの名前を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	なし
指定できる値	Oracleの有効な引用符付き識別子脚注1。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	tableNameまたはviewName

関連項目:

Oracleの有効な引用符付き識別子の詳細は、『Oracle Database SQL言語リファレンス』を参照してください

7.4 キー列名

ドキュメント・キーを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	ID
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	keyColumn.name

7.5 キー列の型

ドキュメント・キーを格納する列のSQLデータ型を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	VARCHAR2
指定できる値	VARCHAR2 NUMBER RAW(16)
JSONコレクション・メタデータのドキュメント・パス	keyColumn.sqlType

注意:

クライアント割当てキーが使用され、キー列タイプがVARCHAR2の場合、データベース文字セットにはAL32UTF8が推奨されます。これにより、キーからデータベース文字セットへの変換がロスレスになります。

それ以外の場合、クライアント割当てキーにデータベース文字セットでサポートされない文字が含まれる場合、読取りまたは書込み操作時に、データベース文字セットへのキーの変換は失われます。これにより、挿入操作中に重複キー・エラーが発生することがあります。もっと一般的に言うと、予測できない結果が生じることがあります。たとえば、読取り操作で、予定したキーとは異なるキーに関連付けられている値が返されることがあります。

7.6 キー列の最大長

キー列の最大長をバイト単位で指定するコレクション・メタデータ・コンポーネントです。このコンポーネントはVARCHAR2型のキーのみに適用されます。

プロパティ	値
デフォルト値	255
指定できる値	キーの割当てメソッドがUUIDまたはGUIDの場合、32バイト以上。「キー列の割当てメソッド」を参照してください。
JSONコレクション・メタデータのドキュメント・パス	keyColumn.maxLength

7.7 キー列の割当てメソッド

コレクションに挿入するオブジェクトにキーを割り当てる際に使用されるメソッドを指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	UUID
指定できる値	UUID GUID SEQUENCE CLIENT EMBEDDED_OID これらのメソッドの詳細は、表7-1を参照してください。
JSONコレクション・メタデータのドキュメント・パス	keyColumn.assignmentMethod

表7-1 キーの割当て方法

メソッド	説明
UUID (デフォルト - Oracle Database API for MongoDBでは使用されません)	キーは、SODAによって、UUID (ユニバーサル一意識別子)に基づいて生成されます。
GUID	キーはSQLファンクションSYS_GUIDによってOracle Databaseに生成されます。Oracle Database SQL言語リファレンスを参照してください。
SEQUENCE	キーはデータベース順序によってOracle Databaseに生成されます。キーの割当てメソッドをSEQUENCEとして指定する場合、その順序名も指定する必要があります。キー列の順序名を参照してください。
CLIENT	キーはクライアント・アプリケーションによって割り当てられます。 注意: クライアント割当てキーが使用され、キー列タイプがVARCHAR2の場合、データベース文字セットにはAL32UTF8が推奨されます。これにより、キーからデータベース文字セットへの変換がロスレスになります。 それ以外の場合、クライアント割当てキーにデータベース文字セットでサポートされない文字が含まれる場合、読取りまたは書込み操作時に、データベース文字セットへのキーの変換は失われます。これにより、挿入操作中に重複キー・エラーが発生することがあります。もっと一般的に言うと、予測できない結果が生じることがあります。たとえば、読取り操作で、予定したキーとは異なるキーに関連付けられている値が返されることがあります。
EMBEDDED_OID (Oracle Database API for MongoDBによって常に使用される)	このメソッドは、Oracle Autonomous Databaseでのみ使用できるOracle Database API for MongoDBでのみ自動的に使用されます。(SODA実装/言語とともにこのメソッドを使用するコレクションは作成できません。) 列値は文字列(データ型VARCHAR2)です。この値は、トップレベル・フィールド_idの値としてコレクションのドキュメントにも埋め込まれます。 ドキュメントにトップレベル・フィールド_idがすでにある場合は、そのフィールド値の文字列表現がキー列に使用されます。 ドキュメントにこのようなフィールドがない場合は、生成された値を含むフィールド_idがドキュメントのトップレベルで埋め込まれ、その値がキー列に使用されます。この値は、12バイトのバイナリOID (ObjectID)の文字列の16進表現です。

7.8 キー列パス

埋込みドキュメント・キーとして使用されるフィールドへのトップレベルのドキュメント・パスを指定するコレクション・メタデータ・コンポーネントです。

コンポーネント値は、Oracle Database API for MongoDBで使用されるコレクション内のドキュメントの埋込みキーであるトップレベル・パス_idです。

このメタデータ・コンポーネントは、キー列の割当てメソッドEMBEDDED_OIDに必要であり、この割当てメソッドでのみ使用されます。これはEMBEDDED_OIDを使用すると自動的に提供され、明示的に指定する必要はありません。

(このコンポーネントを指定すると、EMBEDDED_OID以外の割当てメソッドにkeyColumn.pathが指定されている場合、または指定された値が_idでない場合にエラーが発生します。)

プロパティ	値
デフォルト値	_id
指定できる値	_id
JSONコレクション・メタデータのドキュメント・パス	keyColumn.path

7.9 キー列の順序名

キーの割当てメソッドがSEQUENCEの場合にコレクションに挿入するドキュメントのキーを生成するデータベース順序の名前を指定するコレクション・メタデータ・コンポーネントです。

キーの割当てメソッドをSEQUENCEとして指定する場合、その順序名も指定する必要があります。指定した順序が存在しない場合は、SODAによって作成されます。

プロパティ	値
デフォルト値	なし
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	keyColumn.sequenceName

ノート:

SODAを使用してコレクションをドロップしても、キーの生成に使用する順序はドロップされません。これは、SODAを使用して作成されていないためです。順序をドロップするには、最初にコレクションをドロップしてから、SQLコマンドDROP SEQUENCEを使用します。

関連項目:

• DROP SEQUENCEの詳細は、『Oracle Database SQL言語リファレンス』を参照してください

• データベース順序の詳細は、『Oracle Database概要』を参照してください

7.10 コンテンツ列名

データベース・コンテンツを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	JSON_DOCUMENT
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	contentColumn.name

7.11 コンテンツ列の型

ドキュメント・コンテンツを格納する列のSQLデータ型を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	JSON: データベース初期化パラメータcompatibleが20以上かつコンポーネントmediaTypeColumn.nameが指定されていない場合(コンテンツは同種で、JSONデータのみ)。 それ以外の場合は、BLOB。 コンテンツ・タイプがBLOBの場合、使用するデータベースがOracle Autonomous Database (Autonomous JSON Database、Autonomous Transaction ProcessingまたはAutonomous Data Warehouse)である場合、形式はネイティブJSONバイナリ(OSON)です。それ以外の場合は、テキスト(解析されていないUnicode文字データ)です。 使用するデータベースがAutonomous JSON Database (AJD)の場合、コンポーネントmediaTypeColumn.nameは指定できません。コンテンツはJSONデータ(同種)である必要があります。
指定できる値	JSON (データベース初期化パラメータcompatibleが20以上である場合のみ) VARCHAR2 BLOB CLOB
JSONコレクション・メタデータのドキュメント・パス	contentColumn.sqlType

ノート:

OracleのネイティブJSONバイナリ形式OSON (JSON型またはOSON形式のBLOB型用)を使用するコレクション・コンテンツ・タイプをサポートするには、特定のバージョンのSODAドライバおよび関連ソフトウェアが必要です。SODAドライバを参照してください

.

7.12 コンテンツ列書式

ドキュメント・コンテンツを格納する列の書式を指定するコレクション・メタデータ・コンポーネントです。

このメタデータ・コンポーネントの値は自動的にOSONになり、変更することはできません。このコンポーネントは、データベースがOracle Autonomous Database: Autonomous JSON Database (AJD)、Autonomous Transaction Processing (ATP)またはAutonomous Data Warehouse (ADW)で、メタデータ・コンポーネント・コンテンツ・タイプ(contentColumn.sqlTypeフィールド)の値がBLOBの場合にのみ使用可能です。

プロパティ	値
指定できる値	"OSON"
JSONコレクション・メタデータのドキュメント・パス	contentColumn.jsonFormat

ノート:

OracleのネイティブJSONバイナリ形式OSON (JSON型またはOSON形式のBLOB型用)を使用するコレクション・コンテンツ・タイプをサポートするには、特定のバージョンのSODAドライバおよび関連ソフトウェアが必要です。SODAドライバを参照してください

.

7.13 コンテンツ列の最大長

コンテンツ列の最大長をバイト単位で指定するコレクション・メタデータ・コンポーネントです。このコンポーネントはVARCHAR2型のコンテンツのみに適用されます。

プロパティ	値
デフォルト値	4000
指定できる値	拡張データ型が有効になっている場合、32767。それ以外の場合で列型がVARCHAR2の場合、4000。
JSONコレクション・メタデータのドキュメント・パス	contentColumn.maxLength

関連項目:

拡張データ型の詳細は、『Oracle Database SQL言語リファレンス』を参照してください

7.14 コンテンツ列のJSON検証

JavaScript Object Notation (JSON)コンテンツが従う必要がある構文(厳密構文または緩慢構文)を指定するコレクション・メタデータ・コンポーネントです。

ノート:

コンテンツ列に、Oracleのネイティブ・バイナリ形式OSONを使用するJSONデータが格納されている場合(JSON型またはOSON形式のBLOB)、このメタデータ・コンポーネントは存在しません。

プロパティ	値
デフォルト値	STANDARD
指定できる値	STANDARD STRICT LAX (SQL条件is jsonのデフォルト)
JSONコレクション・メタデータのドキュメント・パス	contentColumn.validation

• STANDARDは、JSON RFC 8259標準(またはデータベース初期化パラメータcompatibleが20より小さい場合は、RFC 4627標準)に従って検証します。Oracle SQL条件is jsonに定義された厳密な構文に対応します。^脚注2

• STRICTはSTANDARDと同じですが、ドキュメントに重複したJSONフィールド名が含まれていないことも確認する点のみ異なります。(SQLキーワードWITH UNIQUE KEYSも使用する場合、Oracle SQL条件is jsonに定義された厳密な構文に対応します。)

• LAXは、より緩慢に検証します。(Oracle SQL条件is jsonに定義された緩慢な構文に対応します。)LAXで許可される緩和の一部として、次のものがあります。

  • JSONフィールド名を二重引用符(")で囲む必要はありません。

  • true、falseおよびnullの、大文字、小文字および混在バージョンが許可されます。

  • 数字はその他の方法で表すことができます。

関連項目:

• 厳密なJSON構文および緩慢なJSON構文の詳細は、Oracle Database JSON開発者ガイドを参照

• JSON RFC 8259標準の場合は、IETF RFC 8259

• JSON RFC 4627標準の場合は、IETF RFC 4627

7.15 コンテンツ列のSecureFiles LOB圧縮

SecureFiles LOB圧縮設定を指定するコレクション・メタデータ・コンポーネントです。

ノート:

コンテンツ列に、Oracleのネイティブ・バイナリ形式OSONを使用するJSONデータが格納されている場合(JSON型またはOSON形式のBLOB)、このメタデータ・コンポーネントは存在しません。

プロパティ	値
デフォルト値	NONE
指定できる値	NONE HIGH MEDIUM LOW
JSONコレクション・メタデータのドキュメント・パス	contentColumn.compress

関連項目:

SecureFiles LOB記憶域の詳細は、『Oracle Database SecureFilesおよびラージ・オブジェクト開発者ガイド』を参照

7.16 コンテンツ列のSecureFiles LOBのキャッシュ

SecureFiles LOBのキャッシュ設定を指定するコレクション・メタデータ・コンポーネントです。

ノート:

コンテンツ列に、Oracleのネイティブ・バイナリ形式OSONを使用するJSONデータが格納されている場合(JSON型またはOSON形式のBLOB)、このメタデータ・コンポーネントは存在しません。

プロパティ	値
デフォルト値	TRUE
指定できる値	TRUE FALSE
JSONコレクション・メタデータのドキュメント・パス	contentColumn.cache

関連項目:

SecureFiles LOB記憶域の詳細は、『Oracle Database SecureFilesおよびラージ・オブジェクト開発者ガイド』を参照

7.17 コンテンツ列のSecureFiles LOBの暗号化

SecureFiles LOBの暗号化設定を指定するコレクション・メタデータ・コンポーネントです。

ノート:

コンテンツ列に、Oracleのネイティブ・バイナリ形式OSONを使用するJSONデータが格納されている場合(JSON型またはOSON形式のBLOB)、このメタデータ・コンポーネントは存在しません。

SecureFiles LOB暗号化を使用するコレクションを作成する前に、暗号化ウォレットを設定する必要があります。

 

プロパティ	値
デフォルト値	NONE
指定できる値	NONE 3DES168 AES128 AES192 AES256
JSONコレクション・メタデータのドキュメント・パス	contentColumn.encrypt

関連項目:

• SecureFiles LOB記憶域の詳細は、『Oracle Database SecureFilesおよびラージ・オブジェクト開発者ガイド』を参照

• ALTER SYSTEM文のSET ENCRYPTION WALLET句を使用して暗号化ウォレットを設定する方法の詳細は、Oracle Database SQL言語リファレンスを参照してください。

7.18 バージョン列名

ドキュメント・バージョンを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	VERSION
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	versionColumn.name

7.19 バージョン列の生成メソッド

コレクションに挿入するか、置き換わるときにオブジェクトのバージョン値の計算に使用されるメソッドを指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	(1)データベース初期化パラメータcompatibleが少なくとも20の場合、または(2)データベースがOracle Autonomous Database (Autonomous JSON Database (AJD)、Autonomous Transaction Processing (ATP)またはAutonomous Data Warehouse (ADW))の場合は、UUID それ以外の場合はSHA256
指定できる値	UUID TIMESTAMP MD5 SHA256 SEQUENTIAL NONE
JSONコレクション・メタデータのドキュメント・パス	versionColumn.method

表7-2に、バージョン生成メソッドを示します。

表7-2 バージョン生成メソッド

メソッド	説明
UUID	ドキュメントが挿入されたときおよび置換操作ごとに、SODAではオブジェクト・コンテンツを無視して、Universally Unique Identifier (UUID)が生成されます。効率的ですが、元のドキュメントと置換後のドキュメントが同じであってもバージョンが変更されます。 バージョン列型の値は、VARCHAR2(255)です。
TIMESTAMP	SODAではオブジェクト・コンテンツを無視して、タイムスタンプから値を生成し、これをLONGに変換します。このメソッドでは、タイムスタンプを取得するためにデータベース・インスタンスへのラウンド・トリップが必要になる可能性があります。UUIDと同様に、元のドキュメントと置換後のドキュメントが同じであってもバージョンが変更されます。 バージョン列型の値は、NUMBERです。
MD5	SODAでは、MD5アルゴリズムを使用してドキュメント・コンテンツのハッシュ値を計算します。このメソッドはUUIDよりも効率的ではありませんが、ドキュメント・コンテンツが変更された場合にのみバージョンが変更されます。 バージョン列型の値は、VARCHAR2(255)です。
SHA256	SODAでは、SHA256アルゴリズムを使用してドキュメント・コンテンツのハッシュ値を計算します。このメソッドはUUIDよりも効率的ではありませんが、ドキュメント・コンテンツが変更された場合にのみバージョンが変更されます。 バージョン列型の値は、VARCHAR2(255)です。
SEQUENTIAL	SODAにより、オブジェクトのコンテンツを無視して、オブジェクトが挿入されたときにバージョン1が割り当てられ、オブジェクトが置換されるたびにバージョン値が増分されます。バージョン値はユーザーにわかりやすい値ですが、元のドキュメントと置換後のドキュメントが同じであってもバージョンが変更されます。 バージョン列型の値は、NUMBERです。
NONE	バージョン列が存在する場合、NONEはバージョンがSODAの外部で生成されたことを意味します(たとえば、データベース・トリガーなど)。

7.20 最終変更のタイムスタンプの列名

ドキュメントの最終変更のタイムスタンプを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	LAST_MODIFIED
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	lastModifiedColumn.name

7.21 最終変更の列索引名

最終変更の列索引の名前を指定するコレクション・メタデータ・コンポーネントです。

このコンポーネントの値は、最終変更のタイムスタンプ列の一意でない索引の名前です。名前が指定されている場合、インデックスが作成されます。この索引は、最終変更のタイムスタンプによって決定された読取りおよび書込み操作のパフォーマンスを向上させることができます。

SODA for RESTのみに、このような操作(タイムスタンプ・パラメータsinceおよびuntilを伴う操作GETコレクション)が用意されています。他の実装では、最終変更のタイムスタンプによって決定される読取り操作または書込み操作を提供しないため、このコンポーネントは使用しません。SODA for RESTの場合であっても、索引の作成と保守にコストがかかるため、アプリケーションでタイムスタンプで決定される読込み操作や書込み操作を使用しないことが確実な場合は、このコンポーネントを設定しないほうが一般的です

プロパティ	値
デフォルト値	なし
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	lastModifiedColumn.index

関連項目:

Oracle REST Data Services RESTのためのSODA開発者ガイド

7.22 作成時のタイムスタンプの列名

ドキュメントの作成時のタイムスタンプを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。このタイムスタンプは、insert、insertAndGet、saveまたはsaveAndGet操作時に生成されます。

プロパティ	値
デフォルト値	CREATED_ON
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	creationTimeColumn.name

7.23 メディア・タイプ列名

ドキュメントのメディア・タイプを格納する列の名前を指定するコレクション・メタデータ・コンポーネントです。異種コレクションの場合、つまり、コレクションがJavaScript Object Notation (JSON)以外のドキュメントを格納できる場合、メディア・タイプ列が必要です。

ノート:

異種コレクションで例による問合せ(QBE)は使用できません。試みると、エラーが発生します。

プロパティ	値
デフォルト値	なし
指定できる値	Oracleの有効な引用符で囲まれた識別子脚注1 (Oracle Database SQL言語リファレンスを参照)。この値に二重引用符記号(")または制御文字が含まれている場合、SODAではそれをアンダースコア文字(_)に置き換えます。
JSONコレクション・メタデータのドキュメント・パス	mediaTypeColumn.name

7.24 読取り専用

コレクションが読取り専用かどうかを指定するコレクション・メタデータ・コンポーネントです。

プロパティ	値
デフォルト値	FALSE
指定できる値	TRUE FALSE
JSONコレクション・メタデータのドキュメント・パス	readOnly

---

脚注凡例

脚注1:

リマインダ: 大文字/小文字を区別して解釈されるため、大文字/小文字は引用符で囲まれたSQL識別子では重要です。

脚注2:

20cより前のデータベース・リリースでは、IETF RFC 4627のみがサポートされていました。JSON文書の最上位レベルに、スカラーではなくJSONオブジェクトまたは配列のみを含めることができます。RFC 8259のサポートには、RFC 4627のサポート(およびRFC 7159のサポート)が含まれています。