Предыдущий

Следующая

Подготовить

Завершено

Вы создаете приложение .NET, которое импортирует и запрашивает данные в контейнере Azure Cosmos DB для NoSQL. Здесь мы обсудим общие цели проекта и способы реализации функций импорта и запросов. Кроме того, мы рассмотрим, как настроить необходимую учетную запись API для NoSQL.

Обзор проекта

Цель этого проекта — создать и проверить консольное приложение .NET, которое отправляет и запрашивает элементы в контейнере API для NoSQL. Приложение .NET использует пакет SDK для .NET для Azure Cosmos DB для NoSQL для взаимодействия с экземпляром службы в Azure. Код проекта использует пакеты транзакций для одновременного создания нескольких связанных элементов. Код проекта также использует запросы, представленные в виде строк, для проверки успешности отправки элементов.

В следующей блок-схеме показана бизнес-логика, которую приложению необходимо выполнить:

Схема блок-схемы, показывающая шаги для проверки подлинности клиента. Затем блок-схема показывает шаг создания пакета, который объединяет создание четырех отдельных элементов. Наконец, блок-диаграмма показывает последовательность для создания, выполнения и наблюдения за результатами запроса.

Основными задачами, которые необходимо выполнить, являются:

1. Создать учетную запись Azure Cosmos DB и получить строку подключения.
2. Создать консольное приложение .NET и добавить ссылку на пакет SDK Microsoft.Azure.Cosmos.
3. Создать базу данных и ресурсы контейнера.
4. Добавить один элемент в виде простой операции.
5. Создать транзакционный пакет для добавления четырех элементов.
6. Выполните и просмотрите результаты запроса.

Настройка

Для выполнения этого проекта требуется учетная запись API для NoSQL.

Создание учетной записи Azure Cosmos DB для NoSQL

Учетная запись API для NoSQL используется для хранения данных, создаваемых в этом проекте, и для выполнения запросов. В этом разделе описаны действия по созданию учетной записи с помощью Azure CLI непосредственно в терминале Azure Cloud Shell.

1. Создайте новую переменную оболочки с именем суффиксом со случайным числом. Создайте новую учетную запись API для NoSQL в группе ресурсов [имя группы ресурсов песочницы].

   let suffix=$RANDOM*$RANDOM
   
   az cosmosdb create \
       --resource-group "<rgn>[sandbox resource group name]</rgn>" \
       --name "mslearn-$suffix" \
       --locations "regionName=westus"
   

   Внимание

   Эта группа ресурсов уже создана песочницей.

2. Дождитесь завершения команды после создания учетной записи. Создание учетной записи может занять несколько минут.

   Совет

   Вы можете перейти к новой учетной записи API для NoSQL с помощью портал Azure.

Получение строки подключения к учетной записи

Теперь, когда у вас есть учетная запись API для NoSQL, можно использовать az cosmosdb keys list команду из Azure CLI для получения учетных данных учетной записи. В этом разделе вы отфильтруете выходные данные команды, чтобы вернуть только один строка подключения.

1. Сначала получите имя последнего созданного API для учетных записей NoSQL.

   let resourceGroup="<rgn>[sandbox resource group name]</rgn>"
   
   az cosmosdb list \
       --resource-group $resourceGroup \
       --query "sort_by([].{name:name,created:systemData.createdAt}, &created)" \
       --output table
   

2. Теперь получите учетные Primary SQL Connection String данные для первой учетной записи из списка недавно созданных учетных записей.

   let resourceGroup="<rgn>[sandbox resource group name]</rgn>"
   
   az cosmosdb keys list \
       --resource-group $resourceGroup \
       --name $(az cosmosdb list \
           --resource-group $resourceGroup \
           --query "sort_by([].{name:name,created:systemData.createdAt}, &created)[0].name" \
           --output tsv) \
       --type connection-strings \
       --query "connectionStrings[?description=='Primary SQL Connection String'].connectionString" \
       --output tsv
   

3. Запишите значение этого строка подключения. Для подключения к этой учетной записи используется строка подключения далее в этом проекте.

Настройка среды разработки

Среда контейнера разработки доступна со всеми зависимостями, необходимыми для выполнения каждого упражнения в этом проекте. Контейнер разработки можно запустить в GitHub Codespaces или локально с помощью Visual Studio Code.

Разработка в браузере

GitHub Codespaces запускает контейнер разработки, управляемый GitHub, с Помощью Visual Studio Code для Интернета в качестве пользовательского интерфейса на основе браузера. Для наиболее простой среды разработки используйте GitHub Codespaces, чтобы у вас были правильные средства разработчика и зависимости, предварительно установленные для выполнения этого модуля обучения.

Внимание

Все учетные записи GitHub могут использовать пространства Кода до 60 часов бесплатно каждый месяц с 2 основными экземплярами.

1. Создайте новое пространство кода GitHub с помощью azure-samples/cosmos-db-dotnet шаблона.

   

2. На странице "Создание пространства кода" просмотрите параметры конфигурации пространства кода и выберите "Создать новое пространство кода".

3. Дождитесь запуска пространства кода. Этот процесс запуска может занять несколько минут.

4. Откройте новый терминал в пространстве кода.

5. Убедитесь, что .NET 8 установлен в вашей среде:

   dotnet --list-sdks
   

6. Закройте терминал.

Остальные упражнения в этом проекте происходят в контексте этого контейнера разработки.

Разработка локально

Расширение "Контейнеры разработки" для Visual Studio Code требует установки Docker на локальном компьютере. Расширение размещает контейнер разработки локально с помощью узла Docker с правильными средствами разработчика и предустановленными зависимостями для завершения этого модуля обучения.

1. Откройте репозиторий шаблонов azure-samples/cosmos-db-dotnet из GitHub в Visual Studio Code.

   

2. Откройте новый терминал.

3. Убедитесь, что .NET 8 установлен в вашей среде:

   dotnet --list-sdks
   

4. Закройте терминал.

Остальные упражнения в этом проекте происходят в контексте этого контейнера разработки.

Продолжить