Documentation sur 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 : Informations de référence

Métadonnées de la collection SODA sur la base de données autonome d'IA

Décrit les métadonnées de collection par défaut et personnalisées sur la base de données d'IA autonome.

Rubrique parent : Métadonnées de collecte SODA

Métadonnées de collecte par défaut SODA sur la base de données d'intelligence artificielle autonome

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

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 votre base de données, les métadonnées de la collection contiennent les informations suivantes (quelle que soit la procédure de mise en oeuvre 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
}
Note

À l'aide de la base de données d'IA autonome toujours gratuite avec Oracle AI Database 26ai, les métadonnées par défaut sont modifiées 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 personnalisées SODA sur la base de données autonome d'IA

Décrit les métadonnées personnalisées de la collection SODA sur la base de données d'IA autonome.

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 é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 dans la base de données d'intelligence artificielle 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
}