Documentazione dell'infrastruttura Oracle Cloud

Metadati raccolta SODA

Descrive i metadati della raccolta SODA nel database.

Argomento padre: Riferimento

Metadati di raccolta SODA in Autonomous Database

Descrive i metadati di raccolta predefiniti e personalizzati in Autonomous Database.

Argomento padre: Metadati raccolta SOA

Metadati di raccolta predefiniti SODA in Autonomous Database

Descrive i metadati di raccolta predefiniti in Autonomous Database, ovvero i metadati per una raccolta aggiunta quando non vengono forniti i metadati personalizzati.

Ogni implementazione SODA consente di creare una raccolta predefinita quando si fornisce un nome di raccolta. Ad esempio, in SODA per Java si utilizza il metodo createCollection e si fornisce solo un parametro nome raccolta: 

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

In questo modo viene creata una raccolta con metadati di raccolta predefiniti. Quando si crea una raccolta predefinita nel database, i metadati della raccolta includono le informazioni riportate di seguito, indipendentemente dall'implementazione SODA utilizzata per creare la raccolta predefinita. 

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

Utilizzando Autonomous Database Sempre gratis con Oracle Database 23ai, i metadati predefiniti vengono modificati come indicato di seguito. 
{
   "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
}

Metadati di raccolta personalizzati SODA in Autonomous Database

Descrive i metadati personalizzati della raccolta SODA in Autonomous Database.

Ogni implementazione SODA fornisce un modo per personalizzare i metadati della raccolta durante la creazione della raccolta. Ad esempio, in SODA per Java è possibile utilizzare il seguente comando:

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

In questo esempio, per metadata_string è possibile utilizzare i metadati predefiniti come punto di partenza e personalizzare quanto riportato di seguito.

  • Modificare keyColumn.assignmentMethod in CLIENT: modificare il valore di assignmentMethod sotto keyColumn nei metadati in CLIENT (anziché UUID).

    Valori validi per keyColumn.assignmentMethod in Autonomous Database:

    • UUID (impostazione predefinita): le chiavi vengono generate da SODA, in base al valore UUID.

    • CLIENT: le chiavi vengono assegnate dall'applicazione CLIENT.

  • Fornire un valore mediaTypeColumn name: è necessaria una colonna del tipo di supporto se la raccolta deve essere eterogenea, ovvero può memorizzare documenti diversi dalla notazione oggetto JavaScript (JSON). Per informazioni dettagliate, vedere Nome colonna tipo di supporto.

L'esempio seguente specifica le chiavi assegnate dal client e una colonna personalizzata del tipo di supporto. Il valore mediaTypeColumn name viene specificato con YOUR_MEDIA_TYPE_COLUMN_NAME. In caso contrario, vengono utilizzate le impostazioni predefinite. 

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