Resumen
Crea una capa de consulta de una tabla DBMS con base en una instrucción de selección de SQL de entrada.
Uso
Las capas de consulta solamente funcionarán con bases de datos corporativas. Las geodatabases personales o de archivo no son espacios de trabajo de entrada válidos para esta herramienta.
Si el resultado de la consulta SQL ingresada devuelve una columna espacial, el resultado será una capa de entidad. Si la consulta SQL no devuelve una columna espacial, el resultado será una tabla independiente.
Los archivos de conexión necesarios para esta herramienta se pueden crear usando la herramienta Crear conexión de base de datos.
- Si el resultado de la consulta SQL no devuelve ninguna fila, la capa de consulta de resultado estará vacía, y solamente incluirá el esquema de las columnas que haya devuelto la consulta. En este caso, si las columnas que se devolvieron contienen una columna espacial, la herramienta usará los siguientes valores predeterminados para crear la capa de consulta:
- Tipo de geometría: POINT
- SRID:
- Referencia espacial: NAD1983
Entonces, dependerá del usuario cambiar cualquiera de estos valores deseados antes de ejecutar la herramienta.
Para los datos geográficos, cada registro en el resultado que se devuelve de la instrucción SQL debe tener un SRID (identificador de referencia espacial) asociado. El valor SRID lo usa la base de datos para determinar la referencia espacial para los datos. Las diferencias funcionales específicas para el SRID variarán entre cada plataforma DBMS. Algunas plataformas DBMS admiten varios valores SRID dentro de la misma tabla; ArcGIS solamente admitirá un valor. Esta herramienta proporciona la capacidad de elegir el valor SRID o tendrá un valor predeterminado en SRID desde el primer registro en el conjunto de resultados.
Sintaxis
MakeQueryLayer_management (input_database, out_layer_name, query, {oid_fields}, {shape_type}, {srid}, {spatial_reference})| Parámetro | Explicación | Tipo de datos |
input_database | El archivos de conexión de base de datos que contiene los datos a consultar. | Workspace |
out_layer_name | Nombre de salida para la capa de entidad o vista de tabla a crear. | String |
query | Instrucción SQL que define la consulta de selección a emitir en la base de datos. | String |
oid_fields [oid_fields,...] (Opcional) | Uno o más campos de la lista SELECCIONAR de la instrucción SELECCIONAR que se pueden usar para generar una identificador de fila única, dinámico. | String |
shape_type (Opcional) | El tipo de forma para la capa de consulta. Solamente aquellos registros del conjunto de resultados de la consulta que coinciden con el tipo de forma específico que se usará en la capa de consulta de salida. La validación de la herramienta intentará establecer esta propiedad con base en el primer registro en el conjunto de resultados. Esto se puede cambiar antes de ejecutar la herramienta si no tiene el tipo de forma de salida deseado. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría.
| String |
srid (Opcional) | Establece el valor SRID (identificador de referencia espacial) para consultas que devuelven geometría. Solamente aquellos registros del conjunto de resultados de la consulta que coinciden con el valor SRID específico que se usará en la capa de consulta de salida. La validación de la herramienta intentará establecer esta propiedad con base en el primer registro en el conjunto de resultados. Esto se puede cambiar antes de ejecutar la herramienta si no tiene el valor SRID de salida deseado. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría. | String |
spatial_reference (Opcional) | Establece el sistema de coordenadas que usará la capa de consulta de salida. La validación de la herramienta intentará establecer esta propiedad con base en el primer registro en el conjunto de resultados. Esto se puede cambiar antes de ejecutar la herramienta si no tiene el sistema de coordenadas de salida deseado. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría. | Spatial Reference |
Ejemplo de código
Ejemplo 1 de MakeQueryLayer (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta MakeQueryLayer en el modo inmediato.
import arcpy
sr = arcpy.SpatialReference("WGS 1984 UTM Zone 12N")
arcpy.MakeQueryLayer_management("Connections/moab.sde",
"Slickrock",
"select * from moabtrails where name = 'slickrock'",
"OBJECTID",
"POLYLINE",
"32611",
sr)
Ejemplo 2 de MakeQueryLayer (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente demuestra cómo utilizar la herramienta MakeQueryLayer.
# Name: MakeQueryLayer.py
# Description: Creates an output query layer based on a where clause.
# This example shows how to create a spatial reference object using the
# name of a coordinate system. It also demonstrates how to use two fields
# to generate a dynamic unique row identifier for the query layer.
# Import system modules
import arcpy
# Create the spatial reference for the output layer.
sr = arcpy.SpatialReference("WGS 1984 UTM Zone 12N")
# Run the tool
arcpy.MakeQueryLayer_management("Connections/moab.sde",
"Single Track",
"select * from moabtrails where type = 'single'",
"UID;name",
"POLYLINE",
"32611",
sr)
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí