Utilisation du plugiciel IntelliJ pour le développement
Parcourez les tables et exécutez des interrogations sur votre instance Oracle NoSQL Database Cloud Service ou le simulateur Oracle NoSQL Database Cloud provenant d'IntelliJ.
Le plugiciel IntelliJ d'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 structure arborescente bien définie à l'aide de l'explorateur de tables.
-
Voir les informations sur les colonnes, les index, les clés primaires et les clés de partition pour une table.
-
Voir les données de colonne dans une structure JSON au format correct.
-
Créez des tables à l'aide d'une entrée de schéma basée sur un formulaire ou fournissez des instructions LDD.
-
Supprimer des tables.
-
Ajoutez de nouvelles colonnes à l'aide d'une entrée basée sur un formulaire ou fournissez des instructions LDD.
-
Supprimer des colonnes.
-
Créer des index.
-
Supprimer les index.
-
Exécuter les interrogations SQL SELECT sur une table et voir les résultats des interrogations sous forme de tableau.
-
Exécuter des instructions LMD pour mettre à jour, insérer et supprimer des données d'une table.
Cet article contient les rubriques suivantes :
Configuration du plugiciel IntelliJ
Voyez comment configurer le plugiciel IntelliJ pour l'instance Oracle NoSQL Database Cloud Service ou le simulateur Oracle NoSQL Database Cloud.
Conditions requises : :
Installez IntelliJ IDEA. Vous pouvez télécharger IntelliJ IDEA à partir de JetBrains.
Procédure :
Vous pouvez installer le plugin comme suit :
-
Ouvrez la page Oracle NoSQL DatabaseConnector, Référentiel de plugiciels 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 Comment installer 'Oracle NoSQL Database Connector'.
Redémarrez l'IDE. L'icône Explorateur de schéma s'affiche dans le panneau de droite.
Après avoir configuré votre plugiciel IntelliJ, créez un projet NoSQL et connectez-le à votre instance Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud.
Création d'un projet NoSQL dans IntelliJ
Voyez comment créer un projet NoSQL dans IntelliJ.
Effectuez les étapes suivantes :
- Ouvrez IntelliJ IDEA. Cliquez sur File (Fichier) > New (Nouveau) > Project (Projet).
- Entrez une valeur dans les champs Nom du projet et Emplacement du projet. Sélectionnez Créer.
- Sélectionnez un système de compilation et un chemin JDK.
- IntelliJ crée votre répertoire de projet NoSQL, qui comprend un exemple de fichier Java. Si vous avez sélectionné Maven comme système de création, votre répertoire de projet inclut également un fichier pom.xml.
- Assurez-vous que le service d'avis est activé pour votre projet Oracle NoSQL. Pour activer le service d'avis, appuyez sur
Alt+\pour ouvrir le menu principal. Cliquez sur Voir, développez Fenêtres d'outils > Avis. Une icône d'avis
s'affiche dans la barre d'outils de droite.
Après avoir créé un projet NoSQL dans IntelliJ, vous pouvez connecter votre projet à Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud.
Connexion au service Oracle NoSQL Database Cloud à partir d'IntelliJ
Voyez comment connecter votre projet NoSQL au service Oracle NoSQL Database Cloud à l'aide du plugiciel IntelliJ.
Effectuez les étapes suivantes :
-
Ouvrez votre projet NoSQL dans IntelliJ.
-
Cliquez sur l'icône de tâche
dans la fenêtre Schema Explorer (Explorateur de schéma) pour ouvrir la boîte de dialogue Settings (Paramètres) du plugiciel. -
Développez Outils > Oracle NoSQL dans l'explorateur de paramètres, puis cliquez sur Connexions.
-
Sélectionnez Cloud dans le menu déroulant du type de profil. Vous pouvez voir toutes les connexions existantes pour le type de profil Cloud dans la liste déroulante Connexions.
-
Cliquez sur Ajouter une connexion. Vous disposez de deux options pour créer une connexion.
-
Utilisation du fichier de configuration : Vous spécifiez le chemin d'accès au 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 locataire, l'ID utilisateur, l'empreinte numérique, la phrase secrète et le chemin de la clé privée.
Entrez les valeurs requises pour les paramètres de connexion suivants et sélectionnez ADD. Sélectionnez ensuite OK.
Tableau - Option de fichier de configuration des paramètres de connexion
Paramètre Description Exemple de valeur Nom de connexion Un nom unique, donné à une spécification de connexion spécifique, est obligatoire à partir de la version 1.5.1 du plugiciel. La mise à jour du champ Nom de la connexion est recommandée après la mise à niveau du plugiciel à partir de la version 1.4.0 ou inférieure.
Note : Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.ndcs_con1Fichier de configuration Chemin d'accès à 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, voir la méthode User Principals dans Authentification pour la connexion à Oracle NoSQL Database. ~/.oci/configProfil Nom du profil.
Note : 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 du compartiment pour votre schéma de base de données NoSQL.
Note : Lorsque vous spécifiez le nom du compartiment, vous devez spécifier la hiérarchie entière avec un deux-points séparant chaque entrée.developers:dev1.Ici
dev1est un compartiment sous le compartimentdevelopers.
Note : Si aucune valeur n'est indiquée, le compartiment racine est utilisé par défaut.Le plugiciel se connecte à la région spécifié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 spécifier le profil approprié.
-
Avancé : Vous spécifiez 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.
Tableau - Option avancée Paramètres de connexion
Paramètre Description Exemple de valeur Nom de connexion Un nom unique, donné à une spécification de connexion spécifique, est obligatoire à partir de la version 1.5.1 du plugiciel. La mise à jour du champ Nom de la connexion est recommandée après la mise à niveau du plugiciel à partir de la version 1.4.0 ou inférieure.
Note : Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.ndcs_con1Point d'extrémité Point d'accès au réseau régional pour Oracle NoSQL Database Cloud Service. https://nosql.us-ashburn-1.oci.oraclecloud.com(pour l'identificateur de région Ashburn Oracle NoSQL Database Cloud Service dans la région Amérique du Nord). Voir Régions de données et points d'extrémité de service associés pour obtenir la liste des points d'extrémité de service.ID locataire et ID utilisateur OCID de la location et OCID de l'utilisateur pour Oracle NoSQL Database Cloud Service. Voir Où obtenir l'OCID de la location et l'OCID de l'utilisateur dans la documentation sur Oracle Cloud Infrastructure. Empreinte digitale et phrase secrète (facultatif) Empreinte numérique et phrase secrète de la clé de signature créées lors de la génération et du chargement de la clé de signature d'API. Voir les ressources suivantes dans la documentation sur Oracle Cloud Infrastructure :
- Pour générer la clé de signature avec une phrase secrète facultative, voir Comment générer une clé de signature d'API.
- Pour obtenir l'empreinte numérique de la clé, voir Comment obtenir l'empreinte numérique de la clé.Private Key (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 chargée. Voir Générer une clé de signature d'API pour savoir comment générer la clé de signature avec une phrase secrète facultative. Compartiment (facultatif) OCID/nom du compartiment pour votre schéma de base de données NoSQL.
Note : Lorsque vous spécifiez le nom du compartiment, vous devez spécifier la hiérarchie entière avec un deux-points séparant chaque entrée.developers:dev1.Ici
dev1est un compartiment sous le compartimentdevelopers.
Note : Si aucune valeur n'est indiquée, le compartiment racine est utilisé par défaut.Note :
-
À partir de la version 1.5.4, le plugiciel IntelliJ télécharge automatiquement la dernière trousse SDK Java pour Oracle NoSQL et définit le chemin de la trousse SDK lors de la création d'une connexion.
-
Si vous mettez à jour le plugiciel à 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 la connexion sera identique au point d'extrémité. Suivez l'étape ci-dessous pour modifier le nom de la connexion.
-
-
Le plugiciel IntelliJ enregistre les détails de connexion dans le nom de connexion indiqué. Pour modifier les détails de la connexion, sélectionnez 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 supprimer un nom de connexion du plugiciel, sélectionnez-le et cliquez sur Supprimer la connexion. Une fois que vous avez confirmé l'action à supprimer, le nom de la connexion est supprimé du plugiciel.
-
Cliquez sur l'icône Web dans l'explorateur de schéma. La liste des connexions existantes s'affiche dans la liste déroulante. Le nom de la connexion sera affiché dans la fenêtre d'outil NoSQL dans le format suivant :
Table - Affichage de connexion
Option utilisée pour créer une connexion Afficher dans la fenêtre d'outils 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)Sélectionnez la connexion et cliquez sur OK. Le plugiciel IntelliJ connecte votre projet à Oracle NoSQL Database Cloud Service et affiche son schéma dans la fenêtre Explorateur de schéma.
Une fois que vous avez connecté votre projet au service Oracle NoSQL Database Cloud Service, vous pouvez gérer les tables et les données de votre schéma.
Connexion au simulateur Oracle NoSQL Database Cloud à partir d'IntelliJ
Voyez comment connecter votre projet NoSQL au simulateur Oracle NoSQL Database Cloud à l'aide du plugiciel IntelliJ.
Effectuez les étapes suivantes :
-
Téléchargez et démarrez le simulateur Oracle NoSQL Database Cloud. Voir Téléchargement du simulateur Oracle NoSQL Database Cloud.
-
Ouvrez votre projet NoSQL dans IntelliJ.
-
Cliquez sur l'icône de tâche
dans la fenêtre Schema Explorer (Explorateur de schéma) pour ouvrir la boîte de dialogue Settings (Paramètres) du plugiciel. -
Développez Outils > Oracle NoSQL dans l'explorateur de paramètres, puis cliquez sur Connexions. Vous pouvez voir toutes les connexions existantes pour le type de profil Cloudsim dans la liste déroulante Connexions.
-
Sélectionnez Cloudsim dans le menu déroulant du type de profil.
-
Cliquez sur Ajouter une connexion. Entrez des valeurs pour les paramètres de connexion suivants, puis cliquez sur OK.
Table - Paramètres de connexion
Paramètre Description Exemple de valeur Nom de connexion Un nom unique, donné à une spécification de connexion spécifique, est obligatoire à partir de la version 1.5.1 du plugiciel. La mise à jour du champ Nom de la connexion est recommandée après la mise à niveau du plugiciel à partir de la version 1.4.0 ou inférieure.
Note : Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.nosql_sim1URL du 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 pour tester les exemples. Note :
-
À partir de la version 1.5.4, le plugiciel IntelliJ télécharge automatiquement la dernière trousse SDK Java NoSQL et définit le chemin de la trousse SDK lors de la création d'une connexion.
-
Si vous mettez à jour le plugiciel à 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 la connexion sera identique au point d'extrémité. Suivez l'étape ci-dessous pour modifier le nom de la connexion.
-
-
Le plugiciel IntelliJ enregistre les détails de connexion dans le nom de connexion indiqué. Pour modifier les détails de la connexion, sélectionnez 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 supprimer un nom de connexion du plugiciel, sélectionnez-le et cliquez sur Supprimer la connexion. Une fois que vous avez confirmé l'action à supprimer, le nom de la connexion est supprimé du plugiciel.
-
Cliquez sur l'icône Web dans l'explorateur de schéma. La liste des connexions existantes s'affiche dans la liste déroulante. Le nom de la connexion sera affiché dans la fenêtre d'outil NoSQL dans le format suivant :
Connection Name:service Url : Tenant IdentifierSélectionnez la connexion et cliquez sur OK. Le plugiciel IntelliJ connecte votre projet au simulateur Oracle NoSQL Database Cloud et il affiche son schéma dans la fenêtre Explorateur de schéma.
Note : Avant de connecter votre projet au simulateur Oracle NoSQL Database Cloud, celui-ci doit avoir démarré et en cours d'exécution. Sinon, votre demande de connexion échoue dans IntelliJ.
Une fois que vous avez connecté votre projet au simulateur Oracle NoSQL Database Cloud, vous pouvez gérer les tables et les données de votre schéma.
Création d'applications à l'aide de la trousse SDK Java pour Oracle NoSQL à partir d'IntelliJ
Voyez comment créer des applications à partir du plugiciel IntelliJ à l'aide de l'ensemble de trousse SDK Java pour Oracle NoSQL.
Après vous être connecté au simulateur Oracle NoSQL Database Cloud ou au service Oracle NoSQL Database Cloud Service, vous pouvez créer des applications à l'aide de la trousse SDK Java pour Oracle NoSQL.
Dans cette rubrique, vous allez exécuter un exemple d'application disponible dans l'ensemble de trousse SDK Java pour Oracle NoSQL pour créer une table dans le simulateur Oracle NoSQL Database Cloud ou Oracle NoSQL Database Cloud Service.
Effectuez les étapes suivantes :
-
Téléchargez la dernière trousse SDK Java pour Oracle NoSQL Database à partir de GitHub.
-
Extraire (décompresser) 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 compilation Maven, assurez-vous d'avoir ajouté les dépendances requises dans pom.xml. Pour plus de détails, voir GitHub sur la trousse SDK Java pour Oracle NoSQL.
-
Dans le répertoire de la trousse SDK Java pour Oracle NoSQL Database Cloud Service extrait, naviguez jusqu'au dossier
oracle-nosql-java-sdk > examples. Copiez les fichiers javaBasicTableExampleetCommondans le répertoire de projet NoSQL.Le programme
BasicExampleTablecrée une table nomméeaudienceData, ajoute deux rangées dans cette table, interroge les rangées insérées, les supprime, puis supprime définitivement 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 s'affiche à droite, entrez votre classe principale dans le champ Nom.
j. Sous Créer et exécuter, spécifiez le chemin JDK Java et entrez la classe principale.
e. Entrez les arguments de programme requis. Sélectionnez Appliquer, puis OK.
Table - Arguments de programme
Connexion Type (Type de connexion) Arguments du programme Informations supplémentaires Cloudsim http://localhost:8080Si vous avez démarré le simulateur Oracle NoSQL Database Cloud sur un port différent, vous devez remplacer 8080 par ce numéro de 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 deuxième argument transmet un fichier de configuration contenant les données d'identification pour la connexion à Oracle NoSQL Database Cloud Service. Pour plus d'informations sur le contenu du fichier de configuration, voir Authentification pour la connexion à Oracle NoSQL Database.
Si vous ne spécifiez pas le fichierconfig, le script utilise le constructeur par défaut de la classeSignatureProvider, qui recherche le fichierconfigà l'adresse :$HOME/.oci -
Pour exécuter ce programme, sélectionnez Exécuter ou appuyez sur Maj + 10.
Note : Si vous voulez exécuter le programme à partir d'un terminal, utilisez les exemples de commandes suivants :
Compilez le programme à l'aide du système de construction maven en utilisant :
mvn compileExécutez le programme en fournissant les arguments du programme :
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 d'outil Exécuter en bas. Vérifiez les journaux pour vérifier que l'exécution du code a réussi. Vous pouvez voir les messages affichés qui indiquent la création de la table, l'insertion de rangées, 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
Note : Comme BasicExampleTable supprime les rangées insérées et la table audienceData, vous ne pouvez pas la voir dans l'explorateur de schéma. Pour voir la table dans l'explorateur de schéma, mettez en commentaire le code qui supprime les rangées insérées et la table, puis exécutez de nouveau le programme.
Gestion des tables à l'aide du plugiciel IntelliJ
Voyez comment créer des tables et voir des données de table dans Oracle NoSQL Database Cloud Service ou le simulateur Oracle NoSQL Database Cloud à partir de l'explorateur de schéma.
Effectuez les étapes suivantes :
-
Localisez l'explorateur de schéma et cliquez sur l'icône
pour charger de nouveau le schéma. -
Localisez votre table sous votre identificateur de locataire, puis développez-la pour voir ses colonnes, sa clé primaire et les détails de la clé de partition. Si vous avez créé un exemple d'application comme décrit dans la rubrique Création d'applications à l'aide de la trousse SDK Java Oracle NoSQL à partir d'IntelliJ, vous pourrez voir la table
audienceData. -
Cliquez deux fois sur le nom de la table pour voir ses données. Vous pouvez également cliquer avec le bouton droit de la souris sur la table et sélectionner Browse Table.
-
Une fenêtre de visualiseur d'enregistrement s'affiche dans l'éditeur principal. Cliquez sur exécuter pour exécuter l'interrogation et afficher les données de la table.
-
Pour voir 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 des opérations LDD pouvant être effectuées à partir du plugiciel IntelliJ sont
CREATE TABLE
-
Localisez l'explorateur de schéma et cliquez sur l'icône Actualiser pour charger de nouveau le schéma.
-
Cliquez avec le bouton droit de la souris sur le nom de la connexion et sélectionnez Créer une table.
-
Dans l'invite, entrez les détails de votre nouvelle table. Vous pouvez créer la table Oracle NoSQL Database selon deux modes :
-
Entrée LDD simple : Vous pouvez utiliser ce mode pour créer la table de manière déclarative, c'est-à-dire sans écrire d'énoncé LDD.
-
Entrée LDD avancée : Vous pouvez utiliser ce mode pour créer la table à l'aide d'un énoncé LDD.
-
-
Vous avez la possibilité d'afficher l'instruction LDD avant de la créer. Cliquez sur Afficher le LDD pour voir l'énoncé LDD formé en fonction des valeurs entrées dans les champs en mode d'entrée LDD simple. Cette instruction LDD 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 sélectionnez Créer une table enfant. Vous pouvez créer une table enfant en deux modes :
-
Entrée LDD 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 LDD avancée : Vous pouvez utiliser ce mode pour créer une table enfant à l'aide d'un énoncé LDD.
Pour plus de détails sur les tables enfants, voir 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. Sélectionnez Voir l'énoncé LDD de la table. Pour copier l'énoncé LDD, cliquez sur Copier dans le presse-papiers. Cliquez sur OK pour fermer la boîte de dialogue.
SUPPRIMER LA TABLE
-
Localisez l'explorateur de schéma et 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 s'affiche, cliquez sur OK pour confirmer l'action d'abandon.
CRÉER UN INDEX
-
Localisez l'explorateur de schéma et 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éé. Sélectionnez 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é sur un formulaire (entrée LDD simple) : Entrez les détails pour créer un index sans écrire d'énoncé LDD. Indiquez le nom de l'index et les colonnes à inclure dans l'index. Si la colonne est de type JSON, un champ supplémentaire nommé "
JSON Path to Index Field" s'affiche. Entrez le chemin d'accès à l'emplacement du champ JSON et sélectionnez le type de données correspondant. -
Créer un index en tant qu'énoncé LDD (pour une entrée LDD avancée) : Entrez un énoncé LDD valide pour créer un index. Il peut également inclure un type de données complexe, c'est-à-dire tableau, carte et enregistrement.
-
-
Cliquez sur Ajouter un index.
ABANDONNER L'INDEX
-
Localisez l'explorateur de schéma et cliquez sur l'icône Refresh pour recharger le schéma.
-
Cliquez sur la table cible pour voir les colonnes répertoriées, les clés primaires, les index et les clés de partition.
-
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 s'affiche, cliquez sur OK pour confirmer l'action d'abandon.
AJOUTER UNE COLONNE
-
Localisez l'explorateur de schéma et 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. Sélectionnez Ajouter une colonne.
-
Vous pouvez ajouter de nouvelles COLONNES dans deux modes :
-
Entrée LDD simple : Vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes sans écrire d'énoncé LDD. En cas de binaire ou de binaire fixe, sélectionnez le type de données
Binary. Pour le fichier binaire fixe, entrez la taille du fichier dans le champSizeet gardez le champ vide en cas de type de données binaires. -
Entrée LDD avancée : Vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes à la table en fournissant un énoncé LDD valide. Ce mode peut également créer des colonnes de type données complexes. Par exemple, tableau, mappage ou enregistrement et également dans un format imbriqué.
-
-
Dans les deux modes, spécifiez le nom de la colonne et définissez-la avec ses propriétés - datatype, valeur par défaut et si elle peut être nulle.
-
Cliquez sur Ajouter une colonne.
SUPPRIMER LA COLONNE
-
Localisez l'explorateur de schéma et cliquez sur l'icône Refresh pour recharger le schéma.
-
Cliquez sur la table cible pour voir les colonnes répertoriées, les clés primaires, les index et les clés de partition.
-
Localisez la colonne cible qui doit être supprimée et cliquez dessus avec le bouton droit de la souris. Cliquez sur Supprimer la colonne.
-
Une fenêtre de confirmation s'affiche, cliquez sur OK pour confirmer l'action d'abandon.
Geler/dégeler le schéma
Vous devez geler le schéma d'une table singleton avant d'en faire une table active globale. Une fois que vous avez gelé le schéma de la table, vous ne pouvez apporter aucune modification au schéma. Pour geler le schéma d'une table singleton, celle-ci doit comporter au moins une colonne JSON. Cliquez avec le bouton droit de la souris sur la table et sélectionnez Geler/Dégeler. Une fois la confirmation effectuée, le schéma de la table est gelé. De même, pour dégeler le schéma de la table, cliquez avec le bouton droit de la souris sur la table et sélectionnez Geler/Dégeler. Une fois que vous avez confirmé, le schéma de la table est remis à mutable, ce qui signifie que le schéma peut être modifié.
Note : Les répliques régionales de table doivent être supprimées (la table doit être une table singleton) avant que l'opération de dégel puisse être effectuée.
Gérer les répliques
Voir 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, 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 sélectionnez 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 décider des unités de lecture et d'écriture de la table dans cette région de réplication. La valeur 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.
Voir la réplique
Cliquez avec le bouton droit de la souris sur la table et sélectionnez Voir les répliques dans Répliques régionales. Vous pouvez voir la liste des répliques de la table.
Supprimer les répliques
Cliquez avec le bouton droit de la souris sur la table et sélectionnez Supprimer les répliques dans Répliques régionales. Cliquez sur Ajouter et sélectionnez une réplique à supprimer. Vous pouvez choisir plusieurs répliques à supprimer à la fois. Cliquez sur Supprimer pour supprimer 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 sélectionnez Modifier la capacité réservée. Vous pouvez choisir l'un des deux modes de capacité : Capacité provisionnée ou Capacité sur demande. Modifiez les valeurs et 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égionale).
-
La modification des unités de lecture, des unités d'écriture ou la modification du mode de capacité de On-Demand à Provisioned ou vice-versa a une portée locale (modifiez uniquement dans la réplique de table régionale où elle est lancée).
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 plugiciel IntelliJ.
Insérer des données
-
Localisez l'explorateur de schéma et cliquez sur l'icône Actualiser pour charger de nouveau 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 rangée.
-
Dans le panneau Insérer une rangée, entrez les détails de l'insertion d'une nouvelle rangée. Vous pouvez INSÉRER une nouvelle rangée dans deux modes :
-
Entrée simple : Vous pouvez utiliser ce mode pour insérer la nouvelle rangée sans écrire d'énoncé LMD. Ici, une entrée de champs d'enregistrement basée sur un formulaire est chargée, où vous pouvez entrer la valeur de chaque champ de l'enregistrement.
-
Pour le type de données binaires, la chaîne entrée doit être un encodage Base64 valide d'une valeur binaire ou sélectionnez le fichier à charger dans la colonne souhaitée.
-
Pour le type de données binaires fixe, la chaîne entrée doit être un encodage Base64 valide d'une valeur binaire ou charger le fichier de taille définie lors de la création de la colonne particulière.
Note : Le format de fichier que vous chargez pour le type de données binaires ne doit avoir que l'extension
.bin. -
-
Entrée JSON avancée : Vous pouvez utiliser ce mode pour insérer une nouvelle rangée 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 complexe, c'est-à-dire tableau, carte, enregistrement.
-
-
Cliquez sur Insérer une rangée.
Modifier les données - Mettre à jour la rangée/supprimer la rangée
-
Localisez l'explorateur de schéma et cliquez sur l'icône Actualiser pour charger de nouveau 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'énoncé SQL pour extraire les données de votre table. Cliquez sur Exécuter pour exécuter l'énoncé.
-
Pour afficher des données de cellule individuelles séparément, cliquez sur la cellule du tableau.
-
Pour effectuer des opérations LMD telles que Update et Delete Row, cliquez avec le bouton droit de la souris sur la ligne concernée. Sélectionnez votre option dans le menu contextuel qui s'affiche.
-
Supprimer une rangée : Une fenêtre de confirmation s'affiche, cliquez sur OK pour supprimer la rangée.
-
Mettre à jour la rangée : 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 rangée dans deux modes : Entrée de champs de rangée basée sur un formulaire (Entrée LDD simple) et Contenu de rangée d'approvisionnement en tant qu'objet JSON (Entrée LDD avancée). En mode d'entrée LDD avancée, les données JSON sont présentées sous forme d'arborescence pour simplifier la consultation et la mise à jour.
Sélectionnez Exécuter pour actualiser et voir les données mises à jour.
Note : Dans n'importe quelle rangée, les colonnes PRIMARY KEY et GENERATED ALWAYS AS IDENTITY ne peuvent pas être mises à jour.
-
Tables d'interrogation
-
Localisez l'explorateur de schéma et cliquez sur l'icône Actualiser pour charger de nouveau le schéma.
-
Cliquez avec le bouton droit de la souris sur la table et sélectionnez Parcourir la table.
-
Dans la zone de texte de gauche, entrez l'instruction SELECT pour extraire les données de votre table. Lorsque vous commencez à saisir l'interrogation, vous êtes invité à entrer la liste des mots possibles pour compléter automatiquement l'instruction SQL. Tous les mots clés SQL et noms de colonne pour la table indiquée sont fournis dans l'invite pour terminer automatiquement l'énoncé SQL.
-
La syntaxe SQL est mise en évidence dans chaque interrogation, ce qui offre une meilleure expérience d'écriture SQL.
-
Vous pouvez formater l'interrogation pour en améliorer la lisibilité. Sélectionnez votre interrogation, cliquez avec le bouton droit de la souris et sélectionnez Préviser. L'interrogation est formatée et les lignes sont encapsulées pour améliorer la lisibilité.
-
Cliquez sur exécuter pour exécuter l'interrogation. Les données correspondantes sont extraites de la table. Lorsque vous cliquez deux fois sur les données extraites, les données de colonne sont ouvertes dans une nouvelle fenêtre. Toutes les données JSON sont affichées dans une structure arborescente dans la nouvelle fenêtre. Cliquez sur '+' pour développer ou sur '-' pour réduire la structure arborescente. Cliquez sur Ctrl ^F dans la nouvelle fenêtre pour activer l'option de recherche, qui vous permet de rechercher n'importe quelle valeur dans l'arbre 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 rangée, puis cliquez sur Télécharger JSON. Dans la boîte de dialogue, naviguez jusqu'à l'emplacement où vous voulez enregistrer le 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.
Note : 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 l'interrogation pour télécharger toutes les données du résultat de l'interrogation. Dans la boîte de dialogue, naviguez jusqu'à l'emplacement où vous voulez enregistrer le 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 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 d'interrogation pour voir le plan d'exécution de l'interrogation.
-
Cliquez sur la liste déroulante Commandes précédentes pour voir les 20 principaux énoncés SQL récemment exécutés qui ont fourni une sortie.
Note : La liste déroulante affiche uniquement les énoncés SQL liés à la table sur laquelle vous travaillez.
Explorateur de schéma
Dans la fenêtre Explorateur de schéma, 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 plugiciel IntelliJ
Découvrez les exigences d'autorisation requises dans Oracle NoSQL Database Cloud Service pour utiliser le plugiciel IntelliJ.
Le plugiciel IntelliJ vous permet d'accéder à Oracle NoSQL Database Cloud Service à l'aide de méthodes d'authentification par clé d'API ou par jeton de session. L'accès aux ressources d'Oracle NoSQL Database Cloud Service, telles que les tables, les espaces-tables et les API, est géré au moyen des politiques du service de gestion des identités et des accès (IAM). Ainsi, seuls les utilisateurs authentifiés, qui sont membres de groupes disposant des autorisations d'inspection, de lecture, d'utilisation ou de gestion de table appropriées 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 plugiciel IntelliJ pour gérer des tables dans les tables d'Oracle NoSQL Database Cloud Service, vos autorisations IAM en vigueur 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 plugiciel IntelliJ retourne l'erreur d'autorisation correspondante, comme indiqué par le service IAM pour OCI.
Par exemple, le service OCI IAM refuse toute opération d'insertion sur une table Oracle NoSQL Database Cloud Service si votre groupe d'utilisateurs n'a que l'autorisation de " lecture " pour les tables NoSQL. Le message d'erreur suivant s'affiche dans le plugiciel IntelliJ :
Error executing Insert Row : Authorization failed or requested resource not found (5.4.18)