Краткое руководство. Подключение к Azure Synapse Link для Azure Cosmos DB

  • Статья

В этой статье описывается, как получить доступ к базе данных Azure Cosmos DB из Azure Synapse Analytics Studio с помощью Synapse Link.

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

Для подключения учетной записи Azure Cosmos DB к рабочей области потребуется следующее:

  • имеющаяся учетная запись Azure Cosmos DB (можно также создать новую учетную запись, следуя инструкциям в этом кратком руководстве);
  • имеющаяся рабочая область Synapse (можно также создать новую рабочую область, следуя инструкциям в этом кратком руководстве).

Включение аналитического хранилища Azure Cosmos DB

Для запуска крупномасштабной аналитики в Azure Cosmos DB без негативных последствий для производительности в рабочей среде рекомендуем включить Synapse Link для Azure Cosmos DB. Эта функция предоставляет возможность HTAP для контейнера и встроенную поддержку в Azure Synapse. Следуйте инструкциям из этого краткого руководства, чтобы включить Synapse Link для контейнеров Azure Cosmos DB.

В рабочей области Synapse выберите Запуск Synapse Studio. На домашней странице Synapse Studio выберите "**Данные", чтобы перейти в обозреватель объектов данных.

Подключение базы данных Azure Cosmos DB к рабочей области Synapse

База данных Azure Cosmos DB подключается в качестве связанной службы. Связанная служба Azure Cosmos DB позволяет пользователям просматривать и изучать данные, а также считывать и записывать их из Apache Spark для Azure Synapse Analytics или SQL в Azure Cosmos DB.

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

  1. Щелкните значок + рядом с данными.
  2. Выберите Подключение к внешнем данным
  3. Выберите API, к которому требуется подключиться: SQL или MongoDB
  4. Выберите Продолжить
  5. Присвойте имя связанной службе. Имя будет отображаться в обозревателе объектов и использоваться средой выполнения Synapse для подключения к базе данных и контейнерам. Рекомендуем использовать понятное имя.
  6. Выберите имя учетной записи Cosmos DB и имя базы данных.
  7. (Необязательно.) Если регион не указан, операции среды выполнения Synapse будут направляться в ближайший регион, где включено аналитическое хранилище. Однако вы можете вручную задать регион, в котором пользователи смогут получить доступ к аналитическому хранилищу Azure Cosmos DB. Выберите Additional connection properties (Дополнительные свойства подключения) — а затем Создать. В разделе Имя свойства введите PreferredRegions и задайте в поле Значение нужный регион (например, WestUS2 — между словами и числом нет пробелов)
  8. Нажмите кнопку Создать

Базы данных Azure Cosmos DB отображаются на вкладке Подключено в разделе Azure Cosmos DB. Контейнер Azure Cosmos DB с поддержкой HTAP можно отличить от контейнера, поддерживающего только OLTP, по следующим значкам:

Контейнер Synapse:

Контейнер HTAP

Контейнер, поддерживающий только OLTP:

Контейнер OLTP

Быстрое взаимодействие с созданными кодом действиями

Если щелкнуть правой кнопкой мыши контейнер, отобразится список жестов, которые активируют среду выполнения Spark или SQL. Запись в контейнер происходит через хранилище транзакций Azure Cosmos DB и приводит к использованию единиц запросов.

Следующие шаги