属性検索に基づいて、選択を追加、更新、または削除します。
入力がフィーチャクラスまたはデータセット パスの場合、このツールは、ツールの結果が適用された新しいレイヤーを作成して返します。
入力に定義クエリが存在する場合、その定義クエリに整合するフィーチャまたは行のみが選択で使用されます。
選択したレコードの数は、ジオプロセシング履歴にリストされます。 この情報にアクセスするには、[パラメーター] > [個数] の順にクリックします。 さらに、[行のカウント (Get Count)] ツールを使用して、選択したレコードの数をカウントできます。 Python の場合、選択したレコードの数は、ツールの Result オブジェクトからアクセスすることもできます。
選択の適用時、レコード数がゼロの選択になる場合があります。 たとえば、存在しないフィールド値を選択すると、結果はレコード数がゼロの選択になります。 入力としてレイヤーを使用するジオプロセシング ツールは、入力のレコードを使用しません。
SQL 式で使用されるフィールド区切り文字は、検索されるデータの形式によって異なります。 たとえば、ファイル ジオデータベースおよびシェープファイルは二重引用符を使用し、エンタープライズ ジオデータベースはフィールド区切り文字を使用しません。 AddFieldDelimiters 関数を使用して、SQL 式で使用されるフィールド区切り文字が正しいことを確認できます。
入力のデータ ソースがフィーチャ サービスの場合は、基になる ArcGIS Server で標準化された SQL クエリを使用することをお勧めします。
| ラベル | 説明 | データ タイプ |
入力行 | 選択を適用するデータ。 | Table View; Raster Layer; Mosaic Layer |
選択するタイプ (オプション) | どのように選択を適用するか、選択がすでに存在する場合にはそれをどうするかを指定します。
| String |
式 (オプション) | レコードのサブセットを選択するために使用する SQL 式。 | SQL Expression |
WHERE 句の反転 (オプション) | 式がそのまま使用されるか、逆の式が使用されるかを指定します。
| Boolean |
| ラベル | 説明 | データ タイプ |
| 更新されたレイヤーまたはテーブル ビュー | 選択が適用された状態の更新された入力。 | Table View; Raster Layer; Feature Layer |
| 個数 | 選択したレコードの数。 | Long |
arcpy.management.SelectLayerByAttribute(in_layer_or_view, {selection_type}, {where_clause}, {invert_where_clause})| 名前 | 説明 | データ タイプ |
in_layer_or_view | 選択を適用するデータ。 | Table View; Raster Layer; Mosaic Layer |
selection_type (オプション) | どのように選択を適用するか、選択がすでに存在する場合にはそれをどうするかを指定します。
| String |
where_clause (オプション) |
レコードのサブセットを選択するために使用する SQL 式。 | SQL Expression |
invert_where_clause (オプション) | 式がそのまま使用されるか、逆の式が使用されるかを指定します。
| Boolean |
| 名前 | 説明 | データ タイプ |
| out_layer_or_view | 選択が適用された状態の更新された入力。 | Table View; Raster Layer; Feature Layer |
| count | 選択したレコードの数。 | Long |
次の Python ウィンドウ スクリプトは、イミディエイト モードで SelectLayerByAttribute 関数を使用する方法を示しています。
import arcpy
arcpy.management.SelectLayerByAttribute("states", "NEW_SELECTION",
"[NAME] = 'California'")次のスタンドアロン スクリプトは、位置と属性検索に基づいてフィーチャを新しいフィーチャクラスに抽出するために、ワークフローで SelectLayerByAttribute 関数を使用する方法を示したものです。
# Name: ExtractFeaturesByLocationAndAttribute.py
# Description: Extract features to a new feature class based on a spatial
# relationship to another layer and an attribute query
# Import system modules
import arcpy
# Set the workspace
arcpy.env.workspace = 'c:/data/mexico.gdb'
# Select all cities that overlap the chihuahua polygon
chihuahua_cities = arcpy.management.SelectLayerByLocation('cities', 'INTERSECT',
'chihuahua', 0,
'NEW_SELECTION')
# Within selected features, further select only those cities with a
# population > 10,000
arcpy.management.SelectLayerByAttribute(chihuahua_cities, 'SUBSET_SELECTION',
'"population" > 10000')
# Write the selected features to a new feature class
arcpy.management.CopyFeatures(chihuahua_cities, 'chihuahua_10000plus')