開発のためのVisual Studio Code Extensionの使用

Oracle NoSQL Database Cloud Serviceは、Microsoft Visual Studio Codeの拡張機能を提供しており、Oracle NoSQL Database Cloud Serviceの実行中のインスタンスに接続できます。

Oracle NoSQL Database Visual Studio (VS) Code拡張機能を使用して、次のことができます。

この記事には次のトピックが含まれます:

Oracle NoSQL Database Visual Studio Code拡張機能のインストール

Oracle NoSQL Database VS Code拡張機能は、Visual Studio Marketplaceからインストールしてオンライン・インストールできます。

Oracle NoSQL Database Visual Studio (VS) Code拡張機能をインストールする前に、Visual Studio Codeをインストールする必要があります。Visual Studio Codeはここからダウンロードできます。

インストールの場合:

  1. Visual Studio Codeで、左側のナビゲーションの「Extensions」アイコンをクリックします。

    Visual Studioコード・アクティビティ・バー

    または、次を押して「Extensions」ビューを開くこともできます。

    • (WindowsおよびLinux) [Control] + [Shift] + [X]

    • (macOS) [Command] + [Shift] + [X]。

  2. 拡張機能マーケットプレイスでOracle NoSQL Database Connectorを検索します。

  3. Oracle NoSQL Database Connector拡張機能で「Install」をクリックします

Visual Studio CodeからのOracle NoSQL Database Cloud ServiceまたはOracle NoSQL Database Cloud Simulatorへの接続

Oracle NoSQL Database Visual Studio (VS) Code拡張機能には、Oracle NoSQL Database Cloud ServiceまたはOracle NoSQL Database Cloud Simulatorに接続するための2つの方法が提供されています。

接続情報を含む構成ファイルを提供するか、特定のフィールドに接続情報を入力できます。Node.jsドライバなどのドライバを使用していて、接続詳細がすでにファイルに保存されている場合や作成する場合は、「Use Configuration File」オプションを使用してOracle NoSQL Database Cloud Serviceに接続します。それ以外の場合は、新しい接続を作成する場合は、「詳細」オプションを使用します。

  1. Visual Studio Codeで、「Activity Bar」の「Oracle NoSQL DB」ビューをクリックします。

    Visual Studioコード・アクティビティ・バー

  2. 「Command Palette」または「Activity Bar」の「Oracle NoSQL DB」ビューから、Oracle NoSQL DBの「Show Connection Settings」ページを開きます。

    • 「Command Palette」から開く

      1. 次を押して「Command Palette」を開きます。

        • (WindowsおよびLinux) [Control] + [Shift] + [P]

        • (macOS)コマンド+ Shift + P

      2. 「Command Palette」で、「OracleNoSQL: Show Connections Settings」を選択します。

        ヒント:

        「Command Palette」にoraclenosqlを入力して、使用できるすべてのOracle NoSQL DBコマンドを表示します。

- Open from Oracle NoSQL DB View
  1. Expand the **TABLE EXPLORER** pane in the left navigation if it's collapsed.

  2. Click **Add Connection** to open the Oracle NoSQL DB **Show Connection Settings** page.

  1. 「接続設定の表示」ページで、「クラウド」または「CloudSim」をクリックして、Oracle NoSQL Database Cloud ServiceまたはOracle NoSQL Database Cloud Simulatorに接続します。

  2. 「新規接続の追加」をクリックし、接続情報を入力します。「追加」をクリックします。

    表- クラウド接続パラメータ

    フィールド 説明 サンプル値
    接続名: プラグイン・バージョン4.0.0では、接続仕様の一意の名前が必須です。バージョン3.0.0以下からプラグインをアップグレードした後に、「Connection Name」フィールドの更新をお薦めします。

    ノート:複数の接続を追加でき、格納されている接続仕様は永続的です。    		  
    地域/エンドポイント: Oracle NoSQL Database Cloud Serviceにアクセスするためのリージョン識別子またはサービス・エンドポイント。リージョン識別子およびサービス・エンド・ポイントのリストは、データ・リージョンおよび関連するサービスURLを参照してください。 us-ashburn-1またはhttps://nosql.us-ashburn-1.oci.oraclecloud.com (北米地域にあるアッシュバーンのOracle NoSQL Database Cloud Serviceリージョン識別子の場合)。
    テナントOCID: Oracle NoSQL Database Cloud ServiceのテナンシのOCID。Oracle Cloud InfrastructureドキュメントのテナンシのOCIDとユーザーのOCIDの取得場所を参照してください。 ocid1.tenancy.oc1..<unique_ID>
    ユーザーOCID: Oracle NoSQL Database Cloud ServiceのユーザーのOCID。Oracle Cloud InfrastructureドキュメントのテナンシのOCIDとユーザーのOCIDの取得場所を参照してください。 ocid1.user.oc1..<unique_ID>
    フィンガープリント: このユーザーに追加された秘密キーのフィンガープリント。<p>署名キーのフィンガープリントは、API署名キーの生成およびアップロード中に作成されます。Oracle Cloud Infrastructureドキュメンテーションのキーのフィンガープリントを取得する方法を参照してください。 12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef
    秘密キー・ファイル: 秘密キーが格納されている場所を参照します。オプションのパスフレーズを使用して署名キーを生成するには、API署名キーの生成方法を参照してください。 /home/user/.oci/oci_api_key.pem
    パス・フレーズ: 秘密キーの作成時に指定したパスフレーズ。署名キーのパスフレーズは、API署名キーの生成およびアップロード中に作成されます。Oracle Cloud Infrastructureドキュメンテーションのキーのフィンガープリントを取得する方法を参照してください。
    必須。キーが暗号化されている場合のみ。    		  
    コンパートメント: Oracle NoSQL Database Cloud Serviceスキーマのコンパートメントの名前またはOCID。

    値を指定しない場合は、デフォルトでrootコンパートメントに設定されます。

    コンパートメントは、Oracle Cloud Infrastructure Identity and Access Management (IAM)で作成します。テナンシの設定およびOracle Cloud Infrastructureドキュメンテーションのコンパートメントの管理を参照してください。

    		- コンパートメント名: mycompartment

    - 親コンパートメントで修飾されたコンパートメント名: parent.childcompartment

    - コンパートメントOCID: ocid1.tenancy.oc1...<unique_ID>

    表- CloudSim接続パラメータ

    フィールド 説明 サンプル値
    接続名: プラグイン・バージョン4.0.0では、接続仕様の一意の名前が必須です。バージョン3.0.0以下からプラグインをアップグレードした後に、「Connection Name」フィールドの更新をお薦めします。

    ノート:複数の接続を追加でき、格納されている接続仕様は永続的です。    		  
    エンド・ポイント: Oracle NoSQL Database Cloud Simulatorインスタンスのサービス・エンドポイントURL。 http://myinstance.cloudsim.com:8080

    この値を使用しない場合は、デフォルトでhttp://localhost:8080に設定されます。
    テナント識別子: テナントを識別する一意の識別子。 Tenant01

    この値を使用しない場合は、デフォルトでTestTenantに設定されます。

    ノート:バージョン4.0.0以降、接続処理が変更されました。古いバージョンのプラグインを使用している場合、アップグレード・プロセス中に最新に使用された接続のみがバージョン4.0.0に移行されます。プラグインにより、移行された接続に名前cloud_old0が自動的に割り当てられます。接続名は、「接続設定」ページの「接続の変更」オプションを使用して変更できます。

  3. 接続の詳細が保存されます。既存の接続を変更するには、「接続」ドロップダウンから接続を選択します。「接続の変更」をクリックします。「接続パラメータ」で必要な変更を行い、「保存」をクリックします。

  4. 「TABLE EXPLORER」の「Web」アイコンをクリックすると、プラグインに存在するすべての接続(オンプレミスおよびクラウド)のリストが表示されます。接続は、Connection Name:Endpoint: Compartment (指定されている場合)という形式でドロップダウンに表示されます。

    リストから接続を選択し、「接続」を選択します。Visual Studio Codeプラグインは、Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulatorに接続し、そのすべての表を「表エクスプローラ」ウィンドウに表示します。

  1. 構成ファイルがない場合は、config.jsonやJSONオブジェクトを含むファイルなどを作成します。Oracle NoSQL Database Cloud ServiceまたはOracle NoSQL Database Cloud Simulatorに接続するための構成ファイル・フォーマットは次のとおりです。

    表- 構成テンプレート

    Oracle NoSQL Database Cloud Service Oracle NoSQL Database Cloud Simulator
    OCI構成ファイルを使用して接続するための構成テンプレート
    { "region": "", "compartment": "", "auth": { "iam": { "configFile": "",  "profileName": "" } } }
    IAM認証資格証明を使用して接続するための構成テンプレート
    { "region": "", "compartment": "", "auth": { "iam": { "tenantId": "", "userId": "", "fingerprint": "", "privateKeyFile": "", "passphrase": "" } } }
    		 
    { "endpoint": "http://myinstance.cloudsim.com:8080", "auth" : "Bearer" }

  2. 「Command Palette」または「Activity Bar」の「Oracle NoSQL DB」ビューから、Oracle NoSQL DB接続設定の表示ページを開きます。

    • 「Oracle NoSQL DB」ビューから開く

      • 左側のナビゲーションにある「Table Explorer」ペインが折りたたまれている場合は、これを展開します。

      • 「Add Connection」をクリックして、Oracle NoSQL DBの「Show Connection Settings」ページを開きます。

      • 「Show Connection Settings」ページで、「Cloud」をクリックしてOracle NoSQL Databaseに接続します。

      • 接続情報を入力し、「追加」をクリックします。

        表- クラウド接続パラメータ

        フィールド 説明 サンプル・ビュー
        接続名: プラグイン・バージョン4.0.0では、接続仕様の一意の名前が必須です。バージョン3.0.0以下からプラグインをアップグレードした後に、「Connection Name」フィールドの更新をお薦めします。

        ノート:複数の接続を追加でき、格納されている接続仕様は永続的です。        		  
        地域/エンドポイント: Oracle NoSQL Database Cloud Serviceにアクセスするためのリージョン識別子またはサービス・エンドポイント。リージョン識別子およびサービス・エンド・ポイントのリストは、データ・リージョンおよび関連するサービスURLを参照してください。 us-ashburn-1またはhttps://nosql.us-ashburn-1.oci.oraclecloud.com (北米地域にあるアッシュバーンのOracle NoSQL Database Cloud Serviceリージョン識別子の場合)。
        構成ファイル: OCI構成ファイルが格納されている場所を参照します。 /home/user/security/config/oci.config
        プロファイル: Oracle NoSQL Database Cloud Serviceへの接続に使用される構成プロファイルの名前。この値を指定しない場合は、デフォルトでDEFAULTプロファイルに設定されます。 ADMIN_USER
        コンパートメント: Oracle NoSQL Database Cloud Serviceスキーマのコンパートメントの名前またはOCID。

        値を指定しない場合は、デフォルトでrootコンパートメントに設定されます。

        コンパートメントは、Oracle Cloud Infrastructure Identity and Access Management (IAM)で作成します。テナンシの設定およびOracle Cloud Infrastructureドキュメントのコンパートメントの管理を参照してください。

        • コンパートメント名

          mycompartment

        • 親コンパートメントで修飾されたコンパートメント名

          parent.childcompartment

        • コンパートメントのOCID

          ocid1.tenancy.oc1...

ノート:バージョン4.0.0以降、接続処理が変更されました。古いバージョンのプラグインを使用している場合、アップグレード・プロセス中に最新に使用された接続のみがバージョン4.0.0に移行されます。プラグインにより、移行された接続に名前cloud_old0が自動的に割り当てられます。接続名は、「接続設定」ページの「接続の変更」オプションを使用して変更できます。

  • 「Command Palette」から開く:

    • 次を押して「Command Palette」を開きます。

      • (WindowsおよびLinux) [Control] + [Shift] + [P]

      • (macOS)コマンド+ Shift + P

    • 「Command Palette」で、「Oracle NoSQL: Connect via Config File」を選択します。

      ノート:「Command Palette」にoraclenosqlを入力して、使用できるすべてのOracle NoSQL DBコマンドを表示します。

    • *.configファイルが格納されている場所を参照し、「Select」をクリックします。

  1. 接続の詳細が保存されます。既存の接続を変更するには、「接続」ドロップダウンから接続を選択します。「接続の変更」をクリックします。「接続パラメータ」で必要な変更を行い、「保存」をクリックします。

  2. 「TABLE EXPLORER」の「Web」アイコンをクリックすると、プラグインに存在するすべての接続(オンプレミスおよびクラウド)のリストが表示されます。接続は、Connection Name:Endpoint: Compartment (指定されている場合)という形式でドロップダウンに表示されます。

    リストから接続を選択し、「接続」を選択します。Visual Studio Codeプラグインは、Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulatorに接続し、そのすべての表を「表エクスプローラ」ウィンドウに表示します。

Visual Studio CodeからのOracle NoSQL Java SDKを使用したアプリケーションの作成

Oracle NoSQL Java SDKパッケージを使用してVisual Studio Code拡張機能からアプリケーションを作成する方法について学習します。

Oracle NoSQL Database Cloud SimulatorまたはOracle NoSQL Database Cloud Serviceに接続したら、Oracle NoSQL Java SDKを使用してアプリケーションを作成できます。

次のステップを実行します:

Mavenプロジェクトの設定

  1. Visual Studio Codeを開きます。

  2. Java Extension Packをインストールします。

    1. 左側のサイドバーの「拡張機能」アイコンをクリックして、「拡張機能」ビューを開きます。

    2. Extensions MarketplaceでJava Extension Packを検索します。

    3. Java Extension Packをインストールするには、「インストール」ボタンをクリックします

  3. 「表示」タブで、「コマンド・パレット」を選択し、[Ctrl]+[Shift]+[P]を押します。

  4. Java: New Projectを検索します。

  5. Mavenとしてプロジェクト・テンプレートを選択します。

  6. 次のプロジェクトの詳細を入力します。

    • プロジェクトの名前。

    • プロジェクトの場所(デフォルトは現在のワークスペース・フォルダ)。

    • パッケージ名(たとえば、com.example.myproject)。

  7. 環境変数にJavaパスを設定します。

  8. Visual Studio Codeは、プロジェクトのディレクトリ構造とファイルを作成します。

  9. プロジェクト・ディレクトリからpom.xmlファイルを開き、次のようにOracle NoSQL Java SDK依存性を追加します。最新バージョンを使用します。Oracle NoSQL Java SDKを参照してください。

    <dependency>
<groupId>com.oracle.nosql</groupId>
<artifactId>nosqldb-driver</artifactId>
<version>5.4.22</version>
</dependency>

サンプル・アプリケーション・プログラムの作成および実行

  1. 次のようにサンプル・アプリケーション・コードを作成します。<your_region_identifier>のリージョンおよび<ocid_of_your_compartment>プレースホルダのコンパートメントOCIDを更新します。

    ノート:このアプリケーションは、OCI構成ファイルから認証詳細を取得します。構成ファイルとその内容の詳細は、Oracle NoSQL Databaseに接続するための認証を参照してください。

    package org.oracle.nosqljavasdk;

import oracle.nosql.driver.NoSQLHandle;
import oracle.nosql.driver.NoSQLHandleConfig;
import oracle.nosql.driver.NoSQLHandleFactory;
import oracle.nosql.driver.iam.SignatureProvider;
import oracle.nosql.driver.ops.GetRequest;
import oracle.nosql.driver.ops.GetResult;
import oracle.nosql.driver.ops.PutRequest;
import oracle.nosql.driver.ops.PutResult;
import oracle.nosql.driver.ops.TableLimits;
import oracle.nosql.driver.ops.TableRequest;
import oracle.nosql.driver.ops.TableResult;
import oracle.nosql.driver.values.MapValue;

public class JavaVSCodeCloud {
    /* Name of your table */
    final static String tableName = "TestSDK";
    static NoSQLHandle handle;
    /* replace the placeholder with the name of your region for example Region.US_ASHBURN_1*/
    /* String region ="<your_region_identifier>";  */

    public static void main(String[] args) throws Exception {
      String region ="<your_region_identifier>";
      String compId ="<ocid_of_your_compartment>";
      handle = generateNoSQLHandleCloud(region,compId);
        try {
            createTable(handle);
            writeRows(handle);
            readRows(handle);
                          /* Uncomment this if you want to drop the table */
            //dropTable(handle);
        } catch (Exception e) {
            System.err.print(e);
        } finally {
            handle.close();
        }
    }

   /* Create a NoSQL handle to access the cloud service */
   private static NoSQLHandle generateNoSQLHandleCloud(String region, String compId) throws Exception {
      SignatureProvider ap = new SignatureProvider();
      NoSQLHandleConfig config = new NoSQLHandleConfig(region, ap);
      /* set your default compartment */
      config.setDefaultCompartment(compId);
      NoSQLHandle handle = NoSQLHandleFactory.createNoSQLHandle(config);
      return handle;
   }

    /**
     * Create a simple table with an integer key
     * and a single string data field
     * and set your desired table capacity
     */
    private static void createTable(NoSQLHandle handle) throws Exception {
        String createTableDDL = "CREATE TABLE IF NOT EXISTS " +
            tableName + "(employeeid INTEGER, name STRING, " +
            "PRIMARY KEY(employeeid))";

        TableLimits limits = new TableLimits(1, 2, 1);
        TableRequest treq = new TableRequest()
            .setStatement(createTableDDL).setTableLimits(limits);

        System.out.println("Creating table " + tableName);
        TableResult tres = handle.tableRequest(treq);

        /* The request is async,
         * so wait for the table to become active.
        */
        System.out.println("Waiting for "

            + tableName + " to become active");
        tres.waitForCompletion(handle, 60000, /* wait 60 sec */
            1000); /* delay ms for poll */
        System.out.println("Table " + tableName + " is active");
    }

    /**
     * Construct a row and add it to the table
     */
    private static void writeRows(NoSQLHandle handle) throws Exception {
        MapValue value =
            new MapValue().put("employeeid", 1).put("name", "Tracy");
        PutRequest putRequest =
            new PutRequest().setValue(value).setTableName(tableName);
        PutResult putResult = handle.put(putRequest);
        if (putResult.getVersion() != null) {
            System.out.println("Wrote " + value);
        } else {
            System.out.println("Put failed");
        }
    }

    /**
     * Set a key and read the row from the table
     */
    private static void readRows(NoSQLHandle handle) throws Exception {
        MapValue key = new MapValue().put("employeeid", 1);
        GetRequest getRequest =
            new GetRequest().setKey(key).setTableName(tableName);
        GetResult getRes = handle.get(getRequest);
        System.out.println("Read " + getRes.getValue());
    }

    /**
     * Drop the table and wait for the table to move to dropped state
     */
    private static void dropTable(NoSQLHandle handle) throws Exception {
        System.out.println("Dropping table " + tableName);
        TableRequest treq = new TableRequest()
            .setStatement("DROP TABLE IF EXISTS " + tableName);
        TableResult tres = handle.tableRequest(treq);
        System.out.println("Waiting for " + tableName + " to be dropped");
        tres.waitForCompletion(handle, 60000, /* wait 60 sec */
            1000); /* delay ms for poll */
        System.out.println("Table " + tableName + " has been dropped");
    }
}

  2. Javaプログラムを実行します。[F5]を押すか、「実行」メニューから目的のオプションを選択できます。

    ノート:ネットワーク・プロキシがある場合は、mavenディレクトリにあるsettings.xmlファイルにそれらを含めます。

  3. Visual Studio Codeターミナルで出力を表示できます。

前述のアプリケーション・コードでは、表TestSDKが作成され、表に行が追加され、表から行が読み取られます。

サンプル出力:

----------------< com.oracle.nosql.example:NoSQLOperation >-----------------
Building NoSQLOperation 1.0-SNAPSHOT
  from pom.xml
--------------------------------[ jar ]---------------------------------

--- resources:3.3.1:resources (default-resources) @ NoSQLOperation ---
Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!
skip non existing resourceDirectory C:\Users\ramya\javaVSCode\src\main\resources

--- compiler:3.8.0:compile (default-compile) @ HelloWorld ---
Changes detected - recompiling the module!
File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!
Compiling 1 source file to C:\Users\ramya\javaVSCode\target\classes

--- exec:3.1.0:exec (default-cli) @ NoSQLOperation ---
Creating table TestSDK
Waiting for TestSDK to become active
Table TestSDK is active
Wrote {"name":"Tracy","employeeid":1}
Read {"employeeid":1,"name":"Tracy"}
------------------------------------------------------------------------
BUILD SUCCESS
------------------------------------------------------------------------
Total time:  8.013 s
Finished at: 2025-11-24T17:01:24+05:30
------------------------------------------------------------------------

Visual Studio Codeの表エクスプローラから表を表示することもできます。詳細は、Visual Studio Code拡張機能を使用した表の管理を参照してください。

Visual Studio Code拡張機能を使用した表の管理

Oracle NoSQL Database Visual Studio (VS) Code拡張機能を使用してデプロイメントに接続したら、左側のナビゲーションにある「TABLE EXPLORER」を使用して次を行います。

また、次のこともできます:

表、列、索引およびキーの確認

アクティブな接続を展開すると、Oracle NoSQL Database VS Codeにそのデプロイメントの表が示されます。

Visual Studio Codeを使用したDDL操作の実行

Visual Studio Codeを使用してDDL操作を実行できます。

Visual Studio Codeプラグイン内から実行できるDDL操作の一部を次に示します。

CREATE TABLE

Oracle NoSQL Database表は、次の2つのモードで作成できます。

  1. 新しい表を追加するOracle NoSQL Database接続の上にマウス・ポインタを置します。

  2. 表示されるプラス・アイコンをクリックするか、データベース接続名を右クリックして「Create Table」をクリックします。

    表エクスプローラ

  3. Create Tableページで、「Simple DDL Input」を選択します。

    表- Oracle NoSQL Database表を作成します

    フィールド 説明
    表名: 一意の表名を指定します。
    列名 表の主キーの列名を指定します。
    列のタイプ 主キー列のデータ型を選択します。
    シャード・鍵として設定 この主キー列をシャード・キーとして設定するには、このオプションを選択します。シャード・キーとは、効率を高めるためにOracle NoSQL Databaseクラスタ全体にデータを分散し、参照およびアクセスが容易になるようにシャード・キーがローカルに共有するレコードを配置するためのものです。シャード・キーを共有するレコードは同じ物理的ロケーションに格納され、アトミックかつ効率的にアクセスできます。
    除去 既存の列を削除するには、このボタンをクリックします。
    +主キー列の追加 複合(複数列)主キーの作成中に列を追加するには、このボタンをクリックします。
    列名 列名を指定します。
    列のタイプ 列のデータ・タイプを選択します。
    デフォルト値 (オプション)列のデフォルト値を指定します。

    ノート:バイナリおよびJSONデータ型の列には、デフォルト値を指定できません。
    NULL以外 列が常に値を持つように指定するには、このオプションを選択します。
    除去 既存の列を削除するには、このボタンをクリックします。
    +列の追加 列を追加するには、このボタンをクリックします。
    単位 表の行のTTL値に使用する単位(「Days」または「Hours」)を選択します。
    値 表の行の有効期間を指定します。日数または時間数が過ぎると、行は自動的に期限切れになり、使用できなくなります。デフォルト値はゼロで、有効期限がないことを示します。

    ノート:「Time to Live」(TTL)を更新しても、表の既存データのTTL値は変更されません。新しいTTL値は、この値の変更後に表に追加された行と、オーバーライドする行の固有の値が指定されていない行にのみ適用されます。

  4. 「作成」をクリックします。

  5. 表の作成前および作成後にDDL文を表示するオプションがあります。

    • 表を作成する前に- 「表の作成」画面の「DDLの表示」をクリックして、「Simple DDL input」モードのフィールドに入力された値に基づいて形成されたDDL文を表示します。このDDL文は、「Create」をクリックすると実行されます。

    • 表の作成後- 既存の表を右クリックします。「View Table DDL」を選択します。

子テーブルを作成

子表を作成するには、目的の表を右クリックし、「Create Child Table」を選択します。既存のOracle NoSQL Database表に対して、次の2つのモードのいずれかで子表を作成できます。

子表の詳細は、Oracle NoSQL Database Cloud Serviceガイドの表階層を参照してください。

DROP TABLE

  1. ターゲット表を右クリックします。

  2. 「Drop Table」をクリックします。

  3. 「はい」をクリックして表を削除します。

CREATE INDEX

DROP INDEX

列の追加

列の削除

スキーマの凍結/凍結解除

シングルトン表をグローバル・アクティブ表にするには、最初にスキーマを凍結する必要があります。詳細は、表のスキーマの凍結を参照してください。

スキーマを凍結/凍結解除するには、次のステップに従います。

  1. 目的の表を右クリックし、「スキーマの凍結/凍結解除」をクリックします。

  2. ダイアログ・ボックスが表示され、「はい」をクリックしてアクションを確定します。

レプリカの管理

リージョナル表のレプリカを参照して、レプリカおよびシングルトン表をグローバル・アクティブ表に変換する方法を理解してください。

レプリカの追加

Visual Studio Codeプラグインを使用すると、異なるリージョンに表レプリカを追加できます。また、既存のグローバル・アクティブ表にレプリカを追加することもできます。

  1. 目的の表を右クリックし、「レプリカ」セクションで「レプリカの追加」を選択します。

  2. 「レプリカの追加」パネルから、「レプリケーション・リージョン」ドロップダウンからリージョンを選択します。

  3. 要件に応じて「Read Capacity」、「Write Capacity」、「Disk Storage」を入力します。

  4. 「レプリカの追加」をクリックします。

  5. レプリカが追加されたという通知を受信したら、「x」をクリックするか、「Ctrl+F4」を押してパネルを閉じます。

レプリカの削除

  1. 表レプリカを削除する目的の表を右クリックします。「レプリカ」セクションで、「レプリカの削除」を選択します。

  2. 「Drop Regional Replicas」パネルで、削除する「Replica Name」ドロップダウンからレプリカを選択します。多数のレプリカを同時に削除するには、「+追加」をクリックしてレプリカ名を選択します。

    ノート:レプリカを削除するには、レプリカ名の横にある「削除」をクリックします。

  3. 「レプリカの削除」をクリックします。

  4. レプリカが削除されたという通知を受信したら、「x」をクリックするか、「Ctrl+F4」を押してパネルを閉じます。

レプリカの表示

  1. 目的の表を右クリックし、そのレプリカを表示します。「レプリカ」セクションで、「レプリカの表示」を選択します。

  2. 「View Regional Replicas」パネルでは、リージョン・レプリカのリストとその書込み容量を表示できます。

  3. レプリカを表示した後、「x」をクリックするか、[Ctrl]+[F4]キーを押してパネルを閉じます。

予約済容量の編集

  1. 目的の表を右クリックし、「予約済容量の編集」をクリックします。

  2. 「予約済容量の編集」パネルで、「プロビジョニング済容量」または「オンデマンド容量」を更新できます。

    1. プロビジョニングされた容量: 要件に従って、読取り容量、書込み容量およびディスク・ストレージを編集できます。

    2. On Demand Capacity: ディスク・ストレージのみを変更できます。読み取り容量と書き込み容量は読み取り専用モードです。

  3. 予約容量が更新されたという通知を受信したら、「x」をクリックするか、「Ctrl+F4」を押してパネルを閉じます。

Visual Studio Codeを使用したDML操作の実行

Visual Studio Codeプラグインを使用して、表からデータの追加、既存データの変更およびデータの問合せを実行できます。

データの挿入

データの変更 - UPDATE ROW/DELETE ROW:

表に対するSQL問合せの実行

ノート:ドロップダウンには、処理中の表に関連するSQL文のみが表示されます。

接続の削除

Oracle NoSQL Database Connectorは、Visual Studio (VS) Codeから接続を削除する2つの方法を提供します。

次が可能です:

ノート:接続をプラグインから完全に削除するには、「接続」ドロップダウンから接続を選択します。「接続の削除」をクリックします。プラグインを削除する確認を受け取り、「はい」をクリックしてプラグインから接続を削除します。Visual Studio Codeから接続を削除すると、現在のワークスペースから永続接続の詳細が削除されます。

  1. 左側のナビゲーションにある「TABLE EXPLORER」ペインが折りたたまれている場合は、これを展開します。

  2. 削除する接続を右クリックし、「Remove Connection」をクリックします。

  1. 次を押して「Command Palette」を開きます。

    • (WindowsおよびLinux) [Control] + [Shift] + [P]

    • (macOS)コマンド+ Shift + P

  2. 「Command Palette」で、「OracleNoSQL: Remove Connection」を選択します。

    ノート:「Command Palette」にoraclenosqlを入力して、使用できるすべてのOracle NoSQL DBコマンドを表示します。

Visual Studio Codeの認可要件

Visual Studio Codeを使用するためにOracle NoSQL Database Cloud Serviceで必要な認可要件について学習します。

Visual Studio Code拡張機能を使用すると、APIキー認証方法を使用してOracle NoSQL database Cloud Serviceにアクセスできます。表、表領域、APIなどのOracle NoSQL Database Cloud Serviceのリソースへのアクセスは、Identity and Access Management (IAM)ポリシーによって管理されます。これにより、特定のコンパートメント内の表権限を適切に検査、読取り、使用または管理するグループのメンバーである認証済ユーザーのみが、これらのリソースと対話できるようになります。詳細は、NDCS表へのアクセスの管理を参照してください

Visual Studio Codeを使用してOracle NoSQL Database Cloud Service表の表を管理する場合、有効なIAM権限によって、読取りまたは書込みが可能なリソースが決まります。ユーザーが認可されていないアクションを試みると、Visual Studio Codeは、OCI IAMで指定された対応する認可エラーを返します。

たとえば、ユーザー・グループにNoSQL表の読取り権限のみがある場合、OCI IAMはOracle NoSQL Database Cloud Service表に対する挿入操作を拒否します。Visual Studio Code拡張機能には、次のエラー・メッセージが表示されます。

Error Inserting the row : NoSQLError: [INSUFFICIENT_PERMISSION] Authorization failed or requested resource not found