El tipo de fuente de datos Azure Cosmos DB en ArcGIS Velocity lee los registros de las colecciones de bases de datos almacenadas en Azure Cosmos DB.
Ejemplo
Un explorador desea cargar datos de una colección de base de datos almacenada en Azure Cosmos DB en Velocity para realizar análisis.
Notas de uso
Tenga en cuenta lo siguiente al trabajar con la fuente Azure Cosmos DB:
- La clave principal se cifra la primera vez que se guarde el análisis y se almacena en un estado cifrado.
- Se puede especificar una cláusula WHERE para restringir los registros cargados de la colección del contenedor de Azure Cosmos DB.
- Es posible especificar variables de tiempo de ejecución de análisis en el parámetro Cláusula WHERE para cargar solo nuevas entidades desde la colección de contenedores de Azure Cosmos DB con cada ejecución.
Parámetros
A continuación, se indican los parámetros de la fuente Azure Cosmos DB:
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
Extremo | URL de extremo para Azure Cosmos DB, por ejemplo, https://yourCosmosDBAccountName.documents.azure.com:443/. | Cadena de caracteres |
Clave maestra | La clave principal para Azure Cosmos DB. | Cadena de caracteres |
Base de datos | El nombre del contenedor de Azure Cosmos DB que contiene la colección de datos que se desea leer. | Cadena de caracteres |
Captura | El nombre de la colección de Azure Cosmos DB en el contenedor especificado que tiene los datos. | Cadena de caracteres |
Cláusula WHERE (opcional) | Restrinja las entidades cargadas desde la colección de contenedores Azure Cosmos DB. Utilice un formato de consulta simple. Por ejemplo, si ya existe un campo numérico llamado course en el dataset, puede especificar una cláusula WHERE de course = 49.5845184; si existe un campo de cadena de caracteres llamado user_id en el dataset, puede especificar una cláusula WHERE de user_id = 'pete1234'. En la interfaz de Azure Cosmos DB, estas consultas tienen el formato SELECT * FROM c WHERE c.user_id = 'pete1234'; no obstante, debe especificar user_id = 'pete1234' para este parámetro en Velocity. Al consultar campos de cadena de caracteres, utilice comillas simples alrededor del texto que forma parte de la consulta, por ejemplo, road_type = 'asphalt'. Es posible especificar variables de tiempo de ejecución de análisis para cargar únicamente nuevas entidades para cada ejecución de un análisis de big data recurrente. Estas variables se reemplazan por los tiempos de inicio programados relevantes para consultar los campos de cadena de caracteres ISO 8601 en Azure Cosmos DB. Las variables de tiempo de ejecución de análisis disponibles son $analytic.AnalyticLastSuccessfulRunScheduledStartTime y $analytic.AnalyticScheduledStartTime. Para la primera ejecución después de iniciar un análisis de big data programado, la variable $feature.AnalyticLastSuccessfulRunScheduledStartTime se proporciona en como el tiempo de origen ISO 8601 del 1 de enero de 1970, de modo que se cargarán todas las entidades posteriores a esa hora. Para implementarlo, especifique una parte adicional de la consulta de cláusula WHERE para devolver entidades después del primer tiempo de ejecución previsto del análisis recurrente. Por ejemplo, puede especificar una cláusula WHERE como se muestra a continuación, donde el análisis empezara el 6 de junio de 2021 a las 12:01:01 UTC. yourISO8601StringTimestampField > '$analytic.AnalyticLastSuccessfulRunScheduledStartTime' and yourISO8601StringTimestampField <= '$analytic.AnalyticScheduledStartTime' and yourISO8601StringTimestampField > '2021-06-04T12:01:01.0Z' | Cadena de caracteres |
Consideraciones y limitaciones
A continuación se indican las consideraciones y limitaciones de uso de la fuente Azure Cosmos DB:
- Al especificar una cláusula WHERE para filtrar valores de cadena, ajuste los valores de texto en comillas simples.
- Al especificar campos de datos, solo se admiten las siguientes configuraciones para esta fuente de datos:
- Segundos de Epoch, por ejemplo, 1616673883
- Milisegundos de Epoch, por ejemplo, 1616673883000
- Formato de fecha y hora ISO 8601 sin zona horaria, por ejemplo, 2021-03-25T12:05:34
- Formato de fecha y hora ISO 8601 con zona horaria, por ejemplo, 2021-03-25T12:05:34+0000
- Fechas de cadena en el formato (milisegundos son opcionales) yyyy-MM-dd HH:mm:ss[.fffffffff], por ejemplo, 2021-03-25 12:05:34 or 2021-03-25 12:05:34.435