Oracle NoSQL Database表は、親/子階層に編成できます。作成できる子表の数、および子表をネストできる深さに制限はありません。

親表を取得しても子表は取得されません。同様に、子表を取得しても親表は取得されません。

子表を作成するには、<parentTableName>.<childTableName>の形式を使用して表に名前を付けます。たとえば、以前にmyTableという名前の簡単な表の作成方法を示しました。

## Enter into table creation mode
table create -name myTable
## Now add the fields
add-field -type STRING -name itemCategory
add-field -type STRING -name description
## A primary key must be defined for every table
## Here, we will define field 'itemCategory' as the primary key.
primary-key -field itemCategory
## Exit table creation mode
exit
## Add the table to the store. Use the -wait flag to
## force the script to wait for the plan to complete
## before doing anything else.
plan add-table -name myTable -wait 

次のように、myChildTableという子表を作成できます。

## Enter into table creation mode
## This 'table create' will fail if 'plan add-table -name myTable'
## is not run first.
table create -name myTable.myChildTable
## Now add the fields
add-field -type STRING -name itemSKU
add-field -type STRING -name itemDescription
add-field -type FLOAT -name price
add-field -type INTEGER -name inventoryCount
## Define the primary key
primary-key -field itemSKU
## Exit table creation mode
exit
## Add the table to the store.
plan add-table -name myTable.myChildTable -wait 

これを実行する場合、子表は親表の主キーを継承することに注意してください。この簡単なケースでは、子表の主キーは実際にはitemCategoryとitemSKUの2つのフィールドです。これにはいくつかの悪影響があります。その1つは、子表を取得するときに親の主キー・フィールドが取得されるという点です。詳細は、「子表の取得」を参照してください。

Oracle NoSQL Database表の列ごとにスキーマを指定します。このスキーマは、単純なデータ型にすることも、複雑なデータ型にすることもできます。

サポートされている単純なデータ型は次のとおりです。

サポートされている複雑なデータ型は、実際には非原子的であり、クラス・オブジェクトとして操作されます。場合によっては、これによりOracle NoSQL Databaseはいくつかのデータ制限(最小データ値や最大データ値など)を満たすことができます。複雑なデータ型は次のとおりです。

「子表の定義」で説明したように、下位情報(連絡先データベースの住所、在庫システムのベンダー連絡先情報など)を保持する子表を作成できます。その際に、子表に無限の数の行を作成し、子表の行のフィールドに索引を付けることができます。

子表を使用する短所は、親表とは別のレコードとして内部的に格納される点です。つまり、子表の作成/更新/削除は複数のI/O要求を表すため、パフォーマンスに制約のあるアプリケーションにとって重要であるということです。

下位データの非常に単純な要件があり、下位データのフィールドに索引付けをしない場合、子表のかわりにレコード・フィールドを使用できます。つまり、子表で必要な複数のI/Oを回避できます。短所は、レコード・フィールドに含まれるフィールドに索引付けできないという点です。

レコード・フィールドを使用する際に前提となるのは、管理する既知の固定数レコードがあるということです(レコードを配列として編成しない場合)。たとえば、連絡先データベースの場合、子表を使用すると、ユーザーごとに無制限の数の住所を関連付けることができます。レコードを使用すると、サポートされている住所(自宅、勤務先など)のレコード・フィールドを作成することで、固定数の住所を関連付けることができます。

add-record-fieldを使用してレコード・フィールドを作成します。これにより、表を作成するときに実行するのと同じように終了する必要があるCLI内の特別なサブモードが開始されます。

## Enter into table creation mode
table create -name myContactsTable
## Now add the fields
add-field -type STRING -name uid
add-field -type STRING -name surname
add-field -type STRING -name familiarName
add-field -type STRING -name homePhone
add-field -type STRING -name workPhone

## Create a record field. This puts us into a new submode.
add-record-field -name homeAddress
add-field -type STRING -name street 
add-field -type STRING -name city
add-field -type STRING -name state
add-field -type INTEGER -name zip -min 00000 -max 99999
### Exit record field creation mode
exit

## Add a second record field
add-record-field -name workAddress
add-field -type STRING -name street 
add-field -type STRING -name city
add-field -type STRING -name state
add-field -type INTEGER -name zip -min 00000 -max 99999
### Exit record field creation mode
exit

## A primary key must be defined for every table
primary-key -field uid
## Exit table creation mode
exit
## Add the table to the store. Use the -wait flag to
## force the script to wait for the plan to complete
## before doing anything else.
plan add-table -name myContactsTable -wait 

レコード・フィールドの配列を作成することもできます。これにより、フィールドごとに無制限の数の住所フィールドを作成できます。

## Enter into table creation mode
table create -name myContactsTable
## Now add the fields
add-field -type STRING -name uid
add-field -type STRING -name surname
add-field -type STRING -name familiarName
add-field -type STRING -name homePhone
add-field -type STRING -name workPhone

## Create an array field. This puts us into a new submode.
add-array-field -name addresses

## Create a record field for the array.
## This puts us into a new submode.
add-record-field -name address
add-field -type ENUM -name addressType -enum-values home,work,other
add-field -type STRING -name street
add-field -type STRING -name city
add-field -type STRING -name state
add-field -type INTEGER -name zip -min 00000 -max 99999
### Exit record field creation mode
exit

### Exit array field creation mode
exit

## A primary key must be defined for every table
primary-key -field uid
## Exit table creation mode
exit
## Add the table to the store. Use the -wait flag to
## force the script to wait for the plan to complete
## before doing anything else.
plan add-table -name myContactsTable -wait

キー/値APIのユーザーは、Avroスキーマを使用してレコード値を記述した可能性があります。現在ストアに存在するAvroスキーマに基づいて表を作成し、そのときに既存のストア・レコードをオーバーレイします。これで、表定義を展開(変更)しないかぎり、表APIとキー/値APIの両方を使用してデータを操作できます。これは、キー/値APIから表APIへの移行を目的としています。

たとえば、ストアに次のAvroスキーマが定義されているとします。

kv-> show schema -name com.example.myItemRecord
{
  "type" : "record",
  "name" : "myItemRecord",
  "namespace" : "com.example",
  "fields" : [ {
    "name" : "itemType",
    "type" : "string",
    "default" : ""
  }, {
    "name" : "itemCategory",
    "type" : "string",
    "default" : ""
  }, {
    "name" : "itemClass",
    "type" : "string",
    "default" : ""
  }, {
    "name" : "itemColor",
    "type" : "string",
    "default" : ""
  }, {
    "name" : "itemSize",
    "type" : "string",
    "default" : ""
  }, {
    "name" : "price",
    "type" : "float",
    "default" : 0.0
  }, {
    "name" : "inventoryCount",
    "type" : "int",
    "default" : 0
  } ]
} 

ここで、このスキーマを使用して表を定義します。表の名前はスキーマの名前に基づいている必要はありません。

kv-> table create -name myItemTable
myItemTable-> add-schema -name com.example.myItemRecord
myItemTable-> show
{
  "type" : "table",
  "name" : "myItemTable",
  "id" : "myItemTable",
  "r2compat" : true,
  "description" : null,
  "shardKey" : [ ],
  "primaryKey" : [ ],
  "fields" : [ {
    "name" : "itemType",
    "type" : "STRING"
  }, {
    "name" : "itemCategory",
    "type" : "STRING"
  }, {
    "name" : "itemClass",
    "type" : "STRING"
  }, {
    "name" : "itemColor",
    "type" : "STRING"
  }, {
    "name" : "itemSize",
    "type" : "STRING"
  }, {
    "name" : "price",
    "type" : "FLOAT",
    "default" : 0.0
  }, {
    "name" : "inventoryCount",
    "type" : "INTEGER"
  } ]
}
myItemTable-> 

この時点で、主キーを定義する必要があります。また、必要に応じて表の場合と同じ方法でシャード・キーも定義します。また、通常の場合と同様にストアに表を追加する必要があります。

myItemTable->primary-key -field itemType -field itemCategory
myItemTable->exit
kv->plan add-table -name myItemTable -wait 

/User/<id>

kv-> table create -name User -r2-compat
User-> add-field -name id -type String
User-> primary-key -field id
User-> exit
Table User built.
kv-> plan add-table -name User -wait 

生産後のある時点でアプリケーションを更新する必要がある場合、新しいフィールドを使用するため、または使用しなくなった既存のフィールドを削除するために表も更新する必要がある可能性が高くなります。そのためには、table evolveおよびplan evolve-tableコマンドを使用します。

フィールドが主キー・フィールドの場合は削除できないことに注意してください。

表を展開できるのは、plan add-tableまたはplan evolve-tableコマンドを使用してストアにすでに追加されている場合のみです。

たとえば、次のスクリプトは前の項で作成した表を展開します。フィールドを追加し、別のフィールドを削除します。また、設計、テストおよび本番環境の一貫性を維持できるようにスクリプトを使用して表を展開します。

## Enter into table evolution mode
table evolve -name myTable
## Add a field
add-field -type STRING -name itemCategory
## Remove a field.
remove-field -name percentage
## Exit table creation mode
exit
plan evolve-table -name myTable -wait 

この項では、表の操作に使用するCLIコマンドについて簡単に説明します。この項は宣伝のみを目的としています。

すべてのCLIコマンドの包括的なリストおよびその構文は、「KVStoreコマンド・リファレンス」を参照してください。CLIのhelpコマンドを使用して、すべてのCLIコマンドのコマンド構文を表示することもできます。