aggregate kv [-count] [-sum <field[,field,..]>] [-avg <field[,field,..]>]
              [-key <key>] [-schema <name>]
              [-start <prefixString>] [-end <prefixString>] 

指定キーを使用した単純なデータ集計操作を実行します。

説明:

たとえば、ストア内のすべてのレコードの単純なcountは次のとおりです。

kv-> aggregate kv -count
count: 33508 

Sumおよびaverageは、一致するレコードの特定のフィールド名を操作しますが、これは、その名前のフィールドを含むAvroレコードのみが使用されるということです。Sumおよびaverageは、AvroタイプがINT、LONG、FLOATおよびDOUBLEの数値フィールドのみを操作します。

たとえば、次のようなスキーマがあるとします。

{
   "type" : "record",
   "name" : "Cookie",
   "fields" : [ {
   "name" : "id",
   "type" : "string",
   "default" : ""
   }, {
     "name" : "frequency",
     "type" : "int",
     "default" : 0
   }, {
     "name" : "lastVisit",
     "type" : "string",
     "default" : ""
   }, {
     "name" : "segments",
     "type" : {
        "type" : "array",
     "items" : "string"
     },
     "default" : [ ]
   } ]
} 

frequencyという名前のフィールドのsumの例:

kv-> aggregate kv -sum frequency -key /visits/charitable_donors/date
sum(frequency): 2068 

frequencyという名前のフィールドのaverageの例:

kv -> aggregate kv -avg frequency -key /visits/charitable_donors/date
avg(frequency): 2.494571773220748 

aggregate table -name <name>
              [-count] [-sum <field[,field,..]>]
              [-avg <field[,field,..]>]
              [-index <name>]
              [-field <name> -value <value>]*
              [-field <name> [-start <value>] [-end <value>]]
              [-json <string>] 

表の数値フィールドに対し、単純なデータ集計操作を実行します。

説明:

次の例を参照してください。

# Create a table 'user_test' with an index on user_test(age):
kv-> execute 'CREATE TABLE user_test (id INTEGER,
firstName STRING, lastName STRING, age INTEGER, PRIMARY KEY (id))'
Statement completed successfully

kv-> execute 'CREATE INDEX idx1 on user_test (age)'
Statement completed successfully

# Insert 3 rows:
kv-> put table -name user_test -json 
'{"id":1,"firstName":"joe","lastName":"wang","age":21}'
Operation successful, row inserted.
kv-> put table -name user_test -json
'{"id":2,"firstName":"jack","lastName":"zhao","age":32}'
Operation successful, row inserted.
kv-> put table -name user_test -json
'{"id":3,"firstName":"john","lastName":"gu","age":43}'
Operation successful, row inserted.

# Get count(*), sum(age) and avg(age) of rows in table:
kv-> aggregate table -name user_test -count -sum age -avg age
Row count: 3
Sum:
        age(3 values): 96
Average:
        age(3 values): 32.00

# Get count(*), sum(age) and avg(age) of rows where
age >= 30, idx1 is utilized to filter the rows:
kv-> aggregate table -name user_test -count -sum age
-avg age -index idx1 -field age -start 30
Row count: 2
Sum:
        age(2 values): 75
Average:
        age(2 values): 37.50

connect admin -host <hostname> -port <registry port> [-username <user>]
[-security <security-file-path>] 

指定されたホストおよびレジストリ・ポートに接続して、管理機能を実行します。管理サービスがターゲット・ホストでアクティブである必要があります。インスタンスが保護されている場合、ログイン資格証明を入力する必要がある可能性があります。

connect store -host <hostname> -port <port> -store <storename> [-username
<user>] [-security <security-file-path>] 

KVStoreに接続し、データ・アクセス機能を実行します。インスタンスが保護されている場合、ログイン資格証明を入力する必要がある可能性があります。

delete kv [-key <key>] [-start prefixString] [-end prefixString] [-all] 

1つ以上のキーを削除します。-allが指定される場合、指定のキーで始まるすべてのキーを削除します。キーが指定されていない場合、ストア内のすべてのキーを削除します。-start および-endフラグは、削除に使用する範囲の制限に使用できます。

たとえば、rootで始まるストア内のすべのキーを削除するには、次のようにします。

kv -> delete kv -all
301 Keys deleted starting at root 

delete table -name <name>
 [-field <name> -value <value>]*
 [-field <name> [-start <value>] [-end <value>]]
 [-ancestor <name>]* [-child <name>]*
 [-json <string>] [-delete-all] 

指定された表から1つまたは複数の行を削除します。表名はピリオドで区切られた名前で、フォーマットはtableName[.childTableName]*です。

ddl add-schema <-file <file> | -string <schema string>>
[-evolve] [-force] 

新しいスキーマを追加するか、または同じ名前を持つ既存のスキーマを変更(展開)します。-evolveフラグを使用して、スキーマが変更されていることを示します。-forceフラグを使用して、変更の警告を無視してスキーマを追加します。

ddl enable-schema -name <name>.<ID> 

以前無効だった既存のスキーマを有効にします。

ddl disable-schema -name <name>.<ID> 

既存のスキーマを無効にします。

get kv [-key <keyString>] [-json] [-file <output>] [-all] [-keyonly]
[-valueonly] [-start <prefixString>] [-end <prefixString>] 

指定されたキーを使用して単純なget操作を実行します。取得した値に表示可能な文字が含まれている場合はそれが出力され、そうでない場合は、そのバイト配列がBase64を使用して表示用にエンコーディングされます。この変換を示すために"[Base64]"が追加されます。getコマンドの引数は次のとおりです。

サブコマンド「get table」を参照してください。

get table -name <name> [-index <name>]
[-field <name> -value <value>]*
[-field <name> [-start <value>] [-end <value>]]
[-ancestor <name>]* [-child <name>]*
[-json <string>] [-file <output>] [-pretty] 

取得操作を実行し、指定された表から行を取得します。表名はピリオドで区切られた名前で、フォーマットはtableName[.childTableName]*です。

plan add-index -name <name> -table <name> [-field <name>]*
[-desc <description>]
[-plan-name <name>] [-wait] [-noexecute] [-force] 

ストア内の表に索引を追加します。表名はピリオドで区切られた名前で、フォーマットはtableName[.childTableName]*です。

plan add-table -name <name>
[-plan-name <name>] [-wait] [-noexecute] [-force] 

ストアに新しい表を追加します。表名はピリオドで区切られた名前で、フォーマットはtableName[.childTableName]*です。

表を追加する前に、まずtable createコマンドを使用して指定された表を作成します。次の例では、表を定義します(名前で表を作成し、フィールドおよびその他の表メタデータを追加します)。

## Enter into table creation mode
table create -name user -desc "A sample user table"
user->
user-> help
Usage: add-array-field |
add-field |
add-map-field |
add-record-field |
add-schema |
cancel |
exit |
primary-key |
remove-field |
set-description |
shard-key |
show 

## Now add the fields
user-> help add-field
Usage: add-field -type <type> [-name <field-name> ] [-not-required]
[-nullable] [-default <value>] [-max <value>] [-min <value>]
[-max-exclusive] [-min-exclusive] [-desc <description>]
[-size <size>] [-enum-values <value[,value[,...]]
<type>: INTEGER, LONG, DOUBLE, FLOAT, STRING, BOOLEAN, DATE, BINARY, FIX
ED_BINARY, ENUM 

## Adds a field. Ranges are inclusive with the exception of String,
## which will be set to exclusive.
user-> add-field -type Integer -name id
user-> add-field -type String -name firstName
user-> add-field -type String -name lastName
user-> help primary-key
Usage: primary-key -field <field-name> [-field <field-name>]*
## Sets primary key.
user-> primary-key -field id
## Exit table creation mode
user-> exit
## Table User built. 

table list -createを使用すると、追加できる表の一覧を表示します。次の例はデプロイメントの準備が整っている表を一覧表示します。

kv-> table list
## Tables to be added:
## User -- A sample user table
kv-> table list -name user
## Add table User:
{
  "type" : "table",
  "name" : "User",
  "id" : "User",
  "description" : "A sample user table",
  "shardKey" : [ "id" ],
  "primaryKey" : [ "id" ],
  "fields" : [ {
    "name" : "id",
    "type" : "INTEGER"
  }, {
    "name" : "firstName",
    "type" : "STRING"
  }, {
    "name" : "lastName",
    "type" : "STRING"
  } ]
} 

次の例では、ストアに表を追加します。

## Add the table to the store.
kv-> help plan add-table
kv-> plan add-table -name user -wait
Executed plan 5, waiting for completion...
Plan 5 ended successfully
kv-> show tables -name user
{
  "type" : "table",
  "name" : "User",
  "id" : "r",
  "description" : "A sample user table",
  "shardKey" : [ "id" ],
  "primaryKey" : [ "id" ],
  "fields" : [ {
    "name" : "id",
    "type" : "INTEGER"
  }, {
    "name" : "firstName",
    "type" : "STRING"
  }, {
    "name" : "lastName",
    "type" : "STRING"
  } ]
} 

表デザインに関する詳細および例は、Oracle NoSQL Database表および索引の概要を参照してください。

plan cancel -id <plan id> | -last 

実行中ではないプランを取り消します。実行中のプランを取り消すにはその前に中断する必要があります。

-lastオプションを使用して、最も最近作成されたプランを参照します。

plan change-parameters -security | -service <id> | -all-rns [-zn <id> | -
znname <name>] | -all-admins [-zn <id> | -znname <name>] [-dry-run]
[-plan-name <name>] [-wait] [-noexecute] [-force] -params [name=value]* 

指定されたゾーンまたはすべてのゾーンにデプロイされた、指定されたサービスまたは同じタイプのすべてのサービス・インスタンスのパラメータを変更します。

-securityフラグにより、ストア全体のグローバル・セキュリティ・パラメータの変更が可能です。他のフラグとともに使用しないでください。

-serviceフラグにより、単一インスタンスが影響を受けるようにできます。-znまたは-znnameフラグとともに使用しないでください。

-all-*フラグは、サービス・タイプのすべてのインスタンスを変更する際に使用できます。変更するパラメータは-paramsフラグの後に続き、スペースで区切られます。スペースが埋め込まれたパラメータ値は、name="value with spaces"のように引用符で囲む必要があります。

-all-*フラグの1つを-znまたは-znnameフラグを組み合せて、指定されたゾーンにデプロイされたサービス・タイプのすべてのインスタンスを変更できます。別のゾーンにデプロイされた指定タイプのインスタンスは変更しません。-all-*フラグの1つがゾーンを指定せずに使用された場合、必要なパラメータ変更は、ゾーンに関係なくストア内の指定されたタイプのすべてのインスタンスに適用されます。

-dry-runが指定された場合、新規パラメータが変更されずに返されます。変更できるパラメータを表示するには、コマンドshow parametersを使用します。詳細は、「show parameters」を参照してください。

ストア内のパラメータの変更の詳細は、「ストアのパラメータの設定」を参照してください。

plan change-storagedir -sn <id> -storagedir <path> -add | -remove
[-plan-name <name>] [-wait] [-noexecute]
[-force] 

レプリケーション・ノードを格納するために、ストレージ・ノード上のストレージ・ディレクトリを追加または削除します。

plan change-user -name <user name>
[-disable | -enable] [-set-password [-password <new password>]
[-retain-current-password]] [-clear-retained-password]
[-plan-name <name>] [-wait] [-noexecute] [-force] 

ストアで指定された名前でユーザーを変更します。-retain-current-password引数オプションによって、構成された保存時間の間または-clear-retained-passwordを使用して消去されるまで、-set-password操作で有効な代替パスワードとして現行パスワードを保持します。保持されたパスワードがすでにユーザーに設定されている場合、再度パスワードを設定するとエラーが発生し、レポートされます。

このコマンドは非推奨です。詳細は、『Oracle NoSQL Database管理者ガイド』でユーザーの変更に関する項を参照してください。

plan create-user -name <user name>
[-admin] [-disable] [-password <new password>]
[-plan-name <name>] [-wait] [-noexecute] [-force] 

ストアで指定された名前でユーザーを作成します。-admin引数は作成されたユーザーに完全な管理者権限があることを示します。

このコマンドは非推奨です。詳細は、『Oracle NoSQL Database管理者ガイド』でユーザーの作成に関する項を参照してください。

plan deploy-admin -sn <id> -port <http port> [-plan-name <name>]
[-wait] [-noexecute] [-force] 

指定されたストレージ・ノードにAdminをデプロイします。管理のタイプ(PRIMARY/SECONDARY)は、ストレージ・ノードが置かれているゾーンのタイプと同じです。このグラフィカル・インタフェースは指定されたポート上でリスニングします。

管理のデプロイの詳細は、「特定のホストでの管理プロセスの作成」を参照してください。

非推奨。かわりに「plan deploy-zone」を参照してください。

plan deploy-sn -zn <id> | -znname <name> -host <host> -port <port>
[-plan-name <name>] [-wait] [-noexecute] [-force] 

指定されたホストおよびポートにおけるストレージ・ノードを指定されたゾーンにデプロイします。

ストレージ・ノードのデプロイの詳細は、「残りのストレージ・ノードの作成」を参照してください。

plan deploy-topology -name <topology name> [-plan-name <name>]
[-wait] [-noexecute] [-force] 

指定されたトポロジをストアにデプロイします。この操作は、ストアのサイズおよび状態によって、時間がかかる場合があります。

申し分のないトポロジ候補のデプロイの詳細は、「トポロジ候補のデプロイ」を参照してください。

plan deploy-zone -name <zone name>
-rf <replication factor>
[-type [primary | secondary]]
[-plan-name <name>] [-wait] [-noexecute] [-force] 

-typeが指定されていない場合、指定されたゾーンをストアにデプロイし、プライマリ・ゾーンを作成します。

ゾーンの作成に関する詳細は、「ゾーンの作成」を参照してください。

plan drop-user -name <user name>
[-plan-name <name>] [-wait] [-noexecute] [-force] 

ストア内の指定された名前でユーザーを削除します。ログイン・ユーザーは自身を削除することはできません。

このコマンドは非推奨です。詳細は、『Oracle NoSQL Database管理者ガイド』でユーザーの削除に関する項を参照してください。

plan evolve-table -name <name>
[-plan-name <name>] [-wait] [-noexecute] [-force] 

ストア内で表を展開します。表名はピリオドで区切られ、フォーマットはtableName[.childTableName]*です。

table evolveコマンドを使用して、指定された表を展開します。次の例では、表を展開しています。

## Enter into table evolution mode
kv-> table evolve -name User
kv-> show
{
  "type" : "table",
  "name" : "User",
  "id" : "r",
  "description" : "A sample user table",
  "shardKey" : [ "id" ],
  "primaryKey" : [ "id" ],
  "fields" : [ {
    "name" : "id",
    "type" : "INTEGER"
  }, {
    "name" : "firstName",
    "type" : "STRING"
  }, {
    "name" : "lastName",
    "type" : "STRING"
  } ]
}
## Add a field
kv-> add-field -type String -name address
## Exit table creation mode
kv-> exit
## Table User built. 

kv-> plan evolve-table -name User -wait
## Executed plan 6, waiting for completion...
## Plan 6 ended successfully
kv-> show tables -name User
{
  "type" : "table",
  "name" : "User",
  "id" : "r",
  "description" : "A sample user table",
  "shardKey" : [ "id" ],
  "primaryKey" : [ "id" ],
  "fields" : [ {
    "name" : "id",
    "type" : "INTEGER"
  }, {
    "name" : "firstName",
    "type" : "STRING"
  }, {
    "name" : "lastName",
    "type" : "STRING"
  }, {
    "name" : "address",
    "type" : "STRING"
  } ]
} 

table list -evolveを使用すると、展開できる表の一覧を表示します。詳細は「plan add-table」を参照してください。

plan execute -id <id> | -last [-wait] [-force] 

作成済でまだ実行されていないプランを実行します。プランは、-noexecuteフラグを使用して事前に作成されているはずです。

-lastオプションを使用して、最も最近作成されたプランを参照します。

plan grant [-role <role name>]* -user <user_name> 

ユーザーにロールを付与できるようにします。

説明:

このコマンドは非推奨です。詳細は、『Oracle NoSQL Database管理者ガイド』でロールまたは権限の付与に関する項を参照してください。

plan interrupt -id <plan id> | -last 

実行中のプランを中断します。中断されたプランは再実行または取消のみが可能です。-lastを使用して、最も最近作成されたプランを参照します。

plan migrate-sn -from <id> -to <id> [-admin-port <admin port>]
[-plan-name <name>] [-wait] [-noexecute] [-force] 

あるストレージ・ノードから別のストレージ・ノードにサービスを移行します。古いノードは実行中ではないことが必要です。

古いノードが管理サービスをホストしていた場合は、-admin-portオプションが必要です。

plan migrate-snコマンドを実行する前に、-java -Xmx256m -Xms256m -jar KVHOME/lib/kvstore.jar stop -root KVROOTを使用して実行中の古いストレージ・ノードを停止できます。

 plan remove-admin -admin <id> | -zn <id> | -znname <name> [-force]
[-plan-name <name>] [-wait] [-noexecute] [-force] 

必要な管理インスタンス(単一の指定されたインスタンスまたはデプロイされたすべてのインスタンス)を指定されたゾーンに移動します。

ストア内で実行されている管理が3つ以下で-adminフラグを使用する場合、あるいは-znまたは-znnameフラグを使用して指定されたゾーンからすべての管理を削除することでストア内に残る管理が1つか2つのみの場合、-forceフラグを使用した場合にのみ必要な管理が削除されます。

また、ストア内の管理が1つのみで-adminフラグを使用する場合、あるいは、-znまたは-znnameフラグを使用して指定されたゾーンからすべての管理を削除することでストアからすべての管理が削除されることになる場合、必要な管理は削除されません。

plan remove-index -name <name> -table <name>
[-plan-name <name>] [-wait] [-noexecute] [-force] 

表から索引を削除します。表名はピリオドで区切られた名前で、フォーマットはtableName[.childTableName]*です。

plan remove-datacenter 

非推奨。かわりに「plan remove-zone」を参照してください。

plan remove-sn -sn <id> [-plan-name <name>]
[-wait] [-noexecute] [-force] 

指定されたストレージ・ノードをトポロジから削除します。

このコマンドは、未使用の古いストレージ・ノードをストアから削除する場合に便利です。これを行うには、「障害が発生したストレージ・ノードの置換」を参照してください。

plan remove-table -name <name> [-keep-data]
[-plan-name <name>] [-wait] [-noexecute] [-force] 

ストアから表を削除します。指定された表が存在し、子表を持っていない必要があります。表の索引は自動的に削除されます。デフォルトでは、この表に格納されているデータも削除されます。表データは-keep-dataフラグを指定することにより、オプションで保存できます。索引および表に格納されているデータの量によっては、長時間のプランになる可能性があります。

次の例では、表を削除しています。

## Remove a table.
kv-> plan remove-table -name User
## Started plan 7. Use show plan -id 7 to check status.
## To wait for completion, use plan wait -id 7.
kv-> show tables
## No table found. 

詳細はOracle NoSQL Database表および索引の概要を参照してください。

plan remove-zone -zn <id> | -znname <name>
[-plan-name <name>] [-wait] [-noexecute] [-force] 

指定されたゾーンをストアから削除します。

このコマンドを実行する前に、plan remove-snコマンドを使用して、指定されたゾーンに属するすべてのストレージ・ノードをまず削除する必要があります。

plan repair-topology
[-plan-name <name>] [-wait] [-noexecute] [-force] 

前回のdeploy-topologyまたはmigrate-snプランの中断か取消から発生した可能性がある、デプロイされた現行トポロジにおける位置メタデータの不整合を検証します。可能であれば、不整合は修復されます。この操作は、ストアのサイズおよび状態によって、時間がかかる場合があります。

plan revoke [-role <role name>]* -user <user_name> 

ユーザーからロールを取り消すことができるようにします。

説明:

このコマンドは非推奨です。詳細は、『Oracle NoSQL Database管理者ガイド』でロールまたは権限の取消しに関する項を参照してください。

plan start-service -service <id> | -all-rns [-plan-name <name>]
[-wait] [-noexecute] [-force] 

指定されたサービスを開始します。

plan stop-service -service <id> | -all-rns
[-plan-name <name>] [-wait] [-noexecute] [-force] 

指定されたサービスを停止します。

このコマンドを使用して、システムによる通信の試行が行われなくなるように、影響を受けるサービスを停止します。その結果、すでに認識している障害に関連するエラー出力の量が減少します。

このコマンドは、ディスク置換プロセスの際に役立ちます。障害が発生したディスクを削除する前に、影響を受けるサービスを停止するには、plan stop-serviceコマンドを使用します。詳細は、「障害が発生したディスクの置換」を参照してください。

plan wait -id <id> | -last [-seconds <timeout in seconds>] 

オプションのタイムアウトが指定されていない場合は、指定したプランが完了するまで無期限に待機します。

-secondsオプションを使用すると、プランが完了するまで待機する時間を指定できます。

-lastオプションは、最も最近作成されたプランを参照します。

pool create -name <name> 

ストアの作成または変更時にリソース・ディストリビューションに使用される、新規ストレージ・ノード・プールを作成します。

ストレージ・ノード・プールの作成の詳細は、「ストレージ・ノード・プールの作成」を参照してください。

pool join -name <name> [-service] <snX>* 

ストレージ・ノードを既存のストレージ・ノード・プールに追加します。

pool remove -name <name> 

ストレージ・ノード・プールを削除します。

put kv -key <keyString> -value <valueString> [-file]
[-hex | -json <schemaName>] [-if-absent] [-if-present] 

指定のキー/値のペアをストアに格納します。次の引数が、putコマンドに適用されます。

put table -name <name> [if-absent | -if-present ]
[-json <string>] [-file <file>] [-update] 

指定された表に行を格納します。表名はピリオドで区切られた名前で、フォーマットはtable[.childTableName]*です。

説明:

show admins 

管理サービスの基本情報を表示します。

show datacenters 

非推奨。かわりに「show zones」を参照してください。

show events [-id <id>] | [-from <date>] [-to <date> ]
[-type <stat | log | perf>] 

イベント詳細またはストア・イベントのリストを表示します。ステータス・イベントは、サービス・ステータスの変更を示します。

ログ・イベントは、注意が必要な場合は示されます。

パフォーマンス・イベントは通常クリティカルではありませんが、調査の評価に値します。"SEVERE"とマークされたイベントは調査する必要があります。

次の日付/時間の形式を使用できます。これはローカル・タイム・ゾーンで解釈されます。

イベントの詳細は、「イベント」を参照してください。

show faults [-last] [-command <command index>] 

失敗しているコマンドを表示します。デフォルトではすべての使用可能な失敗コマンドが表示されます。個々の失敗の詳細は、-lastおよび-commandフラグを使用して表示できます。

show indexes [-table <name>] [-name <name>]

索引メタデータを表示します。デフォルトでは、すべての表の索引メタデータがリストされます。

特定の表が指定された場合、その表の索引メタデータが表示されます。特定の表の索引が指定された場合、その索引のメタデータが表示されます。詳細は、「plan add-index」を参照してください。

show parameters -policy | -service <name> 

指定されたサービスのサービス・パラメータおよび状態を表示します。サービスには、任意の有効な文字列(たとえば、rg1-rn1、sn1、admin2)で識別されるレプリケーション・ノード、ストレージ・ノードまたは管理サービスを指定できます。-policyフラグを使用してグローバル・ポリシー・パラメータを表示します。

show perf 

各レプリケーション・ノードの最近のパフォーマンス情報を表示します。

show plans [-id <id> | -last] 

指定されたプランの詳細を表示するか、対応するプランIDおよびステータスとともに作成されているすべてのプランを一覧表示します。

-idオプションを使用すると、追加の詳細およびステータスを表示するプランを指定できます。

-lastオプションは、最も最近作成されたプランの詳細を表示します。

プラン確認の詳細は、「プランの確認」を参照してください。

show pools 

ストレージ・ノード・プールを一覧表示します。

show schemas [-disabled] | [-name <name>] 

指定されたスキーマのスキーマ詳細、またはストアに登録されているスキーマのリストを表示します。

-nameオプションを使用すると、ストアで現在有効かどうかを確認するスキーマの名前を指定できます。

-disabledオプションを使用すると、現在無効なスキーマも含めて、すべてのスキーマを表示できます。

show snapshots [-sn <id>] 

指定されたストレージ・ノード上のスナップショットを一覧表示します。ストレージ・ノードが指定されていない場合、ストアからストレージ・ノードが1つ選択されます。このコマンドを使用して既存のスナップショットを表示できます。

show tables -name <name>

表情報を表示します。展開のために表を構築している場合、-originalフラグを使用して、元の表情報を表示します。追加するために表を構築している場合、フラグは無視されます。詳細は、「plan add-table」および「plan evolve-table」を参照してください。

show topology [-zn] [-rn] [-sn] [-store] [-status] [-perf] 

現在のデプロイ済トポロジを表示します。デフォルトではトポロジ全体が表示されます。オプションのフラグにより、ゾーン、レプリケーション・ノード、ストレージ・ノードおよびストア名の表示を限定するか、あるいはサービス・ステータスまたはパフォーマンスを指定します。

このコマンドを使用すると、ストレージ・ノードをデプロイできるゾーンのIDを取得できます。

show upgrade-order 

アップグレードが必要なストレージ・ノードを、ストアの操作が中断しないような順序でリストします。

このコマンドでは、1つ以上のストレージ・ノードが1行に表示されます。1行に複数のストレージ・ノードが表示される場合、スペースで区切られます。1行に複数のストレージ・ノードが表示されている場合、そのノードをまとめて安全にアップグレードできます。複数のノードをまとめてアップグレードする場合、すべてのノードのアップグレードが完了してからでなければ、リストの次のノードはアップグレードできません。

ある時点で次にアップグレードするノードのグループがわからなくなった場合は、show upgrade-orderコマンドをいつでも再実行できます。

show users [-name <name>

すべてのユーザーの名前をリストするか、特定のユーザーに関する情報を表示します。ユーザーが指定されていない場合、すべてのユーザーの名前がリストされます。-nameオプションを使用して、ユーザーが指定されている場合、ユーザーに関する詳細情報がリストされます。

show zones [-zn <id>] | -znname <name> 

すべてのゾーンの名前をリストするか、特定のゾーンに関する情報を表示します。

-znまたは-znnameフラグを使用して、追加情報を表示するゾーンを指定します。追加情報には、指定されたゾーン内のすべてのストレージ・ノードの名前、およびそのゾーンがプライマリ・ゾーンかセカンダリ・ゾーンかを含みます。

snapshot create -name <name> 

指定された名前を接頭辞として使用して、新規スナップショットを作成します。

-nameオプションを使用すると、作成するスナップショットの名前を指定できます。

スナップショットは、構成の(トポロジ的な)変更が行われている間は作成しないでください。スナップショットに整合性がなく、使用できなくなる可能性があるためです。

snapshot remove -name <name> | -all 

指定されたスナップショットを削除します。-allが指定されている場合、すべてのスナップショットを削除します。

-nameオプションを使用すると、削除するスナップショットの名前を指定できます。

-allオプションが指定されている場合、すべてのスナップショットを削除します。

スナップショットを使用してストアのバックアップを作成するには、「スナップショットの作成」を参照してください。

以前に作成したスナップショットからストアをリカバリするには、ロード・ユーティリティを使用するか、またはスナップショットから直接リストアします。詳細は、「Loadプログラムの使用」または「スナップショットからの直接リストア」を参照してください。

topology change-repfactor -name <name>  -pool <pool name>
-zn <id> | -znname <name> -rf <replication factor> 

トポロジを変更して、指定されたゾーンのレプリケーション係数を新しい値に変更します。レプリケーション係数はこのとき減少しない可能性があります。

レプリケーション係数の変更の詳細は、「レプリケーション係数の増加」を参照してください。

topology clone -from <from topology> -name <to topology>

または

topology clone -current -name <to topology> 

トポロジ変更操作に使用される新規のトポロジ候補を作成するために、既存のトポロジをクローニングします。

topology create -name <candidate name> - pool <pool name>
-partitions <num> 

指定されたストレージ・プールを使用して、指定されたパーティション数の新規トポロジを作成します。

最初のトポロジ候補の作成の詳細は、「トポロジ候補の作成」を参照してください。

topology delete -name <name> 

トポロジを削除します。

topology list 

既存のトポロジを一覧表示します。

topology preview -name <name> [-start <from topology>]

起動トポロジから指定されたターゲット・トポロジに移行するために実行される操作について説明します。-startが指定されていない場合、現行トポロジが使用されます。このコマンドは、新規トポロジをデプロイする前に使用する必要があります。

topology rebalance -name <name> -pool <pool name>
[-zn <id> | -znname <name>]

均衡の取れたトポロジを作成するため、指定されたトポロジを変更します。オプションの-znフラグが使用されている場合、指定されたゾーンからのストレージ・ノードのみが操作に使用されます。

非コンプライアンス・トポロジの均衡化の詳細は、「非コンプライアンス・トポロジの均衡化」を参照してください。

topology redistribute -name <name> -pool <pool name> 

使用可能なリソースのより効率的な利用のためにリソースを再配布するため、指定されたトポロジを変更します。

書込みスループットを向上させるためのリソースの再配布の詳細は、「データ配布の増加」を参照してください。

topology validate [-name <name>] 

指定されたトポロジを検証します。トポロジが指定されていない場合、現行トポロジが検証されます。検証ではviolationsとnotesが生成されます。

violationsは問題を引き起こす可能性があり、調査が必要です。

notesは情報的で、問題になる可能性がある、または予測が可能であるという、構成上の目立つ差異を示します。

詳細は、「トポロジ候補の検証」を参照してください。

topology view -name <name> 

指定されたトポロジの詳細を表示します。

verify configuration [-silent] [-json] 

コンポーネントを反復してその状態を、管理データベースで予測されていたものに対してチェックすることで、ストア構成を検証します。このコールは、規模の大きいストアでは時間がかかる可能性があります。

-jsonオプションでは、出力をJSON形式で表示することを指定します。

-silentオプションは、検証の進行中に表示される冗長な検証メッセージを非表示にします。かわりに、最初の起動メッセージおよび最後の検証メッセージのみが表示されます。このオプションは、-jsonオプションが指定されている場合は効果を発揮しません。

verify prerequisite [-silent] [-sn snX]* 

ストレージ・ノードが、現行バージョンにアップグレードするために必要な前提条件となるソフトウェア・バージョン以上であることを確認します。このコールは、規模の大きいストアでは時間がかかる可能性があります。

検証プロセスの一部として、このコマンドは前提条件を満たしていない、またはアクセスできないコンポーネントを表示します。また、インストールされているソフトウェアが現行バージョンより新しいマイナー・リリースであるという無効なダウングレード状況にならないか確認します。

このコマンドを使用する場合、現行バージョンとはコマンドライン・インタフェースを実行しているソフトウェアのバージョンのことです。

検証するストレージ・ノードを指定するには、-snオプションを使用します。ストレージ・ノードが指定されていない場合は、ストア内のすべてのノードがチェックされます。

-silentオプションは、検証の進行中に表示される冗長な検証メッセージを非表示にします。かわりに、最初の起動メッセージおよび最後の検証メッセージのみが表示されます。

verify upgrade [-silent] [-sn snX]* 

ストレージ・ノード(およびその管理対象コンポーネント)が現行バージョン以上であることを確認します。このコールは、規模の大きいストアでは時間がかかる可能性があります。

検証プロセスの一部として、このコマンドはアップグレードされていない、またはアクセスできないコンポーネントを表示します。

このコマンドを使用する場合、現行バージョンとはコマンドライン・インタフェースを実行しているソフトウェアのバージョンのことです。

検証するストレージ・ノードを指定するには、-snオプションを使用します。ストレージ・ノードが指定されていない場合は、ストア内のすべてのノードがチェックされます。

-silentオプションは、検証の進行中に表示される冗長な検証メッセージを非表示にします。かわりに、最初の起動メッセージおよび最後の検証メッセージのみが表示されます。