クラウドデータウェアハウス内のデータのクエリレイヤーを作成—ArcGIS Pro

[新しいクエリレイヤー] ダイアログボックスからクエリレイヤーを作成して、クラウドデータウェアハウス内のデータにアクセスします。最高のパフォーマンスを得るには、データウェアハウスの検索に使用する ArcGIS Pro クライアントをデータウェアハウスと同じクラウド環境とリージョンにインストールします。

ヒント:

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

前提条件とワークフロー

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

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

データウェアハウスへの接続

クエリレイヤーを定義する前に、データウェアハウスへの接続を確立しておく必要があります。

[カタログ] ウィンドウにデータベースコネクションを作成 (「ArcGIS Pro のクラウドデータウェアハウスへの接続」で説明) し、プロジェクトに追加して、[新しいクエリレイヤー] ダイアログボックスから参照できます。または、[新しいクエリレイヤー] ダイアログボックスからコネクションを作成することもできます。

SQL クエリの定義

[クエリ] テキストボックスに SQL (Structured Query Language) クエリを指定して、ウェアハウス内のデータから必要なデータにアクセスします。多数の行を含むテーブルまたはビューにアクセスする場合、定義したクエリはレイヤーに含まれる行数を制限する必要があります。たとえば、フィーチャがビンに集約されていない場合、マップ上に何百万ものフィーチャを実際に表示することはできません。そのようなテーブルまたはビューの場合、データのサブセットを返すクエリを使用します。

クエリレイヤーを構築する際には、そのデータウェアハウスに固有の SQL 構文を使用します。

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

詳細については、「ArcGIS でサポートされているクラウドデータウェアハウスのデータタイプ」をご参照ください。

ヒント:

SQL クエリの変数の使用法については、「クエリレイヤーのパラメーターの定義」をご参照ください。
準備された SQL クエリがなく、テーブルのリストを表示する必要がある場合は、[テーブルの一覧] チェックボックスをオンにします。リストに表示されたテーブルと列をダブルクリックして、SQL クエリを構築できます。
クエリに外部テーブルを含めると、描画およびクエリのパフォーマンスが低下することがあります。

マテリアライズドビューの作成

データウェアハウス内に大量のデータを含むテーブルにアクセスし、クエリが返すフィーチャ総数を妥当な数に制限する SQL クエリを定義する場合、データにアクセスする際のクエリパフォーマンスを向上させるために、そのクエリをマテリアライズドビューとしてデータベースに格納します。

[新しいクエリレイヤー] ダイアログボックスでマテリアライズドビューを作成すると、ビュー定義はクエリレイヤーに指定した SQL クエリになります。クエリレイヤーは、クエリレイヤーを操作するたびに SQL クエリを実行するのではなく、マテリアライズドビューにアクセスします。

Google BigQuery でマテリアライズドビューを作成した場合、有効期限が切れるようにマテリアライズドビューを構成できます。何日もビューを必要としない場合は、これを実行して、格納されたマテリアライズドビューが変更されないようにしてください。

SQL クエリに変数が含まれている場合または SQL クエリがビュー用に定義されている場合は、マテリアライズドビューを作成できません。クエリに外部テーブルを含めると、マテリアライズドビューを作成できません。

ヒント:

クエリレイヤーに関連付けられているマテリアライズドビューの名前を確認するには、マップ内のクエリレイヤーの [レイヤープロパティ] ダイアログボックスを開きます。クラウドデータウェアハウス内のこのビューを削除または変更しないでください。

特定のデータソースでのマテリアライズドビューのサポート状況については、クラウドデータウェアハウスベンダーが提供するドキュメントをご参照ください。

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

SQL クエリを定義し、マテリアライズドビューを作成したら、SQL ステートメントを整合チェックします。整合チェック中に、ArcGIS では、テーブル内に最初に返された行のプロパティを使用して、クエリの整合性を確認します。

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

一意識別子の指定

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

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

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

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

ジオメトリタイプ - レイヤーがポイント、マルチポイント、ライン、またはポリゴンフィーチャのどれを格納するかを決定します。
空間参照 - レイヤーの座標系とその他の関連空間プロパティを表します。
注意:
クエリレイヤーの空間参照を定義しても、データは再投影されず、ArcGIS でクエリの結果をマッピングする際に使用する空間参照が定義されるだけです。
Google BigQuery の検索時には、空間参照を定義できません。
SRID - レイヤーの空間参照 ID を表し、クエリで空間参照 ID が同じジオメトリだけを返すために使用されます。クエリレイヤーが空間フィールドを持たない場合は、SRID 値はブランクです。値が設定されている場合、指定したジオメトリ SRID 値を持たないフィーチャはすべて結果セットから除外されます。

クラウドデータウェアハウス内のデータにアクセスするクエリレイヤーを作成

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

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