Visual Studio Code Extension für die Entwicklung verwenden

Oracle NoSQL Database Cloud Service bietet eine Erweiterung für Microsoft Visual Studio Code, mit der Sie eine Verbindung zu einer aktiven Instanz von Oracle NoSQL Database Cloud Service herstellen können.

Mit der Oracle NoSQL Database Visual Studio-(VS-)Codeerweiterung können Sie:

Dieser Artikel enthält die folgenden Themen:

Oracle NoSQL Database-Erweiterung für Visual Studio Code installieren

Sie können die Oracle NoSQL Database VS Code-Erweiterung über den Visual Studio Marketplace für die Onlineinstallation installieren.

Bevor Sie die Oracle NoSQL Database Visual Studio-(VS-)Code-Erweiterung installieren können, müssen Sie Visual Studio Code installieren. Sie können Visual Studio Code hier herunterladen.

Zur Installation:

  1. Klicken Sie in Visual Studio Code in der linken Navigationsleiste auf das Symbol Erweiterungen.

    Visual Studio-Codeaktivitätsleiste

    Alternativ können Sie die Ansicht Erweiterungen öffnen, indem Sie Folgendes drücken:

    • (Windows und Linux) Steuerung + Umschalt + X

    • (macOS) Befehl + Umschalt + X.

  2. Oracle NoSQL Database Connector im Erweiterungs-Marktplatz durchsuchen.

  3. Klicken Sie in der Oracle NoSQL Database Connector-Erweiterung auf "Install".

Verbindung zu Oracle NoSQL Database Cloud Service oder Oracle NoSQL Database Cloud-Simulator aus Visual Studio Code herstellen

Die Oracle NoSQL Database Visual Studio-(VS-)Codeerweiterung bietet zwei Methoden für die Verbindung mit Oracle NoSQL Database Cloud Service oder Oracle NoSQL Database Cloud-Simulator.

Sie können entweder eine Konfigurationsdatei mit den Verbindungsinformationen angeben oder die Verbindungsinformationen in die entsprechenden Felder eingeben. Wenn Sie einen Treiber verwenden, z.B. einen Node.js-Treiber und bereits Verbindungsdetails in einer Datei gespeichert haben oder erstellen möchten, verwenden Sie die Option "Konfigurationsdatei verwenden", um eine Verbindung zu Oracle NoSQL Database Cloud Service herzustellen. Wenn Sie eine neue Verbindung erstellen, verwenden Sie andernfalls die Option "Erweitert".

  1. Klicken Sie in Visual Studio Code in der Aktivitätsleiste auf die Ansicht Oracle NoSQL DB.

    Visual Studio-Codeaktivitätsleiste

  2. Öffnen Sie die Oracle NoSQL DB-Seite Verbindungseinstellungen anzeigen in der Befehlspalette oder in der Ansicht Oracle NoSQL DB in der Aktivitätsleiste.

    • Aus Befehlspalette öffnen

      1. Öffnen Sie die Befehlspalette durch Drücken von Strg+Umschalt:

        • (Windows und Linux) Steuerung + Umschalt + P

        • (macOS) Befehl + Umschalt + P

      2. Wählen Sie in der Befehlspalette OracleNoSQL: Verbindungseinstellungen anzeigen.

        Tipp:

        Geben Sie in der Befehlspalette oraclenosql ein, um alle Oracle NoSQL DB-Befehle anzuzeigen, die Sie verwenden können.

- 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. Klicken Sie auf der Seite Verbindungseinstellungen anzeigen auf Cloud oder CloudSim, um eine Verbindung zu Oracle NoSQL Database Cloud Service oder Oracle NoSQL Database Cloud-Simulator herzustellen.

  2. Klicken Sie auf Neue Verbindung hinzufügen, und geben Sie die Verbindungsinformationen an. Klicken Sie auf Hinzufügen.

    Tabelle - Cloud-Verbindungsparameter

    Feld Beschreibung Beispielwert
    Verbindungsname: Ein eindeutiger Name für die Verbindungsspezifikation ist ab Plug-in-Version 4.0.0 obligatorisch. Das Aktualisieren des Feldes "Verbindungsname" wird empfohlen, nachdem das Plug-in von Version 3.0.0 oder niedriger aktualisiert wurde.

    Hinweis: Sie können mehrere Verbindungen hinzufügen, und die gespeicherten Verbindungsspezifikationen sind persistent.    		  
    Region/Endpunkt: Eine Regions-ID oder ein Serviceendpunkt für den Zugriff auf Oracle NoSQL Database Cloud Service. Eine Liste der Regions-IDs und Serviceendpunkte finden Sie unter Datenregionen und zugehörige Service-URLs. us-ashburn-1 oder https://nosql.us-ashburn-1.oci.oraclecloud.com (für die Oracle NoSQL Database Cloud Service-Regions-ID für Ashburn in der Region Nordamerika).
    Mandanten-OCID: OCID des Mandanten für Oracle NoSQL Database Cloud Service. Siehe OCID und Benutzer-OCID des Mandanten abrufen in der Oracle Cloud Infrastructure-Dokumentation. ocid1.tenancy.oc1..<unique_ID>
    Benutzer-OCID: OCID des Benutzers für Oracle NoSQL Database Cloud Service. Siehe OCID und Benutzer-OCID des Mandanten abrufen in der Oracle Cloud Infrastructure-Dokumentation. ocid1.user.oc1..<unique_ID>
    Fingerprint: Fingerprint für den Private Key, der diesem Benutzer hinzugefügt wurde.<p>Der Fingerprint des Signaturschlüssels wird beim Generieren und Hochladen des API-Signaturschlüssels erstellt. Siehe So rufen Sie den Fingerprint des Schlüssels ab in der Oracle Cloud Infrastructure-Dokumentation. 12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef
    Private-Key-Datei: Navigieren Sie zu dem Speicherort, an dem der Private Key gespeichert ist. Weitere Informationen zum Generieren des Signaturschlüssels mit einer optionalen Passphrase finden Sie unter So generieren Sie einen API-Signaturschlüssel. /home/user/.oci/oci_api_key.pem
    Passphrase: Passphrase, die Sie beim Erstellen des Private Keys angegeben haben. Die Passphrase des Signaturschlüssels wird beim Generieren und Hochladen des API-Signaturschlüssels erstellt. Siehe So rufen Sie den Fingerprint des Schlüssels ab in der Oracle Cloud Infrastructure-Dokumentation.
    Erforderlich, nur, wenn der Schlüssel verschlüsselt ist.    		  
    Compartment: Der Name oder die OCID des Compartments für Ihr Oracle NoSQL Database Cloud Service-Schema.

    Wenn Sie keinen Wert angeben, wird standardmäßig das Compartment root verwendet.

    Sie erstellen Compartments in Oracle Cloud Infrastructure Identity and Access Management (IAM). Siehe Mandanten einrichten und Compartments verwalten in der Oracle Cloud Infrastructure-Dokumentation.

    		- Compartment-Name: mycompartment

    - Compartment-Name mit dem übergeordneten Compartment: parent.childcompartment

    - Compartment-OCID: ocid1.tenancy.oc1...<unique_ID>

    Tabelle - CloudSim-Verbindungsparameter

    Feld Beschreibung Beispielwert
    Verbindungsname: Ein eindeutiger Name für die Verbindungsspezifikation ist ab Plug-in-Version 4.0.0 obligatorisch. Das Aktualisieren des Feldes "Verbindungsname" wird empfohlen, nachdem das Plug-in von Version 3.0.0 oder niedriger aktualisiert wurde.

    Hinweis: Sie können mehrere Verbindungen hinzufügen, und die gespeicherten Verbindungsspezifikationen sind persistent.    		  
    Endpunkt: Serviceendpunkt-URL der Oracle NoSQL Database Cloud-Simulatorinstanz. http://myinstance.cloudsim.com:8080

    Wenn Sie den Wert nicht angeben, wird standardmäßig http://localhost:8080 verwendet.
    Mandanten-ID: Eindeutige ID zum Identifizieren des Mandanten. Tenant01

    Wenn Sie den Wert nicht angeben, wird standardmäßig TestTenant verwendet.

    Hinweis: Die Verbindungsverarbeitung wurde ab Version 4.0.0 geändert. Wenn Sie eine ältere Version des Plugins verwenden, wird nur die zuletzt verwendete Verbindung während des Upgradeprozesses auf Version 4.0.0 migriert. Das Plug-in weist der migrierten Verbindung automatisch den Namen cloud_old0 zu. Sie können den Verbindungsnamen mit der Option "Verbindung ändern" auf der Seite "Verbindungseinstellungen" ändern.

  3. Die Verbindungsdetails werden gespeichert. Um vorhandene Verbindungen zu ändern, wählen Sie die Verbindung in der Dropdown-Liste Verbindungen aus. Klicken Sie auf Modify Connection. Nehmen Sie die gewünschten Änderungen in den Verbindungsparametern vor, und klicken Sie auf Speichern.

  4. Klicken Sie in TABLE EXPLORER auf das Websymbol, um die Liste aller Verbindungen (On-Premise und Cloud) anzuzeigen, die im Plug-in vorhanden sind. Die Verbindungen werden in der Dropdown-Liste im folgenden Format angezeigt: Connection Name:Endpoint: Compartment (falls angegeben).

    Wählen Sie die Verbindung aus der Liste aus, und wählen Sie Verbinden aus. Das Visual Studio Code-Plug-in stellt eine Verbindung zu Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulator her und zeigt alle zugehörigen Tabellen im Tabellen-Explorer-Fenster an.

  1. Wenn Sie keine Konfigurationsdatei haben, erstellen Sie eine, z.B. config.json oder eine Datei mit dem JSON-Objekt. Das Konfigurationsdateiformat für die Verbindung zu Oracle NoSQL Database Cloud Service oder Oracle NoSQL Database Cloud-Simulator ist wie unten dargestellt.

    Tabelle - Konfigurationsvorlagen

    Oracle NoSQL Database Cloud Service Oracle NoSQL Database Cloud-Simulator
    Konfigurationsvorlage für die Verbindung mit der OCI-Konfigurationsdatei
    { "region": "", "compartment": "", "auth": { "iam": { "configFile": "",  "profileName": "" } } }
    Konfigurationsvorlage für die Verbindung mit IAM-Authentifizierungszugangsdaten
    { "region": "", "compartment": "", "auth": { "iam": { "tenantId": "", "userId": "", "fingerprint": "", "privateKeyFile": "", "passphrase": "" } } }
    		 
    { "endpoint": "http://myinstance.cloudsim.com:8080", "auth" : "Bearer" }

  2. Öffnen Sie die Seite {\b Oracle NoSQL DB Show Connection Settings} in der Command Palette oder in der View {\b Oracle NoSQL DB} in der Aktivitätsleiste.

    • Aus Oracle NoSQL DB-Ansicht öffnen

      • Blenden Sie den Tabellen-Explorer-Bereich in der linken Navigationsleiste ein, wenn er ausgeblendet ist.

      • Klicken Sie auf Verbindung hinzufügen, um die Seite "Oracle NoSQL DB-Verbindungseinstellungen anzeigen" zu öffnen.

      • Klicken Sie auf der Seite "Verbindungseinstellungen anzeigen" auf Cloud, um eine Verbindung zu Oracle NoSQL Database herzustellen.

      • Geben Sie die Verbindungsinformationen ein, und klicken Sie auf Hinzufügen.

        Tabelle - Cloud-Verbindungsparameter

        Feld Beschreibung Beispielwert
        Verbindungsname: Ein eindeutiger Name für die Verbindungsspezifikation ist ab Plug-in-Version 4.0.0 obligatorisch. Das Aktualisieren des Feldes "Verbindungsname" wird empfohlen, nachdem das Plug-in von Version 3.0.0 oder niedriger aktualisiert wurde.

        Hinweis: Sie können mehrere Verbindungen hinzufügen, und die gespeicherten Verbindungsspezifikationen sind persistent.        		  
        Region/Endpunkt: Eine Regions-ID oder ein Serviceendpunkt für den Zugriff auf Oracle NoSQL Database Cloud Service. Eine Liste der Regions-IDs und Serviceendpunkte finden Sie unter Datenregionen und zugehörige Service-URLs. us-ashburn-1 oder https://nosql.us-ashburn-1.oci.oraclecloud.com (für die Oracle NoSQL Database Cloud Service-Regions-ID für Ashburn in der Region Nordamerika).
        Konfigurationsdatei: Navigieren Sie zu dem Speicherort, in dem die OCI-Konfigurationsdatei gespeichert ist. /home/user/security/config/oci.config
        Profil: Name des Konfigurationsprofils, das für die Verbindung mit Oracle NoSQL Database Cloud Service verwendet werden soll. Wenn Sie diesen Wert nicht angeben, wird standardmäßig das Profil DEFAULT verwendet. ADMIN_BENUTZER
        Compartment: Der Name oder die OCID des Compartments für Ihr Oracle NoSQL Database Cloud Service-Schema.

        Wenn Sie keinen Wert angeben, wird standardmäßig das Compartment root verwendet.

        Sie erstellen Compartments in Oracle Cloud Infrastructure Identity and Access Management (IAM). Weitere Informationen finden Sie unter Mandanten einrichten und Compartments verwalten in der Oracle Cloud Infrastructure-Dokumentation.

        • Compartment-Name

          Meine Wohnung

        • Compartment-Name mit übergeordnetem Compartment angegeben

          parent.childcompartment

        • Compartment-OCID

          ocid1.tenancy.oc1...

Hinweis: Die Verbindungsverarbeitung wurde ab Version 4.0.0 geändert. Wenn Sie eine ältere Version des Plugins verwenden, wird nur die zuletzt verwendete Verbindung während des Upgradeprozesses auf Version 4.0.0 migriert. Das Plug-in weist der migrierten Verbindung automatisch den Namen cloud_old0 zu. Sie können den Verbindungsnamen mit der Option "Verbindung ändern" auf der Seite "Verbindungseinstellungen" ändern.

  • Aus Befehlspalette öffnen:

    • Öffnen Sie die Befehlspalette durch Drücken von Strg+Um

      • (Windows und Linux) Steuerung + Umschalt + P

      • (macOS) Befehl + Umschalt + P

    • Wählen Sie in der Befehlspalette die Option Oracle NoSQL: Über Konfigurationsdatei verbinden aus.

      Hinweis: Geben Sie in der Befehlspalette oraclenosql ein, um alle Oracle NoSQL DB-Befehle anzuzeigen, die Sie verwenden können.

    • Navigieren Sie zu dem Speicherort, in dem die Datei *.config gespeichert ist, und klicken Sie auf Auswählen.

  1. Die Verbindungsdetails werden gespeichert. Um vorhandene Verbindungen zu ändern, wählen Sie die Verbindung in der Dropdown-Liste Verbindungen aus. Klicken Sie auf Modify Connection. Nehmen Sie die gewünschten Änderungen in den Verbindungsparametern vor, und klicken Sie auf Speichern.

  2. Klicken Sie in TABLE EXPLORER auf das Websymbol, um die Liste aller Verbindungen (On-Premise und Cloud) anzuzeigen, die im Plug-in vorhanden sind. Die Verbindungen werden in der Dropdown-Liste im folgenden Format angezeigt: Connection Name:Endpoint: Compartment (falls angegeben).

    Wählen Sie die Verbindung aus der Liste aus, und wählen Sie Verbinden aus. Das Visual Studio Code-Plug-in stellt eine Verbindung zu Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulator her und zeigt alle zugehörigen Tabellen im Tabellen-Explorer-Fenster an.

Anwendungen mit dem Oracle NoSQL-Java-SDK aus Visual Studio Code erstellen

Hier erfahren Sie, wie Sie Anwendungen aus der Visual Studio Code-Erweiterung mit dem Oracle NoSQL Java SDK-Package erstellen.

Nachdem eine Verbindung zum Oracle NoSQL Database Cloud-Simulator oder zu Oracle NoSQL Database Cloud Service hergestellt wurde, können Sie Anwendungen mit dem Oracle NoSQL Java-SDK erstellen.

Führen Sie die folgenden Schritte durch:

Maven-Projekt einrichten

  1. Öffnen Sie Visual Studio Code.

  2. Installieren Sie das Java Extension Pack:

    1. Öffnen Sie die Ansicht "Erweiterungen", indem Sie auf das Symbol Erweiterungen in der linken Randleiste klicken.

    2. Suchen Sie im Extensions Marketplace nach Java Extension Pack.

    3. Klicken Sie auf die Schaltfläche Installieren, um das Java Extension Pack zu installieren

  3. Wählen Sie auf der Registerkarte Ansicht die Option Befehlspalette aus, und drücken Sie Strg+Umschalt+P.

  4. Suchen Sie nach Java: New Project.

  5. Wählen Sie die Projektvorlage als Maven aus.

  6. Geben Sie die Projektdetails ein:

    • Projektname.

    • Projektspeicherort (Standard ist der aktuelle Workspace-Ordner).

    • Packagename (Beispiel: com.example.myproject).

  7. Legen Sie den Java-Pfad in der Umgebungsvariablen fest.

  8. Visual Studio Code erstellt die Projektverzeichnisstruktur und -dateien.

  9. Öffnen Sie die Datei pom.xml aus dem Projektverzeichnis, und fügen Sie die Oracle NoSQL-Java-SDK-Abhängigkeit wie folgt hinzu. Verwenden Sie die neueste Version. Siehe Oracle NoSQL-Java-SDK.

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

Beispielanwendungsprogramm erstellen und ausführen

  1. Erstellen Sie wie folgt einen Beispielanwendungscode: Aktualisieren Sie die Region in <your_region_identifier> und die Compartment-OCID in den Platzhalter <ocid_of_your_compartment>.

    Hinweis: Diese Anwendung ruft Authentifizierungsdetails aus der OCI-Konfigurationsdatei ab. Weitere Informationen zur Konfigurationsdatei und ihrem Inhalt finden Sie unter Authentifizierung für die Verbindung zu 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-Programm ausführen Sie können F5 drücken oder die gewünschte Option im Menü Ausführen auswählen.

    Hinweis: Wenn Sie über Netzwerkproxys verfügen, nehmen Sie diese in die Datei settings.xml auf, die sich im maven-Verzeichnis befindet.

  3. Sie können die Ausgabe im Visual Studio Code-Terminal anzeigen.

Mit dem obigen Anwendungscode wird die Tabelle TestSDK erstellt, eine Zeile zur Tabelle hinzugefügt und die Zeile aus der Tabelle gelesen.

Beispielausgabe:

----------------< 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
------------------------------------------------------------------------

Sie können die Tabelle auch im Tabellen-Explorer von Visual Studio Code anzeigen. Weitere Informationen finden Sie unter Tabellen mit Visual Studio Code-Erweiterung verwalten.

Tabellen mit Visual Studio Code-Erweiterung verwalten

Nachdem Sie mit der Oracle NoSQL Database Visual Studio-(VS-)Codeerweiterung eine Verbindung zum Deployment hergestellt haben, verwenden Sie die TABLE EXPLORER in der linken Navigationsleiste, um:

Außerdem können Sie folgende Aktionen ausführen:

Tabellen, Spalten, Indizes und Schlüssel untersuchen

Wenn Sie eine aktive Verbindung erweitern, zeigt Oracle NoSQL Database VS Code die Tabellen in diesem Deployment an.

DDL-Vorgänge mit Visual Studio Code ausführen

Mit Visual Studio Code können Sie DDL-Vorgänge ausführen.

Einige der DDL-Vorgänge, die innerhalb des Visual Studio Code-Plug-ins ausgeführt werden können, sind:

CREATE TABLE

Sie können die Oracle NoSQL Database-Tabelle in zwei Modi erstellen:

  1. Zeigen Sie mit der Maus auf die Oracle NoSQL Database-Verbindung, um die neue Tabelle hinzuzufügen.

  2. Klicken Sie auf das angezeigte Plus-Symbol, oder klicken Sie mit der rechten Maustaste auf den Namen der Datenbankverbindung, und klicken Sie auf Tabelle erstellen.

    Tabellen-Explorer

  3. Wählen Sie auf der Seite Tabelle erstellen die Option Einfache DDL-Eingabe.

    Tabelle - Oracle NoSQL Database-Tabelle erstellen

    Feld Beschreibung
    Tabellenname: Geben Sie einen eindeutigen Tabellennamen an.
    Spaltenname Geben Sie einen Spaltennamen für den Primärschlüssel in Ihrer Tabelle an.
    Spaltentyp Wählen Sie den Datentyp für Ihre Primärschlüsselspalte.
    Als Shard-Key festlegen Wählen Sie diese Option aus, um diese Primärschlüsselspalte als Shad-Schlüssel festzulegen. Shard-Schlüssel verteilen Daten an Oracle NoSQL Database-Cluster zwecks effizienter Verteilung und Positionieren von Datensätzen, die den Shard-Schlüssel zur einfachen Referenz und schnellen Zugriff lokal nutzen. Datensätze mit einem gemeinsamen Shard-Schlüssel werden am selben physischen Speicherort gespeichert und können atomar und effizient aufgerufen werden.
    Entfernen Klicken Sie auf diese Schaltfläche, um eine vorhandene Spalte zu löschen.
    + Primärschlüsselspalte hinzufügen Klicken Sie auf diese Schaltfläche, um weitere Spalten hinzuzufügen, wenn Sie einen zusammengesetzten (mehrspaltigen) Primärschlüssel erstellen.
    Spaltenname Geben Sie den Spaltennamen ein.
    Spaltentyp Wählen Sie den Datentyp für Ihre Spalte.
    Standardwert (Optional) Geben Sie einen Standardwert für die Spalte ein.

    Hinweis: Für Spalten vom Datentyp "Binär" und "JSON" können keine Standardwerte angegeben werden.
    Ungleich null Wählen Sie diese Option aus, um anzugeben, dass eine Spalte immer einen Wert enthalten muss.
    Entfernen Klicken Sie auf diese Schaltfläche, um eine vorhandene Spalte zu löschen.
    + Spalte hinzufügen Klicken Sie auf diese Schaltfläche, um weitere Spalten hinzuzufügen.
    Einheit Wählen Sie die Einheit (Tage oder Stunden), die für den TTL-Wert für die Zeilen in der Tabelle verwendet werden soll.
    Wert Geben Sie die Ablaufdauer für die Zeilen in der Tabelle an. Nach der Anzahl der Tage oder Stunden laufen die Zeilen automatisch ab und sind nicht mehr verfügbar. Der Standardwert "Null" gibt an, dass keine Ablaufzeit vorhanden ist.

    Hinweis: Wenn Sie die Gültigkeitsdauer einer Tabelle (TTL) aktualisieren, wird der TTL-Wert von bestehenden Daten in der Tabelle nicht geändert. Der neue TTL-Wert gilt nur für die Zeilen, die der Tabelle hinzugefügt werden, nachdem dieser Wert geändert wurde, und für die Zeilen, für die kein überschreibender zeilenspezifischer Wert angegeben wurde.

  4. Klicken Sie auf Erstellen.

  5. Sie können die DDL-Anweisung vor und nach dem Erstellen einer Tabelle anzeigen.

    • Vor dem Erstellen der Tabelle: Klicken Sie im Fenster "Tabelle erstellen" auf DDL anzeigen, um die DDL-Anweisung anzuzeigen, die basierend auf den Werten gebildet wurde, die in die Felder im Modus Einfache DDL-Eingabe eingegeben wurden. Diese DDL-Anweisung wird ausgeführt, wenn Sie auf Erstellen klicken.

    • Nach dem Erstellen der Tabelle - Klicken Sie mit der rechten Maustaste auf die vorhandene Tabelle. Wählen Sie Tabellen-DDL anzeigen aus.

UNTERGEORDNETE TABELLEN ERSTELLEN

Um eine untergeordnete Tabelle zu erstellen, klicken Sie mit der rechten Maustaste auf die gewünschte Tabelle, und wählen Sie Untergeordnete Tabelle erstellen. Sie können eine untergeordnete Tabelle für eine bereits vorhandene Oracle NoSQL Database-Tabelle in einem der beiden folgenden Modi erstellen:

Weitere Informationen zu untergeordneten Tabellen finden Sie unter Tabellenhierarchien in der Oracle NoSQL Database Cloud Service-Dokumentation.

DROP TABLE

  1. Klicken Sie mit der rechten Maustaste auf die Zieltabelle.

  2. Klicken Sie auf Tabelle löschen.

  3. Klicken Sie auf Ja, um die Tabelle zu löschen.

CREATE INDEX

DROP INDEX

SPALTE HINZUFÜGEN

SPALTE LÖSCHEN

Schema einfrieren/sperren

Um eine Singleton-Tabelle zu einer Global Active-Tabelle zu machen, müssen Sie zuerst das Schema sperren. Weitere Informationen finden Sie unter Schema einer Tabelle fixieren.

Führen Sie die folgenden Schritte aus, um das Schema einzufrieren/zurückzusetzen:

  1. Klicken Sie mit der rechten Maustaste auf die gewünschte Tabelle, und klicken Sie auf Schema sperren/Fixierung aufheben.

  2. Ein Dialogfeld wird angezeigt. Klicken Sie auf Ja, um die Aktion zu bestätigen.

Replikate verwalten

Unter Regionale Tabellenreplikate erfahren Sie, was Replikate sind und wie Sie eine Singleton-Tabelle in eine Global Active-Tabelle konvertieren.

Replikate hinzufügen

Mit dem Visual Studio Code-Plugin können Sie ein Tabellenreplikat in verschiedenen Regionen hinzufügen. Außerdem können Sie Replikate zu einer vorhandenen Tabelle "Global Active" hinzufügen.

  1. Klicken Sie mit der rechten Maustaste auf die gewünschte Tabelle. Wählen Sie im Abschnitt Replikate die Option Replikate hinzufügen aus.

  2. Wählen Sie im Bereich "Replikat hinzufügen" in der Dropdown-Liste Replikationsregion eine Region aus.

  3. Geben Sie je nach Ihren Anforderungen Lesekapazität, Schreibkapazität und Datenträgerspeicher ein.

  4. Klicken Sie auf Replikat hinzufügen.

  5. Wenn Sie eine Benachrichtigung erhalten, dass Replikationen hinzugefügt wurden, schließen Sie den Bereich, indem Sie auf x klicken oder Strg+F4 drücken.

Replikate löschen

  1. Klicken Sie mit der rechten Maustaste auf die gewünschte Tabelle, deren Tabellenreplikat Sie löschen möchten. Wählen Sie in den Abschnitten Replikate die Option Replikate löschen aus.

  2. Wählen Sie im Bereich "Regionale Dropdown-Replikate" das Replikat aus der Dropdown-Liste Replikatname aus, die Sie löschen möchten. Um viele Replikate gleichzeitig zu löschen, klicken Sie auf +Hinzufügen, und wählen Sie den Replikatnamen aus.

    Hinweis: Um ein Replikat zu entfernen, das Sie nicht löschen möchten, klicken Sie einfach neben dem Replikatnamen auf Entfernen.

  3. Klicken Sie auf Replikate löschen.

  4. Wenn Sie eine Benachrichtigung erhalten, dass Replikate gelöscht wurden, schließen Sie den Bereich, indem Sie auf x klicken oder Strg+F4 drücken.

Replikate anzeigen

  1. Klicken Sie mit der rechten Maustaste auf die gewünschte Tabelle, um deren Replikate anzuzeigen. Wählen Sie im Abschnitt Replikate die Option Replikate anzeigen aus.

  2. Im Bereich "Regionale Replikate anzeigen" können Sie eine Liste der regionalen Replikate mit ihrer Schreibkapazität anzeigen.

  3. Nachdem Sie die Replikate angezeigt haben, schließen Sie den Bereich, indem Sie auf x klicken oder Strg+F4 drücken.

Reservierte Kapazität bearbeiten

  1. Klicken Sie mit der rechten Maustaste auf die gewünschte Tabelle, und klicken Sie auf Reservierte Kapazität bearbeiten.

  2. Im Bereich "Reservierte Kapazität bearbeiten" können Sie entweder die bereitgestellte Kapazität oder die On-Demand-Kapazität aktualisieren.

    1. Bereitgestellte Kapazität: Sie können die Lesekapazität, Schreibkapazität und den Festplattenspeicher nach Ihren Anforderungen bearbeiten.

    2. On-Demand-Kapazität: Sie können nur den Festplattenspeicher ändern. Die Lese- und Schreibkapazität befinden sich im schreibgeschützten Modus.

  3. Wenn Sie eine Benachrichtigung erhalten, dass die reservierte Kapazität aktualisiert wurde, schließen Sie den Bereich, indem Sie auf x klicken oder Strg+F4 drücken.

DML-Vorgänge mit Visual Studio Code ausführen

Mit dem Visual Studio Code-Plugin können Sie Daten hinzufügen, vorhandene Daten ändern und Daten aus Tabellen abfragen.

Daten einfügen

Daten ändern - Zeilen aktualisieren/Zeile löschen:

SQL-Abfragen für eine Tabelle ausführen

Hinweis: In der Dropdown-Liste werden nur SQL-Anweisungen angezeigt, die sich auf die Tabelle beziehen, mit der Sie es zu tun haben.

Verbindung wird entfernt

Oracle NoSQL Database Connector bietet zwei Methoden zum Entfernen einer Verbindung aus Visual Studio-(VS-)Code.

Sie können folgende Aktionen ausführen:

Hinweis: Um eine Verbindung dauerhaft aus dem Plug-in zu entfernen, wählen Sie die Verbindung in der Dropdown-Liste Verbindungen aus. Klicken Sie auf Verbindung löschen. Sie erhalten eine Bestätigung zum Löschen des Plug-ins, und klicken Sie auf Ja, um die Verbindung aus dem Plug-in zu entfernen. Wenn Sie eine Verbindung aus Visual Studio Code entfernen, werden die persistenten Verbindungsdetails aus dem aktuellen Workspace gelöscht.

  1. Blenden Sie den Bereich TABLE EXPLORER in der linken Navigationsleiste ein, wenn er ausgeblendet ist.

  2. Klicken Sie mit der rechten Maustaste auf die zu entfernende Verbindung, und klicken Sie dann auf Verbindung entfernen.

  1. Öffnen Sie die Befehlspalette durch Drücken von Strg+Umschalt:

    • (Windows und Linux) Steuerung + Umschalt + P

    • (macOS) Befehl + Umschalt + P

  2. Wählen Sie in der Befehlspalette OracleNoSQL: Verbindung entfernen aus.

    Hinweis: Geben Sie in der Befehlspalette oraclenosql ein, um alle Oracle NoSQL DB-Befehle anzuzeigen, die Sie verwenden können.

Autorisierungsanforderungen für Visual Studio Code

Erfahren Sie mehr über die Autorisierungsanforderungen, die in Oracle NoSQL Database Cloud Service für die Verwendung von Visual Studio Code erforderlich sind.

Mit der Visual Studio Code-Erweiterung können Sie mit der API-Schlüsselauthentifizierungsmethode auf Oracle NoSQL Database Cloud Service zugreifen. Der Zugriff auf Ressourcen in Oracle NoSQL Database Cloud Service, wie Tabellen, Tablespaces und APIs, wird über Identity and Access Management-(IAM-)Policys verwaltet. Dadurch wird sichergestellt, dass nur authentifizierte Benutzer, die Mitglieder von Gruppen mit den entsprechenden Berechtigungen zum Prüfen, Lesen, Verwenden oder Verwalten von Tabellen in einem bestimmten Compartment sind, mit diesen Ressourcen interagieren können. Weitere Informationen finden Sie unter Zugriff auf NDCS-Tabellen verwalten.

Wenn Sie mit Visual Studio Code Tabellen in Oracle NoSQL Database Cloud Service-Tabellen verwalten, legen Ihre effektiven IAM-Berechtigungen fest, aus welchen Ressourcen Sie lesen oder schreiben können. Wenn ein Benutzer eine Aktion versucht, für die ihm die Autorisierung fehlt, gibt Visual Studio Code den entsprechenden Autorisierungsfehler zurück, der von OCI IAM bereitgestellt wird.

Beispiel: OCI IAM lehnt einen Einfügevorgang für eine Oracle NoSQL Database Cloud Service-Tabelle ab, wenn Ihre Benutzergruppe nur über die Leseberechtigung für NoSQL-Tabellen verfügt. Die folgende Fehlermeldung wird in der Visual Studio Code-Erweiterung angezeigt:

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