Generar consulta de definición a partir de la selección (Administración de datos)

Resumen

Crea una consulta de definición (en formato SQL) a partir de las entidades o filas seleccionadas de la capa o tabla.

Uso

• Se requiere una selección activa de la entrada.

• La capa o vista de tabla de entrada debe estar presente en el mapa o la escena.

• Cada cláusula de consulta de definición tiene un límite de 1000 valores. Si la selección contiene más de 1000 valores, la consulta de definición resultante incluirá varias cláusulas.

• Si una capa tiene un campo GlobalID y el parámetro Método de generación está definido como Igualar selección, se utilizará el campo GlobalID en lugar del campo ObjectID. El campo GlobalID no se mostrará en el parámetro si el parametro Método de generación está definido como Utilizar valores de campo.

• El parámetro Adjuntar la consulta activa solo está disponible si el parámetro Método de generación está definido como Utilizar valores de campo y la capa o tabla de entrada tiene una consulta de definición activa. Usted puede determinar la consulta activa examinando las propiedades de la capa o tabla.

• Si el parámetro Sobrescribir cláusula Where está activado, pero no se ha modificado ni especificado el valor del parámetro Cláusula where, la herramienta utilizará la consulta de definición generada de manera predeterminada.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	Capa o vista de tabla a partir de la cuál se va a generar la consulta de definición.	Table View
Método de generación (Opcional)	Especifica el método que se utilizará para generar la consulta de definición. Igualar selección—El campo ObjectID de la tabla de entrada (o el campo GlobalID, si está presente) se utilizará para generar la consulta con los valores presentes en la selección. Esta es la opción predeterminada. Utilizar valores de campo—El valor del parámetro Campo se utilizará para generar la consulta con los valores presentes en la selección.	String
Campo (Opcional)	El campo de la tabla o vista de tabla que se utilizará para generar valores para la consulta. Este parámetro es obligatorio si el parámetro Método de generación está configurado como Utilizar valores de campo.	Field
Nombre de consulta (Opcional)	El nombre único de la consulta que se va a generar.	String
Invertir cláusula Where (Opcional)	Especifica si la consulta de definición generada (cláusula where) se invertirá e incluirá todos los valores no seleccionados o bien todos los valores seleccionados de la tabla de entrada. Activado: la cláusula where se invertirá. Desactivado: la cláusula where no se invertirá. Esta es la opción predeterminada.	Boolean
Adjuntar la consulta activa (Opcional)	Especifica si la consulta de definición generada se incorporará a la consulta activa. Este parámetro está disponible si la capa o tabla tiene una consulta de definición activa y el parámetro Método de generación está definido como Utilizar valores de campo. Activado: la consulta de definición generada se incorporará a la consulta activa. Desactivado: la consulta de definición generada no se incorporará a la consulta activa. Esta es la opción predeterminada.	Boolean
Sobrescribir cláusula where (Opcional)	Especifica si la consulta de definición (cláusula where) se mostrará y se podrá modificar mediante el parámetro Cláusula where antes de que se genere. Activado: la cláusula where se mostrará y se podrá modificar antes de que se genere. Desactivado: la cláusula where no se podrá modificar. Esta es la opción predeterminada.	Boolean
Cláusula Where (Opcional)	La expresión SQL de consulta de definición generada a partir de los demás valores de los parámetros. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression

Salida derivada

Etiqueta	Explicación	Tipo de datos
Tabla actualizada	La entrada actualizada con la consulta de definición generada.	Feature Layer, Table View

Python

arcpy.management.GenerateDefinitionQueryFromSelection(in_table, {method}, {field}, {query_name}, {invert_where_clause}, {append_active_query}, {overwrite_where_clause}, {where_clause})

Nombre	Explicación	Tipo de datos
in_table	Capa o vista de tabla a partir de la cuál se va a generar la consulta de definición.	Table View
method (Opcional)	Especifica el método que se utilizará para generar la consulta de definición. MATCH_SELECTION—Se utilizará el campo ObjectID de la tabla de entrada (o el campo GlobalID, si está presente) para generar la consulta con los valores presentes en la selección. Esta es la opción predeterminada. USE_FIELD_VALUES—Se utilizará el valor del parámetro field para generar la consulta con los valores presentes en la selección.	String
field (Opcional)	El campo de la tabla o vista de tabla que se utilizará para generar valores para la consulta. Este parámetro es obligatorio si el parámetro method se define como USE_FIELD_VALUES.	Field
query_name (Opcional)	El nombre único de la consulta que se va a generar.	String
invert_where_clause (Opcional)	Especifica si la consulta de definición generada (cláusula where) se invertirá e incluirá todos los valores no seleccionados o bien todos los valores seleccionados de la tabla de entrada. INVERT—La cláusula where se invertirá. NON_INVERT—La cláusula where no se invertirá. Esta es la opción predeterminada.	Boolean
append_active_query (Opcional)	Especifica si la consulta de definición generada se incorporará a la consulta activa. Este parámetro está disponible cuando una capa o tabla tiene una consulta de definición activa y el parámetro method está definido como USE_FIELD_VALUES. APPEND—La consulta de definición generada se incorporará a la consulta activa. NOT_APPEND—La consulta de definición generada no se incorporará a la consulta activa. Esta es la opción predeterminada.	Boolean
overwrite_where_clause (Opcional)	Especifica si la consulta de definición (cláusula where) se podrá modificar mediante el parámetro where_clause antes de que se genere. OVERWRITE—La cláusula where se podrá modificar antes de que se genere. NOT_OVERWRITE—La cláusula where no se podrá modificar. Esta es la opción predeterminada.	Boolean
where_clause (Opcional)	La consulta de definición que invalidará los demás valores de los parámetros. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression

Salida derivada

Nombre	Explicación	Tipo de datos
out_table	La entrada actualizada con la consulta de definición generada.	Feature Layer, Table View

Muestra de código

Ejemplo de GenerateDefinitionQueryFromSelection (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función GenerateDefinitionQueryFromSelection de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"

# Set local variables
in_table = "WisconsinAirports.lyrx"
where_clause = '"TRAFFICCOUNT" >= \'100\''

# Run the tool
arcpy.management.GenerateDefinitionQueryFromSelection(
    in_table,
    "MATCH_SELECTION",
    "MyPythonQueryName",
    "NON_INVERT",
    "NOT_APPEND",
    "OVERWRITE",
    where_clause)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí