Использование Visual Studio Code для подключения и запроса экземпляров Azure Cosmos DB

Необходимые компоненты

• Учетная запись Azure Cosmos DB для NoSQL, настроенная с базой данных и контейнером. Используйте любое из этих кратких руководств, чтобы настроить ресурс:
  • Портал
  • Azure CLI

Установка расширения

Чтобы подключить данные в Azure Cosmos DB и управлять ими в Visual Studio, сначала установите расширение "Базы данных Azure".

1. Откройте Visual Studio Code.
2. Перейдите к области расширений , выбрав "Просмотреть > расширения " или нажав клавиши CTRL+SHIFT+X в Windows и COMMAND+ SHIFT+ X в macOS.
3. В строке поиска введите DocumentDB для Visual Studio Code и выберите расширение. Затем нажмите кнопку "Установить".
4. После установки перезагрузите Visual Studio Code при появлении запроса.

Подключение к Azure Cosmos DB для NoSQL

1. В Visual Studio Code перейдите в область Azure (щелкните значок Azure на панели действий).

2. Войдите в учетную запись Azure Cosmos DB для NoSQL с помощью идентификатора Microsoft Entra:

   Примечание.

   При доступе к ресурсам Azure Cosmos DB используйте управление доступом на основе ролей на основе ролей Microsoft Entra.

3. После входа в представление дерева Azure найдите подписку Azure и выполните детализацию до Azure Cosmos DB.

4. Выберите существующую учетную запись или щелкните правой кнопкой мыши, чтобы создать новый ресурс.

Запрос и отображение данных

Следующие действия используют редактор запросов для выполнения запроса и просмотра результатов запроса:

1. В меню коллекции щелкните правой кнопкой мыши коллекцию, чтобы открыть Редактор запросов в предварительной версии.

   

2. Запустите запрос, предоставленный в редакторе запросов, чтобы отобразить данные в представлении таблицы:

   

3. Изучите данные в других поддерживаемых представлениях:

   • Представление JSON: см. структуру необработанных данных.

     

   • Представление дерева: легко изучить вложенные данные.

     

Просмотр метрик запросов и индексов

В редакторе запросов просмотрите дополнительные метрики запросов и индексов, чтобы оптимизировать производительность запроса.

1. Перейдите на вкладку "Статистика" рядом с результатами запроса.

2. Дополнительные сведения об определениях метрик см. в документации по метрикам запросов.

Вставка, изменение и удаление документов

• Редактирование документа в режиме реального времени: добавление, просмотр, изменение и удаление документов мгновенно с изменениями, отраженными в режиме реального времени.

• Импорт из JSON: быстрая загрузка данных из JSON-файлов.

Экспорт результатов запроса

• Скачать результаты: скачать результаты запроса в CSV-файлы или JSON.

Связанный контент

• Начало работы с API для NoSQL
• Краткое руководство по Node.js
• Краткое руководство по Python
• Краткое руководство для Java
• Краткое руководство по переходу

Необходимые компоненты

• Учетная запись Azure Cosmos DB для NoSQL, настроенная с базой данных и контейнером.
• Оболочка MongoDB (mongosh), установленная для взаимодействия командной строки (необязательно, но рекомендуется).

Установка расширения

Чтобы подключить данные в Azure Cosmos DB и управлять ими, необходимо установить расширение баз данных Azure для Visual Studio Code.

1. Откройте Visual Studio Code.
2. Перейдите к области расширений , выбрав "Просмотреть > расширения " или нажав клавиши CTRL+SHIFT+X в Windows и COMMAND+ SHIFT+ X в macOS.
3. В строке поиска введите DocumentDB для Visual Studio Code и выберите расширение. Затем нажмите кнопку "Установить".
4. После установки перезагрузите Visual Studio Code при появлении запроса.

Подключение к рабочей нагрузке MongoDB

Теперь подключитесь к рабочей нагрузке MongoDB в Azure Cosmos DB для MongoDB.

1. На панели рабочей области разверните раздел учетных записей MongoDB.

2. Здесь можно просмотреть все учетные записи MongoDB. Подключитесь к новой учетной записи MongoDB с помощью учетных данных.

   Примечание.

   Все успешно подключенные кластеры MongoDB останутся в разделе учетных записей MongoDB, даже после закрытия Visual Studio Code.

Интуитивно понятные Управление данными

Легко управлять базами данных в Visual Studio Code:

• Создание и удаление баз данных или коллекций: создание или удаление баз данных и коллекций с помощью контекстного меню в учетной записи, базе данных или коллекции на панели ресурсов.

• Импорт из JSON: быстро импортируйте данные из JSON-файлов в коллекцию.

  • Инициирование импорта
    1. Щелкните правой кнопкой мыши имя коллекции в представлении ресурсов и выберите "Импортировать документы в коллекцию".
    2. Кроме того, откройте представление коллекции, щелкнув запись "Документы " коллекции, а затем нажмите кнопку "Импорт ".
  • Выбор JSON-файла
    1. Найдите файл *.json, содержащий данные.
    2. Подтвердите запуск процесса импорта.

• Экспорт данных: сохранение коллекций или результатов запроса в формате JSON для резервного копирования или общего доступа.

  • Инициирование экспорта:
    • Вариант 1
      1. Щелкните правой кнопкой мыши имя коллекции в представлении ресурсов и выберите "Экспорт документов из коллекции ", чтобы экспортировать всю коллекцию.
    • Вариант 2
      1. Откройте представление коллекции, щелкнув запись "Документы " коллекции, а затем нажмите кнопку "Экспорт ".
      2. Выберите экспорт всей коллекции или результатов текущего запроса.
  • Укажите целевой файл:
    1. Введите имя и расположение для целевого файла *.json.
    2. Подтвердите экспорт, чтобы начать сохранение данных.

• Редактирование документа в режиме реального времени: мгновенное добавление, просмотр, изменение и удаление документов с обновлениями в режиме реального времени.

  • Открытие редактирования документа:
    • Доступ к параметрам редактирования документов непосредственно в представлении коллекции. Эти элементы управления удобно расположены над представлением данных для простого доступа.
  • Доступные действия:
    • Добавление: создание новых документов в коллекции.
    • Представление. Просмотр содержимого выбранного документа.
    • Изменение: изменение содержимого выбранных документов.
    • Удаление. Удалите выбранные документы с изменениями, отраженными немедленно.

Мощные средства запросов

Простое выполнение и уточнение запросов:

• Мгновенные результаты: немедленно просматривать результаты запроса в предпочитаемом формате— табличном представлении, JSON или дереве.

  • Легко переключать представления с помощью раскрывающегося меню "Вид ".

• Выполнение запросов напрямую: запись и выполнение запросов MongoDB с такими функциями, как выделение синтаксиса и автозавершение.

  • Чтобы запустить запрос, нажмите кнопку "Найти запрос" или нажмите в Ctrl/Cmd+Enter редакторе запросов.

Гибкие представления данных

Изучите данные с помощью нескольких представлений для разных перспектив:

• Представление JSON: см. необработанную структуру данных JSON.

  

• Представление дерева: навигация и изучение вложенных данных без усилий.

  

• Представление таблицы. Быстрое сканирование данных и детализация в вложенных документах.

  • Для детализации: поиск записей со значком {} , указывающим внедренные объекты. Дважды щелкните, чтобы развернуть и просмотреть содержимое.

  • Чтобы вернуться обратно: Вернитесь на предыдущие уровни с помощью навигационных таблиц под представлением таблицы.

  

Интеграция Оболочки Mongo

Доступны функции командной строки:

• Запуск mongosh: выполнение расширенных команд MongoDB непосредственно из Visual Studio Code.

Управление кластерами

Оставайтесь на вершине ваших ресурсов:

• Просмотр сведений о кластере. Проверьте уровень кластера, версию сервера и использование ресурсов.

• Управление тегами. Упорядочение кластеров с тегами, которые синхронизируются с порталом Azure.