Capa de entidades

El tipo de fuente Capa de entidades de ArcGIS Velocity carga entidades de una capa de entidades de ArcGIS Online o ArcGIS Server.

Ejemplos

A continuación, se muestran ejemplos de uso de la fuente de datos:

  • Un usuario selecciona una capa de entidades alojada de ArcGIS Online que contiene las entidades que se deben cargar.
  • Un analista SIG proporciona la URL a una capa de entidades de ArcGIS Server (por ejemplo, https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2) que contiene las entidades que se cargarán.
  • Un usuario puede agregar condiciones meteorológicas en tiempo real a su mapa incorporando una capa de entidades del tiempo desde ArcGIS Online.

Notas de uso

Tenga en cuenta lo siguiente al trabajar con la fuente de datos:

  • Al explorar un elemento de la capa de entidades, puede filtrar por carpetas, favoritos, grupos u organización. Puede filtrar más detalladamente por fecha de modificación, fecha de creación y etiquetas.
  • Las capas de entidades de ArcGIS Server también se pueden cargar mediante el uso de una URL. Utilice una URL REST del directorio de servicios ArcGIS Server (por ejemplo, https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2). Esta URL debe terminar en /FeatureServer/# o /MapServer/#, donde # es el número de capa.
  • Para cargar una capa de entidades protegida desde una URL, en primer lugar agregue elementos de la web a ArcGIS Online, almacene las credenciales y, a continuación, busque el elemento de ArcGIS Online registrado para cargar la capa de entidades protegida.
  • Las capas de entidades deben tener un campo de identificador único. El identificador único no debe ser nulo, debe contener valores únicos y debe ser uno de los siguientes tipos de datos:
    • Entero (solo valores positivos de 32 y 64 bits)
    • Cadena de caracteres
    • GUID
    • Fecha
    • Solo fecha
    • Solo hora
  • Las capa de entidades debe tener un identificador único que admita las operaciones de resumen de estadísticas Mín y Máx. Cuando utilice una capa de entidades de ArcGIS Server, tenga en cuenta que algunos backends de servicios no admiten campos de ID de objetos virtuales, como ESRI_OID.
  • La capa de entidades debe estar accesible en Internet.
  • Si se proporciona un campo en el parámetro Campo de marca de tiempo, el origen Capa de entidades consulta la capa de entidades para cargar solo las entidades relevantes para el ciclo analítico actual (solo análisis programados).
    • Si se proporciona un valor en Campo de marca de tiempo, la primera vez que se inicia el análisis, Velocity sondea la capa de entidades y carga todas las entidades con una fecha y hora en el campo de marca de tiempo datetime que sea menor que el primer tiempo de ejecución programado que también cumpla los criterios de la cláusula WHERE. En cada sondeo posterior, solo se cargan las entidades con un valor de campo de marca de tiempo entre el último tiempo de ejecución programado y el tiempo de ejecución programado actual que también cumplan los criterios de la cláusula WHERE.
    • Si no se especifica ningún valor de Campo de marca de tiempo, cada vez que se inicie el análisis, el feed de capa de entidades carga todas las entidades de la capa de entidades como eventos para procesar.
  • No se puede especificar un campo de marca de tiempo al configurar un origen de la capa de entidades en un análisis en tiempo real, porque cada vez que se inicia el análisis en tiempo real el feed de la capa de entidades carga todas las entidades devueltas por la cláusula WHERE configurada.
  • Después de configurar los parámetros de conexión de origen, consulte Configurar datos de entrada para obtener información sobre cómo definir el esquema y los parámetros clave.

Parámetros

Los parámetros para la fuente de datos son:

ParámetroDescripciónTipo de datos
Cláusula WHERE

Cláusula SQL (Lenguaje estructurado de consultas) que se utiliza para filtrar las entidades cargadas desde la capa de entidades especificada. De forma predeterminada se cargan todas las entidades utilizando 1=1 y se puede modificar para incluir valores de atributos específicos y condiciones lógicas.

La mayoría de las capas de entidades admiten la sintaxis de la cláusula WHERE de SQL-92 en los campos de la capa.

Las capas de entidades generadas por Velocity o capas de entidades de ArcGIS Enterprise que se ejecutan en una fuente de big data store espaciotemporal tienen restricciones sobre lo que se admite; solo admiten un subconjunto de SQL-92. A continuación, se muestra la sintaxis SQL-92 compatible con estas capas de entidades:

  • ( '<=' | '>=' | '<' | '>' | '=' | '!=' | '<>' | LIKE )
  • (AND | OR)
  • (IS | IS_NOT)
  • (IN | NOT_IN) ( '(' ( expr ( ',' expr )* )? ')' )
  • COLUMN_NAME BETWEEN LITERAL_VALUE AND LITERAL_VALUE

Si utiliza variables globales analíticas para restringir la carga de entidades, cuatro variables globales pertenecen a análisis recurrentes de big data y se enumeran a continuación. Estas variables se pueden utilizar junto con la cláusula WHERE de fuente de la capa de entidades para cargar solo ciertas entidades cada vez que se ejecuta el análisis de big data.

  • $analytic.AnalyticLastScheduledStartTime: la hora de inicio programada para la última ejecución del análisis.
  • $analytic.AnalyticScheduledStartTime: la hora de inicio programada para la ejecución actual del análisis.
  • $analytic.AnalyticLastEndTime: la hora de finalización de la última ejecución del análisis.
  • $analytic.AnalyticStartTime: la hora de inicio de la ejecución actual del análisis. La diferencia entre esta hora y $analytic.AnalyticScheduledStartTime es la demora de inicio.

El flujo de trabajo más común para utilizar estas variables es junto con un análisis en tiempo real que esté escribiendo eventos continuamente en una salida de capa de entidades a medida que ocurren los eventos.

Más información sobre el análisis casi en tiempo real

QueryString

Campos de salida

Campos de la capa de entidades que se cargarán en Velocity.

El valor predeterminado es un asterisco (*), que indica que se cargan todos los campos.

Al especificar campos, utilice una lista de nombres de campo separados por comas, por ejemplo, device_id,timestamp,horizontal_accuracy,latitude,longitude.

Cadena de caracteres

Referencia espacial de salida

El Id. conocido (WKID) de una referencia espacial. El valor predeterminado es 4326.

Cadena de caracteres

Registro adicional

(opcional)

Especifica si está disponible el registro de solicitudes sin procesar emitidas por Velocity. El valor predeterminado es Falso.

Nota:

Active únicamente este parámetro para la localización de averías y desactívelo cuando haya finalizado. Póngase en contacto con el Soporte técnico de Esri para que le ayude a solucionar los problemas.

Booleano

Campo de marca de tiempo

Un campo de fecha para recuperar las entidades más recientes (solo análisis programados).

Más información sobre la configuración del campo de marca de tiempo

Cadena de caracteres

Consideraciones y limitaciones

Tenga en cuenta lo siguiente al utilizar la fuente de datos:

  • La capa de entidades debe estar accesible en Internet.
  • Velocity no hace referencia a capas que requieren créditos para recibir solicitudes (ArcGIS Online).