機械翻訳について

SODAコレクション・メタデータ

データベース上のSODAコレクション・メタデータを記述します。

親トピック: リファレンス

Autonomous DatabaseのSODAコレクション・メタデータ

Autonomous Databaseのデフォルトおよびカスタマイズされたコレクション・メタデータについて説明します。

親トピック: SODAコレクション・メタデータ

Autonomous DatabaseでのSODAのデフォルトのコレクション・メタデータ

カスタム・メタデータが指定されていない場合に追加されるコレクションのメタデータである、Autonomous Databaseのデフォルトのコレクション・メタデータについて説明します。

各SODA実装には、コレクション名を指定するときにデフォルトのコレクションを作成する方法が用意されています。 たとえば、SODA for Javaでは、createCollectionメソッドを使用し、コレクション名パラメータのみを指定します: 

db.admin().createCollection("myCol");

これにより、デフォルトのコレクション・メタデータでコレクションが作成されます。 databaseでデフォルト・コレクションを作成すると、(デフォルト・コレクションの作成に使用するSODA実装に関係なく)コレクション・メタデータには次の情報が含まれます: 

{
   "keyColumn" :
   {
      "name" : "ID",
      "sqlType" : "VARCHAR2",
      "maxLength" : 255,
      "assignmentMethod" : "UUID"
   },

   "contentColumn" :
   {
      "name" : "JSON_DOCUMENT",
      "sqlType" : "BLOB",
      "jsonFormat" : "OSON"
   },
   "versionColumn" :
   {
     "name" : "VERSION",
     "method" : "UUID"
   },
   
   "lastModifiedColumn" :
   {
     "name" : "LAST_MODIFIED"
   },
   
   "creationTimeColumn" :
   {
      "name" : "CREATED_ON"
   },
   
   "readOnly" : false
}

ノート:

Always Free Autonomous DatabaseをOracle Database 23aiとともに使用すると、デフォルトのメタデータが次のように変更されます。 
{
   "keyColumn" :
   {
      "name" : "ID",
      "sqlType" : "VARCHAR2",
      "maxLength" : 255,
      "assignmentMethod" : "UUID"
   },

   "contentColumn" :
   {
      "name" : "JSON_DOCUMENT",
      "sqlType" : "JSON",
   },
   "versionColumn" :
   {
     "name" : "VERSION",
     "method" : "UUID"
   },
   
   "lastModifiedColumn" :
   {
     "name" : "LAST_MODIFIED"
   },
   
   "creationTimeColumn" :
   {
      "name" : "CREATED_ON"
   },
   
   "readOnly" : false
}

親トピック: Autonomous DatabaseのSODAコレクション・メタデータ

Autonomous DatabaseでのSODAカスタマイズ済コレクション・メタデータ

Autonomous DatabaseでのSODAコレクション・カスタム・メタデータについて説明します。

各SODA実装には、コレクション作成時にコレクション・メタデータをカスタマイズする方法が用意されています。 たとえば、SODA for Javaでは、次のコマンドを使用できます: 

OracleDocument metadata = db.createDocumentFromString("metadata_string");
OracleCollection col = db.admin().createCollection("myCustomColl", metadata);

この例では、metadata_stringのデフォルト・メタデータを開始点として使用し、次の項目をカスタマイズできます:

  • keyColumn.assignmentMethodのCLIENTへの変更: メタデータのkeyColumnの下にあるassignmentMethodの値を(UUIDではなく) CLIENTに変更します。

    Autonomous Database上のkeyColumn.assignmentMethodの有効な値:

    • UUID (デフォルト): キーは、UUIDに基づいてSODAによって生成されます。

    • CLIENT: キーはクライアント・アプリケーションによって割り当てられます。

  • mediaTypeColumn name値を指定してください: コレクションが異種である場合、つまりJavaScript Object Notation (JSON)以外のドキュメントを格納できる場合は、メディア・タイプ列が必要です。 詳細は「メディア・タイプ列名」を参照してください。

次の例では、クライアントによって割り当てられたキーとカスタム・メディア・タイプ列を指定します。 mediaTypeColumn nameは、値YOUR_MEDIA_TYPE_COLUMN_NAMEで指定されます。 それ以外の場合は、デフォルト設定が使用されます。 

{
   "keyColumn" :
   {
      "name" : "ID",
      "sqlType" : "VARCHAR2",
      "maxLength" : 255,
      "assignmentMethod" : "CLIENT"
   },
   
   "contentColumn" :
   {
      "name" : "JSON_DOCUMENT",
      "sqlType" : "BLOB"
   },

   "versionColumn" :
   {
     "name" : "VERSION",
     "method" : "UUID"
   },

   "lastModifiedColumn" :
   {
     "name" : "LAST_MODIFIED"
   },

   "creationTimeColumn" :
   {
      "name" : "CREATED_ON"
   },

   "mediaTypeColumn" :
   {
      "name" : "YOUR_MEDIA_TYPE_COLUMN_NAME"
   },

   "readOnly" : false
}

親トピック: Autonomous DatabaseのSODAコレクション・メタデータ