Utilisation du module d'extension IntelliJ pour le développement
Parcourir les tables et exécuter des requêtes sur l'instance ou le simulateur Oracle NoSQL Database Cloud Service à partir de IntelliJ.
- Affichez les tables dans une structure arborescente 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 d'une table.
- Afficher les données de colonne dans une structure JSON bien formatée.
- Créer des tables à l'aide d'une entrée de schéma basée sur un formulaire ou fournir des instructions DDL.
- Supprimer des tables.
- Ajoutez de nouvelles colonnes à l'aide d'une entrée basée sur un formulaire ou fournissez des instructions DDL.
- Supprimer les colonnes.
- Créer des index.
- Supprimer des 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 DML pour mettre à jour, insérer et supprimer des données d'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 ou le simulateur Oracle NoSQL Database Cloud Service.
Création d'un projet NoSQL dans IntelliJ
Découvrez comment créer un projet NoSQL dans IntelliJ.
- Ouvrez IntelliJ IDEA. Cliquez sur File > New > Project.
- Entrez une valeur pour Nom de projet et Emplacement de projet, puis cliquez sur Créer.
- Une fois le projet NoSQL créé, vous pouvez parcourir les exemples de fichiers java à partir de la fenêtre Explorateur de projets.
- 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 notificationapparaît dans la barre d'outils de droite.
Connexion à Oracle NoSQL Database Cloud Service à partir de IntelliJ
Découvrez comment connecter votre projet NoSQL à Oracle NoSQL Database Cloud Service à l'aide du plug-in IntelliJ.
Connexion au module Oracle NoSQL Database Cloud à partir de IntelliJ
Découvrez comment connecter votre projet NoSQL au simulateur Oracle NoSQL Database Cloud à l'aide du module d'extension IntelliJ.
Gestion des tables à l'aide du module d'extension IntelliJ
Découvrez comment créer des tables et afficher les données de table dans Oracle NoSQL Database Cloud Service ou dans le simulateur Oracle NoSQL Database Cloud à partir de IntelliJ.
Effectuer des opérations DDL à l'aide de IntelliJ
Vous pouvez utiliser IntelliJ pour effectuer des opérations DDL.
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 une table de façon déclarative, c'est-à-dire sans écrire d'instruction DDL.
- **Entrée DDL avancée** : Vous pouvez utiliser ce mode pour créer une table à l'aide d'une instruction DDL.
- Vous pouvez afficher l'instruction LDD avant de la créer. Cliquez sur Afficher 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 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 entrant simplement un nom de table avec d'autres détails requis.
- **Entrée DDL avancée** : Vous pouvez utiliser ce mode pour créer une table enfant à l'aide d'une instruction DDL.
Pour plus de détails sur les tables enfant, reportez-vous à Hiérarchies de tables dans le guide Oracle NoSQL Database Cloud Service.
- 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. Faites un clic droit sur la table existante. Choisissez Visualiser le DDL de table. Pour copier l'instruction DDL, cliquez sur Copy to Clipboard. Cliquez sur OK pour fermer la boîte de dialogue.
SUPPRIMER LA TABLE
- Localisez Schema Explorer, puis cliquez sur l'icône Refresh pour recharger le schéma.
- Cliquez avec le bouton droit de la souris sur la table que vous souhaitez supprimer. Choisissez Supprimer la table.
- Une fenêtre de confirmation apparaît. Cliquez sur OK pour confirmer l'action de suppression.
CRÉER UN INDEX
- Localisez Schema Explorer, 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 pouvez créer un index en deux modes :
- **Création d'index basée sur un formulaire (entrée LDD simple)** : entrez les détails permettant de créer 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 DDL (pour l'entrée DDL avancée)** : Entrez une instruction DDL valide pour créer un index. Elle peut également inclure des types de données complexes (tableau, carte et enregistrement).
- **Création d'index basée sur un formulaire (entrée LDD simple)** : entrez les détails permettant de créer 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é "
- Cliquez sur Ajouter un index.
SUPPRIMER L'INDEX
- Localisez Schema Explorer, puis cliquez sur l'icône Refresh pour recharger le schéma.
- Cliquez sur la table cible pour afficher les colonnes répertoriées, à savoir Primary Keys, Indexes et Shard Keys.
- Localisez l'index cible à supprimer et cliquez dessus avec le bouton droit de la souris. Cliquez sur Supprimer un index.
- Une fenêtre de confirmation apparaît. Cliquez sur OK pour confirmer l'action de suppression.
AJOUTER UNE COLONNE
- Localisez Schema Explorer, 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. Cliquez sur Ajouter une colonne.
- Vous pouvez ajouter de nouvelles COLONNES en deux modes :
- Entrée DDL simple : vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes sans écrire d'instruction DDL. En cas de fichier binaire ou binaire fixe, sélectionnez le type de données
Binary
. Pour les fichiers binaires fixes, entrez la taille du fichier dans le champSize
et conservez la valeur NULL dans le cas d'un type de données binaires. - Entrée DDL avancée : vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes à la table en fournissant une instruction DDL 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é.
- Entrée DDL simple : vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes sans écrire d'instruction DDL. En cas de fichier binaire ou binaire fixe, sélectionnez le type de données
- Dans les deux modes, indiquez le nom de la colonne et définissez-la avec ses propriétés : type de données, valeur par défaut et possibilité d'affectation de valeur NULL.
- Cliquez sur Ajouter une colonne.
SUPPRIMER UNE COLONNE
- Localisez Schema Explorer, puis cliquez sur l'icône Refresh pour recharger le schéma.
- Cliquez sur la table cible pour afficher les colonnes répertoriées, à savoir Primary Keys, Indexes et Shard Keys.
- Localisez la colonne cible à supprimer et cliquez dessus avec le bouton droit de la souris. Cliquez sur Supprimer (Drop Column).
- Une fenêtre de confirmation apparaît. Cliquez sur OK pour confirmer l'action de suppression.
Figer/UnFreeze Schéma
Remarques :
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.
Vous pouvez ajouter une réplique régionale à une table singleton, pour en faire une table active globale ou ajouter une réplique à une table active globale existante. La table doit être gelé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.
Cliquez avec le bouton droit de la souris sur la table et choisissez Visualiser les répliques dans Répliques régionales. Vous pouvez afficher la liste des répliques de la table.
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 en même temps. Cliquez sur Enlever pour enlever la réplique de la liste des répliques à supprimer. Cliquez sur Supprimer des 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 avec le bouton droit de la souris sur la table 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 et cliquez sur Appliquer les modifications.
- 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égionale).
- La modification des unités de lecture, des unités d'écriture ou du mode de capacité de On-Demand à provisionné ou vice versa a une portée locale (modification uniquement dans la réplique de table régionale où elle est lancée).
Effectuer des opérations DML à l'aide de IntelliJ
Vous pouvez ajouter des données, modifier des données existantes et interroger des données à partir de tables à l'aide du module d'extension IntelliJ.
Insérer des données
- Localisez Schema Explorer, 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 une ligne doit être insérée. Choisissez 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 en deux modes :
- Entrée simple : vous pouvez utiliser ce mode pour insérer la nouvelle ligne sans écrire d'instruction LMD. 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 binaire, la chaîne saisie doit être un encodage 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 binaire fixe, la chaîne saisie doit être un encodage Base64 valide d'une valeur binaire ou télécharger le fichier de taille définie lors de la création de la colonne particulière.
Remarques :
Le format de fichier que vous téléchargez pour le type de données binaire ne doit comporter que 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 colonne et la valeur correspondante en tant que paires clé-valeur. L'entrée peut également être de type de données complexe (tableau, carte, enregistrement).
- Entrée simple : vous pouvez utiliser ce mode pour insérer la nouvelle ligne sans écrire d'instruction LMD. 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.
- Cliquez sur Insérer une ligne.
Modifier les données - UPDATE ROW/DELETE ROW
- Localisez Schema Explorer, 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 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 la requête.
- Pour afficher les données d'une cellule individuelle 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 : un panneau HTML distinct s'ouvre sous les lignes répertoriées, contenant les noms de colonne et la valeur correspondante dans une entrée basée sur un formulaire et en tant qu'objet de paire de clés JSON. Vous pouvez choisir l'une des deux méthodes et fournir de nouvelles valeurs.
Remarques :
Dans n'importe quelle ligne, les colonnes PRIMARY KEY et GENERATED ALWAYS AS IDENTITY ne peuvent pas être mises à jour.
Tables de requête
- Localisez Schema Explorer, puis cliquez sur l'icône Refresh pour recharger le schéma.
- Faites un clic droit sur la table et choisissez Parcourir la table.
- Dans la zone de texte de gauche, entrez l'instruction SELECT pour extraire les données de votre table.
- Cliquez sur Exécuter pour exécuter la requête. Les données correspondantes sont extraites de la table.
- Cliquez avec le bouton droit de la souris sur une ligne et cliquez sur Télécharger 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 apparaît en bas à droite de l'écran. Cliquez sur le lien pour ouvrir le fichier téléchargé. Le fichier s'ouvre dans le navigateur.
- 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 s'affiche 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 apparaît 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 premières instructions SQL récemment exécutées qui avaient fourni une sortie.
Remarques :
La liste déroulante affiche uniquement les instructions SQL associées à la table sur laquelle vous travaillez.
Explorateur de schémas
- Dans la fenêtre Schema Explorer, 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.
Utilisation du module d'extension IntelliJ pour le développement