Utilisation du plugiciel IntelliJ pour le développement

Parcourez les tables et exécutez des interrogations sur votre instance ou simulateur Oracle NoSQL Database Cloud Service à partir de IntelliJ.

Le plugiciel IntelliJ pour Oracle NoSQL Database Cloud Service se connecte à une instance en cours d'exécution d'Oracle NoSQL Database Cloud Service ou à un simulateur et vous permet de :
  • Affichez les tables dans une structure arborescente bien définie avec 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.
  • Supprimez des tables.
  • Ajoutez de nouvelles colonnes à l'aide d'une entrée basée sur un formulaire ou fournissez des instructions LDD.
  • Déposer des colonnes.
  • Créer des index.
  • Abandonner les index.
  • Exécutez des interrogations SQL SELECT sur une table et affichez les résultats des interrogations sous forme de tableau.
  • Exécutez des instructions LMD pour mettre à jour, insérer et supprimer des données d'une table.

Cet article contient les informations suivantes :

Configuration du plugiciel IntelliJ

Voyez comment configurer le plugiciel IntelliJ pour l'instance ou le simulateur Oracle NoSQL Database Cloud Service.

Comme préalable, vous devez d'abord installer IntelliJ IDEA. Vous pouvez télécharger IntelliJ IDEA à partir de JetBrains.

Vous pouvez installer le plugiciel à 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 plugiciels JetBrains et installez-le.
  2. Option 2 : Installation à partir d'Oracle Technology Network.

    Note :

    La version la plus récente peut être téléchargée à partir d'Oracle Technology Network.
    1. Téléchargez le plugiciel IntelliJ à partir d'Oracle Technology Network. Ne pas extraire les fichiers.
    2. Lancez l'IDEA IntelliJ, naviguez jusqu'à Fichier > Paramètres > Plugiciels. Vous pouvez également accéder aux paramètres en sélectionnant l'icône IDE and Project Settings (Paramètres IDE et projet) icône de paramètres de projet située dans le coin supérieur droit de la barre de menu principale.
    3. Sélectionnez l'icône Gérer les référentiels, configurer le mandataire ou installer le plugiciel à partir du disque en haut à droite, puis sélectionnez Installer le plugiciel à partir du disque.
    4. Sélectionnez le fichier zip du plugiciel téléchargé.

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 ou simulateur Oracle NoSQL Database Cloud Service.

Création d'un projet NoSQL dans IntelliJ

Voyez comment créer un projet NoSQL dans IntelliJ.

Effectuez les étapes suivantes :
  1. Ouvrez IntelliJ IDEA. Cliquez sur File > New > Project.
  2. Entrez une valeur dans les champs Nom du projet et Emplacement du projet. Sélectionnez Créer.
  3. Sélectionnez un système de compilation et un chemin JDK.
  4. 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 compilation, votre répertoire de projet inclut également un fichier pom.xml.
  5. Assurez-vous que le service d'avis est activé pour votre projet Oracle NoSQL. Pour activer les avis, appuyez sur Alt+\ pour ouvrir le menu principal. Cliquez sur Voir, développez Fenêtres d'outils > Avis. Une icône d'avis icône de cloche de notification 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.

Connexion à Oracle NoSQL Database Cloud Service à partir de IntelliJ

Voyez comment connecter votre projet NoSQL à Oracle NoSQL Database Cloud Service à l'aide du plugiciel IntelliJ

Effectuez les étapes suivantes :
  1. Ouvrez votre projet NoSQL dans IntelliJ.
  2. Cliquez sur l'icône de tâche 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.
  3. Développez Outils > Oracle NoSQL dans l'explorateur des paramètres, puis cliquez sur Connexions.
  4. Sélectionnez Cloud (Cloud) dans la liste déroulante du type de profil. Vous pouvez voir toutes les connexions existantes pour le type de profil Cloud dans la liste déroulante Connexions.
  5. Cliquez sur Ajouter une connexion. Vous disposez de deux options pour créer une connexion.

    1. 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, qui est 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 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_con1
      Fichier 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/config
      Profil 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.
      		DEFAULT
      Compartiment (facultatif) OCID/nom de compartiment de votre schéma de base de données NoSQL.

      Note :

      Lorsque vous spécifiez le nom du compartiment, vous devez spécifier toute la hiérarchie avec un deux-points séparant chaque entrée.
      		developers:dev1.

      Ici, dev1 est un compartiment sous le compartiment developers.

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

    2. 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_con1
    Point fin Point d'accès réseau régional au service 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 client et ID utilisateur OCID de la location et OCID de l'utilisateur pour votre service Oracle NoSQL Database Cloud Service. Voir Emplacement 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 pendant la génération et le chargement de la clé de signature de l'API.
    Voir les ressources suivantes dans la documentation sur Oracle Cloud Infrastructure :
    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érer une clé de signature d'API pour plus d'informations sur la génération d'une clé de signature d'API 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 dev1 est un compartiment sous le compartiment developers.

    Note :

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

    Note :

    1. À 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.
    2. 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 connexion sera identique au point d'extrémité. Suivez l'étape ci-dessous pour modifier le nom de la connexion.
  6. Le plugiciel IntelliJ enregistre les détails de connexion dans le nom de connexion spécifié. 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 n'importe lequel 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 l'action de suppression confirmée, le nom de la connexion est supprimé du plugiciel.
  7. 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 de l'outil NoSQL dans le format suivant :

    Table - Affichage de connexion

    Option servant à créer une connexion Afficher dans la fenêtre d'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)

    Sélectionnez la connexion et cliquez sur OK. Le plugiciel IntelliJ connecte votre projet à Oracle NoSQL Database Cloud Service et il affiche son schéma dans la fenêtre Explorateur de schéma.

Après avoir connecté votre projet à 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 de IntelliJ

Voyez comment connecter votre projet NoSQL au Simulateur Oracle NoSQL Database Cloud à l'aide du plugiciel IntelliJ.

Effectuez les étapes suivantes :
  1. Pour télécharger et démarrer le simulateur Oracle NoSQL Database Cloud. Reportez-vous à la section Téléchargement du simulateur Oracle NoSQL Database Cloud.
  2. Ouvrez votre projet NoSQL dans IntelliJ.
  3. Cliquez sur l'icône de tâche 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.
  4. Développez Outils > Oracle NoSQL dans l'explorateur des 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.
  5. Sélectionnez Cloudsim dans la liste déroulante du type de profil.
  6. Cliquez sur Ajouter une connexion. Entrez des valeurs pour les paramètres de connexion ci-dessous, 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 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_sim1
    URL du 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 pour tester les exemples.

    Note :

    1. À partir de la version 1.5.4, le plugiciel IntelliJ télécharge automatiquement la dernière trousse SDK Java pour NoSQL et définit le chemin de la trousse SDK lors de la création d'une connexion.
    2. 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 connexion sera identique au point d'extrémité. Suivez l'étape ci-dessous pour modifier le nom de la connexion.
  7. Le plugiciel IntelliJ enregistre les détails de connexion dans le nom de connexion spécifié. 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 n'importe lequel 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 l'action de suppression confirmée, le nom de la connexion est supprimé du plugiciel.
  8. 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 de l'outil NoSQL dans le format suivant : 
    Connection Name:service Url : Tenant Identifier

    Sé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 :

    Pour que vous puissiez connecter votre projet au Simulateur Oracle NoSQL Database Cloud, celui-ci doit avoir commencé et être 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.

Gestion des tables à l'aide du plugiciel IntelliJ

Voyez comment créer des tables et voir les données de table dans Oracle NoSQL Database Cloud Service ou le simulateur Oracle NoSQL Database Cloud à partir de IntelliJ.

After connecting to the Oracle NoSQL Database Cloud Simulator or Oracle NoSQL Database Cloud Service, you can can download the Oracle NoSQL Database Java SDK and execute the examples to create a sample table. Le plugiciel IntelliJ vous permet de voir les tables et les données qu'elles contiennent dans la fenêtre de l'explorateur de schéma.
Pour exécuter un programme, procédez comme suit :
  1. Téléchargez la dernière trousse SDK Java pour Oracle NoSQL Database à partir de GitHub.
  2. Extraire (décompresser) le fichier téléchargé dans un référentiel local.
  3. Lancez IntelliJ IDEA et ouvrez le projet NoSQL connecté à votre Oracle NoSQL Database Cloud Service ou simulateur.
  4. Dans la fenêtre Explorateur de projet, localisez le référentiel local et ouvrez le script BasicTableExample. Vous le trouverez dans le dossier exemples sous oracle-nosql-java-sdk. Ce programme crée une table nommée audienceData, ajoute deux rangées dans cette table, interroge les rangées insérées, les supprime, puis supprime définitivement la table audienceData.
  5. Pour transmettre les arguments requis, cliquez sur Run > Edit Configurations. Selon le type de connexion, entrez les arguments de programme suivants et cliquez sur OK.

    Table - Arguments du programme

    Connexion Type (Type de connexion) Arguments du programme Informations supplémentaires
    Nuage http://localhost:8080 Si 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 us-ashburn-1 -configFile D:\OCI_PROP\config Le premier argument indique la région de données de votre service Oracle NoSQL Database Cloud. 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 fichier de configuration et son contenu, voir la méthode User Principals dans Authentification pour la connexion à Oracle NoSQL Database.
  6. Pour exécuter ce programme, cliquez sur Run > Run 'BasicExampleTable' ou appuyez sur Maj + 10.
  7. Consultez les journaux du terminal pour vérifier que le code a été exécuté correctement. Vous pouvez voir les messages affichés qui indiquent la création de la table, l'insertion de rangées, etc..

    Conseil :

    Comme BasicExampleTable supprimera les rangées insérées et la table audienceData, vous ne pouvez pas voir cette table dans l'explorateur de schéma. Si vous voulez 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.
  8. Voici la marche à suivre pour consulter les tables et leurs données :
    1. Sélectionnez l'explorateur de schéma et cliquez sur l'icône Icône d'actualisation pour recharger le schéma.
    2. Localisez la table audienceData sous votre identificateur de client, puis développez-la pour voir ses colonnes, sa clé primaire et les détails de la clé de partition.
    3. 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.
    4. 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.
    5. 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 de IntelliJ

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

Certaines des opérations LDD qui peuvent être effectuées à partir du plugiciel IntelliJ sont :

CREATE TABLE

  • Localisez l'explorateur de schéma et 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 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 :
    • **Simple DDL Input** : Vous pouvez utiliser ce mode pour créer une 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 une table à l'aide d'une instruction DDL.
  • 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 voulue et sélectionnez Créer une table enfant. Vous pouvez créer une table enfant dans 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 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 enfants, voir 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. 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 Copy to Clipboard. Cliquez sur OK pour fermer la page.

SUPPRIMER UNE TABLE

  • Localisez la vue Schema Explorer et cliquez sur l'icône Refresh pour recharger le schéma.
  • Faites un clic droit sur la table que vous souhaitez supprimer. Sélectionnez Supprimer une table.
  • Une fenêtre de confirmation s'affiche, cliquez sur OK pour confirmer l'action de suppression.

CRÉER UN INDEX

  • Localisez la vue Schema Explorer 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 Create Index, vous avez la possibilité de créer un index dans deux modes :
    • **Form Based Index Creation (Simple DDL Input)** : Entrez les détails de la 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 données JSON, un champ supplémentaire appelé "JSON Path to Index Field" s'affiche. Entrez le chemin d'accès à l'emplacement du champ JSON et choisissez son type de données.
    • **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 des types de données complexes, c'est-à-dire un tableau, une carte et un enregistrement.
  • Cliquez sur Ajouter un index.

SUPPRIMER L'INDEX

  • Localisez la vue Schema Explorer 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 de suppression.

AJOUTER UNE COLONNE

  • Localisez la vue Schema Explorer 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 COLUMNs dans deux modes :
    • Entrée LDD simple : Vous pouvez utiliser ce mode pour ajouter de nouvelles colonnes sans écrire d'énoncé LDD. Dans le cas d'un binaire binaire ou fixe, sélectionnez le type de données Binary. Pour le binaire fixe, entrez la taille du fichier dans le champ Size et gardez le champ nul 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 une instruction LDD valide. Ce mode peut également créer des colonnes de type de données complexes. Par exemple, tableau, mappage ou enregistrement et en format imbriqué.
  • Dans les deux modes, spécifiez le nom de la colonne et définissez-la avec ses propriétés - type de données, valeur par défaut et si elle peut être nulle.
  • Cliquez sur Ajouter une colonne.

DÉPOSER LA COLONNE

  • Localisez la vue Schema Explorer 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 de suppression.

Geler/UnFreeze - Schéma

Vous devez geler le schéma d'une table singleton avant d'en faire une table Global Active. Une fois que vous avez gelé le schéma de la table, vous ne pouvez pas y apporter de modifications. 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 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 sélectionnez Geler/Dégeler. Une fois que vous avez confirmé la modification, le schéma de la table redevient mutable, ce qui signifie qu'il 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égionale pour comprendre ce qui sont des 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 globale active ou ajouter une réplique à une table globale active existante. La table doit être gelée avant d'y ajouter une réplique. Cliquez avec le bouton droit sur la table et sélectionnez Ajouter une réplique dans Répliques régionales. Vous pouvez sélectionner 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 Disk Storage 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 les répliques. Une fois que vous avez confirmé, 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égionales).
  • La modification des unités de lecture, des unités d'écriture ou du mode de capacité de On-Demand à provisionné ou inversement a une portée locale (modification uniquement dans la réplique de table régionale où elle est lancée).

Effectuer des opérations LMD à 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 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 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, où vous pouvez entrer la valeur de chaque champ de l'enregistrement.
      • Pour le type de données binaire, la chaîne entrée doit être un encodage Base64 valide d'une valeur binaire ou sélectionner le fichier à charger dans la colonne souhaitée.
      • Pour le type de données binaire fixe, la chaîne entrée doit être un encodage Base64 valide d'une valeur binaire ou charger le fichier de taille défini 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 qu'une 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 données complexes, c'est-à-dire tableau, carte, enregistrement.
  • Cliquez sur Insérer une rangée.

Modifier les données - METTRE À JOUR ROW/DELETE ROW

  • 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 les données d'une cellule individuelle séparément, cliquez sur la cellule de la table.
  • 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 la 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 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 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, puis 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 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, puis 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 instructions SQL liées à la table sur laquelle vous travaillez.

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