Crear capa de consulta

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. POINT —La capa de consulta de salida utilizará geometría de punto. MULTIPOINT —La capa de consulta de salida usará geometría de multipunto. POLYGON —La capa de consulta de salida usará geometría de polígono. POLILÍNEA —La capa de consulta de salida usará geometría de polilínea.	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

Muestra 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 Desktop Basic: Sí
• ArcGIS Desktop Standard: Sí
• ArcGIS Desktop Advanced: Sí