Mit dem Datenquellentyp Azure Cosmos DB in ArcGIS Velocity können Sie Datensätze aus Datenbanksammlungen lesen, die in Azure Cosmos DB gespeichert sind.
Beispiel
Ein Forscher möchte Daten aus einer Datenbanksammlung, die in Azure Cosmos DB gespeichert ist, in Velocity laden, um Analysen durchzuführen.
Verwendungshinweise
Beachten Sie beim Arbeiten mit der Azure Cosmos DB-Quelle Folgendes:
- Der Hauptschlüssel wird beim erstmaligen Speichern der Analyse verschlüsselt und in verschlüsseltem Zustand gespeichert.
- Es kann eine WHERE-Klausel angegeben werden, um die Datensätze, die aus der Azure Cosmos DB-Containersammlung geladen werden, zu beschränken.
- Im Parameter WHERE-Klausel können analytische Laufzeitvariablen angegeben werden, damit für jede Ausführung nur neue Features aus der Azure DB-Containersammlung geladen werden.
Parameter
Nachfolgend werden die Parameter für die Azure Cosmos DB-Quelle beschrieben:
| Parameter | Beschreibung | Datentyp |
|---|---|---|
Endpunkt | Die Endpunkt-URL für Azure Cosmos DB, z. B. https://yourCosmosDBAccountName.documents.azure.com:443/. | Zeichenfolge |
Hauptschlüssel | Der Primärschlüssel für Azure Cosmos DB | Zeichenfolge |
Datenbank | Der Name des Azure Cosmos DB-Containers, der die zu lesende Datensammlung enthält | Zeichenfolge |
Sammlung | Der Name der Azure Cosmos DB-Sammlung im angegebenen Container mit den Daten | Zeichenfolge |
WHERE-Klausel (optional) | Zum Beschränken der Features, die aus der Azure Cosmos DB-Containersammlung geladen werden. Verwenden Sie ein einfaches Abfrageformat. Wenn in dem Dataset z. B. ein numerisches Feld namens course enthalten ist, können Sie die WHERE-Klausel course = 49.5845184 angeben; wenn in dem Dataset ein Zeichenfolgenfeld namens user_id enthalten ist, können Sie die WHERE-Klausel user_id = 'pete1234' angeben. Auf der Azure Cosmos DB-Oberfläche werden diese Abfragen in der Form SELECT * FROM c WHERE c.user_id = 'pete1234' angezeigt; Sie müssen für diesen Parameter in Velocity jedoch user_id = 'pete1234' angeben. Setzen Sie beim Abfragen von Zeichenfolgenfeldern den Text, der Teil der Abfrage ist, in einfache Anführungszeichen, z. B. road_type = 'asphalt'. Für eine wiederkehrende Big-Data-Analyse können analytische Laufzeitvariablen angegeben werden, damit für jede Ausführung nur neue Features geladen werden. Diese Variablen werden beim Abfragen von ISO 8601-Zeichenfolgenfeldern in Azure Cosmos DB durch die relevanten geplanten Startzeiten der Analyse ersetzt. Die verfügbaren analytischen Laufzeitvariablen sind $analytic.AnalyticLastSuccessfulRunScheduledStartTime und $analytic.AnalyticScheduledStartTime. Da bei der ersten Ausführung einer geplanten Big-Data-Analyse die Variable $feature.AnalyticLastSuccessfulRunScheduledStartTime als ISO 8601-Ursprungszeit der 1. Januar 1970 angegeben wird, werden alle Features nach diesem Zeitpunkt geladen. Um dies zu berücksichtigen, geben Sie einen zusätzlichen Teil der WHERE-Klauselabfrage an, damit Features nach dem erwarteten Zeitpunkt der ersten Ausführung der wiederkehrenden Analyse zurückgegeben werden. Sie können z. B., wie unten dargestellt, eine WHERE-Klausel angeben, in der die Analyse am 6. Juni 2021 um 12:01:01 UTC gestartet wurde. yourISO8601StringTimestampField > '$analytic.AnalyticLastSuccessfulRunScheduledStartTime' and yourISO8601StringTimestampField <= '$analytic.AnalyticScheduledStartTime' and yourISO8601StringTimestampField > '2021-06-04T12:01:01.0Z' | Zeichenfolge |
Überlegungen und Beschränkungen
Nachfolgend finden Sie Überlegungen und Einschränkungen zum Verwenden der Azure Cosmos DB-Quelle:
- Bei der Angabe einer WHERE-Klausel zum Filtern von Zeichenfolgenwerten müssen Sie Textwerte in einfache Anführungszeichen einschließen.
- Bei der Angabe von Datumsfeldern werden für diese Datenquelle nur die folgenden Konfigurationen unterstützt:
- Sekunden in Epoch-Zeit, wie zum Beispiel 1616673883
- Millisekunden in Epoch-Zeit, wie zum Beispiel 1616673883000
- ISO 8601-Datum/Uhrzeit-Format ohne Zeitzone, wie z. B. 2021-03-25T12:05:34
- ISO 8601-Datum/Uhrzeit-Format mit Zeitzone, wie z. B. 2021-03-25T12:05:34+0000
- Datumsangaben im Zeichenfolgenformat (Millisekunden optional): yyyy-MM-dd HH:mm:ss[.fffffffff], wie z. B. 2021-03-25 12:05:34 or 2021-03-25 12:05:34.435