オンプレミスのOracle NoSQL DatabaseからOracle NoSQL Database Cloud Serviceへの移行

この例では、Oracle NoSQL Database Migratorを使用して、Oracle NoSQL DatabaseからOracle NoSQL Database Cloud Service (NDCS)にNoSQL表のデータおよびスキーマ定義をコピーする方法を示します。

ユースケース

開発者は、既存のNoSQL Database KVStoreワークロードのリソース、クラスタおよびガベージ・コレクションの管理のオーバーヘッドを回避するためのオプションを調べています。解決策として、NDCSによって既存のオンプレミスKVStoreワークロードが自動的に管理されるため、これらをOracle NoSQL Database Cloud Serviceに移行することにします。

デモでは、myTableというNoSQL表のデータおよびスキーマ定義をNoSQL Database KVStoreからNDCSに移行する方法について説明します。また、このユースケースを使用して、事前作成済の構成JSONファイルを渡してrunMigratorユーティリティを実行する方法も示します。
前提条件
  • 移行するソースとシンクを指定します。
    • ソース: Oracle NoSQL Database
    • シンク: Oracle NoSQL Database Cloud Service
  • OCIクラウド資格証明を指定し、OCI構成ファイルで取得します。構成ファイルを/home/.oci/configに保存します。Oracle NoSQL Database Cloud Serviceの使用資格証明の取得を参照してください。
    [DEFAULT]
    tenancy=ocid1.tenancy.oc1....
    user=ocid1.user.oc1....
    fingerprint= 43:d1:....
    key_file=</fully/qualified/path/to/the/private/key/>
    pass_phrase=<passphrase>
  • Oracle NoSQL Database Cloud Serviceのリージョン・エンドポイントおよびコンパートメント名を指定します。
    • endpoint: us-phoenix-1
    • compartment: developers
  • オンプレミスKVStoreの次の詳細を指定します。
    • storeName: kvstore
    • helperHosts: <hostname>:5000
    • table: myTable
手順
myTableのデータおよびスキーマ定義をNoSQL Database KVStoreからNDCSに移行するには:
  1. 識別されたソースおよびシンクの詳細を含む構成JSONファイルを準備します。ソース構成テンプレートおよびシンク構成テンプレートを参照してください。
    {
      "source" : {
        "type" : "nosqldb",
        "storeName" : "kvstore",
        "helperHosts" : ["<hostname>:5000"],
        "table" : "myTable",
        "requestTimeoutMs" : 5000
      },
      "sink" : {
        "type" : "nosqldb_cloud",
        "endpoint" : "us-phoenix-1",
        "table" : "myTable",
        "compartment" : "developers",
        "schemaInfo" : {
          "schemaPath" : "<complete/path/to/the/JSON/file/with/DDL/commands/for/the/schema/definition>",
          "readUnits" : 100,
          "writeUnits" : 100,
          "storageSize" : 1
        },
        "credentials" : "<complete/path/to/oci/config/file>",
        "credentialsProfile" : "DEFAULT",
        "writeUnitsPercent" : 90,
        "requestTimeoutMs" : 5000
      },
      "abortOnError" : true,
      "migratorVersion" : "1.0.0"
    }
  2. コマンド・プロンプトを開き、NoSQL Database Migratorユーティリティを抽出したディレクトリに移動します。
  3. --configまたは-cオプションを使用して構成JSONファイルを渡し、runMigratorコマンドを実行します。
    [~/nosqlMigrator/nosql-migrator-1.0.0]$./runMigrator --config <complete/path/to/the/JSON/config/file>
    
  4. 次に示すように、ユーティリティはデータの移行に進みます。
    Records provided by source=10, Records written to sink=10, Records failed=0.
    Elapsed time: 0min 10sec 426ms
    Migration completed.
検証

移行を検証するには、NDCSコンソールにログインし、ソース・データを使用してmyTableが作成されていることを確認します。