IntelliJ-Plug-in für die Entwicklung verwenden
Tabellen durchsuchen und Abfragen in Ihrer Oracle NoSQL Database Cloud Service-Instanz oder im Oracle NoSQL Database Cloud-Simulator von IntelliJ ausführen.
Das IntelliJ-Plug-in für Oracle NoSQL Database Cloud Service stellt die Verbindung zu einer aktiven Instanz von Oracle NoSQL Database Cloud Service oder Oracle NoSQL Database Cloud Simulator her und ermöglicht Ihnen Folgendes:
-
Zeigen Sie die Tabellen in einer gut definierten Baumstruktur mit Table Explorer an.
-
Informationen zu Spalten, Indizes, Primärschlüsseln und Shard-Schlüsseln für eine Tabelle anzeigen.
-
Zeigen Sie Spaltendaten in einer gut formatierten JSON-Struktur an.
-
Tabellen mit formularbasierten Schemaeinträgen erstellen oder DDL-Anweisungen bereitstellen
-
Tabellen löschen
-
Neue Spalten mit formularbasierten Einträgen hinzufügen oder DDL-Anweisungen bereitstellen
-
Spalten löschen.
-
Indizes generieren
-
Indizes entfernen.
-
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 aus einer Tabelle zu aktualisieren, einzufügen und zu löschen.
Dieser Artikel enthält die folgenden Themen:
IntelliJ-Plug-in einrichten
Erfahren Sie, wie Sie das IntelliJ-Plug-in für Oracle NoSQL Database Cloud Service-Instanz oder den Oracle NoSQL Database Cloud-Simulator einrichten.
Voraussetzung:
Installieren Sie IntelliJ IDEA. Sie können IntelliJ IDEA von JetBrains herunterladen.
Vorgehensweise:
Sie können das Plug-in wie folgt installieren:
-
Öffnen Sie die Seite Oracle NoSQL DatabaseConnector, JetBrains-Plug-in-Repository.
- Wählen Sie Get aus.
- Wählen Sie im Menü Versionen die Option Herunterladen für die neueste Version des Oracle NoSQL Database-Connectors.
- Befolgen Sie im Popup-Fenster die Anweisungen auf dem Bildschirm unter How to Install 'Oracle NoSQL Database Connector'.
Starten Sie die IDE neu. Das Symbol Schema Explorer wird im rechten Fensterbereich angezeigt.
Nachdem Sie die IntelliJ-Plug-ins erfolgreich eingerichtet hat, erstellen sie ein NoSQL-Projekt, und verbinden Sie es mit der Oracle NoSQL Database Cloud Service-Instanz oder dem Oracle NoSQL Database Cloud-Simulator.
NoSQL-Projekt in IntelliJ erstellen
Erfahren Sie, wie Sie ein NoSQL-Projekt in IntelliJ erstellen.
Führen Sie die folgenden Schritte durch:
- Öffnen Sie IntelliJ IDEA. Klicken Sie auf Datei > Neu > Projekt.
- Geben Sie einen Wert für Projektname und Projektstandort ein. Wählen Sie Erstellen.
- Wählen Sie ein Build-System und einen JDK-Pfad.
- IntelliJ erstellt das NoSQL-Projektverzeichnis, das eine Java-Beispieldatei enthält. Wenn Sie Maven als Build-System ausgewählt haben, enthält das Projektverzeichnis auch eine pom.xml-Datei.
- Stellen Sie sicher, dass Notifications für Ihr Oracle NoSQL-Projekt aktiviert ist. Um Notifications zu aktivieren, drücken Sie
Alt+\, um das Hauptmenü zu öffnen. Klicken Sie auf Ansicht, und blenden Sie Toolfenster > Benachrichtigungen ein. Das Benachrichtigungssymbol
wird in der rechten Werkzeugfensterleiste angezeigt.
Nachdem Sie ein NoSQL-Projekt in IntelliJ erfolgreich erstellt haben, können Sie Ihr Projekt mit Oracle NoSQL Database Cloud Service oder dem Oracle NoSQL Database Cloud-Simulator verbinden.
Verbindung zu Oracle NoSQL Database Cloud Service über IntelliJ herstellen
Erfahren Sie, wie Sie Ihr NoSQL-Projekt über das IntelliJ-Plug-in mit Oracle NoSQL Database Cloud Service verbinden.
Führen Sie die folgenden Schritte durch:
-
Öffnen Sie Ihr NoSQL-Projekt in IntelliJ.
-
Klicken Sie im Fenster Schema Explorer auf das Aufgabensymbol
, um den Dialog Einstellungen für das Plug-in zu öffnen. -
Blenden Sie im Einstellungs-Explorer Extras > Oracle NoSQL ein, und klicken Sie auf Verbindungen.
-
Wählen Sie im Dropdown-Menü für den Profiltyp Cloud aus. Sie können alle vorhandenen Verbindungen für den Cloud-Profiltyp in der Dropdown-Liste Verbindungen anzeigen.
-
Klicken Sie auf Add Connection. Sie haben zwei Optionen, um eine Verbindung zu erstellen.
-
Konfigurationsdatei verwenden: Sie geben den Pfad der Konfigurationsdatei an, der auf den Speicherort der OCI-Konfigurationsdatei verweist, die auf Ihrem lokalen System gespeichert ist. Diese Datei enthält die wesentlichen Parameter, die für die Anmeldung bei Oracle NoSQL Database Cloud Service erforderlich sind, wie Region, Mandanten-ID, Benutzer-ID, Fingerprint, Passphrase und Private-Key-Pfad.
Geben Sie die erforderlichen Werte für die folgenden Verbindungsparameter ein, und wählen Sie ADD aus. Wählen Sie dann OK aus.
Tabelle - Option für Konfigurationsdatei für Verbindungsparameter
Parameter Beschreibung Beispielwert Verbindungsname Ein eindeutiger Name, der einer bestimmten Verbindungsspezifikation zugewiesen wird, ist ab der Plug-in-Version 1.5.1 obligatorisch. Das Aktualisieren des Feldes "Verbindungsname" wird empfohlen, nachdem das Plug-in von Version 1.4.0 oder niedriger aktualisiert wurde.
Hinweis: Sie können mehrere Verbindungen hinzufügen, und die gespeicherten Verbindungsspezifikationen sind persistent.ndcs_con1Konfigurationsdatei Pfad eines Verzeichnisses, in dem die Konfigurationsdatei im lokalen System gespeichert ist. Weitere Informationen zur Konfigurationsdatei und zu ihrem Inhalt finden Sie in der Methode Benutzer-Principals unter Authentifizierung für die Verbindung zu Oracle NoSQL Database. ~/.oci/configProfil Name des Profils.
Hinweis: Sie können mehrere Profile mit unterschiedlichen Werten für diese Einträge erstellen und dann angeben, welches Profil geladen werden soll.DEFAULTCompartment (optional) Der Compartment-OCID/Compartment-Name für das NoSQL-Datenbankschema.
Hinweis: Wenn Sie den Compartment-Namen angeben, müssen Sie die gesamte Hierarchie mit einem Doppelpunkt angeben, der jeden Eintrag trennt.developers:dev1.Hier ist
dev1ein Compartment unter dem Compartmentdevelopers.
Hinweis: Wenn kein Wert angegeben ist, wird standardmäßig das Root Compartment angezeigt.Das Plug-in stellt eine Verbindung zu der Region her, die in der Konfigurationsdatei angegeben ist.
Wenn Sie die Sessiontoken-basierte Authentifizierung verwenden, enthält Ihre Konfigurationsdatei das angegebene Profil für das Sessiontoken zusammen mit dem Tokenpfad. Um eine Verbindung zu Oracle NoSQL Database Cloud Service herzustellen, müssen Sie die Option für die Konfigurationsdatei auswählen und das entsprechende Profil angeben.
-
Erweitert: Sie geben direkt die Verbindungsparameter an, die für die Verbindung zu Oracle NoSQL Database Cloud Service erforderlich sind. Geben Sie die erforderlichen Werte für die folgenden Parameter ein, und wählen Sie Hinzufügen. Wählen Sie dann OK aus.
Tabelle - Erweiterte Option "Verbindungsparameter"
Parameter Beschreibung Beispielwert Verbindungsname Ein eindeutiger Name, der einer bestimmten Verbindungsspezifikation zugewiesen wird, ist ab der Plug-in-Version 1.5.1 obligatorisch. Das Aktualisieren des Feldes "Verbindungsname" wird empfohlen, nachdem das Plug-in von Version 1.4.0 oder niedriger aktualisiert wurde.
Hinweis: Sie können mehrere Verbindungen hinzufügen, und die gespeicherten Verbindungsspezifikationen sind persistent.ndcs_con1Endpunkt Regionaler Netzwerkzugriffspunkt für Oracle NoSQL Database Cloud Service. https://nosql.us-ashburn-1.oci.oraclecloud.com(für die Oracle NoSQL Database Cloud Service-Regions-ID von Ashburn in der Region Nordamerika). Eine Liste der Serviceendpunkte finden Sie unter Datenregionen und zugehörige Serviceendpunkte.Kunden-ID und Benutzerkennung OCID des Mandanten und der Benutzer-OCID für Oracle NoSQL Database Cloud Service. Weitere Informationen finden Sie unter OCID und Benutzer-OCID des Mandanten abrufen in der Oracle Cloud Infrastructure-Dokumentation. Fingerabdruck und Passphrase (optional) Der Fingerprint und die Passphrase des Signaturschlüssels, die beim Generieren und Hochladen des API-Signaturschlüssels erstellt wurden. Informationen hierzu finden Sie in den folgenden Ressourcen in der Oracle Cloud Infrastructure-Dokumentation:
- Informationen zum Generieren des Signaturschlüssels mit einer optionalen Passphrase finden Sie unter So generieren Sie einen API-Signaturschlüssel.
- Informationen zum Abrufen des Fingerprints des Schlüssels finden Sie unter Fingerprint des Schlüssels abrufen.Private Key Der für den Benutzer generierte Private Key. Für den Anwendungsbenutzer muss ein API-Signaturschlüssel generiert und hochgeladen werden. Weitere Informationen zum Generieren des Signaturschlüssels mit einer optionalen Passphrase finden Sie unter So generieren Sie einen API-Signaturschlüssel. Compartment (optional) Der Compartment-OCID/Compartment-Name für das NoSQL-Datenbankschema.
Hinweis: Wenn Sie den Compartment-Namen angeben, müssen Sie die gesamte Hierarchie mit einem Doppelpunkt angeben, der jeden Eintrag trennt.developers:dev1.Hier ist
dev1ein Compartment unter dem Compartmentdevelopers.
Hinweis: Wenn ein Wert nicht angegeben wird, wird standardmäßig das Root Compartment angezeigt.Hinweis:
-
Ab Version 1.5.4 lädt das IntelliJ-Plug-in automatisch das neueste Oracle NoSQL-Java-SDK herunter und legt den SDK-Pfad beim Erstellen einer Verbindung fest.
-
Wenn Sie das Plugin von Version 1.4.0 oder niedriger aktualisieren, migrieren alle gespeicherten Verbindungen zur neuen Version. In diesem Fall entspricht der Verbindungsname dem Endpunkt. Führen Sie den folgenden Schritt aus, um den Verbindungsnamen zu ändern.
-
-
Das IntelliJ-Plug-in speichert die Verbindungsdetails im angegebenen Verbindungsnamen. Um die Verbindungsdetails zu ändern, wählen Sie den Verbindungsnamen in der Dropdown-Liste für Verbindungen aus. Klicken Sie auf Modify Connection. Sie können einen beliebigen Verbindungsparameter (siehe oben) ändern und auf OK klicken, um die Einstellungen zu speichern. Um einen Verbindungsnamen aus dem Plug-in zu entfernen, wählen Sie den Verbindungsnamen, und klicken Sie auf Verbindung löschen. Sobald Sie die zu löschende Aktion bestätigt haben, wird der Verbindungsname aus dem Plug-in entfernt.
-
Klicken Sie im Schema Explorer auf das Websymbol. Die Liste der vorhandenen Verbindungen wird im Dropdown-Feld angezeigt. Der Verbindungsname werden im NoSQL-Toolfenster in folgendem Format angezeigt:
Tabelle - Verbindungsanzeige
Zum Erstellen einer Verbindung verwendete Option Im NoSQL-Tool-Fenster anzeigen AdvancedConnection Name:Endpoint:Compartment Name/OCID(falls nicht Root)Use Configuration FileConnection Name:Configuration file path:Profile:Compartment Name/OCID(falls nicht Root)Wählen Sie die Verbindung aus, und klicken Sie auf OK. Das IntelliJ-Plug-in verbindet Ihr Projekt Mit Oracle NoSQL Database Cloud Service und zeigt das zugehörige Schema im Fenster "Schema Explorer" an.
Nachdem Sie das Projekt erfolgreich mit Oracle NoSQL Database Cloud Service verbunden haben, können Sie die Tabellen und Daten in Ihrem Schema verwalten.
Verbindung zu Oracle NoSQL Database Cloud-Simulator über IntelliJ herstellen
Erfahren Sie, wie Sie Ihr NoSQL-Projekt über das IntelliJ-Plug-in mit Oracle NoSQL Database Cloud-Simulator verbinden.
Führen Sie die folgenden Schritte durch:
-
Oracle NoSQL Database Cloud-Simulator herunterladen und starten. Siehe Oracle NoSQL Database Cloud-Simulator downloaden.
-
Öffnen Sie Ihr NoSQL-Projekt in IntelliJ.
-
Klicken Sie im Fenster Schema Explorer auf das Aufgabensymbol
, um den Dialog Einstellungen für das Plug-in zu öffnen. -
Blenden Sie im Einstellungs-Explorer Extras > Oracle NoSQL ein, und klicken Sie auf Verbindungen. Sie können alle vorhandenen Verbindungen für den Cloudsim-Profiltyp in der Dropdown-Liste Verbindungen anzeigen.
-
Wählen Sie im Dropdown-Menü für den Profiltyp Cloudsim aus.
-
Klicken Sie auf Add Connection. Geben Sie Werte für die folgenden Verbindungsparameter ein, und klicken Sie auf OK.
Tabelle - Verbindungsparameter
Parameter Beschreibung Beispielwert Verbindungsname Ein eindeutiger Name, der einer bestimmten Verbindungsspezifikation zugewiesen wird, ist ab Plug-in-Version 1.5.1 obligatorisch. Das Aktualisieren des Feldes "Verbindungsname" wird empfohlen, nachdem das Plug-in von Version 1.4.0 oder niedriger aktualisiert wurde.
Hinweis: Sie können mehrere Verbindungen hinzufügen, und die gespeicherten Verbindungsspezifikationen sind persistent.nosql_sim1Service-URL IP-Adresse und Port, auf denen der Oracle NoSQL Database Cloud-Simulator ausgeführt wird. Der Standardwert ist http://localhost:8080.Mandanten-ID Eindeutige ID zum Identifizieren des Mandanten. Der Standardwert ist exampleId. Behalten Sie diesen Wert bei, wenn Sie die Beispiele testen möchten. Hinweis:
-
Ab Version 1.5.4 lädt das IntelliJ-Plug-in automatisch das neueste NoSQL-Java-SDK herunter und legt den SDK-Pfad beim Erstellen einer Verbindung fest.
-
Wenn Sie das Plugin von Version 1.4.0 oder niedriger aktualisieren, migrieren alle gespeicherten Verbindungen zur neuen Version. In diesem Fall entspricht der Verbindungsname dem Endpunkt. Führen Sie den folgenden Schritt aus, um den Verbindungsnamen zu ändern.
-
-
Das IntelliJ-Plug-in speichert die Verbindungsdetails im angegebenen Verbindungsnamen. Um die Verbindungsdetails zu ändern, wählen Sie den Verbindungsnamen in der Dropdown-Liste für Verbindungen aus. Klicken Sie auf Modify Connection. Sie können einen beliebigen Verbindungsparameter (siehe oben) ändern und auf OK klicken, um die Einstellungen zu speichern. Um einen Verbindungsnamen aus dem Plug-in zu entfernen, wählen Sie den Verbindungsnamen, und klicken Sie auf Verbindung löschen. Sobald Sie die zu löschende Aktion bestätigt haben, wird der Verbindungsname aus dem Plug-in entfernt.
-
Klicken Sie im Schema Explorer auf das Websymbol. Die Liste der vorhandenen Verbindungen wird im Dropdown-Feld angezeigt. Der Verbindungsname werden im NoSQL-Toolfenster in folgendem Format angezeigt:
Connection Name:service Url : Tenant IdentifierWählen Sie die Verbindung aus, und klicken Sie auf OK. Das IntelliJ-Plug-in verbindet Ihr Projekt Mit dem Oracle NoSQL Database Cloud-Simulator und zeigt das zugehörige Schema im Fenster "Schema Explorer" an.
Hinweis: Bevor Sie das Projekt über den Oracle NoSQL Database Cloud-Simulator verbinden, muss es gestartet und ausgeführt werden. Andernfalls verläuft die Verbindungsanforderung in IntelliJ nicht erfolgreich.
Nachdem Sie das Projekt erfolgreich mit dem Oracle NoSQL Database Cloud-Simulator verbunden haben, können Sie die Tabellen und Daten in Ihrem Schema verwalten.
Anwendungen mit dem Oracle NoSQL-Java-SDK aus IntelliJ erstellen
Hier erfahren Sie, wie Sie Anwendungen aus dem IntelliJ-Plug-in 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.
In diesem Thema führen Sie eine Beispielanwendung aus, die im Oracle NoSQL Java-SDK-Package verfügbar ist, um eine Tabelle im Oracle NoSQL Database Cloud-Simulator oder Oracle NoSQL Database Cloud Service zu erstellen.
Führen Sie die folgenden Schritte durch:
-
Laden Sie das neueste Oracle NoSQL Database-Java-SDK von GitHub herunter.
-
Extrahieren (entpacken) Sie die heruntergeladene Datei in einem lokalen Repository.
-
Starten Sie IntelliJ IDEA und öffnen Sie Ihr NoSQL-Projekt.
-
Wenn Sie das Maven-Build-System verwenden, stellen Sie sicher, dass Sie die erforderlichen Abhängigkeiten in pom.xml hinzugefügt haben. Weitere Informationen finden Sie unter Oracle NoSQL Java SDK GitHub.
-
Navigieren Sie aus dem extrahierten Oracle NoSQL Database Cloud Service-Java-SDK-Verzeichnis zum Ordner
oracle-nosql-java-sdk > examples. Kopieren Sie die JAVA-DateienBasicTableExampleundCommonin das NoSQL-Projektverzeichnis.Das Programm
BasicExampleTableerstellt eine Tabelle namensaudienceData, fügt dieser Tabelle zwei Zeilen hinzu, fragt die eingefügten Zeilen ab, löscht die eingefügten Zeilen und löscht schließlich die TabelleaudienceData. -
Bevor Sie das Anwendungsprogramm ausführen, müssen Sie die erforderlichen Argumente angeben, um eine Verbindung herzustellen:
a. Wählen Sie im Menü Ausführen > Konfigurationen bearbeiten.
b. Wählen Sie Neue Konfiguration hinzufügen, Anwendung aus.
c. Geben Sie im rechten Fenster Ihre Hauptklasse in das Feld Name ein.
d. Geben Sie unter Erstellen und ausführen den Java JDK-Pfad an, und geben Sie die Hauptklasse ein.
e. Geben Sie die erforderlichen Programmargumente ein. Wählen Sie Apply und anschließend Okay aus.
Tabelle - Programmargumente
Verbindungstyp Programmargumente Weitere Informationen Cloudsimulation http://localhost:8080Wenn Sie den Oracle NoSQL Database Cloud-Simulator in einem anderen Port gestartet haben, müssen Sie "8080" durch diese Portnummer ersetzen. Cloud Region [-configFile <path-to-config-file>]
Beispiel:us-ashburn-1 -configFile D:\OCI_PROP\configDas erste Argument gibt die Datenregion des Oracle NoSQL Database Cloud Service an. Das zweite Argument übergibt eine Konfigurationsdatei, die Zugangsdaten für die Verbindung mit Oracle NoSQL Database Cloud Service enthält. Informationen zum Inhalt der Konfigurationsdatei finden Sie unter Authentifizierung für die Verbindung zu Oracle NoSQL Database.
Wenn Sie die Dateiconfignicht angeben, verwendet das Skript den Standardkonstruktor für die KlasseSignatureProvider, der nach der Dateiconfigsucht unter:$HOME/.oci -
Um dieses Programm auszuführen, wählen Sie "Ausführen" oder drücken Sie die Umschalttaste + 10.
Hinweis: Wenn Sie das Programm über ein Terminal ausführen möchten, verwenden Sie die folgenden Beispielbefehle:
Kompilieren Sie das Programm mit dem maven build-System:
mvn compileFühren Sie das Programm aus, indem Sie die Programmargumente angeben:
mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="<region>"Beispiel:
mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="us-ashburn-1" -
Zeigen Sie die Ausgabe im Fenster {\b Run tool} unten an. Prüfen Sie die Logs, um zu bestätigen, dass die Codeausführung erfolgreich war. Sie sehen die Meldungen, die das Erstellen von Tabellen, das Einfügen von Zeilen usw. angeben.
Beispielausgabe:
Creating table audienceData
Created table audienceData
Put row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}} result=non-null Version
Got row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}}
Inserted row via query, result:
{"NumRowsInserted":1}
Got row inserted by query: {"cookie_id":106,"audience_data":{"audience_segment":{"foodie":"2020-06-01","sports_lover":"2020-05-10"},"ipaddr":"10.0.00.xxx"}}
Put row from json: {"cookie_id":456,"audience_data":{"ipaddr":"10.0.00.yyy","audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"}}}
Got row inserted as JSON: {"cookie_id":456,"audience_data":{"audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"},"ipaddr":"10.0.00.yyy"}}
Query results for SELECT * from audienceData WHERE cookie_id = 456:
{"cookie_id":456,"audience_data":{"audience_segment":{"foodie":"2018-12-31","sports_lover":"2019-01-05"},"ipaddr":"10.0.00.yyy"}}
Deleted key {"cookie_id":456} result=true
Dropping table audienceData
Process finished with exit code 0
Hinweis: Da BasicExampleTable die eingefügten Zeilen und die Tabelle audienceData löscht, können Sie diese Tabelle nicht im Schema-Explorer anzeigen. Wenn Sie die Tabelle im Schema-Explorer anzeigen möchten, kommentiert Sie den Code, mit dem die eingefügten Zeilen und die Tabelle löscht, und führt das Programm erneut durch.
Tabellen mit dem IntelliJ-Plug-in verwalten
Erfahren Sie, wie Sie Tabellen erstellen und Tabellendaten in Oracle NoSQL Database Cloud Service oder Oracle NoSQL Database Cloud-Simulator im Schema Explorer anzeigen.
Führen Sie die folgenden Schritte durch:
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Symbol
, um das Schema erneut zu laden. -
Suchen Sie die Tabelle unter Ihrer Mandanten-ID, und blenden sie ein, um die zugehörigen Spalten, den Primärschlüssel und den Shard-Schlüsseldetails anzuzeigen. Wenn Sie eine Beispielanwendung erstellt haben, wie im Thema Anwendungen mit dem Oracle NoSQL-Java-SDK aus IntelliJ erstellen beschrieben, wird die Tabelle
audienceDataangezeigt. -
Doppelklicken Sie auf den Tabellennamen, um die zugehörigen Daten anzuzeigen. Alternativ können Sie mit der rechten Maustaste auf die Tabelle Klicken und Tabelle durchsuchen auswählen.
-
Im Haupteditor wird ein Fenster für die Datensatzanzeige angezeigt. Klicken Sie auf Execute, um die Abfrage auszuführen und Tabellendaten anzuzeigen.
-
Um die Daten einzelner Zellen separat anzuzeigen, doppelklicken Sie auf die Zelle.
DDL-Vorgänge mit IntelliJ ausführen
Mit IntelliJ können Sie DDL-Vorgänge ausführen.
Einige der DDL-Vorgänge, die innerhalb des IntelliJ-Plug-ins ausgeführt werden können, sind
CREATE TABLE
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Symbol Aktualisieren, um das Schema erneut zu laden.
-
Klicken Sie mit der rechten Maustaste auf den Verbindungsnamen, und wählen Sie Tabelle erstellen aus.
-
Geben Sie im Prompt die Details für die neue Tabelle ein. Sie können die Oracle NoSQL Database-Tabelle in zwei Modi erstellen:
-
Einfache DDL-Eingabe: Mit diesem Modus können Sie die Tabelle deklarativ erstellen, d.h. ohne eine DDL-Anweisung zu erstellen.
-
Erweiterte DDL-Eingabe: Mit diesem Modus können Sie die Tabelle mit einer DDL-Anweisung erstellen.
-
-
Sie können die DDL-Anweisung vor der Erstellung anzeigen. Klicken Sie auf DDL anzeigen, um die DDL-Anweisung anzuzeigen, die basierend auf den Werten gebildet wurde, die in die Felder im Eingabemodus "Einfache DDL" eingegeben wurden. Diese DDL-Anweisung wird ausgeführt, wenn Sie auf "Create" klicken.
-
Klicken Sie auf Erstellen, um die Tabelle zu 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 in zwei Modi erstellen:
-
Einfache DDL-Eingabe: Sie können diesen Modus verwenden, um eine untergeordnete Tabelle zu erstellen, indem Sie einfach einen Tabellennamen und andere erforderliche Details eingeben.
-
Erweiterte DDL-Eingabe: Sie können in diesem Modus eine untergeordnete Tabelle mit einer DDL-Anweisung erstellen.
Weitere Informationen zu untergeordneten Tabellen finden Sie unter Tabellenhierarchien.
-
-
Klicken Sie auf Erstellen, um eine untergeordnete Tabelle zu erstellen.
-
Sie können die DDL-Anweisung nach dem Erstellen einer Tabelle anzeigen. Mit der rechten Maustaste auf die vorhandene Tabelle klicken. Wählen Sie Tabellen-DDL anzeigen aus. Um die DDL-Anweisung zu kopieren, klicken Sie auf In Zwischenablage kopieren. Klicken Sie auf OK, um das Dialogfeld zu schließen.
DROP TABLE
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Aktualisieren-Symbol, um das Schema erneut zu laden.
-
Klicken Sie mit der rechten Maustaste auf die Tabelle, die Sie löschen möchten. Wählen Sie Tabelle löschen.
-
Ein Bestätigungsfenster wird angezeigt. Klicken Sie auf OK, um die Löschaktion zu bestätigen.
CREATE INDEX
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Aktualisieren-Symbol, um das Schema erneut zu laden.
-
Klicken Sie mit der rechten Maustaste auf die Tabelle, in der der Index erstellt werden muss. Wählen Sie Index erstellen.
-
Im Bereich "Index erstellen" können Sie Indizes in zwei Modi erstellen:
-
Formularbasierte Indexerstellung (einfache DDL-Eingabe): Geben Sie die Details zum Erstellen eines Index ein, ohne eine DDL-Anweisung zu schreiben. Geben Sie den Namen des Index und die Spalten an, die Teil des Index sein sollen. Wenn die Spalte den JSON-Datentyp aufweist, wird ein zusätzliches Feld mit dem Namen "
JSON Path to Index Field" angezeigt. Geben Sie den Pfad zum Speicherort des JSON-Feldes ein, und wählen Sie den entsprechenden Datentyp aus. -
Index als DDL-Anweisung erstellen (für erweiterte DDL-Eingabe): Geben Sie eine gültige DDL-Anweisung ein, um einen Index zu erstellen. Es kann auch komplexe Datentypen umfassen, d.h. Array, Map und Record.
-
-
Klicken Sie auf Index hinzufügen.
DROP INDEX
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Aktualisieren-Symbol, um das Schema erneut zu laden.
-
Klicken Sie auf die Zieltabelle, um die aufgelisteten Spalten, Primärschlüssel, Indizes und Shard-Schlüssel anzuzeigen.
-
Suchen Sie den Zielindex, der gelöscht werden muss, und klicken Sie mit der rechten Maustaste darauf. Klicken Sie auf Index löschen.
-
Ein Bestätigungsfenster wird angezeigt. Klicken Sie auf OK, um die Löschaktion zu bestätigen.
SPALTE HINZUFÜGEN
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Aktualisieren-Symbol, um das Schema erneut zu laden.
-
Klicken Sie mit der rechten Maustaste auf die Tabelle, der die Spalte hinzugefügt werden soll. Wählen Sie Spalte hinzufügen aus.
-
Sie können neue Spalten in zwei Modi hinzufügen:
-
Einfache DDL-Eingabe: In diesem Modus können Sie neue Spalten hinzufügen, ohne eine DDL-Anweisung zu schreiben. Bei binärer oder fester Binärdatei wählen Sie den Datentyp als
Binaryaus. Bei einer festen Binärdatei geben Sie die Größe der Datei in das FeldSizeein, und behalten Sie das Feld bei einem binären Datentyp null bei. -
Erweiterte DDL-Eingabe: In diesem Modus können Sie neue Spalten in die Tabelle einfügen, indem Sie eine gültige DDL-Anweisung angeben. In diesem Modus können auch Spalten mit komplexem Datentyp erstellt werden. Beispiel: Array, Map oder Record und auch im verschachtelten Format.
-
-
Geben Sie in beiden Modi den Namen der Spalte an, und definieren Sie die Spalte mit ihren Eigenschaften - Datentyp, Standardwert und ob sie auf Null gesetzt werden kann.
-
Klicken Sie auf Spalte hinzufügen.
SPALTE LÖSCHEN
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Aktualisieren-Symbol, um das Schema erneut zu laden.
-
Klicken Sie auf die Zieltabelle, um die aufgelisteten Spalten, Primärschlüssel, Indizes und Shard-Schlüssel anzuzeigen.
-
Suchen Sie die Zielspalte, die gelöscht werden soll, und klicken Sie mit der rechten Maustaste darauf. Klicken Sie auf Spalte löschen.
-
Ein Bestätigungsfenster wird angezeigt. Klicken Sie auf OK, um die Löschaktion zu bestätigen.
Schema einfrieren/sperren
Sie müssen das Schema einer Singleton-Tabelle einfrieren, bevor Sie sie zu einer Global Active-Tabelle machen. Nachdem Sie das Schema der Tabelle gesperrt haben, können Sie keine Änderungen am Schema vornehmen. Um das Schema einer Singleton-Tabelle einzufrieren, muss sie mindestens eine JSON-Spalte aufweisen. Klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie Fixieren/Fixieren. Sobald Sie bestätigen, wird das Schema der Tabelle eingefroren. Um das Schema der Tabelle zu entsperren, klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie Fixieren/Fixieren. Nach der Bestätigung wird das Schema der Tabelle wieder in "mutable" geändert, was bedeutet, dass das Schema geändert werden kann.
Hinweis: Die regionalen Tabellenreplikate müssen gelöscht werden (die Tabelle muss eine Singleton-Tabelle sein), bevor der Vorgang zum Aufheben der Fixierung ausgeführt werden kann.
Replikate verwalten
Unter Regionale Tabellenreplikate wird beschrieben, was Replikate sind und wie Sie eine Singleton-Tabelle durch Hinzufügen regionaler Replikate in eine globale aktive Tabelle konvertieren.
Replikat hinzufügen
Sie können ein regionales Replikat zu einer Singleton-Tabelle hinzufügen, um sie zu einer globalen aktiven Tabelle zu machen oder ein Replikat zu einer vorhandenen globalen aktiven Tabelle hinzuzufügen. Die Tabelle sollte eingefroren werden, bevor Sie ihr ein Replikat hinzufügen. Klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie unter Regionale Replikate die Option Replikat hinzufügen aus. Sie können ein Replikat aus der Dropdown-Liste der Replikationsregion auswählen. Sie können die Leseeinheiten und Schreibeinheiten der Tabelle in diesem Replikationsbereich auswählen. Der Wert für den Festplattenspeicher für die Tabelle kann im Replikat nicht geändert/bearbeitet werden. Klicken Sie auf Replikat hinzufügen. Die Tabelle wird in der Region repliziert.
Replikat anzeigen
Klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie unter Regionale Replikate die Option Replikate anzeigen aus. Sie können die Liste der Replikate für die Tabelle anzeigen.
Replikate löschen
Klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie unter Regionale Replikate die Option Replikate löschen aus. Klicken Sie auf Hinzufügen, und wählen Sie ein zu entfernendes Replikat aus. Sie können mehrere Replikate gleichzeitig löschen. Klicken Sie auf Entfernen, wenn Sie das Replikat aus der Liste der zu löschenden Replikate entfernen möchten. Klicken Sie auf Replikate löschen. Nach der Bestätigung wird die Tabelle aus allen ausgewählten Replikaten gelöscht.
Reservierte Kapazität bearbeiten
Sie können die reservierte Kapazität und das Nutzungsmodell einer Tabelle bearbeiten. Klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie Reservierte Kapazität bearbeiten. Sie können einen der beiden Kapazitätsmodi wählen: Bereitgestellte Kapazität oder On-Demand-Kapazität. Ändern Sie die Werte, und klicken Sie auf Änderungen anwenden.
Wenn es sich bei der bearbeiteten Tabelle um eine globale aktive Tabelle handelt:
-
Die Änderung der Speicherkapazität hat einen globalen Geltungsbereich (Änderungen in einem regionalen Tabellenreplikat werden automatisch an alle regionalen Tabellenreplikate propagiert).
-
Änderung der Leseeinheiten, Schreibeinheiten oder Änderung des Kapazitätsmodus von On-Demand in Bereitgestellt oder umgekehrt hat einen lokalen Geltungsbereich (Änderung nur im regionalen Tabellenreplikat, in dem sie initiiert wird).
DML-Vorgänge mit IntelliJ ausführen
Mit dem IntelliJ-Plug-in können Sie Daten hinzufügen, vorhandene Daten ändern und Daten aus Tabellen abfragen.
Daten einfügen
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Symbol Aktualisieren, um das Schema erneut zu laden.
-
Klicken Sie mit der rechten Maustaste auf die Tabelle, in die eine Zeile eingefügt werden soll. Wählen Sie Zeile einfügen.
-
Geben Sie im Bereich "Zeile einfügen" die Details zum Einfügen einer neuen Zeile ein. Sie können eine neue ROW in zwei Modi einfügen:
-
Einfache Eingabe: Sie können diesen Modus verwenden, um die neue Zeile einzufügen, ohne eine DML-Anweisung zu schreiben. Hier wird ein formularbasierter Datensatzfeldeintrag geladen, in den Sie den Wert jedes Feldes im Datensatz eingeben können.
-
Bei binären Datentypen muss die eingegebene Zeichenfolge eine gültige Base64-Codierung eines Binärwerts sein, oder wählen Sie die hochzuladende Datei in der gewünschten Spalte aus.
-
Bei einem festen binären Datentyp sollte die eingegebene Zeichenfolge eine gültige Base64-Codierung eines Binärwerts sein oder die bei der Erstellung der jeweiligen Spalte definierte Datei mit der Größe hochladen.
Hinweis: Das Dateiformat, das Sie für den Binärdatentyp hochladen, darf nur die Erweiterung
.binaufweisen. -
-
Erweiterte JSON-Eingabe: Sie können diesen Modus verwenden, um eine neue Zeile in die Tabelle einzufügen, indem Sie ein JSON-Objekt angeben, das den Spaltennamen und den entsprechenden Wert als Schlüssel/Wert-Paare enthält. Die Eingabe kann auch vom komplexen Datentyp sein, d.h. Array, Map, Record.
-
-
Klicken Sie auf Zeile einfügen.
Daten ändern - Zeilen aktualisieren/Zeile löschen
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Symbol Aktualisieren, um das Schema erneut zu laden.
-
Klicken Sie mit der rechten Maustaste auf die Tabelle, in die eine Zeile eingefügt werden soll. Wählen Sie Tabelle durchsuchen aus.
-
Geben Sie im Textfeld auf der linken Seite die SQL-Anweisung ein, um Daten aus der Tabelle abzurufen. Klicken Sie auf Ausführen, um die Anweisung auszuführen.
-
Um einzelne Zellendaten separat anzuzeigen, klicken Sie auf die Tabellenzelle.
-
Um DML-Vorgänge wie "Zeile aktualisieren" und "Zeile löschen" auszuführen, klicken Sie mit der rechten Maustaste auf die entsprechende Zeile. Wählen Sie Ihre Option aus dem angezeigten Kontextmenü aus.
-
Zeile löschen: Ein Bestätigungsfenster wird angezeigt. Klicken Sie auf OK, um die Zeile zu löschen.
-
Zeile aktualisieren: In einem separaten HTML-Fenster werden die Spaltennamen und die entsprechenden Werte angezeigt. Sie können neue Werte für Zeilendaten in zwei Modi eingeben: Formularbasierte Zeilenfeldeingabe (einfache DDL-Eingabe) und Zeileninhalt als JSON-Objekt angeben (erweiterte DDL-Eingabe). Im erweiterten DDL-Eingabemodus werden JSON-Daten als Baumstruktur dargestellt, um die Anzeige und Aktualisierung zu vereinfachen.
Wählen Sie Ausführen aus, um die aktualisierten Daten zu aktualisieren und anzuzeigen.
Hinweis: In jeder Zeile können die Spalten PRIMARY KEY und GENERATED ALWAYS AS IDENTITY nicht aktualisiert werden.
-
Abfragetabellen
-
Suchen Sie den Schema-Explorer, und klicken Sie auf das Symbol Aktualisieren, um das Schema erneut zu laden.
-
Klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie Tabelle durchsuchen.
-
Geben Sie im Textfeld auf der linken Seite die SELECT-Anweisung ein, um Daten aus der Tabelle abzurufen. Wenn Sie mit der Eingabe der Abfrage beginnen, werden Sie aufgefordert, die Liste der möglichen Wörter einzugeben, um die SQL-Anweisung automatisch abzuschließen. Alle SQL-Schlüsselwörter und Spaltennamen für die angegebene Tabelle werden in der Eingabeaufforderung angegeben, um die SQL-Anweisung automatisch abzuschließen.
-
Die SQL-Syntax wird in jeder Abfrage hervorgehoben, was eine bessere SQL-Schreiberfahrung ermöglicht.
-
Sie können die Abfrage formatieren, um ihre Lesbarkeit zu verbessern. Wählen Sie Ihre Abfrage aus, klicken Sie mit der rechten Maustaste, und wählen Sie Prettify. Die Abfrage wird formatiert, und Zeilen werden umgebrochen, um die Lesbarkeit zu verbessern.
-
Klicken Sie auf Execute, um die Abfrage auszuführen. Die entsprechenden Daten werden aus der Tabelle abgerufen. Wenn Sie auf die abgerufenen Daten doppelklicken, werden die Spaltendaten in einem neuen Fenster geöffnet. Alle JSON-Daten werden in einer Baumstruktur im neuen Fenster angezeigt. Klicken Sie auf +, um die Baumstruktur einzublenden, oder auf -, um sie auszublenden. Klicken Sie im neuen Fenster auf Strg ^F, um die Suchoption zu aktivieren, mit der Sie nach einem beliebigen Wert in der JSON-Baumstruktur suchen können. Klicken Sie auf den Aufwärts- oder Abwärtspfeil, um zum vorherigen bzw. nächsten Suchereignis zu wechseln.
-
Klicken Sie mit der rechten Maustaste auf eine beliebige Zeile, und klicken Sie auf JSON herunterladen. Wechseln Sie im Dialogfeld zu dem Speicherort, in dem Sie die Datei speichern möchten. Klicken Sie dann auf Speichern. Nachdem die Datei heruntergeladen wurde, wird unten rechts auf dem Bildschirm eine Benachrichtigung angezeigt. Klicken Sie auf den Link, um die heruntergeladene Datei zu öffnen. Die Datei wird im Browser geöffnet.
Hinweis: Wenn der Datentyp "Binär" lautet, klicken Sie einfach in der Ausgabe auf Binärobjekt herunterladen.
-
Klicken Sie auf Abfrageergebnis herunterladen, um alle Daten im Abfrageergebnis herunterzuladen. Wechseln Sie im Dialogfeld zu dem Speicherort, in dem Sie die Datei speichern möchten. Klicken Sie dann auf Speichern. Bei mehreren Zeilen wird unten rechts auf dem Bildschirm eine Fortschrittsleiste angezeigt, in der die Anzahl der heruntergeladenen Zeilen in Echtzeit angezeigt wird. Nachdem die Datei heruntergeladen wurde, wird unten rechts auf dem Bildschirm eine Benachrichtigung angezeigt. Klicken Sie auf den Link, um die heruntergeladene Datei zu öffnen. Die Datei wird im Browser geöffnet.
-
Klicken Sie auf Abfrageplan anzeigen, um den Ausführungsplan der Abfrage anzuzeigen.
-
Klicken Sie auf die Dropdown-Liste Vorherige Befehle, um die Top 20 zuletzt ausgeführten SQL-Anweisungen anzuzeigen, die eine Ausgabe bereitgestellt hatten.
Hinweis: In der Dropdown-Liste werden nur SQL-Anweisungen angezeigt, die sich auf die Tabelle beziehen, an der Sie arbeiten.
Schema-Explorer
Im Fenster Schema Explorer können Sie den vollständigen Datentyp einer bestimmten Spalte prüfen. Suchen Sie die jeweilige Spalte, und dem Datentyp folgt der Spaltenname.
Autorisierungsanforderungen für IntelliJ-Plug-in
Erfahren Sie mehr über die Autorisierungsanforderungen, die in Oracle NoSQL Database Cloud Service für die Verwendung des IntelliJ-Plug-ins erforderlich sind.
Das IntelliJ-Plug-in ermöglicht Ihnen den Zugriff auf Oracle NoSQL Database Cloud Service mit API-Schlüsselauthentifizierung oder Sessiontokenauthentifizierungsmethoden. 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 das IntelliJ-Plug-in zum Verwalten von Tabellen in Oracle NoSQL Database Cloud Service-Tabellen verwenden, bestimmen Ihre effektiven IAM-Berechtigungen, welche Ressourcen Sie lesen oder in welche Sie schreiben können. Wenn ein Benutzer eine Aktion versucht, für die ihm keine Autorisierung fehlt, gibt das IntelliJ-Plug-in 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 im IntelliJ-Plug-in angezeigt:
Error executing Insert Row : Authorization failed or requested resource not found (5.4.18)