選択から定義クエリを生成 (Generate Definition Query From Selection) (データ管理)

サマリー

レイヤーまたはテーブルの選択したフィーチャまたは行から定義クエリ (SQL 形式) を作成します。

使用法

• 入力のアクティブな選択が必要です。

• マップまたはシーンで入力レイヤーまたはテーブル ビューが存在する必要があります。

• 定義クエリの句には、1,000 個の値の制限が設けられています。 選択に 1,000 個以上の値が含まれている場合、生成される定義クエリには複数の句が含まれます。

• レイヤーに GlobalID フィールドがあり、[生成方法] パラメーターが [選択の一致] に設定されている場合、ObjectID フィールドの代わりに GlobalID フィールドが使用されます。 [生成方法] パラメーターが [フィールド値の使用] に設定されている場合、GlobalID フィールドはパラメーターにリストされません。

• [アクティブなクエリのアペンド] パラメーターは、[生成方法] パラメーターが [フィールド値の使用] に設定されており、入力レイヤーまたはテーブルにアクティブな定義クエリがある場合にのみ使用できます。 アクティブなクエリは、レイヤーまたはテーブルのプロパティを検証することで決定できます。

• [Where 句の上書き] パラメーターはオンであるが、[Where 句] パラメーター値が変更または指定されていない場合、ツールはデフォルトで生成された定義クエリを使用します。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力テーブル	定義クエリを生成するレイヤーまたはテーブル ビュー。	Table View
生成方法 (オプション)	定義クエリの生成に使用される方法を指定します。 選択の一致—選択内に存在する値でクエリを生成するには、入力テーブルの ObjectID フィールド (または、存在する場合は GlobalID フィールド) を使用します。 これがデフォルトです。 フィールド値の使用—選択内に存在する値でクエリを生成するには、[フィールド] パラメーター値を使用します。	String
フィールド (オプション)	クエリの値を生成するために使用される、テーブルまたはテーブル ビューのフィールド。 このパラメーターは、[生成方法] パラメーターが [フィールド値の使用] に設定されている場合に必須です。	Field
クエリ名 (オプション)	生成されるクエリの一意の名前。	String
WHERE 句の反転 (オプション)	生成された定義クエリ (Where 句) が反転しており、選択されていない値をすべて含めるか、入力テーブルのすべての選択値を含めるかを指定します。 オン - Where 句は反転します。 オフ - Where 句は反転しません。 これがデフォルトです。	Boolean
アクティブなクエリのアペンド (オプション)	生成された定義クエリをアクティブなクエリに追加するかどうかを指定します。 このパラメーターは、レイヤーまたはテーブルにアクティブな定義クエリがあり、[生成方法] パラメーターが [フィールド値の使用] に設定されている場合に使用できます。 オン - 生成された定義クエリをアクティブなクエリに追加します。 オフ - 生成された定義クエリをアクティブなクエリに追加しません。 これがデフォルトです。	Boolean
Where 句の上書き (オプション)	定義クエリ (Where 句) を生成する前に、定義クエリを表示し、[Where 句] パラメーターを変更できるかどうかを指定します。 オン - 生成される前に Where 句は表示され、変更できます。 オフ - Where 句は変更できません。 これがデフォルトです。	Boolean
WHERE 句 (オプション)	他のパラメーター値から生成された定義クエリの SQL 式。 SQL 構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。	SQL Expression

派生した出力

ラベル	説明	データ タイプ
更新されたテーブル	生成された定義クエリで更新された入力。	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})

名前	説明	データ タイプ
in_table	定義クエリを生成するレイヤーまたはテーブル ビュー。	Table View
method (オプション)	定義クエリの生成に使用される方法を指定します。 MATCH_SELECTION—選択内に存在する値でクエリを生成するには、入力テーブルの ObjectID フィールド (または、存在する場合は GlobalID フィールド) を使用します。 これがデフォルトです。 USE_FIELD_VALUES—選択内に存在する値でクエリを生成するには、field パラメーター値を使用します。	String
field (オプション)	クエリの値を生成するために使用される、テーブルまたはテーブル ビューのフィールド。 このパラメーターは、method パラメーターが USE_FIELD_VALUES に設定されている場合に必須です。	Field
query_name (オプション)	生成されるクエリの一意の名前。	String
invert_where_clause (オプション)	生成された定義クエリ (Where 句) が反転しており、選択されていない値をすべて含めるか、入力テーブルのすべての選択値を含めるかを指定します。 INVERT—Where 句は反転します。 NON_INVERT—Where 句は反転しません。 これがデフォルトです。	Boolean
append_active_query (オプション)	生成された定義クエリをアクティブなクエリに追加するかどうかを指定します。 このパラメーターは、レイヤーまたはテーブルにアクティブな定義クエリがあり、method パラメーターが USE_FIELD_VALUES に設定されている場合に使用できます。 APPEND—生成された定義クエリをアクティブなクエリに追加します。 NOT_APPEND—生成された定義クエリをアクティブなクエリに追加しません。 これがデフォルトです。	Boolean
overwrite_where_clause (オプション)	定義クエリ (Where 句) を生成する前に、where_clause パラメーターを変更できるかどうかを指定します。 OVERWRITE—生成される前に Where 句を変更できます。 NOT_OVERWRITE—Where 句は変更できません。 これがデフォルトです。	Boolean
where_clause (オプション)	定義クエリは他のパラメーター値を上書きします。 SQL 構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。	SQL Expression

派生した出力

名前	説明	データ タイプ
out_table	生成された定義クエリで更新された入力。	Feature Layer, Table View

コードのサンプル

GenerateDefinitionQueryFromSelection の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで GenerateDefinitionQueryFromSelection 関数を使用する方法を示しています。

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)

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes