Oracle Cloud Infrastructure - Dokumentation

Informationen zur Oracle NoSQL Database Visual Studio Code-Erweiterung

Oracle NoSQL Database Cloud Service stellt eine Erweiterung für Microsoft Visual Studio Code bereit, 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:
  • Tabellen in einer wohldefinierten Baumstruktur mit Table Explorer anzeigen
  • Zeigen Sie Informationen zu Spalten, Indizes, Primärschlüsseln und Shard-Schlüsseln für eine Tabelle an.
  • Spaltendaten in einer gut formatierten JSON-Struktur anzeigen.
  • Erstellen Sie Tabellen mit formbasierten Schemaeinträgen, oder geben Sie DDL-Anweisungen an.
  • Tabellen löschen.
  • Führen Sie SELECT SQL-Abfragen für eine Tabelle aus, und zeigen Sie die Abfrageergebnisse im Tabellenformat an.
  • Führen Sie DML-Anweisungen aus, um Daten in einer Tabelle zu aktualisieren, einzufügen und zu löschen.

Dieser Artikel enthält die folgenden Themen:

Oracle NoSQL Database Visual Studio Code-Erweiterung installieren

Sie können die Oracle NoSQL Database VS Code-Erweiterung auf zwei Arten installieren. Installieren Sie im Visual Studio Marketplace zur Online-Installation, oder installieren Sie das VSIX-Package mit der Datei *.vsix für die Offlineinstallation.

Bevor Sie die Oracle NoSQL Database Visual Studio-(VS-)Codeerweiterung installieren können, müssen Sie Visual Studio Code installieren. Sie können Visual Studio Code hier herunterladen.
  1. Klicken Sie in Visual Studio Code auf das Symbol Erweiterungen in der linken Navigation.


    Visual Studio-Codeaktivitätsleiste

    Alternativ können Sie die Ansicht Erweiterungen öffnen, indem Sie Folgendes drücken:
    • (Windows und Linux) Steuerelement + Umschalt + X
    • (macOS) Befehl + Umschalt + X.
  2. Suchen Sie Oracle NoSQL Database Connector auf dem Marketplace für Erweiterungen.
  3. Klicken Sie in der Oracle NoSQL Database Connector-Erweiterung auf "Installieren".
  1. Laden Sie die VSIX-Datei für Oracle NoSQL Database von der Oracle NoSQL Database-Downloads-Site herunter.
  2. Klicken Sie in Visual Studio Code auf das Symbol Erweiterungen in der linken Navigation.


    Visual Studio-Codeaktivitätsleiste

    Alternativ können Sie die Ansicht Erweiterungen öffnen, indem Sie Folgendes drücken:
    • (Windows und Linux) Steuerelement + Umschalt + X
    • (macOS) Befehl + Umschalt + X.
  3. Klicken Sie in der Ansicht Erweiterungen auf das Menü Weitere Aktionen (...), und klicken Sie dann auf Aus VSIX installieren....


    Aus VSIX-Aktion installieren

  4. Navigieren Sie zu dem Speicherort der Datei *.vsix, und klicken Sie auf Installieren.

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

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

Sie können entweder eine Konfigurationsdatei mit den Verbindungsinformationen angeben oder die Verbindungsinformationen in die jeweiligen Felder eingeben. Wenn Sie einen Node.js-Treiber verwenden und bereits Verbindungsdetails in einer Datei gespeichert sind, verwenden Sie die Option "Über Konfigurationsdatei verbinden", um eine Verbindung zu Oracle NoSQL Database Cloud Service herzustellen. Wenn Sie eine neue Verbindung erstellen, verwenden Sie andernfalls die Option "Einzelne Felder ausfüllen".
  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 Seite Verbindungseinstellungen anzeigen von Oracle NoSQL DB über die Befehlspalette oder die Ansicht Oracle NoSQL DB in der Aktivitätsleiste.
    • Aus Befehlspalette öffnen
      1. Öffnen Sie die Befehlspalette, indem Sie Folgendes drücken:
        • (Windows und Linux) Steuerung + Umschalt + P
        • (macOS) Befehl + Umschalt + P
      2. Wählen Sie in der Befehlspalette die Option OracleNoSQL: Verbindungseinstellungen anzeigen aus.

        Tipp:

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


        Oracle NoSQL DB - Befehl "Verbindungseinstellungen anzeigen"

    • Aus Oracle NoSQL DB-Ansicht öffnen
      1. Blenden Sie den Bereich TABLE EXPLORER in der linken Navigation ein, wenn er ausgeblendet ist.
      2. Klicken Sie auf Verbindung hinzufügen, um die Seite Verbindungseinstellungen anzeigen von Oracle NoSQL DB zu öffnen.


      Oracle NoSQL DB-TABELLEN-EXPLORER

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


    NoSQL DB-Verbindungseinstellungen für Oracle NoSQL Database Cloud Service

  4. Geben Sie die Verbindungsinformationen ein.

    Tabelle 5-4: Cloudverbindungsparameter

    Feld Beschreibung Beispielwert
    Region: Wählen Sie die Regions-ID des Oracle NoSQL Database Cloud Service-Endpunkts aus. us-ashburn-1
    Konfigurationsdatei: Navigieren Sie zu dem Speicherort der OCI-Konfigurationsdatei. /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_USER
    Compartment: Der Name oder die OCID des Compartments für das Oracle NoSQL Database Cloud Service-Schema.

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

    Compartments erstellen Sie 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.

    • Abteilungsname

      mycompartment

    • Mit dem übergeordneten Compartment qualifizierter Compartment-Name

      Parent.childcompartment

    • Compartment-OCID

      ocid1.tenancy.oc1...<unique_ID>
    Mandanten-OCID: OCID des Mandanten für Oracle NoSQL Database Cloud Service. Siehe Mandanten-OCID und Benutzer-OCID 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 Mandanten-OCID und Benutzer-OCID 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.

    Der Fingerprint des Signaturschlüssels wird erstellt, während der API-Signaturschlüssel generiert und hochgeladen wird. Siehe How to Get the Key's Fingerprint 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, in 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 How to Get the Key's Fingerprint 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 das Oracle NoSQL Database Cloud Service-Schema.

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

    Compartments erstellen Sie 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.

    • Abteilungsname

      mycompartment

    • Mit dem übergeordneten Compartment qualifizierter Compartment-Name

      Parent.childcompartment

    • Compartment-OCID

      ocid1.tenancy.oc1...<unique_ID>

    Tabelle 5-5 CloudSim Verbindungsparameter

    Feld Beschreibung Beispielwert
    Endpunkt: Serviceendpunkt-URL der Oracle NoSQL Database Cloud-Simulator-Instanz. 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.

  5. Klicken Sie auf Verbinden.
  6. Klicken Sie auf Zurücksetzen, um die gespeicherten Verbindungsdetails aus dem Workspace zu löschen.
  1. Erstellen Sie die Konfigurationsdatei, z.B. config.json oder eine Datei mit dem JSON-Objekt. Das Konfigurationsdateiformat für die Verbindung mit Oracle NoSQL Database Cloud Service oder Oracle NoSQL Database Cloud-Simulator wird wie unten dargestellt angezeigt.

    Tabelle 5-6 Konfigurationsvorlagen

    Oracle NoSQL Database Cloud Service Oracle NoSQL Database Cloud-Simulator
    Konfigurationsvorlage für die Verbindung mit der OCI-Konfigurationsdatei
    {
 "region": "<region-id-of-nosql-cloud-service-endpoint>",
 "compartment": "<oci-compartment-name-or-id>",
 "auth":
  {
   "iam":
    {
     "configFile": "<path-to-OCI-config-file>", 
     "profileName": "<oci-credentials-profile-name>"
    }
  }
}
    Konfigurationsvorlage für die Verbindung mit IAM-Authentifizierungszugangsdaten
    {
 "region": "<region-id-of-nosql-cloud-service-endpoint>",
 "compartment": "<oci-compartment-name-or-id>",
 "auth":
  {
   "iam":
    {
     "tenantId": "<tenancy-ocid>",
     "userId": "<user-ocid>",
     "fingerprint": "<fingerprint-for-the-signing-key>",
     "privateKeyFile": "<path-to-the-private-key>",
     "passphrase": "<passphrase-of-the-signing-key>"
     }
   }
}
    		 
    {
 "endpoint": "http://myinstance.cloudsim.com:8080",
 "auth" : "Bearer<tenant-id>"
}
  2. Öffnen Sie die Befehlspalette, indem Sie Folgendes drücken:
    • (Windows und Linux) Steuerelement + Umschalt + X
    • (macOS) Befehl + Umschalt + X
  3. Wählen Sie in der Befehlspalette Oracle NoSQL: Über Konfigurationsdatei verbinden aus.

    Tipp:

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


    Verbindung über Konfigurationsdatei herstellen

  4. Navigieren Sie zu dem Speicherort der Datei *.config, und klicken Sie auf Auswählen.

Tabellen mit Visual Studio Code-Erweiterung verwalten

Nachdem Sie sich mit der Oracle NoSQL Database Visual Studio-(VS-)Codeerweiterung bei Ihrem Deployment angemeldet haben, verwenden Sie TABLE EXPLORER in der linken Navigation:
  • Tabellen, Spalten, Indizes, Primärschlüssel und Shard-Schlüssel untersuchen
  • Neue Tabellen erstellen
  • Löschen Sie vorhandene Tabellen.
  • Führen Sie SELECT-SQL-Abfragen und DML-Anweisungen für eine Tabelle aus.

Oracle NoSQL DB-TABELLEN-EXPLORER

Wenn Sie eine aktive Verbindung erweitern, zeigt Oracle NoSQL Database VS Code die Tabellen in diesem Deployment an.
  • Klicken Sie auf den Tabellennamen, um die Spalten, Indizes, Primärschlüssel und Shard-Schlüssel anzuzeigen. Der Spaltenname wird zusammen mit seinem Datentyp angezeigt.
  • Sie können das Schema oder die Tabelle jederzeit aktualisieren, um das Deployment erneut abzufragen und Oracle NoSQL Database Cloud Service mit den aktuellen Daten aufzufüllen.
    • Suchen Sie in TABLE EXPLORER die Verbindung, und klicken Sie auf das Symbol "Aktualisieren", um das Schema neu zu laden. Alternativ können Sie mit der rechten Maustaste auf die Verbindung klicken und Schema aktualisieren auswählen.


      Oracle NoSQL DB VS Code-Erweiterung - Schema aktualisieren

    • Suchen Sie in TABLE EXPLORER den Tabellennamen, und klicken Sie auf das Symbol "Aktualisieren", um die Tabelle neu zu laden. Alternativ können Sie mit der rechten Maustaste auf den Tabellennamen klicken und Tabelle aktualisieren auswählen.


      Oracle NoSQL DB VS-Codeaktualisierungstabelle

SQL-Abfragen und DML-Anweisungen für eine Tabelle ausführen

  1. Klicken Sie mit der rechten Maustaste auf die Zieltabelle, und wählen Sie Tabelle durchsuchen aus.
  2. Geben Sie im Fenster SQL die SELECT-Abfrage in das Textfeld ein, und klicken Sie auf
    Oracle NoSQL DB VS Code - Abfrage ausführen

    . Das Abfrageergebnis wird im Tabellenformat angezeigt. Sie können die Anzahl der Zeilen pro Seite anpassen. Sie können auch DML-Anweisungen ausführen, um Daten aus einer Tabelle zu aktualisieren, einzufügen und zu löschen.
  3. Um die Daten einzelner Zellen separat anzuzeigen, klicken Sie auf die Tabellenzelle.

Tabelle löschen

  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.

Oracle NoSQL Database Cloud Service-Tabelle aus Visual Studio-Code erstellen

Sie können die Oracle NoSQL Database Cloud Service-Tabelle in zwei Modi erstellen:
  • Einfache DDL-Eingabe: Mit diesem Modus können Sie die Oracle NoSQL Database Cloud Service-Tabelle deklarativ erstellen, d.h. ohne eine DDL-Anweisung zu schreiben.
  • Erweiterte DDL-Eingabe: Mit diesem Modus können Sie die Oracle NoSQL Database Cloud Service-Tabelle mit einer DDL-Anweisung erstellen.
  1. Bewegen Sie den Mauszeiger über die Oracle NoSQL Database Cloud Service-Verbindung, um die neue Tabelle hinzuzufügen.
  2. Klicken Sie auf das Pluszeichen.
  3. Wählen Sie auf der Seite Tabelle erstellen die Option Einfache DDL-Eingabe aus.


    Oracle NoSQL Database Cloud Service-Tabelle mit einfachem DDL-Eingabemodus erstellen

    Tabelle 5-7: Oracle NoSQL Database Cloud Service-Tabelle erstellen

    Feld Beschreibung
    Lesekapazität (Leseeinheiten) Geben Sie die Anzahl der Leseeinheiten ein. Weitere Informationen zu Leseeinheiten finden Sie unter Kapazität schätzen.
    Schreibkapazität (Schreibeinheiten) Geben Sie die Anzahl der Schreibeinheiten ein. Weitere Informationen zu Schreibeinheiten finden Sie unter Kapazität schätzen.
    Datenspeicher (GB) Geben Sie die Datenträgerkapazität in GB an, die von der Tabelle verwendet werden soll. Weitere Informationen zur Speicherkapazität finden Sie unter Kapazität schätzen.
    Tabellenname: Geben Sie einen Tabellennamen an, der innerhalb Ihres Mandanten eindeutig ist. Tabellennamen müssen den Oracle NoSQL Database Cloud Service-Naming-Konventionen entsprechen. Siehe Service Limits.
    Spaltenname Geben Sie einen Spaltennamen für den Primärschlüssel in der Tabelle an. Weitere Informationen zu den Anforderungen für die Benennung von Spalten finden Sie unter Servicelimits.
    Spaltentyp Wählen Sie den Datentyp für die Primärschlüsselspalte aus.
    Als Shard-Schlüssel festlegen Wählen Sie diese Option, um diese Primärschlüsselspalte als Shard-Schlüssel festzulegen. Shard-Schlüssel ist die Verteilung von Daten über das Oracle NoSQL Database Cloud Service-Cluster hinweg, um die Effizienz zu erhöhen, und die Positionierung von Datensätzen, die denselben Shard-Schlüssel verwenden, zwecks einfacher Referenz und schnellem Zugriff lokal. Datensätze mit demselben 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 beim Erstellen eines zusammengesetzten (mehrspaltigen) Primärschlüssels hinzuzufügen.
    Spaltenname Geben Sie den Spaltennamen an. Stellen Sie sicher, dass Sie den unter Servicelimits beschriebenen Anforderungen für die Spaltenbezeichnung entsprechen.
    Spaltentyp Wählen Sie den Datentyp für die Primärschlüsselspalte aus.
    Standardwert (Optional) Geben Sie einen Standardwert für die Spalte an.
    Hinweis

    Für Spalten vom Datentyp "BINARY" und "JSON" können Sie keine Standardwerte angeben.
    Nicht Null Wählen Sie diese Option, 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 verfallen die Zeilen automatisch und sind nicht mehr verfügbar. Der Standardwert "Null" gibt an, dass keine Ablaufzeit vorhanden ist.
    Hinweis

    Wenn Sie die Gültigkeitsdauer der Tabelle (TTL) aktualisieren, wird der TTL-Wert von vorhandenen Daten in der Tabelle nicht geändert. Der neue TTL-Wert wendet nur auf die Zeilen an, die der Tabelle hinzugefügt werden, nachdem dieser Wert geändert wurde, und auf die Zeilen, für die kein überschreibender zeilenspezifischer Wert angegeben wurde.
  4. Klicken Sie auf DDL anzeigen, um die DDL-Anweisung anzuzeigen, die auf den Werten basiert, die in die Felder im Modus Einfache DDL-Eingabe eingegeben wurden. Diese DDL-Anweisung wird ausgeführt, wenn Sie auf Erstellen klicken.
  5. Klicken Sie auf Erstellen.
  1. Bewegen Sie den Mauszeiger über die Oracle NoSQL Database Cloud Service-Verbindung, um die neue Tabelle hinzuzufügen.
  2. Klicken Sie auf das Pluszeichen.
  3. Wählen Sie auf der Seite Tabelle erstellen die Option Erweiterte DDL-Eingabe aus.


    Oracle NoSQL Database Cloud Service-Tabelle mit dem erweiterten DDL-Eingabemodus erstellen

    Tabelle 5-8: Tabelle für Oracle NoSQL Database Cloud Service erstellen

    Feld Beschreibung
    Lesekapazität (Leseeinheiten) Geben Sie die Anzahl der Leseeinheiten ein. Weitere Informationen zu Leseeinheiten finden Sie unter Kapazität schätzen.
    Schreibkapazität (Schreibeinheiten) Geben Sie die Anzahl der Schreibeinheiten ein. Weitere Informationen zu Schreibeinheiten finden Sie unter Kapazität schätzen.
    Datenspeicher (GB) Geben Sie die Datenträgerkapazität in GB an, die von der Tabelle verwendet werden soll. Weitere Informationen zur Speicherkapazität finden Sie unter Kapazität schätzen.
    DDL-Anweisung Geben Sie die DDL-Anweisung zum Erstellen von Tabellen an. Siehe SQL-Referenz für Oracle NoSQL Database.
  4. Klicken Sie auf Erstellen.

Verbindung entfernen

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

Sie können Folgendes ausführen:
  • Entfernen einer Verbindung mit der Befehlspalette oder
  • Entfernen Sie in der Aktivitätsleiste eine Verbindung aus der Oracle NoSQL DB-Ansicht.
Hinweis

Wenn Sie eine Verbindung aus Visual Studio Code entfernen, werden die persistierten Verbindungsdetails aus dem aktuellen Workspace gelöscht.
  1. Blenden Sie den Bereich TABLE EXPLORER in der linken Navigation ein, wenn er ausgeblendet ist.
  2. Klicken Sie mit der rechten Maustaste auf die Verbindung, die Sie entfernen möchten, und klicken Sie dann auf Verbindung entfernen.


Tabellen-Explorer

  1. Öffnen Sie die Befehlspalette, indem Sie Folgendes drücken:
    • (Windows und Linux) Steuerung + Umschalt + P
    • (macOS) Befehl + Umschalt + P
  2. Wählen Sie in der Befehlspalette die Option OracleNoSQL: Verbindung entfernen aus.

    Tipp:

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


    Verbindung entfernen