クエリレイヤーの作成 (Make Query Layer) (データ管理)—ArcGIS Pro

サマリー

入力 SQL の SELECT ステートメントに基づいて、DBMS からクエリレイヤーを作成します。

使用法

クエリレイヤーは、エンタープライズデータベースのみで動作します。ファイルジオデータベースは、このツールに有効な入力ワークスペースではありません。
ツールで作成されたレイヤーは一時的なものであり、プロジェクトを保存するか、[行のコピー (Copy Rows)] または [フィーチャのコピー (Copy Features)] でコピーを作成してデータを保持しておかない限り、セッション終了後に削除されます。
入力した SQL クエリの結果として空間列が返された場合、出力はフィーチャレイヤーとなります。SQL クエリが空間列を返さない場合、出力はスタンドアロンテーブルになります。
このツールで必要な接続ファイルは、[データベース接続の作成 (Create Database Connection)] ツールを使用して作成できます。
SQL クエリの結果で行が返されない場合、出力クエリレイヤーは空になり、クエリで返された列のスキーマのみが含まれます。この場合、返された列に空間列が含まれていると、ツールは次のデフォルト設定を使用してクエリレイヤーを作成します。
- ジオメトリタイプ - POINT
- SRID - 1
- 空間参照 - NAD1983
次に、ツールを実行する前に、これらの値のいずれかを変更すべきかどうかを決定する必要があります。
地理データの場合、SQL ステートメントから返された結果の各レコードには、空間参照 ID (SRID) が関連付けられています。SRID 値は、データの空間参照を決定するためにデータベースによって使用されます。SRID に関する特定の機能は、DBMS プラットフォーム間で異なります。同じテーブル内で複数の SRID 値をサポートする DBMS プラットフォームもありますが、ArcGIS は 1 つの値しかサポートしません。このツールでは SRID 値を選択することができ、デフォルトでは結果セットの最初のレコードの SRID が使用されます。

パラメーター

ラベル	説明	データタイプ
入力データベースコネクション	クエリ対象のデータを含むデータベースコネクションファイル。	Workspace
出力レイヤー名	作成されるフィーチャレイヤーまたはテーブルビューの出力名。	String
クエリ	データベースで実行する SELECT クエリを定義する SQL ステートメント。注意: 残りのコントロールが有効化される前に、この文字列は整合チェックをパスする必要があります。整合チェックは、入力ボックス以外の場所をクリックしたときに実行されます。整合チェックプロセスでは、データベースに対してクエリを実行し、SQL クエリの結果が ArcGIS のデータモデリング標準に従っているかどうかが確認されます。整合チェックに失敗した場合は、ツールが警告を返します。唯一の例外はモデルビルダーの場合で、入力が出力データであるときは、整合チェックが実行されません。整合チェックルールとして、次を満たしていることが確認されます。 SQL クエリの結果に含まれる空間フィールドは 1 つのみである。 SQL クエリの結果に含まれる空間参照は 1 つのみである。 SQL クエリの結果に含まれるエンティティタイプ (ポイント、マルチポイント、ライン、ポリゴンなど) は 1 つのみである。 SQL クエリの結果に、ArcGIS でサポートされていないフィールドタイプを含めることはできません。ArcGIS でサポートされているフィールドタイプについては、「ArcGIS フィールドデータタイプ」をご参照ください。整合チェックは、対象のデータが ArcGIS と同じ標準を使用しない空間データベース内のデータである場合に特に重要になります。	String
一意の識別子フィールド (オプション)	動的で一意な行 ID を生成する、SELECT ステートメントの SELECT リストの 1 つ以上のフィールド。	String
シェープタイプ (オプション)	クエリレイヤーのシェープタイプを指定します。クエリの結果セットに含まれるレコードのうち、指定したシェープタイプに一致するレコードだけが出力クエリレイヤーで使用されます。ツールの整合チェックにより、結果セットの最初のレコードに基づいてこのプロパティが設定されます。目的の出力シェープタイプに設定されていない場合は、ツールを実行する前に変更できます。クエリの結果セットがジオメトリフィールドを返さない場合、このパラメーターは無視されます。ポイント—出力クエリレイヤーはポイントジオメトリを使用します。マルチポイント—出力クエリレイヤーはマルチポイントジオメトリを使用します。ポリゴン—出力クエリレイヤーはポリゴンジオメトリを使用します。ポリライン—出力クエリレイヤーはポリラインジオメトリを使用します。	String
SRID (オプション)	ジオメトリを返すクエリの空間参照 ID (SRID)。クエリの結果セットに含まれるレコードのうち、指定した SRID 値に一致するレコードだけが出力クエリレイヤーで使用されます。ツールの整合チェックにより、結果セットの最初のレコードに基づいてこのプロパティが設定されます。目的の出力 SRID 値に設定されていない場合は、ツールを実行する前に変更できます。クエリの結果セットがジオメトリフィールドを返さない場合、このパラメーターは無視されます。	String
座標系 (オプション)	出力クエリレイヤーで使用する座標系。ツールの整合チェックにより、結果セットの最初のレコードに基づいてこのプロパティが設定されます。目的の出力座標系に設定されていない場合は、ツールを実行する前に変更できます。クエリの結果セットがジオメトリフィールドを返さない場合、このパラメーターは無視されます。	Spatial Reference
レイヤーの空間プロパティを定義 (オプション)	レイヤーの空間プロパティの定義方法を指定します。整合チェック処理時に、クエリレイヤーに対して次元、ジオメトリタイプ、空間参照、SRID、および一意識別子の各プロパティが設定されます。これらの値は、クエリで返される先頭行に基づいています。テーブルに対するツールのクエリからこれらのプロパティを取得するのではなく、プロパティを手動で定義するために、[レイヤーの空間プロパティの定義] パラメーターがデフォルトでオンになっています。オン - レイヤーの空間プロパティを手動で定義します。これがデフォルトです。オフ - クエリで返される先頭行に基づいてレイヤープロパティが決定されます。	Boolean
座標に M 値を含める (オプション)	レイヤーに M 値が含まれるかどうかを指定します。オン - レイヤーに M 値が含まれます。オフ - レイヤーに M 値は含まれません。これがデフォルトです。	Boolean
座標に Z 値を含める (オプション)	レイヤーに Z 値が含まれるかどうかを指定します。オン - レイヤーに Z 値が含まれます。オフ - レイヤーに Z 値は含まれません。これがデフォルトです。	Boolean
範囲 (オプション)	レイヤーの範囲。このパラメーターは、[レイヤーの空間プロパティの定義] (Python の spatial_properties = DEFINE_SPATIAL_PROPERTIES) がオンの場合のみ使用されます。この範囲にはテーブル内のすべてのフィーチャを含める必要があります。 [デフォルト] - すべての関連する入力の最大範囲に基づく範囲とします。これがデフォルトです。 [現在の表示範囲] - 範囲がデータフレームまたは表示範囲と同じになります。アクティブなマップが存在しない場合、このオプションは使用できません。 [以下の指定に一致] - この範囲は、指定された最小および最大範囲値に基づきます。 [参照] - 範囲は、既存のデータセットに基づきます。	Extent

派生した出力

ラベル	説明	データタイプ
出力レイヤー	出力クエリレイヤー。	テーブルビュー

arcpy.management.MakeQueryLayer(input_database, out_layer_name, query, {oid_fields}, {shape_type}, {srid}, {spatial_reference}, {spatial_properties}, {m_values}, {z_values}, {extent})

名前	説明	データタイプ
input_database	クエリ対象のデータを含むデータベースコネクションファイル。	Workspace
out_layer_name	作成されるフィーチャレイヤーまたはテーブルビューの出力名。	String
query	データベースに発行される SELECT クエリを定義する SQL ステートメント。	String
oid_fields [oid_fields,...] (オプション)	動的で一意な行 ID を生成する、SELECT ステートメントの SELECT リストの 1 つ以上のフィールド。	String
shape_type (オプション)	クエリレイヤーのシェープタイプを指定します。クエリの結果セットに含まれるレコードのうち、指定したシェープタイプに一致するレコードだけが出力クエリレイヤーで使用されます。ツールの整合チェックにより、結果セットの最初のレコードに基づいてこのプロパティが設定されます。目的の出力シェープタイプに設定されていない場合は、ツールを実行する前に変更できます。クエリの結果セットがジオメトリフィールドを返さない場合、このパラメーターは無視されます。 POINT—出力クエリレイヤーはポイントジオメトリを使用します。 MULTIPOINT—出力クエリレイヤーはマルチポイントジオメトリを使用します。 POLYGON—出力クエリレイヤーはポリゴンジオメトリを使用します。 POLYLINE—出力クエリレイヤーはポリラインジオメトリを使用します。	String
srid (オプション)	ジオメトリを返すクエリの空間参照 ID (SRID)。クエリの結果セットに含まれるレコードのうち、指定した SRID 値に一致するレコードだけが出力クエリレイヤーで使用されます。ツールの整合チェックにより、結果セットの最初のレコードに基づいてこのプロパティが設定されます。目的の出力 SRID 値に設定されていない場合は、ツールを実行する前に変更できます。クエリの結果セットがジオメトリフィールドを返さない場合、このパラメーターは無視されます。	String
spatial_reference (オプション)	出力クエリレイヤーで使用する座標系。ツールの整合チェックにより、結果セットの最初のレコードに基づいてこのプロパティが設定されます。目的の出力座標系に設定されていない場合は、ツールを実行する前に変更できます。クエリの結果セットがジオメトリフィールドを返さない場合、このパラメーターは無視されます。	Spatial Reference
spatial_properties (オプション)	レイヤーの空間プロパティの定義方法を指定します。整合チェック処理時に、クエリレイヤーに対して次元、ジオメトリタイプ、空間参照、SRID、および一意識別子の各プロパティが設定されます。これらの値は、クエリで返される先頭行に基づいています。テーブルに対するツールのクエリからこれらのプロパティを取得するのではなく、プロパティを手動で定義するには、このパラメーターのデフォルト値を使用します。 DEFINE_SPATIAL_PROPERTIES—レイヤーの空間プロパティを手動で定義します。これがデフォルトです。 DO_NOT_DEFINE_SPATIAL_PROPERTIES—クエリで返される先頭行に基づいてレイヤープロパティが決定されます。	Boolean
m_values (オプション)	レイヤーに M 値が含まれるかどうかを指定します。 INCLUDE_M_VALUES—レイヤーに M 値が含まれます。 DO_NOT_INCLUDE_M_VALUES—レイヤーに M 値は含まれません。これがデフォルトです。	Boolean
z_values (オプション)	レイヤーに Z 値が含まれるかどうかを指定します。 INCLUDE_Z_VALUES—レイヤーに Z 値が含まれます。 DO_NOT_INCLUDE_Z_VALUES—レイヤーに Z 値は含まれません。これがデフォルトです。	Boolean
extent (オプション)	レイヤーの範囲。このパラメーターは、[レイヤーの空間プロパティの定義] (Python の spatial_properties = DEFINE_SPATIAL_PROPERTIES) がオンの場合のみ使用されます。この範囲にはテーブル内のすべてのフィーチャを含める必要があります。 MAXOF - すべての入力の最大範囲が使用されます。 MINOF - すべての入力に共通する最小領域が使用されます。 DISPLAY - 範囲は、表示範囲と同じになります。 [レイヤー名] - 指定したレイヤーの範囲が使用されます。 Extent オブジェクト - 指定したオブジェクトの範囲が使用されます。 [座標のスペース区切りの文字列] - 指定した文字列の範囲が使用されます。座標は、x-min、y-min、x-max、y-max の順序で表されます。	Extent

派生した出力

名前	説明	データタイプ
out_layer	出力クエリレイヤー。	テーブルビュー

コードのサンプル

MakeQueryLayer (クエリレイヤーの作成) の例 1 (Python ウィンドウ)

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

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)

MakeQueryLayer (クエリレイヤーの作成) の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトで、この 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)

サマリー

使用法

パラメーター

注意:

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容