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

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

Это важно

Synapse Link для Cosmos DB больше не поддерживается для новых проектов. Не используйте эту функцию.

Используйте зеркальное отображение Azure Cosmos DB для Microsoft Fabric, которое теперь находится в стадии общей доступности. Зеркальное отображение обеспечивает те же преимущества нулевого ETL и полностью интегрировано с Microsoft Fabric. Дополнительные сведения см. в Обзоре зеркалирования Cosmos DB.

Предварительные условия

Для подключения учетной записи 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 и приводит к использованию единиц запросов (Request Units).

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

  • Last updated on