Предварительная версия функции: Требования для использования поставщика данных Cosmos DB для NoSQL

В этом разделе описываются требования для использования поставщика данных Cosmos DB для NoSQL, а также порядок настройки и рекомендации при использовании поставщика данных Azure Cosmos DB для NoSQL с виртуальными таблицами.

Важно!

  • Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.
  • Мы предполагаем, что эта функция будет изменена, поэтому не следует использовать ее в рабочей среде. Используйте ее только в средах тестирования и разработки.
  • Корпорация Майкрософт не предоставляет поддержку компонентов, выпущенных для предварительного ознакомления. Служба технической поддержки Microsoft Dynamics 365 не рассматривает обращения и не отвечает на вопросы, связанные с этой функцией. Функции для предварительного ознакомления не предназначены для использования в рабочей среде; на них распространяются дополнительные условия использования.

Что такое Azure Cosmos DB?

Azure Cosmos DB — это глобально распространяемый многомодельный сервис базы данных Microsoft для критически важных приложений. Он предоставляет широкие и привычные возможности запросов SQL с постоянными низкими задержками с данными JSON без схемы. Дополнительные сведения: Введение в Azure Cosmos DB: Azure Cosmos DB для NoSQL

Требования

  • Подписка Azure, которая включает Azure Cosmos DB.
  • Коллекция Azure Cosmos DB для NoSQL.
  • Тип базы данных Azure Cosmos DB должен быть SQL.

Сопоставление типов данных

Предположим, что имеется документ Azure Cosmos DB в коллекции с именем Заказы, который имеет следующую структуру JSON.

Пример JSON для документа Azure Cosmos DB для NoSQL.

В этой таблице указаны сопоставления типов данных для документа Azure Cosmos DB для NoSQL в коллекции Заказы с Microsoft Dataverse.

Данные Azure Cosmos DB для NoSQL Dataverse
id Первичный ключ
name Строка текста
quantity Целое число
orderid Однострочный текст
ordertype Набор выбора
amount Десятичное число или валюта
delivered Да/нет
datetimeoffset Дата и время

Примечание

  • Атрибуты с префиксом подчеркивания (_) создаются в Azure Cosmos DB для NoSQL.
  • Атрибуты, которые настроены как необязательные в документе Azure Cosmos DB для NoSQL и сопоставлены в Dataverse как Требуется для бизнеса, вызывают ошибку среды выполнения.
  • Значения атрибута id должны иметь тип guid.

Поддерживаемая фильтрация запросов SQL

Фильтрация запросов SQL поддерживает следующие операторы.

  • Операторы сравнения: <,>,<=, >=,!=
  • Логические операторы: and, or
  • Логические операторы: in, not in
  • Строковые операторы: like, contains, begins with, ends with

Примечание

Использование оператора like переводится в соответствующие операторы contains/begins with/ends with. Azure Cosmos DB для NoSQL не поддерживает аргументы шаблонов, как описано в разделе Like (Transact-SQL). Поставщик данных Azure Cosmos DB для NoSQL может транслировать один особый случай Like('[aA]%') в BeginsWith('a') OR BeginsWith('A'). Обратите внимание, что сравнение строк в Azure Cosmos DB для NoSQL чувствительно к регистру символов.

Добавление источника данных с использованием поставщика данных Azure Cosmos DB для NoSQL

  1. Перейдите в AppSource, выберите ПОЛУЧИТЬ и следуйте инструкциям для добавления приложения в вашу среду с использованием версии v9x или более поздней.

  2. После установки решения выполните вход в среду и откройте Параметры > Администрирование > Источники данных виртуальных сущностей.

  3. На панели инструментов действий выберите СОЗДАТЬ, затем в диалоговом окне Выберите поставщика данных выберите Azure Cosmos DB для поставщика данных API SQL и выберите ОК. Выберите поставщик данных Azure Cosmos DB для NoSQL.

  4. Введите следующую информацию и выберите СОХРАНИТЬ И ЗАКРЫТЬ.

    Столбец Описание:
    Название Введите имя, которое описывает источник данных.
    Имя коллекции Имя базы данных Azure Cosmos DB, содержащей коллекцию, которую требуется выводить в виртуальной таблице.
    Ключ авторизации Первичный или вторичный ключи для учетной записи Azure Cosmos DB. Ключ можно найти на портале администрирования Azure в параметре Ключи в вашей учетной записи Azure Cosmos DB.
    URI-адрес URI-адрес группы ресурсов, в которой расположена коллекция Azure Cosmos DB. URI формируется аналогично https://contoso/documents.azure.com:443. URI-адрес можно найти на портале администрирования Azure в параметре Ключи для учетной записи Azure Cosmos DB.
    Время ожидания в секундах Введите число секунд ожидания ответа службы Azure Cosmos DB перед отменой запроса данных из-за истечения времени ожидания. Например, введите 30 для ожидания не более 30 секунд до истечения срока ожидания. Время ожидания по умолчанию составляет 120 секунд.

    Создание источника данных с использованием поставщика данных Azure Cosmos DB для NoSQL.

Рекомендации и ограничения

  • Обратите внимание на следующее при использовании Azure Cosmos DB в качестве источника данных:
    • Каждый источник данных Azure Cosmos DB может быть связан только с одной виртуальной таблицей.
    • Можно подключить несколько источников данных к одной и той же коллекции в экземпляре Azure Cosmos DB.
  • Нельзя сегментировать данные в коллекции по таблицам.
  • Базы данных Azure Cosmos DB не требуют схемы, тем не менее данные внутри Azure Cosmos DB должны быть структурированы с помощью предсказуемой схемы.
  • Хотя поставщик данных Azure Cosmos DB для NoSQL реализует трансляцию запроса операторов проецирования, фильтрации и сортировки, он не поддерживает операции объединения.
  • При использовании Azure Cosmos DB для NoSQL возможна фильтрация только по одному столбцу.

См. также

Создание и изменение виртуальных таблиц, содержащих данные из внешнего источника данных

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).