Summary
Selects table records matching a Structured Query Language (SQL) expression and writes them to an output table.
Usage
The input can be an INFO, dBASE, or geodatabase table, a feature class, table view, or VPF dataset.
The Expression parameter can be created with the Query Builder or simply typed in. For details on the expression syntax, see Build an SQL query or SQL reference for elements used in query expressions.
If a table view is used for Input Table and no expression is entered, only the selected records are written to the output table. If a table view is used for input table and an expression is entered, the expression is only executed against the selected records, and the expression-based subset of the selected set is written to the output table.
To create a table from the table view's selected set of records, use the Copy Rows (management) tool.
Syntax
arcpy.analysis.TableSelect(in_table, out_table, {where_clause})
Parameter | Explanation | Data Type |
in_table | The table containing records matching the specified expression that will be written to the output table. | Table View; Raster Layer |
out_table | The output table containing records from the input table that match the specified expression. | Table |
where_clause (Optional) |
An SQL expression used to select a subset of records. For more information on SQL syntax, see SQL reference for elements used in query expressions. | SQL Expression |
Code sample
The following Python window script demonstrates how to use the TableSelect function in immediate mode.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TableSelect_analysis("majorrds.shp", "C:/output/majorrdsCl4.shp", '"CLASS" = \'4\'')
The following Python script demonstrates how to use the TableSelect function in a stand-alone script.
# Name: TableSelect_Example2.py
# Description: Select class4 roads from the major roads gnatcatcher habitat study area
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_features = "majorrds.shp"
out_feature_class = "C:/output/majorrdsCl4.shp"
where_clause = '"CLASS" = \'4\''
# Execute TableSelect
arcpy.TableSelect_analysis(in_features, out_feature_class, where_clause)
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes