Métadonnées de collection SODA pour une base de données autonome

Décrit les métadonnées de collection par défaut et personnalisées pour une base de données autonome.

Métadonnées de collection par défaut SODA pour une base de données autonome

Décrit les métadonnées de collection par défaut pour une base de données autonome, c'est-à-dire les métadonnées qui sont ajoutées à une collection en l'absence de métadonnées personnalisées.

Chaque mise en oeuvre de SODA permet de créer une collection par défaut lorsque vous indiquez un nom de collection. Par exemple, dans SODA pour Java, vous utilisez la méthode createCollection et fournissez uniquement un paramètre de nom de collection : 

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

Cette opération crée une collection avec les métadonnées de collection par défaut. Lorsque vous créez une collection par défaut dans Autonomous Database, les métadonnées de la collection comprennent les informations suivantes (quelle que soit la mise en oeuvre de SODA utilisée pour créer la collection par défaut) : 

{
   "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
}

Métadonnées personnalisées de collection SODA pour une base de données autonome

Décrit les métadonnées personnalisées de collection SODA pour les bases de données autonomes.

Chaque mise en oeuvre de SODA permet de personnaliser les métadonnées d'une collection lors de la création de celle-ci. Par exemple, dans SODA pour Java, vous pouvez utiliser la commande suivante :

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

Dans cet exemple, pour metadata_string, vous pouvez utiliser les métadonnées par défaut comme point de départ et personnaliser les suivantes :

  • Remplacez keyColumn.assignmentMethod par CLIENT. Remplacez la valeur de assignmentMethod sous keyColumn dans les métadonnées par CLIENT (au lieu de UUID).

    Valeurs valides pour keyColumn.assignmentMethod pour une base de données autonome :

    • UUID (par défaut) : Les clés sont générées par SODA en fonction de l'UUID.

    • CLIENT : Les clés sont affectées par l'application CLIENT.

  • Indiquez une valeur mediaTypeColumn name : Une colonne de type de média est nécessaire si la collection doit être hétérogène, c'est-à-dire qu'elle doit stocker des documents dans un format autre que JavaScript Object Notation (JSON). Voir Nom de colonne de type de média pour plus de détails.

L'exemple suivant indique les clés affectées par le client et une colonne de type de média personnalisée. La valeur mediaTypeColumn name est indiquée avec la valeur YOUR_MEDIA_TYPE_COLUMN_NAME. Sinon, les paramètres par défaut sont utilisés. 

{
   "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
}