Démarrage rapide : Créer un compte Azure Cosmos DB for NoSQL à l'aide du portail Azure

S’APPLIQUE À : NoSQL

Dans ce démarrage rapide, vous créez un nouveau compte Azure Cosmos DB for NoSQL dans le portail Azure. Vous utilisez ensuite l'expérience d’explorateur de données du portail Azure pour créer une base de données et un conteneur en configurant tous les paramètres requis. Enfin, vous ajoutez un échantillon de données au conteneur et lancez une requête de base.

Prérequis

Créer un compte

Commencez par créer un compte Azure Cosmos DB for NoSQL

  1. Connectez-vous au portail Azure (https://portal.azure.com).

  2. Entrez Azure Cosmos DB dans la barre de recherche globale.

    Capture d’écran de la barre de recherche globale dans le portail Azure.

  3. Dans Services, sélectionnez Azure Cosmos DB.

    Capture d’écran de l'option Azure Cosmos DB sélectionnée dans le menu de recherche.

  4. Dans le volet Azure Cosmos DB, sélectionnez Créer, puis Azure Cosmos DB for NoSQL.

    Capture d’écran de l'option Créer dans le volet d'un service Azure.

    Capture d’écran du volet sélection de l'API Azure Cosmos DB avec l'API for NoSQL en surbrillance.

  5. Dans le volet Informations de base, configurez les options suivantes, puis sélectionnez Avis+ créer :

    Valeur
    Abonnement Sélectionnez votre abonnement Azure.
    Groupe de ressources Créer un groupe de ressources ou en sélectionner un
    Nom du compte Fournir un nom globalement unique
    Zones de disponibilité Désactiver
    Emplacement Sélectionnez une région Azure prise en charge pour votre abonnement

    Capture d’écran du volet « Informations de base » de la création de ressources Azure Cosmos DB for NoSQL.

    Conseil

    Vous pouvez laisser les options non spécifiées à leur valeur par défaut. Vous pouvez également configurer le compte pour limiter le débit total du compte à 1 000 unités de requête par seconde (RU/s) et activer le niveau gratuit pour minimiser vos coûts.

  6. Dans le volet Avis+ créer, attendez que la validation de votre compte se termine avec succès, puis sélectionnez Créer.

    Capture d’écran de l'étape de validation des ressources dans l'expérience de création.

  7. Le portail accède automatiquement au volet Déploiement. Attendez la fin du déploiement.

    Capture d’écran du volet de déploiement avec un déploiement en attente.

  8. Une fois le déploiement terminé, sélectionnezGo to ressource pour accéder au nouveau compte Azure Cosmos DB for NoSQL.

    Capture d’écran d'une ressource entièrement déployée avec l'option « Go to ressource » en surbrillance.

Créer une base de données et un conteneur

Ensuite, utilisez l'explorateur de données pour créer une base de données et un conteneur dans le portail.

  1. Dans le volet de ressources du compte, sélectionnez Explorateur de données dans le menu de service.

    Capture d’écran de l'option explorateur de données dans le menu de service du compte.

  2. Dans le volet explorateur de données, sélectionnez l’option Nouveau conteneur.

    Capture d’écran de l'option « Nouveau conteneur » dans l'explorateur de données.

  3. Dans le dialogue Nouveau conteneur, configurez les valeurs suivantes, puis sélectionnez OK :

    Valeur
    Sauvegarde de la base de données Création
    ID de base de données cosmicworks
    Partager le débit entre les conteneurs Ne sélectionnez rien
    ID de conteneur employees
    Clé de partition department/name
    Débit du conteneur (mise à l’échelle automatique) Autoscale
    Nombre maximal de RU/s du conteneur 1000

    Capture d’écran du dialogue pour créer une base de données et un conteneur avec les options spécifiées remplies.

  4. Créer un nouveau fichier nommé demo.bicepparam ou (demo.bicepparam).

  5. Observez la base de données et le conteneur nouvellement créés dans la hiérarchie de l'explorateur de données.

    Capture d’écran de la hiérarchie de l’Explorateur de données avec un conteneur de base de données présent.

    Conseil

    En option, vous pouvez développer le nœud du conteneur pour observer des propriétés et des paramètres de configuration supplémentaires.

Ajouter et interroger des échantillons de données

Enfin, utilisez l'explorateur de données pour créer un échantillon, puis lancez une requête de base dans le conteneur.

  1. Développez le nœud du conteneur employés dans l’arborescence de l’Explorateur de données. Sélectionnez ensuite l’option Éléments.

    Capture d’écran de l’option « Éléments » dans un conteneur dans la hiérarchie de l’Explorateur de données.

  2. Dans le menu de l'explorateur de données, sélectionnez Nouvel élément.

    Capture d’écran de l'option « Nouvel élément » dans le menu de l'explorateur de données.

  3. À présent, insérez le code JSON suivant pour un nouvel élément dans le conteneur employés, puis sélectionnez Enregistrer :

    {
      "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": {
        "first": "Kai",
        "last": "Carter"
      },
      "email": "<kai@adventure-works.com>",
      "department": {
        "name": "Logistics"
      }
    }
    

    Capture d’écran du contenu JSON d’un nouvel élément dans l’Explorateur de données.

  4. Dans le menu de l'explorateur de données, sélectionnez Nouvelle requête SQL.

    Capture d’écran de l'option « Nouvelle requête SQL » dans le menu de l'explorateur de données.

  5. Insérez maintenant la requête NoSQL suivante pour obtenir tous les éléments pour la logistics section en utilisant une recherche insensible à la casse. La requête met ensuite en forme la sortie en tant qu’objet JSON structuré. Exécutez la requête en sélectionnant Exécuter la requête :

    SELECT VALUE {
        "name": CONCAT(e.name.last, " ", e.name.first),
        "department": e.department.name,
        "emailAddresses": [
            e.email
        ]
    }
    FROM
        employees e
    WHERE
        STRINGEQUALS(e.department.name, "logistics", true)
    

    Capture d’écran du texte de requête NoSQL dans l’Explorateur de données.

  6. Observez la production du tableau JSON de la requête.

    [
      {
        "name": "Carter Kai",
        "department": "Logistics",
        "emailAddresses": [
          "kai@adventure-works.com"
        ]
      }
    ]
    

    Capture d’écran des résultats de l’exécution de la requête NoSQL précédente dans l’Explorateur de données.