Тип источника Azure Cosmos DB в ArcGIS Velocity считывает записи из коллекций баз данных, хранящихся в Azure Cosmos DB.
Пример
Пользователь хочет загрузить данные из коллекции базы данных, хранящейся в Azure Cosmos DB, в Velocity для выполнения анализа.
Примечания по использованию
При работе с источником Azure Cosmos DB нужно учитывать следующее:
- Главный ключ шифруется при первом сохранении аналитики и сохраняется в зашифрованном состоянии.
- Можно указать условие WHERE, чтобы ограничить записи, загружаемые из коллекции контейнеров Azure Cosmos DB.
- Аналитические переменные времени запуска можно указать в параметре условие Where, чтобы при каждом запуске загружать только новые объекты из коллекции контейнеров Azure Cosmos DB.
Параметры
Ниже приведены параметры для источника Azure Cosmos DB:
| Параметр | Описание | Тип данных |
|---|---|---|
Конечная точка | URL конечной точки для Azure Cosmos DB, например, https://yourCosmosDBAccountName.documents.azure.com:443/. | Строка |
Основной ключ | Основной ключ для Azure Cosmos DB. | Строка |
База данных | Имя контейнера Azure Cosmos DB, содержащего набор данных для чтения. | Строка |
Коллекция | Имя коллекции Azure Cosmos DB в указанном контейнере, содержащем данные. | Строка |
Условие WHERE (дополнительно) | Ограничивает объекты, загружаемые из коллекции контейнеров Azure Cosmos DB. Используйте простой формат запроса. Например, если в наборе данных существует числовое поле course, вы можете задать условие WHERE course = 49.5845184; если в наборе есть текстовое поле user_id, вы можете задать условие WHERE user_id = 'pete1234'. В интерфейсе Azure Cosmos DB эти запросы будут выглядеть как SELECT * FROM c WHERE c.user_id = 'pete1234'; однако, вы должны указать user_id = 'pete1234' для этого параметра в Velocity. При запросе строковых полей используйте одинарные кавычки вокруг текста, который является частью запроса, например, road_type = 'asphalt'. Можно указать аналитические переменные времени запуска, чтобы загружать только новые объекты при каждом запуске для повторяющегося анализа больших данных. Эти переменные заменяются соответствующим временем запуска аналитики по расписанию для запроса строковых полей ISO 8601 в Azure Cosmos DB. Доступные аналитические переменные времени запуска $analytic.AnalyticLastSuccessfulRunScheduledStartTime и $analytic.AnalyticScheduledStartTime. Для первого запуска после запуска аналитики больших данных по расписанию переменная $feature.AnalyticLastSuccessfulRunScheduledStartTime будет предоставлена в качестве исходного времени ISO 8601 1 января 1970 года, поэтому будут загружены все объекты после этого времени. Чтобы учесть это, укажите дополнительную часть запроса для условия Where для возврата объектов после ожидаемого первого времени запуска повторяющейся аналитики. Например, можно указать условие Where, как показано ниже, где аналитика была запущена 6 июня 2021 года в 12:01:01 по UTC. yourISO8601StringTimestampField > '$analytic.AnalyticLastSuccessfulRunScheduledStartTime' and yourISO8601StringTimestampField <= '$analytic.AnalyticScheduledStartTime' and yourISO8601StringTimestampField > '2021-06-04T12:01:01.0Z' | Строка |
Советы и ограничения
Ниже приведены соображения и ограничения при использовании источника Azure Cosmos DB:
- При указании условия WHERE для фильтрации строковых значений заключайте текстовые значения в одинарные кавычки.
- При указании полей даты для этого источника данных поддерживаются только следующие конфигурации:
- Секунды epoch, например, 1616673883
- Миллисекунды epoch, например, 1616673883000
- Формат даты и времени ISO 8601 без часового пояса, например, 2021-03-25T12:05:34
- Формат даты и времени ISO 8601 с часовым поясом, например, 2021-03-25T12:05:34+0000
- Строковые даты в формате (миллисекунды необязательны) yyyy-MM-dd HH:mm:ss[.fffffffff], например, 2021-03-25 12:05:34 or 2021-03-25 12:05:34.435