Utilisation du module d'extension IntelliJ pour le développement
Browse tables and execute queries on your Oracle NoSQL Database Cloud Service instance or Oracle NoSQL Database Cloud Simulator from IntelliJ.
Le module d'ajout IntelliJ Oracle NoSQL Database Cloud Service se connecte à une instance en cours d'exécution d'Oracle NoSQL Database Cloud Service ou du simulateur Oracle NoSQL Database Cloud et vous permet d'effectuer les opérations suivantes :
-
Affichez les tables dans une arborescence bien définie à l'aide de l'explorateur de tables.
-
Afficher des informations sur les colonnes, les index, les clés primaires et les clés de shard pour une table.
-
Affichez les données de colonne dans une structure JSON bien formatée.
-
Créez des tables à l'aide d'une entrée de schéma basée sur un formulaire ou fournissez des instructions DDL.
-
Supprimez des tables.
-
Ajoutez de nouvelles colonnes à l'aide d'une entrée basée sur un formulaire ou fournissez des instructions DDL.
-
Supprimer des colonnes.
-
Créer des index
-
Supprimer les index.
-
Exécuter des requêtes SQL SELECT sur une table et afficher les résultats des requêtes sous forme de tableau.
-
Exécuter des instructions LMD pour mettre à jour, insérer et supprimer des données dans une table.
Cet article comprend les rubriques suivantes :
Configuration du module d'extension IntelliJ
Découvrez comment configurer le Module d'extension IntelliJ pour l'instance Oracle NoSQL Database Cloud Service ou le Simulateur Oracle NoSQL Database Cloud.
Prérequis:
Installez IntelliJ IDEA. Vous pouvez télécharger IntelliJ IDEA à partir de JetBrains.
Procédure:
Vous pouvez installer le module d'extension comme suit :
-
Ouvrez la page Oracle NoSQL DatabaseConnector, référentiel de modules d'extension JetBrains.
- Sélectionnez Obtenir.
- Dans le menu Versions, sélectionnez Télécharger pour la dernière version du connecteur Oracle NoSQL Database.
- Dans la fenêtre contextuelle, suivez les instructions à l'écran sous Installation d'Oracle NoSQL Database Connector.
Redémarrez l'IDE. L'icône Explorateur de schémas s'affiche sur le panneau de droite.
After you successfully set up your IntelliJ plugin, create a NoSQL project, and connect it to your Oracle NoSQL Database Cloud Service instance or Oracle NoSQL Database Cloud Simulator.
Création d'un projet NoSQL dans IntelliJ
Découvrez comment créer un projet NoSQL dans IntelliJ.
Procédez comme suit :
- Ouvrez IntelliJ IDEA. Cliquez sur Fichier, puis sur Nouveau et sur Projet.
- Entrez une valeur pour Nom de projet et Emplacement de projet. Choisissez Créer.
- Sélectionnez un système de build et un chemin JDK.
- IntelliJ crée le répertoire de projet NoSQL, qui inclut un exemple de fichier Java. Si vous avez sélectionné Maven comme système de construction, le répertoire de votre projet inclut également un fichier pom.xml.
- Assurez-vous que Notifications est activé pour votre projet Oracle NoSQL. Pour activer Notifications, appuyez sur
Alt+\pour ouvrir le menu principal. Cliquez sur Afficher, développez Fenêtres d'outils > Notifications. Une icône de notification
apparaît dans la barre de fenêtre de l'outil de droite.
Une fois que vous avez créé un projet NoSQL dans IntelliJ, vous pouvez le connecter à Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud.
Connexion à Oracle NoSQL Database Cloud Service à partir d'IntelliJ
Découvrez comment connecter votre projet NoSQL à Oracle NoSQL Database Cloud Service à l'aide du module d'extension IntelliJ.
Procédez comme suit :
-
Ouvrez le projet NoSQL dans IntelliJ.
-
Cliquez sur l'icône
de la tâche dans la fenêtre Explorateur de schéma pour ouvrir la boîte Paramètres du module d'extension. -
Dans l'Explorateur de paramètres, développez Outils > Oracle NoSQL, puis cliquez sur Connexions.
-
Sélectionnez Cloud dans le menu déroulant pour le type de profil. Vous pouvez visualiser toutes les connexions existantes pour le type de profil Cloud dans la liste déroulante Connexions.
-
Cliquez sur Add Connection. Pour créer une connexion, vous avez deux possibilités.
-
Utilisation du fichier de configuration : vous indiquez le chemin du fichier de configuration, qui pointe vers l'emplacement du fichier de configuration OCI stocké sur votre système local. Ce fichier contient les paramètres essentiels requis pour la connexion à Oracle NoSQL Database Cloud Service, tels que la région, l'ID de locataire, l'ID utilisateur, l'empreinte digitale, la phrase de passe et le chemin de clé privée.
Entrez les valeurs requises pour les paramètres de connexion suivants et sélectionnez ADD. Sélectionnez ensuite OK.
Table - Option de fichier de configuration des paramètres de connexion
Paramètre Description Exemple de valeur Connection Name Un nom unique, qui est donné à une spécification de connexion spécifique, est obligatoire à partir du plugin version 1.5.1. La mise à jour du champ Nom de connexion est recommandée après la mise à niveau du module d'extension à partir de la version 1.4.0 ou inférieure.
Remarque : Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.ndcs_con1Fichier de configuration Chemin d'un répertoire dans lequel le fichier de configuration est stocké dans le système local. Pour plus d'informations sur le fichier de configuration et son contenu, reportez-vous à la méthode ID utilisateur dans Authentification pour la connexion à Oracle NoSQL Database. ~/.oci/configProfil Nom du profil.
Remarque : Vous pouvez créer plusieurs profils avec des valeurs différentes pour ces entrées, puis spécifier le profil à charger.DEFAULTCompartiment (facultatif) OCID/nom de compartiment de votre schéma de base de données NoSQL.
Remarque : lorsque vous indiquez le nom du compartiment, vous devez indiquer la hiérarchie entière avec le signe deux-points séparant chaque entrée.developers:dev1.Ici,
dev1est un compartiment sous le compartimentdevelopers.
Remarque : si aucune valeur n'est indiquée, le compartiment racine est la valeur par défaut.Le module d'extension se connecte à la région indiquée dans le fichier de configuration.
Si vous utilisez l'authentification basée sur un jeton de session, votre fichier de configuration inclut le profil désigné pour le jeton de session ainsi que le chemin du jeton. Pour vous connecter à Oracle NoSQL Database Cloud Service, vous devez sélectionner l'option de fichier de configuration et indiquer le profil approprié.
-
Avancé : vous indiquez directement les paramètres de connexion requis pour la connexion à Oracle NoSQL Database Cloud Service. Entrez les valeurs requises pour les paramètres suivants et sélectionnez ADD. Sélectionnez ensuite OK.
Table - Paramètres de connexion - Option avancée
Paramètre Description Exemple de valeur Connection Name Un nom unique, qui est donné à une spécification de connexion spécifique, est obligatoire à partir du plugin version 1.5.1. La mise à jour du champ Nom de connexion est recommandée après la mise à niveau du module d'extension à partir de la version 1.4.0 ou inférieure.
Remarque : vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.ndcs_con1Adresse Point d'accès réseau local à Oracle NoSQL Database Cloud Service. https://nosql.us-ashburn-1.oci.oraclecloud.com(pour l'identificateur de région Oracle NoSQL Database Cloud Service d'Ashburn dans la région Amérique du Nord). Reportez-vous à Régions de données et adresses de service associées pour consulter la liste des adresses de service.ID de locataire et ID utilisateur OCID de la location et OCID de l'utilisateur pour Oracle NoSQL Database Cloud Service. Reportez-vous à Emplacement d'obtention de l'OCID de location et de l'OCID de l'utilisateur dans la documentation Oracle Cloud Infrastructure. Empreinte digitale et phrase de passe (facultatif) Empreinte et phrase de passe de la clé de signature créées lors de la génération et du téléchargement de la clé de signature d'API. Reportez-vous aux ressources suivantes dans la documentation Oracle Cloud Infrastructure :
pour générer la clé de signature avec une phrase de passe facultative, reportez-vous à Procédure de génération d'une clé de signature d'API.
- Pour obtenir l'empreinte de la clé, reportez-vous à Procédure d'obtention de l'empreinte de la clé.Clé privée Clé privée générée pour l'utilisateur. Pour l'utilisateur de l'application, une clé de signature d'API doit être générée et téléchargée. Reportez-vous à Procédure de génération d'une clé de signature d'API pour générer la clé de signature avec une phrase de passe facultative. Compartiment (facultatif) OCID/nom de compartiment de votre schéma de base de données NoSQL.
Remarque : lorsque vous indiquez le nom du compartiment, vous devez indiquer la hiérarchie entière avec le signe deux-points séparant chaque entrée.developers:dev1.Ici,
dev1est un compartiment sous le compartimentdevelopers.
Remarque : si aucune valeur n'est indiquée, elle est par défaut le compartiment racine.Remarque :
-
A partir de la version 1.5.4, le module d'extension IntelliJ télécharge automatiquement le dernier kit SDK Java Oracle NoSQL et définit le chemin du kit SDK lors de la création d'une connexion.
-
Si vous mettez à jour le plug-in à partir de la version 1.4.0 ou inférieure, toutes les connexions stockées migrent vers la nouvelle version. Dans ce cas, le nom de connexion sera identique à l'adresse. Suivez l'étape ci-dessous pour modifier le nom de connexion.
-
-
Le module d'extension IntelliJ enregistre les détails de connexion dans le nom de connexion spécifié. Pour modifier les détails de la connexion, choisissez le nom de la connexion dans la liste déroulante Connexions. Cliquez sur Modifier la connexion. Vous pouvez modifier l'un des paramètres de connexion (mentionnés ci-dessus) et cliquer sur OK pour enregistrer les paramètres. Pour enlever un nom de connexion du module d'extension, choisissez-le et cliquez sur Supprimer la connexion. Une fois l'action à supprimer confirmée, le nom de connexion est supprimé du plug-in.
-
Cliquez sur l'icône Web dans l'explorateur de schémas. La liste des connexions existantes s'affiche dans la liste déroulante. Le nom de la connexion apparaît dans la fenêtre de l'outil NoSQL au format suivant :
Table - Affichage de la connexion
Option utilisée pour créer une connexion Afficher dans la fenêtre de l'outil NoSQL AdvancedConnection Name:Endpoint:Compartment Name/OCID(si autre que root)Use Configuration FileConnection Name:Configuration file path:Profile:Compartment Name/OCID(si autre que root)Choisissez la connexion et cliquez sur OK. Le module d'extension IntelliJ connecte votre projet à Oracle NoSQL Database Cloud Service et affiche son schéma dans la fenêtre de l'explorateur de schéma.
Une fois le projet lié à Oracle NoSQL Database Cloud Service, vous pouvez gérer les tables et les données dans votre schéma.
Connexion au simulateur Oracle NoSQL Database Cloud à partir d'IntelliJ
Découvrez comment connecter votre projet NoSQL au simulateur Oracle NoSQL Database Cloud à l'aide du module d'extension IntelliJ.
Procédez comme suit :
-
Téléchargez et démarrez le simulateur Oracle NoSQL Database Cloud. Reportez-vous à Téléchargement du simulateur de cloud Oracle NoSQL Database.
-
Ouvrez le projet NoSQL dans IntelliJ.
-
Cliquez sur l'icône
de la tâche dans la fenêtre Explorateur de schéma pour ouvrir la boîte Paramètres du module d'extension. -
Dans l'Explorateur de paramètres, développez Outils > Oracle NoSQL, puis cliquez sur Connexions. Vous pouvez visualiser toutes les connexions existantes pour le type de profil Cloudsim dans la liste déroulante Connexions.
-
Sélectionnez Cloudsim dans le menu déroulant pour le type de profil.
-
Cliquez sur Add Connection. Entrez les valeurs des paramètres suivants, puis cliquez sur OK.
Table - Paramètres de connexion
Paramètre Description Exemple de valeur Connection Name Un nom unique, qui est donné à une spécification de connexion spécifique, est obligatoire à partir du plugin version 1.5.1. La mise à jour du champ Nom de connexion est recommandée après la mise à niveau du module d'extension à partir de la version 1.4.0 ou inférieure.
Remarque : vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.nosql_sim1URL de service Adresse IP et port sur lesquels le simulateur Oracle NoSQL Database Cloud est exécuté. La valeur par défaut est http://localhost:8080Identificateur de locataire Identificateur unique du locataire. La valeur par défaut est exampleId. Conservez cette valeur si vous souhaitez tester les exemples. Remarque :
-
A partir de la version 1.5.4, le module d'extension IntelliJ télécharge automatiquement le dernier kit SDK Java NoSQL et définit le chemin du kit SDK lors de la création d'une connexion.
-
Si vous mettez à jour le plug-in à partir de la version 1.4.0 ou inférieure, toutes les connexions stockées migrent vers la nouvelle version. Dans ce cas, le nom de connexion sera identique à l'adresse. Suivez l'étape ci-dessous pour modifier le nom de connexion.
-
-
Le module d'extension IntelliJ enregistre les détails de connexion dans le nom de connexion spécifié. Pour modifier les détails de la connexion, choisissez le nom de la connexion dans la liste déroulante Connexions. Cliquez sur Modifier la connexion. Vous pouvez modifier l'un des paramètres de connexion (mentionnés ci-dessus) et cliquer sur OK pour enregistrer les paramètres. Pour enlever un nom de connexion du module d'extension, choisissez-le et cliquez sur Supprimer la connexion. Une fois l'action à supprimer confirmée, le nom de connexion est supprimé du plug-in.
-
Cliquez sur l'icône Web dans l'explorateur de schémas. La liste des connexions existantes s'affiche dans la liste déroulante. Le nom de la connexion apparaît dans la fenêtre de l'outil NoSQL au format suivant :
Connection Name:service Url : Tenant IdentifierChoisissez la connexion et cliquez sur OK. Le module d'extension IntelliJ connecte votre projet au simulateur Oracle NoSQL Database Cloud et affiche son schéma dans la fenêtre Explorateur de schéma.
Remarque : avant de connecter le projet au simulateur Oracle NoSQL Database Cloud, il doit être démarré et en cours d'exécution. Sinon, votre demande de connexion échoue dans IntelliJ.
Une fois le projet lié au simulateur Oracle NoSQL Database Cloud, vous pouvez gérer les tables et les données dans votre schéma.
Création d'applications à l'aide du kit SDK Java Oracle NoSQL à partir d'IntelliJ
Découvrez comment créer des applications à partir du module d'extension IntelliJ à l'aide du package SDK Java Oracle NoSQL.
Une fois que vous avez connecté au simulateur Oracle NoSQL Database Cloud ou Oracle NoSQL Database Cloud Service, vous pouvez créer des applications à l'aide du kit SDK Java Oracle NoSQL.
Dans cette rubrique, vous allez exécuter un exemple d'application disponible dans le package de kit SDK Java Oracle NoSQL pour créer une table dans le simulateur Oracle NoSQL Database Cloud ou Oracle NoSQL Database Cloud Service.
Procédez comme suit :
-
Téléchargez le dernier kit SDK Java Oracle NoSQL Database à partir de GitHub.
-
Extrayez (décompressez) le fichier téléchargé dans un référentiel local.
-
Lancez IntelliJ IDEA et ouvrez votre projet NoSQL.
-
Si vous utilisez le système de build Maven, vérifiez que vous avez ajouté les dépendances requises dans pom.xml. Pour plus de détails, reportez-vous à GitHub du kit SDK Java Oracle NoSQL.
-
A partir du répertoire du kit SDK Java Oracle NoSQL Database Cloud Service extrait, accédez au dossier
oracle-nosql-java-sdk > examples. Copiez les fichiers javaBasicTableExampleetCommondans le répertoire de votre projet NoSQL.En examinant le code, le programme
BasicExampleTablecrée une table nomméeaudienceData, ajoute deux lignes dans cette table, interroge les lignes insérées, supprime les lignes insérées et supprime la tableaudienceData. -
Avant d'exécuter le programme d'application, vous devez fournir les arguments nécessaires pour vous connecter :
a. Dans le menu, sélectionnez Exécuter > Modifier les configurations.
b. Sélectionnez Ajouter une nouvelle configuration, puis Application.
c. Dans la fenêtre qui apparaît à droite, entrez votre classe principale dans le champ Nom.
d. Sous Créer et exécuter, indiquez le chemin JDK Java et entrez la classe principale.
e. Entrez les arguments de programme requis. Sélectionnez Appliquer, puis OK.
Table - Arguments du programme
Type de connexion Arguments de programme En savoir plus Cloudsim http://localhost:8080Si vous venez de démarrer le simulateur Oracle NoSQL Database Cloud sur un port différent, vous devez remplacer 8080 par le numéro de ce port. Cloud Region [-configFile <path-to-config-file>]
Par exemple :us-ashburn-1 -configFile D:\OCI_PROP\configLe premier argument indique la région de données du service Oracle NoSQL Database Cloud Service. Le second argument transmet un fichier d'identification contenant les informations d'identification permettant de se connecter à Oracle NoSQL Database Cloud Service. Pour plus d'informations sur le contenu des fichiers de configuration, reportez-vous à Authentification de connexion à Oracle NoSQL Database.
Si vous n'indiquez pas le fichierconfig, le script utilise le constructeur par défaut pour la classeSignatureProvider, qui recherche le fichierconfigà l'adresse suivante :$HOME/.oci -
Pour exécuter ce programme, sélectionnez Exécuter ou appuyez sur Maj + 10.
Remarque : si vous souhaitez exécuter le programme à partir d'un terminal, utilisez les exemples de commande suivants :
Compilez le programme à l'aide du système de construction maven à l'aide des éléments suivants :
mvn compileExécutez le programme en fournissant les arguments suivants :
mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="<region>"Exemple :
mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="us-ashburn-1" -
Affichez la sortie dans la fenêtre de l'outil Run en bas. Vérifiez les journaux pour vous assurer que l'exécution du code a réussi. Vous pouvez voir les messages d'affichage qui indiquent la création de la table, l'insertion des lignes, etc.
Exemple de sortie :
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
Remarque : Sachant que BasicExampleTable supprime les lignes insérées et supprime la table audienceData, vous de ne pouvez pas voir cette table dans l'explorateur de schémas. Si vous voulez voir la table dans l'explorateur de schémas, commentez le code qui supprime les lignes insérées et supprime la table, puis réexécute le programme.
Gestion des tables à l'aide du module d'extension IntelliJ
Découvrez comment créer des tables et afficher leurs données dans Oracle NoSQL Database Cloud Service ou le simulateur Oracle NoSQL Database Cloud à partir de l'explorateur de schémas.
Procédez comme suit :
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône
pour recharger le schéma. -
Localisez la table sous l'identificateur du locataire, puis développez-la pour afficher les détails de colonnes, de clé primaire et d'une clé de shard qui lui sont associées. Si vous avez créé un exemple d'application comme décrit dans la rubrique Création d'applications à l'aide du kit SDK Java Oracle NoSQL à partir d'IntelliJ, vous pouvez voir la table
audienceData. -
Cliquez deux fois sur le nom de la table pour afficher ses données. Vous pouvez également cliquer sur la table à l'aide du bouton droit de la souris et sélectionner Parcourir la table.
-
Une fenêtre d'affichage d'enregistrements apparaît dans l'éditeur principal. Cliquez sur Exécuter pour exécuter la requête et afficher les données de table.
-
Pour afficher les données d'une cellule individuelle séparément, cliquez deux fois sur la cellule.
Effectuer des opérations LDD à l'aide d'IntelliJ
Vous pouvez utiliser IntelliJ pour effectuer des opérations LDD.
Certaines opérations LDD qui peuvent être effectuées à partir du module d'extension IntelliJ sont
CREATE TABLE
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Actualiser pour recharger le schéma.
-
Cliquez avec le bouton droit de la souris sur le nom de la connexion et choisissez Créer une table.
-
Dans l'invite, entrez les détails de la nouvelle table. Vous pouvez créer la table Oracle NoSQL Database en deux modes :
-
Entrée DDL simple : vous pouvez utiliser ce mode pour créer la table de manière déclarative, c'est-à-dire sans écrire d'instruction DDL.
-
Entrée DDL avancée : vous pouvez utiliser ce mode pour créer la table à l'aide d'une instruction DDL.
-
-
Vous pouvez afficher l'instruction LDD avant de la créer. Cliquez sur Afficher le DDL pour afficher l'instruction DDL formée en fonction des valeurs saisies dans les champs en mode d'entrée DDL simple. Cette instruction DDL est exécutée lorsque vous cliquez sur Create.
-
Cliquez sur Create (Créer) pour créer la table.
-
Pour créer une table enfant, cliquez avec le bouton droit de la souris sur la table souhaitée et choisissez Créer une table enfant. Vous pouvez créer une table enfant en deux modes :
-
Entrée DDL simple : vous pouvez utiliser ce mode pour créer une table enfant en saisissant simplement un nom de table avec d'autres détails requis.
-
Entrée DDL avancée : vous pouvez utiliser ce mode pour créer la table enfant à l'aide d'une instruction DDL.
Pour plus d'informations sur les tables enfant, reportez-vous à Hiérarchies de tables.
-
-
Cliquez sur Créer pour créer une table enfant.
-
Vous avez la possibilité d'afficher l'instruction LDD après avoir créé une table. Cliquez avec le bouton droit sur la table existante. Choisissez Visualiser le DDL de tableau. Pour copier l'instruction LDD, cliquez sur Copier dans le presse-papiers. Cliquez sur OK pour fermer la boîte de dialogue.
DROP TABLE
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Refresh pour recharger le schéma.
-
Cliquez avec le bouton droit de la souris sur la table à supprimer. Sélectionnez Supprimer la table.
-
Une fenêtre de confirmation apparaît. Cliquez sur OK pour confirmer l'action de déplacement.
CREATE INDEX
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Refresh pour recharger le schéma.
-
Cliquez avec le bouton droit de la souris sur la table dans laquelle l'index doit être créé. Choisissez Créer un index.
-
Dans le panneau Créer un index, vous avez la possibilité de créer un index en deux modes :
-
Création d'index basée sur un formulaire (entrée LDD simple) : entrez les détails de création d'un index sans écrire d'instruction LDD. Indiquez le nom de l'index et les colonnes à inclure dans l'index. Si la colonne est de type de données JSON, un champ supplémentaire appelé "
JSON Path to Index Field" apparaît. Entrez le chemin d'accès à l'emplacement du champ JSON et choisissez le type de données correspondant. -
Créer un index en tant qu'instruction LDD (pour l'entrée LDD avancée) : entrez une instruction LDD valide pour créer un index. Il peut également inclure un type de données complexe, par exemple un tableau, une carte et un enregistrement.
-
-
Cliquez sur Ajouter un index.
DROP INDEX
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Refresh pour recharger le schéma.
-
Cliquez sur la table cible pour afficher les colonnes répertoriées, les clés primaires, les index et les clés de shard.
-
Localisez l'index cible qui doit être supprimé et cliquez dessus avec le bouton droit de la souris. Cliquez sur Supprimer l'index.
-
Une fenêtre de confirmation apparaît. Cliquez sur OK pour confirmer l'action de déplacement.
AJOUTER UNE COLONNE
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Refresh pour recharger le schéma.
-
Cliquez avec le bouton droit de la souris sur la table dans laquelle la colonne doit être ajoutée. Choisissez Ajouter une colonne.
-
Vous pouvez ajouter de nouveaux COLONNES en deux modes :
-
Entrée DDL simple : vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes sans écrire d'instruction DDL. Dans le cas d'un fichier binaire ou fixe, sélectionnez le type de données
Binary. Pour les fichiers binaires fixes, entrez la taille du fichier dans le champSizeet conservez la valeur NULL dans le cas d'un type de données binaires. -
Entrée LDD avancée : vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes à la table en fournissant une instruction LDD valide. Ce mode peut également créer des colonnes de type de données complexe. Par exemple, tableau, carte ou enregistrement et également au format imbriqué.
-
-
Dans les deux modes, indiquez le nom de la colonne et définissez la colonne avec ses propriétés - type de données, valeur par défaut et si elle peut être NULL.
-
Cliquez sur Ajouter une colonne.
SUPPRIMER LA COLONNE
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Refresh pour recharger le schéma.
-
Cliquez sur la table cible pour afficher les colonnes répertoriées, les clés primaires, les index et les clés de shard.
-
Localisez la colonne cible à supprimer et cliquez dessus avec le bouton droit de la souris. Cliquez sur Supprimer la colonne.
-
Une fenêtre de confirmation apparaît. Cliquez sur OK pour confirmer l'action de déplacement.
Geler/annuler le gel du schéma
Vous devez figer le schéma d'une table singleton avant de la transformer en table active globale. Une fois le schéma figé, vous ne pouvez plus le modifier. Pour figer le schéma d'une table singleton, elle doit comporter au moins une colonne JSON. Cliquez sur la table avec le bouton droit de la souris et choisissez Geler/Dégeler. Une fois la confirmation effectuée, le schéma de la table est figé. De même, pour dégeler le schéma de la table, cliquez avec le bouton droit de la souris sur la table et choisissez Geler/Dégeler. Une fois la confirmation effectuée, le schéma de la table redevient mutable, ce qui signifie que le schéma peut être modifié.
Remarque : les répliques régionales de table doivent être supprimées (la table doit être une table singleton) pour que l'opération de dégel puisse être effectuée.
Gérer les répliques
Reportez-vous à Répliques de table régionales pour comprendre ce que sont les répliques et comment convertir une table singleton en table active globale en ajoutant des répliques régionales.
Ajouter une réplique
Vous pouvez ajouter une réplique régionale à une table singleton, en faire une table active globale ou ajouter une réplique à une table active globale existante. La table doit être figée avant d'y ajouter une réplique. Cliquez avec le bouton droit de la souris sur la table et choisissez Ajouter une réplique dans Répliques régionales. Vous pouvez choisir une réplique dans la liste déroulante de la région de réplication. Vous pouvez choisir les unités de lecture et d'écriture de la table dans cette région de réplication. La valeur de stockage sur disque de la table ne peut pas être modifiée/modifiée dans la réplique. Cliquez sur Ajouter une réplique. La table est répliquée dans la région.
Visualiser la réplique
Cliquez avec le bouton droit de la souris sur la table et choisissez Afficher les répliques dans Répliques régionales. Vous pouvez afficher la liste des répliques de la table.
Supprimer les répliques
Cliquez avec le bouton droit de la souris sur la table et choisissez Supprimer les répliques dans Répliques régionales. Cliquez sur Ajouter et choisissez la réplique à enlever. Vous pouvez choisir plusieurs répliques à supprimer à la fois. Cliquez sur Enlever pour enlever la réplique de la liste des répliques à supprimer. Cliquez sur Supprimer les répliques. Une fois la confirmation effectuée, la table est supprimée de toutes les répliques sélectionnées.
Modifier la capacité réservée
Vous pouvez modifier la capacité réservée et le modèle d'utilisation d'une table. Cliquez sur la table avec le bouton droit de la souris et choisissez Modifier la capacité réservée. Vous pouvez choisir l'un des deux modes de capacité : Capacité provisionnée ou Capacité à la demande. Modifiez les valeurs, puis cliquez sur Appliquer les modifications.
Si la table modifiée est une table active globale :
-
La modification de la capacité de stockage a une portée globale (la modification d'une réplique de table régionale est automatiquement propagée à toutes les répliques de table régionales).
-
Le changement d'unités de lecture, d'unités d'écriture ou le changement de mode de capacité de On-Demand à provisionné ou vice-versa a une portée locale (changement uniquement dans la réplique de table régionale où il est lancé).
Effectuer des opérations LMD à l'aide d'IntelliJ
Vous pouvez ajouter des données, modifier des données existantes et interroger des données à partir de tables à l'aide du plug-in IntelliJ.
Insérer les données
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Actualiser pour recharger le schéma.
-
Cliquez avec le bouton droit de la souris sur la table dans laquelle une ligne doit être insérée. Sélectionnez Insérer une ligne.
-
Dans le panneau Insérer une ligne, entrez les détails d'insertion d'une nouvelle ligne. Vous pouvez insérer une nouvelle ligne dans deux modes :
-
Entrée simple : vous pouvez utiliser ce mode pour insérer la nouvelle ligne sans écrire d'instruction LMD. Ici, une entrée de champs de ligne basée sur un formulaire est chargée, dans laquelle vous pouvez saisir la valeur de chaque champ de la ligne.
-
Pour le type de données binaires, la chaîne saisie doit être un codage Base64 valide d'une valeur binaire ou sélectionnez le fichier à télécharger dans la colonne souhaitée.
-
Pour le type de données binaires fixe, la chaîne saisie doit être un codage Base64 valide d'une valeur binaire ou charger le fichier de taille défini lors de la création de la colonne particulière.
Remarque : le format de fichier que vous téléchargez pour le type de données binaires doit uniquement avoir l'extension
.bin. -
-
Entrée JSON avancée : vous pouvez utiliser ce mode pour insérer une nouvelle ligne dans la table en fournissant un objet JSON contenant le nom de la colonne et sa valeur correspondante en tant que paires clé-valeur. L'entrée peut également être de type de données complexe, c'est-à-dire tableau, carte, enregistrement.
-
-
Cliquez sur Insérer une ligne.
Modifier les données - UPDATE ROW/DELETE ROW
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Actualiser pour recharger le schéma.
-
Cliquez avec le bouton droit de la souris sur la table dans laquelle une ligne doit être insérée. Sélectionnez Parcourir la table.
-
Dans la zone de texte de gauche, entrez l'instruction SQL permettant d'extraire les données de votre table. Cliquez sur Exécuter pour exécuter l'instruction.
-
Pour afficher les données d'une cellule séparément, cliquez sur la cellule du tableau.
-
Pour effectuer des opérations LMD telles que Mettre à jour et Supprimer une ligne, cliquez avec le bouton droit de la souris sur la ligne concernée. Choisissez votre option dans le menu contextuel qui s'affiche.
-
Supprimer la ligne : une fenêtre de confirmation apparaît. Cliquez sur OK pour supprimer la ligne.
-
Mettre à jour la ligne : une fenêtre HTML distincte s'ouvre et affiche les noms de colonne et les valeurs correspondantes. Vous pouvez entrer de nouvelles valeurs pour les données de ligne dans deux modes : entrée de champs de ligne basée sur un formulaire (entrée DDL simple) et Approvisionner le contenu des lignes en tant qu'objet JSON (entrée DDL avancée). En mode d'entrée LDD avancé, les données JSON sont présentées sous forme d'arborescence pour simplifier l'affichage et la mise à jour.
Sélectionnez Exécuter pour actualiser les données mises à jour et les afficher.
Remarque : Dans n'importe quelle ligne, les colonnes PRIMARY KEY et GENERATED TOUJOURS AS IDENTITY ne peuvent pas être mises à jour.
-
Tables de requête
-
Localisez l'explorateur de schémas, puis cliquez sur l'icône Actualiser pour recharger le schéma.
-
Cliquez sur la table avec le bouton droit de la souris et choisissez Parcourir la table.
-
Dans la zone de texte de gauche, entrez l'instruction SELECT permettant d'extraire des données de votre table. Lorsque vous commencez à saisir la requête, vous êtes invité à saisir la liste des mots possibles pour compléter automatiquement l'instruction SQL. Tous les mots-clés SQL et noms de colonne de la table donnée sont fournis dans l'invite permettant de terminer automatiquement l'instruction SQL.
-
La syntaxe SQL est mise en évidence dans chaque requête, ce qui permet une meilleure expérience d'écriture SQL.
-
Vous pouvez formater la requête pour améliorer sa lisibilité. Sélectionnez votre requête, cliquez avec le bouton droit de la souris et sélectionnez Préparer. La requête est formatée et les lignes sont encapsulées pour améliorer la lisibilité.
-
Pour exécuter la requête, cliquez sur Exécuter. Les données correspondantes sont extraites de la table. Lorsque vous cliquez deux fois sur les données extraites, les données de colonne s'ouvrent dans une nouvelle fenêtre. Toutes les données JSON sont affichées dans une arborescence dans la nouvelle fenêtre. Cliquez sur + pour développer ou sur - pour réduire la structure de l'arborescence. Cliquez sur Ctrl ^F dans la nouvelle fenêtre pour activer l'option de recherche, qui permet de rechercher n'importe quelle valeur dans l'arborescence JSON. Cliquez sur la flèche vers le haut ou vers le bas pour passer à l'occurrence de recherche précédente ou suivante, respectivement.
-
Cliquez avec le bouton droit de la souris sur une ligne et cliquez sur Télécharger le JSON. Dans la boîte de dialogue, accédez à l'emplacement d'enregistrement du fichier et cliquez sur Enregistrer. Une fois le fichier téléchargé, une notification s'affiche en bas à droite de l'écran. Cliquez sur le lien pour ouvrir le fichier téléchargé. Le fichier s'ouvre dans le navigateur.
Remarque : dans le cas d'un type de données binaire, cliquez simplement sur Télécharger l'objet binaire dans la sortie.
-
Cliquez sur Télécharger le résultat de la requête pour télécharger toutes les données du résultat de la requête. Dans la boîte de dialogue, accédez à l'emplacement d'enregistrement du fichier et cliquez sur Enregistrer. Dans le cas de plusieurs lignes, une barre de progression apparaît en bas à droite de l'écran pour afficher le nombre de lignes téléchargées en temps réel. Une fois le fichier téléchargé, une notification s'affiche en bas à droite de l'écran. Cliquez sur le lien pour ouvrir le fichier téléchargé. Le fichier s'ouvre dans le navigateur.
-
Cliquez sur Afficher le plan de requête pour visualiser le plan d'exécution de la requête.
-
Cliquez sur la liste déroulante Commandes précédentes pour afficher les 20 principales instructions SQL récemment exécutées qui ont fourni une sortie.
Remarque : la liste déroulante affiche uniquement les instructions SQL liées à la table sur laquelle vous travaillez.
Explorateur de schémas
Dans la fenêtre Explorateur de schémas, vous pouvez vérifier le type de données complet d'une colonne particulière. Localisez la colonne particulière et le type de données est suivi du nom de la colonne.
Exigences d'autorisation pour le module d'extension IntelliJ
Découvrez les exigences en matière d'autorisation requises dans Oracle NoSQL Database Cloud Service pour utiliser le module d'extension IntelliJ.
Le module d'extension IntelliJ vous permet d'accéder à Oracle NoSQL Database Cloud Service à l'aide des méthodes d'authentification par clé d'API ou par jeton de session. L'accès aux ressources dans Oracle NoSQL Database Cloud Service, telles que les tables, les tablespaces et les API, est géré via des stratégies Identity and Access Management (IAM). Ainsi, seuls les utilisateurs authentifiés, qui sont membres de groupes disposant des droits d'accès de table appropriés à inspecter, lire, utiliser ou gérer dans un compartiment donné, peuvent interagir avec ces ressources. Pour plus d'informations, voir Gestion de l'accès aux tables NDCS.
Lorsque vous utilisez le module d'extension IntelliJ pour gérer les tables dans les tables Oracle NoSQL Database Cloud Service, vos droits d'accès IAM effectifs déterminent les ressources à partir desquelles vous pouvez lire ou écrire. Si un utilisateur tente une action pour laquelle il n'a pas d'autorisation, le module d'extension IntelliJ renvoie l'erreur d'autorisation correspondante, telle que fournie par OCI IAM.
Par exemple, OCI IAM refuse toute opération d'insertion sur une table Oracle NoSQL Database Cloud Service si votre groupe d'utilisateurs dispose uniquement du droit d'accès en lecture pour les tables NoSQL. Le message d'erreur suivant s'affiche dans le plug-in IntelliJ :
Error executing Insert Row : Authorization failed or requested resource not found (5.4.18)