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.

Le module d'extension IntelliJ Oracle NoSQL Database Cloud Service se connecte à une instance ou à un simulateur Oracle NoSQL Database Cloud Service en cours d'exécution et vous permet d' :
  • 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.

Vous devez d'abord installer IntelliJ IDEA en tant que prérequis. Vous pouvez télécharger IntelliJ IDEA à partir de JetBrains.

Vous pouvez installer le plug-in à l'aide de l'une des options suivantes :
  1. Option 1 : recherchez le connecteur Oracle NoSQL Database Cloud Service dans le référentiel de modules d'extension JetBrains et installez-le.
  2. Option 2 : effectuez une installation à partir d'Oracle Technology Network.

    Remarques :

    La version la plus récente peut être téléchargée à partir d'Oracle Technology Network.
    1. Téléchargez le module d'extension IntelliJ depuis Oracle Technology Network. Ne pas extraire les fichiers.
    2. Lancez l'IDEA IntelliJ, accédez à Fichier > Paramètres > Modules d'extension. Vous pouvez également accéder aux paramètres en sélectionnant l'icône IDE et paramètres de projet projet-paramètres-icône située dans le coin supérieur droit de la barre de menu principale.
    3. Sélectionnez l'icône Manage Repositories, Configure Proxy or Install Plugin from Disk dans l'angle supérieur droit, puis sélectionnez Install Plugin from disk.
    4. Sélectionnez le fichier zip du plug-in téléchargé.

Redémarrez l'IDE. L'icône Explorateur de schémas s'affiche sur le panneau de droite.

Une fois le module d'extension IntelliJ configuré, créez un projet NoSQL et connectez-le à l'instance ou au simulateur Oracle NoSQL Database Cloud Service.

Création d'un projet NoSQL dans IntelliJ

Découvrez comment créer un projet NoSQL dans IntelliJ.

Procédez comme suit :
  1. Ouvrez IntelliJ IDEA. Cliquez sur File > New > Project.
  2. Entrez une valeur pour Nom de projet et Emplacement de projet. Choisissez Créer.
  3. Sélectionnez un système de build et un chemin JDK.
  4. IntelliJ crée le répertoire de projet NoSQL, qui inclut un exemple de fichier Java. Si vous avez sélectionné Maven en tant que système de construction, le répertoire de votre projet inclut également un fichier pom.xml.
  5. 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 icône de notification apparaît dans la barre d'outils de droite.
Une fois le projet NoSQL créé dans IntelliJ, vous pouvez le connecter à Oracle NoSQL Database Cloud Service ou à un simulateur.

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.

Procédez comme suit :
  1. Ouvrez le projet NoSQL dans IntelliJ.
  2. Cliquez sur l'icône de tâche icône de tâche dans la fenêtre explorateur de schémas pour ouvrir la boîte de dialogue Paramètres du plug-in.
  3. Développez Tools > Oracle NoSQL dans l'Explorateur de paramètres, puis cliquez sur Connexions.
  4. 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.
  5. Cliquez sur Add Connection (Ajouter une connexion). Vous avez le choix entre deux options pour créer une connexion.

    1. 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, 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
      Nom de connexion Un nom unique, attribué à une spécification de connexion spécifique, est obligatoire à partir du plug-in 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.

      Remarques :

      Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.
      		ndcs_con1
      Fichier 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/config
      Profil Nom du profil.

      Remarques :

      Vous pouvez créer plusieurs profils avec des valeurs différentes pour ces entrées, puis spécifier le profil à charger.
      		DEFAULT
      Compartiment (facultatif) OCID du compartiment/nom du compartiment pour le schéma de base de données NoSQL.

      Remarques :

      Lorsque vous indiquez le nom du compartiment, vous devez indiquer l'intégralité de la hiérarchie avec le signe deux-points séparant chaque entrée.
      		developers:dev1.

      Ici, dev1 est un compartiment sous le compartiment developers.

      Remarques :

      En l'absence de valeur, la valeur par défaut est le compartiment racine.

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

    2. 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
    Nom de connexion 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.

    Remarques :

    Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.
    		ndcs_con1
    Adresse Point d'accès réseau régional vers 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 à Adresses de service associées et régions de données pour consulter la liste des adresses de service.
    ID de locataire et ID utilisateur OCID de la location et de l'utilisateur pour Oracle NoSQL Database Cloud Service. See Where to get the Tenancy's OCID and User's OCID in Oracle Cloud Infrastructure Documentation.
    Empreinte digitale et phrase de passe (facultatif) L'empreinte et la phrase de passe de la clé de signature créées lors de la génération et du téléchargement de cette dernière.
    Reportez-vous aux ressources suivantes dans la Documentation Oracle Cloud Infrastructure :
    Clé privée Clé privée générée pour l'utilisateur. Pour l'utilisateur de l'application, vous devez générer et télécharger une clé de signature d'API. Reportez-vous à How to Generate an API Signing Key pour générer la clé de signature avec une phrase de passe facultative.
    Compartiment (facultatif) OCID de compartiment/nom de compartiment pour le schéma de base de données NoSQL.

    Remarques :

    Lorsque vous indiquez le nom du compartiment, vous devez indiquer la hiérarchie entière avec un signe deux-points séparant chaque entrée.
    		developers:dev1.

    Ici, dev1 est un compartiment sous le compartiment developers.

    Remarques :

    Si aucune valeur n'est indiquée, la valeur par défaut est le compartiment racine.

    Remarques :

    1. 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.
    2. Si vous mettez à jour le module d'extension à 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 à celui de l'adresse. Suivez l'étape ci-dessous pour modifier le nom de connexion.
  6. Le module d'extension IntelliJ enregistre les détails de connexion dans le nom de connexion indiqué. Pour modifier les détails de connexion, choisissez le nom de connexion dans la liste déroulante Connexions. Cliquez sur Modify Connection. 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 que vous avez confirmé l'action à supprimer, le nom de connexion est enlevé du module d'extension.
  7. 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
    Advanced Connection Name:Endpoint:Compartment Name/OCID (si autre que racine)
    Use Configuration File Connection Name:Configuration file path:Profile:Compartment Name/OCID(si autre que racine)

    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 que vous avez connecté votre projet à Oracle NoSQL Database Cloud Service, vous pouvez gérer les tables et les données dans votre schéma.

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.

Procédez comme suit :
  1. Téléchargez et démarrez le simulateur Oracle NoSQL Database Cloud. Pour plus d'informations, reportez-vous à Downloading the Oracle NoSQL Database Cloud Simulator.
  2. Ouvrez le projet NoSQL dans IntelliJ.
  3. Cliquez sur l'icône de tâche icône de tâche dans la fenêtre explorateur de schémas pour ouvrir la boîte de dialogue Paramètres du plug-in.
  4. Développez Outils > Oracle NoSQL dans l'explorateur de paramètres, puis cliquez sur Connexions. Vous pouvez visualiser toutes les connexions existantes pour le type de profil Cloudsim sous la liste déroulante Connexions.
  5. Sélectionnez Cloudsim dans le menu déroulant pour le type de profil.
  6. Cliquez sur Add Connection. Entrez des valeurs pour les paramètres de connexion suivants et cliquez sur OK.

    Table - Paramètres de connexion

    Paramètre Description Exemple de valeur
    Connection Name Un nom unique, attribué à une spécification de connexion spécifique, est obligatoire à partir du plug-in 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.

    Remarques :

    Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.
    		nosql_sim1
    URL de service L'adresse IP et le port sur lesquels le simulateur Oracle NoSQL Database Cloud est exécuté. La valeur par défaut est http://localhost:8080
    Identificateur de locataire Identificateur unique du locataire. La valeur par défaut est exampleId. Conservez cette valeur si vous souhaitez tester les exemples.

    Remarques :

    1. 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.
    2. Si vous mettez à jour le module d'extension à 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 à celui de l'adresse. Suivez l'étape ci-dessous pour modifier le nom de connexion.
  7. Le module d'extension IntelliJ enregistre les détails de connexion dans le nom de connexion indiqué. Pour modifier les détails de connexion, choisissez le nom de connexion dans la liste déroulante Connexions. Cliquez sur Modify Connection. 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 que vous avez confirmé l'action à supprimer, le nom de connexion est enlevé du module d'extension.
  8. 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 Identifier

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

    Remarques :

    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 connecté au simulateur Oracle NoSQL Database Cloud, vous pouvez gérer les tables et les données dans votre schéma.

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.

Une fois que vous avez connecté au simulateur Oracle NoSQL Database Cloud ou à l'Oracle NoSQL Database Cloud Service, vous pouvez télécharger le kit SDK Java Oracle NoSQL Database et exécuter les exemples pour créer une table exemple. A l'aide du module d'extension IntelliJ, vous pouvez afficher les tables et leurs données dans la fenêtre Explorateur de schémas.
Pour exécuter un programme, procédez comme suit :
  1. Téléchargez le dernier kit SDK Java Oracle NoSQL Database à partir de GitHub.
  2. Extrayez (décompressez) le fichier téléchargé dans un référentiel local.
  3. Lancez le projet IDEA IntelliJ et ouvrez le projet NoSQL connecté à Oracle NoSQL Database Cloud Service ou au simulateur.
  4. Dans la fenêtre Explorateur de projets, recherchez le référentiel local et ouvrez le script BasicTableExample. Vous le trouverez dans le dossier examples sous oracle-nosql-java-sdk. En examinant le code, ce programme crée une table nommée audienceData, insère deux lignes dans cette table, interroge les lignes insérées, supprime les lignes insérées et supprime la table audienceData.
  5. Pour transmettre les arguments requis, cliquez sur Exécuter > Modifier les configurations. En fonction du type de connexion, entrez les arguments de programme suivants et cliquez sur OK.

    Table - Arguments de programme

    Type de connexion Arguments de programme En savoir plus
    Nuageux http://localhost:8080 Si vous avez démarré le simulateur Oracle NoSQL Database Cloud sur un port différent, vous devez remplacer 8080 par le numéro de ce port.
    Cloud us-ashburn-1 -configFile D:\OCI_PROP\config Le premier argument indique la région de données de votre instance 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 fichier de configuration et son contenu, reportez-vous à la méthode ID utilisateur dans Authentification pour la connexion à Oracle NoSQL Database.
  6. Pour exécuter ce programme, cliquez sur Run (Exécuter) > Run 'BasicExampleTable' (Exécuter) ou appuyez sur Shift + 10.
  7. Pour vérifier que le code est exécuté correctement, consultez les journaux dans le terminal. Vous pouvez voir les messages d'affichage qui indiquent la création de la table, l'insertion des lignes, etc.

    Conseil :

    Comme BasicExampleTable supprime les lignes insérées et supprime (DRO) la table audienceData, vous 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 (DROP) la table, puis exécutez à nouveau le programme.
  8. Pour afficher les tables et leurs données, procédez comme suit :
    1. Recherchez l'explorateur de schémas, puis cliquez sur l'icône icône Actualiser pour recharger le schéma.
    2. Localisez la table audienceData sous l'identificateur de locataire, puis développez-la pour afficher les détails de colonnes, de clé primaire et de clé de shard qui lui sont associés.
    3. Cliquez deux fois sur le nom de la table pour afficher ses données. Sinon, vous pouvez faire un clic droit sur la table et sélectionner Browse Table.
    4. 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.
    5. Pour afficher les données d'une cellule individuelle séparément, double-cliquez sur la cellule.

Effectuer des opérations DDL à l'aide de IntelliJ

Vous pouvez utiliser IntelliJ pour effectuer des opérations DDL.

Certaines des opérations DDL 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 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).
  • 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 champ Size 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é.
  • 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

Vous devez geler le schéma d'une table singleton avant de la transformer en table active globale. Une fois que vous avez gelé le schéma de la table, vous ne pouvez plus le modifier. Pour figer le schéma d'une table singleton, il doit comporter au moins une colonne JSON. Cliquez avec le bouton droit de la souris sur la table et choisissez Valider/Dégeler. Une fois que vous avez confirmé, 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 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é.

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.

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

Afficher la réplique

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.

Supprimer des 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 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.

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 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 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. 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).
  • 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 la table. Cliquez sur Exécuter pour exécuter l'instruction.
  • 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 : 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.

      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 l'explorateur de schémas, puis cliquez sur l'icône Actualiser 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 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 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 principales instructions SQL récemment exécutées qui ont fourni une sortie.

    Remarques :

    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.