Documentation Oracle Cloud Infrastructure

Métadonnées de collection SODA

Il décrit les métadonnées de la collection SODA sur la base de données.

Rubrique parent : Référence

Métadonnées de collection SODA sur la base de données Autonomous AI

Décrit les métadonnées d'ensemble par défaut et personnalisées sur Autonomous AI Database.

Rubrique parent : Métadonnées de collection SODA

Métadonnées de collection SODA par défaut sur la base de données Autonomous AI

Décrit les métadonnées d'une collection par défaut sur Autonomous AI Database, c'est-à-faire les métadonnées d'une collection qui sont ajoutées lorsque ces métadonnées personnalisées ne sont pas fournies.

Chaque implémentation SODA permet de créer une collection par défaut lorsque vous indiquez un nom de collection. Par exemple, dans SODA pour Java, 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 votre base de données, les métadonnées de la collection incluent les informations suivantes (quelle que soit l'implémentation SODA que vous utilisez 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
}
Remarque

L'utilisation d'une base de données d'IA autonome Toujours gratuit avec Oracle AI Database 26ai modifie les métadonnées par défaut comme suit. 
{
   "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
}

Métadonnées de collection SODA personnalisées sur la base de données Autonomous AI

Décrit les métadonnées personnalisées de collection SODA sur la base de données Autonomous AI.

Chaque implémentation SODA permet de personnaliser les métadonnées de collection lors de la création de la collection. 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 éléments suivants :

  • 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 sur la base de données Autonomous AI :

    • UUID (valeur par défaut) : les clés sont générées par SODA, en fonction de UUID

    • CLIENT : les clés sont affectées par l'application client

  • Indiquez une valeur mediaTypeColumn name : une colonne de type de support est nécessaire si la collection doit être hétérogène, c'est-à-dire qu'elle peut stocker des documents dans des formats autres que JSON (JavaScript Object Notation). Pour obtenir des détails, reportez-vous à Nom de colonne de types de média.

L'exemple suivant spécifie des clés affectées par le client et une colonne de type de support personnalisée. mediaTypeColumn name est spécifié 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
}