ProConcepts Geodatabase - EsriJapan/arcgis-pro-sdk GitHub Wiki

粒度の細かい Geodatabase API を使用する機能。Geodatabase API の機能は、ArcGIS.Core.dll にあります。Geodatabase API は通常、マップの探索、マップのオーサリング、および編集と組み合わせて使用​​されます。

Language:      C#
Subject:       Geodatabase
Contributor:   ArcGIS Pro SDK Team <[email protected]>
Organization:  Esri, http://www.esri.com
Date:          10/06/2024
ArcGIS Pro:    3.4
Visual Studio: 2022

• アーキテクチャ
  • リソース管理
  • 名前空間と拡張メソッド
  • ジオデータベース アイテム
• データストア
  • ジオデータベース
    • QueryDef
    • QueryTable
  • データベース
    • クエリ レイヤー
  • フィーチャ サービス
  • シェープファイル
    • ObjectIDs vs FeatureIDs
    • フィールドとインデックスの制限
  • CAD ファイル
• フィーチャ データの操作
  • データセット
    • テーブル
    • フィーチャクラス
    • フィーチャ データセット
    • リレーションシップ クラス
    • 属性付きのリレーションシップ クラス
    • リアルタイム データセット
  • Definition
  • フィールド
    • 64 ビット ObjectId と BigInteger
    • DateOnly と Timeonly
    • TimestampOffset
    • Precision と Scale
  • ドメイン
  • サブタイプ
  • データのクエリ
    • QueryFilter
      • Where 句
      • ObjectID のクエリ
      • 選択
      • 検索
      • ページネーション
      • 行とフィーチャの操作
      • リサイクル
    • SQL 構文
    • 結合
    • テーブルのソート
    • 統計計算
    • 異なるクエリ構文を使用する場合
  • バージョニング
    • パーシャル ポスト
    • コンフリクト
  • アーカイブと履歴管理
  • リレーションシップクラスの操作
  • 添付ファイル
    • 添付ファイルの追加
    • 添付ファイルへのアクセス
    • 添付ファイルの更新
    • 添付ファイルの削除
  • 条件値
  • 属性ルール
• データストアの編集
  • アドイン モードでの編集
  • スタンドアロン モードでの編集
• その他のトピック
  • SQL の実行
  • MCT の除外項目
  • ユニークなインスタンス化
  • ジオプロセシングでのジオデータベース オブジェクトの使用

• ArcGIS.Core.Data API は、主に DML（データ操作言語）に重点を置いています。限定的な DDL（データ定義言語）機能については、DDL ProConcepts ドキュメント で説明されています。

API リファレンスに記載されているように、ArcGIS.Core.Data API のほとんどすべてのメソッドは、メイン CIM スレッド（MCT）で呼び出す必要があります。これらのメソッド呼び出しは、QueuedTask.Run 呼び出し内にラップする必要があります。そうしないと、ConstructedOnWrongThreadException がスローされます。

ほとんどの場合、メモリ管理の問題を処理するために、.NET によって提供される組み込みのガベージコレクションに安全に依存できます。ガベージコレクターは、実行時に、デッド .NET オブジェクトからすべてのメモリを再利用し、ライブ オブジェクトが使用するメモリを圧縮して、マネージヒープのサイズを縮小します（ガベージコレクションの詳細については、こちら をご覧ください）。ただし、Pro SDK Core.Data API は管理されていないリソース（つまり、ガベージコレクションによって管理されていないリソース）を使用するため、アプリケーションによって明示的に解放される必要があります。管理されていないリソースには、ファイルロック、データベース接続、ネットワーク接続などがあります。

アンマネージリソースを処理するための .NET には、Object.Finalizeを使用する暗黙的な制御パターン と IDisposable.Disposeを使用する明示的な制御パターン の2つのパターンがあります。 ArcGIS.Core.Data API は、両方を提供します。推奨されるパターンは、使用が終了したら Dispose を呼び出して、基になるアンマネージリソースを明示的に解放することです。Dispose は、アンマネージリソースを解放して、基になるファイルロックまたはアクティブなデータベース接続を解放します（Dispose を呼び出す「using」構造を使用することもできます。Pro スニペットとサンプルには「using」の例が多数あります）。

Finalize を使用する暗黙の制御パターンは、開発者が Dispose の呼び出しを忘れたり、呼び出さないことを選択した場合でも、アンマネージリソースを解放できるようにするためのフェイルセーフと見なす必要があります。ただし、アンマネージリソースは、オブジェクトがガベージコレクションされるまで（将来のある時点で）解放されないため、オブジェクトによって保持されているファイルロックまたはデータベース接続は、ファイナライズされるまで使用され続けます。アンマネージリソースの暗黙的な解放によっては、リソースがまだロックされている、またはリソースを取得したオブジェクトがスコープ外になった場合でも接続が消費されるなど、予期しない動作が発生する可能性があります。

Dispose の使用法は明白に見えるかもしれませんが、開発者は意図せずに Core.Data インスタンスを取得するコードに注意する必要があります。たとえば、.NET 呼び出しのシーケンスをチェーンして、ジオデータベース階層をナビゲートするコードについて考えてみます。便利でコンパクトに見える次の2つのステートメントは、実際には問題があります。

Geodatabase gdb = featureLayer.GetFeatureClass().GetDatastore() as Geodatabase;

そして

var id = row.GetTable().GetID();

前者の場合、フィーチャクラスインスタンスが取得され、後者の場合、テーブルインスタンスが取得され、どちらも破棄されません。開発者は、ガベージコレクションが行われるまで、管理されていないリソースを保持するフィーチャクラスやテーブルインスタンスを間接的にインスタンス化したことにおそらく気づいていません。代わりに、これらのステートメントをコーディングする正しい方法は、Core.Data インスタンスを変数として明示的に取得し、使用後にそれらを破棄することです。using ステートメントは、これを実現するための便利な方法です。  

using (FeatureClass featureClass = featureLayer.GetFeatureClass())
using (Geodatabase gdb = featureClass.GetDatastore() as Geodatabase)
{
  // etc.
}

using (Table table = row.GetTable())
{
  var id = table.GetID();
  // etc.
}	

using ステートメントのもう1つの利点は、using のスコープ内で実行されているコードが例外をスローした場合でも、Dispose が確実に呼び出されることです。

考慮すべきもう1つのユースケースは、API メソッドが Core.Data オブジェクトのリストを返す場合です。たとえば、IReadOnlyList <Dataset> を返す Table.GetControllerDatasets() について考えてみます。この場合、using ステートメントでは不十分であり、各リスト項目を個別に破棄する必要があります。

  IReadOnlyList<Dataset> controllerDatasets = table.GetControllerDatasets();

  // Do something with the list

  foreach (Dataset dataset in controllerDatasets)
  {
    dataset.Dispose();
  }

インスタンスで Dispose が呼び出されると、アンマネージリソース（ほぼすべて）にアクセスするメソッドまたはプロパティのいずれかを呼び出すと、ArcGIS.Core.ObjectDisconnectedException が発生します。

Geodatabase API のほとんどのクラスは、ArcGIS.Core.Data 名前空間に存在します。ArcGIS.Core.Data の必要なオブジェクトを、アーキテクチャスタックの上位レベルで ArcGIS Pro と統合する必要がある場合があります。このような場合、C#拡張メソッドが提供されます。これらの拡張メソッドを使用するには：

• ArcGIS.Desktop.Extensions への参照をソリューションに追加します
• using ArcGIS.Core.Data.Extensions; をソースファイルの先頭に追加します

これらの手順により、これらの拡張メソッドを、ジオデータベースクラスの通常のメソッドであるかのように表示できます。

これらの拡張メソッドは、ArcGIS Pro アドインでの使用を目的としており、CoreHost アプリケーションでは使用できません。

Pro 内では、ジオデータベース コンテンツは、フォルダー接続、ファイルパス、または参照ダイアログのいずれかを介してディスク上で参照または検索できます。いずれの場合も、ジオデータベース コンテンツを参照または検索すると、ArcGIS.Desktop.Core.Items が取得されます。アイテムから基になるジオデータベース データセットにアクセスするには、ProConcepts Content and Items を参照してください。

Datastore は、フィーチャクラス、ラスタデータセット、およびテーブルのような空間および非空間データセットのコンテナです。

ArcGIS.Core.Data API では、Datastore はデータセットのコンテナとして機能するあらゆるオブジェクトを表す抽象クラスです。例えば、Geodatabase は Datastore を継承し、ファイル ジオデータベース、モバイル ジオデータベース、エンタープライズ ジオデータベース、および feature service ジオデータベースの Datastore タイプをサポートします。すべての Datastore タイプがすべてのタイプの属性フィールドやストレージ タイプ プロパティをサポートしているわけではないことに注意することが重要です。GetDatastoreProperties() メソッドは DatastoreProperties クラスを返し、どの Datastore タイプがどのプロパティをサポートしているかを指定する。同様に、 Datastore 型の中にはデータストアのプロパティをサポートしていないものもあります。サポートされているかどうかは Datastore.AreDatastorePropertiesSupported プロパティを呼び出すことで確認できます。

// Check if a datastore supports datastore properties
bool areDatastorePropertiesSupported = geodatabase.AreDatastorePropertiesSupported();

if (areDatastorePropertiesSupported)
{
	DatastoreProperties datastoreProperties = geodatabase.GetDatastoreProperties();

	// Supports 64-bit integer field
	bool supportsBigInteger = datastoreProperties.SupportsBigInteger;

	// Supports pagination
	bool supportsQueryPagination = datastoreProperties.SupportsQueryPagination;

	// Supports datastore edit 
	bool canEdit = datastoreProperties.CanEdit;

	// Supports 64-bit Object ID
	bool supportsBigObjectId = datastoreProperties.SupportsBigObjectID;

	// Supports DateOnly field
	bool supportsDateOnly = datastoreProperties.SupportsDateOnly;

	// Supports TimeOnly field
	bool supportsTimeOnly = datastoreProperties.SupportsTimeOnly;

	// Supports TimestampOffset field
	bool supportsTimestampOffset = datastoreProperties.SupportsTimestampOffset;
}

注：Datastore は、ArcObjects API の Workspace と概念的に同等の抽象化です。

概念的には、ArcGIS ジオデータベースは、共通のファイルシステムフォルダーに保持されている、REST サービスによって管理されている、またはマルチユーザーリレーショナル DBMS（Oracle、Microsoft SQL Server、PostgreSQL、SAP HANA、IBM DB2 等）に格納されているさまざまなタイプの地理データセットのコレクションです。ジオデータベースには様々なサイズがあり、ユーザー数も様々で、ファイルをベースにした小規模なシングルユーザーのデータベースから、多くのユーザーがアクセスする大規模なワークグループ、部門、企業のジオデータベースまで幅広く対応しています。

ArcGIS.Core.Data API では、Geodatabase クラスは ArcGIS のネイティブデータ構造を表し、編集とデータ管理に使用される主要なデータ形式です。ArcGISは、多数の地理情報システム（GIS）ファイル形式の地理情報を処理しますが、ジオデータベースの機能を操作して活用するように設計されています。

ファイル ジオデータベース、モバイル ジオデータベース、エンタープライズ ジオデータベース、および フィーチャ サービス ジオデータベースは、Geodatabase クラスを使用して開くことができます。このクラスは、さまざまなタイプのジオデータベースをサポートするために、オーバーロードされたコンストラクターのリストを公開します。

ファイル ジオデータベースを開くには、次のように FileGeodatabaseConnectionPath のインスタンスを Geodatabase コンストラクターに渡す必要があります。

Geodatabase fileGeodatabase = new Geodatabase(new FileGeodatabaseConnectionPath(new Uri(@"path\to\the\file\geodatabase")));

モバイル ジオデータベースを開くには、 MobileGeodatabaseConnectionPath のインスタンスを次のように Geodatabase コンストラクターに渡す必要があります。

Geodatabase mobileGeodatabase = new Geodatabase(new MobileGeodatabaseConnectionPath(new Uri(@"path\to\the\mobile\geodatabase")));

SDE接続ファイル または一連の 接続プロパティ を使用してエンタープライズジオデータベースを開くには、次の2つの方法があります。

Geodatabase enterpriseGeodatabaseViaConnectionFile = new Geodatabase(new DatabaseConnectionFile(new Uri(@"path\to\the\sde\file")));

DatabaseConnectionProperties connectionProperties = new DatabaseConnectionProperties(EnterpriseDatabaseType.SQLServer)
{
  AuthenticationMode = AuthenticationMode.DBMS,
  Instance           = "machineName\\instanceName",
  Database           = "databaseName",
  User               = "username",
  Password           = "Not1234"
  Version            = "dbo.DEFAULT"
};

Geodatabase enterpriseGeodatabaseViaConnectionProperties = new Geodatabase(connectionProperties);

余談ですが、接続ファイルがあり、接続プロパティを抽出したい場合は、静的メソッドDatabaseClient.GetDatabaseConnectionProperties() を使用してこれを実行できます。これは、接続ファイル内のユーザープロパティとパスワードプロパティを置き換える場合に役立ちます。ユーザー名とパスワードの情報が欠落している接続ファイルを使用して、エンタープライズ ジオデータベースへの接続を開くことはできません。

ジオデータベース オブジェクトを取得する別の方法は、ArcGIS.Core.Data.Dataset.GetDatastore() を使用することです。これにより、ArcGIS.Core.Data.Datastore 参照が返されます。 基になるデータストアがジオデータベースである場合は、それをジオデータベースにキャストして、ジオデータベース インターフェイスにアクセスできます。

QueryDef は、ジオデータベース データストアにクエリを実行してカーソルを取得できるようにする構造です。QueryDef を使用すると、where 句、prefix 句、postfix 句、サブフィールド、およびクエリを実行するテーブルを含むクエリに基づいて、単一のテーブルからカーソルを生成できます。また、ジオデータベース内の2つ以上のテーブル間の結合を作成するために使用することもできます。

QueryDef クラスは、クエリの詳細 を指定するためのプロパティを提供します。Geodatabase クラスの Evaluate メソッドは、QueryDef オブジェクトを受け取り、クエリを満たす行へのアクセスを提供する RowCursor を返します。Evaluate メソッドには、カーソルから連続する行を返すときにリサイクルを使用するかどうかを指定するブール パラメーターもあります。

QueryDef queryDef = new QueryDef
{
  Tables      = "Highways",
  WhereClause = "TYPE = 'Paved Undivided'",
};

using (RowCursor rowCursor = geodatabase.Evaluate(queryDef, false))
{
  while (rowCursor.MoveNext())
  {
    using (Row row = rowCursor.Current)
    {
      Feature feature = row as Feature;
      Geometry shape  = feature.GetShape();

      string type = Convert.ToString(row["TYPE"]); // Will be "Paved Undivided" for each row.
	
      try
      {
        Table table = row.GetTable(); // Will always throw exception because rows retrieved from QueryDef do not have a parent table.
      }
      catch (NotSupportedException exception)
      {
        // Handle not supported exception.
      }
    }
  }
}

以下は、QueryDef の評価を実行する際に考慮すべきいくつかの事項です。

• エンタープライズ ジオデータベースの QueryDef のサブフィールドには、同じ名前の列を複数含めることはできません。
• フィールドエイリアスは、QueryDef の Subfields プロパティではサポートされていません。
• サブフィールドに Shape フィールドが指定されている場合、RowCursor.Current から返されるオブジェクトは Feature オブジェクトです。
• 結合が含まれている場合、QueryDef の評価では、結合の左側のテーブルの Shape フィールドのみがサポートされます。

注：ジオメトリは 不変 であるため、.NET ガベージコレクタによって管理されます。IDisposable を実装する Row と同じ意味でリサイクル可能ではありません（リサイクルでは、メモリが再利用される前にオブジェクトの処理が完了することが想定されます。マルチスレッド環境では、同時に使用できるため、これはできません）。将来のリリースでは、ジオメトリのリサイクルのサポートが追加される可能性があります。

クエリテーブルは、同じ ジオデータベースの1つ以上のテーブルを含むクエリを表す仮想テーブルです。クエリテーブルが作成されると、shape 列が含まれているかどうかに応じて、読み取り専用テーブルまたはフィーチャクラスとして返されます。クエリテーブルの主な用途のいくつかは、クエリテーブルをレイヤーとしてマップに追加し、他の読み取り専用テーブルまたはフィーチャクラスとして使用して検索を実行し、テーブルを使用してジオプロセシング分析ツールを操作することです。QueryTable に対する選択は、エンタープライズ ジオデータベースではサポートされていません。マップに追加すると、クエリテーブルは保存時にプロジェクト内に保持されます。クエリに含まれるテーブルに変更が加えられた場合、それは仮想テーブルであるため、クエリテーブルに反映されます。

クエリテーブルを作成するための最初のステップは、QueryDef を作成することです。次に、QueryDef を使用して QueryTableDescription を作成します。設定できるその他のプロパティには、クエリテーブルの名前、および ObjectID を作成するためのキーフィールドのコンマ区切りリストが含まれます。MakeCopy ブール プロパティが true に設定されていて、キーフィールドが設定されていない場合、データのローカル クライアント側のコピーがクエリテーブルの生成に使用されます。最後に、QueryTableDescription を使用して、Geodatabase.OpenQueryTable(QueryTableDescription) を呼び出して ArcGIS.Core.Data.Table を取得します。

using (Geodatabase geodatabase = new Geodatabase(new FileGeodatabaseConnectionPath(new Uri("path\\to\\gdb"))))
{
  QueryDef queryDef = new QueryDef
  {
    Tables    = "CommunityAddress JOIN MunicipalBoundary on CommunityAddress.Municipality = MunicipalBoundary.Name",
    SubFields = "CommunityAddress.OBJECTID, CommunityAddress.Shape, CommunityAddress.SITEADDID, CommunityAddress.ADDRNUM, CommunityAddress.FULLNAME, CommunityAddress.FULLADDR, CommunityAddress.MUNICIPALITY, MunicipalBoundary.Name, MunicipalBoundary.MUNITYP, MunicipalBoundary.LOCALFIPS",
  };

  QueryTableDescription queryTableDescription = new QueryTableDescription(queryDef)
  {
    Name        = "CommunityAddrJounMunicipalBoundr",
    PrimaryKeys = geodatabase.GetSQLSyntax().QualifyColumnName("CommunityAddress", "OBJECTID")
  };
  
  Table queryTable = geodatabase.OpenQueryTable(queryTableDescription);
}

Database データストアは、エンタープライズ データベースまたは SQLite データベース を表します。テーブルとフィーチャクラスを開く、定義の取得、テーブルの一覧表示などのデータベース機能へのアクセスを提供しますが、バージョン管理、アーカイブ、整合チェック、リレーションシップクラスなどのジオデータベース機能はサポートしていません。エンタープライズ ジオデータベースはデータベース データストアを介して開くことができますが、データベースに関連付けられた機能へのアクセスのみを提供するため、このアプローチはお勧めしません。

データベース データストアのインスタンスは、次のタイプの Connector を使用する3つのコンストラクタのいずれかを使用して開くことができます -- DatabaseConnectionProperties、 DatabaseConnectionFile、 SQLiteConnectionPath。

DatabaseConnectionProperties は、エンタープライズ データベース プラットフォーム（EnterpriseDatabaseType 列挙型で指定）を指定し、そのプラットフォームに固有の接続の詳細は、DatabaseConnectionProperties のプロパティを使用して指定できます。

// SQL Server
DatabaseConnectionProperties databaseConnectionProperties = new DatabaseConnectionProperties(EnterpriseDatabaseType.SQLServer)
{
  AuthenticationMode = AuthenticationMode.DBMS,
  Instance           = "machine\\instance",
  Database           = "database",
  User               = "username",
  Password           = "password"
};

Database database = new Database(databaseConnectionProperties); 

DatabaseConnectionFile は、.sde 接続ファイルのファイルの場所への URI を受け取ります。

Database database = new Database(new DatabaseConnectionFile(new Uri("path\\to\\.sde\\file")));

SQLiteConnectionPath は、SQLite データベースファイルの場所への URI を受け取ります。

Database database = new Database(new SQLiteConnectionPath(new Uri("path\\to\\sqlite\\file")));

クエリレイヤーを使用すると、SQL クエリの結果に読み取り専用のテーブルまたはフィーチャクラスとしてアクセスできます。次の手順を使用して、クエリレイヤーを作成します。

1. Database.GetQueryDescription を使用して QueryDescription を作成します。QueryDescription については、このセクションの後半で詳しく説明します。
2. オブジェクト ID 列、shape タイプ、SR ID、空間参照などの詳細を使用して、QueryDescription を変更します（クエリによっては不要な場合があります）。
3. QueryDescription を Database.OpenTable に渡して、クエリレイヤーを表すテーブルまたはフィーチャクラスを取得します。

クエリレイヤーの要件の1つは、一意の ID が必要であることです。これは、自然なユニーク ID（ArcGIS でオブジェクト ID として使用される既存のフィールド）またはマップされた一意の ID（1つ以上の既存のフィールドの値を整数にマッピングすることによって作成された仮想フィールド）にすることができます。クエリの結果には、次のいずれかが含まれている必要があります。

• null を許可しない整数フィールド（自然なユニーク ID）
• 一意のタプル（マップされた一意の ID）になる1つ以上の整数、文字列、または GUID フィールドの組み合わせ

次の表では、個別に一意ではないが、一意のタプルを形成する（null 値を含まない）文字列フィールドと整数フィールドを含むクエリ結果を ID マッピングに使用できます。

次の要件と制限が適用されます。

• 一意性 - 単一のフィールド（自然またはマップ）を使用する場合、すべての値が一意である必要があります。複数のフィールドを使用する場合、各行のタプルは一意である必要があります。一意でない値がマッピングに使用されている場合、エラーは発生しませんが、予期しない動作が発生し、分析結果が正しくない可能性があります。
• null 値なし - マップされた ID が使用されている場合、ID の作成に使用されるフィールドに null 値を含めることはできません。null 値を使用すると、マッピング中にエラーが発生します。
• 負の自然値 - 自然なユニーク ID を使用する場合、フィールドに負の値を含めることはできません。自然なユニーク ID が0未満の行は無視されます。
• ジオメトリ フィールド-ジオメトリ フィールドは必要ありません。結果セットには、最大1つのジオメトリ フィールドを含めることができます。

覚えておくべき1つの特別なケースは、同じ shape フィールド内の複数のジオメトリタイプです。これは通常、ArcGIS Pro では無効ですが、1つのタイプの行のみを使用するように指定することでクエリレイヤーを作成できます。たとえば、shape 列にポイント ジオメトリとポリゴン ジオメトリの両方がある場合、QueryDescription.SetShapeType(GeometryType) メソッドを使用して、このクエリレイヤーで考慮するジオメトリタイプを指定できます。

QueryDescription は、クエリレイヤーを表すテーブルまたはフィーチャクラスの作成に使用される中間オブジェクトです。前に説明したように、QueryDescription はDatabase.GetQueryDescription メソッドから取得されます。このメソッドは、可能であればクエリの説明のプロパティを自動検出します。たとえば、クエリ結果で null を許可しない整数フィールドが見つかった場合、QueryDescription.IsObjectIDMappedColumnRequired() は false になり、 QueryDescription.GetObjectIDField() は選択された整数フィールドを指定します。ID マッピングが必要で、適切なマッピング フィールドを自動的に決定できない場合、QueryDescription.IsObjectIDMappedColumnRequired() は true になり、QueryDescription.SetObjectIDFields() を使用して、クエリクラスの作成に使用する前に、マップされた一意の ID を指定する必要があります。

GetQueryDescription メソッドには、次の3つのオーバーロードがあります。

• GetQueryDescription(string tableName) - tableName 引数で指定された単一の（つまり、スタンドアロンの）テーブルに関連付けられた QueryDescription オブジェクトを作成します。つまり、結果のオブジェクトにより、ShapeType、SpatialReference などのパラメーターのデフォルトの推論を使用して、データベーステーブルのすべてのフィールドを使用してクエリレイヤーが作成されます。
• GetQueryDescription(ArcGIS.Core.Data.Table) - ArcGIS.Core.Data.Table への参照が与えられた場合、このメソッドを使用して、テーブル参照によって表される対応するクエリレイヤーのパラメーターを検出できます。これは、別のクエリレイヤーを表す別のテーブルまたはフィーチャクラスを作成する前に、クエリの説明をカスタマイズする場合にも役立ちます。
• GetQueryDescription(string queryStatement, string queryLayerName) - カスタムフィールドまたは複数のテーブル間の結合を持つクエリレイヤーが必要な場合、このメソッドの最初のパラメーターは必要なクエリを指定する文字列であり、2番目のパラメーターは結果のクエリレイヤーの名前です。

QueryDescription オブジェクトは、クエリ結果がどのようになるかを決定するために使用できるいくつかのゲッターを定義します。たとえば、QueryDescription.GetFields() メソッドは、クエリ結果の読み取り専用リストを返します。QueryDescriptionは、クエリレイヤーの作成方法を定義するために使用できる次のゲッター/セッターも定義します。

• GetSpatialReference/SetSpatialReference - フィーチャクラスが作成されたときに適用される空間参照。空間参照を定義するには、SetSpatialReference メソッドを使用する必要があります。
• GetShapeType/SetShapeType - shape フィールドにあるジオメトリのタイプ。shape フィールドに複数のジオメトリタイプが含まれている場合、このプロパティを設定すると、クエリクラスから取得される行のサブセットが指定されます（単一のジオメトリタイプに一致する行のみを使用できます）。
• GetObjectIDFields/SetObjectIDFields - 自然な ID 列が見つかった場合、GetObjectIDFields はその名前を返します。マッピングが必要な場合は、SetObjectIDFields メソッドを使用して、使用するフィールドを指定する必要があります。
• GetSRID/SetSRID - 作成時にフィーチャクラスに適用される空間参照に対応するSRID。SRID を指定するには、SetSRID を使用する必要があります。

Geodatabase クラスは、フィーチャ サービス（すなわち、Web ジオデータベース）を表し、そのサービスに含まれるデータセットへのアクセスを提供することができます。Geodatabase クラスには、ServiceConnectionProperties オブジェクトを受け取るオーバーロードされたコンストラクターがあります。このコンストラクターは、フィーチャ サービスへの URL と、オプションで、フィーチャ サービスに接続するための資格情報を指定します。資格情報が必要かどうかは、フィーチャ サービスの配置タイプによって異なります。

フィーチャサービスをホストできる3種類の環境は次のとおりです。

• ArcGIS Online
• ArcGIS Enterprise ポータルとフェデレーションされた ArcGIS Server サイト
• スタンドアロンの ArcGIS Server サイト（ポータルとフェデレーションされていない）

ArcGIS Online でホストされているフィーチャ サービスの場合、フィーチャ サービス接続は、ユーザーが ArcGIS Pro にサインインしたときに使用した ArcGIS Online クレデンシャルを使用します。Enterprise ポータルとフェデレーションされた ArcGIS Server サイトのフィーチャ サービスの場合、ArcGIS Pro でポータル接続を追加するときに、ユーザーが資格情報を指定する必要があります。詳細については、 ポータル接続の追加 を参照してください。

ServiceConnectionProperties serviceConnectionProperties = new ServiceConnectionProperties(new Uri("http://federated-server.com/server/rest/services/Hosted/CampusEditing/FeatureServer"));
Geodatabase geodatabase = new Geodatabase(serviceConnectionProperties);

スタンドアロンの ArcGIS Server サイト（Enterprise ポータルとフェデレーションされていない）でホストされているフィーチャ サービスの場合、クレデンシャルをServiceConnectionProperties オブジェクトの User プロパティと Password プロパティに割り当てて渡す必要があります。

ServiceConnectionProperties serviceConnectionProperties = new ServiceConnectionProperties(new Uri("https://non-federated-server.com/arcgis/rest/services/UnitedStatesWest/FeatureServer"))
{
  User     = "username",
  Password = "password",
};
Geodatabase geodatabase = new Geodatabase(serviceConnectionProperties);

シェープファイルは、地理的フィーチャの幾何学的位置と属性情報を格納するための単純な非トポロジ形式です。シェープファイルの地理的フィーチャは、ポイント、ライン、またはポリゴン（エリア）で表すことができます。シェープファイルを含むデータストアには、シェープファイルのフィーチャに結合できる追加の属性を格納できる dBASE テーブルを含めることもできます。

FileSystemDatastore を介してシェープファイルでサポートされるデータ型は、テーブル とフィーチャクラス のみです。フィーチャクラスとテーブルを除いて、ほとんどのデータセットタイプはシェープファイル データストアでサポートされていません。たとえば、リレーションシップクラスもフィーチャデータセットもシェープファイル データストアで開くことはできません。さらに、フィーチャデータセットを必要とするデータセット（トポロジやユーティリティネットワークなど）も開くことができません。

以下には、考慮すべきいくつかの制限が含まれています。

• エイリアス名とモデル名はサポートされていません（これにはデータセットとフィールドが含まれます）。
• シェープファイルの長さと面積のフィールドは維持されません。
• アノテーション フィーチャクラスとディメンション フィーチャクラスはサポートされていません。
• QueryDef はサポートされていません。
• ドメインとルールはサポートされていません。
• シェープファイルで z 値を有効にするには、m 値も有効にする必要があります。
• シェープファイルの DateTime フィールド値は本当の DateTime 値ではありません。むしろ、それらは日付値のみです。DateTime 値がシェープファイルの DateTime フィールドに格納されている場合、値の日付部分は正しく維持されますが、時間値は維持されません。シェープファイルで DateTime 値をモデル化するには、値の時間部分を格納する1つ以上の追加フィールドを作成します。たとえば、1つのフィールドを使用して深夜からの秒数を格納したり、3つのフィールドを使用して時間、分、秒を個別に格納したりできます。
• Null 値はシェープファイルではサポートされていません。これを回避するための1つのアプローチは、通常はデータで発生しない値を使用して null を表すことです。たとえば、都市を含むシェープファイルでは、値 –9999 を使用して null（不明）の人口を表すことができます。
• インデックス名はシェープファイルでは維持されません。それらは、それらが作成されたフィールドと同じ名前になります。
• Table/FeatureClass の Validate メソッドはサポートされていません。
• Table/FeatureClass の Differences メソッドはサポートされていません。

シェープファイルは、FileSystemDatastore コンストラクターを使用して開くことができます。このコンストラクターは、FileSystemDatastoreType.Shapefile が指定された FileSystemConnectionPath を受け取ります。

FileSystemConnectionPath connectionPath = new FileSystemConnectionPath(new Uri("path\\to\\shapefiles\\directory"), FileSystemDatastoreType.Shapefile);
FileSystemDatastore shapefile = new FileSystemDatastore(connectionPath);

OpenDataset<T> ジェネリックメソッドを使用して、Table または FeatureClass を開くことができます。 T は Table または FeatureClass である必要があります。T が他のタイプの場合、InvalidOperationException がスローされます。 OpenDataset メソッドは、ファイル拡張子の有無にかかわらず、シェープファイルで呼び出すことができます。 OpenDataset メソッドが .shp ファイルで呼び出された場合、返されるオブジェクトは FeatureClass であり、FeatureClass 参照にキャストできます。 OpenDataset メソッドが .dbf ファイルで呼び出された場合（対応する .shp ファイルがない場合）、返されるオブジェクトは Table オブジェクトです。

シェープファイル FeatureClass または Table に関するメタデータを取得するには、GetDefinition<T> ジェネリックメソッドを使用して、フィールド、インデックス、フィーチャクラス名、オブジェクト ID フィールド名などの詳細を提供する定義を取得できます。 T は TableDefinition または FeatureClassDefinition である必要があります。T が他のタイプの場合、InvalidOperationException がスローされます。シェープファイル フィーチャクラスから取得した Definition クラスのメソッドのうち、サポートされていないものは以下の通りです。

• GetAliasName
• GetModelName
• GetCreatedAtField
• GetCreatorField
• GetDefaultSubtypeCode
• GetSubtypeField
• GetSubtypes
• GetEditedAtField
• GetEditorField
• GetGlobalIDField
• HasGlobalID
• IsEditorTrackingEnabled
• IsTimeInUTC
• GetAreaField
• GetLengthField

FileSystemConnectionPath connectionPath = new FileSystemConnectionPath(new Uri("path\\to\\shapefiles\\directory"), FileSystemDatastoreType.Shapefile);
FileSystemDatastore shapefile = new FileSystemDatastore(connectionPath);

FeatureClass footPrints = shapefile.OpenDataset<FeatureClass>("BuildingFootprints");
FeatureClass easements = shapefile.OpenDataset<FeatureClass>("Easements.shp"); // The name can be provided with or without the extension.
TableDefinition easementsDefinition = shapefile.GetDefinition<TableDefinition>("Easements");

シェープファイルには常に、ObjectID と同じ方法で一般的に使用できる Feature ID（FID）フィールドが含まれています。 たとえば、シェープファイルから取得したフィーチャクラスから作成された Selection オブジェクトは、ObjectID の代わりに FID を使用します。ObjectID と同様に、FID は編集できず、FID フィールドのIField.Type の値は esriFieldTypeOID の値を返します。

ObjectID と FID の主な違いは、ObjectID はジオデータベース内のフィーチャまたは行の永続的な識別子であるのに対し、FID は単にシェープファイル内のフィーチャまたは行の現在の（ゼロベースの）位置を表すことです。これは、フィーチャがまったく変更されていない場合でも、セッションごとに異なる FID を持つことができることを意味します。

次の表に示すように、整数フィールドと3つのポイントフィーチャを持つシェープファイルについて考えてみます。

編集が保存された後に FID が1のフィーチャが削除されると、シェープファイルの属性テーブルは次の表に示すように変更されます。

ワークフローでフィーチャに静的識別子が必要な場合は、FID フィールド以外の整数フィールドを使用してください。

シェープファイルは、ジオデータベースに関連して使用できるフィールドのタイプに制限があります。たとえば、次のフィールドタイプはサポートされていません。

• グローバル一意識別子（GUID）
• GlobalID
• バイナリ ラージ オブジェクト（BLOB）
• ラスター

さらに、フィールド名は10文字に制限されており、前述のように、エイリアス名とモデル名はサポートされていません。

Pro SDK は、CAD ファイルを含むディレクトリから作成される CAD ファイル ワークスペースもサポートしています。 CAD データセットは読み取り専用で、単一の DXF、DWG、DGN ファイルをベースにしています。 CAD ファイルは、空間参照（PRJ）や座標変換（WLD）のための補助ファイルと関連している場合があります。

CAD ファイルのワークスペースは、FileSystemDatastore のコンストラクタで開くことができます。このコンストラクタは、コンストラクタで FileSystemDatastoreType.Cad が指定される FileSystemConnectionPath を受け取ります。

FileSystemConnectionPath connectionPath = new FileSystemConnectionPath(new Uri("path\\to\\CAD \\directory"), FileSystemDatastoreType.Cad);
FileSystemDatastore cadDatastore = new FileSystemDatastore(connectionPath);

OpenDataset<T> というジェネリックなメソッドを使うことで、特定の CAD ファイルを CadDataset として開くことができます。T は CadDataset でなければなりません。もし T が他のタイプであると、InvalidOperationException がスローされます。

CAD データセットは、デフォルトでは、ジオメトリ的なタイプに基づいて、POINTS、POLYLINES、POLYGON、MULTIPATCH、ANNOTATION の各フィーチャ クラスに解釈されます。 フィーチャの属性は、選択された CAD エンティティのプロパティから、仮想テーブルとしてメモリに組み立てられます。 ソースジオメトリは、複数のデフォルト フィーチャ クラスに含まれる場合があります。例えば、POLYGONS フィーチャ クラスに含まれる全てのフィーチャは、POLYLINES フィーチャ クラスにも表現されます。 AutoCAD ファイルの場合、DWG ファイルには、ArcGIS for AutoCAD で作成された、または ArcGIS Desktop からエクスポートされたデータから作成された明示的な ArcGIS フィーチャ クラスが含まれている場合があります。この場合、フィーチャ属性は、オリジナルの GIS フィーチャ属性データ、または ArcGIS for AutoCAD から追加された GIS データからエンコードされます。

利用可能なフィーチャ クラスのリストを含む CAD データセットに関するメタデータは、GetDefinition を呼び出すことで取得でき、CadDatasetDefinition オブジェクトが返されます。CAD ファイル内の個々のフィーチャークラスは、CadDataset の OpenDataset メソッドで開くことができます。

Dataset 抽象クラスは、ArcGIS Pro で意味のある一貫したデータの集合体であるエンティティを表します。たとえば、ArcGIS.Core.Data.Table はデータセットを継承し、指定されたスキーマに準拠するデータのコレクションを表します（たとえば、各行には同じフィールドがあります）。

データセット エンティティを表し、データセットから継承するクラスを以下に説明します。

Tables は、1つ以上の列（またはフィールド）を持つ0個以上の行を含むデータセットのタイプです。テーブル内のすべての行には、同じ列があり、各列に1つの値（または値なし）が関連付けられています。

ジオデータベースでは、属性は、次の単純でありながら不可欠なリレーショナルデータの概念に基づいてテーブルで管理されます。

• テーブルには行が含まれています。
• テーブルのすべての行には同じ列があります。
• 各列には、整数、10進数、文字、日付などのデータ型があります。
• 一連のリレーショナル関数と演算子（SQLなど）を使用して、テーブルとそのデータ要素を操作できます。

ArcGIS.Core.Data API では、 Table オブジェクトは次の方法で取得できます。

• Geodatabase オブジェクトから：

Table table = geodatabase.OpenDataset<Table>("TableName");

FeatureService を表す Geodatabase オブジェクトの場合、OpenDataset は、テーブルの ID の文字列表現を使用して呼び出すことができます。

Table table = geodatabase.OpenDataset<Table>("2");

• FeatureLayer オブジェクトから：

ArcGIS.Desktop.Mapping.Layer selectedLayer = MapView.Active.GetSelectedLayers()[0];
if (selectedLayer is ArcGIS.Desktop.Mapping.FeatureLayer)
{
  ArcGIS.Core.Data.Table table = (selectedLayer as FeatureLayer).GetTable();
}

• Row オブジェクトから：

ArcGIS.Desktop.Editing.Events.RowChangedEvent.Subscribe(args =>
{
  ArcGIS.Core.Data.Row row     = args.Row;
  ArcGIS.Core.Data.Table table = row.GetTable();
}

フィーチャクラス は、共通のフィーチャの同種のコレクションであり、それぞれが同じ空間表現（ポイント、ライン、ポリゴンなど）と、共通の属性列のセット（たとえば、道路の中心線を表すラインフィーチャクラス）を持ちます。ArcGIS Pro では、ジオデータベースで一般的に使用されている現在サポートされているフィーチャクラスは、ポイント、ライン、およびポリゴンです。

次の画像では、ポイント、ライン、およびポリゴンを使用して、同じエリアの3つのデータセットを表します。ポイントとしての公園およびレクリエーションエリアの場所、ラインとしての道路、およびポリゴンとしての施設です。

ArcGIS.Core.Data API では、FeatureClass クラスは Table クラスから継承します。FeatureClass オブジェクトの取得は、次の例に示すようにTable オブジェクトの取得に似ています。

• Geodatabase オブジェクトから：

FeatureClass table = geodatabase.OpenDataset<FeatureClass>("FeatureClassName");

FeatureService を表すジオデータベースオブジェクトの場合、OpenDataset は、フィーチャクラスの ID の文字列表現を使用して呼び出すことができます。

FeatureClass featureClass = geodatabase.OpenDataset<FeatureClass>("2");

• FeatureLayer オブジェクトから：

ArcGIS.Desktop.Mapping.Layer selectedLayer = MapView.Active.GetSelectedLayers()[0];
if (selectedLayer is ArcGIS.Desktop.Mapping.FeatureLayer)
{
  Table table = (selectedLayer as FeatureLayer).GetTable();
  
  if(table is FeatureClass)
  {
    FeatureClass featureClass = table as FeatureClass;
  }
}

• Feature オブジェクトから：

ArcGIS.Desktop.Editing.Events.RowChangedEvent.Subscribe(args =>
{
  Row row = args.Row;
  
  if(row is Feature)
  {
    FeatureClass featureClass = row.GetTable() as FeatureClass;
  }
}

次のコードを使用して、FeatureClass オブジェクトを開くことができます。

Table table = geodatabase.OpenDataset<Table>("FeatureClassName");

テーブルは ArcGIS.Core.Data.Table 参照ですが、実際には、ArcGIS.Core.Data.FeatureClass オブジェクトです。テーブル参照を FeatureClass としてキャストすると、キャストは期待どおりに機能します。

フィーチャデータセットは、共通の座標系を共有する関連するフィーチャクラスのコレクションです。フィーチャデータセットは空間的に使用されます。それらの主な目的は、トポロジ、ネットワークデータセット、またはテレインデータセットを構築するための共通のデータセットに関連するフィーチャクラスを編成することです。データを保存するのではなく、他のデータセットのコンテナとして機能し、含まれているデータセットと共通の空間参照の範囲を維持します。

ArcGIS.Core.Data.FeatureDataset オブジェクトは Geodatabase オブジェクトからのみ取得できます。

FeatureDataset FeatureDataset = geodatabase.OpenDataset<FeatureDataset>("FeatureDatasetName");

GIS は、さまざまなタイプの地理的および非地理的エンティティに関する情報を統合します。これらのエンティティの多くは関連している可能性があります。

• 地理的エンティティは、他の地理的エンティティに関連付けることができます。たとえば、建物を区画に関連付けることができます。
• 地理的エンティティは、非地理的エンティティに関連付けることができます。たとえば、土地の区画を所有者に関連付けることができます。
• 非地理的エンティティは、他の非地理的エンティティに関連付けることができます。たとえば、区画の所有者に税コードを割り当てることができます。

ジオデータベースのリレーションシップクラスは、あるデータセットのオブジェクト（フィーチャクラスまたはテーブル）と別のデータセットのオブジェクト間の関連付けを管理します。リレーションシップの両端にあるオブジェクトは、テーブル内のジオメトリまたはレコードを持つフィーチャにすることができます。

リレーションシップクラスは、参照整合性を検証し、場合によっては保証するのに役立ちます。たとえば、1つのフィーチャを削除または変更すると、関連するフィーチャが削除または変更される可能性があります。さらに、リレーションシップクラスはジオデータベースに格納されているため、ジオデータベースを使用するすべてのユーザーがアクセスできます。リレーションシップクラスは、次のカーディナリティをサポートします。

• 1対1
• 1対多
• 多対多

注：多対多のリレーションシップクラスは、属性付きのリレーションシップクラスと見なされます。これらは引き続きリレーションシップクラスとして開くことができますが、属性付きのリレーションシップクラス として開くこともできます。

ArcGIS.Core.Data.RelationshipClass オブジェクトは、Geodatabase オブジェクトから取得できます。リレーションシップクラスの名前がわかっている場合は、Geodatabase.OpenDataset<RelationshipClass> メソッドを使用して開くことができます。

RelationshipClass relationshipClass = geodatabase.OpenDataset<RelationshipClass>("RelClassName");

または、OpenRelationshipClasses メソッドを使用して、2つのテーブルまたはフィーチャクラス間のすべてのリレーションシップクラスをフェッチすることもできます。最初のパラメーターは関連元テーブル名またはオブジェクトであり、2番目のパラメーターは関連先テーブル名またはオブジェクトです。指定されたテーブル間に複数の関係が存在する可能性があるため、戻り値はRelationshipClass オブジェクトの IReadOnlyList です。パラメータの順序によって、返されるリレーションシップクラスが異なることに注意してください。

IReadOnlyList<RelationshipClass> relationshipClasses = geodatabase.OpenRelationshipClasses("SourceTableName", "DestinationTableName");
IReadOnlyList<RelationshipClass> relationshipClassesAlternate= geodatabase.OpenRelationshipClasses(sourceTableObject, destinationTableObject);

フィーチャサービス ジオデータベースを使用する場合、テーブル名は、レイヤ ID 文字列、またはフィーチャサービスを介して公開されるフィーチャクラスの名前である必要があります。

IReadOnlyList<RelationshipClass> srcToDestRelClasses = geodatabase.OpenRelationshipClasses("0", "2"));
IReadOnlyList<RelationshipClass> srcToDestRelClassesAlternate = geodatabase.OpenRelationshipClasses("L3States", "L2Counties");

リレーションシップクラスの操作の詳細については、 Working with relationship classes を参照してください。

シンプルまたはコンポジットで、特定のカーディナリティのリレーションシップクラスは、属性を持つことができます。属性を持つリレーションシップクラスは、データベースのテーブルに格納されます。このテーブルには、少なくとも関連元フィーチャクラスまたはテーブルへの外部キーと、関連先フィーチャクラスまたはテーブルへの外部キーが含まれています。

属性付きのリレーションシップには、他の属性を含めることもできます。たとえば、給水管を格納するフィーチャクラスと消火栓を格納するフィーチャクラスを関連付ける属性付きリレーションシップクラスを検討する場合、給水管オブジェクトには独自の属性があり、消火栓オブジェクトには独自の属性があります。リレーションシップクラスは、どの給水管がどの消火栓に給水するかを示します。2つを接続するライザーのタイプなど、そのリレーションシップに関するある種の情報を格納する必要があるため、この情報を属性としてリレーションシップクラスに格納できます。

ArcGIS.Core.Data API では、 AttributedRelationshipClass クラスはRelationshipClass から継承します。中間テーブルを持つすべてのRelationshipClasses は、ユーザー定義の属性が存在するかどうかに関係なく、属性付きのリレーションシップクラスとして扱われます。

ArcGIS.Core.Data.AttributedRelationshipClass オブジェクトは、 Geodatabase オブジェクトから取得できます。属性付きのリレーションシップクラスの名前がわかっている場合は、Geodatabase.OpenDataset <AttributedRelationshipClass> メソッドを使用して開くことができます。 -->

AttributedRelationshipClass attrRelationshipClass = geodatabase.OpenDataset<AttributedRelationshipClass>("AttrRelClassName");

または、OpenRelationshipClasses メソッドを使用して、2つのテーブルまたはフィーチャクラス間のすべてのリレーションシップクラスをフェッチすることもできます。最初のパラメーターは関連元テーブル名またはオブジェクトであり、2番目のパラメーターは関連先テーブル名またはオブジェクトです。指定されたテーブル間に複数の関係が存在する可能性があるため、戻り値はRelationship クラスオブジェクトの IReadOnlyList です。パラメータの順序によって、返されるリレーションシップクラスが異なることに注意してください。

IReadOnlyList<RelationshipClass> relationshipClasses = geodatabase.OpenRelationshipClasses("SourceTableName", "DestinationTableName");
IReadOnlyList<RelationshipClass> relationshipClassesAlternate= geodatabase.OpenRelationshipClasses(sourceTableObject, destinationTableObject);

フィーチャサービス ジオデータベースを使用する場合、テーブル名は、レイヤ ID 文字列、またはフィーチャサービスを介して公開されるフィーチャクラスの名前である必要があります。

IReadOnlyList<RelationshipClass> srcToDestRelClasses = geodatabase.OpenRelationshipClasses("0", "2"));
IReadOnlyList<RelationshipClass> srcToDestRelClassesAlternate = geodatabase.OpenRelationshipClasses("L3States", "L2Counties");

リレーションシップクラスの操作の詳細については、リレーションシップクラスの操作 を参照してください。

リアルタイム データセットとフィーチャクラスは、ProConcepts Stream Layers でカバーされています

Definition は、データセットに関するメタデータを表す概念です。データセットは、カプセル化するデータにアクセスする方法を提供しますが、Definition には、データセットのスキーマ、それに関連付けられた一意のプロパティなどが記述されます。

注：定義は、ArcObjects API の DataElement と概念的に同等の抽象化です。

ArcGIS.Core.Data.Dataset 抽象クラスから継承するすべてのクラスには、そのデータセットから期待される固有の動作であるメソッドがあることに注意してください。ただし、すべてのメタデータには、Definition 抽象クラスを介してアクセスする必要があります。

メタデータを Definition に分離する理由の1つは、データセットを開く場合と比較して、Definition を開くことが軽量な操作であるためです。たとえば、Polyline FeatureClass に関する情報のみが必要な場合は、すべてのFeatureClass を開いて同じことを行うよりも、Definition の取得とフィルタリングの方が効率的です。

Definition 抽象クラスから継承するクラスは次のとおりです。

• TableDefinition - ArcGIS.Core.Data.Table データセットのメタデータ。TableDefinition からアクセスできる主要なオブジェクトには、フィールド、サブタイプ、インデックス、ObjectIDField、SubtypeField、GlobalIDField などの名前があります。
• FeatureClassDefinition - TableDefinition から継承し、FeatureClass に固有のメタデータ、特に ShapeField、ShapeType、SpatialReference、Area、Length などにアクセスするためのメソッドへの追加アクセスがあります。
• FeatureDatasetDefinition — FeatureDataset のSpatialReference およびExtent へのアクセスを提供するメタデータ。
• RelationshipClassDefinition - ArcGIS.Core.Data.RelationshipClass の メタデータで、カーディナリティ、関連元と関連先のデータセット、関連元の外部キーフィールド、それがコンポジットかどうか、データセットとそのアタッチメント テーブルを関連付ける RelationshipClass を表しているかどうかなどの情報にアクセスできます。
• AttributedRelationshipClassDefinition - RelationshipClassDefinition から継承し、関連先の外部キーフィールド、属性列名を表すフィールドなどへの追加アクセスを提供します。
• UnknownDefinition - API でまだサポートされていないデータセットの Definition にアクセスしようとしていることを表します。これには、ジオメトリックネットワーク、パーセルファブリック、およびトポロジが含まれます。

Definitions にアクセスするための2つのオプションは次のとおりです。

• Geodatabase から Definition を開く - 一般的には、データセットが開かれることが予想されない場合に使用されます。

FeatureDatasetDefinition definition = geodatabase.GetDefinition<FeatureDatasetDefinition>("FeatureDatasetName");

• データセットから Definition を開く - これは、データセットがすでに開かれており、参照にアクセスできる場合に使用されます。

ArcGIS.Desktop.Mapping.Layer selectedLayer = MapView.Active.GetSelectedLayers()[0];
if (selectedLayer is ArcGIS.Desktop.Mapping.FeatureLayer)
{
  using (Table table = (selectedLayer as FeatureLayer).GetTable())
  {
    TableDefinition definition = table.GetDefinition();
  }
}

テーブル、フィーチャクラス、および属性付きのリレーションシップクラスは、列と同義のフィールドで構成されます。フィールドは、対応するデータセットのスキーマを表します。

ArcGIS.Core.Data では、フィールドは常に、以下のオブジェクトの GetFields() を呼び出すことでアクセス可能な ArcGIS.Core.Data.Field オブジェクトの読み取り専用のリストとして返されます。

• TableDefinition
• FeatureClassDefinition
• AttributedRelationshipClassDefinition
• RowCursor
• RowBuffer
• Row
• Feature
• AttributedRelationship

同じデータセットの場合、次のオブジェクトのセットから同時に取得されるフィールドのコレクションは同等である必要があります。

• TableDefinition、RowCursor、RowBuffer、Row
• FeatureClassDefinition、RowCursor、RowBuffer、Feature
• AttributedRelationshipClassDefinition、AttributedRelationship

読み取り専用コレクションを取得した後、LINQ を使用して、以下に示すようにリストをフィルター処理できます。

using (Geodatabase geodatabase = new Geodatabase(new FileGeodatabaseConnectionPath(new Uri("path\\to\\gdb"))))
using (FeatureClass enterpriseFeatureClass = geodatabase.OpenDataset<FeatureClass>("LocalGovernment.GDB.FacilitySite"))
{
  FeatureClassDefinition facilitySiteDefinition = enterpriseFeatureClass.GetDefinition();
  IReadOnlyList<Field> fields = facilitySiteDefinition.GetFields();

  IEnumerable<Field> dateFields = fields.Where(field => field.FieldType == FieldType.Date);
}

3.2から、64ビット フィールド型のサポートが追加されました：64 ビットの ObjectID (OID) と BigInteger です。64ビットの OID と BigInteger (64ビットの整数) フィールドにより、開発者はより大きな整数値を表現することができます。

この規格では、符号に1ビット、指数に11ビット、仮数に52ビットが割り当てられています。したがって、ジオデータベースの64ビット データ フィールドに書き込める整数の最大値は 9007199254740991 または (2^53)-1 ですが、18446744073709552000 または (2^64) までの値を読み込むことができます。

// Creating a 64-bit Object ID
FieldDescription oidFieldDescription_64 = new FieldDescription("ObjectID", FieldType.OID) 
{
  Length = 8
};

// Creating a  64-bit  integer
FieldDescription bigIntegerFieldDescription = new FieldDescription("BigInt", FieldType.BigInteger);

32ビットの ObjectID の長さは4バイト、64ビットの ObjectID の長さは8バイトです。

Pro SDKは、特定の日付や時刻を表す DateOnly フィールドと TimeOnly フィールドもサポートしています。

DateOnly フィールドは時刻を含まない特定の日付を表します。このフィールドは生年月日など、時刻に関係がない特定の日付を保存するのに適しています。

TimeOnly フィールドは日付のない時刻を表します。このフィールドは毎日発生するような、日付を保存することが不適切なイベントの保存に最適です。

//Creating fields
// 9/28/2014 (DateOnly)
FieldDescription earthquakeDateOnlyFieldDescription = new FieldDescription("Earthquake_DateOnly", FieldType.DateOnly);

// 1:16:42 AM (TimeOnly)
FieldDescription earthquakeTimeOnlyFieldDescription = new FieldDescription("Earthquake_TimeOnly", FieldType.TimeOnly);

// Creating a row buffer
rowBuffer["Earthquake_DateOnly"] = new DateOnly(2014, 9, 28);
rowBuffer["Earthquake_TimeOnly"] = new TimeOnly(1, 16, 42);

注: Oracle Enterprise Geodatabase は、DateOnly フィールドと TimeOnly フィールドをサポートしていません。

TimeStampOffset フィールドは、協定世界時（UTC）の日付と時刻の値を表し、オフセット値は現地時間と UTC の差を示します。

// Creating a time stamp offset field
// 9/28/2014 1:16:42.000 AM -09:00 
FieldDescription earthquakeTimestampOffsetFieldDescription = new FieldDescription("Earthquake_TimestampOffset_Local", FieldType.TimestampOffset);

// creating a row buffer 
rowBuffer["Earthquake_TimestampOffset_Local"] = new DateTimeOffset(2014, 9, 28, 1, 16, 42, 0, TimeSpan.FromHours(-9));

日付と時刻のデータ型コンポーネントの図。

注: Postgres Enterprise Geodatabase は TimestampOffset フィールドをサポートしていません。

完全なリストと追加の詳細については、ArcGIS データ タイプ をご参照ください。Pro SDK を使用してフィールドに適用できる各データ型について説明しています。

フィールドの精度プロパティは、数値の最大桁数を表します。スケールは、数値の小数点以下の桁数を表します。例えば、4703338.13 という数値のスケールは 2 で、精度は 9 です。

 FieldDescription fieldDescription = new FieldDescription("LandArea", FieldType.Double)
 {
    Precision = 9,
    Scale = 2
 };

ファイルおよびモバイル ジオデータベースは精度やスケールの値をサポートしていません。精度やスケールの値を指定しても無視されます。

日付フィールドの場合、精度はミリ秒単位の値を記録する機能を指します。標準的な日付フィールドであるFieldType.Dateの精度値は1であり、ミリ秒単位の時間を記録することができます。

//Precision applies to the Date field type
FieldDescription highPrecisionDate = new FieldDescription("EarthQuake_Time", FieldType.Date);
highPrecisionDate.Precision = 1;
highPrecisionDate.SetDefaultValue(new DateTime(2023,07,14,14,54,03,105));

ジオデータベースでは、ルールを使用して、テーブルやフィーチャクラスにさまざまな種類の制約を課すことができます。これには、属性に関するルールとリレーションシップに関するルールがあります。属性に関するルールは最も一般的なもので、ドメインを使用して作成されます。ドメインは、フィールドに割り当てることのできる許容値を指定するために使用されます。

ジオデータベースのドメインには、次のような種類があります。

• コード化された値 - 有効な値のリストを指定し、それぞれを文字列で表現します。
• 範囲ドメイン - 有効な値の範囲を最小値と最大値の数値で指定します。

ArcGIS.Core.Data API では、ArcGIS.Core.Data.Domain は抽象クラスとしてモデル化されたファーストクラスのエンティティです。抽象クラスである Domain を継承するクラスとして、RangeDomain と CodedValueDomain があります。Domainは、Domain のName、FieldType、Description へのアクセスを提供します。RangeDomain では、さらに Min と Max の値へのアクセスが可能です。CodedValueDomain は、コードをキーとする <object,string> の C# Generic Sorted List として返されるコードと値のペアへのアクセスを提供します。

ドメインには2つの方法でアクセスできます。ドメインにアクセスするには、 Field オブジェクトの GetDomain メソッドを使用します。これはドメインの参照を返すもので、ベースとなる Domain のタイプ（CodedValueDomain または RangeDomain）に応じて安全にキャストする必要があります。GetDomain メソッドには、オプションで Subtype パラメータがあります。これは、引数として渡された Subtype オブジェクトで表されるサブタイプの値に対応するフィールドに割り当てられたドメインを取得するために使用できます。指定されたサブタイプに割り当てられたドメインがない場合は、NULL 値が返されます。サブタイプが指定されていない場合は、フィールドのデフォルトのドメインが返されます。フィールドにドメインが割り当てられていない場合は、NULL 値が返されます。

ドメインにアクセスするもう 1 つの方法は、Geodatabase オブジェクトの GetDomains メソッドを使用することです。このメソッドを呼び出すと、派生タイプが CodedValueDomain および RangeDomain である Domain インスタンスの読み取り専用リストが返されます。

using (Geodatabase geodatabase = new Geodatabase(new FileGeodatabaseConnectionPath(new Uri("path\\to\\gdb"))))
using (FeatureClass enterpriseFeatureClass = geodatabase.OpenDataset<FeatureClass>("LocalGovernment.GDB.FacilitySite"))
{
  FeatureClassDefinition facilitySiteDefinition = enterpriseFeatureClass.GetDefinition();
  IReadOnlyList<Field> fields = facilitySiteDefinition.GetFields();

  Field doubleField = fields.First(field => field.FieldType == FieldType.Double);

  Domain domain = doubleField.GetDomain();

  if (domain is RangeDomain)
  {
    RangeDomain rangeDomain = domain as RangeDomain;
    // The reason we can directly call convert to double because the domain was obtained from a double Field.
    double minValue = Convert.ToDouble(rangeDomain.GetMinValue());
    double maxValue = Convert.ToDouble(rangeDomain.GetMaxValue());
  }

  if (domain is CodedValueDomain)
  {
    CodedValueDomain codedValueDomain = domain as CodedValueDomain;
    SortedList<object, string> codedValuePairs = codedValueDomain.GetCodedValuePairs();
    IEnumerable<KeyValuePair<object, string>> filteredPairs = codedValuePairs.Where(pair => Convert.ToDouble(pair.Key) > 20.0d);
    double code = Convert.ToDouble(codedValueDomain.GetCodedValue("sampleValue"));
    string value = codedValueDomain.GetName(21.45d);
  }
}

Subtypes は、単一のテーブル内のオブジェクトを、同様のルールと動作を持つグループに分割する方法です。サブタイプは共通のフィールドセットを共有しますが、各グループは独自の属性とリレーションシップルール、および作成時の異なるデフォルト値を持つことができます。この例は、住宅、商業、および工業用のサブタイプに分割されることが多い土地区画です。サブタイプは単一のテーブルまたはフィーチャクラスに対して定義されており、共有することはできません。

テーブルまたはフィーチャクラスのサブタイプは、TableDefinition および FeatureClassDefinition を介して取得できます。GetSubtypes メソッドを使用すると、subtype オブジェクトの読み取り専用リストが返されます。各 subtype オブジェクトは、サブタイプコードとサブタイプ名へのアクセスを提供します。

using (Geodatabase geodatabase = new Geodatabase(new FileGeodatabaseConnectionPath(new Uri("path\\to\\gdb"))))
using (FeatureClass enterpriseFeatureClass = geodatabase.OpenDataset<FeatureClass>("Fittings"))
{
  FeatureClassDefinition featureClassDefinition = enterpriseFeatureClass.GetDefinition();
  Subtype bendSubtype = featureClassDefinition.GetSubtypes().First(subtype => subtype.GetName().Equals("BEND"));
  Subtype sleeveSubtype = featureClassDefinition.GetSubtypes().First(subtype => subtype.GetName().Equals("SLEEVE"));

  IReadOnlyList<Field> listOfFields = featureClassDefinition.GetFields();
  int typeCodeDescFieldIndex        = featureClassDefinition.FindField("TYPE_CODE_DESC");
  
  Domain domainForBend      = listOfFields[typeCodeDescFieldIndex].GetDomain(bendSubtype);
  string bendDomainName     = domainForBend.GetName();
  Domain domainForSleeve    = listOfFields[typeCodeDescFieldIndex].GetDomain(sleeveSubtype);
  string sleeveDomainName   = domainForSleeve.GetName();
  Domain domainForNoSubtype = listOfFields[typeCodeDescFieldIndex].GetDomain();
  string masterDomainName   = domainForNoSubtype.GetName();
}

この API を使用してデータをクエリする2つの方法は次のとおりです。

• 選択 - オブジェクト ID のリスト全体、または条件に一致する Row / Feature のオブジェクト ID のリストのいずれかにアクセスします。選択は通常、基準を満たすオブジェクト ID を取得するために使用されます。これにより、たとえば、マップ上のフィーチャを強調表示できます。選択を使用する利点は、行全体を取得する場合に比べて操作が軽量であるということです。選択は、同じTable/FeatureClass からの複数の異なる選択を1つの選択に結合する場合にも役立ちます。
• 検索 - オブジェクト ID だけでなく、Table/FeatureClass のすべてまたはサブセットのフィールドの値にもアクセスするために使用されます。データの編集を行う必要がある場合にも検索が必要です。

クエリフィルターは、クエリ中にデータベースから取得されるレコードを制限し（QueryFilter.WhereClause プロパティを使用）、クエリ結果のどのフィールドにデータを入力するかを指定し（QueryFilter.SubFields プロパティを使用）、返された結果を特定の順序で並べ替えるために使用されます。（QueryFilter.PostfixClause プロパティを使用して）順序付けし、場合によっては（QueryFilter.PrefixClause プロパティを使用して）一意の/異なる結果のみを取得します。クエリフィルターはカーソルと選択範囲を作成するために使用され、Geodatabase API 全体で共通です。

ArcGIS.Core.Data.QueryFilter は、クエリフィルターを作成するためのクラスを表します。これは、ArcGIS.Core.Data API でスレッドに依存しない数少ないオブジェクトの1つです（つまり、MCT 以外のスレッドで QueryFilter を作成できます）。

QueryFilter queryFilter = new QueryFilter();

string whereClause = "OWNER_NAME = 'ADA IAN'";
queryFilter.WhereClause = whereClause;

string prefixClause = "DISTINCT";
queryFilter.PrefixClause = prefixClause;

string postfixClause = "ORDER BY OWNER_NAME";
queryFilter.PostfixClause = postfixClause;

string subFields = "OBJECTID, OWNER_NAME";
queryFilter.SubFields = subFields;

（prefix 句や postfix 句などの Distinct キーワードの使用は、これらのキーワードをサポートするデータベースでのみ機能することに注意してください。）

ArcGIS.Core.Data.SpatialQueryFilter は、ArcGIS.Core.Data.QueryFilter を継承し、結果をフィルタリングするためのフィルタ ジオメトリと、フィルタ ジオメトリに使用する空間関係タイプ（ArcGIS.Core.Data.SpatialRelationship 列挙型を使用）を指定するためのプロパティが追加されています。

MapPoint minPoint = new MapPointBuilder(-123, 41).ToGeometry();
MapPoint maxPoint = new MapPointBuilder(-121, 43).ToGeometry();

SpatialQueryFilter spatialFilter = new SpatialQueryFilter
{
  WhereClause         = "OWNER_NAME = 'ADA IAN'",
  FilterGeometry      = new EnvelopeBuilder(minPoint, maxPoint).ToGeometry(),
  SpatialRelationship = SpatialRelationship.Intersects,
};

Where 句は、Structured Query Language (SQL) ステートメントのコンポーネントで、クエリの属性制約を定義します。QueryFilter と SpatialQueryFilter では、Where 句がプロパティとして使用されます。Where 句は、論理結合子（AND および OR）で結ばれた1対多の式で構成できます。以下は、Where 条件式の有効なフォーマットです。

オペランド1 述語 オペランド2

オペランドは、テーブルからのフィールド名、数値定数、文字列、単純な算術式、関数呼び出し、またはサブクエリで構成されます。

以下は、LIKE 述語で使用できる2種類のワイルドカードです。

• 1文字のワイルドカード（アンダースコア、_）
• 複数文字のワイルドカード（パーセント記号、%）

単一文字のワイルドカードを含む文字列は、ワイルドカードが比較文字列の単一文字に対応する場合に true と評価されますが、複数文字のワイルドカードを含む文字列は、ワイルドカードが比較文字列の0から複数の文字に対応する場合に true と評価されます。

以下はステートメントの例です。

• 'Belmont' LIKE '％mont'（true と評価）
• 'Belmont' LIKE '％elmont％'（true と評価）
• 'Belmont' LIKE'Belmont _ '（false と評価）
• 'Belmont' LIKE'Bel_ont '（true と評価）

Guid フィールドをテストする where 句を作成するときは、常に Guid を次のようにフォーマットする必要があります。

'{" + guid.ToString().ToUpper() + "}'

データベースの中には、Guid をネイティブなデータ型として格納し、大文字の文字列を使用するものがあるため、ToUpper の呼び出しが必要です。

QueryFilter クラスの ObjectIDs プロパティは、ObjectID のセットに対応する一連の行を取得するためのショートカットです。なお、データベースシステムによっては、SQL の in 句で指定できる値の数が制限されている場合があります。このプロパティは、必要に応じて要求を自動的に複数の要求に分割することで、この制限を回避します。ObjectIDs プロパティは、Where 句と組み合わせることもできます。

public RowCursor SearchingATable(Table table, IReadOnlyList<long> objectIDs)
{
  QueryFilter queryFilter = new QueryFilter()
  {
    ObjectIDs = objectIDs
  };

  return table.Search(queryFilter);
}

ArcGIS.Core.Data API で、Selection を取得するには、Table/FeatureClass または Selection オブジェクトで Select メソッドを呼び出す必要があります。Select メソッドは、次の2つのパラメーターを取ります。

• QueryFilter - Table/FeatureClass 用の ArcGIS.Core.Data.QueryFilter または FeatureClass 用の ArcGIS.Core.Data.SpatialQueryFilter のいずれかを指定します。デフォルト値は null で、Selection はオブジェクト ID をフィルタリングしないことを意味します。
• SelectionOption - SelectionOption.Normal、SelectionOption.None、SelectionOption.OnlyOne のいずれかの enum 値を取ります。これはデフォルトのパラメータで、デフォルト値は SelectionOption.Normal です。
  • SelectionOption.Normal - フィルターに一致するすべてのレコードを提供します。
  • SelectionOption.OnlyOne - フィルターに一致する最初のレコードを提供します。
  • SelectionOption.None - 空の選択を提供します。これは、複数の選択を組み合わせるために使用することを目的としています。

using (Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri("path\\to\\sde\\file\\sdefile.sde"))))
using (Table enterpriseTable = geodatabase.OpenDataset<Table>("LocalGovernment.GDB.piCIPCost"))
{
  QueryFilter anotherQueryFilter = new QueryFilter { WhereClause = "FLOOR = 1 AND WING = 'E'" };

  // Use SelectionOption.Normal to select all matching entries.
  using (Selection anotherSelection = enterpriseTable.Select(anotherQueryFilter, SelectionType.ObjectID, SelectionOption.Normal))
  {
  }

  // This can be used to get one record that matches the criteria. No assumptions can be made about which record satisfying the criteria is selected.
  using (Selection onlyOneSelection = enterpriseTable.Select(anotherQueryFilter, SelectionType.ObjectID, SelectionOption.OnlyOne))
  {
    // This will always be one.
    int singleRecordCount = onlyOneSelection.GetCount();

    // This will always have one record.
    IReadOnlyList<long> listWithOneValue = onlyOneSelection.GetObjectIDs(); 
  }
  
  // This can be used to obtain an empty selection, which can be used as a container to combine results from different selections.
  using (Selection emptySelection = enterpriseTable.Select(anotherQueryFilter, SelectionType.ObjectID, SelectionOption.Empty))
  {
  }
}

ArcGIS.Core.Data.QueryFilter または ArcGIS.Core.Data.SpatialQueryFilter で指定したクエリに一致する行のデータを読み込んで修正するには、Table または FeatureClass の検索が必要です。

検索結果は ArcGIS.Core.Data.RowCursor で、System.Collections.IEnumerator インターフェイスに似たインターフェイスを持ちます（Reset メソッドを除く）。RowCursor.MoveNext() は、結果の最後のレコードが返されたかどうかを表すブール値を返します。結果が空の場合、RowCursor.MoveNext() の最初の呼び出しは false を返します。通常、RowCursor のすべての行にアクセスするには、MoveNext と while ループを組み合わせて使用します。RowCursor.MoveNext() が true の場合、RowCursor.Current には ArcGIS.Core.Data.Row の参照が与えられます。対象となるオブジェクトは、Table の場合は ArcGIS.Core.Data.Row、FeatureClass の場合は ArcGIS.Core.Data.Feature です。オブジェクトが実際に Feature オブジェクトの場合は、Feature にキャストして Shape にアクセスできます。

Table または FeatureClass を検索するには、次の 2 つのパラメータを持つ Search メソッドを使用します。

• QueryFilter -フィルタにマッチする行をフェッチするためのフィルタを指定します。既定値は NULL で、NULL を指定するとテーブルのすべての行が取得されます。
• リサイクルのブール値 - 行カーソルから取得した連続した行が、行ごとに新しいメモリ位置を使用するか、MoveNext が呼び出されたときに同じメモリ位置を使用するかを指定します。リサイクルについては、後のセクションで詳しく説明します。デフォルトはtrue です。

行を変更する場合は、QueryFilter で Subfields を使用しないでください。

using (Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri("path\\to\\sde\\file\\sdefile.sde"))))
using (FeatureClass schoolBoundaryFeatureClass = geodatabase.OpenDataset<FeatureClass>("LocalGovernment.GDB.SchoolBoundary"))
{
  // Using a spatial query filter to find all features that have a certain district name and lying within a given Polygon.
  SpatialQueryFilter spatialQueryFilter = new SpatialQueryFilter
  {
    WhereClause    = "DISTRCTNAME = 'Indian Prairie School District 204'",
    FilterGeometry = new PolygonBuilder(new List<Coordinate2D>
    {
      new Coordinate2D(1021880, 1867396),
      new Coordinate2D(1028223, 1870705),
      new Coordinate2D(1031165, 1866844)
    }).ToGeometry(),

    SpatialRelationship = SpatialRelationship.Within
  };

  // Without Recycling
  using (RowCursor indianPrairieCursor = schoolBoundaryFeatureClass.Search(spatialQueryFilter, false))
  {
    while (indianPrairieCursor.MoveNext())
    {
      using (Feature feature = (Feature)indianPrairieCursor.Current)
      {
        int nameFieldIndex  = feature.FindField("NAME");
        string districtName = Convert.ToString(feature["DISTRCTNAME"]);
        double area         = Convert.ToDouble(feature["SCHOOLAREA"]);
        string name         = Convert.ToString(feature[nameFieldIndex]);
        Geometry geometry   = feature.GetShape();
      }
    }
  }
}

RowCursor.MoveNext() が true を返した場合、Row（または Feature）オブジェクトが作成されることに注意してください。この行（RowCursor.Current）が他で必要ない場合でも、System.IDisposable.Dispose を呼び出すか、using 文を使用して適切に処分する必要があります。

QueryFilterはページ分割をサポートしています。これは、 Offset プロパティと Rowcount プロパティを使用して、大きなクエリ結果を小さなクエリ結果に分割することを目的としています。Offset はクエリの結果から何行スキップするかを指定し、 RowCount はクエリによって返される行数を指定します。

QueryFilter queryFilter = new QueryFilter()
{
  ObjectIDs = objectIDs,
  
  // Number of rows to return (return 100 rows)
  RowCount = 100,

  // Positional offset to skip number of rows (skip 20 rows)
  Offset = 20,

  PostfixClause = "ORDER BY OBJECTID"
};

データストアによっては恣意的な結果にならないように、 PostfixClause プロパティを Offset プロパティまたは RowCount プロパティと組み合わせて使用する必要があります。

ArcGIS.Core.Data.Feature は、ArcGIS.Core.Data.Row を継承し、フィーチャ上の Shape を取得・設定するメソッドを追加しています。

Row（および Feature）には、行の属性にアクセスするための整数ベースのインデクサと文字列ベースのインデクサがあります。フィールドのインデックスがわかっている場合は 整数ベースのインデクサ が使われ、フィールド名がわかっている場合は 文字列ベースのインデクサ が使われます。戻り値は常に System.Object で、対応する Field オブジェクトから推測されるフィールドタイプに基づいて、対応するタイプにキャストする必要があります。

ジオメトリを扱うには、GetShape() と SetShape(Geometry) を使用する必要があります。Geometry は 不変 のオブジェクトであるため、Shape を新しいジオメトリに設定するには、対応するビルダーを使用して 新しいジオメトリを構築 する必要があります（Feature.GetShape() で取得した既存のジオメトリを使用する場合もあります）。

リサイクルは、複雑で大規模なデータセットにアクセスする際のパフォーマンスを向上させるために使用することができ、一般的には、マップ上の図形をレンダリングしたり、UI でテーブルを入力したりするために使用されます。

リサイクルを有効にするには、Search の2番目のパラメータを true に設定します（デフォルトのパラメータ値です）。リサイクルを使用すると、RowCursor で MoveNext を呼び出したときに取得した連続した Row 参照に対して、MoveNext の以前の反復処理で取得したすべての参照が、RowCursor.Current が参照している現在の Row を指すようになります。これは、MoveNext が呼び出されると、前の行は利用できなくなることを意味します。

using (Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri("path\\to\\sde\\file\\sdefile.sde"))))
using (FeatureClass schoolBoundaryFeatureClass = geodatabase.OpenDataset<FeatureClass>("LocalGovernment.GDB.SchoolBoundary"))
{
  QueryFilter queryFilter = new QueryFilter
  {
    WhereClause = "DISTRCTNAME = 'Indian Prairie School District 204'"
  };

  using (RowCursor indianPrairieCursor = schoolBoundaryFeatureClass.Search(queryFilter, true))
  {
    try
    {
      Row row1 = null;
	  
      if (indianPrairieCursor.MoveNext())
      {
        row1 = indianPrairieCursor.Current;
      }
        
      Row row2 = null;
      
      if (indianPrairieCursor.MoveNext())
      {
        row2 = indianPrairieCursor.Current;
      }

      // If the code reaches this point, row1 and row2 are referencing the second row object obtained 
      // when the MoveNext was called the second time.
      }
      finally
      {
        if(row1 != null)
          row1.Dispose();
		  
        if(row2 != null)
          row2.Dispose();
      }
    }
}

複数のプラットフォーム（ファイル ジオデータベース、SQL Server エンタープライズ ジオデータベース、Oracle エンタープライズ ジオデータベース、シェープファイルなど）に対して実行されるクエリの作成、新しいフィールドの作成、新しいテーブルの作成には、考慮すべき微妙な違いがあります。

その一部を紹介します。

• クエリを実行するデータベースの現在の種類に応じた特定の関数名
• テーブル名やカラム名が正しいかどうか
• 完全修飾されたテーブル名の所有者名
• 文字列比較で大文字小文字を区別するかどうか
• 受け入れるまたは返されるタイムスタンプ、日付、または時間の形式
• テーブル名またはフィールド名が特定の文字で始まるか、特定の文字を含むかどうか
• 指定された単語がデータベースのキーワードとみなされるかどうか
• クエリの中でどのような SQL 句や述語が使用できるか

複数のデータプラットフォームに対応したアプリケーションを開発するためには、これらの点を考慮する必要があります。

Datastore から取得した SQLSyntax クラスは、これらの問い合わせに答え、実行に成功するコードを書くための機能を提供します。例として、SQLSyntax を使用したプラットフォームに依存しないクエリの作成 を参照してください。

結合は、2つのテーブルのフィールドを1つのテーブル表現にまとめるために使用されます。結合に参加するテーブルは、同じデータストアからでも、異なるデータストアからでも可能です。結合は、リレーションシップクラスから作成されます。リレーションシップクラスは、ジオデータベースからのものでも、仮想リレーションシップクラスとしてメモリ内に定義されたものでも構いません。仮想リレーションシップクラス（Relate にも使用）は重要な概念であり、これにより結合は異なるデータストアのテーブルを結合することができます。例えば、エンタープライズ フィーチャクラスをクエリレイヤーと結合したり、シェイプファイルのフィーチャクラスをファイルジオデータベースのフィーチャクラスと結合したりすることができます。結合は、データストア間で実行できるという点で、QueryDef とは異なります。 結合は、一対多のカーディナリティをサポートしません。結合は読み取り専用ですが、ベース テーブルに加えられたデータ変更は反映されます。結合を作成するには、2つのテーブル（またはフィーチャクラス）とリレーションシップクラスが必要です。

ArcGIS.Core.Data API で Join を取得するには、まずリレーションシップクラスを取得する必要があります。これは、ジオデータベースから開かれた RelationshipClass であるか、または VirtualRelationshipClassDescription を使用してインメモリの RelationshipClass を作成することができます。VirtualRelationshipClassDescription を作成するには、左テーブルと右テーブルの両方が必要です。例えば、以下のようになります。

ArcGIS.Desktop.Mapping.Layer selectedLayer = MapView.Active.GetSelectedLayers()[0];
if (selectedLayer is ArcGIS.Desktop.Mapping.FeatureLayer)
{
  using (Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri("path\\to\\sde\\file\\sdefile.sde"))))
  using (FeatureClass leftFeatureClass = geodatabase.OpenDataset<FeatureClass>("LocalGovernment.GDB.SchoolBoundary"))
  using (Table rightTable = (selectedLayer as FeatureLayer).GetTable())
  {
    FeatureClassDefinition leftFeatureClassDefinition = leftFeatureClass.GetDefinition();
    IReadOnlyList<Field> listOfFields = leftFeatureClassDefinition.GetFields();

    Field originPrimaryKey      = listOfFields.FirstOrDefault(field => field.Name.Equals("primaryKeyField"));
    Field destinationForeignKey = listOfFields.FirstOrDefault(field => field.Name.Equals("foreignKeyField"));

    VirtualRelationshipClassDescription relationshipClassDescription = new VirtualRelationshipClassDescription(originPrimaryKey, destinationForeignKey, RelationshipCardinality.OneToMany);
    RelationshipClass relationshipClass = leftFeatureClass.RelateTo(rightTable, relationshipClassDescription);
  }
}

リレーションシップクラスが決まったら、JoinDescription を使って以下のように結合の属性を指定します。

• リレーションシップクラス: 結合の必須引数
• JoinType: 結合が内部結合か左外部結合か
• JoinDirection: 結合が左のテーブルから右のテーブルに行くのか（Forward）、右のテーブルから左のテーブルに行くのか（Backward）
• TargetFields: 左テーブルのフィールドを含める必要がある（結合が Backward の場合、対象となるフィールドは右テーブルのものであることに注意してください）
• QueryFilter: クエリに基づいて結合の内容をフィルタリングする
• Selection: 結合を作成する際に使用する選択項目

JoinDescription joinDescription = new JoinDescription(relationshipClass)
{
  JoinType      = JoinType.LeftOuterJoin,
  JoinDirection = JoinDirection.Backward
};

using (Join join         = new Join(joinDescription))
using (Table joinedTable = join.GetJoinedTable())
{
  // The joinedTable is an ArcGIS.Core.Data.Table reference that can be either an ArcGIS.Core.Data.Table or an
  // ArcGIS.Core.Data.FeatureClass (depending upon whether the join has a Shape column).
}

結合について注意すべき点があります。

• Definition は一時的なものなので、結合ではサポートされません。
• 結合から得られるテーブルの選択は、一意の識別子列の異なる値に基づいて行われます。つまり、一対多のリレーションシップクラスを使用した結合で、左のテーブルの同じ行が右のテーブルの複数の行と一致する場合、選択では一致する1つの行しか返されませんが、検索ではすべての行が返されます。
• パフォーマンスを向上させるために、サーバー側で結合を実行する（結合を含む SQL クエリを実行して結果を返す）ようにあらゆる試みが行われます。これができない場合（例えば、左テーブルと右テーブルが異なるデータストアの場合）、結合はクライアント側で実行されます。
• JoinDescription.ErrorOnFailureToProcessJoinOnServerSide プロパティを設定すると、強制的にサーバー上で結合を実行することができます。結合がサーバー上で実行できない場合は、エラーが返されます。

ジオデータベースでは、ソートされた順序で行カーソルを作成する機能もあります。これは、Table.Sort() メソッドによって実現されます。Sort は、QueryFilter と SortDescription のセットを組み合わせた TableSortDescription オブジェクトを引数として受け取ります。

SortDescription クラスは、特定のフィールドでのソートを可能にします。このオブジェクトのプロパティにより、呼び出し元は、ソートが昇順か降順か、大文字と小文字を区別するかしないかを指定することができます。

次のスニペットは、World Cities テーブルを国名、都市名の順にソートして返します。

public RowCursor SortWorldCities(FeatureClass worldCitiesTable)
{
  using (FeatureClassDefinition featureClassDefinition = worldCitiesTable.GetDefinition())
  {
    Field countryField = featureClassDefinition.GetFields().First(x => x.Name.Equals("COUNTRY_NAME", StringComparison.OrdinalIgnoreCase));
    Field cityNameField = featureClassDefinition.GetFields().First(x => x.Name.Equals("CITY_NAME", StringComparison.OrdinalIgnoreCase));

    // Create SortDescription for Country field
    SortDescription countrySortDescription = new SortDescription(countryField);
    countrySortDescription.CaseSensitivity = CaseSensitivity.Insensitive;
    countrySortDescription.SortOrder = SortOrder.Ascending;

    // Create SortDescription for City field
    SortDescription citySortDescription = new SortDescription(cityNameField);
    citySortDescription.CaseSensitivity = CaseSensitivity.Insensitive;
    citySortDescription.SortOrder = SortOrder.Ascending;

    // Create our TableSortDescription
    TableSortDescription tableSortDescription = new TableSortDescription(new List<SortDescription>() { countrySortDescription, citySortDescription });

    return worldCitiesTable.Sort(tableSortDescription);
  }
}

ジオデータベースには、テーブルフィールドの統計を計算する強力なツールがあります。これらの統計は、サポートされている場合はサーバーで計算されます。統計は、Table クラスの CalculateStatistics() メソッドを呼び出して計算されます。

CalculateStatistics() は、統計の計算方法を指定する TableStatisticsDescription オブジェクトを受け取ります。

QueryFilter プロパティを使用すると、統計計算を行う前にテーブルの行をフィルタリングすることができます。オプションの GroupBy プロパティは行をグループ化し、オプションの OrderBy プロパティはそのグループをソートします。データストアが Group By と Order By をサポートしていない場合（例：シェープファイル）、これらのプロパティは無視されます。

最後に、StatisticsDescriptions プロパティには、計算する統計値のセットが含まれています。

StatisticsDescription クラスを使用すると、指定されたフィールドに対して計算するさまざまな関数のセットを呼び出し側で指定することができます。上記のクラスを使用すると、Table.CalculateStatistics() を1回呼び出すだけで、複数のフィールドに対する複数の統計情報を計算することができます。

戻り値は、TableStatisticsResult オブジェクトのセットです。GroupBy が指定されていない場合、またはベースとなるデータストアが GroupBy をサポートしていない場合、1つの TableStatisticsResult が返されます。それ以外の場合は、フィールドのグルーピングごとに1つの TableStatisticsResult インスタンスが返されます。

TableStatisticsResult オブジェクトの GroupBy プロパティは、返されたグループ化について説明します。キーと値のペアは、グループの Field とそのフィールドの値を表します。元の GroupBy の各フィールドに対して1つの key-value ペアが返されます。

StatisticsResults リストには、計算された統計情報のリストが含まれています。

StatisticsResults オブジェクトでは、各フィールドに対してどの統計が要求されたかに基づいて、適切なプロパティのみが入力されます。

例えば、3つのフィールド（Region、Population_1990、Population_2000）を含む Country テーブルを考えてみましょう。4つの地域、"North"、"South"、"East"、"West" があります。これらの地域のそれぞれについて、Population_1990 と Population_2000 フィールドの合計と平均を計算したいと考えます。この計算を行うために、TableStatisticsDescription を以下のように組み立てます。

Table.CalculateStatistics() メソッドは、以下のようなTableStatisticsResults オブジェクトのリストを返します。

次のコードサンプルは、上記の例と一致しています。

// Calculate the Sum and Average of the Population_1990 and Population_2000 fields, grouped and ordered by Region
public void CalculateStatistics(FeatureClass countryFeatureClass)
{
  using (FeatureClassDefinition featureClassDefinition = countryFeatureClass.GetDefinition())
  {
    // Get fields
    Field regionField = featureClassDefinition.GetFields().First(x => x.Name.Equals("Region"));
    Field pop1990Field = featureClassDefinition.GetFields().First(x => x.Name.Equals("Population_1990"));
    Field pop2000Field = featureClassDefinition.GetFields().First(x => x.Name.Equals("Population_2000"));

    // Create StatisticsDescriptions
    StatisticsDescription pop1990StatisticsDescription = new StatisticsDescription(pop1990Field, new List<StatisticsFunction>() { StatisticsFunction.Sum, StatisticsFunction.Average });
    StatisticsDescription pop2000StatisticsDescription = new StatisticsDescription(pop2000Field, new List<StatisticsFunction>() { StatisticsFunction.Sum, StatisticsFunction.Average });

    // Create TableStatisticsDescription
    TableStatisticsDescription tableStatisticsDescription = new TableStatisticsDescription(new List<StatisticsDescription>() { pop1990StatisticsDescription, pop2000StatisticsDescription });
    tableStatisticsDescription.GroupBy = new List<Field>() { regionField };
    tableStatisticsDescription.OrderBy = new List<SortDescription>() { new SortDescription(regionField) };

    // Calculate Statistics
    IReadOnlyList<TableStatisticsResult> statisticsResults = countryFeatureClass.CalculateStatistics(tableStatisticsDescription);

    // Code to process results goes here...
  }
}

データのクエリには、テーブルまたはフィーチャクラスの検索、QueryDef、QueryTable、クエリレイヤー、結合 など、さまざまな構成があります。以下に、特定のシナリオにおける特定の構成要素の利点を示します。

• ジオデータベースに登録されている1つのテーブルを対象とした単純なクエリ: Table.Search や FeatureClass.Search が最も適しています。
• データを取得するためにジオデータベース内で結合を行う単発のクエリ: QueryDef は、クエリに一致するデータを含む行カーソルを返すので、最も適しています。
• ジオデータベース内の2つ以上のテーブルを結合する同じクエリを複数回使用する場合: QueryTable の方が適しているかもしれません。QueryDef の評価を複数回実行するのに比べて、パフォーマンス上の利点があるためです。
• ジオデータベース内の1つのテーブルを含むクエリの結果をマップに追加したり、ジオプロセシングツールで結果を使用したりする場合: この目的には、QueryTable が最も適しています。さらに、QueryTable はバージョン管理されたデータ（子孫バージョンを使用する場合）やアーカイブされたデータ（過去の時点のデータを使用する場合）でも機能します。
• ジオデータベース内の2つ以上のテーブルを結合するクエリの結果をマップに追加したり、ジオプロセシングツールで結果を使用する: この場合、QueryTable または結合が適しています。どちらの構造も再帰的な結合が可能であり（結合テーブルから結合を作成したり、クエリテーブルからクエリテーブルを作成したり）、バージョン管理されたデータやアーカイブされたデータを扱うことができます。
• 単純なクエリや結合をデータベース内で実行する場合（ジオデータベースのスキーマがない場合）: クエリレイヤーが最も適した構成です。
• 複数のデータストア（ファイルジオデータベースと SQL Server データベースなど）にまたがる結合を実行する場合: 結合は、複数のデータストアのデータを結合できる唯一の構成要素です。

バージョニングにより、複数のユーザーが長時間のトランザクション環境で空間データや表形式データを同時に編集することができます。ユーザーは、データの抽出やフィーチャのロックを事前に行うことなく、データベースを直接変更することができます。

以下は、API が提供する5つの主要な機能です。

• ジオデータベース内のすべてのバージョンを、バージョンのプロパティを含めて一覧表示する
• 特定のバージョンへの接続
• 新しいバージョンの作成
• 異なるバージョンのテーブルとフィーチャクラスの違いを一覧表示する
• リコンサイルとポスト

VersionManager オブジェクトは、Geodatabase オブジェクトからアクセスできます。VersionManager は、現在接続されているバージョン、履歴バージョンのリスト、および現在接続されているユーザーが所有するすべてのパブリック バージョン、保護されたバージョン、およびプライベート バージョンのリストへのアクセスを提供します。VersionManager は、Geodatabase オブジェクトの IsVersioningSupported メソッドが true を返した場合にのみアクセス可能です。特定のジオデータベースで使用されているバージョニングのタイプ（ブランチまたはトラディショナル）は、VersionManager.GetVersioningType() を呼び出すことで確認できます。

The VersionBase class represents either a Version or a HistoricalVersion in a Geodatabase. The VersionManager.GetCurrentVersionBaseType() returns whether the current geodatabase is connected to a Version or a HistoricalVersion.

返されるバージョンは ArcGIS.Core.Data.Version オブジェクトであり、以下へのアクセスが可能です。

• 名前、アクセス タイプ、説明などの属性
• 親バージョン オブジェクト
• 子バージョン オブジェクトのリスト
• 現在のユーザがそのバージョンの所有者であるかどうか

VersionManager から取得した Version オブジェクトで表されるバージョンに接続するには、Version オブジェクトの Connect メソッドを呼び出し、対応する Geodatabase オブジェクトを返すことで、Geodatabase のそのバージョンのデータセットを取得することができます。

VersionManagerクラスの別のメソッドである GetVersionNames() は、バージョンそのものではなく、バージョン名のリストを提供します。適用可能なバージョンのリストを表示することが目的であれば、このルーチンは高速で軽量です。この名前は、後で VersionManager.GetVersion(string) を呼び出して、Version を取得するために使用できます。

新しいバージョンを作成するには、適切なプロパティを持つ VersionDescription を作成する必要があります。このバージョン説明は、VersionManager クラス の CreateVersion に渡されます。これにより、デフォルトの子となる新しいバージョンが作成されます。トラディショナルな（ブランチではない）バージョニングを使用している場合は、オーバーロードにより、他のバージョンの子であるバージョンを作成することができます。

違いを見つけるには、以下のようなワークフローが考えられます。

1. Geodatabase で説明されているメソッドのいずれかを使用して、Geodatabase オブジェクトを取得します。
2. VersionManager を使用して、対象となる他の Version オブジェクトを見つけます。
3. Connect() を使用して、他のバージョンの Geodatabase オブジェクトを取得します。
4. 両方の Geodatabase オブジェクトから対応する Table/FeatureClasses を開きます。
5. Differences メソッドを使用して、DifferenceCursor を取得します。

差分のタイプは、ArcGIS.Core.Data.DifferenceType 列挙体を使用して Differences メソッドのパラメータとして指定できます。

フィーチャ サービス ワークスペースでは、ArcGIS Enterprise 10.7 以降のブランチ バージョニングのみがサポートされます。ソース テーブルは子ブランチのもので、ターゲット テーブルは DEFAULT のものでなければなりません。差分タイプの DeleteNoChange は子バージョンで行われた削除を、Insert は子バージョンで行われた挿入を、UpdateNoChange は子バージョンで行われたすべての更新を返します。その他の差分タイプはサポートされていません。

using (Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri("path\\to\\sde\\file\\sdefile.sde"))))
using (VersionManager versionManager = geodatabase.GetVersionManager())
{
  IReadOnlyList<Version> versionList = versionManager.GetVersions();
  IReadOnlyList<Version> childVersionList = null;

  try
  {
    IEnumerable<Version> publicVersions = versionList.Where(version => version.GetAccessType() == VersionAccessType.Public);

    // The default version will have a null Parent.
    Version defaultVersion = versionList.First(version => version.GetParent() == null);

    childVersionList = defaultVersion.GetChildren();
    Version qaVersion = childVersionList.First(version => version.GetName().Contains("QA"));

    using (Geodatabase qaVersionGeodatabase = qaVersion.Connect())
    {
      FeatureClass currentFeatureClass = geodatabase.OpenDataset<FeatureClass>("featureClassName");
      FeatureClass qaFeatureClass      = qaVersionGeodatabase.OpenDataset<FeatureClass>("featureClassName");

      DifferenceCursor differenceCursor = currentFeatureClass.Differences(qaFeatureClass, DifferenceType.DeleteNoChange);

      while (differenceCursor.MoveNext())
      {
        // The current row value refers to the row on the source Table/FeatureClass.
        // Thus, for DeleteNoChange differences, the row will be null.
        using (Row current = differenceCursor.Current)
        {
        }

        long objectID = differenceCursor.ObjectID;
	  
        // Do something with the object Id.
      }
    }  
  }
  finally
  {
    if (versionList != null)
    {
      foreach (Version version in versionList)
      {
        version.Dispose();
      }
    }

    if (childVersionList != null)
    {
      foreach (Version version in childVersionList)
      {
        version.Dispose();
      }
    }
  }
}

バージョンのリコンサイルとポスティングは、Version クラスの Reconcile と Post という二つの異なるメソッドで実現されます。

Post メソッドは、引数として PostOptions オブジェクトを使用します。ポスト オプションオブジェクトは、部分ポストのために選択したフィーチャのリスト、サービス同期タイプ (Post を同期して実行するかどうか)、ターゲットバージョン (デフォルトバージョンを指定する場合は null を使用します) を指定します。

Reconcile メソッドは、引数として ReconcileOptions オブジェクトを使用します。リコンサイル オプション オブジェクトは、競合の解決方法 (競合が見つかったら中断するか継続するか)、競合の検出タイプ (行単位または列単位)、ターゲットバージョン (デフォルトバージョンを指定する場合は null を使用) を指定します。

同じ編集セッションで、リコンサイルの直後にバージョンをポストするには、オーバーロード Reconcile(ReconcileOptions, PostOptions) を使用する必要があります。

ノート: トラディショナル バージョニングはスタンドアロン ポスト、Version.Post(PostOptions) をサポートしないので、ポストには Version.Reconcile(ReconcileOptions, PostOptions) を使用しなければなりません。ブランチ バージョニングはスタンドアロン ポスト Version.Post(PostOptions) をサポートしますが、Version.Reconcile() をあらかじめ呼び出しておく必要があります。

トラディショナルのバージョニングを使用する場合、競合解決のタイプを設定することで、ターゲットバージョンと編集バージョンのどちらを優先して競合を解決するかを指定することもできます。

ブランチ バージョンのオーナーを変更するには、Version.ChangeOwner ルーチンを呼び出します。

リコンサイルを行う際、編集中のバージョンはターゲット バージョンからの変更で更新されます。ターゲット バージョンに変更をマージすることはありません。リコンサイル後、コンフリクトを確認した後、ターゲット バージョンに変更をポストすることでマージプロセスが完了します。

パーシャル ポストすることで、開発者はバージョンで行われた変更のサブセットをポストすることができます。使用例としては、電力会社が新しい分譲住宅の設備を設計するためにバージョンを使用する場合があります。プロセスのある時点で、新しい住宅の1ブロックは完成しているが、残りの分譲地は未建設のままです。部分的にポストすることで、ユーザは完成した作業をポストする一方で、まだ建設されていないフィーチャをバージョンに残し、後でポストすることができます。

どのフィーチャをポストするかを指定するには、PostOptions.PartialPostSelections プロパティを使います。このプロパティは、ObjectID ベースの選択リストを保持します。更新や挿入の場合、これらの選択項目の作成は比較的簡単です。例えば、フィーチャクラスの ConstructedStatus フィールドを使用して、フィーチャがポストできる状態であることを示すことができます。

QueryFilter constructedFilter = new QueryFilter()
{
  WhereClause = "ConstructedStatus = 'True'"
};
Selection constructedSupportStructures = supportStructureFeatureClass.Select(constructedFilter, SelectionType.ObjectID, SelectionOption.Normal);

削除されたフィーチャのセットを取得するクエリを発行することができないため、ポストしたいフィーチャの削除を指定するのは少し難しいです。代わりに、手動で ObjectID のリストを作成する必要があります（このリストの作成はもちろん開発者次第ですが、属性ルールを使用してフィーチャの削除を記録するという実装案もあります）。このリストを作成したら、次のようにして Selection を作成します。

Selection deletedSupportStructures = supportStructureFeatureClass.Select(null, SelectionType.ObjectID, SelectionOption.Empty);
deletedSupportStructures.Add(deletedSupportStructureObjectIDs);

どちらの場合も、選択項目にそのバージョンで変更されていないフィーチャが含まれていると、パーシャル ポストは失敗します。上記のセクションで説明したように、変更されたフィーチャを確認するために Table.Differences を使用することができます。

パーシャル ポストは、ArcGIS Enterprise 10.9 以降のブランチ バージョニングでサポートされており、パーセル ファブリック、トポロジーでは現在サポートされていません。

rcGIS Enterprise 11.3 または Pro SDK 3.3 以降、ユーティリティ ネットワークは、パーシャル ポストをサポートしています。

リコンサイル操作の間、子バージョンで行われた変更は、マージしたいターゲット バージョンと比較されます。コンフリクトが存在する場合、Version.GetConflicts() メソッドはターゲット バージョンとの Conflict のリストを返します。Conflict クラスには、コンフリクト タイプや前後の行の値など、行の ObjectId による 2 つのバージョンの違いに関する情報が含まれています。

現在のところ、Version.GetConflicts() メソッドはブランチ バージョンのデータ ストアからの競合をサポートしています。

履歴管理は、ジオデータベース内のすべてのデータまたは一部のデータに加えられた変更を記録し、アクセスするための機能を提供します。履歴管理は、時間の経過に伴うデータの変化を捉え、管理し、分析するためのメカニズムです。

組織は、以下のような一般的な質問に答えるために、データに加えられた変更を保存する必要があります。

• ある時点での特定の属性の値は何だったのか？
• 特定のフィーチャや行は時間の経過とともにどのように変化したのか？
• ある空間領域は時間とともにどのように変化したのか？

履歴管理は、データの変化を保存することで、このような質問への回答を支援します。履歴管理は、履歴管理が有効になった瞬間から無効になるまで、データセットの変更を維持するということを理解することが重要です。

データセット上の履歴管理の有効化と無効化は、Python またはジオプロセシングツールによって行われます。ジオデータベース API の2つのルーチンが履歴管理へのアクセスを提供します。

• Table.IsArchiveEnabled() は、テーブルで履歴管理が有効になっている場合に true を返します。
• 有効な場合は、Table.GetArchiveTable() を使用して実際の履歴管理テーブルを返すことができます。

上記のように個々の履歴管理テーブルを表示することもできますが、VersionManager クラスのルーチンを使用して履歴バージョンに接続する方が簡単な場合が多いです。履歴バージョンは、ジオデータベース内のすべての履歴管理されたデータセットが特定の時間にどのような状態であったかを示す読み取り専用の表現を提供します。履歴バージョンは、日付と時刻、または名前付きの履歴マーカーを使用してアクセスできます。履歴マーカーとは、名前が付けられた特定の日時のことです。たとえば、「Twin Pines Mall safety incident」という名前の履歴マーカーは、1985年10月26日の午前1時15分という日時を参照しています。履歴マーカーの作成には、CreateHistoricalVersion メソッドを使用します。

HistoricalVersion historicalVersion = versionManager.CreateHistoricalVersion(new HistoricalVersionDescription("Historical marker snapshot at the moment", DateTime.Now));

タイムスタンプは各履歴バージョンで一意でなければなりません。履歴バージョンは、タイムスタンプをキーとしてキャッシュされます。

GetCurrentHistoricalVersion メソッドは、現在選択されている履歴バージョンを返します。GetHistoricalVersion は、日時または履歴マーカー名のいずれかから履歴バージョンオブジェクトを取得します。ジオデータベース上のすべての履歴マーカーのリストを取得するには、GetHistoricalVersions メソッドを使用できます。HistoricalVersion](https://pro.arcgis.com/en/pro-app/latest/sdk/api-reference/topic7499.html) オブジェクトを取得したら、[Connect` メソッドはその特定の時点のジオデータベース接続を返します。

using (Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri("path\\to\\sde\\file\\sdefile.sde"))))
using (VersionManager versionManager = geodatabase.GetVersionManager())
{
  if (versionManager.GetCurrentVersionBaseType() == VersionBaseType.HistoricalVersion)
  {
    HistoricalVersion historicalVersion = versionManager.GetCurrentHistoricalVersion();
    using (Geodatabase historicalGeodatabase = historicalVersion.Connect())
    {
      //
    }
  }
}

RelationshipClass では以下の操作を行うことができます。

• リレーションシップの作成 - リレーションシップを作成するには、RelationshipClass オブジェクトの CreateRelationship メソッドに、関連元クラスの行と関連先クラスの行への参照を渡す必要があります。CreateRelationship が期待通りに機能するためには、関連元クラスの主キーの値（および帰属するリレーションシップクラスの関連先クラスの主キーの値）が設定されている必要があることに注意してください。例としては、リレーションシップの作成 を参照してください。属性付きのリレーションシップクラスの場合、第3引数に RowBuffer を渡して属性を追加することができます（これはオプションのパラメータです）。RowBuffer は、 AttributedRelationshipClass オブジェクトの CreateRowBuffer を呼び出すことで取得できます。

• リレーションシップの削除 - リレーションシップの作成と同様に、リレーションシップを削除する際には、関連元の行と関連先の行への参照を RelationshipClass の DeleteRelationship メソッドに渡す必要があります。例は、リレーションシップの削除 を参照してください。

• 指定された RelationshipClass によって関連付けられた行の検索 - 関連元のクラスまたは関連先のクラスのオブジェクト ID のリストが与えられると、GetRowsRelatedToOriginRowsまたは GetRowsRelatedToDestinationRows はそれぞれ、渡されたオブジェクト ID に関連する対応する行オブジェクトを提供します。例は、RelationshipClass によって関連付けられた行の取得 を参照してください。

添付ファイルは、個々のフィーチャにファイルを追加するためのもので、画像、PDF、テキスト文書など、さまざまな種類のファイルを追加できます。例えば、建物を表すフィーチャがある場合、添付ファイルを使って、建物を様々な角度から撮影した複数の写真や、建物の権利書や税務情報を含む PDF ファイルを追加することができます。

添付ファイルを追加するには、まず、フィーチャクラスまたはテーブルの添付ファイルを有効にする必要があります。添付ファイルを有効にすると、添付ファイルを格納するための新しいテーブルが作成され、フィーチャと添付ファイルを関連付けるための新しいリレーションシップクラスが作成されます。

ArcGIS.Core.Data API は DML のみの API であるため、プログラムで添付ファイルを有効にするには、Geoprocessing API を使用する方法があります。

IReadOnlyList<string> parameters = Geoprocessing.MakeValueArray("path\\to\\sde\\connection.sde\\FeatureClassName");
IGPResult gpResult = await Geoprocessing.ExecuteToolAsync("management.EnableAttachments", parameters);

テーブルやフィーチャクラスが添付ファイルを有効にしているかどうかの判断は、Table や FeatureClass オブジェクトの IsAttachmentEnabled プロパティを使って行うことができます。

添付ファイルを追加するには、Attachment constructor を使用して新しい添付ファイル オブジェクトを作成します。Name、ContentType、Data は新しい添付ファイルのメソッドを使って取得、設定できます。すべての情報が設定されたら、新しく作成されたAttachment オブジェクトを使って、Row の AddAttachment メソッドを呼び出し、添付ファイルを追加します。添付ファイルの追加の例は、アタッチメントの追加 に記載されています。

添付ファイルにデータを設定するには、ディスク上のファイルからメモリストリームを作成する必要があります。この方法の1つは、ファイルからの MemoryStream の取得 に記載されています。

添付ファイルを取得するには、Row の GetAttachments メソッドを使用できます。引数が渡されていない場合は、その行のすべての添付ファイルが返されます。第1引数に添付ファイルの ID のリストが渡された場合は、ID に一致する添付ファイルが返されます。2番目の引数は Boolean で、添付ファイルのデータを返すかどうかを指定するのに使われます。添付ファイルへのアクセスの例については、添付ファイルの更新 を参照してください。

行やフィーチャから添付ファイルを取得した後、添付ファイルのゲッターとセッターを使って、Name、Content Type、Data を設定します。そして、更新された添付ファイル オブジェクトを使って、Row や Feature の UpdateAttachment を呼び出すことができます。添付ファイルへのアクセスの例については、添付ファイルの更新 を参照してください。

添付ファイルを削除するには、まず行から添付ファイルを取得し、Row またはFeature に対して、削除したい添付ファイルの ID のリストを渡してDeleteAttachments を使用する必要があります。戻り値は、対応する添付ファイルの削除に失敗したときにスローされる例外に対する添付ファイルの ID のディクショナリです。ディクショナリが空の場合、要求された添付ファイルは正常に削除されたことになります。DeleteAttachments に引数が渡されない場合、その行のすべての添付ファイルが削除されます。添付ファイルの削除の例については、添付ファイルの削除を参照してください。

条件値はあるフィールドの値が他のフィールドの値に依存することを可能にするデータ設計機能です。
ドメインを持つフィールドは、エディターに有効な値のリストから選択することを制限しますが、条件値では、さらに一歩進んで、他のフィールドに基づいて値のリストを制限することができます。いくつかのフィールドはフィールド グループでリンクされ、条件値の組み合わせはフィールド グループ内で定義されます。編集時には、ドメイン値のリスト全体が表示されるのではなく、条件値のみが表示されます。
このように、条件値は有効な入力の数を減らすために追加の制約を適用することによって、データの整合性を強化するのに役立ちます。

Contingencyクラスの GetContingentValues() メソッドを使用することで条件値にアクセスすることができます。このメソッドは、FieldGroup 名による ContingentValue の辞書を返します。
ContingentValue は、FieldGroup に属するフィールドの可能な値を定義する基本クラスです。
条件値は次のいずれかです。

• ContingentCodedValue — コード値ドメインの値
• ContingentRangeValue — 最大および最小範囲ドメイン値の定義
• ContingentAnyValue — フィールドのドメインに含まれる任意の値が有効であるとみなされることを示す（nullも同様）
• ContingentNullValue — null 値がフィールドに対して有効であることを示す

FieldGroup には、条件値をサポートするフィールド名とその制限が含まれます。

TableDefinition または FeatureClassDefinition クラスの GetContingencies() メソッドは、データセットに適用された Contingency のリストを返します。

using (TableDefinition tableDefinition = table.GetDefinition())
{
  IReadOnlyList<Contingency> contingencies = tableDefinition.GetContingencies();
  foreach (Contingency contingency in contingencies)
  {
    // Field group 
    FieldGroup filedGroup = contingency.FieldGroup;
    string fieldGroupName = filedGroup.Name;
    IReadOnlyList<string> fieldInFieldGroup = filedGroup.FieldNames;
    bool isEditRestriction = filedGroup.IsRestrictive;

    int contingencyId = contingency.ID;
    Subtype subtype = contingency.Subtype;
    bool isContingencyRetired = contingency.IsRetired;

    // Contingent values 
    IReadOnlyDictionary<string, ContingentValue> contingentValuesByFieldName = contingency.GetContingentValues();
    foreach (KeyValuePair<string, ContingentValue> contingentValueKeyValuePair in contingentValuesByFieldName)
    {
      string attributeFieldName = contingentValueKeyValuePair.Key;

      // Contingent value type associated with the attribute field
      ContingentValue contingentValue = contingentValueKeyValuePair.Value;

      switch (contingentValue)
      {
        case ContingentCodedValue contingentCodedValue:
          string codedValueDomainName = contingentCodedValue.Name;
          object codedValueDomainValue = contingentCodedValue.CodedValue;
          break;
        case ContingentRangeValue contingentRangeValue:
          object rangeDomainMaxValue = contingentRangeValue.Max;
          object rangeDomainMinValue = contingentRangeValue.Min;
          break;
        case ContingentAnyValue contingentAnyValue:
          // Any value type
          break;
        case ContingentNullValue contingentNullValue:
          // Null value
          break;
      }
    }
  }
}

さらに、Table.GetContingentValues メソッドは、与えられた RowBuffer と属性フィールドの潜在的な条件値のリストを取得します。

using (RowBuffer rowBuffer = parcels.CreateRowBuffer())
{
  IReadOnlyDictionary<FieldGroup, IReadOnlyList<ContingentValue>> possibleZonings = parcels.GetContingentValues(rowBuffer, "Zone");
  IEnumerable<FieldGroup> possibleFieldGroups = possibleZonings.Keys;
  foreach (FieldGroup possibleFieldGroup in possibleFieldGroups)
  {
    IReadOnlyList<ContingentValue> possibleZoningValues = possibleZonings[possibleFieldGroup];
  }
}

[Table.ValidateContingencies] メソッドは、行を条件値に対して検証し、ContingencyValidationResult を返します。この結果には、一致した (有効な) 条件および反した (無効な) 条件に関する情報が含まれます。

using (RowBuffer rowBuffer = parcels.CreateRowBuffer())
{
  // Insert values in a row buffer
  rowBuffer["Zone"] = "Business";
  rowBuffer["TaxCode"] = "TaxB";

  // Validate contingency values of the parcels' row 
  ContingencyValidationResult contingencyValidationResult = parcels.ValidateContingencies(rowBuffer);

  // Valid contingencies
  IReadOnlyList<Contingency> matchedContingencies = contingencyValidationResult.Matches;
  if (matchedContingencies.Count > 0)
  {
    // Create a row with valid contingency values
    parcels.CreateRow(rowBuffer);
  }

  // Invalid contingencies
  IReadOnlyList<ContingencyViolation> violatedContingencies = contingencyValidationResult.Violations;
  foreach (ContingencyViolation contingencyViolation in violatedContingencies)
  {
    ContingencyViolationType violationType = contingencyViolation.Type;
    Contingency violatedContingency = contingencyViolation.Contingency;
  }
}

Contingency は廃止することができます。廃止されると、既存のデータには残りますが、編集には利用できなくなります。

属性ルール は、ジオデータベースのデータセットの編集作業を改善し、データの整合性を高めるものです。属性ルールは、属性を自動的に入力したり、編集操作中に無効な編集を制限したり、既存のフィーチャの整合チェックを行うために使用できる、ユーザ定義のルールです。ジオデータベースは、属性を自動的に入力する計算ルール、データの品質を保証する制約ルール、既存フィーチャを確認する検証ルールをサポートしています。

ジオデータベースが属性ルールをサポートしているかどうかを調べるには、Geodatabase クラスの IsAttributeRuleSupported() メソッドを使用します。

属性ルールはジオデータベースのフィーチャクラスまたはテーブルのプロパティとして作成されます。そのため、データセットの属性ルールは TableDefinition の GetAttributeRules メソッドを使用して取得できます。これは、AttributeRuleDefinition オブジェクトの読み取り専用リストを返します。データセットのすべての属性ルールを取得することもできますし、特定のルール タイプ（計算、制約、整合チェック）の属性ルールを取得することもできます。属性ルールを取得したら、そのプロパティを調べることができます。

属性ルールには、GetNameメソッドとGetDescriptionメソッドを使用して取得した名前と説明があります。GetAttributeRuleTypeを使用して、AttributeRuleTypeを決定します。ルールの詳細は、GetScriptExpressionで取得できるスクリプト式で定義され、GetTriggeringEventsを調べることで、どのイベントがルールをトリガーするかを判断できます。ルールが作成された時期によっては、ルールの実行または評価に必要な Arcade の最小バージョンを確認することが役立ちます。 この情報を取得するには、GetMinimumArcadeVersion を使用します。

属性ルールの作成時に、エラー番号、エラーメッセージ、重大度を定義することができます。 GetErrorNumber、GetErrorMessage、GetSeverity メソッドを使用して、これらを取得することができます。評価に関するステータス プロパティは、GetIsBatch、GetIsEnabled、GetExcludeFromClientEvaluation を使用して取得できます。

Pro SDK は、整合チェック ルールとバッチ計算ルールを実行するルーチンを提供します。これらの属性ルールを実行するためのクラスを以下の図に示します。詳細については、この後のドキュメントのセクションで説明します。

Pro SDK で属性ルールを扱うための中心となるクラスは AttributeRuleManager クラスです。 このオブジェクトは、Geodatabase クラスのGetAttributeRuleManager() メソッドを呼び出すことで取得できます。 ジオデータベースが属性ルールをサポートしているかどうかは、まず上述のIsAttributeRuleSupported() メソッドをチェックする必要があります。

属性ルールにはいくつかの種類があります。 即時計算と制約ルールは、複数のジオデータベースタイプでサポートされており、行の作成、更新、削除の際に自動的に発行されます。

一部のジオデータベースでは、バッチ計算および検証ルールがサポートされています。これらのルールは、AttributeRuleManager クラスの EvaluateInEditOperation() 拡張メソッド を呼び出すことで実行されます。データベースが評価をサポートしているかどうかを判断するためには、事前に IsEvaluationSupported() メソッドを呼び出す必要があります。

属性ルールを実行するには、EvaluateInEditOperation() メソッドを使用します。 EvaluateInEditOperation() の呼び出しに渡されるパラメータは、AttributeRuleEvaluationDescription クラス によって指定されます。 サポートされている組み合わせは、限られた数のコンストラクタを使用して適用されます。

EvaluateInEditOperation() メソッドは、AttributeRuleEvaluationResult オブジェクトを返し、検出されたエラーの数を判別するために使用されます。

フィーチャ サービスで呼び出されると、EvaluateInEditOperation() メソッドはREST エンドポイントへの呼び出しを行い、同期して実行されます。このルーチンは処理のオーバーヘッドが少ないです。残念ながら、処理に時間がかかりすぎるとサーバーのタイムアウトの影響を受けやすくなります。この問題を回避するために、Evaluate REST エンドポイントはこのルーチンの非同期バージョンを提供しています。処理は、検証サーバーからジオプロセシング サーバーにオフロードされます。これによりパフォーマンスが低下しますが、ジオプロセシング サーバは長時間実行されるジョブを処理するように設計されており、タイムアウトの影響を受けません。このサービスでは、操作が完了するまで ArcGIS Pro がサービスをポーリングします。多くの評価コールは多数のフィーチャに対して実行されるため、非同期バージョンがデフォルトとなっています。

AttributeRuleEvaluationDescription の ServiceSynchronizationType パラメータは、どのバージョンのサービスを呼び出すかを制御できます。これには2つの値を持つServiceSynchronizationType 列挙型を使用します。Synchronous と Asynchronous です。ここで重要なのは、C# 開発者の視点から見ると、このパラメータに関わらず、このルーチンは 同期 C# メソッドであるということです。API の他のメソッドと同様に、操作が完了するまで現在のスレッドをブロックします。

CoreHost アプリケーションを書く場合は、AttributeRuleManager クラスの Evaluate() ベースメソッドを使用してください。このルーチンは独自のトランザクション管理を行うため，Geodatabase.ApplyEdits() で作成された編集操作の内部では発行できません。

属性ルールの検証に失敗すると、エラーが一連のエラーテーブルに書き込まれます。同様に、バッチ計算ルールの実行で問題が発生した場合も、これらのテーブルにエラーが書き込まれます。使用されるエラー テーブルは、ソースのフィーチャクラスまたはテーブルのジオメトリに応じて4つあります。これらのエラーテーブルは Pro のユーザーインターフェースで見ることができ、Pro SDK でも AttributeRuleManager の GetErrorTable() メソッドでアクセスすることができます。これらのテーブルは取得後、他のジオデータベースのテーブルと同様に読み込んだりクエリすることができます。これらのテーブルの各行はエラーを表しています。

CreateAttributeRuleError() ルーチンは、エラーテーブルの1つから行を取り、それを使って AttributeRuleError オブジェクトを生成します。このオブジェクトはテーブルをよりユーザーフレンドリーに表示します。機能的に重要なのは、このオブジェクトを使って、エラーの原因となったフィーチャを取り出すことができることです。OriginClass プロパティはテーブルまたはフィーチャのクラス名を返します。これは Geodatabase.OpenDataset() を使ってテーブルを開くのに使用できます。 AttributeRuleError クラスの OriginGlobalID または OriginObjectID プロパティを使用すると、エラーの原因となった特定の行を取得することができます。

属性ルールのエラーテーブルは、ほとんどの場合、読み取り専用です。 検証に失敗したフィーチャに対して EvaluateInEditOperation() を実行することによってのみ、新しい行を作成することができます。行を削除するには、エラーの原因となった根本的な問題を解決し、EvaluateInEditOperation() を再度実行する必要があります。これらのテーブルにできる唯一の更新は、エラーを 例外 としてマークすることです。これは、そのエラーが例外的なケースであり、エラーとして扱うべきではないことをシステムに示すために使用されます。エラーを例外としてマークするには、AttributeRuleError クラスの IsException プロパティを設定して、そのリストを AttributeRuleManager の UpdateErrorsInEditOperation() エクステンションメソッドに渡します。

CoreHost アプリケーションを書く場合は、AttributeRuleManager クラスの UpdateErrors() ベースメソッドを使用してください。このルーチンは独自のトランザクション管理を行うので、Geodatabase.ApplyEdits() で作成された編集操作の中では発行できません。

ArcGIS.Core.Data API は、複数の編集を1つのトランザクションとして実行することをサポートしています（ロングトランザクションとも呼ばれます）。トランザクションでの編集には、以下の2つのモードがあります。

• アドイン モードでの編集
• スタンドアロン モードでの編集

これは、ArcGIS Pro のアドインをオーサリングする際にトランザクションで編集を実行する通常のモードです。EditOperation クラスは、ArcGIS Pro でのトランザクション内の編集のサポートを提供します。詳細については、ArcGIS Pro ProConcepts Editing ドキュメントの 高度な編集 を参照してください。

ArcGIS.Core API が ArcGIS.CoreHost API サポートを使用して ArcGIS Pro の外部（コンソール アプリケーションなど）で使用される場合、これをスタンドアロン モードと呼びます。このモードでは、トランザクションで編集を実行する場合、ArcGIS.Core.Data.Geodatabase.ApplyEdits メソッドを使用する必要があります。

geodatabase.ApplyEdits(() =>
{
  using (RowBuffer rowBuffer = citiesTable.CreateRowBuffer())
  {
    rowBuffer["State"] = "Colorado";

    rowBuffer["Name"] = "Fort Collins";
    rowBuffer["Population"] = 167830;
    citiesTable.CreateRow(rowBuffer).Dispose();

    rowBuffer["Name"] = "Denver";
    rowBuffer["Population"] = 727211;
    citiesTable.CreateRow(rowBuffer).Dispose();

    // etc.
  }
});

上の例で示したように、ApplyEdits メソッドは Action デリゲートを受け取ります。Action デリゲートは、トランザクション内で実行しなければならないすべての編集をカプセル化します。トランザクションは、Action デリゲートの実行中にスローされる例外がない場合にのみコミットされます。実行中に処理されない例外が発生した場合は、それまでに行われたすべての編集がロールバックされ、トランザクションは中止されます。

Enterprise ジオデータベースは、デフォルトでバージョン管理された編集セッションを使用するように自動的に設定されます。バージョン管理されていないデータを編集したい場合は、バージョン管理されていない編集セッションを使用することを示す追加のBoolean パラメータを持つ ApplyEdits オーバーロードを使用する必要があります。

// The non-versioned edit of States feature class that participates in a composite relationship 
geodatabase.ApplyEdits(() =>
{
  using (Table table = geodatabase.OpenDataset<FeatureClass>("States"))
  {
    using (RowCursor cursor = table.Search(queryFilter, false))
    {
      if (cursor.MoveNext())
      {
        using (Feature feature = (Feature)cursor.Current)
        {
          feature["Name"] = "CA";
          feature.Store();
        }
      }
    }
  }
}, false);

1つの編集セッションで、バージョン管理されたデータとバージョン管理されていないデータの両方に対する編集を混在させることは推奨されません。

EditOperation.ExecuteAsync と Geodatabase.ApplyEdits の動作の違いを以下に示します。

• ApplyEdits メソッドは、単一のジオデータベース内の編集にのみ使用できますが、EditOperation の ExecuteAsync は、複数のジオデータベースへの編集のインターリーブを可能にします。
• ExecuteAsync とは異なり、ApplyEdits は Undo/Redo 機能をサポートしません。
• ExecuteAsync は、編集セッションを終了するために SaveEdits または DiscardEdits 呼び出しを必要としますが、ApplyEdits は、編集セッションと編集操作の両方を暗黙的に終了します。
• ApplyEdits は、マップの更新をサポートしません。

ApplyEdits は、ArcGIS Pro の外部での編集を目的としていることに注意してください。アドインでのすべての編集には、EditOperation を使用する必要があります。

スタンドアロンの CoreHost アプリケーションで大量の行を挿入する場合は、InsertCursor クラスを使用してください。これは、上記の手法と同等以上のパフォーマンスが保証されています。使用するフィーチャクラスやテーブルの種類によっては、何倍も速くなる可能性があります。速くならないテーブルの例としては、アノテーションやディメンションのフィーチャクラス、コンポジット リレーションシップクラスに参加するテーブル、添付ファイルのあるテーブルなどがあります。

geodatabase.ApplyEdits(() =>
{
  using (InsertCursor insertCursor = citiesTable.CreateInsertCursor())
  using (RowBuffer rowBuffer = citiesTable.CreateRowBuffer())
  {
    rowBuffer["State"] = "Colorado";

    rowBuffer["Name"] = "Fort Collins";
    rowBuffer["Population"] = 167830;
    insertCursor.Insert(rowBuffer);

    rowBuffer["Name"] = "Denver";
    rowBuffer["Population"] = 727211;
    insertCursor.Insert(rowBuffer);

    // Insert more rows here
    // A more realistic example would be reading source data from a file

    insertCursor.Flush();
  }
});

UpdateCursor クラスは、行を高速に更新するように設計されています。少なくとも、Table.CreateRow() メソッドと Row.Store() メソッドを繰り返し呼び出すのと同等以上のパフォーマンスが保証されています。多くの場合、そのパフォーマンスは大幅に向上するでしょう。

using (UpdateCursor updateCursor = citiesTable.CreateUpdateCursor(queryFilter, false))
{
  if (updateCursor.MoveNext())
  {
    using (Row row = updateCursor.Current)
    {
      int stateIndex = row.FindField("State");
      row[stateIndex] = "Colorado";

      updateCursor.Update(row);
    }
  }
}

ArcGIS Pro アドインで使用する場合、更新カーソルは編集操作のコールバック内で使用する必要があります。スタンドアロンの CoreHost アプリケーションでは、更新カーソルの使用は Geodatabase.ApplyEdits の呼び出し内に囲む必要があります。

データベースが SQL などのネイティブ プログラミング言語をサポートしている場合、DatabaseClient クラスの静的な ExecuteStatement メソッドを使ってステートメントを実行することができます。ステートメントは DDL（データ定義言語）や DML（データ操作言語）ステートメントであれば何でも構いませんが、結果セットを返すことはできません。SQL の構文は、ベースとなるデータベースで要求されるとおりです。

先に説明したように、ArcGIS.Core.Data API のすべてのメソッドは、メイン CIM スレッド（MCT）で呼び出されなければなりません。ただし、いくつかの除外事項が存在します。ArcGIS.Core.Data.SpatialQueryFilter および ArcGIS.Core.Data.QueryFilter はどのスレッドでも構築できますが、QueryFilter を使用した Search および Select は、MCT で呼び出す必要があります。

疑わしい場合は、トリプルスラッシュのドキュメントを参照して、そのメソッドを任意のスレッドで呼び出すことができるかどうかを判断してください。

以前に ArcObjects で Geodatabase API の固有のインスタンス化特性に依存するコードを開発したことがある場合、ArcGIS.Core.Data API の Handle プロパティを使用して、Pro SDK に同等のロジックを実装することができます。Handle は、ディクショナリキーとして効率的に使用したり、ArcObjects のポインターを比較するのと同等の等価チェックに使用できます。

アーキテクチャ セクションの冒頭で述べたように、アンマネージリソースを明示的に Dispose することを忘れないでください。 例えば、以下のようなコードは避けてください。

  if (row.GetTable().Handle == _handle)
  {
    //etc.
  }

このコードは、管理された Core.Data テーブルインスタンスをインスタンス化します。このテーブルインスタンスは、ガベージコレクションされるまで、アンマネージリソースへの参照が解放されません。このコードが、破棄されずにガベージコレクションされなければならない何百万ものテーブルインスタンスを生成するループの中で呼び出されていた場合には、さらに悪い結果になる可能性もあります。   その代わりに、テーブルへの明示的な参照を毎回取得し、Handle プロパティが評価された後に破棄する必要があります。

  using (Table table = row.GetTable())
  {
    if (table.Handle == _handle)
    {
      // etc.
    }
  }

Row クラスと Feature クラスには Handle プロパティがありますが、これらの値を等価性チェックに使用することはできません。これは、同じベースとなるデータベースの行を参照する異なる Row オブジェクトは、異なる RowCursor オブジェクトを使用して作成でき、リサイクルされた RowCursor オブジェクトは同じ Row を使用して複数のベースとなるデータベースの行を参照するためです。

ジオデータベース オブジェクトで Geoprocessing API を使用したい場合があります。例えば、DDL API でサポートされていないデータストアやデータセットに対して DDL（データ定義言語）操作を行いたい場合には、ジオプロセシングを使用する必要があります。これらのオブジェクトへのパスを提供するために、Datastore.GetPath() および Dataset.GetPath() ルーチンを使用することができます。