データベース内のデータのクエリレイヤーを作成—ArcGIS Pro

データベースレイヤーをマップ上にドラッグして、クエリレイヤーを自動的に作成するか、[マップ] タブの [データの追加] ボタンを使用して、クエリレイヤーをマップ内に作成することができます。

ヒント:

このページでは、データベース内のテーブルのクエリレイヤーを作成する方法を説明します。クラウドデータウェアハウス内のデータにアクセスする場合は、「クラウドデータウェアハウス内のデータのクエリレイヤーを作成」をご参照ください。

ジオデータベースシステムテーブルにアクセスするクエリレイヤーはサポートされていません。

前提条件とワークフロー

クエリレイヤーを作成する前に、「クエリレイヤー向けのデータベースとクライアントの構成」に目を通しておいてください。

次に、以下の各サブセクションを参照し、[新しいクエリレイヤー] ダイアログボックスを使用してデータベースのクエリレイヤーを作成する際に実行するワークフローを確認してください。

データベースへの接続

クエリレイヤーを定義する前に、クエリ対象のデータベースに接続しておく必要があります。

「ArcGIS Pro でのデータベースコネクション」の記載に従って [カタログ] ウィンドウでデータベース接続を作成し、プロジェクトに追加した後、そのデータベース接続を [新しいクエリレイヤー] ダイアログボックスから選択することができます。また、[新しいクエリレイヤー] ダイアログボックスからデータベース接続を作成することもできます。

SQL クエリの定義

[クエリ] テキストボックスに SQL クエリを指定して、テーブルまたはビューから必要なデータにアクセスします。

SQL クエリを [クエリ] テキストボックスに貼り付けるか、準備された SQL クエリがなく、テーブルのリストを表示する必要がある場合は、[テーブルの一覧] チェックボックスをオンにします。リストに表示されているテーブルと列をダブルクリックし、SQL クエリをダブルクリックするか、[テーブルの一覧] ウィンドウから [クエリ] テキストボックスまでドラッグして、SQL クエリを構築することができます。

データベースの各列にはそれぞれデータタイプが設定されています。 ArcGIS では、ほとんどの一般的なデータベースタイプを使用できます。ただし、一部のデータベースタイプはサポートされていません。属性列のタイプに不明と表示されている場合は、ArcGIS がサポートしていないデータタイプであることを示します。クエリを指定するときには、データタイプが不明の列をすべて除外するか、ArcGIS でサポートされているデータタイプにクエリで変更する必要があります。データベースごとにサポートされているデータタイプのリストについては、「ArcGIS でサポートされている DBMS のデータタイプ」をご参照ください。

クエリレイヤーを構築する際には、そのデータベースに固有の SQL 構文を使用します。一般的な例は、SELECT * FROM Test.myuser.US_States のようになります。この場合は、US_States テーブル内のすべての行を含むクエリレイヤーが作成されます。マップに米国全体が表示されます。

SQL クエリの変数の使用法については、「クエリレイヤーのパラメーターの定義」をご参照ください。

SQL ステートメントの整合チェック

SQL クエリを定義したら、その整合チェックを実行します。整合チェック中に、ArcGIS では、テーブル内に最初に返された行のプロパティを使用して、クエリの整合性を確認します。

また、ArcGIS では、ArcGIS 要件を満たすために、クエリから最初に返された行のプロパティを使用して、マップに表示される他の行をフィルタリングします。たとえば、ArcGIS では、空間テーブル内の 1 つの空間参照しかサポートしていません。フィーチャクラス内のフィーチャごとに異なる空間参照 ID (SRID) が使用されている場合、クエリレイヤーはデフォルトで、クエリから最初に返されたフィーチャと同じ SRID を持つ行だけを返します。同様に、ArcGIS では、テーブルごとに 1 つのジオメトリタイプしかサポートしていません。デフォルトでは、クエリから最初に返された行と同じジオメトリタイプを持つフィーチャだけがマップに表示されます。別の SRID またはジオメトリタイプを使用するには、クエリレイヤーの空間プロパティを定義します。

一意識別子の指定

一意識別子は、テーブル内の各行を識別するために ArcGIS で使用される 1 つまたは複数の列です。

整合チェック中に、ArcGIS では、テーブルの 1 つの一意識別子列を識別しようとします。適切な列が見つかった場合は、その列をクエリレイヤーに使用できます。一意識別子が見つからない場合や別の一意識別子を使用したい場合は、ダイアログボックスの次のパネルで新しい一意識別子を定義できます。

クエリレイヤーを含むフィーチャレイヤーを公開する場合、クエリレイヤーの一意識別子フィールドは、データベースで管理された NULL 以外の一意の単一列にする必要があります。

空間プロパティの定義 (オプション)

空間列を含むフィーチャクラスまたはビューの場合、以下を定義するか、整合チェック時に ArcGIS が検出したデフォルト値を使用します。

ジオメトリタイプ - レイヤーがポイント、マルチポイント、ライン、またはポリゴンフィーチャのどれを格納するかを決定します。
Z 値と M 値 - これらのオプションは、Z 座標または M 座標を持つフィーチャをレイヤーに含めるかどうかを決定します。
空間参照 - レイヤーの座標系とその他の関連空間プロパティを表します。
データベース内のフィーチャに設定された現在の SRID 値に基づいて、空間参照を正確に確定できない場合があります。この場合は、クエリレイヤーの空間参照が不明になるため、空間参照を定義する必要があります。このことはクラウドデータウェアハウスには当てはまらないので、クラウドデータウェアハウスでは空間参照を定義できません。
注意:
クエリレイヤーの空間参照を定義しても、データは再投影されず、ArcGIS でクエリの結果をマッピングする際に使用する空間参照が定義されるだけです。
SRID - レイヤーの空間参照 ID を表し、クエリで空間参照 ID が同じジオメトリだけを返すために使用されます。クエリレイヤーが空間フィールドを持たない場合は、SRID 値はブランクです。値が設定されている場合、指定したジオメトリ SRID 値を持たないフィーチャはすべて結果セットから除外されます。データベース内のデータにカスタム SRID が使用されている場合は、その SRID をクエリレイヤーの空間プロパティで指定する必要があります。このことはクラウドデータウェアハウスには当てはまりません。

データベーステーブルのクエリレイヤーを作成

クエリ対象のテーブルに何十万ものレコードが含まれていない場合は、そのテーブルをマップ上にドラッグして、クエリレイヤーを自動的に作成することができます。大規模なデータセットの場合は、[新しいクエリレイヤー] ダイアログボックスを使用してクエリレイヤーを定義します。

テーブルをマップ上にドラッグ

[カタログ] ウィンドウ内のデータベース接続から、データベースフィーチャクラス、テーブル、またはビューをマップ上にドラッグすると、ArcGIS Pro は、そのフィーチャクラス、テーブル、またはビューからすべての行とフィールドを選択するクエリレイヤーを自動的に作成します。これは、データベースにのみ適用されますが、エンタープライズジオデータベースには適用されません。

レイヤーをマップにドラッグすると、ArcGIS Pro でそのレイヤーの範囲が計算されます。多数のフィーチャを含むテーブルを追加する場合は、範囲の計算に時間がかかる場合があります。データの範囲を知っている場合や、範囲の計算を待たずに独自の空間参照の範囲を使用したい場合は、そちらを選択できます。 [範囲の計算] ダイアログボックスで該当するボタンをクリックします。 [範囲の入力] をクリックした場合は、テーブル内のすべてのフィーチャを含む有効な範囲を入力する必要があります。

レイヤーをマップに追加したら、必要に応じてクエリレイヤーを変更できます。

クエリの定義

[新しいクエリレイヤー] ダイアログボックスを使用して ArcGIS Pro プロジェクトのマップ内にクエリレイヤーを定義するには、次の手順を実行します。

クエリレイヤーを追加するマップを ArcGIS Pro で開きます。
[マップ] リボン上の [データの追加] ボタンをクリックして、ドロップダウンリストから [クエリレイヤー] ボタンを選択します。
[新しいクエリレイヤー] ダイアログボックスが表示されます。
次のいずれかの方法で接続を指定します。
- 接続ファイル (*.sde) がプロジェクト内にすでに存在する場合は、ドロップダウンリストからそのファイルを選択します。
- プロジェクトに接続が存在していない場合は、新しいデータベース接続ボタンを選択して新しい接続を作成します。
[名前] テキストボックスに、作成するクエリの名前を指定します。
この名前は、マップの [コンテンツ] ウィンドウに表示されます。
[クエリ] テキストボックスに SQL クエリを入力するか貼り付けます。
テーブルとその列を一覧表示するには、[テーブルの一覧] チェックボックスをオンにします。 [テーブルの一覧] セクション内のテーブルをダブルクリックして、そのテーブル内のすべての列を [クエリ] テキストボックスに追加し、[クエリ] テキストボックスでクエリを編集することができます。たとえば、クエリレイヤーに含まれるデータを制限するために、含めたくない列をクエリから削除したり、クエリに項目を追加したりすることができます。
レイヤーの空間プロパティを定義する方法を指定します。
- [ArcGIS Pro でレイヤーの空間プロパティを検索] (デフォルトオプション) を選択して、クエリから最初に返された行の空間プロパティを ArcGIS Pro で使用できるようにします。 SQL ステートメントの整合チェックを実行する際に、ArcGIS Pro でこれらのプロパティが検索されます。
- 最初の行の空間プロパティとは異なる空間プロパティを持つフィーチャをレイヤーに含める場合は、[レイヤーの空間プロパティの定義] を選択します。
クエリの構文が正しいかどうかと ArcGIS でそのクエリを使用できるかどうかを確認するための整合チェックを実行する必要があります。 [整合チェック] をクリックして、整合チェックプロセスを開始します。
整合チェックでは、データベースに対してクエリを実行し、クエリから返された結果セットが ArcGIS のデータモデリング標準に従っているかどうかを確認します。クエリレイヤーは、整合性が確認されるまでマップに追加されません。
整合チェックルールとして、次を満たしていることが確認されます。
- 結果セットの持つ空間フィールドは 1 つだけである。
- 結果セットが持つ空間参照は 1 つだけである。
- 結果セットが持つシェープタイプは 1 つだけである。
- 結果セットに、ArcGIS のサポートしないフィールドタイプは含まれていない。
何らかの理由で整合チェックに失敗した場合は、エラーメッセージが返されるため、クエリを修正する必要があります。
整合チェックは、対象のデータが ArcGIS と同じ標準を使用しない空間データベース内のデータである場合に特に重要になります。
クエリが整合チェックに合格したら、[次へ] をクリックします。
クエリレイヤーの一意識別子フィールドを選択するか、ArcGIS Pro で選択されたフィールドを使用します。
マップのすべてのフィーチャには一意識別子が必要です。したがって、クエリレイヤーには、各フィーチャの値を含む一意識別子が含まれている必要があります。詳細については、「クエリレイヤーの一意識別子フィールドの選択」をご参照ください。
ジオメトリタイプと空間参照を選択します。
ArcGIS Pro が空間プロパティを決定できることを選択した場合は、これらのパラメーターがすでに設定されている可能性があります。
1. ドロップダウンメニューからジオメトリタイプを選択します。
2. [座標系] ボタンをクリックして、データで使用される空間参照の座標系を選択するか、既存のデータセットから空間参照をインポートします。ただし、これによってデータが再投影されることはありません。
ArcGIS Pro で空間プロパティが定義されることをステップ 6 で選択した場合は、[完了] をクリックして、クエリレイヤーをマップに追加します。
レイヤーの空間プロパティを定義することをステップ 6 で選択した場合は、上記のダイアログボックスに追加セクションが表示されます。 [レイヤー範囲プロパティ] セクションでは、次のいずれかを選択して、クエリレイヤーの空間範囲を指定する必要があります。
- [範囲の入力] - [次へ] をクリックした際に、範囲を入力する必要があります。必ず有効な範囲を指定し、テーブル内のすべてのフィーチャを範囲に含める必要があります。
- [マップ範囲を使用] - 現在のマップの範囲がクエリレイヤーの範囲として使用されます。 [次へ] をクリックして、マップ範囲の値を確認します。
- [空間参照範囲の使用] - データの空間参照の範囲がクエリレイヤーの範囲として使用されます。一部の空間参照では、この範囲は地球全体になります。 [次へ] をクリックして、空間参照範囲の値を確認します。
レイヤーの範囲の設定または確認が終了したら、[完了] をクリックして、クエリレイヤーをマップに追加します。